From 1d1a0f5d54004f2890ba098ed981dbae9de7d2bd Mon Sep 17 00:00:00 2001
From: ringo <ringo.arch@gmail.com>
Date: Thu, 10 Sep 2026 17:07:21 +0800
Subject: [PATCH] =?UTF-8?q?feat(plugin):=20=E6=9B=B4=E6=96=B0=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E8=87=B3=200.2.5=EF=BC=8C=E5=A2=9E=E5=8A=A0=E5=B7=A5?=
 =?UTF-8?q?=E5=85=B7=E5=8F=91=E7=8E=B0=E8=A7=84=E5=88=99=E4=B8=8E=E9=97=AD?=
 =?UTF-8?q?=E7=8E=AF=E5=8D=95=E5=85=A5=E5=8F=A3=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 plugins/deta/.codex-plugin/plugin.json  |  2 +-
 plugins/deta/.mcp.json                  | 11 ++++++-----
 plugins/deta/package-lock.json          | 13 +++++++++++++
 plugins/deta/package.json               |  2 +-
 plugins/deta/skills/aml-design/SKILL.md | 20 ++++++++++++++++++++
 5 files changed, 41 insertions(+), 7 deletions(-)
 create mode 100644 plugins/deta/package-lock.json

diff --git a/plugins/deta/.codex-plugin/plugin.json b/plugins/deta/.codex-plugin/plugin.json
index 6df57d9..52ff22a 100644
--- a/plugins/deta/.codex-plugin/plugin.json
+++ b/plugins/deta/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "deta",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "DETA 建筑性能设计插件：以 AML 为唯一事实源编辑建筑模型，经 GSA 编译为建筑模型并做规则校验。",
   "author": {
     "name": "DETA",
diff --git a/plugins/deta/.mcp.json b/plugins/deta/.mcp.json
index c668af1..b368fa1 100644
--- a/plugins/deta/.mcp.json
+++ b/plugins/deta/.mcp.json
@@ -1,8 +1,9 @@
 {
-  "mcpServers": {
-    "deta_mcp": {
-      "type": "streamable-http",
-      "url": "https://deta.city/mcp-api/mcp"
+    "mcpServers": {
+      "deta_mcp": {
+        "type": "streamable-http",
+        "url": "https://deta.city/mcp-api/mcp",
+        "omit_tools_from": ["deferred"]
+      }
     }
   }
-}
diff --git a/plugins/deta/package-lock.json b/plugins/deta/package-lock.json
new file mode 100644
index 0000000..b6c3757
--- /dev/null
+++ b/plugins/deta/package-lock.json
@@ -0,0 +1,13 @@
+{
+  "name": "deta-plugin",
+  "version": "0.2.5",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "deta-plugin",
+      "version": "0.2.5",
+      "license": "Proprietary"
+    }
+  }
+}
diff --git a/plugins/deta/package.json b/plugins/deta/package.json
index b58dcea..341035a 100644
--- a/plugins/deta/package.json
+++ b/plugins/deta/package.json
@@ -1,6 +1,6 @@
 {
   "name": "deta-plugin",
-  "version": "0.1.0",
+  "version": "0.2.5",
   "description": "DETA 建筑性能设计：AML 建筑模型读写与编译校验（Codex 插件 / dsh 组合包 双壳）",
   "type": "module",
   "license": "Proprietary",
diff --git a/plugins/deta/skills/aml-design/SKILL.md b/plugins/deta/skills/aml-design/SKILL.md
index 9f298ad..781c0b9 100644
--- a/plugins/deta/skills/aml-design/SKILL.md
+++ b/plugins/deta/skills/aml-design/SKILL.md
@@ -5,6 +5,25 @@ description: 以 AML 为唯一事实源读写建筑模型并编译校验。当
 
 # DETA 建筑性能设计（AML）
 
+## ★ 先读：工具怎么找、模型怎么改（任意工作目录都适用）
+
+**工具发现规则（重要）**：宿主对插件类 MCP 工具做**懒加载检索**，一次检索只返回少量结果
+（实测 `Only 10 shown of 23`）。**搜不到不等于不存在**——不确定有哪些工具时，先调
+**`list_capabilities`**（能力目录）拿到当前形态的**完整工具名清单**，再按名字**直接调用**。
+
+**改建筑模型只有一个标准动作**（远程形态）：
+
+  `build_model({ aml, projectId })` —— 写服务端工作区 → 编译成建筑模型 → 规范校验 → 写进云项目，
+  一次调用完成；返回 `gate`（校验是否通过）、编译摘要、校验明细、云工作区 `headSha`。
+
+  - **不要**把 AML 拷进 Studio 的代码编辑器手工点编译（那是没有闭环工具时的兜底，不是正常路径）；
+  - **不要**用脚本自绘模型图代替 Studio；
+  - 校验不通过（`gate: failed`）就按 `validation` 明细改 AML 后重跑，直到通过；
+  - 冲突（`version_conflict`）说明云工作区被其它会话改过：确认要覆盖才传 `force: true`。
+
+**看模型 / 打开 Studio**：`studio_link` 拿一次性免密链接，再用宿主内置浏览器（`iab`）打开——
+不要手工在面板登录，也不要用 playwright 逐步点击。
+
 ## 何时使用
 
 用户提到建筑方案、房间/空间布局、层高、墙体开洞（门窗）、围护结构、体形系数、
@@ -153,6 +172,7 @@ Studio 就是 ant-model（deta.city 上的建筑性能应用）。在 Codex 右
 
 设计源码读写/搜索：**宿主原生工具**（read / patch / grep / shell），不经 MCP
 生成与语法：`generate_aml`、`get_aml_schema`
+能力目录：`list_capabilities`（不确定有哪些工具时先调它拿完整名字表——检索一次只回少量结果，搜不到不等于不存在）
 闭环单入口：`build_model`（写工作区 → 编译 → 校验 → 云同步；见「闭环单入口 build_model」一节）
 编译与校验：`apply_design`、`validate_model`、`envelope_stats`、`query_spatial_graph`、
 `generate_candidates`、`analyze_gsa_issues`、`analyze_rules_compliance`