diff --git a/plugins/deta/.codex-plugin/plugin.json b/plugins/deta/.codex-plugin/plugin.json
index 89f8a53..ac3fa68 100644
--- a/plugins/deta/.codex-plugin/plugin.json
+++ b/plugins/deta/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "deta",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "DETA 建筑性能设计插件：以 AML 为唯一事实源编辑建筑模型，编译为建筑模型并执行规则校验。",
   "author": {
     "name": "DETA",
diff --git a/plugins/deta/package-lock.json b/plugins/deta/package-lock.json
index fd95e6d..60c1ec5 100644
--- a/plugins/deta/package-lock.json
+++ b/plugins/deta/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "deta-plugin",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "deta-plugin",
-      "version": "0.2.7",
+      "version": "0.2.8",
       "license": "Proprietary"
     }
   }
diff --git a/plugins/deta/package.json b/plugins/deta/package.json
index d557b2a..cb0ada3 100644
--- a/plugins/deta/package.json
+++ b/plugins/deta/package.json
@@ -1,6 +1,6 @@
 {
   "name": "deta-plugin",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "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 73c9ab3..227aad8 100644
--- a/plugins/deta/skills/aml-design/SKILL.md
+++ b/plugins/deta/skills/aml-design/SKILL.md
@@ -155,6 +155,13 @@ Studio 就是deta.city 上的建筑性能应用。在 Codex 右侧内置浏览
    - 同一轮只调用一个本插件工具，不要并发；
    - 单会话保持轻量，完成任务后另起会话继续；
    - 一旦出现该错误，**停止重试并告知用户重开会话**（工作区文件不会丢失）。
+6. **复杂形体（`<solid script="geometry/xxx.py">`）的脚本属于工作区文件，不是宿主本地文件**。
+   编译服务没有工作区访问权：编译前引擎会按 AML 声明的相对路径把脚本内容**随请求携带**
+   （键名必须与 AML 一字不差，含 `geometry/` 前缀）。因此：
+   - 脚本必须真实存在于**工作区**（用工作区文件工具读写，如 `geometry/shapes.py`）；
+   - 脚本取不到时编译会**显式失败并列出原因**（而不是"编译通过但形体丢失"）；
+   - 改动脚本内容后无需重命名或改 AML；若 AML 里写了 `version="sha256:…"`，脚本内容变了
+     必须同步更新该版本号，否则编译报「几何脚本版本不匹配」。
 
 ## 标准工作流