# ppt-master **Repository Path**: bytesfly/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**: 1 - **Created**: 2026-04-18 - **Last Updated**: 2026-04-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # PPT Master — AI 生成原生可编辑 PPTX,支持任意文档输入 [![Version](https://img.shields.io/badge/version-v2.3.0-blue.svg)](https://github.com/hugohe3/ppt-master/releases) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![GitHub stars](https://img.shields.io/github/stars/hugohe3/ppt-master.svg)](https://github.com/hugohe3/ppt-master/stargazers) [![AtomGit stars](https://atomgit.com/hugohe3/ppt-master/star/badge.svg)](https://atomgit.com/hugohe3/ppt-master) [English](./README.md) | 中文

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

> **官方渠道 —** 本项目**仅**在 [GitHub](https://github.com/hugohe3/ppt-master)(主仓库)和 [AtomGit](https://atomgit.com/hugohe3/ppt-master)(自动同步镜像)发布。其他平台上的转发版本均为非官方版本,不由作者维护。遵循 MIT 协议——使用需保留署名。 --- 丢进一份 PDF、DOCX、网址或 Markdown,拿回一份**原生可编辑的 PowerPoint**——真正的形状、真正的文本框、真正的图表,不是图片。点击任何元素即可编辑。 **[为什么选 PPT Master?](./docs/zh/why-ppt-master.md)** 市面上不缺 AI PPT 工具——缺的是一个**生成出来的 PPT 能真正拿去用**的工具。我每天都在做 PPT,但大部分产品输出的是图片或网页截图,好看但改不了;要么就是基础到只有文本框和列表。你还得按月充会员,把文件传到别人的服务器上,被锁在某个平台里。 PPT Master 不一样: - **真正的 PPT** — 如果一个文件在 PowerPoint 里打不开、不能编辑,它就不应该被叫做 PPT。PPT Master 输出的每个元素都能直接点击修改 - **成本透明可控** — 工具免费开源,唯一成本是你自己的 AI 编辑器,花了多少钱你清清楚楚。VS Code Copilot 下最低 **$0.08/份** - **数据不出本地** — 你的文件不应该为了做一份 PPT 就被上传到别人的服务器。除与 AI 模型的对话外,全流程在你的电脑上完成 - **不锁定平台** — 你的工作流不应该被任何一家公司绑架。Claude Code、Cursor、VS Code Copilot 等均可驱动;Claude、GPT、Gemini、Kimi 等模型均可使用 **[在线预览 →](https://hugohe3.github.io/ppt-master/)** · [`examples/`](./examples/) — 15 个项目,229 页 ## 效果展示
杂志风 — 打造小院指南
杂志风 — 暖色调,大图排版,生活方式感
学术风 — 医学图像分割研究
学术风 — 严谨结构,数据图表,论文答辩场景
暗色艺术风 — MV 深度解析
暗色艺术风 — 电影感深色背景,美术馆陈列感
自然风 — 湿地野生动物纪录
自然纪录风 — 沉浸式摄影,简洁信息层级
科技风 — Claude AI 订阅方案
科技 / SaaS 风 — 白底卡片,定价表格,产品说明书
发布会风 — 小米春季新品
发布会风 — 高对比度,参数突出,苹果/小米发布会感
--- ## 关于作者 我是何雨果(Hugo He),一名投融资领域的专业人士(注册会计师 · 资产评估师 · 咨询工程师(投资)),同时也是一名开源产品实践者。 PPT Master 源于一个真实的痛点:在投融资和咨询工作中,我每天都要制作和审阅大量 PPT,而市面上的 AI 幻灯片工具导出的都是图片,不是可编辑的元素。作为一个每天都需要点击进去修改内容的人,这完全不可接受。我需要的是真正的 DrawingML——点击任何元素都能直接编辑,就像手工搭建的一样。 这个项目是我把**专业领域经验**和**产品工程能力**结合起来的一次实践——把一个复杂的专业痛点,变成一个任何人都能用的开源工具。 🌐 [个人网站](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 了。
Windows — 请看专门的手把手安装指南 ⚠️ Windows 需要一些额外步骤(PATH 设置、执行策略等)。我们为 Windows 用户写了一份**手把手安装指南**: **📖 [Windows 安装指南](./docs/zh/windows-installation.md)** — 从零到跑通第一份 PPT,10 分钟搞定。 简要流程:从 [python.org](https://www.python.org/downloads/) 下载 Python → **安装时勾选 "Add to PATH"** → `pip install -r requirements.txt` → 完成。
macOS / Linux — 安装即用 ```bash # macOS brew install python pip install -r requirements.txt # Ubuntu / Debian sudo apt install python3 python3-pip pip install -r requirements.txt ```
边缘场景备用方案 — 99% 的用户用不到 下面两个外部程序只作为极端场景的兜底。**绝大多数用户根本不需要装**,只有遇到以下具体场景才装: | 备用方案 | 只在以下情况才装 | |---------|-----------------| | [Node.js](https://nodejs.org/) 18+ | 你需要抓取微信公众号文章,**且**你的 Python + 系统 + CPU 组合下 `curl_cffi`(`requirements.txt` 里已默认安装)没有预编译 wheel。正常安装下 `web_to_md.py` 已能通过 `curl_cffi` 直接抓微信。 | | [Pandoc](https://pandoc.org/) | 你需要转 `.doc`、`.odt`、`.rtf`、`.tex`、`.rst`、`.org`、`.typ` 这些小众格式。`.docx`、`.html`、`.epub`、`.ipynb` 已由 Python 原生处理,不需要 pandoc。 | ```bash # macOS(仅在上述条件成立时才装) brew install node brew install pandoc # Ubuntu / Debian sudo apt install nodejs npm sudo apt install pandoc ```
### 2. 选择 AI 编辑器 | 工具 | 推荐度 | 说明 | |------|:------:|------| | **[Claude Code](https://claude.ai/)** | ⭐⭐⭐ | 效果最佳——原生 Opus,上下文最充裕 | | [Cursor](https://cursor.sh/) / [VS Code + Copilot](https://code.visualstudio.com/) | ⭐⭐ | 不错的替代方案 | | Codebuddy IDE | ⭐⭐ | 国产模型最佳选择(Kimi 2.5、MiniMax 2.7) | ### 3. 配置项目 **方式 A — 下载 ZIP**(无需安装 Git): [GitHub](https://github.com/hugohe3/ppt-master) → **Code → Download ZIP** · [AtomGit](https://atomgit.com/hugohe3/ppt-master) → **克隆/下载 → 下载ZIP**(国内网速更快) **方式 B — Git clone**(需先安装 [Git](https://git-scm.com/downloads)): ```bash # GitHub git clone https://github.com/hugohe3/ppt-master.git # AtomGit(国内网速更快) git clone https://atomgit.com/hugohe3/ppt-master.git cd ppt-master ``` 然后安装依赖: ```bash pip install -r requirements.txt ``` 日常更新(仅方式 B):`python3 skills/ppt-master/scripts/update_repo.py` ### 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 导出。 > **输出说明:** 两个带时间戳的文件保存至 `exports/` — 原生形状版 `.pptx`(可直接编辑)和 `_svg.pptx` 快照版(视觉参考备份)。需要 Office 2016+。 > **AI 迷失上下文?** 让它先读 `skills/ppt-master/SKILL.md`。 > **遇到问题?** 查看 **[常见问题](./docs/zh/faq.md)** — 涵盖模型选择、排版问题、导出异常等,基于真实用户反馈持续更新。 ### 5. AI 生图配置(可选) ```bash cp .env.example .env # 然后填入你的 API Key ``` ```env IMAGE_BACKEND=gemini # 必填——必须显式指定 GEMINI_API_KEY=your-api-key GEMINI_MODEL=gemini-3.1-flash-image-preview ``` 支持的后端:`gemini` · `openai` · `qwen` · `zhipu` · `volcengine` · `stability` · `bfl` · `ideogram` · `siliconflow` · `fal` · `replicate` 运行 `python3 skills/ppt-master/scripts/image_gen.py --list-backends` 查看分级。环境变量优先于 `.env`。使用各家独立的 Key(`GEMINI_API_KEY`、`OPENAI_API_KEY` 等)——不支持全局 `IMAGE_API_KEY`。 > **建议:** 高质量图片推荐在 [Gemini](https://gemini.google.com/) 中生成并选择 **Download full size**。去水印可用 `scripts/gemini_watermark_remover.py`。 --- ## 文档导航 | | 文档 | 说明 | |---|------|------| | 🆚 | [为什么选 PPT Master](./docs/zh/why-ppt-master.md) | 与 Gamma、Copilot 等工具的对比 | | 🪟 | [Windows 安装指南](./docs/zh/windows-installation.md) | Windows 用户手把手安装教程 | | 📖 | [SKILL.md](./skills/ppt-master/SKILL.md) | 核心流程与规则 | | 📐 | [画布格式](./skills/ppt-master/references/canvas-formats.md) | PPT 16:9、小红书、朋友圈等 10+ 种格式 | | 🛠️ | [脚本与工具](./skills/ppt-master/scripts/README.md) | 所有脚本和命令 | | 💼 | [示例](./examples/README.md) | 15 个项目,229 页 | | 🏗️ | [技术路线](./docs/zh/technical-design.md) | 架构、设计哲学、为什么选 SVG | | ❓ | [常见问题](./docs/zh/faq.md) | 模型选择、费用、排版问题排查、自定义模板 | --- ## 贡献 详见 [CONTRIBUTING.md](./CONTRIBUTING.md)。 ## 开源协议 [MIT](LICENSE) ## 致谢 [SVG Repo](https://www.svgrepo.com/) · [Tabler Icons](https://github.com/tabler/tabler-icons) · [Robin Williams](https://en.wikipedia.org/wiki/Robin_Williams_(author))(CRAP 设计原则)· 麦肯锡、BCG、贝恩 ## 联系与合作 欢迎合作交流、将 PPT Master 集成到你的工作流,或者单纯提问: - 💬 **提问与分享** — [GitHub Discussions](https://github.com/hugohe3/ppt-master/discussions) - 🐛 **Bug 反馈与功能建议** — [GitHub Issues](https://github.com/hugohe3/ppt-master/issues) - 📧 **商务 / 咨询 / 定制合作** — [heyug3@gmail.com](mailto:heyug3@gmail.com) - 🌐 **了解更多** — [www.hehugo.com](https://www.hehugo.com/) --- ## Star History 如果这个项目对你有帮助,请给一个 ⭐! Star History Chart --- ## DigitalOcean Support

本项目获得 DigitalOcean Open Source Credits Program 支持:

Powered by DigitalOcean

--- ## 赞助 如果这个项目帮你省了时间,欢迎请我喝杯咖啡! **PayPal** 通过 PayPal 赞助 **支付宝** 支付宝收款码 --- Made with ❤️ by [何雨果 Hugo He](https://www.hehugo.com/) [⬆ 回到顶部](#ppt-master--ai-生成原生可编辑-pptx支持任意文档输入)