用途
cadcraft-editor 是 cadcraft 的内嵌编辑器技能,用于在支持 MCP Apps 或内置浏览器的宿主内打开 cadcraft 的真实编辑界面,连接当前工作区,并让 Agent 的操作显示在同一页面中。
主要能力
从当前已加载插件的工具列表中找到 cadcraft-editor 服务后,可使用其工具打开编辑界面。宿主支持原生 MCP Apps 时,界面以 ui://cadcraft/panel.html 呈现。编辑操作包括:用 open/new_drawing 打开或新建图纸,用 query_entities 核对几何,用 execute 执行命令,用 save 保存,用 render 预览。
使用方式
首次调用 open_editor 时传入任务工作区的绝对路径 workspace;相对文件路径可在编辑器就绪后交给具体打开工具。仅工具返回文字结果不代表界面已打开。
当 Codex 未自动呈现面板时,可调用 open_browser_editor,把返回的 editorUrl 交给宿主的内置浏览器打开能力;Codex Desktop 可调用 open_in_codex,target 为 browser,url 为实际返回值。不要将本地页面路径猜成固定端口。
同一实例只打开一个编辑页。调用 editor_status,待 attached 或 ready 为 true 后再执行;加载失败应先处理页面错误。本轮所有编辑使用同一服务。
若工具未注册,可在得到插件实际目录后用项目终端运行 node ui/dist/adapter.mjs --serve,并通过环境变量 CRAFT_WORKSPACE_ROOT 指定本任务工作区,保持该进程存活。此模式可展示 UI,但自动化仍须连接对应 MCP 实例,不能另开一个后端声称共享会话。
适用场景与限制
适用于需要在宿主内查看并操作 cadcraft 编辑界面的场景。宿主仅支持 MCP 时,工具调用能力与内嵌 UI 是两件事,可在外部浏览器使用同一个 editorUrl,但必须明确告知这不是宿主内嵌验收。原生 CLI 与 Web 编辑器不是同一个内存文档,切换前必须先保存并显式重开。开发候选缺少 ui/dist/adapter.mjs 时需先按插件 ui/README.md 构建,不要从任意缓存猜测路径,不要绕过校验。该技能独立安装不附带编辑器服务,需要安装配套插件或配置其 MCP 后端。完成后应保存工程并重开检查,读取实际导出文件;浏览器存储、预览截图和已提交渲染任务不等于工作区交付。