DeckCraft 用于创建和编辑演示文稿,涵盖幻灯片、形状、文本、图表与放映等内容。该技能通过 DeckCraft 提供的结构化自动化接口来操作应用,包括控制协议、MCP 服务器和 CLI。其目标是操作用户正在使用的演示文稿,并尽量保留可编辑的幻灯片内容。
用途与接口:
- 桌面控制:通过回环 TCP 连接,采用按行分隔的 JSON 传输,并非 HTTP 或 MCP JSON-RPC。每行发送一个请求,按 id 匹配回复,并在执行依赖操作前检查 ok 状态。
- MCP 服务器:推荐优先使用已连接的 MCP 服务器,提供 inspect_document、inspect_slide、add_slide、add_shape、add_text_box、set_text、insert_picture、insert_table、insert_chart、render_slide 等工具。使用前应查看各工具的 schema。
- CLI:用于一次性文件操作,提供 info、run、render、convert 等子命令。
deckcraft-cli mcp --connect PORT可操作与可见应用相同的演示稿;deckcraft-cli mcp启动独立的无头引擎,不会改变用户当前窗口。
主要能力:
通过 engine.commands 查询命令 ID 与参数说明;通过 engine.execute 传入 {command, params} 执行。文档提到的结构化命令包括 slide.new、shape.insert、shape.connect、format.、design.theme、table.、chart.*、transition.set、animation.set 等。几何单位是幻灯片点(1/72 英寸),文档示例的 16:9 幻灯片为 960 × 540,自定义尺寸需实际检查。
使用方式要点:
- 先查找可用的 DeckCraft 工具、可执行文件和已有会话,优先复用已有会话。
- 在 POSIX 系统用
command -v deckcraft deckcraft-cli检查;在 Windows 用where deckcraft deckcraft-cli。若不在 PATH 中,可检查应用安装位置,例如 macOS 的 /Applications 与 ~/Applications,或使用mdfind -name DeckCraft.app;不要臆造可执行文件路径。 - 需要桌面会话时,可用
deckcraft --control PORT启动,文档中 7990 为上游示例。 - 编辑前先检查演示文档、活动幻灯片、版式、分区、形状和选区,使用实际返回的 ID,并区分形状 ID 与幻灯片索引。
- 多个命令依赖当前幻灯片或选区时,先确认其状态。MCP 批量操作在首次出错时停止,应检查部分结果后再继续。
- 若修改超时或丢失回复,先检查结果再重试,避免重复插入幻灯片或形状。
- 手势交互用 ui.tool.select 选工具,并通过 ui.pointer 发送幻灯片空间事件;ui.move、ui.click、ui.drag 使用屏幕坐标,操作前检查窗口、画布与幻灯片矩形。
- 放映相关可使用 show.start 与 show.end;若任务涉及时序、逐步构建、导航或媒体播放,应在实际放映中验证。
- 预览可用 ui.render、MCP render_slide、ui.screenshot 或 MCP screenshot;无头渲染不需要可见窗口。
保存与导出:
使用桌面端 app.open、app.save、app.export,或 MCP 的 open_presentation、save_presentation、export。CLI 的 run 支持重复 --cmd 'ID=JSON',并可配合 --save OUT、--export OUT;不同 CLI 调用之间的内存编辑不共享,保存后可继续处理。convert 导出图像时只输出第一张幻灯片;需要完整预览可用 render --all。PDF 导出可通过 file.export 参数区分幻灯片、备注页与讲义。保存后应验证输出文件存在且可读,必要时重新打开检查持久性,并审查导出结果的格式保真度。
适用场景:
适合通过 AI 或脚本批量创建、修改和审查演示文稿,自动化生成幻灯片预览,导出 PDF 或图像,以及在保留可编辑内容的前提下执行结构化编辑。
限制:
该技能本身不安装 DeckCraft,也不配置 MCP 服务器;如果没有可执行文件或可用连接,需要报告缺少前置条件。控制协议快照为 2026-10-14 下载的上游未修改版本,MCP 工具与安装方式应参考上游文档,不要借用其他应用的参数或 schema。