diff --git a/plugins/deta/skills/aml-design/SKILL.md b/plugins/deta/skills/aml-design/SKILL.md index d3a1624..4911381 100644 --- a/plugins/deta/skills/aml-design/SKILL.md +++ b/plugins/deta/skills/aml-design/SKILL.md @@ -21,8 +21,8 @@ description: 以 AML 为唯一事实源读写建筑模型并编译校验。当 - 校验不通过(`gate: failed`)就按 `validation` 明细改 AML 后重跑,直到通过; - 冲突(`version_conflict`)说明云工作区被其它会话改过:确认要覆盖才传 `force: true`。 -**看模型 / 打开 Studio**:`open_studio`(推荐)或 `studio_link` 拿一次性免密链接,再用宿主内置 -浏览器(`iab`)打开——不要手工在面板登录,也不要用 playwright 逐步点击。 +**看模型 / 打开 Studio**:`open_studio` 拿一次性免密链接,再用宿主内置浏览器(`iab`)打开—— +不要手工在面板登录,也不要用 playwright 逐步点击。 **执行器在线是模拟类工具的前置条件**:`simulate` / `studio_command` / `query_simulation_db` / `view_canvas` 的算力在 ant-model 浏览器里的执行器,经网关 host-call 中继干活;项目标签页一关 @@ -97,8 +97,7 @@ Studio 就是deta.city 上的建筑性能应用。在 Codex 右侧内置浏览 打开步骤(用宿主内置浏览器 = browser 插件的 `iab`): -1. **先调 `open_studio` 拿链接并确认执行器上线**(推荐路径,免手工登录;工具面里没有它时用 - `studio_link`,但 `studio_link` 只给链接、不报执行器状态)。返回 `url` +1. **先调 `open_studio` 拿链接并确认执行器上线**(免手工登录)。返回 `url` (`https://deta.city/mcp-api/portal-session/landing?ticket=…&next=/design/`)、 `studioUrl`、`executor_online`、`expiresInSeconds`(180)。该链接在面板内会自动完成 deta.city 登录并跳到 Studio。 @@ -112,7 +111,7 @@ Studio 就是deta.city 上的建筑性能应用。在 Codex 右侧内置浏览 (重载会丢面板里正在进行的操作);没有才 `const tab = await iab.tabs.new(); await tab.goto(url);` 4. 打开后告诉用户「Studio 已在右侧面板打开(项目名/ID)」,并说明模拟在面板里运行。 -旧路径(工具面里没有 `studio_link` 时):自己拼 `studioUrl` +旧路径(工具面里没有 `open_studio` 时):自己拼 `studioUrl` (本机项目目录 `deta.json` 的 `projectId`,或 `push_project(…, projectId)` 的返回值, 形如 `https://deta.city/design/`),按上面第 2–4 步打开——但需面板已登录。 @@ -126,13 +125,13 @@ Studio 就是deta.city 上的建筑性能应用。在 Codex 右侧内置浏览 前置与故障: -- 面板未登录 deta.city:用 `studio_link` 的一次性链接即可免手工登录(见上);只有拿不到 - `studio_link` 时才退化为手工:在面板里打开 `https://deta.city/login` 完成一次登录 +- 面板未登录 deta.city:用 `open_studio` 的一次性链接即可免手工登录(见上);只有拿不到 + `open_studio` 时才退化为手工:在面板里打开 `https://deta.city/login` 完成一次登录 (登录态写入该浏览器的 `ant_token` cookie 与 `ant-model-auth` localStorage,之后长期有效), 登录完成后重新打开 `studioUrl` 即自动加载项目。 - **宿主把 MCP 授权页开在哪个浏览器由宿主决定**(实测 Codex Desktop 走系统默认浏览器), 且**那一页的登录态不会进入面板**——所以别把"MCP 已授权"当成"面板已登录",两者要分别确认: - MCP 授权只解决 Codex↔服务端;面板登录解决 Studio 在面板里的会话(`studio_link` 正是两者的桥)。 + MCP 授权只解决 Codex↔服务端;面板登录解决 Studio 在面板里的会话(`open_studio` 正是两者的桥)。 实测口径:授权页在系统浏览器完成换码后停留在宿主的回调页("Authentication complete. You may close this window."),该页不归我们控制;授权页自身已改为**在隐藏框架内完成换码**并给出「打开 deta.city」 与「关闭本页」,不再顶层跳走。 @@ -187,6 +186,6 @@ Studio 就是deta.city 上的建筑性能应用。在 Codex 右侧内置浏览 `generate_candidates`、`analyze_gsa_issues`、`analyze_rules_compliance` 同步:`push_project`、`pull_project` 脚本与参考:`run_script`、`run_scripts`、`read_reference` -项目与查询:`list_projects`、`list_buildings`、`query_knowledge`、`parameter_sweep` -面板与 Studio:`open_studio`(打开 Studio 执行器:免密链接 + 轮询等上线,见「在右侧面板打开 Studio」一节)、 -`studio_link`(只要链接时用) +项目与查询:`list_projects`、`list_buildings`、`parameter_sweep` +(`query_knowledge` 已在远程形态裁出——它需要宿主注入知识库回调,无头/远程形态不接入,调用只会返回 unavailable) +面板与 Studio:`open_studio`(打开 Studio 执行器:免密链接 + 轮询等上线,见「在右侧面板打开 Studio」一节)