PPT Master：一个让 AI 生成真正可编辑 PowerPoint 的开源工具

它是一套跑在 AI IDE（比如 Claude Code、Cursor、VS Code + Copilot）里的工作流，你在 IDE 的对话框里说"用这份 PDF 做一份 PPT"，AI 按这套工作流在你本机生成一个真正可编辑的 .pptx。

项目采用 MIT 开源协议，最新版本 v2.7.0（2026 年 5 月发布）。作者是 Hugo He，一位金融从业者（CPA · CPV · 投资咨询工程师），因为工作中经常需要审核编辑演示文稿，不想让 AI 生成的幻灯片变成"改不动的图片"，因此有了这个工具。

核心能力

原生可编辑

这是 PPT Master 最核心的卖点。它生成的 .pptx 文件里，每个形状、文本框、渐变、阴影都是 PowerPoint 原生对象。不是图片，不是 HTML 转换的产物——是你在 PowerPoint 里双击就能直接编辑的东西。

模板复用

你可以把一个已有的 .pptx 文件作为模板，让 AI 把新内容填进去。它会提取原设计中的主题色、字体、母版结构，保留你的视觉风格。也支持用 /create-template 命令将任意 PPTX 转为可复用模板。

AI 配图

两种配图方式可以混用：

• AI 生成：支持 gpt-image-2、Nano Banana 等模型，根据内容自动生成配图
• 网络搜索：支持 Pexels、Pixabay 等免费图库，零配置也能用（配置 API Key 后图片质量更好）

动画与旁白

• 页间切换动画和元素入场动画
• TTS 语音旁白：能把演讲者备注转成音频，在 PowerPoint 播放时自动朗读每页内容
• 支持声音克隆，可以用自己的声音做旁白
• 可以导出为 MP4 视频

多格式输出

不只有 PPT 一种格式，还支持：

• PPT 16:9 / 4:3
• 小红书封面 3:4
• 朋友圈 1:1
• 竖版 9:16 手机海报
• 以及更多自定义画布尺寸

数据全在本地

源文件在本地转换，SVG 在本地生成，PPTX 在本地导出。唯一外发的是你和 AI 编辑器的对话。对金融、法务、政府等有数据合规要求的场景来说，这意味着敏感文档不需要上传到第三方服务器。

工作原理

PPT Master 的工作方式可以简化成这样：

你的源文件（PDF/Word/Markdown/网页）
        ↓
   AI 分析内容，制定大纲
        ↓
   AI 逐页设计版面，生成 SVG
        ↓
   svg2ooxml 转换引擎处理
        ↓
   输出原生可编辑 .pptx

关键技术点是 SVG→DrawingML 转换。SVG 和 DrawingML 本质上都是基于绝对坐标的二维矢量格式，一个矩形、一个渐变、一个阴影，在 SVG 里怎么写，在 DrawingML 里就有对应写法。PPT Master 底层依赖一个叫 svg2ooxml 的 Python 包来做这个转换。

整个过程中，AI 扮演四个角色接力工作：策略师负责理解需求和制定大纲，图片生成师负责配图，执行师负责逐页生成 SVG 和排版，优化师基于设计原则做视觉微调。

怎么用

1. 安装环境

只需要 Python 3.10 以上版本：

git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

Windows 用户有一份专门的安装指南，从零到能用大约 10 分钟。

2. 选择 AI 编辑器

PPT Master 可以在任何一个支持 agent 能力的工具里运行：

• Claude Code（CLI 或 VS Code 扩展）
• Cursor
• VS Code + GitHub Copilot
• Windsurf、Zed、Cline、Continue 等等

打开你常用的 AI 编辑器，把工作目录指向 ppt-master 项目文件夹就行。

3. 准备素材

把你的源文件放进 projects/ 目录。支持的格式：

• PDF 文档
• Word 文档（.docx）
• Markdown 文件
• 网页链接（包括微信公众号文章）
• 纯文本（直接粘贴到对话框）

4. 开始生成

在 AI 编辑器的对话框里输入指令，比如：

请用 projects/report.pdf 生成一份 PPT，风格简洁商务，8-10 页

AI 会先和你确认几个设计参数（模板风格、画布尺寸、配色倾向），然后逐页生成。10 页左右的文档大约需要 10-20 分钟。

生成的文件在 exports/ 目录下，直接用 PowerPoint 打开就能编辑。

模型选择与成本

PPT Master 本身免费，唯一的花费是 AI 模型的使用费。官方推荐搭配：

效果差异主要来自 AI 生成 SVG 的质量——越强的模型，排版越稳定，细节越到位。如果生成结果不够理想，升级模型比调参数管用。

项目也支持 GPT、Gemini、Kimi 等其他模型，但官方明确表示 Claude + 大上下文窗口 + gpt-image-2 的组合能达到最高质量上限。

资源与链接

• GitHub 仓库：github.com/hugohe3/ppt-master
• 在线 Demo：hugohe3.github.io/ppt-master
• 示例项目：examples 目录
• 新手入门指南：Getting Started
• Windows 安装指南：Windows Installation
• 常见问题：FAQ
• 作者网站：hehugo.com