SuperAPI AI 工具集

designcraft-editor

设计与创作

查看项目

更新于 11-02 02:06

技能介绍

designcraft-editor 是 designcraft 的内嵌编辑器技能,用途是在支持 MCP Apps 或内置浏览器的宿主内打开 designcraft 的真实编辑界面,连接当前任务工作区,并让 Agent 的操作显示在同一页面。

主要能力与使用方式:先从当前已加载插件的工具列表找到 designcraft-editor 服务,使用本任务工作区的绝对路径调用 open_editor,首次调用传入 workspace;相对文件路径可在编辑器就绪后交给具体打开工具。宿主支持原生 MCP Apps 时呈现 ui://designcraft/panel.html,只有工具文字结果不代表界面已打开。Codex 未自动呈现面板时,可调用 open_browser_editor,把返回的 editorUrl 交给宿主的内置浏览器打开能力;Codex Desktop 可调用 open_in_codex,target 为 browser,url 为实际返回值。不要把本地页面路径猜成固定端口。

操作约束:同一实例只打开一个编辑页。调用 editor_status,待 attached 或 ready 为 true 再执行;加载失败先处理页面错误。本轮所有编辑使用同一服务。原生 CLI 与 Web 编辑器不是同一个内存文档,切换前必须先保存并显式重开。用 open_document/new_document 管理文档,inspect_document 与 get_story 核对内容;execute 执行命令,save_document 保存,render_page 逐页检查。

适用场景:需要在宿主内直接查看并操作 designcraft 编辑界面、让 Agent 操作与人工查看同屏时使用。限制与前提:如果宿主仅支持 MCP,工具调用能力与内嵌 UI 是两件事,可在外部浏览器使用同一个 editorUrl,但必须明确告知这不是宿主内嵌验收。开发候选缺少 ui/dist/adapter.mjs 时需先按插件 ui/README.md 构建,不要从任意缓存猜测路径,不要绕过校验。该技能独立安装不附带编辑器服务,需要安装配套插件或配置它的 MCP 后端。工具未注册时,可在得到插件实际目录后用项目终端运行 node ui/dist/adapter.mjs --serve,通过环境变量 CRAFT_WORKSPACE_ROOT 指定本任务工作区;保持该进程存活,此模式可展示 UI,自动化仍须连接对应 MCP 实例,不能另开一个后端声称共享会话。完成后保存工程并重开检查,读取实际导出文件;浏览器存储、预览截图和已提交渲染任务不等于工作区交付。