PPT Master：AI把文档变成可编辑PPT的三步指南
项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master 周四下午四点，领导丢来一份 60 页的 PDF，说周五上午要一份汇报 PPT。你打开浏览器搜了一圈"AI 做 PPT"，下载的全是一堆改不了字的图片。PPT Master 是条别的路：它把 PDF、Word 这类文档，直接变成原生可编辑的 PPTX 文件。
⚖️ 和同类 AI PPT 工具差在哪
| Gamma | Beautiful.ai | PPT Master | |
|---|---|---|---|
| 输出格式 | 图片幻灯片 | 图片/HTML 幻灯片 | 原生 .pptx，形状可逐个点击编辑 |
| 费用结构 | 按月订阅 | 按月订阅 | 工具免费开源，只付 AI 模型调用费 |
| 数据处理 | 文档上传云端 | 文档上传云端 | 除模型对话外，全程在本地机器上跑 |
Gamma 和 Beautiful.ai 的幻灯片本质上是一整张图片，你只能整页删重做；PPT Master 里每个文字框、形状、渐变都是 PowerPoint 原生对象。
🧠 SVG 转 DrawingML：为什么它输出的 PPT 真能编辑
AI 先把每页 PPT 写成 SVG（一种用坐标描述图形的矢量格式），再由脚本翻译成 DrawingML（PowerPoint 内部用的图形标记语言）。这两个格式底层都是"在坐标 x、y 放一个什么形状、什么颜色"，所以转换接近把日语翻译成英语的方言级改写，不是把图片硬掰进 PPT。结果是输出文件里的文本框、渐变、阴影、图表，你在 PowerPoint 里点哪个都能改。
🚀 从 PDF 到 PPTX 只要三步
10 分钟装好环境
前置要求只有一个：Python 3.10 及以上。
git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master
cd ppt-master
pip install -r requirements.txt
这一步完成后你会看到项目里的 examples/ 目录——21 个完整示例项目、280 页成品 PPTX 都在那里，随时可以下载下来打开对照。Windows 用户多两步 PATH 配置，照 Windows 安装指南走，10 分钟能搞定。
第一份 PPT 这样出
用支持 AI 代理的 IDE（Cursor、Windsurf、VS Code 装 Claude Code 插件等）打开项目文件夹，把 PDF 放进 projects/ 目录，然后在聊天面板里说：
请从 projects/q3-report/sources/report.pdf 做一份 PPT
AI 会先和你对一遍设计规范：模板、画幅、页数。确认后它依次完成内容分析、版式设计、SVG 生成和导出。这一步完成后你会看到 exports/ 目录下出现一个带时间戳的 .pptx——用 PowerPoint 打开，每个文字框、形状都是可点选编辑的独立对象，页面转场是原生动画。想跳过确认环节，直接说"快速生成一份 8 页的 PPT"就行。
进阶玩法：实时预览和一键旁白
最能打的两个功能。生成过程中，浏览器预览会自动打开在 http://localhost:5050：页面渲染你可以实时看；改错别字不用重新跑，点中元素就能直接改文字、颜色、字号。
旁白功能默认用 edge-tts，覆盖约 90 种语言环境。在聊天框里对它说：
为这份演示生成旁白，重新导出并嵌入音频
音频会嵌回 PPTX，之后用 PowerPoint 就能直接导出带同步配音的 MP4。如果你有自己的 .pptx 模板，也可以说"用这个模板填入新内容"，原有设计保持不变。
👀 眼见为实：21 个示例里挑 3 个看
你猜这张 Transformer 架构图是怎么进 PPT 的？examples/ppt169_attention_is_all_you_need/ 用一篇论文生成了 16 页技术演示：数学公式导出成 PowerPoint 原生公式对象，架构图是独立可编辑的形状，不是截图。
20 页的金融数据报告又是什么效果？examples/ppt169_global_ai_capital_2026/ 走彭博社风格的深色仪表板，柱状图、饼图、折线图都是可编辑的原生形状，不是画在背景里的图。
中文内容呢？examples/ppt169_cangzhuo/ 是一套 14 页的文化主题《藏拙》，水墨风配图为 AI 生成，中文排版、图注、页眉都按中文阅读习惯处理。
🛠️ 踩坑速查
- AI 跳步或忘了流程：让它重读 skills/ppt-master/SKILL.md。
- 视觉质量不理想：换大上下文模型，配图像生成接口——工作流定下限，模型定上限。
- 文字溢出、元素重叠：重跑那一页，或在实时预览里直接拖。
- 没有图像生成 API key：零配置网络搜索兜底，能跑通但图质参差。
- 长文档超上下文窗口：让生成分块运行，细节见 FAQ。
回到周四下午：你只需要把 PDF 丢进 projects 目录，告诉 AI 做什么。具体流程见 docs/getting-started.md。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
