AI Feeds
开源项目

ppt-master

ppt-master

AI驱动的PPT生成工具，能从任意文档直接输出原生可编辑的.pptx文件，支持形状、动画、演讲者笔记和音频旁白，还可自定义模板。亮点在于输出是真·PPTX，每个元素都可以在PowerPoint中直接点选编辑，而非图片堆砌；数据本地处理，无平台锁定。适合需要快速生成高质量演示文稿的职场人士，但对模型质量有要求，推荐使用Claude等大上下文模型以达到最佳效果。

README

PPT Master — 用 AI 从任意文档生成本地可编辑的 PPTX

Version License: MIT GitHub stars AtomGit stars The Agentic Leaderboard

hugohe3%2Fppt-master | Trendshift

English | 中文

本项目得以保持免费开源，得益于 PackyCode、APIKEY.FUN、RunAPI、优云智算 及其他赞助商的支持。
PackyCode 感谢 PackyCode 赞助本项目！PackyCode 是一家可靠、高效的 API 转发服务商，为 Claude Code、Codex、Gemini 等提供转发服务。PackyCode 为本项目用户提供专属优惠：使用此链接注册，充值时输入优惠码 ppt-master 即可享受 9 折优惠。
APIKEY.FUN 感谢 APIKEY.FUN 赞助本项目！APIKEY.FUN 是一家专业的企业级 AI 转发服务商，致力于为企业与开发者提供稳定、高效、低成本的 AI 接入服务。平台支持 Claude、OpenAI、Gemini 等主流模型，价格低至官方价格的 7%。通过我们的专属链接注册，可享独家福利：充值永久最高 5% 折扣。
RunAPI 感谢 RunAPI 赞助本项目！RunAPI 是一款高效稳定的 API 平台——一个 API Key 即可接入 OpenAI、Claude、Gemini、DeepSeek、Grok 等 150+ 领先模型，价格低至官方价格的 10%，稳定性出众，并与 Claude Code 等工具无缝兼容。RunAPI 为 PPT Master 用户提供专属福利：通过我们的专属链接注册并联系管理员，即可领取 7 元免费额度。
优云智算 感谢优云智算赞助本项目！优云智算是 UCloud 的 AI 云平台，提供国内外主流模型的一站式 API 服务，一个密钥即可调用全部模型。平台提供高性价比的 CodingPlan 套餐（涵盖 GLM5.2、Deepseek-v4 等），同时支持海外模型官方渠道稳定接入，满足多样化开发需求。兼容 Claude Code、Codex 等主流 AI 编程工具以及通用 API 调用。平台支持企业级高并发、7×24 小时技术支持及自助开票。通过此链接注册，最高可获 10 元免费额度，立即开始使用。

[!IMPORTANT]

这是一个工具，不是许愿池

不要指望它一次性交出完美无缺的成品。它的真正价值是替你完成大部分繁琐工作；剩下的打磨工作仍需你自己动手——可原生编辑的 PPTX 存在的意义，正是为了让你能继续加工，而不是一张无法触碰的扁平图像。使用的模型越便宜，你需要做的事就越多。最终结果的好坏，取决于你使用本项目以及 PowerPoint 的技巧。

在线体验 · 关于作者 Hugo He · 示例 · 常见问题 · 路线图 · 联系

下载新的配音版 Attention Is All You Need 幻灯片——在 PowerPoint 中播放，每一页会自动朗读。这只是 PPT Master 能力的冰山一角。

当然，你也可以下载下方六个示例幻灯片中的任意一个——在 PowerPoint 中打开原始 .pptx 文件，是感受本项目真正能力上限的最快方式。

Editorial magazine — Pritzker 2026 architecture review
编辑杂志风格——建筑摄影、宁静的排版网格
在线翻阅 · 下载 .pptx 		Data journalism — Global AI Capital 2026
数据新闻风格——Bloomberg 风格暗色仪表盘，图表驱动
在线翻阅 · 下载 .pptx 		Swiss typographic grid — Grid Systems primer
瑞士网格风格——严格的模块化网格、克制排版、红色强调
在线翻阅 · 下载 .pptx
Glassmorphism SaaS — AI Agent engineering demo
玻璃拟态 SaaS 风格——半透明图层、渐变深度、产品 UI
在线翻阅 · 下载 .pptx 		Memphis pop — Sugar Rush festival
孟菲斯波普风格——鲜艳原色、几何图案、活力满满
在线翻阅 · 下载 .pptx 		Risograph zine — Indie bookstore guide
Risograph 小册风格——双色印刷、手工感书店文化
在线翻阅 · 下载 .pptx

使用 Claude Opus 4.7 + gpt-image-2 生成。在线翻阅所有示例 → · examples/ 目录 · 为什么选择 PPT Master？

放入你的素材，拿回一份真正的 PowerPoint：可直接编辑、带有原生幻灯片切换和进入动画、可转为配音的演讲者备注，还能选择遵循你自己的 PPT 模板——一份开箱即用且可继续编辑的完整演示文稿。各功能的使用方法 → 快速入门。

⚠️ PPT Master 是一个工作流框架（harness），而非完整的 Agent（智能体）。 harness + model = agent——工具拥有工作流，而模型决定能力上限。要组合出真正高质量的 Agent，请使用 Claude（大上下文窗口约 1M tokens）+ AI 图像生成（gpt-image-2）。其他模型也能运行流水线，但无法达到同样的质量上限。如果结果令人失望，请升级模型——不要归咎于框架。

工作原理——PPT Master 是一个工作流（一种“技能”），在 Claude Code、Cursor、VS Code + Copilot 或 Codebuddy 等 AI IDE 中运行。你与 AI 对话——“基于这个 PDF 做份演示文稿”——它会按照工作流在你的电脑上生成一份真正可编辑的 .pptx。你无需编写代码，IDE 只是对话发生的地方。

你需要做的：安装 Python，安装一个 AI IDE，放入你的素材。

为何这样设计——掌握 Python 和 AI Agent 的使用会越来越重要。本项目旨在展示仅凭这两样东西你能走多远。如果你从零开始，确实有学习曲线，但这是一条值得攀登的曲线。做演示文稿只是借口——我真正想推动的是 Python 和 Agent。

PPT Master 与众不同：

  • 真正的 PowerPoint——如果不能被 PowerPoint 打开并编辑，就不应该称为 PPT。PPT Master 输出的每个元素都可以直接点击和编辑
  • 透明、可预测的成本——工具本身免费开源；唯一的成本是你的 AI 模型使用费。随着 AI 工具转向按用量计费，你只需为实际消耗付费——不需要额外订阅 PPT 服务
  • 数据留在本地——你的文件不应该为了制作演示文稿而被上传到别人的服务器。除了 AI 模型通信外，整个流水线都在你的机器上运行
  • 无平台锁定——你的工作流不应被任何单一公司挟持。支持 Claude Code、Cursor、VS Code Copilot 等；支持 Claude、GPT、Gemini、Kimi 等多种模型

AI 演示工具大致分为四类。PPT Master 只做最后一种：

类别 输出 能否在 PowerPoint 中逐元素编辑？
模板填充 从固定模板构建的 PPTX 部分可以——受模板限制
基于图像 每页一张大图，打包成 PPTX ❌ 每页是一张图片
HTML 演示 基于 Web 的演示 ❌ 不是 PPTX
原生可编辑（PPT Master） 真实的 DrawingML 图形、文本框、图表 ✅ 任意元素都可点击编辑

使用者的水平更重要

上面的示例都是一次生成——我甚至没有精修过；花些时间打磨，效果会截然不同。同样的 PowerPoint，设计师能做出令人惊艳的作品，而大多数人只接触过几个基础功能——区别不在于工具，而在于使用者。如果你暂时达不到那个水平，很可能是你还没学会工作流——从快速入门和示例项目开始。

最佳效果确实需要使用 Claude。在你嫌贵之前，想想雇佣专业人士制作同等水平的演示文稿要花多少钱。本项目也支持 GPT、Gemini、Kimi 等其他模型——效果自然会不同。指望以最低成本获得顶级输出，这本身就不合理。

由 Hugo He 打造

我是一名金融专业人士（CPA · CPV · 咨询工程师（投资）），经常审阅和编辑演示文稿。我希望 AI 生成的幻灯片在 PowerPoint 中依然可编辑，而不是被压平为图片——于是有了这个项目。

🌐 个人网站 · 📧 heyug3@gmail.com · 🐙 @hugohe3

快速开始

1. 前置条件

你只需要 Python。 其他一切通过 pip install -r requirements.txt 安装。

依赖项 必需？ 作用
Python 3.10+ ✅ 是 核心运行时——你唯一需要实际安装的

总结——安装 Python，运行 pip install -r requirements.txt，就可以开始生成演示文稿了。

Windows —— 请参阅专门的分步指南 ⚠️

Windows 需要额外几步（PATH 设置、执行策略等）。我们为 Windows 用户编写了分步指南：

📖 Windows 安装指南 —— 从零开始，10 分钟内生成可用的演示文稿。

快速版：从 python.org 下载 Python → 安装时勾选“Add to PATH” → pip install -r requirements.txt → 完成。

macOS / Linux —— 安装即用
# macOS
brew install python
pip install -r requirements.txt

# Ubuntu / Debian
sudo apt install python3 python3-pip
pip install -r requirements.txt
特殊情况备用 —— 99% 的用户不需要

Pandoc —— 仅旧版文档格式需要：.doc、.odt、.rtf、.tex、.rst、.org 或 .typ。.docx、.html、.epub、.ipynb 由 Python 原生处理——无需 pandoc。

# macOS
brew install pandoc

# Ubuntu / Debian
sudo apt install pandoc

2. 选择 Agent（智能体）

PPT Master 可在任何具备 Agent 能力的工具中运行——能够读写文件、执行命令并维持多轮对话。

类型 示例 说明
IDE 原生 Agent • VS Code 架构（VS Code 本身及其分支和衍生品）：Cursor、Trae、Codebuddy IDE、Windsurf、Void 等
• 其他架构：Zed 等		 内建 Agent 的编辑器
IDE 插件 / 扩展 GitHub Copilot、Claude Code（VS Code / JetBrains 扩展）、Cline、Continue、Roo Code 等 安装在 VS Code 或 JetBrains 等宿主中
CLI Agent Claude Code CLI、Codex CLI、Aider、Gemini CLI 等 在终端中运行；适用于脚本、远程或服务器场景

模型推荐：为获得最佳效果，请使用 Claude Opus 搭配 gpt-image-2；Gemini 3.5 Flash 目前性价比很高——速度特别快，值得一试。

🔑 想用 Claude / GPT / Gemini 但还没有访问权限？ 项目赞助商 PackyCode、APIKEY.FUN 和 RunAPI 提供按量付费的 Claude、GPT、Gemini 等接入服务——无需订阅，并为本项目用户提供专属折扣（详情见页面顶部）。

🔀 同时管理多个服务商？ 如果你持有多个服务商的密钥，cc-switch 是一款跨平台桌面应用，可一键切换 Claude Code、Codex、Gemini CLI 等工具的 API 服务商，无需手动编辑配置。

3. 设置

选项 A — 下载 ZIP（无需 Git）：在 GitHub 页面上点击 Code → Download ZIP，然后解压。

选项 B — Git 克隆（需要安装 Git）：

git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master

然后安装依赖：

pip install -r requirements.txt

后续更新（选项 A / B）：python3 skills/ppt-master/scripts/update_repo.py

选项 C — 技能市场：仓库自带了 .claude-plugin/marketplace.json，因此可以通过 Claude Code 插件市场 生态系统安装：

# 跨 Agent CLI（Claude Code、Cursor、Codex 等）
npx skills add hugohe3/ppt-master

# 或在 Claude Code 中
/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master

以上两种安装路径仅获取技能文件（非完整仓库）；你仍需要在安装位置运行 pip install -r requirements.txt 才能执行后续处理脚本。

4. 创建

提供源素材（推荐）：将你的 PDF、DOCX、图片或其他文件放入 projects/ 目录，然后在 AI 聊天面板中告知 AI 使用哪些文件。获取路径最快捷的方式：在文件管理器或 IDE 侧边栏中右键点击文件 → 复制路径（或 复制相对路径）并直接粘贴到聊天中。

你：请从 projects/q3-report/sources/report.pdf 创建 PPT

直接粘贴内容：你也可以直接将文本内容粘贴到聊天窗口中，AI 会根据内容生成 PPT。

你：请将以下内容转为 PPT：[在此粘贴你的内容...]

无论哪种方式，AI 都会首先确认设计规格：

AI：好的。让我们确认设计规格：
    [模板] B) 自由设计
    [版面] PPT 16:9
    [页数] 8-10 页
    ...

AI 会处理一切——内容分析、视觉设计、SVG 生成和 PPTX 导出。

输出：原生图形 .pptx（可直接编辑）保存到 exports/<名称>_<时间戳>.pptx。svg_output/ 的副本始终会快照到 backup/<时间戳>/svg_output/，用于重新导出/存档。传递 --svg-snapshot 可在 exports/ 中额外生成一个 SVG 图像预览版 pptx 并列于原生 pptx 旁（参见常见问题）。需要 Office 2016+。

已有想要复用的 .pptx？ 将那份 PPT 连同你的新素材交给 AI，告诉它“用新内容填充这份 PPT”——它会将文本、表格和图表数据填入你现有的设计中，仅导出你选择的页面，且保持原生可编辑。参见常见问题和模板填充工作流。

AI 丢失上下文了？ 请它阅读 skills/ppt-master/SKILL.md。

出了问题？ 查看**常见问题**——涵盖模型选择、布局问题、导出问题等。根据实际用户反馈持续更新。

5. 图片获取（可选）

对于非用户提供的图片，有两种途径可以混合使用于同一份 PPT 中：

对于基于 API 的功能，在 .env 中填写凭据。克隆安装可使用 cp .env.example .env；技能市场安装应使用持久化用户配置：

mkdir -p ~/.ppt-master
cp /path/to/installed/ppt-master/.env.example ~/.ppt-master/.env

PPT Master 依次读取：当前进程环境变量，然后按照以下顺序找到的第一个 .env：当前工作目录、技能目录（例如 ~/.agents/skills/ppt-master/.env）、克隆仓库根目录、~/.ppt-master/.env。

A) AI 生成 —— image_gen.py。设置 IMAGE_BACKEND 以及对应服务商的 *_API_KEY（OPENAI_API_KEY、GEMINI_API_KEY 等），流水线会自动调用。运行 python3 skills/ppt-master/scripts/image_gen.py --list-backends 可查看完整的后端列表。gpt-image-2 是目前最佳默认选择。

B) 网络图片搜索 —— image_search.py。零配置即可工作，但配置 PEXELS_API_KEY / PIXABAY_API_KEY（两者均免费）可获得更高质量的结果。没有密钥时，搜索仅使用 Openverse / Wikimedia Commons；这在备用时很有用，但图片质量可能参差不齐，因为许多结果是普通用户上传的。有了密钥后，默认服务商链还会附加 Pexels / Pixabay，这能显著改善现代图库摄影、人物、工作场景、生活方式和插画内容的覆盖。默认优先注重质量：CC0、公有领域、Pexels / Pixabay 免署名许可、CC BY 和 CC BY-SA 被一同考虑，当所选图片需要署名时，Executor 会添加一行内联致谢。仅当某张幻灯片完全不能容忍任何署名行时，才使用 --strict-no-attribution。对于高影响力的封面、产品照片、肖像和品牌场景，优先顺序为：用户提供的高分辨率素材 / AI 生成 > 配置了 Pexels / Pixabay 密钥的网络搜索 > 零配置网络搜索。

完整参考：image-generator.md（AI） · image-searcher.md（网络）。

文档

文档 说明
📘 快速入门 三步完成第一份 PPT，以及如何使用模板、实时预览、动画、配音、声音克隆（新用户从这里开始）
🆚 为什么选择 PPT Master 与 Gamma、Copilot 及其他 AI 工具的对比
🪟 Windows 安装指南 面向 Windows 用户的分步设置指南
📖 SKILL.md 核心工作流和规则
📐 画布格式 PPT 16:9、小红书、微信及 10+ 种格式
🛠️ 脚本与工具 所有脚本和命令
💼 示例 所有示例项目
🏗️ 技术设计 架构、设计理念、为何使用 SVG
❓ 常见问题 模型选择、成本、布局排错、自定义模板

参与贡献

请参阅 CONTRIBUTING.md 了解如何参与。

许可证

MIT

致谢

SVG Repo · Tabler Icons · Simple Icons · Phosphor Icons · Robin Williams（CRAP 原则）

相关工具

cc-switch —— 跨平台桌面应用，用于管理并在 Claude Code、Codex、Gemini CLI 等工具间一键切换 API 服务商。在以上 Agent 中运行 PPT Master 时非常方便。

联系与合作

想合作、将 PPT Master 集成到你的工作流中，或有疑问？

Star 历史

Star History Chart

赞助商与支持

PPT Master 目前主要由我一个人构建和维护。每个新模板、Bug 修复和文档更新都需要持续的资源——目前由以下赞助商和个人支持者共同承担。

企业赞助商

<a href="https://www.p

开源项目hugohe32026-06-27原文

相关内容