PPT Master：用 AI 把文档变成可编辑的 PPT
一款开源的 AI 演示制作工作流：从文档梳理故事线、设计页面，到导出可继续编辑的 PPTX。附安装方法与需求示例。
关于这份Skill
AI 可以将文档或主题转换为真正的原生 PowerPoint 演示文稿——包含原生形状、过渡效果和动画，可按需生成数据驱动的图表和表格，支持从演讲者备注中提取音频旁白，并支持您自己的 .pptx 模板。
适用场景
- 经营汇报与项目复盘
- 产品方案与客户提案
- 研究分享与培训课件
- 需要多轮编辑的 PowerPoint 演示
Skill 安装与使用步骤
- 下载完整 PPT Master 仓库，准备 Python 3.10+，按官方说明安装依赖。
- 在可读写文件、执行命令的 AI 工具中打开工作目录，提供报告、文档或主题。
- 说明受众、页数、时长与品牌要求，先确认故事线和逐页大纲，再生成页面。
- 导出 PPTX 后打开检查文字、图表与来源；需要修改数据时明确要求原生图表版本。
使用建议
- 本文是中文资源介绍与使用指南，完整 Skill、脚本及依赖请从原项目获取。
- 项目本身以 MIT 协议开源；AI 模型及按需调用的图片、语音服务可能另行收费。
- 本地处理不等于完全离线；使用云端模型时应核对其数据政策。
- 默认可编辑图形不等于可编辑数据的原生图表，请在需求中说明输出要求。
- 首次可先试做 5—8 页；重要汇报前请检查实际演示软件中的排版与播放效果。
Skill介绍
项目完整说明文档与使用指南，支持图文阅读与一键复制 Markdown 源码。
PPT Master — AI 生成原生 PowerPoint，支持任意文档输入
可编辑早已是及格线——真正拉开差距的是原生深度。 PPT Master 交给你的是一份真正的 PowerPoint：母版、原生形状、数据驱动的图表与表格，而不是一堆扁平文本框，也不是套模板填空的结果。它还不止把幻灯片排得好看——先替你把逻辑理顺，再谈视觉；而这份原生深度在持续向 PowerPoint 本身靠拢，逐版本补齐更多原生能力。
形态上，它是一套在具备 Agent 能力的 AI 工具里运行的工作流：把你的主题或材料交给 AI，就在你本机生成，数据不出本地，不锁定任何平台和模型。
项目介绍
产品定位
PPT Master 交付的是 PowerPoint 的原生对象模型本身，而且具备原生深度：
- **原生可编辑对象**：带调节手柄的原生形状与连接符、按需的数据驱动图表与表格、完整的文本/图片/填充/效果，点开任意元素均可作为原生 PowerPoint 对象继续编辑。
- **真实母版继承**：在走模板/结构化路线时，可产出带真实母版与版式（`p:sldMaster` / `p:sldLayout` 继承）的完整 deck。
- **全场景管线**：支持从源文档直接生成新 PPT，也支持从参考资料提炼可复用的模板、将新内容填入已有 `.pptx` 并保留设计，或为成品追加原生转场、动画与旁白。
核心承诺
- **成本透明可控**：工具完全开源，唯一成本是调用的 AI 模型费用，无任何额外订阅费。
- **数据不出本地**：除与 AI 模型的必要请求外，所有文档解析、排版渲染与导出全流程均在本机完成。
- **不锁定平台与模型**：任何具备 Agent 能力的 AI IDE/CLI 均可驱动；支持 Claude、GPT、Gemini、Kimi 等主流模型。
Note
工具定位提示：harness + model = agent。PPT Master 负责编排工作流，产出上限主要取决于底层模型。推荐使用具有大上下文窗口的模型配合 AI 生图使用。
使用方法
1. 前置环境准备
运行环境仅需 Python 3.10+：
- **macOS**： ```bash brew install python ```
- **Linux (Ubuntu/Debian)**： ```bash sudo apt install python3 python3-pip ```
- **Windows**： 从 [python.org](https://www.python.org/downloads/) 下载安装包，**安装时必须勾选 "Add to PATH"**。
(可选依赖) 如果需要转换小众源文件格式（如 .doc、.odt、.rtf、.tex 等），可额外安装 pandoc。常用的 .docx、.html、.epub、.ipynb 已由 Python 原生支持，无需安装 Pandoc。
2. 选择并准备 Agent 工具
PPT Master 可在任何具备 Agent 能力（支持读写文件、执行命令、持续多轮对话）的工具中运行，任意选择一种即可：
| 类型 | 代表工具 | 说明 |
|---|---|---|
| IDE 内置 Agent | Cursor、Windsurf、Zed 等 | 编辑器原生集成 Agent 对话面板 |
| IDE 扩展 / 插件 | Claude Code（VS Code / JetBrains 插件）、GitHub Copilot、Cline 等 | 在主流编辑器内安装插件使用 |
| CLI 终端 Agent | Claude Code CLI、Codex CLI、Gemini CLI 等 | 终端命令行交互，适合轻量与自动化操作 |
3. 配置项目
方式 A：Git Clone（推荐）
# 克隆仓库
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
# 安装 Python 依赖
pip install -r requirements.txt日常更新（针对 Git 用户）：
python3 skills/ppt-master/scripts/update_repo.py方式 B：下载 ZIP 压缩包
- 前往仓库页面下载 ZIP 压缩包并解压。
- 打开终端进入解压后的项目目录，执行依赖安装： ```bash pip install -r requirements.txt ```
方式 C：通过 Agent Marketplace 安装 Skill
# 跨 agent CLI（Claude Code、Cursor、Codex 等）
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。
4. 开始创作
- **加载项目**：在 Agent 工具中通过 **文件 → 打开文件夹** 打开 `ppt-master` 根目录（CLI 用户直接在终端 `cd` 进入该目录）。
- **提供材料**： - **文件输入（推荐）**：将 PDF、DOCX、Markdown、图片等素材放置到 `projects/` 目录下，在聊天面板中告知文件路径。 - **直接文本**：直接将文字内容粘贴到对话框中。
常用操作指令
- **标准流程（AI 协助梳理大纲与设计规范）**： ```text 请用 projects/q3-report/sources/report.pdf 生成一份 16:9 商业汇报 PPT ``` AI 将先确认设计规范（配色、模板风格、预计页数），确认后逐步完成内容提炼、版面排版并导出 PPTX。
- **快速生成（跳过交互确认）**： ```text 用 projects/q3-report/sources/report.pdf 快速生成一份 6 页 PPT，不用跟我确认，直接导出 ```
- **套用既有 PPT 模板 / 样式修改**： ```text 参考 projects/template.pptx 的设计，将 projects/data.txt 的内容制作为 PPT 并保留原模板样式 ```
导出与结果
- 导出的成品位于 `exports/_.pptx`，所有元素均为可逐形状编辑的原生 DrawingML。
- 如需保留完整数据源、支持原生编辑图表数据，可让 AI 在命令中附带 `--native-charts-and-tables` 导出。
5. 配图获取与配置（可选）
根据需求可启用 AI 绘图或网络图库检索能力，配置统一在 .env 中管理：
cp .env.example .env- **AI 生图**：如果 Agent 环境本身支持生图工具，可直接调用；也可在 `.env` 中配置对应生图供应商的 API Key（支持通过 `python3 skills/ppt-master/scripts/image_gen.py --list-backends` 查看支持的后端清单）。
- **免版权图库搜索**： - 默认零配置下自动使用 Openverse / Wikimedia Commons。 - 可在 `.env` 中配置免费申请的 `PEXELS_API_KEY` 或 `PIXABAY_API_KEY`，以获取更高质量的现代商业摄影与人物、办公类素材。
