ARTICLE · 1367597
7万颗星的 PPT Master:文档扔进去,逐页画出原生 PPT
主角:ppt-master 一句话价值:只有文档、没有 PPT,也能有一份真能改的 PPT
大家好,我是夏树。
上一篇写的是逆向:只有截图、源文件丢了,怎么把图拆回能改的 PPT。这篇是另一条路,正着来:手里只有一份文档,或者脑子里只有一句话,要从零做出一份 PPT。GitHub 上干这件事最火的工具叫 ppt-master,77,051 星,半年从 1.6 万星涨到 7.7 万星。我按它自己的 Quick 流程亲手做了一套 4 页的 PPT,校验全过,数字都在下面。
它到底是什么
仓库是 hugohe3/ppt-master,2026-11-15 核验:77,051 星、6,018 fork,MIT 开源,最新版 v6.9.0(2026-11-08),建于 2025-12-10。作者 Hugo He 是金融从业者,平时天天审 PPT,受不了 AI 生成的 PPT 变成一张不能改的图片,自己动手造了这套工具。官网示例站:ppt-master-examples
它不是一个 App,也不是一个网站。你下载不了一个“PPT Master”双击打开。它是一个 skill,跑在 AI 编程助手里的:Claude Code 是作者首选,Codex CLI、Cursor、Gemini CLI、GitHub Copilot、Cline 也都能跑。你在助手的聊天框里说一句“把这份 PDF 做成 PPT”,它就在你的电脑上把活干完。
它吃的东西很多:PDF、DOCX、PPTX、EPUB、HTML、LaTeX、Markdown、网址,或者直接粘贴一段文字。没有文档也行,给它一个题目,它先上网查资料再动手。吐出来的是一份标准 。pptx,落到项目文件夹的 exports/ 里。
它怎么工作:先画 SVG,再翻成 PPT
流程分四步:
读源文档。agent 先把你的材料读完,提炼出要讲什么。 定方案。一个叫 Strategist 的角色先定论证结构,从 5 种叙事模式里挑一种:金字塔、叙事、教学、展示、简报;再从 18 种视觉风格里定一套。 逐页画 SVG。每一页都由 agent 手写成一张 SVG 矢量图:标题放哪、卡片多大、字什么颜色,都在 SVG 里定死。 脚本翻译。本地 Python 脚本把 SVG 一对一翻成 PowerPoint 原生对象,生成 。pptx。
第二步和第三步之间有个分岔:默认流程会先把设计方案拿给你确认,模板、16:9 还是 4:3、多少页,确认完再画;赶时间就说“快速生成,不用确认”,agent 直接画到底,不停下来问你。这次实测我走的就是快速生成。
为什么中间要过一道 SVG?因为 SVG 和 PowerPoint 底层的 DrawingML 都是带绝对坐标的矢量语言,矩形、路径、渐变、阴影几乎能一一映射。让大模型直接手写 DrawingML 的 XML,又长又容易写坏;让它写 SVG,它最擅长。翻译这一步交给脚本,确定性就回来了。等于两种方言互译,不是跨语言桥接。
成品长什么样:文字是文本框,双击就能改;形状是原生形状,带调节手柄,能拖能改色;连接件、图标、表格都在。图表和表格默认是“画出来”的形状,好处是在 PowerPoint、Keynote、LibreOffice、WPS 里显示一致;想要带数据表的真图表,加一个 --native-charts-and-tables 参数,会另外存一份 _native_charts_tables.pptx,图表带 Edit Data,数字改了图跟着变。公式会变成可编辑的 OMML 公式。过渡、动画、演讲者备注、旁白都能加。不支持的作者也写明白了:SmartArt、WordArt、OLE、宏明确排除,视频不生成。
除了从零生成,它还有两条路线。Create Template:拿你给的参考材料,提炼出一套能反复用的品牌、风格、版式或者整套模板。Edit Native PPTX:拿你现有的公司模板 。pptx,往里面填新内容,不动的页字节级不变,设计一点不走样。画布也不止 16:9:4:3、小红书 3:4、方形 1:1、9:16 故事、微信头图、A4 打印都有。
怎么装:三步
第一步,装 Python 3.10 到 3.14。去 python.org 下,Windows 安装时勾上“Add to PATH”。作者还给 Windows 单独写了一份安装指南,因为那边的路径和执行策略要多几步。
第二步,挑一个 AI 助手。Claude Code 是作者开发和测试最深的环境,Codex、Cursor、Gemini CLI 也行。装好之后,你只用它的聊天框,不用写代码。
第三步,下载项目,装依赖:
1 2 3 git clone https://github.com/hugohe3/ppt-master.gitcd ppt-masterpip install -r requirements.txt 也可以用 npx skills add hugohe3/ppt-master 只装 skill 文件,但依赖还得自己装。仓库不小,整库约 80MB,图标和模板占了大头,想省事直接整库克隆。国内访问 GitHub 不顺的话,AtomGit 上有镜像。以后更新不用重下,跑 python3 skills/ppt-master/scripts/update_repo.py 就行。
Windows 对照表:
brew install pythonsudo apt install python3 python3-pip | ||
python3 -m venv venvsource venv/bin/activate | python -m venv venvvenv\Scripts\activate | |
pip install -r requirements.txt | pip install -r requirements.txt | |
python3 skills/ppt-master/scripts/update_repo.py | python skills/ppt-master/scripts/update_repo.py |
装好之后,在助手里打开 ppt-master 文件夹,把源文件放进 projects/,聊天框里说一句话就行:
1 Please create a PPT from projects/q3-report/sources/report.pdf 赶时间就加一句“快速生成,不用确认”,直接出成品。
我是怎么测的
测试环境是一台没装 Claude Code 也没装 Codex 的 Linux 虚拟机。仓库克隆下来,依赖装进虚拟环境,先跑了 skill 自带的完整性检查 attribution_guard.py,exit 0。
这次走的是 Quick 流程,源文档是我自己写的一篇短文《PPT 的两条路:逆向还原 vs 从零生成》,四节,对应 4 页:封面、逆向还原、从零生成、怎么选。里面的数字都是之前核验过的:逆向那件 3,367 星、182 fork、v0.4.0,ppt-master 77,051 星、6,018 fork、v6.9.0。
按流程,先给标题和正文定字体、做校准。本机装了 Noto Sans CJK SC,标题 44pt 粗体、正文 20pt,校准表记下了每种字号每 100 像素能放几个汉字,之后每页都按这个算宽度,没为塞字改过一处文案。
然后 4 页 SVG 由 agent 亲手写出来:深色封面和结尾是藏青底,逆向页用琥珀色、生成页用青色,全套配色一致。每页都守着 skill 的硬规则:1280×720 画布、中文语言标记、每组带边界、文字一段一个文本框。最后跑最终检查、导出、再独立验成品。
限制先交代清楚:这次没配图片后端,4 页里 0 图片、0 图标,图片那条路完全没走;也没走默认流程的 Strategist 和确认环节,没开备注、动画、旁白,没走模板路线。渲染只在 LibreOffice 里验过,没在真正的 PowerPoint 里打开过。
测出来的结果:数字都在这
• 最终检查:4/4 全部通过,警告 0、错误 0。第一遍其实带了 3 条不阻塞的提醒,标题组里两个文字重复写了粗体,应该提到组上。按检查器自己给的办法跑了 compact_svg_styles.py 修掉,重跑就干净了。
• 导出的 ppt-liangtiao-lu_20261115_131015.pptx:21,426 字节,4 页,16:9(13.33×7.5 英寸),原生 DrawingML 形状,导出自检通过。
• 读回验证:我自己用 python-pptx 递归读了一遍(不递归会漏掉组里的形状):第 1 页 9 个文本框、第 2 页 13 个、第 3 页 16 个、第 4 页 13 个,合计 51 个,和检查器的清单一致。51 段文字逐段核对,数字和版本号与源文档一字不差:77,051 星、6,018 fork、v6.9.0、3,367 星、182 fork、v0.4.0、54 个文本框、86 个形状、21 条违规。
• 样子:LibreOffice 渲染出来跟 SVG 预览并排对照,4 页版式一致,标题、统计卡、步骤条、对比卡位置都没移位,文字无溢出、无裁切、无缺字。像素差异 5.3%–7.6%(逐像素比对,阈值 30),是两个渲染器的字体抗锯齿差别,不是版式错了。

上面这张就是第 3 页,左面是 SVG 预览,右面是导出的 PPTX 渲染。第一眼看过去,基本就是同一页。
一处如实说明:第 4 页有一句为了排版做了压缩,源文档的“要起一份新稿的人”写成了“要起新稿”,完整原句在第 3 页页脚一字不差。不是新事实,是排版取舍,写清楚。
成本:动手之前先算账
工具本身免费,MIT 开源,没有订阅、没有账号、没有按套收费。你花的钱在模型那头。README 原话:高 token 用量是这个方案的 trade-off,不是缺陷。逐页设计意味着每一页都要烧一轮 token,官方没公布过每套成本,也没实测 token 数。
怎么算这笔账,看你怎么付模型钱。包月订阅制的助手(比如 Claude Code 的订阅),多做一套不另花钱;按量计费的 API,每 token 都算钱。图片也一样:配图走 AI 生成要另算图片的钱,走 Pexels、Pixabay 免费图库搜索不用钱,配 API Key 之后结果更好。
速度也要算进去:10 页大约 10–20 分钟,因为一页一页串行生成,为的是风格一致。跟 Gamma 那种几秒出结果的在线工具比,慢得多。README 也把话说在前面:模型定上限,便宜模型多留手工活;别指望一次出成品,繁琐的部分它替你干了,收尾还是你的——成品之所以是原生可编辑的,就是为了让你接着改。
适合谁、不适合谁
适合:手里有报告、论文、方案文档,要转成一份能接着改的 PPT 的人;每个月都要按同一套路出 PPT 的人(模板路线就是干这个的);公司有固定模板,要往里面填新内容的人;材料涉密、不想把文档传到在线工具上的人——转换和导出全在本地跑。
不适合这几类:要几秒出结果、打开浏览器就用的,选 Gamma、Presentations.AI 这类在线工具;只改一页、或者只修现有 PPT 里的某一页,PowerPoint 里的 Claude 插件更顺手;想从零生成新 PPT 但完全不想装 Python、配助手,那这套工具的前置成本比收益大。
还有三句提醒。第一,认准仓库名 hugohe3/ppt-master,GitHub 上同名克隆不少,下之前核对账号,因为助手会在你机器上跑它里面的脚本。第二,别喂不可信的 PDF,文件里可能藏着给 agent 的指令。第三,涉密材料把可选的在线服务关掉:图片生成、图片搜索、URL 读取、在线旁白,这些会出本机;转换和导出本身不出本机。
第三方评测 stork.ai 的判断也值得听:独立实测很少,星数代表关注度,不代表质量。先下一个示例成品,在 PowerPoint 里打开看看字体稳不稳、形状拖得动不动、图表数字对不对,再决定要不要把工作流押上去。
同类东西怎么选
• Gamma、Presentations.AI、AiPPT:在线工具,浏览器里几秒出结果,不用装任何东西。代价是成品大多是它们自己的格式,可编辑性不如原生 PPTX,深度定制也弱。图的是快。
• Claude for PowerPoint 插件:装在 PowerPoint 里面,边做边改,修单页最顺手。但要 Pro、Max、Team 或 Enterprise 套餐才能用。
• anthropics/skills@pptx:官方的轻量版 skill,纯脚本生成基础形状和文本。适合快速出简单结构的 PPT,复杂排版别指望它。
• 上一篇的 image-to-editable-ppt-skill:那是逆向,源文件丢了、只有图的时候用。这篇是生成,手里有文档、要起新稿的时候用。两条路不冲突,分工就是“改旧稿”和“起新稿”。
常见问题
没有 Claude Code 能用吗?
能。只要是能读写文件、跑命令、多轮对话的助手就行:Codex、Cursor、Gemini CLI、Copilot、Cline 都在支持列表里。作者说 Claude Code 是开发测试最深的环境,别的也能跑,质量有差距。
做一套 PPT 到底花多少钱?
工具本身 0 元。花在模型上:包月订阅多做一套不另花钱,按量计费按 token 算。官方没给过每套的数字,10 页 10–20 分钟这个量级,自己拿一页试了再估。
10 页的 PPT 要多久?
按 README 的口径,10 页大约 10–20 分钟。我的建议是先拿一小份试一次快速生成,再决定整份上不上。
生成的图能改吗?
分两层。形状、文字、图表都是原生对象,能改。配图分两种:AI 生成的图和网上搜的图,都是以图片形式嵌进去的,改不了里面的内容,只能换一张、裁一下、移位置。没配图片后端时,未完成的配图会以虚线占位框标记,并且会卡住导出——要么补上图,要么把这项配图需求去掉(用原生文字/形状顶上),导出才会继续。本次实测没配图片后端,4 页里 0 图片,这条没测过。
机密文档能转吗?
转换和导出本身全在本地,不出本机。图片生成、图片搜索、URL 读取、在线旁白这四项是可选的在线服务,涉密的关掉再转,或者别用。
和 Gamma 那种在线工具比,选哪个?
要快、要零门槛,选在线工具。要一份能在 PowerPoint 里接着改、反复用的底稿,选 ppt-master。两个不是一代东西,别拿速度比可编辑性。
相关推荐
• 28 万 star 的 ECC:给 AI 编程助手装一套“工程纪律”
• 一个终端,11 个 AI 编程助手免费随便用:每月 13 亿 token(free-claude-code)
上一篇写了逆向那件,这篇写了生成这件。两条路都通了,你手头那份文档,打算先拿哪一页试?
参考来源
• ppt-master 仓库
• ppt-master 官方示例站
• PPT Master guide, the free tool that turns a PDF into PowerPoint
• ppt-master Review (2026): Pricing & Alternatives
• PPT Master Skill 深度调研:从 SVG 中转、网页可视化批注到原生可编辑 PPTX
• 主流 PPT 生成 Skill 测评排名
• 2026 年最全 AI PPT 生成工具横评:26 款 Agent Skill 深度解析与选型指南
如果对你有启发,欢迎点赞、在看、转发


















































































