























今天在 GitHub Trending 上看到一个有意思的项目:PPT Master,它能通过 AI 直接从任意文档(PDF、DOCX、图片等)生成真正的 PowerPoint 文件——不是图片拼接,而是每个元素都可以在 PowerPoint 中直接编辑的原生 DrawingML 图形。
PPT Master 是一个开源的 AI 演示文稿生成工作流,核心设计理念是:AI 生成的 PPT 必须是真正可编辑的 PowerPoint,而不是一张张打包进 PPTX 的图片。
核心特性:
.pptx 模板,让 AI 填充新内容,保持品牌设计一致gpt-image-2 等模型,还能生成幻灯片语音旁白作者 Hugo He 本身是一位 CPA / CPV / 投资咨询工程师,日常工作中需要审阅和修改大量演示文稿,这个工具源于他"让 AI 生成的 PPT 能够在 PowerPoint 里直接改"的实际需求。
PPT Master 的本质是一个结构化工作流(skill/harness),而非独立的应用程序。它运行在具有 agent 能力的 AI IDE 中,充当 AI 与 PowerPoint 生成引擎之间的协调层。
用户输入(文档 / 文本)
↓
AI IDE Agent
(Claude Code / Cursor / etc.)
↓
PPT Master 工作流
(skill/SKILL.md 定义流程)
↓
┌─────────────────────────┐
│ 内容解析 & 布局规划 │
│ 视觉设计 & SVG 生成 │
│ PPTX 导出(python-pptx)│
└─────────────────────────┘
↓
输出:.pptx 文件
| 组件 | 技术选型 | 作用 |
|---|---|---|
| Python 3.10+ | 运行时 | 核心依赖 |
python-pptx | PPTX 生成 | 构建原生 DrawingML 形状 |
| SVG 渲染 | 视觉元素 | 生成图标、装饰图形 |
| AI 模型 | 内容理解 + 设计规划 | 核心智能层 |
gpt-image-2(可选) | 图片生成 | 生成幻灯片封面等配图 |
| Pexels/Pixabay API(可选) | 图库搜索 | 提供高质量免版权图片 |
作者在 README 中特别指出:
PPT Master is a harness, not a complete agent.
harness + model = agent— the tool owns the workflow; the model sets the ceiling.
这意味着输出的质量上限取决于所选 AI 模型的能力。推荐使用 Claude Opus(约 1M token 上下文)配合 gpt-image-2,可达到官方示例中的设计水准;Gemini 3.5 Flash 则是当前性价比最优的选择。
PPT Master 提供了两条图片获取路径:
IMAGE_BACKEND + 对应 API Key):调用 gpt-image-2 等模型自动生成配图PEXELS_API_KEY 或 PIXABAY_API_KEY 可获得更高质量的商业图库资源# 方式一:下载 ZIP(无需 Git)
# GitHub 页面 → Code → Download ZIP,解压即可
# 方式二:Git clone
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
# 安装依赖(唯一必需步骤)
pip install -r requirements.txt
Windows 用户建议阅读 docs/windows-installation.md 获得详细的分步指引。
projects/ 目录请用 projects/report.pdf 制作一个 PPT,主题是季度报告
exports/<name>_<timestamp>.pptx直接粘贴文本内容:
你:请把以下内容做成 PPT:[粘贴文本内容]
使用已有模板填充新内容:
将你的 .pptx 模板文件路径发给 AI:
你:请用 templates/brand-deck.pptx 填充 projects/q3-report/sources/report.pdf 的内容
生成带旁白的演示文稿:
你:基于 projects/talk.md 制作一个 15 页的 PPT,并在每张幻灯片中添加语音旁白
调整画布格式:
PPT Master 支持多种画布格式(16:9 演示、小红书笔记、微信公众号封面等),在设计确认阶段告诉 AI 你需要的格式即可。
Q: AI 生成的 PPT 效果不好怎么办?
A: PPT Master 是 harness(工具),model 是 agent(大脑)。效果上限由模型决定。升级模型(如从 GPT-4o 换成 Claude Opus)+ 配合 gpt-image-2 图片生成,效果会显著提升。不要因为模型能力不足而否定工具本身。
Q: 安装时报错 Module not found?
A: 确保已执行 pip install -r requirements.txt,且使用的是 Python 3.10+ 环境。可用 python3 --version 确认版本。
Q: 导出的 PPTX 打开是空白或格式错乱? A: 检查使用的 Office 版本是否在 2016 以上(不支持 Office 2013 及更早版本)。另确认 AI 选择的模型是否上下文窗口足够大(建议 200k+ tokens)。
Q: 如何使用自定义模板?
A: 在 AI IDE 中将你的 .pptx 文件路径发给 AI,并明确说明"用这个模板"或"填充这个模板"。AI 会保留模板中的版式、配色、字体,只替换文字和数据内容。
Q: 图片质量参差不齐?
A: 配置 Pexels/Pixabay API Key(免费额度足够个人使用),图片质量会大幅提升。参考 docs/getting-started.md 中的 .env 配置说明。
PPT Master 解决了一个非常具体的痛点:现有 AI PPT 工具要么输出图片式"假 PPT",要么需要昂贵的专属订阅。PPT Master 通过工作流+harness的方式,将 AI 的内容理解能力与原生 PPTX 生成能力解耦,让你用自己信任的 AI 模型、自己的 PowerPoint,做真正可编辑的演示文稿。
唯一需要注意的是,这个工具的使用效果高度依赖 AI 模型的能力——花时间学习工作流、用更强的模型,产出质量会明显更好。如果你对演示文稿有较高要求,又恰好已经在用 Claude Code 或 Cursor,这绝对是一个值得一试的组合。
GitHub 地址: https://github.com/hugohe3/ppt-master
官方示例: https://hugohe3.github.io/ppt-master/
作者网站: https://www.hehugo.com/
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。