用途
保真改 PPT 是一个围绕 PowerPoint 的本地工作流与质量层,而非 PowerPoint 原生编辑器的替代品。它的首要定位是“保真修改”:当用户提出修改、修复、优化、重设样式或修复既有演示文稿的请求时(如“改PPT”“修改这份PPT”“只改第X页”“别动其他页”“edit this pptx”“revise this deck”等),它只改动用户点名的幻灯片或对象,保持其余内容不变,并输出可编辑的 .pptx。
它的次要能力是从素材生成新的可编辑 PPTX 或网页风格演示文稿,触发词包括“create PPT”“生成PPT”“做PPT”“杂志风PPT”“网页PPT”等,但资料明确指出生成是次要模式,不应把修订/修复请求变成从零重做。
主要能力
保真编辑模式的核心是使用原生、保留包结构的对象编辑路径,逐字复制每个包部件,仅重新序列化被点名的幻灯片(以及该幻灯片图表操作涉及的图表部件),因此未被触碰的幻灯片、Logo、母版、版式、主题、媒体与链接保持字节级一致。
支持的原生操作包括:
- 文本:
--replace OLD=NEW或操作replace_text - 样式:操作
style_text,可设字体、字号、加粗、颜色(可选匹配) - 表格:操作
replace_table_cell,按行列或查找文本定位 - 形状:操作
set_shape_geometry,以磅为单位移动或缩放(按索引/名称/文本匹配) - 图表:操作
replace_chart_text、set_chart_value,仅重写关联的图表部件
支持通过 edits.json 在单次调用中执行多页或混合操作。若某操作不匹配任何内容,即使是被点名的幻灯片也保持字节一致。
使用方式
运行脚本前先检查环境(需要 Python 3.10+)。若存在 ${SKILL_DIR}/.venv 则优先使用其中的 Python;否则安装轻量核心依赖:
bash ${SKILL_DIR}/scripts/bootstrap.sh --profile core
--profile core 仅安装 requirements-core.txt,不含 Chromium 与 npm。需要源文件转换、图像生成或 Playwright 渲染时使用 --profile all 或 visual-review。脚本出现 ModuleNotFoundError 时,按路由安装对应的可选依赖,不应跳过该步骤。
保真编辑的典型流程为先检视再编辑:
python3 ${SKILL_DIR}/scripts/preserve_edit_pptx.py --list <source.pptx>
python3 ${SKILL_DIR}/scripts/preserve_edit_pptx.py <source.pptx> <repaired.pptx> \
--slide <N> --replace "旧文本=新文本" --report <fidelity-report.json>
多页/混合操作:
python3 ${SKILL_DIR}/scripts/preserve_edit_pptx.py <source.pptx> <repaired.pptx> \
--edits edits.json --report <fidelity-report.json>
单页单操作:--op '{"op":"style_text","size":24,"bold":true}'。
当提供既有 PPTX 作为视觉或品牌参考时,可运行 pptx_template_import.py 并带 --manifest-only --reference-style-mode style-only,用生成的 reference-style.json 复用母版/版式节奏、主题字体与颜色、占位符、图表处理与常见页面角色,而不复制私有内容。
生成模式的基本序列为:输入 → 故事板 → 设计与生成 → 精修与交付。
适用场景
- 对已有品牌模板做局部修改,且其他页面必须保持不变
- 修复演示文稿中的指定问题页
- 复用既有演示文稿的母版与版式节奏生成新内容(生成模式)
- 在用户仅给出简短主题或“帮我做个 PPT”时,按固定回退策略产出可编辑或网页风格演示文稿
限制
- 保真报告是硬性门槛:
safe必须为 true,只有预期的幻灯片/图表部件可被修改,不得新增或删除部件,否则为硬失败,须停止并报告,不得交付。 - 对编辑器尚不支持的原生操作(增删幻灯片、插入新图片、重建表格结构、自由重设计),不应整份往返处理,而应返回针对这些对象的简短 PowerPoint/WPS 操作步骤。
- 若当前环境不可用编辑器,则不应生成修复后的 PPTX,应立即返回操作步骤。
- 若某个选定问题无法在不破坏锁定的前提下改进,则保留原始页面并报告用户需做出的确切决定。
- 严禁为局部修复而将整份源演示文稿导入再导出经 Artifact Tool、SVG 或其他重建管线,这些路径可能改变母版、透明度、占位符、分组对象、链接与未触碰的幻灯片。
- 实际原生编辑后,需通过 PowerPoint、WPS 或 LibreOffice 渲染改动页并全尺寸检查前后差异;出现可见对象缺失、背景变黑/改变、Logo 破损、链接变化或非预期移动均为硬失败。
- 不得仅凭文本/规则检查就宣称成功或给出 Verified 凭证,必须有渲染后的视觉复核。
版本与能力层级说明
资料标注为 v7.0.0-beta.1:保真编辑为 RC;upm make 生成可编辑演示文稿为 Beta(形状可编辑的 DrawingML,而非原生 a:tbl/图表数据对象);upm make --format web-deck 为实验性 SVG HTML 预览(非杂志风 GA);Kimi 导出为实验性/非正式;自动修复仅限有限的溢出字体缩小与修复计划,并非完整的两轮执行器。正式模式拒绝占位符或无来源交付。优先使用 bin/upm 质量门,CLI 退出码 0 表示必需门已通过。
其他具体收费、价格、平台支持等信息资料暂未提供。