SuperAPI AI 工具集

deckcraft-editor

办公与效率

查看项目

更新于 11-04 23:02

技能介绍

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

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

同一实例只打开一个编辑页,调用 editor_status,待 attached 或 ready 为 true 再执行;加载失败先处理页面错误。本轮所有编辑使用同一服务;原生 CLI 与 Web 编辑器不是同一个内存文档,切换前必须先保存并显式重开。演示文稿的创建与打开使用 open_presentation/new_presentation,操作与核对使用 add_slide、inspect_slide、inspect_document,保存使用 save_presentation。

适用场景:需要在宿主内嵌界面中实时查看并操作 deckcraft 演示文稿、连接指定工作区进行编辑、让 Agent 操作与人工界面保持同一页面的场合。

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