用途:对已有演示文稿(output.pptx)做精准、局部的修改,包括改错字、更新文本、应用原型变换重设幻灯片样式,以及通过 ops 补丁增删移动幻灯片。当用户想改某页文字、调整版式或做无需整体重建的目标性修改时使用。
前置条件:项目目录中已有 output.pptx;可选 slides.json(上下文)与 design-profile.json(用于 QA)。
使用方式:先用 find . -name "design-profile.json" -maxdepth 3 定位项目目录,之后命令均在项目目录内运行。定位目标用 uvx --from agent-slides slides inspect output.pptx --fields slides.slide_uid,slides.shapes.shape_uid,slides.title --out ids.json --compact,或用 slides find output.pptx --query "<search text>" --limit 10 --out find.json --compact 搜索文本;大文件可用 --page-size 与 --page-token 分页,也可用 --placeholders 0、--summary 查看占位符与摘要。修改前先评估:保留现有优点、明确影响范围与风险,避免过度编辑。文本修改示例:uvx --from agent-slides slides edit output.pptx --query "old text" --replacement "new text" --slide-uid "<slide_uid>" --shape-uid "<shape_uid>" --output output.pptx --compact;也可用 --slide、--slide-id、--shape-id 选择。版式变换:slides transform output.pptx --slide-uid "<slide_uid>" --to timeline --output output.pptx --compact。ops 补丁:slides apply output.pptx --ops-json @patch_ops.json --output output.pptx --compact,ops 文件包含 replace_text、add_text 等操作及 slide_index、坐标、font_size 等字段。改完用 find 或 inspect 验证,再运行 slides qa output.pptx --profile design-profile.json --slides-json @slides.json --out qa.json --compact,必要时用 slides repair。
限制与注意:--query 只替换文本内容,不改字体大小、颜色、加粗,需改格式应使用 ops 补丁;不要用猜测的占位符索引调用 set_placeholder_text,标准占位符应使用 set_semantic_text 配合 role(title、subtitle、body),只有在 inspect 或 template_layout.json 中取得精确 idx 时才用 set_placeholder_text。应先 inspect 再编辑,不要覆盖输入文件而不验证,也不应借此重构叙事或重写内容。出错时可运行 uvx --from agent-slides slides docs method:edit 核对当前契约。验收标准为改动可通过 find/inspect 验证、qa.json 返回 "ok": true,且无未解析 token 或契约级问题。