docs(plugin): 铁律补复杂形体脚本契约，版本 0.2.8

skill aml-design 新增铁律 6：`<solid script="geometry/xxx.py">` 的脚本属**工作区文件**——
编译服务无工作区访问权，编译前引擎按 AML 声明的相对路径把脚本内容随请求携带（键名一字不差，
含目录前缀）；脚本必须真实存在于工作区（可用工作区文件工具读写）；取不到时编译**显式失败**
并列出原因，而不是「编译通过但形体丢失」；AML 若声明 `version="sha256:…"`，脚本内容变了必须
同步版本号，否则报「几何脚本版本不匹配」。

配套引擎侧修复见 ant-copilot 提交 `fix(solid): <solid script> 脚本随编译请求携带 + 缺失显式失败`。
版本 0.2.7 → 0.2.8（三处同步），供 Codex 换缓存目录后生效；官方校验器 passed。

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

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

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

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:…"`，脚本内容变了
+     必须同步更新该版本号，否则编译报「几何脚本版本不匹配」。
 
 ## 标准工作流