ppt-master

项目概述

PPT Master 把文档、PDF、网页、图片或一段文字主题变成 PowerPoint 原生可编辑的 .pptx 文件，整条流水线在你自己的电脑上跑完：AI 负责拆解内容、设计版式并生成 SVG，仓库里的 Python 脚本再把 SVG 编译成 DrawingML。它不是一个独立软件，而是放在 skills/ppt-master 目录下的一套技能与脚本，任何能读写文件、执行命令、保持多轮对话的 AI 工具都能驱动它。产出不是贴图或套模板填空，而是带母版、原生形状、图表、表格与 OMML 公式的真实幻灯片，打开 PowerPoint 后可以逐页继续修改。

项目	内容
形态	AI 工具内的技能包加 Python 脚本
输出	原生可编辑 .pptx，默认附 svg_final/ 页面预览
运行环境	Python 3.10–3.14
许可	MIT

把「让 AI 画图」换成「让 AI 写真正的 PowerPoint」。

支持的宿主

宿主类型	代表工具	使用方式
IDE 内置 Agent	VS Code、Cursor、Trae、Windsurf、Zed	打开项目文件夹，在侧边聊天面板输入指令
IDE 插件	Claude Code 扩展、GitHub Copilot、Cline	装在 VS Code 或 JetBrains 宿主里调用
命令行 Agent	Claude Code CLI、Codex CLI、Gemini CLI	终端里进入项目目录后直接对话

主要功能

• 原生 PPTX 导出：输出落在 exports/名称_时间戳.pptx，形状、文本框与连接线都是 PowerPoint 原生对象，可直接改字改色
• 文档转大纲：直接读取 PDF、DOCX、HTML、EPUB、IPYNB，doc、odt、rtf、tex、rst、org、typ 等旧格式需另装 Pandoc
• 母版与版式：默认产出带 p:sldMaster 与 p:sldLayout 继承的幻灯片，也支持套用企业现成模板
• 原生图表表格：加 --native-charts-and-tables 时生成带「编辑数据」的 Chart 与 Table 对象，另存为 _native_charts_tables.pptx
• 公式与动效：公式编译为 OMML，PowerPoint 2010 及以上可编辑；支持原生切换、动画和按备注生成配音
• 图片获取：image_gen.py 走 AI 生图，image_search.py 走网页搜图，按 CC0、CC BY 等许可自动加署名
• 成品复填：把已有 .pptx 交给 AI，保留原有设计只换内容，未改页面保持字节级一致
• 画布规格：内置 PPT 16:9、小红书、微信公众号等 10 种以上画布尺寸

快速上手

1. 安装 Python 3.10–3.14，Windows 安装包记得勾选 Add to PATH
2. 克隆仓库后进入目录，执行 pip install -r requirements.txt
3. 用 AI 工具打开 ppt-master 文件夹，或在终端里进入该目录后启动 CLI Agent
4. 把 PDF、DOCX 或图片放进 projects/，在对话里写明路径，例如用 projects/q3-report/sources/report.pdf 做 8 页
5. 按 AI 给出的设计规格确认模板、比例与页数，也可以直接说快速生成、不用确认
6. 生成结束到 exports/ 取文件，默认流程的页面预览在 svg_final/
7. 需要数据驱动图表时追加 --native-charts-and-tables，会另存一份 _native_charts_tables.pptx
8. 需要配图时把 .env.example 复制为 .env，填入 PEXELS_API_KEY 或 PIXABAY_API_KEY，不填也能用 Openverse 搜图

适用人群

• 经常做汇报的职场人士
• 需要复用企业模板的团队
• 想批量产出幻灯片的运营
• 愿意折腾 AI 工具的技术用户

核心优势

• 成本只算模型：软件本身免费开源，除模型调用与你主动开启的搜索、生图、语音服务外没有订阅费用
• 数据留在本地：除调用模型外整条流水线在本机执行，素材不用先上传到第三方平台
• 不锁模型：Claude、GPT、Gemini、Kimi 都能驱动同一套流程，换工具不必重做项目
• 贴近原生能力：按 docs/powerpoint-svg-mapping.md 的逐项对照补齐 PowerPoint 特性，而不是把页面截图贴进幻灯片

系统要求

项目	要求
操作系统	Windows 10 及以上、macOS、Linux
Python	3.10–3.14
可选依赖	Pandoc，仅 doc、odt、rtf、tex、rst、org、typ 等旧格式需要
AI 工具	具备文件读写、命令执行与多轮对话能力的 Agent
模型上下文	建议 100 万 token 级，长文档更稳

注意事项

• 模型决定上限：技能只提供流程，排版质量取决于模型的上下文与审美，弱模型跑同一流程差距明显
• 单次生成不续跑：快速模式一次成型、不可恢复，也没有 svg_final/ 预览
• PDF 组件许可不同：可选的 PDF 转换器基于 AGPL-3.0 的 PyMuPDF，二次分发含该组件的包需遵守其条款
• 素材需自备：字体、品牌模板与高清图不在仓库内，企业模板要自行放进 projects/ 或模板目录
• 输出会持续累积：每次生成都在 exports/ 新建带时间戳的文件，长期使用需自行清理