PPT Master AI PPT生成完整指南：把文档变成原生可编辑的PowerPoint
项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master PPT Master 是一个开源的 AI 工作流工具：它接收 PDF、DOCX、Markdown 甚至一个纯主题，产出一份原生可编辑的 PowerPoint 文件（.pptx）。与把幻灯片渲染成图片的方案不同，它生成的是真正的 PowerPoint 对象——形状、文本框、图表、表格都能在 PowerPoint 里直接点选编辑；整个流程在你本机运行，不绑定任何特定 AI 平台或模型。
🔧 它是怎么工作的
产物形态：可编辑对象，而不是图片
PPT Master 的最终产物是 exports/ 目录下的标准 .pptx 包。文件内部是 PowerPoint 的原生对象模型：带调整手柄的原生形状与连接线、具备完整段落与字体格式的文本框、可按需导出的数据图表与表格、真实的 OOXML 切换与元素动画，以及可以转成语音旁白的演讲者备注。把它打开后，你对任何元素做的修改都是对 PowerPoint 对象本身的修改，而不是对一张位图的修补。
基本原理：用约束式 SVG 做中间语言
直接让 AI 写 OOXML 过于冗长且脆弱，直接把每页渲染成图片又会丢掉原生对象模型。PPT Master 的折中方案是：AI 以一套受项目契约约束的 SVG 作为视觉创作语言，逐页写入 svg_output/，再由确定性的 Python 脚本把 SVG 编译成原生 DrawingML。SVG 与 DrawingML 都是绝对坐标的二维矢量格式，矩形、路径、渐变、阴影几乎一一映射，所以这次转换更接近"方言互译"而非格式桥接——这是产物能达到原生深度而非"扁平可编辑皮肤"的原因。
一个典型项目目录长这样：sources/（源材料）、design_spec.md 与 spec_lock.md（设计规范与执行契约）、svg_output/（原始 SVG）、svg_final/（自包含预览）、exports/（最终 PPTX）、notes/（每页演讲者备注）。
✍️ 核心功能详解
内容分析：先推理叙事，再动手画页面
在画第一页之前，工作流会先执行 Strategist 阶段：通读源材料、确定核心信息、选择叙事模式——pyramid（结论先行的说服）、narrative（故事线）、instructional（教学）、showcase（展示）、briefing（中性简报）——然后搭建大纲和信息层级。同一份材料，不同模式会得到完全不同的骨架结构；拆分、合并、重排、删减都由推理决定，而不是照搬源文档的顺序。确认后，决策写入 design_spec.md 和 spec_lock.md，作为后续所有页面必须遵守的契约。
设计生成：逐页产出 SVG，附带实时预览
AI 逐页把 SVG 写入 svg_output/，第一页会先过一道专门的质量门，之后的页面连续产出。期间本地会开一个浏览器预览（默认 localhost:5050），你可以看着页面逐张渲染出来。预览支持两条修改路径：一是不经过 AI，直接在侧边面板改文本、颜色、字号，拖动或用方向键挪位置，点击 Apply changes 后写回 svg_output/；二是点击某个元素写下修改意见提交，然后在聊天里说一句"apply my annotations"，AI 会重写那一块并重新导出 PPTX。
风格与模板：内置 18 种风格，复用现成 PPT 有两条路径
视觉风格与叙事骨架是两个独立维度，可自由组合。内置风格从 swiss-minimal、editorial 到 dark-tech、brutalist、ink-wash，另有 custom 选项。如果你手里已经有一份想复用的 .pptx，有两条明确的路径：
- Fill Native PPTX：克隆源 PPT 的页面外壳，直接在 OOXML 里替换文本、表格和图表数据，原设计保持原生状态，适合"换内容不换版式"的季度报告场景。
- Create Template：把参考 PPT 提炼成可复用的 Brand（品牌识别）、Style（视觉方法）、Layout（页面结构）、Deck（完整演示应用）工作区，之后生成新 PPT 时指定该工作区，得到带真实幻灯片母版（
p:sldMaster）与版式继承的成品。
导出与交付：动画、旁白和多画幅
导出由 finalize_svg.py 和 svg_to_pptx.py 完成，写出 exports/<name>_<timestamp>.pptx。图表和表格默认导出为 SVG 派生的可编辑 DrawingML 形状，好处是在 PowerPoint、Keynote、LibreOffice、WPS 间渲染一致；加上 --native-charts-and-tables 参数后，符合条件的图表表格会替换为 PowerPoint 原生数据对象，拥有 Edit Data 工作簿，代价是跨软件渲染可能有差异——两者都完全可编辑，选择权在你。
页面切换默认 fade，另有 203 个原生入场、强调、路径、退出动画预设可选，动画是真实的 OOXML 时序数据而不是嵌入视频。演讲者备注可以用 edge-tts（约 90 种语言）合成为每页语音并嵌回 PPTX，PowerPoint 即可把它导出为带旁白的 MP4；也可以接入 ElevenLabs 等平台的克隆音色。画幅不限于 16:9，4:3、小红书 3:4、1:1 方图、9:16 竖版、A4 打印都在同一条管线内。
🚀 上手流程
环境要求
- Python 3.10+
- 一个具备 agent 能力的 AI 工具（能读写文件、执行命令、多轮对话）：Claude Code、Cursor、VS Code + Copilot、GitHub Copilot 等，任选其一
- 仅当需要处理
.doc、.rtf、.tex等旧格式时才额外要 Pandoc；.docx、.html、.epub由 Python 原生处理
安装只需三条命令
git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master
cd ppt-master
pip install -r requirements.txt
一次完整调用
用 AI 工具打开项目目录，把源材料放进 projects/ 目录，然后在聊天窗口输入："请用 projects/q3-report/sources/report.pdf 制作一份PPT"。默认情况下，AI 会先和你确认设计规范——模板还是自由设计、画幅比例、页数——确认后自动完成内容分析、图像获取、SVG 生成与导出。赶时间可以直接说"快速生成，不需要和我确认"，它会跳过交互一轮做完，但注意快速模式没有中间规划文件，上下文丢失后需要重跑。最终的 .pptx 位于项目下的 exports/ 目录，直接在 PowerPoint 打开继续修改即可。
🎯 适用场景与边界
比较适合的情况：
- 成品后续要在 PowerPoint 里持续编辑——改一句文案、换一张图、更新图表数据，甚至交给同事接手
- 数据不能出本机，比如金融、政府等对数据驻留有要求的组织（除你自己与 AI 模型的通信外，管线全程本地）
- 需要反复套用统一品牌或版式，比如季度汇报、系列课程
- 希望 AI 先把论证结构和叙事理清楚，而不是只把页面排好看
不太适合的情况，项目文档自己也说得很直白：
- 想要打开浏览器立刻出结果：它需要装 Python、克隆仓库、配置 AI 工具，且 10 页左右的演示文稿生成需要 10–20 分钟
- 实时多人协作编辑、分享链接场景：它是本地文件，没有协作层
- 期待"一次生成即完美"：官方定位是高质量的可编辑草稿，收尾判断留给你
- SmartArt、嵌入式 OLE 对象、宏等明确不在支持范围；动画与部分特效以 Microsoft PowerPoint 为校验目标，Keynote、WPS 等软件打开时个别效果可能映射不同
README 还有一条提醒值得记住：模型决定质量上限。效果不理想时，先换更大的上下文窗口和更强的布局能力模型（项目推荐 Kimi K3 或 Claude 搭配 gpt-image-2 之类的图像生成），再回头核对用法。
📂 仓库资源导航
- Getting Started：从第一份 PPT 到模板、实时预览、动画、旁白、声音克隆的完整入门
- Technical Design：约束式 SVG 中间语言、导出管线与质量门的完整架构
- FAQ：源格式、模型选择、布局排错等，基于真实用户反馈持续更新
- Templates Guide：模板使用、提炼、边界的三条路径详解
- PowerPoint ↔ SVG Mapping Guide：逐功能的原生支持边界记录（原生 / 近似 / 需烘焙 / 不支持）
- Why PPT Master 与 Project Positioning：设计动机、产品承诺与能力边界
- Windows Installation：Windows 环境分步安装指南
- Examples：21 个完整示例项目、共 280 页，含《Attention Is All You Need》论文深读（带对象级动画与旁白导出版），每个项目都保留设计规范、SVG 源与导出产物
- SKILL.md：AI 执行工作流时遵循的核心规则
下一步
建议的路径是：按 Getting Started 装好环境，用你手边一份真实的文档生成第一份演示文稿；生成前后各花几分钟打开 示例的导出文件，在 PowerPoint 里点选其中的形状、表格和公式——"原生可编辑"这五个字的分量，摸过之后就有体感了。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
