【GitHub】AI 做 PPT 的老毛病,被 21 套中文模板治好了
- 2026-11-09 01:16:41
让 AI 做 PPT，翻车的多半在版式这一环。字号乱跳、图形飘着、留白全无。有个 3664 星的项目换了个思路，让模型只负责填字，排版交给现成的模板。想少熬几个晚上的，建议先收藏。
{它不画版式，只往格子里填字}
这个仓库叫 GordenPPTSkill，作者 GordenSun，5 月 27 日建仓，到现在 3664 星、344 个 fork。
核心只有一句话。不给模型一张白纸，给 21 套已经排好的 .pptx。每套模板下面固定四个文件。
模型的活变成写一份 edits.json：
{
"template_slug": "minimal-business-summary",
"selected_slides": [1, 2, 3, 5, 7, 9, 10, 12],
"edits": [
{"slide": 1, "slot_id": "cover_title_cn", "new_text": "2026 年度复盘"}
]
}
然后一条命令：
python3 scripts/build_pptx.py \
templates/minimal-business-summary/template.pptx \
edits.json out/final.pptx \
--detail templates/minimal-business-summary/detail.json
走的是 python-pptx 直接改 XML 这条路，出来是一份真 .pptx，能用 PowerPoint 打开继续手改。
定位精度到了 run 这一层
detail.json 里每个文字槽长这样：
{
"slot_id": "cover_title_en",
"address": {"shape_id": 46, "paragraph": 0, "run": 0},
"box_cm": [13.12, 4.87],
"chars_per_line": 6,
"max_lines": 2,
"max_chars": 14,
"level": 2,
"editable": true
}
shape_id 定位形状，paragraph 数段落，run 数到同一段里第几截带独立格式的文字。精确到 run，一句话里半截英文斜体半截中文黑体也不会被改坏。
后面那几个容量字段是按文本框实际尺寸算的。页数从 16 页的简约商务总结，一路到 59 页的竞聘述职合辑。党政党建、开题答辩、数据看板、幼儿课件，中文职场那一圈场景基本铺满了。
三种走法
SKILL.md 把使用分成三条路，模型自己判断走哪条。
模式 A：从 21 套内置模板里挑，默认走这条
模式 B：你给一份自己的 .pptx，它当未知模板现场探查
模式 C：完全原创，大量留白，单页元素不超过 4 个
第二条挺实用。把公司那套模板丢进去，它会先用 render_slides.py 把每页渲成 PNG，再逐个读 shape、paragraph、run，自己判断哪页是封面、哪页是章节扉页，顺手跳过「稻壳儿」和「感谢下载」这类宣传页。
{一条反常识的规矩，比功能更值钱}
1.0.17 那版更新说明里有一句很硬的判断，max_chars 从硬上限降成了参考值，同时把省略号截断彻底禁掉。
绝对禁止为了凑数而砍掉后半句、在结尾加 ... / … / 等等 来硬凑长度。被省略号截断的半句话，比轻微超框难看得多，是最差的结果。
我自己的感受是，这条踩中的正是 AI 做 PPT 最难看的那个点。模型被字数限制逼急了，就会把句子砍成半截加三个点，一页上七八个省略号，谁看都觉得敷衍。
作者给的替代方案是先重写措辞，用更精炼的说法。实在不行宁可轻微超出，也别出现省略号。
配套还有一条，同一层级的标题不许单独改小字号，要压长度就改文字。build_pptx.py 的出框检测只提示不拦截，--strict 参数反而是劝你别用的。
{20 个版本，26 天}
仓库 5 月 27 日建，6 月 22 日发到 1.0.20，中间 26 天。翻 updates.json 能看到完整的补漏史。
1.0.6 那版把模板里内嵌的中文字体全剥掉，体积从 508MB 降到 63MB，顺手把 .pptx 从 Git LFS 迁回普通 git blob，绕开 LFS 的流量上限。
1.0.19 和 1.0.20 连着两版在修同一类毛病。red-teaching-models 第 26 页有 4 个 EMF 图标，在 macOS 版 PowerPoint、WPS、Keynote 里一律显示「无法显示该图片」。
下一版又揪出更隐蔽的 ghost picture frame，空的 <a:blip/> 挂着没有图片的引用，红色教学那套 14 处、麦肯锡风 16 处，全用占位 PNG 填回去。
这事也说明模板多半是从现成设计稿改造来的。NOTICE.md 里作者自己写了，模板取自稻壳儿、WPS 在线模板、党政机关公开模板这类渠道。
{用之前看清楚两件事}
授权：代码随便用，模板不行
scripts/、references/ 是 MIT，拿去商用改都行。
模板不是。作者在 NOTICE.md 里写得很直白，自己不带模板的商业授权，也给不了你。
The maintainer of this repository (GordenSun) does not hold commercial licensing rights to the templates and cannot grant them.
想商用得回稻壳儿那边找原设计师谈。有二手站推荐「让团队的 AI 助手学会做公司风格的 PPT」，这条路在授权上走不通，别被带偏。
文档：17 套是旧数字
README 和仓库简介都写着 17 套模板，templates/INDEX.md 和 SKILL.md 已经是 21 套，多出来的是两套红色教学模板。README 目录里 VERSION 还标着 1.0.0，实际文件里是 1.0.20。
以 INDEX.md 为准，别按 README 数。
还有个细节，这仓库 3664 星，issue 数是 0。作者把沟通全放在微信群里，二维码前后换了五版。
字体也要留意。模板大量用微软雅黑，Linux 或 macOS 上渲染预览得配一条 fontconfig alias，指到 WenQuanYi Micro Hei 或 Noto Sans SC。交给别人的 .pptx 不用管，宿主机会自己找字体。
{最后}
如果你每周都要交一份汇报，装上这个技能，让 AI 去填字，你自己只改结论。省下来的时间够你多改两版内容。
去 GitHub 给它点个 Star 吧，顺手翻翻 templates/INDEX.md，看看有没有你能直接用上的那套。
GordenPPTSkill
21 套中文 PPT 模板 + 只改文字不动版式的构建脚本，个人研究可用
https://github.com/GordenSun/GordenPPTSkill
#AI做PPT #开源项目 #PPT模板 #效率工具 #AI办公 #每天一个开源项目 #python
{ 感谢阅读 }
如果本文对您有帮助，欢迎 “点赞“，点“推荐”
