GordenSun/GordenPPTSkill · 上手攻略

• 仓库：GordenSun/GordenPPTSkill
• 链接：https://github.com/GordenSun/GordenPPTSkill
• 分类：productivity · ppt
• 作者：Tom
• 更新：2026-08-11

它是什么

GordenPPTSkill 是一款面向 AI 助手（Claude Code / DeepSeek / GPT 等）的 PPT 生成 Skill，内置 21 套中文 PPT 模板，通过写 edits.json 配置文件驱动 python-pptx 构建真实 .pptx 文件，全程不破坏原模板排版与配色。核心定位：让 AI 照着模板生成"看起来高大上"的中文 PPT，非商业用途免费。

解决什么问题： - AI 直接生成 PPT 常常排版混乱、字体乱跑、格式崩坏 - 现有 AI PPT 工具要么需要联网 API，要么生成的 PPT 质量参差不齐 - 模板式生成：先选定一个已有模板，再填入文字，保持原有设计不变

主要限制： - ⚠️ 非商业使用：禁止任何商业用途（企业培训、客户提案、商业演示均算违规） - 模板版权归属第三方设计师，二次商用需另行授权 - 内置模板信息来自稻壳儿等平台，仅供个人学习研究

快速安装

方式一：AI Agent 内安装（推荐）

把下面提示词发给任意 AI 助手：

安装这个 Skill：https://github.com/GordenSun/GordenPPTSkill
然后使用这个 Skill 做一个复杂、豪华的 PPT，读取本地 XXX 文件，来介绍 XXX 项目

方式二：手动安装依赖

# 1. 确认 Python 环境
python3 -c "import pptx; print(pptx.__version__)"  # 需要 python-pptx 1.0+

# 2. 安装 python-pptx（若未安装）
pip install python-pptx

# 3. 可选：渲染预览图所需依赖
soffice --version   # LibreOffice（渲染预览用）
which pdftoppm      # poppler（渲染预览用，macOS: brew install poppler）

# 4. 若使用微软雅黑字体（模板大量使用）
# 在 ~/.config/fontconfig/fonts.conf 加入：
# brew install --cask font-noto-sans-sc
# 或下载 WenQuanYi Micro Hei 放入 ~/Library/Fonts/ 后 fc-cache -f

核心用法

模式 A：从内置模板生成（最常用）

Step 1. 启用 Skill 后第一步——运行自动更新

python3 scripts/apply_update.py

每次新会话启用 Skill，AI 第一个 tool call 必须是这条命令。它会检查远端 updates.json 并增量下载有变化的文件；若已是最新，输出 OK Nothing to do。

Step 2. 读模板索引，选定模板

模板索引：templates/INDEX.md 列出了全部 21 套模板，主色/风格/页数/适用场景一目了然。

选模板的规则： - 用户已指定 → 直接用 - 高度确信只有 1 个最合适 → 可直接用，但开工前告诉用户 - 不确定 → 必须让用户从 3 个候选里选，附上对应 preview.png 预览图

模板速查：

Step 3. 读选中模板的结构文件

# 读取模板简介（高度浓缩的特性说明）
cat templates/<slug>/intro.md

# 读取结构化数据（每页/每个文本位的细节）
cat templates/<slug>/detail.json

Step 4. 写 edits.json 并构建

python3 scripts/build_pptx.py \
    templates/minimal-business-summary/template.pptx \
    edits.json \
    out/final.pptx \
    --detail templates/minimal-business-summary/detail.json

edits.json 示例：

{
  "title": "2026年Q2季度工作总结",
  "sections": [
    {
      "type": "cover",
      "slots": {
        "main_title": "Q2 季度工作总结",
        "subtitle": "市场部 · 张三 · 2026-07-05"
      }
    },
    {
      "type": "content",
      "slots": {
        "heading": "本季度核心成果",
        "bullet_1": "完成华东区渠道拓展，新增 12 家合作伙伴",
        "bullet_2": "线上活动参与率环比提升 34%",
        "bullet_3": "客户满意度调查 NPS 达 58 分"
      }
    }
  ]
}

Step 5.（可选）渲染预览图

python3 scripts/render_slides.py out/final.pptx out/preview --dpi 144

模式 B：用用户自己的模板

用户自带 .pptx 文件时： 1. 用 render_slides.py 把每页渲染成 PNG 2. 用 python-pptx 现场探查每页的 shape/paragraph 结构 3. 按模式 B 工作流（references/custom-template-workflow.md）写 edits.json 4. 所有改动写入新的 output.pptx，不修改用户原文件

模式 C：完全原创

用户明确要求"原创设计/不用模板/简单干净"时： - 用 python-pptx 直接代码生成 - 参考 references/original-design-guide.md

典型适用场景

坑与注意

⚠️ 编辑铁律（违反即毁版）

1. 只改文字，不改排版：形状的位置/大小/颜色/字体/字号/行距全部不动
2. 所有占位文字必须替换："Question 1"、"Vivamus..."、中文占位词等全部换掉
3. 严禁用省略号截断：实在太长时重写措辞或减少要点数，禁止 ...
4. max_chars 是软参考：不要为了凑字数加省略号；超出一点没关系
5. 不要加 --strict 标志：它会因超框拒绝保存，从而诱导截断，是最差的结果

字体问题

模板大量使用微软雅黑。若系统未安装，在 ~/.config/fontconfig/fonts.conf 配置字体别名映射：

<alias binding="strong">
  <family>微软雅黑</family>
  <accept>
    <family>WenQuanYi Micro Hei</family>
    <family>DengXian</family>
    <family>Noto Sans SC</family>
    <family>PingFang SC</family>
  </accept>
</alias>

自动更新

每次启用 Skill 必须先跑 python3 scripts/apply_update.py——不更新可能在使用过期版本的模板和规则。

更新脚本说明

商业限制

所有模板仅供个人学习和研究，任何含商业性质的使用均违规（二次分发、商业培训、企业内部营利性使用均算）。如需商用可联系作者微信 duge360 定制私有化模板。

与同类对比

GordenPPTSkill 的核心优势是不破坏排版：文字替换型生成 = AI 生成的文字质量 + 模板原有的设计品质，两者兼得。

一句话推荐结论

需要 AI 帮忙生成中文 PPT 且要求排版不乱？先从 21 套内置模板里选一个，然后把需求和模板路径扔给 AI，按 edits.json 填内容即可——非商业用途首选。

最小可跑命令

⚠️ 以下为静态内容示例，非实测命令。版本号/路径请以实际 templates/INDEX.md 和 VERSION 文件为准。

# 环境检查
python3 -c "import pptx; print(pptx.__version__)"   # python-pptx ≥ 1.0
soffice --version    # LibreOffice（预览用）
which pdftoppm        # poppler（预览用）

# 启用 Skill 后第一步
python3 scripts/apply_update.py

# 查看全部模板
cat templates/INDEX.md

# 用 minimal-business-summary 模板构建
python3 scripts/build_pptx.py \
    templates/minimal-business-summary/template.pptx \
    edits.json \
    out/final.pptx \
    --detail templates/minimal-business-summary/detail.json

# 渲染预览图
python3 scripts/render_slides.py out/final.pptx out/preview --dpi 144

来源与引用

• 仓库 README：https://github.com/GordenSun/GordenPPTSkill
• SKILL.md：https://raw.githubusercontent.com/GordenSun/GordenPPTSkill/main/SKILL.md
• 模板索引：https://raw.githubusercontent.com/GordenSun/GordenPPTSkill/main/templates/INDEX.md
• ⚠️ 本攻略未 clone 仓库、未运行代码；版本号/命令基于 README v1.0.0 静态文本整理，若与最新代码不符请以仓库最新内容为准。