# ppt-master **Repository Path**: ltfjasper/ppt-master ## Basic Information - **Project Name**: ppt-master - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-24 - **Last Updated**: 2026-05-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # PPT Master — AI 生成原生可编辑 PPTX,支持任意文档输入 [](https://github.com/hugohe3/ppt-master/releases) [](https://opensource.org/licenses/MIT) [](https://github.com/hugohe3/ppt-master/stargazers) [](https://atomgit.com/hugohe3/ppt-master) [English](./README.md) | 中文
本项目由 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 折 专属优惠。 |
在线预览 · 关于何雨果 · 示例下载 · 常见问题 · 路线图 · 联系我
![]() 杂志风 — 建筑摄影 + 排版网格,冷静克制的编辑感 在线翻页 · 下载 .pptx |
![]() 新闻 / 财经数据风 — 深色仪表盘,图表驱动,彭博风 在线翻页 · 下载 .pptx |
![]() 瑞士风 — 严格栅格,克制字体,红色点缀 在线翻页 · 下载 .pptx |
![]() 毛玻璃 SaaS — 半透明叠层,渐变景深,产品 UI 感 在线翻页 · 下载 .pptx |
![]() 孟菲斯波普 — 高饱和原色,几何图形,俏皮活力 在线翻页 · 下载 .pptx |
![]() Risograph Zine — 双色印刷质感,手作书店文化 在线翻页 · 下载 .pptx |
生成模型:Claude Opus 4.7 + gpt-image-2。在线翻看全部示例 → · examples/ 目录 · 为什么选 PPT Master?
更多端到端实例:合集·PPT-Master 能力展示(B 站)
--- 丢进一份 PDF、DOCX、网址或 Markdown,拿回一份**原生可编辑的 PowerPoint**——真正的形状、真正的文本框、真正的图表,不是图片。点击任何元素即可编辑。 > **⚠️ PPT Master 是 harness,不是完整的 agent。** `harness + model = agent`——工具负责工作流,模型决定上限。要组成真正高质量的 agent,推荐组合是:**Claude 大上下文窗口(~100 万 token)+ AI 生图(`gpt-image-2`)**。其他模型能跑流程,但达不到同等质量上限。效果不理想,请先换模型,不要质疑 harness。 > **实时预览与可视化修改** —— 生成过程中会自动打开浏览器预览 `http://localhost:5050`。点选任意元素,写一句要改成什么,点 **Submit annotations**,回到对话说一句"应用注解"(或 "apply my annotations"),AI 就会改写 SVG 并重新导出 PPTX。最初我只想做纯对话驱动,但很多用户希望能可视化看到效果再改,所以把这条路径融进了主流程。这部分能力建立在 [@WodenJay](https://github.com/WodenJay) 的 [PR #85](https://github.com/hugohe3/ppt-master/pull/85) 之上,特别致谢。详见 [实时预览工作流 →](./skills/ppt-master/workflows/live-preview.md)。 > **模板复刻** —— 把任何一份你喜欢的 `.pptx` 丢给 AI,一句"用 `/create-template` 复刻成模板",就能拿到一套可被 PPT Master 直接调用的页面布局——主题色、字体、母版/版式结构、复用图片、甚至精灵图裁剪关系都按 OOXML 真实抽取,封面/章节/装饰繁复的页面都能稳定还原。从此你不再受限于内置模板:公司品牌 deck、客户中标模板、找的高质量参考稿,都能一键变成你的私人模板库。详见 [模板指南 →](./docs/zh/templates-guide.md)。 > **动画** —— 导出的 deck 支持**页间转场**和**页内元素入场动画**,输出为真正的 OOXML 动画(不是嵌入视频)。默认进入页面后元素按顺序自动级联入场,无需点击;在 PowerPoint 和 Keynote 中原生播放,无需额外工具。详见 [转场与动画使用指南 →](./docs/zh/animations.md)。 > **旁白与视频** —— 把演讲者备注按页生成语音旁白(默认 `edge-tts`,也可配置云端 TTS 获得高质量音色),把音频嵌回 PPTX,再用 PowerPoint 自带"导出视频"产出带旁白和转场的 MP4,全程无需第三方工具。详见 [音频旁白与视频导出 →](./docs/zh/audio-narration.md)。 > > **声音复刻** —— 用 ElevenLabs / MiniMax / Qwen / CosyVoice 复刻出你自己的声音(或在授权前提下复刻演讲者的声音),让整份 deck 用 *你的声音* 念出来。在 provider 控制台复刻一次,把得到的 `voice_id` 传进来,PPT Master 就会用这个音色逐页朗读备注并嵌入回 PPTX。详见 [使用复刻音色 →](./docs/zh/audio-narration.md#使用复刻音色)。 > **运作方式** —— PPT Master 是一套在 AI IDE(Claude Code / Cursor / VS Code + Copilot / Codebuddy 等)里运行的工作流(一个 "skill")。你在 IDE 的对话框里跟 AI 说"用这份 PDF 做一份 PPT",AI 按这套工作流在你本机生成一个真正可编辑的 `.pptx`。你不写任何代码——IDE 只是你和 AI 对话的地方。 > > **你要做的**:装 Python、装一个 AI IDE、把资料放进来。 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 形状、文本框、图表** | ✅ 每个元素都能点开改 | --- ## 关于作者 我是何雨果(Hugo He),投融资领域从业者(注册会计师 · 资产评估师 · 咨询工程师(投资)),工作中经常审阅和修改 PPT。我希望 AI 生成的幻灯片仍然能在 PowerPoint 里继续编辑,而不是被压成一张张图片——所以做了这个。 🌐 [个人网站](https://www.hehugo.com/) · 📧 [heyug3@gmail.com](mailto:heyug3@gmail.com) · 🐙 [@hugohe3](https://github.com/hugohe3) --- ## 快速开始 ### 1. 前置条件 **只需装 Python 即可。** 其余依赖通过 `pip install -r requirements.txt` 一次装齐。 | 依赖 | 是否必须 | 用途 | |------|:--------:|------| | [Python](https://www.python.org/downloads/) 3.10+ | ✅ **必需** | 核心运行时——唯一真正需要安装的东西 | > **一句话总结** — 装好 Python,跑一行 `pip install -r requirements.txt`,就可以开始生成 PPT 了。
---
Made with ❤️ by [何雨果 Hugo He](https://www.hehugo.com/) — 如果这个项目对你有帮助,请给一个 ⭐,也欢迎[赞助支持](#赞助与支持)。
官方发布渠道:GitHub(主仓库)· AtomGit(镜像)。其他平台转发版本均为非官方版本。MIT 协议,使用需保留署名。
[⬆ 回到顶部](#ppt-master--ai-生成原生可编辑-pptx支持任意文档输入)