docs(skill): 候选比选口径（预览图走工具结果、wall_roles/unit_door 契约），studio 0.3.11

ask_user 卡片协议上装不下图 → 预览图随 generate_candidates 的工具结果回（宿主显示），选项文字按序号引用；补 wall_roles 列表形态与 unit_door.offset 0~1 的实测契约。

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",

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"
     }
   }

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",

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 会回显路径）。