feat(plugin): 更新版本至 0.2.5，增加工具发现规则与闭环单入口说明

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

plugins/deta/.mcp.json

@@ -2,7 +2,8 @@
     "mcpServers": {
       "deta_mcp": {
         "type": "streamable-http",
-      "url": "https://deta.city/mcp-api/mcp"
+        "url": "https://deta.city/mcp-api/mcp",
+        "omit_tools_from": ["deferred"]
+      }
     }
   }
-}

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

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

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`