效率与协作
pptx-generationpowerpointsvg-pipelinedocument-to-slidespresentationnative-chartsaudio-narration
PPT Master — AI 原生 PowerPoint 生成器
将文档或主题转换为真正可编辑的原生 PowerPoint 演示文稿，支持图表、动画、旁白和自定义模板。
- Star 数
- ★ 64k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Python
- FA 评分
- 0/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude CodeChatGPT · Codex（部分支持）
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 金融专业人士需要将季度报告 PDF 快速转换为可编辑的演示文稿
- 不适合
- 不愿安装 Python 或使用 AI 编程工具的用户
- 期望一次生成即可直接使用的成品演示文稿的人
这个 Agent 能做什么，适合哪些场景？
PPT Master 是一个 AI 驱动的工具，可将 PDF、Word 文档或直接粘贴的文本转换为原生 PowerPoint (.pptx) 文件。它生成的幻灯片具备真实的 PowerPoint 行为：原生形状、过渡、动画、数据图表和表格，甚至可根据演讲者备注生成音频旁白。该工具作为技能运行，可在任何支持 Agent 的 AI 工具（如 Claude Code）中使用，并在本地机器上处理数据，确保隐私。它支持自定义模板和品牌指南，并通过 SVG 中间格式生成可编辑的 PPTX 文件，而非扁平图像。
读取 PDF、DOCX、HTML、EPUB、IPYNB 等来源文件（通过 Pandoc 支持旧格式），或直接输入文本。运行一个工作流，包括内容分析、设计规范确认、SVG 手写生成，以及通过 finalize_svg.py 导出为原生 PPTX。可选集成 AI 图像生成（image_gen.py）和网络图片搜索（image_search.py），支持 Pexels/Pixabay 等。支持原生图表/表格替换（--native-charts-and-tables 标志）和模板填充工作流。
- 金融专业人士需要将季度报告 PDF 快速转换为可编辑的演示文稿
- 市场营销人员为产品发布创建包含品牌模板和自定义样式的演示文稿
- 教育工作者将课程笔记或讲义转换为带旁白的幻灯片
- 数据分析师将数据报告转换为包含原生图表和表格的仪表板风格演示文稿
- 团队协作时，在不离开 AI 编码环境的情况下生成并迭代演示文稿
如何安装或部署这个 Agent？
- 安装 Python 3.10+。
- 克隆仓库：
git clone https://github.com/hugohe3/ppt-master.git并cd ppt-master，或下载 ZIP。 - 安装依赖：
pip install -r requirements.txt。 - 可选：配置
.env文件，设置OPENAI_API_KEY、GEMINI_API_KEY、PEXELS_API_KEY等。
如何使用这个 Agent？
- 在支持 Agent 的工具（如 Claude Code）中打开项目文件夹。
- 将源材料放入
projects/目录。 - 在聊天中指示：
请根据 projects/q3-report/sources/report.pdf 创建 PPT。 - 等待设计规范确认，或使用快速生成模式：
快速生成 5 页 PPT，无需确认。 - 输出将保存到
exports/<name>_<timestamp>.pptx。
这个 Agent 有哪些优点和局限？
优点
- 生成真正原生、可编辑的 PPTX，而非平面图像
- 支持原生图表、动画、旁白和模板
- 本地处理，数据保持隐私
- 免费开源，仅需支付 AI 模型费用
- 活跃开发，持续添加 PowerPoint 原生功能
局限
- 需要 AI 模型（推荐 Kimi K3 或 Claude）和图像生成（如 gpt-image-2）以获得最佳效果，增加成本
- 学习曲线：需要安装 Python 并熟悉 AI 工具的使用
- 生成的初始质量可能不完美，需手动调整
- Windows 可能需要额外配置
- 免费图片搜索（Openverse/Wikimedia）质量可能不稳定
这个 Agent 与同类方案有什么区别？
该项目未提及具体的替代产品；它将自己定位为“第一代”AIPP 工具，但未提及其他工具。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| PPT Master — AI 原生 PowerPoint 生成器 当前 | 0 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 64k | 今天 | Python | Claude Code |
| Paper2Slides：一键从论文生成演示文稿 | 44 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.8k | 5 个月前 | Python | — |
| PPT Agent | 41 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 912 | 4 个月前 | Python | — |
| PPTAgent（DeepPresenter） | 34 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 5.1k | 28 天前 | Python | — |
FollowAgents 如何评估这个 Agent？
FollowAgents 源码审查 · FARS-2.1
缺口较多
0/ 100
五分制 0.0 / 5
本评测基于 2026年8月9日 的源码；此后该项目发布了 17 个正式版本，尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
查看各维度的扣分理由
证据不足：未提供权限、确认、数据流、敏感数据处理、依赖安全、外部影响、回滚或来源归属的具体实现。README 声称数据本地化，但无代码证据。
证据不足：未提供自洽性、依赖可用性或失败消息的具体实现。
证据不足：未提供受众、能力边界、触发精度或环境适配的具体实现。
证据不足：未提供信息架构、安装说明、命名稳定性、示例、已知限制、许可证、版本控制或维护责任的具体实现。
证据不足：未提供输出可用性、边际价值或成本效益的具体实现。
证据不足：未提供声明可追溯性、交叉来源佐证或事实推断分离的具体实现。
风险与缓解建议
查看完整评分方法 →
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 静态审查仅基于 README、LICENSE、SECURITY.md、requirements.txt 和部署工作流，未检查实际代码。
- README 中的功能声明（如原生图表、动画、模板支持）未在提供的文件中得到验证。
- 依赖列表未提供具体版本，无法评估依赖安全性。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Patch release: fixes from an audit of the issue history. Most of them stop a tool from losing, overwriting or rewriting content while it reports success. Installation and startup - Skill-only installations create projects in your working folder again (703aa72f, #144). Since v6.3.0, project_manager.py init placed projects relative to the installed skill. For an npx skills or plugin installation, that meant .agents/projects/ or the plugin cache, where an update can replace them. Inside a repository checkout nothing changes. …在 GitHub 查看 ↗ -
发布说明摘录
Patch release: fixes for work that the live preview, source conversion and source import could lose without a warning, plus a full pass over the UI strings in every language. Live preview - Unapplied annotations and direct edits now survive a server stop (1fa3768a, #319). Before, they lived only in server memory, and the idle timeout, Exit preview, --shutdown, a kill or a crash before Apply changes discarded them. Closing a laptop lid made this likely: the idle timer counted the suspend time, so the server exited on wake. …在 GitHub 查看 ↗ -
发布说明摘录
Minor release: a browser review page for the design spec, Google's new Nano Banana 2.1 as the default Google image model, and fixes for content that source conversion and PPTX/SVG text round-trips used to lose without a warning. Image generation - Google image generation now defaults to Nano Banana 2.1 (gemini-nano-banana-2.1, GA on 2026-10-06), on the Gemini, OpenRouter (google/gemini-nano-banana-2.1) and fal (google/nano-banana-2.1) backends. Google has deprecated gemini-3.1-flash-image, but has not announced a shutdown date. Nano Banana 2.1 does not offer 512px, so all th …在 GitHub 查看 ↗
常见问题
PPT Master 是免费的吗？
项目本身免费，仅需支付 AI 模型 API 调用费用。可自行部署，无订阅服务。
我的数据安全吗？
是的。除与 AI 模型通信外，整个流程在本地运行，数据不发送到云端。
需要哪些 AI 模型或 API 密钥？
需要可访问 Claude、GPT、Gemini 等模型（推荐 Kimi K3 或 Claude）以及可选的图像生成服务（如 OpenAI 或 Google）的 API 密钥。项目赞助商提供这些服务的 API 转售。
遇到错误或输出不佳怎么办？
请检查 FAQ 文档，其中涵盖模型选择、布局问题、导出错误等。如果 AI 上下文丢失，可要求其阅读
skills/ppt-master/SKILL.md。可以自定义模板吗？
可以，支持使用自己的
.pptx 模板，并可将其提炼为可复用的品牌或布局模板。