PPT Master 使用指南：AI 把文档变成可编辑的 PowerPoint
项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master PPT Master 是一个开源的 AI 演示文稿生成工具：把 PDF、DOCX、网页或一个主题交给它，它会在你的电脑上跑完整个流程，产出一个真正可编辑的 PowerPoint 文件。形状、文本框、图表、幻灯片母版和过渡动画都是原生 PowerPoint 对象，而不是图片或填好的模板。适合需要频繁产出汇报、课件、发布材料，又不想逐页排版的职场人、学生和创作者。
30 秒看懂 PPT Master 是什么
- 形态：它不是一个独立 App，而是一套在 AI 工具里运行的"工作流"（skill）——VS Code、Cursor、Claude Code CLI 等任何具备 agent 能力的工具都能驱动它，你只用聊天面板，不写代码。
- 解决的核心问题：多数 AI PPT 工具输出"图片 + 固定版式"，生成后无法深改；PPT Master 输出原生对象，每个元素都能点选、移动、改色、改写。
- 成本：项目本身免费开源，唯一花费是你自己的 AI 模型用量，没有 PPT 订阅费、积分或按席位收费。
- 数据流向：除与 AI 模型的通信外，转换、SVG 生成、PPTX 导出全部在本地完成，源文档不离开你的机器。
核心功能：可编辑 PPT 是怎么生成的
输出的是原生 PowerPoint 对象
生成结果落在 exports/<name>_<timestamp>.pptx。内部流程以 SVG（1280×720 px 画布）为中间格式，再转换为 DrawingML 形状写回 PPTX，文件里的文本、形状、渐变、阴影都是真实 PowerPoint 对象。走模板路线时，演示文稿还会带上真正的幻灯片母版与布局（p:sldMaster / p:sldLayout 继承），全局改一处即可生效。适合"交付后还要持续改稿"的场景。
几乎任何来源文件都能当输入
支持 PDF、DOCX、PPTX、EPUB、HTML、LaTeX、RST、Markdown、URL（含微信文章），以及直接粘贴进聊天的纯文本，AI 会先统一转成 Markdown 再生成。也可以只给一个主题、不给材料：流程会自动跑"主题研究"阶段，从公开网络收集事实素材。有素材想整理、只有一个想法让 AI 查资料，两种场景都覆盖。
叙事模式 × 视觉风格自由组合
生成前锁定两个独立选择：Mode（怎么讲：pyramid / narrative / instructional / showcase / briefing）和视觉风格（怎么长：swiss-minimal、dark-tech、editorial、glassmorphism 等，也可自定义），任意模式可配任意风格。若你有现成 .pptx，还有两条模板路线：把它变成可复用的 Brand / Style / Layout / Deck 工作区，或直接"用新内容填充这份 PPT"并保留原设计。
不止 16:9：多种画布格式
除标准 16:9、4:3 外，开箱支持小红书 3:4（如 --format xhs）、微信/Instagram 1:1、Story/TikTok 9:16、微信公众号头图、A4 打印版式。输出仍是含原生形状的 .pptx，方便按投放渠道改版。
从安装到跑通：最快上手步骤
先装 Python 3.10+（Windows 安装时记得勾选 "Add to PATH"，详细步骤见 docs/windows-installation.md）。然后克隆仓库并装依赖，一共三行命令：
git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master
cd ppt-master
pip install -r requirements.txt
接着用 AI 工具打开 ppt-master 目录（IDE 里 File → Open Folder；CLI 则 cd 进去再启动），把源文件放进 projects/，在聊天面板里说：
你：请根据 projects/q3-report/sources/report.pdf 创建一份 PPT
也可以直接把文本粘进聊天窗口。默认情况下 AI 会先和你确认设计规范（模板、画布、页数）再动手；想跳过就明确说"快速生成，不用确认"。完成后到 exports/ 取 .pptx 文件即可。
进阶用法
过渡动画与对象动画
默认是 fade 0.4 秒的页面过渡，元素动画关闭。导出时加参数即可启用 203 种进入/强调/路径/退出预设：
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto
-t push 可换页面过渡效果，也可写一份 animations.json 侧车文件精细控制每个对象的时序。
音频旁白与视频导出
每页的演讲者备注（notes/）可以转成逐页语音旁白并嵌回 PPTX，默认引擎 edge-tts（约 90 种语言）；也可以带上自己克隆的语音（ElevenLabs / MiniMax / Qwen / CosyVoice），只需提供 voice_id。之后在 PowerPoint 里直接导出带同步旁白的 MP4，不需要第三方工具，详见 docs/audio-narration.md。
实时预览与原生图表表格
生成过程中会自动打开浏览器预览页（默认 http://localhost:5050）：页面随 AI 生成实时渲染，你可以直接选元素改文字、颜色、拖位置，点 Apply changes 写回 svg_output/。图表和表格默认导出为可编辑的 SVG 衍生 DrawingML 形状，在 PowerPoint / Keynote / LibreOffice / WPS 中渲染一致；需要 Excel 式"编辑数据"时传 --native-charts-and-tables，符合条件的组会替换为 PowerPoint 原生 Chart/Table 对象，文件另存为 *_native_charts_tables.pptx。
常见问题
需要什么样的 AI 工具和模型？
任何能读写文件、执行命令、多轮对话的 agent 工具都行：VS Code、Cursor、Zed、Claude Code（CLI 或 IDE 插件）、Codex CLI、GitHub Copilot 等。官方推荐 Kimi K3 或大上下文窗口的 Claude，再搭配 gpt-image-2 之类的图像生成，整体效果上限最高。
使用成本高吗？
项目本身免费开源，唯一成本是你本就要支付的 AI 模型用量，没有额外的 PPT 订阅、专有积分或席位费。按订阅制的套餐做多少份 PPT 都不再加钱；按 token 的 API 只是另一种计价结构，PPT Master 自身不叠加费用。
没有图片生成 API 密钥怎么办？
有三条路：宿主 AI 工具自带图像生成时可直接用（无需单独密钥）；用内置的 image_search.py 零配置搜索 Openverse / Wikimedia Commons；或在 .env 里配置免费的 PEXELS_API_KEY / PIXABAY_API_KEY 提升图库质量。版权自动处理，需要署名时会在页面上加一行标注。
生成的文件能在别的软件里打开吗？
可以。基于形状的方案在 PowerPoint、Keynote、LibreOffice、WPS 中渲染一致。但动画效果以 Microsoft PowerPoint 为主要验证目标，其他软件可能重映射或省略个别效果——如果交付对动画敏感，请在 PowerPoint 里预览。
文档与资源
- docs/getting-started.md：快速上手，含模板、实时预览、动画、旁白
- docs/faq.md：模型选择、成本、排版问题排查
- docs/templates-guide.md 与 docs/templates-architecture.md：模板系统
- docs/audio-narration.md、docs/animations.md：旁白与动画详解
- docs/technical-design.md、docs/powerpoint-svg-mapping.md：架构与 PowerPoint 能力边界逐条对照
- examples/：21 个完整示例项目（论文讲解、数据报告、时尚周刊等），每个含
design_spec.md和svg_final/预览 - skills/ppt-master/templates/：内置可视化模板与图标库
- skills/ppt-master/SKILL.md：AI 读取的核心工作流规则
PPT Master 的价值分工很明确：AI 承担内容分析、排版和导出的重活，你拿到的是一份原生可编辑的文件，剩下的润色归你。它适合愿意装一点环境、有稳定 AI 模型渠道的人；如果你期待一键出完美终稿，或完全不想配置任何工具，它可能不是对的选择。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
