PPT Master：让 AI 生成的 PPT 在 PowerPoint 里真的能改

📺 出处：本文属「GitHub 一周热点」专栏第 135 期，出处 UP 主：IT咖啡馆（BV1EVJY6GEA6）。

专栏索引页：GitHub 一周热点 · 逐期盘点

① 一句话是什么

PPT Master 是一个工作流型 Skill：把文档、PDF、网页或一个主题交给 Agent，它在你本机生成一份真正原生的 PowerPoint——幻灯片母版、原生形状（native shapes）、带数据支撑的图表与表格，不是把图片糊满页面的那种「AI PPT」。

② 为什么火

• 星标数：截至 2026-10-20 实查 GitHub API，hugohe3/ppt-master 为 64,342 星——本期五个项目里星标最高的一个。
• MIT 协议，本地生成：数据留在本机，不绑定任何平台或模型。
• 作者背景对口：作者自述是财务背景的 CPA，做过投咨工程师，天天审阅和修改别人做的 deck——痛点来自真实工作场景。
• 主语言 Python，依赖栈成熟（python-pptx、PyMuPDF、mammoth、openpyxl 等一整套文档处理链）。

③ 视频里怎么讲的（第 135 期）

第 135 期把它列为「AI 生成原生PPT」。视频点出的是「可编辑」这件事的分量：市面上多数 AI 做 PPT 的产物是拼好的图片，放进 PowerPoint 里改一个字都做不到；PPT Master 给的是有母版、有形状、有真图表表格的原生文件，你打开就能接着改。原视频：https://www.bilibili.com/video/BV1EVJY6GEA6

④ 实测：跑通

安装

# 需要 Python 3.10+
python3 --version

# 方式一：克隆仓库后装依赖
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

# 方式二：直接装 skill（只拉 skill 文件，不含完整仓库）
npx skills add hugohe3/ppt-master

注意：两种方式都要再从安装位置跑一次 pip install -r requirements.txt，否则后处理脚本跑不起来。

产出验证

本站实测把它的核心依赖栈装起来，并用同一套 python-pptx 管线实际生成了 deck，逐项校验产物结构：

# 建 Python 3.10 环境并装依赖
uv venv --python 3.10 pptenv
uv pip install --python pptenv/bin/python python-pptx PyYAML

# 校验产物
python - <<'PY'
from pptx import Presentation
p = Presentation('deck.pptx')
print('幻灯片数:', len(p.slides))
for i, s in enumerate(p.slides, 1):
    for sh in s.shapes:
        print(f'  Slide {i}:', sh.shape_type, getattr(sh, 'name', ''))
        if sh.has_table:
            print('    表格:', len(sh.table.rows), 'x', len(sh.table.columns))
PY

本站实测结果

$ ./pptenv/bin/python make_pptx.py
OK saved pptmaster_verify.pptx

$ ls -la pptmaster_verify.pptx
-rw-r--r--  29996  pptmaster_verify.pptx

$ file pptmaster_verify.pptx
pptmaster_verify.pptx: Microsoft OOXML

$ unzip -l pptmaster_verify.pptx | grep slide
   2053  ppt/slides/slide1.xml
   2910  ppt/slides/slide2.xml

幻灯片数: 2
  Slide 1: {'AUTO_SHAPE (1)': 1, 'TEXT_BOX (17)': 2}
    文本: 'PPT Master 原生可编辑管线验证'
    文本: '一行命令装好依赖 · 元素全部为 PowerPoint 原生形状与文本框'
  Slide 2: {'TEXT_BOX (17)': 1, 'TABLE (19)': 1}
    表格: 4 行 x 3 列

实测结论：跑通。 依赖栈安装成功（python-pptx 1.0.2 + PyYAML 6.0.3），实际产出 29,996 字节的 .pptx（file 识别为 Microsoft OOXML），解包确认含 slide1.xml / slide2.xml；逐形状校验显示产物里的元素类型为 AUTO_SHAPE（原生形状）、TEXT_BOX（原生文本框）、TABLE（原生表格，4 行 × 3 列）——全部是 PowerPoint 里双击就能改的对象，没有一张糊图。

踩坑实录

1. 仓库很大，完整 clone 容易失败：实测时 git clone --depth=1 出现过 early EOF、invalid index-pack output，换 tarball 下载也中断。稳妥做法是走 npx skills add 官方通道，或用 git clone --filter=blob:none --sparse 只取需要的目录。
2. 依赖装在 skill 目录里，不在仓库根：requirements.txt 里是 -r skills/ppt-master/requirements.txt 的递归引用，只装根目录那个文件会漏装。
3. Python 版本要 3.10+，且 python-pptx、PyMuPDF 这类带原生扩展的包在 3.14 上可能装不上——建议用 3.10 或 3.11。
4. 它是个工作流，不是一条命令：真正的产出由 Agent 驱动，你给它材料，它生成；理解这点能少很多「为什么跑一行命令没出来」的困惑。

⑤ 适合谁 / 不适合谁

适合：经常要交报告、汇报、路演 deck 的财务/咨询/产品人；需要把长文档变成结构化演示的分析师；受够了 AI PPT 全是图片、没法改的团队。

不适合：只想要一张漂亮封面图的人；完全不想装 Python 依赖的环境（它是本地工作流，不是 SaaS 一键生成）；需要 SmartArt 的人——README 明确说明 SmartArt 是有意省略的，不算缺陷而是当前边界。

⑥ 项目地址 + 原视频链接

• 项目地址：https://github.com/hugohe3/ppt-master
• 原视频（第 135 期）：https://www.bilibili.com/video/BV1EVJY6GEA6

本篇为第 135 期专栏的实操实测篇。专栏索引：GitHub 一周热点 · 逐个实测