PPT Master 使用指南：把 PDF 变成原生可编辑的 PowerPoint，三步完成
项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master 手上有一份 30 页的 PDF 报告，明天上午要汇报。把文件放进 PPT Master 的 projects/ 目录，在 AI 聊天框里说一句"做成 PPT"，得到的是一份 .pptx——里面的形状、文本框、图表都是 PowerPoint 原生对象，可以逐个点开修改，而不是套死的图片或填好的模板。PPT Master 是一个开源（MIT 协议）的 AI 演示文稿工作流，整个流程跑在你自己的电脑上，你只需为使用的 AI 模型付费。
它能做什么：从一份文档到一份完整演示文稿
- 输入几乎不限：PDF、DOCX、Markdown、EPUB、HTML、网页链接，也可以直接把文本粘贴进聊天框
- 输出是真 PPT：元素是 DrawingML 原生形状和文本框；图表和表格默认导出为跨软件渲染一致的可编辑形状，加参数
--native-charts-and-tables可换成带"编辑数据"功能的 PowerPoint 原生图表对象 - 转场与动画：默认带 fade 页面转场；对象动画按需开启，内置 203 种进入、强调、路径、退出预设
- 多种画布比例：内置 8 种——16:9、4:3、小红书 3:4、微信 1:1、竖版故事 9:16、公众号头图、横幅和 A4 打印
- 自带模板库：19 套品牌模板（麦肯锡、Google、微软等）、12 种叙事风格、30+ 图表原型，以及可复用的页面版式
它和别的 AI 做 PPT 工具有什么不同
生成的是原生对象，不是图片
多数工具把每页渲染成图片或固定文本块，改一处动全身。PPT Master 输出的每个矩形、渐变、阴影都可以在 PowerPoint 里点选编辑；走模板路线时还会生成真正的幻灯片母版和版式，全局改一处、整份生效。
数据留在本地
除了你与 AI 模型之间的正常通信，文档解析、SVG 生成、PPTX 导出全部在本机运行，源文件不经过任何第三方服务器。
不绑定平台和模型
它本质上是一个"技能包"，跑在任何支持 AI 代理的工具里：VS Code、Cursor、Zed 这类带智能体的 IDE，或 Claude Code、Codex 这类命令行工具。模型侧 Claude、GPT、Gemini、Kimi 都能驱动，推荐组合见文末建议。
从 0 到第一份 PPTX 的最短路径
前置要求只有 Python 3.10 以上，安装就一行：
git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master
cd ppt-master
pip install -r requirements.txt
用任意支持 AI 代理的工具打开这个目录（VS Code 里 File → Open Folder 即可），把源文件放进 projects/ 目录，然后在聊天框给出路径：
你：请根据 projects/q3-report/sources/report.pdf 做一份 8 页的 PPT
AI 会先和你确认页数、比例和设计方向，然后依次完成内容分析、排版、配图、SVG 生成和导出，最终在 exports/ 目录得到带时间戳的 .pptx。不想逐条确认的话，说一句"快速生成、不用问我"就进入单次直出模式。生成过程中浏览器会打开本地预览页（默认 localhost:5050），可以看着每一页实时渲染出来。
Windows 用户要多处理 PATH 和执行策略，仓库里有专门的分步文档：docs/windows-installation.md。
进阶能力：预览编辑、模板填充与语音旁白
三个容易被忽略、但实际很好用的功能：
浏览器可视化编辑。 预览页里可以直接选中元素改文字、换颜色、拖位置，全程不用 AI；也可以选中元素写下批注意见，让 AI 只重画那一块再重新导出。
用你现有的 PPT 当模板。 两条路线：把新内容填进你现有 .pptx 的版式里（保留原设计，只替换文字、表格和图表数据）；或者先把喜欢的 PPT 提炼成可复用的品牌/风格/版式工作区，之后每次都基于它生成新稿。模板体系的完整规则见 docs/templates-guide.md。
语音旁白与视频。 让 AI 把每页演讲者备注转成配音并嵌回 PPTX（默认 edge-tts，覆盖约 90 种语言），之后在 PowerPoint 里一键导出带同步旁白的 MP4。也支持用 ElevenLabs、MiniMax 等平台的克隆音色朗读整份文稿。
其余能力一笔带过：网页搜图零配置可用（配 Pexels/Pixabay 密钥质量更高），AI 生图支持 gpt-image-2 等后端，公式可导出为 PowerPoint 里可编辑的对象。
资源与生态：21 个示例项目可以直接拆着看
examples/ 目录下有 21 个完整示例项目，覆盖论文讲解、数据新闻、时尚周刊、建筑设计、文化随笔等主题。每个项目都保留了 design_spec.md（设计规格）、notes/（逐页演讲备注）和 svg_final/（可直接在浏览器打开的预览页），是了解"什么输入产出什么稿子"最快的方式。
文档按阅读顺序排：
- 新手入口：docs/getting-started.md
- 选型与取舍：docs/why-ppt-master.md
- 技术架构（为什么用 SVG 中转）：docs/technical-design.md
- PowerPoint 与 SVG 的能力对照：docs/powerpoint-svg-mapping.md
- 常见问题（模型选择、排版排错）：docs/faq.md
模板库在 skills/ppt-master/templates/，全部脚本与命令说明见 skills/ppt-master/scripts/README.md。
适合谁，从哪开始
如果你经常要把手头文档、报告或主题变成对外演示，并且希望成品能继续手工打磨，PPT Master 值得装一份；如果你要的是"一次生成、永远不改"的图，普通生成器就够。建议从 examples/ 里挑一个你熟悉的主题，把它导出的 .pptx 用 PowerPoint 打开，看看"可编辑"到底意味着什么，再决定要不要上手。
实操建议：驱动模型推荐 Kimi K3 或 Claude，上下文窗口越大越好（约 1M tokens 级别），配图搭配
gpt-image-2效果最稳。生成的是"高质量可编辑初稿"，模型越弱返工越多——结果不满意时先换更强的模型，再对照 docs/faq.md 排查排版和导出问题。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
