文章正文
这个项目属于 AI 辅助做 PPT 的工具类项目，核心不是套模板，而是在你本机生成一份真正能在 PowerPoint 里逐元素修改的文件。
它把 PDF、Word、网页、图片等素材交给 AI，按一套固定工作流出一份原生 .pptx，每个形状、文本框、图表都能点开改。
和市面上把每页压成一张大图的方案不同，它走的是”原生可编辑”路线，作者明确把它定位成全场少有的正经做 PPT 的选手。
仓库里带了 viewer.html 本地翻页预览器，examples 目录下还有多套已经生成好的成品 deck 可以直接打开看效果。
工作流本身免费开源，唯一成本是你自己的 AI 模型用量，文件处理都在本机完成，数据不需要上传到别人的服务器。
如果你经常要交可编辑的 PPT、又不想被某个平台或模板绑架，这份源码值得下载下来研究一下。
源码简介
这是一套在 AI IDE（Claude Code / Cursor / VS Code Copilot）里运行的 PPT 生成工作流源码。
它用 Python 在本地把素材转成原生可编辑的 PowerPoint 文件，形状、文本框、图表都以 DrawingML 对象导出，打开后能继续改。
源码基于 MIT 协议开源，适合想学习”AI 生成可编辑 PPTX”实现思路、或需要在本机批量产出演示文稿的开发者下载研究。
适用场景
- 需要用 AI 快速产出可二次编辑 PPTX 的个人或团队
- 已有 .pptx 模板、希望按内容批量填充结构的场景
- 想把演讲者备注自动合成语音旁白、制作带讲解的视频
技术栈与运行环境
- 前端：viewer.html / index.html 本地翻页预览器（原生 HTML/JS，无构建依赖）
- 核心语言：Python 3.10+ 工作流，skill 定义驱动 agent 执行
- 关键依赖：python-pptx（生成 DrawingML 形状/文本框/图表）、edge-tts（逐页旁白音频）、PyMuPDF（PDF 解析）、XlsxWriter
- 运行环境：本机 Python + 支持 agent 的 AI IDE；模型可切换 Claude / GPT / Gemini / Kimi 等
- 其他：requirements.txt 内已列出可选依赖，按需 pip 安装
功能亮点
- 原生可编辑 PPTX 输出：README 与 requirements.txt 均指向 python-pptx，scripts/svg_to_pptx.py 明确把 SVG 元素转成可编辑 DrawingML 形状。
- 演讲者备注转语音旁白：requirements.txt 含 edge-tts，scripts/notes_to_audio.py 可在 Windows / macOS / Linux 生成逐页旁白音频。
- 支持基于自有 .pptx 模板填充：README 写明可”参考你自己的 PPT 模板来设计”，适合沿用现成版式。
- 多源素材导入：源码内置 source_to_md 处理 docx / html / epub / ipynb，README 还列了 PDF、网页、图片等输入方式。
- 原生转场与入场动画：README 说明产物带 PPT 原生转场，入场动画可按需开启（默认关闭）。
- 本地翻页预览器：仓库根目录 viewer.html、index.html 提供翻页查看，examples 下多套 deck 可直接体验。
安装与部署提示
- 安装 Python 3.10+ 并勾选加入 PATH（Windows 用户参考 docs/zh/windows-installation.md）。
- 获取源码后执行 pip install -r requirements.txt（或 skills/ppt-master/requirements.txt）。
- 在支持 agent 的 AI IDE 中按工作流运行，把素材放进项目即可生成 .pptx。
- 需要转小众格式（.doc / .odt / .tex 等）时再装 Pandoc，常规 docx / html / pdf 由 Python 原生处理。
截图与演示说明
- 在线翻页预览页 viewer.html，examples 下多个 deck 可翻看（普利兹克奖、全球 AI 资本、瑞士网格等）。
- examples/ 内置成品 deck 及其 exports/*.pptx 导出文件，可在 PowerPoint 打开验证可编辑性。
- docs/assets/screenshots/ 下多套风格封面预览（杂志风、新闻财经风、瑞士风、毛玻璃、孟菲斯、Zine 等）。
- 技术脚本页：skills/ppt-master/scripts/ 下的 svg_to_pptx.py、notes_to_audio.py、source_to_md/ 等。
常见问题
#### 需要联网或付费吗？
工具本身免费开源（MIT），唯一成本是自备 AI 模型的用量。文件处理在本机完成，数据不出本地，不绑定任何平台。
#### 适合二次开发吗？
源码是 Python 工作流加 skill 定义，目录结构清晰，脚本可单独调用（如 svg_to_pptx.py 批量转 SVG），方便按需扩展或接入自有流程。
安全风险提示
特别提示：本项目未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本项目依赖 AI 模型能力生成内容，运行前需自备可用的模型接入方式。
GitHub项目开源地址：https://github.com/hugohe3/ppt-master
