docs(plugin): 技能同步 studio_link 并入 open_studio、query_knowledge 已裁出

对应 ant-copilot 的两处收敛:打开 Studio 只留 open_studio(追加 waitSeconds 确认 executor_online 的典型节奏);query_knowledge 因需宿主注入知识库回调、远程形态不接入,已从工具一览移除并说明原因。
This commit is contained in:
ringo
2026-09-11 15:39:58 +08:00
parent c21a979c0c
commit 63d52f47b5
+10 -11
View File
@@ -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/<id>`)、
`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/<projectId>`),按上面第 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」一节)