多页批量编辑

August 7, 2026 · View on GitHub

Ultimate PPT Master

编辑的克制，生成的锋利。
把真实资料变成可继续修改的 PowerPoint。
一套本地优先的演示文稿工作台：对已有 PPTX 做保真局部编辑，
或从原始素材生成可编辑幻灯片（Editable Deck · Beta）。

_{仓库曾获 160+ Stars；2026-08 短暂转私有后，GitHub 不恢复私有化前的 Stars。感谢每一位点亮过它的朋友，欢迎再次点亮。}

v7 统一架构（upm CLI）· Beta

当前 main / v7 内核定位为 v7.0.0-beta 技术预览：架构方向正确，但质量门与多入口尚未完全收敛。CLI 返回 0 才表示该模式下的 required gate 已通过；失败产物会移至 exports/draft/。

能力	状态	说明
Preserve Edit	RC	包级保真编辑；真实 PowerPoint 矩阵仍待签字
Editable Deck	Beta	DeckIR→PPTD→本地 shape-editable DrawingML PPTX（非原生 `a:tbl`/chart 数据对象）；正式模式禁止占位交付
Web Deck	Experimental	`upm make --format web-deck` 现为 SVG HTML Preview，不是杂志风/Swiss 成品 Web Deck
Kimi Adapter	Experimental / 非正式交付	依赖就绪 ≠ 导出已验证；正式交付只用 `--export-backend local`

谁做什么： 纯 CLI 可完成 plan→compile→export→quality gates；Agent/LLM 仅在需要 brief 增强时介入。ZIP/python-pptx 打开 ≠ 真实 PowerPoint 排版签字。自动修复 = 溢出有限缩字号 + 修复计划，不是通用两轮执行器。

规范规划核心： Python upm plan / upm.compiler.planner（deterministic-draft-planner）是 DeckIR 的 source of truth。Bridge/Desktop 默认 shell 到该核心；JS/独立大纲规划器仅为 legacy fallback。

bin/upm plan <source> --emit bridge   # 规范 DeckIR（Bridge/Desktop 共用）
bin/upm make <source-or-topic>        # 生成可编辑 PPTX（默认）
bin/upm edit <file.pptx> "修改要求"    # 保真局部修改；或 --edits edits.json
bin/upm open <project>                # PPTD 视觉精修
bin/upm review <project>              # 重新审计（失败非 0）
bin/upm doctor                        # 环境检查（只报告）

详见 upm-cli.md、HTTP API 说明、upm-v7-unification.md 与 upm-migration.md。

HTTP API？

没有公网多租户「一键生成 PPTX」HTTP 服务。服务器批处理请直接跑 bin/upm make。本机可选 Agent Connect Bridge（127.0.0.1 编排 handoff，不单独制造最终 PPTX）。完整说明：docs/guides/http-api.md。

社区与生态

Socialistic 徽章（上方）：可选在线试用入口，便于留下使用 trace；不替代本地 upm 质量门与正式交付。
Open Design 等插件生态：欢迎社区以 MIT 方式封装工作流插件；本仓库当前不内置官方 Open Design 插件包。有具体 manifest PR 可再开讨论。

能力一览

保真改 PPT — 对已有品牌 PPTX 指哪改哪，母版 / logo / 链接字节级不动。
一分钟安装 — 复制粘贴一条命令，本机即用；无需登录，无 API 依赖。
正式办公 PPTX — 从素材生成可编辑的 PowerPoint，母版、链接、对象字节级保真。
AI Web Deck（实验） — 网页版演示预览（SVG HTML Preview）；杂志风/Swiss 成品仍在收敛，见上方 v7 状态表。
成品与 Proof — 每个案例附改前改后渲染、质量报告与 Release 证据。
已知限制 — 诚实边界见 FAQ 与已知边界，不做夸大承诺。

设计哲学

"内容决定节奏，装饰不能代替论据。"

Ultimate PPT Master 不是又一个「输入主题、输出模板」的幻灯片生成器。它被设计为一间 编辑工作室——像杂志主编审稿一样对待每一页幻灯片：构图有据可查，色彩承担结构角色，留白即是节奏。

它解决两个问题，各有各的锋利：

◢ 保真编辑

你已经有一份带品牌的 PPTX。

领导发来的、客户给的、模板套好的真实文件——你只需要改几处数字或结论，却不能把母版、logo、印章和超链接一起弄坏。

Ultimate PPT Master 把 .pptx 当作 zip 包：没点名的 part 原样拷贝，只重写你指定的页。 改完交回一份 fidelity report，写明改了什么、多少部分原样没动。

改了 3 处 · 封面 / 第 4 页 / 第 6 页
其余 78 个部件原样保留

◤ 从零生成

你还没有 PPT，只有散落的素材。

PDF、Word、Excel、网页、粘贴文字——先确认故事板和证据链，再选择视觉方向，逐页生成，最终交付：

可编辑 PPTX — 正式汇报、咨询方案、政务材料
Web Deck（实验） — 网页预览；正式杂志风成品暂未开放

每一页都经过 brief 增强、证据定级、视觉审查，不是模板填空。

保真编辑：只改第 1 页标题，其余部分原样不动

_{真实样例：仅修改第 1 页标题。可复现 — python3 scripts/make_preserve_demo_proof.py}

快速开始

Agent 技能（推荐）

npx skills add kdnsna/ultimate-ppt-master-skill --skill ultimate-ppt-master

该命令会把整个技能包复制到本机（约 100MB，含桌面端与示例）。还需要装一次轻量 Python 依赖（保真编辑引擎本身纯标准库，但生成路线需要）：

cd ~/.agents/skills/ultimate-ppt-master
bash scripts/bootstrap.sh --profile core

然后对你的 Agent 说：

把这份 PPT 第 3 页的「Q2」改成「Q3」，第 6 页结论换成附件新数字，别的都别动。

用这份材料做一份 10 页可编辑 PPTX，正式汇报风格。

命令行（零第三方依赖）

# 查看每页内容
python3 scripts/preserve_edit_pptx.py --list deck.pptx

# 改一页文字
python3 scripts/preserve_edit_pptx.py deck.pptx out.pptx \
  --slide 1 --replace "Q2=Q3" --report fidelity.json

# 样式 / 表格 / 图表 typed ops
python3 scripts/preserve_edit_pptx.py deck.pptx out.pptx \
  --slide 2 --op '{"op":"style_text","size":24,"bold":true}'

# 多页批量编辑
python3 scripts/preserve_edit_pptx.py deck.pptx out.pptx --edits edits.json

edits.json 示例：

[
  { "slide": 1, "replacements": { "Q2": "Q3" } },
  { "slide": 4, "operations": [
      { "op": "replace_table_cell", "row": 2, "col": 1, "text": "128" }
  ]},
  { "slide": 6, "operations": [
      { "op": "set_chart_value", "series": 1, "point": 2, "value": 42 }
  ]}
]

桌面端

git clone https://github.com/kdnsna/ultimate-ppt-master-skill.git
cd ultimate-ppt-master-skill
npm run setup && npm run desktop

拖入 .pptx → 选页 → 编辑 → 保存。原文件永不覆盖。

MCP Server（接入任意 Agent）

python3 scripts/ppt_preserve_mcp.py

零依赖 stdio MCP，暴露 inspect_pptx / edit_pptx_preserving 两个工具。详见 MCP 接入指南。

编辑能力

操作	说明
文本	标题、正文、标注 — 查找替换
样式	字体 / 字号 / 粗体 / 颜色，可按文本定位
表格	按行列坐标或内容查找改单元格
形状	移动、缩放（单位 pt）
图表	图例 / 标签文字、数据点数值
保真门禁	改动清单 + 意外变更即失败，绝不交付损坏文件

_{暂不支持：增删整页、插入新图、重建表格结构、自由画布重排 — 这些请回 PowerPoint / WPS 收尾。}

视觉体系

Ultimate PPT Master 内建一套完整的设计合约，而非随机美化：

Paper
#F6F3ED
_{暖白编辑面} Ink
#171714
_{标题与正文} Mineral Blue
#1D4ED8
_{证据与强调} Signal Coral
#D9573B
_{决定性结论} Sage
#73866C
_长期视角

排版即角色系统 — 展示用衬线、证据用无衬线、正文用黑体、元数据用等宽，各司其职
封面默认浅色 — 暗色封面是显式的艺术指令，不是自动行为
色彩即结构 — 颜色标记章节边界、证据归属、风险与行动，而非装饰
柔边合约 — 容器圆角 8-14 pt (PPTX) / 12-20 px (Web)，保持编辑纪律

完整设计系统详见 DESIGN.md。

架构

scripts/preserve_edit_pptx.py        保真引擎（标准库，CLI + apply_edits API）
        │
        ├── apps/desktop             桌面端 · 拖拽编辑
        ├── scripts/ppt_preserve_mcp.py   MCP Server · 接入任意 Agent
        ├── SKILL.md                 Agent Skill · Cursor / Claude / Codex
        └── apps/web + apps/bridge   在线工作台 · 浏览器 + 本地桥接

你是	选择
业务同学	桌面端，拖进去改
Cursor / Claude / Codex 用户	安装 Skill，自然语言指挥
构建自己的 Agent	MCP 或 CLI / `apply_edits` API
开发者 / CI	CLI + fidelity report 门禁

作品展示

样例	查看
正式可编辑 PPTX · 脱敏经营复盘	下载 PPTX · 关键页预览
杂志风 Web Deck · 编辑美学（预览）	完整演示

本地优先

文件默认不离机。桌面端和 MCP 在本机运行，源文件与产物留在本地。需要模型能力时走你自己配置的 Provider；纯保真编辑可完全离线。

为银行、政务、法务场景而设计。

文档


安装	INSTALL · Agent 安装
保真编辑	定位说明 · 场景 Prompt
从零生成	选择交付路线 · Web 体验
接入	MCP Server · Agent Bridge · Provider 配置
设计	设计系统 · 视觉合约
故障排查	troubleshooting
版本	v6.3.9 发布说明
中文文档索引	docs/zh-CN

FAQ

会动我的模板和 logo 吗？
不会。没点名的 package part 原样拷贝，一个字节都不动。

支持 WPS 吗？
支持。输出标准 .pptx，WPS 与 PowerPoint 均可继续编辑。

改坏了怎么办？
永不覆盖原文件。每次编辑附带 fidelity report，核对变更范围。

和 pptlint 什么关系？
pptlint 做交付前检查，发现问题后用 Ultimate PPT Master 做保真修复。

已知边界

保真编辑覆盖文本、样式、表格单元格、形状几何与图表数值；增删页 / 插图 / 重建结构不在范围
不做「导入再整份导出」：已有 PPTX 只能逐页保真修复，不能整份导入后重导出
像素级改前改后对比需本机 LibreOffice，否则产出矢量对比卡
从零生成由本地 Agent 驱动，不是托管云服务
无 Canva 式多人画布或云账号

_{MIT · 如果它帮你把「差点能交」的幻灯片收成了「能交出去的那份」，欢迎 Star。}