PPT Master — 原生可编辑 PPT 生成技能
把文档或主题交给 AI，生成真正的原生 PowerPoint：原生形状、切换与动画、数据图表、语音旁白，本机运行，数据不外泄。
文档极长（10万+字符），只读取了开头部分；流程写得非常严格（分阶段、禁止跳步），但未复测实际生成质量。
仅基于文档静态阅读，未实际运行生成流程验证输出质量，star 数偏高但不作为分数依据。
- 文档篇幅巨大，本次评估未通读全部内容，深层的边界情况处理未核实
这个 Skill 能做什么，适合哪些场景？
PPT Master 是一个运行在任意具备 Agent 能力的 AI 工具（如 Claude Code、Codex、Gemini CLI）中的开源工作流（Skill），由 Hugo He 开发，MIT 许可。它把 PDF、DOCX、网页或你粘贴的内容转化为可在 PowerPoint 中继续编辑的原生 .pptx：包含幻灯片母版、原生形状与连接符、可按需导出的真实数据图表和表格、原生切换与可选入场动画，并能根据演讲者备注生成音频旁白甚至视频。它还支持用你自己的 .pptx 模板填充内容、从参考稿提炼品牌/版式模板、以及对成品演示文稿做美化或加旁白。整个流水线在本机运行，唯一的成本是你所用 AI 模型的调用费用。
读取用户提供的 PDF、DOCX、图片或粘贴文本，先确认设计规格（模板、比例、页数等），再生成页面并导出可编辑的 .pptx。技术路径是先生成 SVG，再由转换脚本写入原生 DrawingML 对象；默认图表/表格导出为可编辑形状，传 --native-charts-and-tables 则替换为带数据的 PowerPoint 原生 Chart/Table 对象。支持：用现有 .pptx 模板填充新内容并保留设计；创建品牌/样式/版式/母版模板；对成品文件编辑、美化、添加切换、动画和基于备注的旁白。图像获取支持 AI 生成（image_gen.py，需配置 OPENAI_API_KEY 或 GEMINI_API_KEY 等）和零配置网页图片搜索（image_search.py，可选配 Pexels/Pixabay key 提升质量，自动处理许可与署名）。每次运行前执行 scripts/attribution_guard.py 完整性校验，然后按 routing.md 选择唯一工作流路由执行。
- 经常审阅和修改汇报材料、希望 AI 生成的幻灯片保持可编辑而非扁平图片的专业人士（作者本人即财务背景的 CPA）。
- 需要把长报告、论文或网页内容快速变成可继续打磨的演示文稿的职员或学生。
- 有现成公司 .pptx 模板，想让 AI 按模板填充新内容并保留原设计的用户。
- 希望给完成稿自动添加旁白音频或自播放视频、用于课程或演示的讲师与培训者。
- 需要从优秀参考稿提炼可复用品牌/版式模板的设计或品牌负责人。
- 想批量制作带数据图表（真实可编辑数据）的商业或数据新闻风格演示的analyst。
这个 Skill 有哪些优点和局限？
- 输出是真正的原生 PowerPoint 对象（母版、形状、数据图表/表格），不是扁平图片，可在 PowerPoint 中继续编辑
- 流水线在本机运行，除模型通信外数据不上传，无平台锁定
- 免费开源（MIT），无订阅费，唯一成本是 AI 模型调用
- 支持自有 .pptx 模板填充、模板提炼、美化、编辑、旁白等多条工作流路由
- 不依赖单一 AI 厂商，任何具备文件读写和命令执行能力的 Agent 工具都能驱动
- 带阻塞式用户确认门和完整性校验（attribution_guard.py），流程纪律严格
- 质量高度依赖所用模型：作者明确推荐大上下文（约 100 万 token）的 Kimi K3 或 Claude，配合 gpt-image-2 或 gemini-3.1-flash-image 图像生成，便宜模型效果会有明显差距且需更多人工打磨
- 需要本地安装 Python 并运行脚本，对完全非技术用户有安装门槛（Windows 还需额外步骤）
- SmartArt 是有意不支持的，与其他原生能力存在差距
- --native-charts-and-tables 生成的原生图表跨应用渲染可能不一致
- 源材料未提供测试套件或独立质量评估，各平台实际表现依赖用户自测
如何安装这个 Skill？
前置：Python 3.10+，Windows 需勾选 Add to PATH。安装：git clone https://github.com/hugohe3/ppt-master.git && cd ppt-master && pip install -r requirements.txt。也可下载 ZIP（快速试用），或用技能市场安装：npx skills add hugohe3/ppt-master，或在 Claude Code 中 /plugin marketplace add hugohe3/ppt-master && /plugin install ppt-master@ppt-master（技能包安装后仍需在安装目录运行 pip install -r requirements.txt）。旧格式文档（.doc/.odt/.rtf 等）才需要 Pandoc。密钥配置：克隆安装 cp .env.example .env；技能安装可放 ~/.ppt-master/.env。
如何使用这个 Skill？
在具备 Agent 能力的工具（Claude Code、Cursor、Codex CLI、Gemini CLI 等）中打开 ppt-master 文件夹，把素材放入 projects/ 或直接在聊天中粘贴内容，例如："请从 projects/q3-report/sources/report.pdf 创建一个 PPT"。AI 会先确认设计规格再生成并导出 .pptx。想复用现有模板：把 .pptx 和新素材一起给 AI 并说"用新内容填充这套模板"。想加旁白：请 AI 为成品添加基于演讲者备注的旁白。AI 失去上下文时可让它读取 skills/ppt-master/SKILL.md；其他问题查阅 docs/faq.md。
这个 Skill 与同类方案有什么区别？
源材料未点名具体竞品，但定位上与常见的"生成可编辑幻灯片"工具不同：它强调原生 PowerPoint 对象模型深度（母版、可调形状、真实数据图表）而非仅是可编辑文本框，并承诺持续向 PowerPoint 本身的能力收敛。