1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ppt-master |
| 作者/维护者 | Hugo He（个人开发者，另有 16 位代码贡献者，数据来自 GitHub API） |
| 来源链接 | https://github.com/hugohe3/ppt-master |
| 许可证 | MIT（仓库根目录 LICENSE 文件确认，条款为标准 MIT 文本） |
| GitHub Stars | 42,454（数据来自 GitHub API） |
| Forks | 3,511（数据来自 GitHub API） |
| 最新版本 | v4.3.0（GitHub Releases，与 SKILL.md 元数据版本号一致） |
| 安装方式 | Claude Code 插件市场 / npx skills add 跨 Agent CLI / Git clone / ZIP 下载，四种渠道均已抓取确认 |
项目自述名称为 “PPT Master”，与正式名称（仓库名 ppt-master）含义一致，仅大小写与空格不同。
2. 功能介绍与亮点
ppt-master 是一个把 PDF、DOCX、网页链接或 Markdown 素材转换成原生可编辑 PPTX 的 AI 演示技能：不是把文字塞进现成模板，而是先梳理论证结构再逐页设计，产出带真实 DrawingML 形状、原生图表表格、母版版式的 PowerPoint 文件，可在 PowerPoint 中继续编辑。
核心能力：
- 四条工作路线：生成全新 PPTX、创建可复用的品牌/版式模板、往已有 PPTX 模板填充内容、为成品 PPTX 做原生增强（动效、配乐讲解）；
- 图表与素材自动化：内置图片生成/检索（可接 OpenAI、Gemini、Qwen、智谱、火山引擎等多家图像后端）、SVG 转原生 PPTX 形状、演讲者备注转语音旁白；
- 交付前质检：批量校验脚本检查 PPTX 结构合规性（OPC 校验、动效/转场一致性），降低“生成即报错”的概率；
- 多语言文档：README 提供英文与简体中文双语版本，Windows 另有专门的分步安装指南。
3. 适用场景
固定分类：文档与办公自动化。
适合需要频繁产出结构完整、可持续编辑的汇报/研究类演示文稿的用户，例如行业研究报告、竞品分析、项目周报、学术分享。官方示例覆盖编辑类杂志风格、数据新闻风格、瑞士网格风格等多种视觉语言，说明能力不局限于单一模板美学。由于生成流程涉及多阶段脚本与可选图像 API 配置，更适合愿意花时间做一次性环境搭建、之后长期复用的中级用户，而非追求“一句话秒出”的轻量场景。
4. 跨 Agent 兼容性
- Claude Code：原生支持。仓库自带
.claude-plugin/marketplace.json，可通过/plugin install ppt-master@ppt-master直接安装；README 明确将其列为“作者主要开发与测试环境”。 - Codex：支持。README 的 Agent 选择表格将 Codex CLI 列为受支持的 CLI Agent 之一，仓库根目录另附通用
AGENTS.md作为“面向通用 AI Agent 的项目入口”。 - OpenClaw：未验证——已抓取材料中未出现相关字样。
- Hermes Agent：未验证——已抓取材料中未出现相关字样。
5. 推荐理由
ppt-master 把“AI 做 PPT”这件事做到了原生格式深度：不是导出一张长图或几个文本框拼接的伪 PPTX，而是保留母版、原生形状、可编辑图表的真实 PowerPoint 文件，这是多数同类技能止步于“能看”而做不到“能改”的关键差异点。项目本身活跃维护、文档详尽、支持多种图像生成后端自由切换，且完全开源可审计，是目前该细分赛道功能覆盖面最完整的选择之一。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | GitHub 42,454 stars，获第三方趋势榜 Trendshift 收录，16 位代码贡献者、200+ 条 issue 讨论，社区活跃度有多重独立信号支撑 |
| 可用性 | 8 | 文档详尽（含 Windows 专用指南、FAQ、路线图），近日仍有版本发布；但需要本地 Python 环境与依赖安装，且有用户反馈首次搭建与单次生成耗时较长 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
- shell 命令执行：本地 Python 脚本处理文档解析、图像后处理、PPTX 组装，权限范围与文档处理功能直接对应，无越界操作。
- 联网外发数据：图像与语音生成为可选功能，须用户在
.env中显式配置图像/语音服务商的 API Key 后才会触发外呼，服务商与用途在文档中列明。 - API Key/凭据存储：通过本地
.env文件管理，安装文档给出清晰的配置路径说明，未发现明文硬编码或异常上传行为。 - 可疑指令排查：SKILL.md 要求执行一个本地“完整性校验”脚本，用途是检测归属信息（版权声明、赞助者名单）是否被删改，逻辑为纯本地文件哈希与文本比对，不联网、不收集数据；审阅脚本源码未发现隐蔽外发或混淆代码。
- License：MIT，条款标准，未见任何附加限制条款。
- 维护时间：近日仍有代码提交与版本发布，维护活跃。
需要提醒的一点：脚本集合中含有一个“去除 AI 图像生成商水印 Logo”的工具，用于清理生成图片角标以便嵌入演示文稿；该操作可能与部分图像服务商的水印保留条款存在冲突，使用前建议核实所选图像服务商的服务条款。
7. 跟同类 Skills 相比的优势
| 技能 | 核心定位 | 与 ppt-master 的差异 |
|---|---|---|
| Dashi PPT Skill | 用自然语言在浏览器内编辑 12 套主题、1,020 个版式页面，一键导出 PPTX/PDF | 交互方式是“网页可视化编辑后导出”，上手更快、可视化程度更高；导出引擎的核心组件为专有闭源模块，而 ppt-master 全链路 MIT 开源可审计 |
| OfficeCLI | C# 编写的单二进制命令行工具，覆盖 Word/Excel/PPT 全套 Office 文档的读写与自动化 | 定位是通用 Office 文档操作层（三层抽象、稳定路径寻址、原生 MCP Server），适合批量脚本化办公场景；ppt-master 专精 PPTX 单一格式，在演示文稿的叙事结构设计、图表与动效深度上打磨更细 |
8. 用户评价
- GitHub issue 讨论中，用户 wenku1992abc（issue #97）反映“现在生成一个 PPT 要 20 分钟以上，用户体验感较慢”，建议优化生成速度。
- 用户 yudalang3（issue #225）分享“花了一个小时让它本地跑起来，发现这个东西已经比较笨重”，并主动发起了一个教程汇总帖，邀请其他用户补充上手经验，该帖已被维护者置顶。
9. 其他补充
仓库提供英文与简体中文两套完整 README，赞助商信息集中在独立的 SPONSORS.md / SPONSORS_CN.md 文件中列出，与核心技能说明分离。
10. 安装使用方式
方式一：Claude Code 插件市场
/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master安装后仍需在插件目录下执行 pip install -r requirements.txt 才能运行文档后处理脚本。
方式二：跨 Agent 通用 CLI 安装器
npx skills add hugohe3/ppt-master方式三：Git Clone（推荐，可持续拉取更新）
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt方式四：下载 ZIP：GitHub 页面 Code → Download ZIP，解压后同样执行 pip install -r requirements.txt；仓库 Releases 页也提供仅含技能文件（不含示例成片）的精简压缩包，体积更小。
注意事项：需预先安装 Python 3.10+；如需图像/语音生成功能，须在 .env 中配置对应服务商的 API Key，不配置也可运行基础的文字版 PPTX 生成流程；macOS/Linux 用户如需将输入文档转换为 Markdown 素材，建议额外安装 pandoc。
11. 注意事项
- 单次完整生成流程耗时可能达到 20 分钟以上，不适合追求秒级出稿的场景。
- 首次搭建涉及 Python 环境、依赖安装与可选 API Key 配置，有用户反馈实际耗时接近一小时。
- 图像生成/语音合成功能依赖用户自备第三方服务商 API Key，会产生对应服务商的调用费用。
- 脚本内置的图像水印去除工具存在与部分图像服务商条款冲突的可能，建议使用前核实相关条款。
- OpenClaw、Hermes Agent 的兼容性尚未有官方材料确认，如需在这两类环境使用建议先做小范围验证。