SuperAPI AI 工具集

oas-program

设计与创作

查看项目

更新于 10-15 17:21

技能介绍

用途:OAS Program 技能用于描述“想要什么”而非“已存在什么”,即目标面积、必须靠近关系、流线偏好、房间数量与硬性限制。Program 是任务书,Layout 才是答案;一旦开始输出多边形或墙坐标,就属于 oas-layout 而非本技能。

主要能力与字段:程序文档为扁平 JSON 对象,不是类型化类。包含 oas_program、plan_id、title、description 等元数据,其中 plan_id 用于把 program 链接到 layout;design_goal 为自然语言意图句;global_constraints 可含 target_area_m2、max_area_m2、orientation_preference、climate、accessibility_level 等;rooms[] 每项含 id、usage、desired_area_m2、must_have、should_have、adjacency、avoid;adjacency 使用前缀键 must_touch、should_touch、avoid_touch、must_connect_via;circulation 含 primary_entry 与自由格式 rules[];rationale 为可选理由字符串。

关键规则:只表达意图,不包含已解析几何,不得出现 boundary_polygon、walls 或坐标。desired_area_m2 接受 { "min": X, "max": Y } 或精确数值,标量同样合法。约束强度由字段前缀编码而非标志位:must_have/must_touch 为硬约束,should_have/should_touch 为软约束,avoid_touch 为硬性否定,没有单独的 hard: true 字段。房间应使用 program id 引用,而非 Layout id,因为 Layout id 尚不存在;邻接目标为程序级 id,如 "corridor" 或 "living_kitchen"。circulation 的 rules[] 为自然语言字符串,求解器按启发式解析,应简洁且具声明性。

使用方式与限制:完整 schema 见 docs/program.md,涵盖约束组合与邻接权重。相关技能为 oas-layout(由 program 解析出的几何)与 oas-core(与 Layout 共享的 usage 取值词汇表)。资料未提供安装命令、收费信息或具体运行步骤。