Ultimate PPT Master
编辑的克制，生成的锋利。
把真实资料变成可继续修改的 PowerPoint。
一套本地优先的演示文稿工作台：对已有 PPTX 做保真局部编辑，
或从原始素材生成可编辑幻灯片（Editable Deck · Beta）。
English · 在线工作台 · 作品集 · 文档
-FFD700%3Fstyle%3Dflat-square)
仓库曾获 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 页标题。可复现 — 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 门禁 |
作品展示
本地优先
文件默认不离机。桌面端和 MCP 在本机运行，源文件与产物留在本地。需要模型能力时走你自己配置的 Provider；纯保真编辑可完全离线。
为银行、政务、法务场景而设计。
文档
FAQ
会动我的模板和 logo 吗？
不会。没点名的 package part 原样拷贝，一个字节都不动。
支持 WPS 吗？
支持。输出标准 .pptx，WPS 与 PowerPoint 均可继续编辑。
改坏了怎么办？
永不覆盖原文件。每次编辑附带 fidelity report，核对变更范围。
和 pptlint 什么关系？
pptlint 做交付前检查，发现问题后用 Ultimate PPT Master 做保真修复。
已知边界
- 保真编辑覆盖文本、样式、表格单元格、形状几何与图表数值；增删页 / 插图 / 重建结构不在范围
- 不做「导入再整份导出」：已有 PPTX 只能逐页保真修复，不能整份导入后重导出
- 像素级改前改后对比需本机 LibreOffice，否则产出矢量对比卡
- 从零生成由本地 Agent 驱动，不是托管云服务
- 无 Canva 式多人画布或云账号
MIT · 如果它帮你把「差点能交」的幻灯片收成了「能交出去的那份」，欢迎 Star。
评论