内容生产

GordenPPTSkill:AI友好PPT生成技能 / 项目研究报告

文章目录
  1. 这是什么
  2. 它怎么转
  3. 怎么升级
  4. 能用在哪
  5. 风险提示
  6. 资料核对(2026-10-13)
蓝色像素虾在受保护的 PPT 模板里填入文字槽位
图 1:GordenPPTSkill 的核心不是重新设计 PPT,而是只填文字、不碰排版。

GitHub: GordenSun/GordenPPTSkill 作者: GordenSun License: 源码/原创元数据 MIT;内置模板视觉资产另有非商业限制 语言: Python 定位: 面向 AI 的中文 PPT 生成 Skill,模板填字 + python-pptx 工具链。当前 SKILL.md 写 21 套,README 的 17 套数字尚未同步,选型以模板索引为准


这是什么

它是一个"填空式 PPT 生成器"——你挑一套模板,告诉 AI 哪个位置换什么文字,工具按定位地址选页、替换文字,尽量保留原有版式。它不是任意复杂 PPT 的“无损编辑”保证。构建脚本

就像填空题:模板是一张已经印好的表格,AI 帮你填字。形状属性可以不动,但长文字、字体替代仍会改变显示结果;整段替换还会保留首个 run 的格式并清空其余 run,原来混排的加粗、变色不一定还在。

它怎么转

PPT 模板文字槽位替换后生成副本并人工检查预览
图 2:填字流程输出文稿副本,字体、换行和图表仍需另行检查。

触发层: 用户说"做一份 PPT"(工作汇报、年终总结、述职竞聘、开题答辩…)

核心层: - 模板库:template.pptx / intro.md / detail.json / preview.png,按模板索引挑选 - build_pptx.py:读取 edits.json,以 slot_id 或显式 address 定位 run/段落,再选页保存 - 自有模板:当前模式 B 是先渲染,再用 python-pptx 探查 shape / paragraph / run,不能依赖旧稿未核实的 extract_template.py - 更新工具:作者要求首次启用时运行 apply_update.py;受控环境应先 check_update.py 看变更,审核并固定版本,不把自动下载视为安全保证

输出层: - out/final.pptx → 用户要的 PPT - out/renders/ → 每页 PNG 预览

卡点层: - 文档和脚本不一致 → 固定同一版本,关键参数以脚本实际实现为准 - 超 max_chars 不自知 → 容量只是估算,长文字仍需逐页渲染检查 - 章节名不一致 → 改了目录章节名,分章扉页没跟着改

怎么升级

入门段: 会用模式 A 就够了:从 templates/INDEX.md 选模板,读 intro.md + detail.json,写 edits.json,再跑 build_pptx.py。构建需要 python-pptx,预览另需 LibreOffice + Poppler;生成成功后仍要看图和用目标播放器打开。

进阶段: 补两个认知:detail.json 是槽位地图,不是实际排版引擎;更新前先审查脚本、模板和许可变化,保持生成环境可复现。

高手段: 为自己有权使用的模板建立槽位映射,或者按模式 C 用 python-pptx 做原创简洁版式;别把文档提到的功能当成脚本已实现的参数。

能用在哪

  1. 标准化学习演示:用许可允许的模板练习固定版式填字
  2. 批量报告生成:复用 MIT 工具链,配自己的授权模板,程序化生成 edits.json
  3. 企业内部知识库输出:可借鉴槽位思路统一风格,但仓库 NOTICE 明确把营利组织内部使用也列入内置模板的禁止范围,不能直接拿它们做企业模板库

风险提示

代码和模板分别查看许可,模板授权联系原权利人
图 3:代码和模板的授权要分开核对,仓库维护者不能代授模板商用权。
  • 代码和模板不是同一授权:LICENSE 将 scripts、references 和原创技能元数据置于 MIT;NOTICE 对模板 PPTX 与预览图另设非商业限制,注明视觉版权归原模板作者,仓库维护者不能授予其商业许可。README 还有更宽泛的禁止二次分发表述,准备分发前应澄清;“公开可下载”不能代替授权,也不足以据此定性盗版
  • 字体地狱:微软雅黑缺失或换成替代字体,会影响换行和预览;最终机器也要核对字体授权与显示
  • max_chars 只是软提示:当前 build_pptx.py 默认 lint(可用 --no-lint 关掉),超量只提示、不拒绝保存;--strict 主要约束 expected_text 不匹配和定位/编辑失败,不是排版合格开关。SKILL.md 中仍有相反旧说明,以代码为准
  • 图表不会跟着文字变:改“60%”不等于更新圆环弧长;当前构建脚本没有 SKILL.md 提到的 --chart-data 参数。真实 chart 要另行实现数据更新并核查,不能只换标签

核心洞察: AI 生成 PPT 的最大痛点不是"生成",而是"保持排版"。解法是放弃让 AI 从头设计,改为"AI 只管填字,排版交给模板"——工程上的务实,也是一套可复制的"结构化约束"思维模式。

资料核对(2026-10-13)

本次直接读取官方 README、SKILL.md、LICENSE、NOTICE 与 build_pptx.py,区分文档自述和代码行为;未运行构建、更新或 Office 渲染,不是无损兼容性实测。

记录到这里,判断留给实践。