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