From 80fbd162d3d91288e94b77dc0d00556a17965425 Mon Sep 17 00:00:00 2001 From: ringo Date: Thu, 17 Sep 2026 14:54:32 +0800 Subject: [PATCH] =?UTF-8?q?docs(plugin):=20=E9=93=81=E5=BE=8B=E8=A1=A5?= =?UTF-8?q?=E5=A4=8D=E6=9D=82=E5=BD=A2=E4=BD=93=E8=84=9A=E6=9C=AC=E5=A5=91?= =?UTF-8?q?=E7=BA=A6=EF=BC=8C=E7=89=88=E6=9C=AC=200.2.8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit skill aml-design 新增铁律 6：`` 的脚本属**工作区文件**—— 编译服务无工作区访问权，编译前引擎按 AML 声明的相对路径把脚本内容随请求携带（键名一字不差， 含目录前缀）；脚本必须真实存在于工作区（可用工作区文件工具读写）；取不到时编译**显式失败** 并列出原因，而不是「编译通过但形体丢失」；AML 若声明 `version="sha256:…"`，脚本内容变了必须 同步版本号，否则报「几何脚本版本不匹配」。 配套引擎侧修复见 ant-copilot 提交 `fix(solid): 脚本随编译请求携带 + 缺失显式失败`。 版本 0.2.7 → 0.2.8（三处同步），供 Codex 换缓存目录后生效；官方校验器 passed。 --- plugins/deta/.codex-plugin/plugin.json | 2 +- plugins/deta/package-lock.json | 4 ++-- plugins/deta/package.json | 2 +- plugins/deta/skills/aml-design/SKILL.md | 7 +++++++ 4 files changed, 11 insertions(+), 4 deletions(-) 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. **复杂形体（``）的脚本属于工作区文件，不是宿主本地文件**。 + 编译服务没有工作区访问权：编译前引擎会按 AML 声明的相对路径把脚本内容**随请求携带** + （键名必须与 AML 一字不差，含 `geometry/` 前缀）。因此： + - 脚本必须真实存在于**工作区**（用工作区文件工具读写，如 `geometry/shapes.py`）； + - 脚本取不到时编译会**显式失败并列出原因**（而不是"编译通过但形体丢失"）； + - 改动脚本内容后无需重命名或改 AML；若 AML 里写了 `version="sha256:…"`，脚本内容变了 + 必须同步更新该版本号，否则编译报「几何脚本版本不匹配」。 ## 标准工作流