SuperAPI AI 工具集

ultimate-ppt-master

办公与效率

查看项目

更新于 10-16 13:08

技能介绍

用途

保真改 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 表示必需门已通过。

其他具体收费、价格、平台支持等信息资料暂未提供。