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