Files

shumengya 50edff80f5 feat: 导出 SproutClaw .sproutclaw 配置

包含 extensions、skills、prompts、settings、auth、models、mcp 等配置。
排除 node_modules、npm 缓存、sessions 等运行时数据。

2026-06-26 15:48:56 +08:00

24 KiB

Raw Permalink Blame History

PPT Master — AI 生成原生可编辑 PPTX，支持任意文档输入

English | 中文

_{本项目由 PackyCode、APIKEY.FUN 等赞助方支持，得以持续免费开源。}

	感谢 PackyCode 赞助了本项目！PackyCode 是一家稳定、高效的 API 中转服务商，提供 Claude Code、Codex、Gemini 等多种中转服务。PackyCode 为本项目的用户提供了特别优惠，使用此链接注册并在充值时填写"ppt-master"优惠码，可以享受 9 折优惠。
	感谢 APIKEY.FUN 赞助了本项目！APIKEY.FUN 是一家专业的企业级 AI 中转站，致力于为企业和开发者提供稳定、高效、低成本的 AI 中转服务。平台支持 Claude、OpenAI、Gemini 等主流热门模型，价格低至官方原价的 7%。通过本项目专属链接注册，还可享受最高永久充值 95 折专属优惠。

Important

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

别指望一把就给你一份完美的成品 PPT。它真正的价值是帮你把大部分枯燥的活儿干掉，剩下的打磨交给你——做原生可编辑的 PPT，本就是为了让你接着改，而不是甩给你一张改不动的图。模型越便宜，要补的人工就越多。成品好不好，最终取决于你操作这个项目和 PPT 的能力。

在线预览 · 关于何雨果 · 示例下载 · 常见问题 · 路线图 · 联系我

下载这份带音频旁白的 Attention Is All You Need 论文精读 deck，在 PowerPoint 里直接放映，每一页都会自己"读"给你听 —— 这只是 PPT Master 能力的冰山一角。

当然，你也可以下载下面六份示例 .pptx 中的任意一份，在 PowerPoint 里打开是最快感受这个项目能力边界的方式。

_{杂志风 — 建筑摄影 + 排版网格，冷静克制的编辑感在线翻页 · 下载 .pptx}	_{新闻 / 财经数据风 — 深色仪表盘，图表驱动，彭博风在线翻页 · 下载 .pptx}	_{瑞士风 — 严格栅格，克制字体，红色点缀在线翻页 · 下载 .pptx}
_{毛玻璃 SaaS — 半透明叠层，渐变景深，产品 UI 感在线翻页 · 下载 .pptx}	_{孟菲斯波普 — 高饱和原色，几何图形，俏皮活力在线翻页 · 下载 .pptx}	_{Risograph Zine — 双色印刷质感，手作书店文化在线翻页 · 下载 .pptx}

_{生成模型：Claude Opus 4.7 + gpt-image-2。在线翻看全部示例 → · examples/ 目录 · 为什么选 PPT Master？}

更多端到端实例：合集·PPT-Master 能力展示（B 站）

丢进你的原材料，拿回的是一份真正的 PowerPoint：可以直接修改，有 PPT 原生的转场与入场动画，演讲者备注能合成音频旁白，还能参考你自己的 PPT 模板——一份能直接拿去讲、回头还能改的真 PPT。每项能力怎么用 → 快速入门。

⚠️ PPT Master 是 harness，不是完整的 agent。 harness + model = agent——工具负责工作流，模型决定上限。要组成真正高质量的 agent，推荐组合是：Claude 大上下文窗口（~100 万 token）+ AI 生图（gpt-image-2）。其他模型能跑流程，但达不到同等质量上限。效果不理想，请先换模型，不要质疑 harness。

运作方式 —— PPT Master 是一套在 AI IDE（Claude Code / Cursor / VS Code + Copilot / Codebuddy 等）里运行的工作流（一个 "skill"）。你在 IDE 的对话框里跟 AI 说"用这份 PDF 做一份 PPT"，AI 按这套工作流在你本机生成一个真正可编辑的 .pptx。你不写任何代码——IDE 只是你和 AI 对话的地方。

你要做的：装 Python、装一个 AI IDE、把资料放进来。

为什么是这种形态 —— 未来，使用 Python 和 AI agent 的能力会越来越重要。这个项目就是要展示：仅凭这两样，你能走多远。代价是零基础上手有一段学习曲线，但走完这段，你就接上了未来。做 PPT 只是个借口——我真正想推广的是 Python 和 agent。

PPT Master 不一样：

真正的 PPT — 如果一个文件在 PowerPoint 里打不开、不能编辑，它就不应该被叫做 PPT。PPT Master 输出的每个元素都能直接点击修改
成本透明可控 — 工具免费开源，唯一成本是你自己的 AI 模型用量。当前主流 AI 工具都已转向按量计费，你用多少付多少——PPT Master 不在此之外增加任何额外订阅费用
数据不出本地 — 你的文件不应该为了做一份 PPT 就被上传到别人的服务器。除与 AI 模型的对话外，全流程在你的电脑上完成
不锁定平台 — 你的工作流不应该被任何一家公司绑架。Claude Code、Cursor、VS Code Copilot 等均可驱动；Claude、GPT、Gemini、Kimi 等模型均可使用

市面上的 AI PPT 工具大致分四类，PPT Master 只做最后一类：

类型	产物形态	能在 PowerPoint 里逐元素改吗
模板填空	套模板的 PPTX	部分可以，受模板限制
图片式	一页一张大图拼成 PPTX	❌ 整页是图片
HTML 演示	网页演示	❌ 不是 PPTX
原生可编辑（PPT Master）	真 DrawingML 形状、文本框、图表	✅ 每个元素都能点开改

会用的人，比工具更关键

上面这些示例都是我用它一次性做出来的，甚至都没有精修——如果再花时间精修，那就是另一番样子了。同一个 PowerPoint，设计师能做出令人惊叹的作品，多数人只用到几个基础功能——差别不在工具，在用工具的人。如果你暂时做不到，多半是还没摸熟用法，请先翻一翻快速入门和示例工程。

最好的效果确实需要 Claude。觉得贵之前，先想想同等水准的 PPT 请人做要花多少钱？项目本身也支持 GPT、Gemini、Kimi 等模型，只是效果有差异——想要顶配的产出、又只付最低的成本，本就不合常理。

关于作者

我是何雨果（Hugo He），投融资领域从业者（注册会计师 · 资产评估师 · 咨询工程师（投资）），工作中经常审阅和修改 PPT。我希望 AI 生成的幻灯片仍然能在 PowerPoint 里继续编辑，而不是被压成一张张图片——所以做了这个。

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

快速开始

1. 前置条件

只需装 Python 即可。 其余依赖通过 pip install -r requirements.txt 一次装齐。

依赖	是否必须	用途
Python 3.10+	✅ 必需	核心运行时——唯一真正需要安装的东西

一句话总结 — 装好 Python，跑一行 pip install -r requirements.txt，就可以开始生成 PPT 了。

Windows — 请看专门的手把手安装指南 ⚠️

Windows 需要一些额外步骤（PATH 设置、执行策略等）。我们为 Windows 用户写了一份手把手安装指南：

📖 Windows 安装指南 — 从零到跑通第一份 PPT，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、通义灵码、CodeGeeX 等	装在 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 都能解决卡点——两家都支持按量调用 Claude、GPT、Gemini 等主流模型，无需订阅，支持国内支付。PackyCode：充值时填写优惠码 ppt-master 享 9 折。APIKEY.FUN：价格低至官方原价的 7%，通过专属链接注册可享受最高永久充值 95 折专属优惠。

3. 配置项目

方式 A — 下载 ZIP（无需安装 Git）： GitHub → Code → Download ZIP · AtomGit → 克隆/下载 → 下载ZIP（国内网速更快）

方式 B — Git clone（需先安装 Git）：

# GitHub
git clone https://github.com/hugohe3/ppt-master.git
# AtomGit（国内网速更快）
git clone https://atomgit.com/hugohe3/ppt-master.git
cd ppt-master

然后安装依赖：

pip install -r requirements.txt

日常更新（方式 A / B）：python3 skills/ppt-master/scripts/update_repo.py

方式 C — Skill marketplace：仓库已添加 .claude-plugin/marketplace.json 元数据，可通过 Claude Code plugin marketplace 生态一行安装：
# 跨 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
上述两种安装方式都只会拉取 skill 文件本身（不含完整仓库），后处理脚本仍需在安装目录跑 pip install -r requirements.txt。

4. 开始创作

提供原始材料（推荐）： 将 PDF、DOCX、图片等文件放入 projects/ 目录下，在 AI 聊天面板中告诉它使用哪些文件。获取路径的最快方式：在文件管理器或 IDE 侧边栏中右键文件 → 复制路径（Copy Path / Copy Relative Path），直接粘贴进聊天框。

你：请用 projects/q3-report/sources/report.pdf 这份文件生成一份 PPT

直接输入内容： 也可以把文字内容直接粘贴进聊天窗口，AI 会根据这些内容生成 PPT。

你：请根据以下内容制作成 PPT：[粘贴你的文字内容...]

两种方式下 AI 都会先确认设计规范：

AI：好的，先确认设计规范：
   [模板] B) 自由设计
   [格式] PPT 16:9
   [页数] 8-10 页
   ...

AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。

输出说明： 原生形状版 .pptx（可直接编辑）保存至 exports/<name>_<timestamp>.pptx；svg_output/ 始终镜像到 backup/<timestamp>/svg_output/，便于归档或后续重跑。加 --svg-snapshot 时，额外在 exports/ 内并排生成 SVG 快照版 pptx（详见常见问题）。需要 Office 2016+。

已有一份想复用的 .pptx？ 把那份 deck 连同素材给 AI，说「套模板」即可——它会把新内容（文字、表格、图表数据）填进你现有的设计，只导出你挑选的页面，且保持原生可编辑。详见常见问题与套模板工作流。

AI 迷失上下文？ 让它先读 skills/ppt-master/SKILL.md。

遇到问题？ 查看 常见问题 — 涵盖模型选择、排版问题、导出异常等，基于真实用户反馈持续更新。

5. 图片获取（可选）

非用户自带图片有两条路径，可在同一份 deck 里按行混用：

需要 API 的功能统一通过 .env 配置。clone 安装可以用 cp .env.example .env；skill marketplace 安装建议使用持久的用户级配置：

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

PPT Master 会优先读取当前进程环境变量，然后按顺序读取第一个存在的 .env：当前工作目录、clone 仓库根目录、~/.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（网络）。

文档导航

	文档	说明
📘	快速入门	三步做出第一份 deck，外加模板、实时预览、动画、旁白、声音复刻的用法（新用户从这里开始）
🆚	为什么选 PPT Master	与 Gamma、Copilot 等工具的对比
🪟	Windows 安装指南	Windows 用户手把手安装教程
📖	SKILL.md	核心流程与规则
📐	画布格式	PPT 16:9、小红书、朋友圈等 10+ 种格式
🛠️	脚本与工具	所有脚本和命令
💼	示例	所有示例项目
🏗️	技术路线	架构、设计哲学、为什么选 SVG
❓	常见问题	模型选择、费用、排版问题排查、自定义模板

贡献

详见 CONTRIBUTING.md。

开源协议

MIT

致谢

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

联系与合作

欢迎合作交流、将 PPT Master 集成到你的工作流，或者单纯提问：

💬 提问与分享 — GitHub Discussions
🐛 Bug 反馈与功能建议 — GitHub Issues
🌐 了解更多 — www.hehugo.com

Star History

赞助与支持

PPT Master 目前主要由我开发维护。每个新模板、Bug 修复、文档更新都需要持续的资源投入，目前由以下赞助方和个人支持者共同分担。

企业赞助方

个人赞助

如果 PPT Master 帮到了你，任何金额的个人赞助都能帮助项目持续更新、保持免费开源。

Made with ❤️ by 何雨果 Hugo He — 如果这个项目对你有帮助，请给一个 ⭐，也欢迎赞助支持。

_{官方发布渠道：GitHub（主仓库）· AtomGit（镜像）。其他平台转发版本均为非官方版本。MIT 协议，使用需保留署名。}

⬆ 回到顶部

_{杂志风 — 建筑摄影 + 排版网格，冷静克制的编辑感在线翻页 · 下载 .pptx}	_{新闻 / 财经数据风 — 深色仪表盘，图表驱动，彭博风在线翻页 · 下载 .pptx}	_{瑞士风 — 严格栅格，克制字体，红色点缀在线翻页 · 下载 .pptx}
_{毛玻璃 SaaS — 半透明叠层，渐变景深，产品 UI 感在线翻页 · 下载 .pptx}	_{孟菲斯波普 — 高饱和原色，几何图形，俏皮活力在线翻页 · 下载 .pptx}	_{Risograph Zine — 双色印刷质感，手作书店文化在线翻页 · 下载 .pptx}

24 KiB Raw Permalink Blame History Unescape Escape