PPT Master — AI 从任意文档生成原生 PowerPoint

项目动机

市面上的 AI 演示文稿工具大多只能输出扁平化、无法在 PowerPoint 中继续编辑的产物。可编辑只是基础门槛，真正的差异在于能否交付真正的 PowerPoint 对象模型：原生图形与连接器（带调节手柄）、可数据驱动的图表与表格、完整的文本/图片/填充/效果体系，以及通过模板与结构化路径实现的真实幻灯片母版与版式继承。

PPT Master 的长期方向是持续向 PowerPoint 本体收敛——逐步构建并整合更多原生能力，不断缩小 AI 生成内容与人工制作之间的差距。

核心形态

工具以"技能"（skill）的形态存在，可运行于任何具备代理能力的 AI 工具中：用户在聊天框中提出"用这份 PDF 做一份演示"，AI 即在本地机器上完成整套流程并导出原生可编辑的 .pptx。无需编写代码，用户只需完成三件事：安装 Python、安装 AI 工具、放入素材。

除了"从源文档生成新演示"这条主路径，还支持：

• 从参考材料提炼可复用的品牌/样式/版式/演示模板
• 在保留既有设计的前提下，为现有 .pptx 填充新内容
• 为成稿添加原生切换、动画与旁白

三条附加承诺：成本透明且可预期（仅模型调用费用，无订阅）；数据留在本地（除模型通信外全流程本地运行）；无平台锁定（任何支持代理的 IDE 均可驱动，Claude、GPT、Gemini、Kimi 等模型通用）。

⚠️ 工具不是许愿机：harness + model = agent——PPT Master 只负责工作流，上限由模型决定。推荐组合：Kimi K3 或 Claude（大上下文窗口，约 100 万 token）+ AI 图像生成（gpt-image-2 或 gemini-3.1-flash-image）。一次生成即可获得完美成品的期望不切实际；工具的价值在于承担大部分繁重工作，剩余的精修由用户完成。

技术架构与工作流

工具先进行论证结构化（reason the argument into shape），再进行视觉设计。SVG 管线是默认生成路径：

1. 内容分析与设计规格确认（默认会与用户确认；显式声明可跳过）
2. 视觉基线应用与图像/图标/原生图形/图表/表格/公式准备
3. 手写 SVG 稿件
4. 质量检查
5. finalize_svg.py 生成自包含预览至 svg_final/，并将 SVG 转换为可直接编辑的原生 DrawingML 演示文稿，输出至 exports/<name>_<timestamp>.pptx

图表与表格默认以可独立编辑的 SVG 派生 DrawingML 图形导出，优先保证跨应用视觉一致性；可通过 --native-charts-and-tables 替换为 PowerPoint 原生 Chart/Table 对象（支持"编辑数据"与对象专属控件，但跨应用渲染可能存在差异），输出文件名为 <name>_<timestamp>_native_charts_tables.pptx。

快速上手

环境准备

只需安装 Python 3.10+，其余依赖通过 pip install -r requirements.txt 一行安装。Windows 用户需注意 PATH 与执行策略设置，建议参考专门的逐步安装指南。.docx、.html、.epub、.ipynb 由 Python 原生处理；只有 .doc、.odt、.rtf、.tex、.rst、.org、.typ 等遗留格式需要额外安装 Pandoc。

选择代理工具

PPT Master 可运行于任何具备代理能力的工具中。推荐 Claude Code（CLI 或 VS Code/JetBrains 扩展）作为开发与测试环境；其他可选：Cursor、Windsurf、Codebuddy、Trae、Zed、GitHub Copilot、Cline、Codex CLI、Gemini CLI 等。用户只需使用其聊天面板，不涉及编码。

多供应商 API 密钥管理可借助跨平台桌面应用 cc-switch，实现一键切换 Claude Code、Codex、Gemini CLI 等工具的 API 提供商。

获取项目

方式 A（推荐）：Git 克隆，可随时拉取最新版本。

git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

方式 B：直接下载 ZIP，适合快速试用，但无法 git pull；更新需重新下载 ZIP 并迁移 .env 与 projects/ 文件夹。

方式 C：通过 Claude Code 插件市场安装（仅获取技能文件，仍需在安装位置执行 pip install -r requirements.txt）：

# 跨代理 CLI
npx skills add hugohe3/ppt-master

# 或在 Claude Code 内
/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master

Git 克隆安装的更新命令：

python3 skills/ppt-master/scripts/update_repo.py

生成演示

在 AI 工具中打开 ppt-master 目录，将源材料（PDF、DOCX、图片等）放入 projects/ 目录，然后向聊天框发送指令：

请基于 projects/q3-report/sources/report.pdf 创建一份演示文稿

也可直接粘贴文本内容让 AI 生成。默认情况下，AI 会先确认设计规格（模板、版式、页数等）；显式声明"快速生成，无需确认"则跳过确认环节直接进入创作与导出。

图像获取（可选）

两种非用户图片来源，可在同一演示中按图混用：

• A) AI 生成：image_gen.py 脚本。设置 IMAGE_BACKEND 与对应 *_API_KEY（如 OPENAI_API_KEY、GEMINI_API_KEY），管线自动调用。运行 python3 skills/ppt-master/scripts/image_gen.py --list-backends 查看完整后端列表，gpt-image-2 为当前最优默认。
• B) 网络图像搜索：image_search.py 脚本。零配置即可工作（使用 Openverse / Wikimedia Commons）；配置 PEXELS_API_KEY / PIXABAY_API_KEY（均为免费）后默认链路追加 Pexels / Pixabay，可显著提升现代风格库存照片、人物、工作场景、生活方式与插画覆盖质量。许可证自动处理（CC0、公共领域、Pexels/Pixabay 无需署名、CC BY、CC BY-SA 统一纳入），需署名的图片由执行器添加简短内联署名。

API 密钥存放于 .env：克隆安装使用 cp .env.example .env；插件市场安装需使用持久用户配置 ~/.ppt-master/。

复用既有 .pptx

若已有希望复用的演示文稿，可将其与新素材一并交给 AI 并提出"用新内容填充这份演示"——AI 会在保留原设计的前提下填充文本、表格与图表数据，并仅导出所选页面，全程保持原生可编辑。