hugohe3/ppt-master

PPT Master – AI生成、完全可编辑的PowerPoint演示文稿

功能

• 接收源文档（PDF、DOCX、网页等），利用大上下文LLM提取关键点，构建幻灯片大纲，并生成原生的 .pptx 文件。
• 输出不是扁平化的图像，而是包含真实PowerPoint对象：幻灯片母版、版式、形状、连接线、数据驱动的图表和表格，因此你可以在PowerPoint中打开并继续编辑。
• 支持三种主要工作流：
  1. 从原始材料生成全新演示文稿。
  2. 从参考文件生成品牌/模板演示文稿。
  3. 在保留原有设计的前提下，向现有演示文稿填充新内容，并可选添加过渡、动画或旁白。

工作原理

1. 支持代理的AI工具 – 任何能运行“代理”（Claude Code、Cursor、VS Code扩展、CLI工具等）的聊天/IDE工具，可读取你的提示并读写文件。
2. 基于Python的技能 – 仓库自带一个Python技能，由代理调用。它解析源文件，与选定的LLM（Kimi K3、Claude、GPT、Gemini等）通信，并构建PowerPoint XML结构。
3. 本地执行 – 所有文件处理和PowerPoint生成都在你的机器上完成；仅LLM API调用通过网络传输，确保你的源数据私密性。

核心优势

• 原生深度 – 幻灯片包含真实的PowerPoint对象（形状、图表、表格），而非扁平图像或预填充模板。
• 模型无关 – 可与任何能读取提示并返回文本的LLM配合使用；作者推荐使用Kimi K3（约1M令牌上下文）或Claude以获得最佳效果。
• 成本透明 – 软件采用MIT许可证；你只需支付LLM和任何你使用的图像生成API的费用。
• 无锁定 – 可自由切换提供商（Claude、GPT、Gemini等），无需更改工作流程。

快速入门

1. 安装Python 3.10+，运行 pip install -r requirements.txt。
2. 选择一个代理（例如Claude Code），打开其聊天窗口。
3. 按照快速入门步骤操作：克隆仓库（或下载ZIP），在 .env 中设置API密钥，并告诉代理“从 my‑paper.pdf 生成一个演示文稿”之类的内容。
4. 代理运行该技能，生成 output.pptx，你可在PowerPoint中打开进行最终微调。

开发者

• Hugo He，一位需要可编辑AI生成演示文稿的金融专业人士，为展示Python + AI代理的潜力而创建了此工具。

查看方式

• 实时演示画廊： https://hugohe3.github.io/ppt-master-examples/
• 示例源仓库： https://github.com/hugohe3/ppt-master-examples
• 详细文档（产品定位、FAQ、路线图）位于仓库的 docs/ 文件夹中。

---

TL;DR: PPT Master是一个开源Python技能，让任何AI代理（Claude、GPT、Kimi等）都能将文档转换为完全可编辑的PowerPoint文件，保留原生形状、图表和版式，同时确保你的数据本地化。