ppt-master Skill：把 AI 生成的 PPT 拉回到 PowerPoint 本身

Skill超级捕获手 技术创作者 2026-08-05 14 阅读

上周刷 GitHub 看到一个 4.3 万星的项目,自诩「要把 AI 生成的 PPT 拉回到 PowerPoint 本身」——不是把页面铺成图片、不是把文字塞进模板,而是用 PowerPoint 自己的对象模型重新画一遍。这条路线在 AI PPT 工具里并不常见,今天盘一下 hugohe3/ppt-master。

总结

ppt-master 是一个以「Skill 形态」交付的 AI PPT 生成器:它不发布 SaaS,只交付一个能在任何 agent-capable AI 工具里运行的 skill,把 PDF/DOCX/网页/主题一键转成原生可编辑的 PowerPoint——保留 slide master、原生 shape、可点编辑的 chart/table,甚至能给 keynote 配语音旁白。截至 2026-08-05 GitHub 43.1k stars、3.5k forks,8 月 4 日仍在快速迭代(0.4.3.0 版本刚发布,2 天内 4 次 commit)。它的火爆,本质是戳中了「AI 生成 PPT 没法直接改」这个老大难。

功能与原则

核心能力一句话:让 AI 帮你做 80% 的 PPT 体力活,剩下 20% 在 PowerPoint 里继续精修——而不是导出图片就完事。

五项硬能力:
– 原生 DrawingML 输出:slide master、可编辑 shape、可点击选中的 chart/table,不是「图片 + 文字框」拼贴
– 多源输入 → 结构化大纲:PDF / DOCX / 网页 / 主题文本,走 AI 先理解、后设计、再生成
– 可选动画与旁白:母版切换、入场/强调/动作路径/退出动画、speaker notes 转语音旁白(video)
– 模板填充:把你已有的 .pptx 模板 + 新内容丢给它,只填充文字/图表、不破坏设计
– AI 生图 + 联网搜图双通道:默认推荐 gpt-image-2,无 key 也能用 Openverse/Wikimedia 兜底

设计原则(README 原文):
– Editable is now table stakes — 可编辑早已是底线,真正的差异是「PowerPoint 自己能做到多少」
– Direction of travel, not a checklist — 持续跟 PowerPoint 本身的功能收敛,SmartArt 等刻意留白是「设计留白」而非「能力缺口」
– harness + model = agent — ppt-master 只拥有 workflow,模型(Claude / Kimi K3)定天花板

认可度

  • GitHub stars:43,100+ (截至 2026-08-05);forks:3,500+
  • Trendshift 收录 + The Agentic Leaderboard 收录
  • 版本节奏:v4.3.0 刚于 2026-07-31 发布,8 月 4 日仍在快速迭代(docs: surface quick generation in README, feat(templates): add consulting decision style)
  • commits by hugohe3 and commits by claude——首页显著标注「人 + AI 协作开发」,本身就是它的活广告
  • Sponsor 矩阵:Kimi(月之暗面)、PackyCode、APIKEY.FUN、RunAPI、优云智算——侧面背书 AI 工具链认可度

链接

Github 仓库

  • Live Demo: https://hugohe3.github.io/ppt-master/
  • Examples: https://github.com/hugohe3/ppt-master/tree/main/examples
  • 中文 README: https://github.com/hugohe3/ppt-master/blob/main/README_CN.md

原作者

Hugo He(@hugohe3),财务背景出身(CPA · CPV · 投资咨询工程师),日常工作就是 review 和改 deck。他自述做这个项目的动机非常朴素:「AI 生成的 slide 应该继续在 PowerPoint 可编辑,而不是被压扁成图片。」他在 README 末尾还捎带推广了微软另一个项目 microsoft/ResearchStudio(他最近加入),把论文直接转 talk video / poster / blog——contentradar 眼里,这是同一个方向的延伸。

介绍

ppt-master 把自己定位成一个「跑在 AI 工具里的 workflow」(换句话说,一个 Skill):你打开 Claude Code / Cursor / Codex / Kimi Code 任一个 agent,丢进去一份 PDF 或一段主题文本,它在你的机器上跑完整个 pipeline,最后吐回一份 .pptx 文件——你双击在 PowerPoint 打开,每一页都是原生对象,可以继续改。

跟你日常用过的 Gamma / 美图 AI PPT / ChatGPT + 模板的最大区别在于:它不卖 SaaS、闭源订阅或模板。它的承诺只有三条:
– 透明可预测的成本:免费开源,唯一成本是你用 AI 模型那一份(没有 PPT 订阅费加价)
– 数据本地:除模型通信外,整个 pipeline 跑在你自己的机器上
– 零平台锁定:支持 Claude / GPT / Gemini / Kimi 等任意模型,任意 agent-capable IDE 都能驱动

输入输出侧,它给了两条主路径:source → deck(从文档/主题生成新 deck)和 template-fill(把新内容填进你已有的 .pptx 模板,保留原设计)。两条路径的 contract 都是「输出保留 PowerPoint 原生编辑能力」。

特点

  • 真原生 PowerPoint 输出:shape、connector、master、layout、data-backed chart、table 都是真对象,改一个数字图表上的数据点就是点一下的事,不会触发「图片 → 删不掉的背景图」噩梦
  • AI 生成 + 联网搜图双通道:image_gen.py 接 gpt-image-2 / gemini-3.1-flash-image / 多家 OpenAI-compatible;image_search.py 走 Pexels + Pixabay(需要 key)/ Openverse + Wikimedia(零配置),许可证自动匹配
  • 多 agent 兼容:同一份 skill,在 Claude Code / Cursor / Codex / Gemini CLI / Kimi Code / Windsurf / VS Code / JetBrains IDE 上都能跑;通过 npx skills add hugohe3/ppt-master 或 /plugin marketplace add 一键安装
  • 持续向 PowerPoint 自身收敛:README 附 PowerPoint ↔ SVG Mapping Guide,公开说明哪些功能「故意没做」(SmartArt)而不是「能力缺口」
  • 多语言 + 完整文档矩阵:Getting Started / Why PPT Master / Project Positioning / FAQ / Roadmap / Windows 安装指南,README 中英文双版

使用方法

最快 4 步(Mac/Linux,Windows 有独立指南):

  1. 前置:装 Python 3.10+
  2. 任选一个 agent:Claude Code / Cursor / Codex / Kimi Code / Gemini CLI 等(推荐 Claude Code,作者本人最常调试)
  3. 下载 skill:
    bash
    git clone https://github.com/hugohe3/ppt-master.git
    cd ppt-master
    pip install -r requirements.txt
    也可以走 plugin marketplace:
    bash
    # Claude Code / Cursor / Codex CLI
    npx skills add hugohe3/ppt-master
    # 或在 Claude Code 里
    /plugin marketplace add hugohe3/ppt-master
    /plugin install ppt-master@ppt-master
  4. 生成 deck:把 PDF 放到 projects/q3-report/sources/,然后在 agent 对话框里:
    Please create a PPT from projects/q3-report/sources/report.pdf
    默认会先确认设计 spec(模板 / 版式 / 页数),可以一句话跳过:
    Quickly generate a 5-page deck from projects/q3-report/sources/report.pdf

可选:cp .env.example .env 后填 OPENAI_API_KEY / GEMINI_API_KEY 启用 AI 生图,或填 PEXELS_API_KEY / PIXABAY_API_KEY 提升搜图质量。

使用场景与人群

  • 财务 / 咨询 / 投资:季度报告、尽调 deck、投资路演——背景就是模板,内容要不断更新
  • 学术研究者:论文 → conference talk deck;Hugo 自己同时在做 microsoft/ResearchStudio(论文 → talk video),这是一脉相承的「学术最后一公里」市场
  • 企业培训 / 销售 enablement:把产品文档 / 客户案例快速翻成统一风格的 deck
  • 带模板接手老 PPT:换季度数字、换 logo,保留设计——template-fill 路径主打这个
  • AI 工具链团队:跨 IDE 复用同一份 skill,避免锁定

模型推荐(README 强调):Kimi K3 或 Claude 配 1M 上下文窗口 + gpt-image-2 生图,天花板最高;便宜模型跑得起来但质量有差距。

输入与输出案例

案例 1 — PDF → 财报 deck

Input:
– 文件:projects/q3-report/sources/report.pdf(50 页 Q3 报告)
– Prompt:Quickly generate a 10-page deck from projects/q3-report/sources/report.pdf — no need to confirm with me

Output:
– exports/q3-report_2026-08-05_143022.pptx
– 内含 10 页 std 16:9、母版继承、3 张数据图表(可「Edit Data」改数字)、1 张 SVG 的财务仪表板、speaker notes 已写满
– 双击 PowerPoint 打开,任何一页、任何一个图,鼠标点上去都还能继续编辑

案例 2 — 主题 + 模板填充

Input:
– 模板:projects/brand-template/source.pptx(公司蓝皮 deck)
– 新内容:粘贴 Q3 业绩更新文本
– Prompt:Fill this deck with the new content from projects/q3-report/sources/report.pdf — preserve the design, only update text/charts/numbers

Output:
– exports/brand-template_2026-08-05_150011.pptx
– 字体 / 配色 / Logo / 母版继承自你给的模板,只是文字、图表数据被新内容替换
– 适合「每季度换个数字、整体设计不能动」的报告场景

如果你之前用 Gamma / ChatGPT + 模板做 PPT 一直被「图片改不动」折磨,这是个值得试的替代路径——它的爆不是靠营销,而是踩中了一个真实痛点:我要 AI 帮我做 PPT,但我还想在 PowerPoint 里继续改。

GitHub: https://github.com/hugohe3/ppt-master

评论区

0 条评论

登录后可评论。

Skill超级捕获手 14 阅读