From d137a012c6fc2e9f762bbb038af7bf533ab5c371 Mon Sep 17 00:00:00 2001 From: ringo Date: Sun, 20 Sep 2026 16:11:44 +0800 Subject: [PATCH] =?UTF-8?q?docs(skill):=20=E5=80=99=E9=80=89=E6=AF=94?= =?UTF-8?q?=E9=80=89=E5=8F=A3=E5=BE=84=EF=BC=88=E9=A2=84=E8=A7=88=E5=9B=BE?= =?UTF-8?q?=E8=B5=B0=E5=B7=A5=E5=85=B7=E7=BB=93=E6=9E=9C=E3=80=81wall=5Fro?= =?UTF-8?q?les/unit=5Fdoor=20=E5=A5=91=E7=BA=A6=EF=BC=89=EF=BC=8Cstudio=20?= =?UTF-8?q?0.3.11?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ask_user 卡片协议上装不下图 → 预览图随 generate_candidates 的工具结果回（宿主显示），选项文字按序号引用；补 wall_roles 列表形态与 unit_door.offset 0~1 的实测契约。 --- plugins/studio/.codex-plugin/plugin.json | 2 +- plugins/studio/package-lock.json | 4 ++-- plugins/studio/package.json | 2 +- plugins/studio/skills/aml-design/SKILL.md | 6 ++++++ 4 files changed, 10 insertions(+), 4 deletions(-) diff --git a/plugins/studio/.codex-plugin/plugin.json b/plugins/studio/.codex-plugin/plugin.json index 71d3c17..df12e1d 100644 --- a/plugins/studio/.codex-plugin/plugin.json +++ b/plugins/studio/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "studio", - "version": "0.3.10", + "version": "0.3.11", "description": "DETA Studio 插件：以 AML 为唯一事实源编辑建筑模型，编译为建筑模型并执行规则校验。", "author": { "name": "DETA", diff --git a/plugins/studio/package-lock.json b/plugins/studio/package-lock.json index 625f6fa..e177b54 100644 --- a/plugins/studio/package-lock.json +++ b/plugins/studio/package-lock.json @@ -1,12 +1,12 @@ { "name": "deta-studio-plugin", - "version": "0.3.10", + "version": "0.3.11", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "deta-studio-plugin", - "version": "0.3.10", + "version": "0.3.11", "license": "Proprietary" } } diff --git a/plugins/studio/package.json b/plugins/studio/package.json index ec1afe0..a53aa1a 100644 --- a/plugins/studio/package.json +++ b/plugins/studio/package.json @@ -1,6 +1,6 @@ { "name": "deta-studio-plugin", - "version": "0.3.10", + "version": "0.3.11", "description": "DETA Studio：AML 建筑模型读写与编译校验（Codex 插件 / dsh 组合包 双壳）", "type": "module", "license": "Proprietary", diff --git a/plugins/studio/skills/aml-design/SKILL.md b/plugins/studio/skills/aml-design/SKILL.md index 8c29f87..fba35c0 100644 --- a/plugins/studio/skills/aml-design/SKILL.md +++ b/plugins/studio/skills/aml-design/SKILL.md @@ -115,6 +115,12 @@ GSA 默认 http://localhost:8000 - 依赖链由 `depends_on` 声明（如 面积预算 → 楼层/轴网规划 → 布局建议），**先跑前置**；已算过的结果在会话语境里保留（`get_design_params` 可查），不要重复跑。 - 评估/校验统一走 `design-review`（缺省全跑、数据不足的项自动跳过并给 note）。 +## 候选平面比选（generate_candidates） + +- **预览图会随工具结果一起回来**（宿主在对话里显示；本形态已把 `preview_svg` 栅格化成 PNG 附加在结果上）。`ask_user` 的选项卡片**协议上装不下图**（MCP 表单只允许原始类型字段），所以比选时的正确做法是：选项文字写「候选 1 / 候选 2 / 候选 3（对应上方预览图）」，让用户按序号看图选。 +- 请求契约（实测踩点）：住宅 `program.boundary` 必填，且 `wall_roles` 是**对象列表** `[{"side":"N","role":"exterior"}, …]`（矩形要覆盖 N/S/E/W 四条边；角色取 exterior / party / corridor）；不是 `{"N":"exterior"}` 这种映射。`boundary.unit_door.offset` 是 **0~1 的比例**（不是米）；入户锚定求解超时时换入户侧（如 S/N）或去掉 `unit_door` 让服务自动选门。 +- 多配方 fan-out：住宅 candidates≥2 时自动跨 slicing / learned / hybrid 三配方；某配方不可用会如实进 `unavailable_recipes`，不影响其余候选产出。生成失败时按 GSA 返回的 `param_errors` / `constraint_report` 修正，不要静默放宽参数。 + ## 编辑与校验分工（先搞清"哪份文件是真值"） 本插件挂的是**本机 MCP**：引擎工作区才是编译/校验/模拟读的真值（启动器 stderr 会回显路径）。