PPT Master 使用指南在 Agent 工作流中生成原生可编辑 PowerPoint 的完整实践【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-masterPPT Master 是一套运行在任意具备 Agent 能力的 AI 工具中的 PPT 生成工作流skill把 PDF、DOCX、网页或纯文字材料交给 AI它在本机完成内容分析、视觉设计、SVG 创作与导出产出的是带原生形状、数据驱动图表与表格、母版版式的真实.pptx文件。本文以官方中文 README 为骨架结合仓库中的脚本目录、路由规则与配置样例完整覆盖从安装、配置到输出管线的全流程读完后你可以独立完成选择 Agent 环境、配置生图/搜图后端、跑通默认与快速两种生成模式并理解svg_output/→exports/的底层转换链。一、产品定位「原生深度」而不是一张能改的图README 开篇的判断是可编辑早已是及格线真正拉开差距的是原生深度。PPT Master 交付的是 PowerPoint 的原生对象模型本身——带调节手柄的原生形状与连接符、按需的数据驱动图表与表格、完整的文本/图片/填充/效果点开任意元素它都作为原生 PowerPoint 对象继续编辑。走模板/结构化路线时还能产出带真正母版与版式p:sldMaster/p:sldLayout继承的 deck。这份深度被定义为一个前进方向而非固定清单项目的北极星是持续向 PowerPoint 本身靠拢逐版本补齐更多原生能力缩小「AI 能替你生成的」与「你在 PowerPoint 里手工能做出的」之间的差距。PowerPoint ↔ SVG 映射指南 逐条、诚实地记录了当前能力的覆盖范围——其中 SmartArt 是刻意排除项而非缺口。工作流形态与三条承诺从形态看PPT Master 不是独立应用而是运行在有 Agent 能力的 AI 工具里的一个 skill在对话框里说用这份 PDF 做一份 PPT它就按流程在本机生成并导出原生可编辑的.pptx全程不写代码——只需要装 Python、装一个 AI 工具、把材料放进来。在此形态上它给出三个承诺成本透明可控工具免费开源MIT 协议见 LICENSE唯一成本是你自己的 AI 模型用量不叠加订阅费用数据不出本地除与 AI 模型的对话外全流程在你的电脑上完成不锁定平台任何具备 agent 能力的 AI IDE 均可驱动Claude、GPT、Gemini、Kimi 等模型均可使用。从 SKILL.md 的路由表还能看到「从源材料生成新 deck」只是主管线仓库同时内置了另外几条一等路线且各自有明确的保留契约路线运行时权威文档生成 PPTX — 图片转 PPTX恒定 Quickworkflows/profiles/image-to-pptx.md生成 PPTX — Beautify美化已有 deckworkflows/profiles/beautify-pptx.md生成 PPTX — 常规 Defaultworkflows/generate-pptx.md生成 PPTX — 显式 Quickworkflows/profiles/quick-generate.md创建可复用模板workflows/create-template.md填充原生 PPTX 模板workflows/template-fill-pptx.md增强已有 PPTX转场/动画/旁白workflows/native-enhance-pptx.md即你可以从参考资料中提炼可复用的品牌/风格/版式/成品模板、把新内容填进你已有的.pptx并保留其设计或为成品 deck 追加原生转场、动画和旁白。这是一个工具不是一个许愿池harness model agent——PPT Master 只负责工作流产出上限由模型决定。README 的明确建议使用大上下文窗口约 100 万 token的强模型如 Kimi K3 或 Claude驱动流程并搭配 AI 生图gpt-image-2或 Googlegemini-3.1-flash-image其他模型能跑通流程但存在质量差距。不要指望一把拿到完美成品——它的价值是把大部分枯燥的活儿干掉剩下的打磨交给你做原生可编辑的 PPT 本就是为了让你接着改而不是甩给你一张改不动的图。模型越便宜要补的人工就越多效果不理想时先升级模型再对照快速入门与examples/中的示例工程检查用法。为什么选它、以及它不适合的场景见 为什么选 PPT Master这些承诺背后的长期能力边界见 项目定位与能力边界。二、快速开始1. 前置条件只需安装 Python 3.10。其余依赖在第 3 步下载好项目后用一行pip install -r requirements.txt装齐。仓库根的 requirements.txt 实际只做一件事——通过-r skills/ppt-master/requirements.txt引入 skill 内置的完整依赖列表因此无论装完整仓库还是只装 skill 包依赖口径一致。Windows需要额外步骤PATH 设置、执行策略等官方提供了手把手安装指南 Windows 安装指南从零到跑通第一份 PPT 约 10 分钟。核心要点安装 Python 时勾选 Add to PATH。macOS / Linux安装即用# macOS brew install python # Ubuntu / Debian sudo apt install python3 python3-pip边缘场景备用方案99% 的用户用不到Pandoc 只在需要转小众格式时才装.doc、.odt、.rtf、.tex、.rst、.org、.typ。.docx、.html、.epub、.ipynb已由 Python 原生处理不需要 pandoc# macOS brew install pandoc # Ubuntu / Debian sudo apt install pandoc从源码结构看这些格式转换能力对应 scripts/README.md 中的source_to_md/目录pdf_to_md.py、doc_to_md.py、excel_to_md.py、ppt_to_md.py、web_to_md.py等后端转换器由统一的source_to_md.py分发入口调度。2. 选择一个 AgentPPT Master 在任何具备 agent 能力可读写文件、执行命令、持续多轮对话的工具里都能跑。没用过这类工具也不用担心它们在本项目里只扮演一个角色——一个能读写文件的 AI 聊天窗口。从下表任选一款装好即可全程只用它的聊天面板不需要写任何代码。作者最推荐Claude Code—— 本项目开发与测试最充分的环境CLI 与 VS Code / JetBrains 扩展均可。类型代表工具说明IDE 内置 agentVS Code 架构含 VS Code 本体及 Cursor、Trae、Codebuddy IDE、Windsurf 等分支与衍生、Zed 等编辑器原生集成 agentIDE 插件 / 扩展Claude CodeVS Code / JetBrains 扩展、GitHub Copilot、Cline、通义灵码 等装在 VS Code / JetBrains 等宿主里使用CLI agentClaude Code CLI、Codex CLI、Gemini CLI 等终端里运行适合脚本化 / 远程 / 服务器场景模型推荐追求最佳效果语言模型选 Kimi K3或 Claude驱动流程搭配 AI 生图 ——gpt-image-2OpenAI或gemini-3.1-flash-imageGoogle。3. 配置项目方式 A — Git clone推荐可随时拉取最新版本git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master.git cd ppt-master然后安装依赖pip install -r requirements.txt方式 B — 下载 ZIP无需安装 Git适合快速体验从仓库代码页选择 Download ZIP 下载解压后同样执行pip install -r requirements.txt装依赖。注意 ZIP 没有 Git 历史不能自动git pull。如果完整仓库下载失败或嫌体积太大可以改到 Releases 页面下载纯技能包ppt-master-skill-*.zip约 56 MB功能完整但不含内置示例 deck。方式 C — Skill marketplace仓库根目录已添加 .claude-plugin/marketplace.json 元数据当前版本 4.8.0git-subdir方式只拉取skills/子目录可通过 Claude Code plugin marketplace 生态一行安装# 跨 agent CLIClaude Code、Cursor、Codex 等 npx skills add hugohe3/ppt-master # 或在 Claude Code 内 /plugin marketplace add hugohe3/ppt-master /plugin install ppt-masterppt-master上述两种 marketplace 安装方式都只会拉取 skill 文件本身不含完整仓库后处理脚本仍需在安装目录跑pip install -r requirements.txt。日常更新Git clone 安装执行更新脚本python3 skills/ppt-master/scripts/update_repo.py脚本会拉取最新版如果requirements.txt有变化会自动同步 Python 依赖——这与 requirements.txt 头部注释一致update_repo.py会对该文件及其递归-r/--requirement引用树计算指纹。ZIP 安装重新下载最新版 ZIP解压到新目录把旧目录里的.env和projects/复制过去再执行pip install -r requirements.txt。4. 开始创作先在 Agent 里打开项目文件夹目标是让 AI 工作在上一步解压/克隆出来的ppt-master目录里——IDE 类工具通过菜单「文件 → 打开文件夹」打开它CLI 类工具先cd ppt-master再启动。之后的一切都在聊天里完成。提供原始材料推荐将 PDF、DOCX、图片等文件放入projects/目录下在 AI 聊天面板中告诉它使用哪些文件。获取路径的最快方式在文件管理器或 IDE 侧边栏中右键文件 → 复制路径Copy Path / Copy Relative Path直接粘贴进聊天框你请用 projects/q3-report/sources/report.pdf 这份文件生成一份 PPT直接输入内容也可以把文字内容直接粘贴进聊天窗口AI 会根据这些内容生成 PPT你请根据以下内容制作成 PPT[粘贴你的文字内容...]默认流程下除非显式要求快速生成AI 会先确认设计规范AI好的先确认设计规范 [模板] B) 自由设计 [格式] PPT 16:9 [页数] 8-10 页 ...AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。这个「先停下来确认」的行为有明确的源码依据SKILL.md 的全局执行纪律规定「Blocking means stop」——在每个⛔ BLOCKING门控处等待用户显式确认不得替用户做决定且「串行执行」按所选路由权威文档的步骤顺序推进。快速生成跳过来回确认显式说明即可AI 直接进入创作与导出你用 projects/q3-report/sources/report.pdf 快速生成一份 5 页 PPT不用跟我确认你明确提的照做你没提的由 AI 直接定不再回来问。它仍会转换来源、补齐事实、应用共享视觉基线并按需使用图片/图标/原生形状/图表/表格/PowerPoint 原生行内或块级公式——省掉的是交互与持久规划不是 PPT 能力。Quick 模式quick-generate.md是不可续接的一次性生成也不会产生svg_final/预览细节见下文「输出说明」。输出说明管线细节SVG 管线统一由项目转换器读取svg_output/生成可直接编辑的原生 DrawingML.pptx保存至exports/name_timestamp.pptx默认 Generate 流程会运行finalize_svg.py并生成自包含预览svg_final/PowerPoint 手工「转换为形状」不在支持范围Quick 模式跳过 Strategist、确认、design_spec.md、spec_lock.md与finalize_svg.py通过无锁的 Quick 最终质量检查后导出最终 PPTX它不写替代计划上下文丢失后不能续接公式 marker 会把 LaTeX payload 编译为 PowerPoint 2010 可编辑 OMML块级 group 与行内tspanrun 都保留普通 SVG 预览导出时将其替换。Keynote、WPS、LibreOffice 等非 PowerPoint 客户端的公式显示与编辑能力不在支持合同内讲稿、自定义对象动画和旁白默认关闭Agent 可在用户要求或 deck 确有需要时启用Quick 使用默认输出路径时仍会生成普通 postflight 报告并把svg_output/镜像到backup/timestamp/svg_output/显式指定输出路径时沿用普通流程不创建备份的行为图表和表格默认导出为 SVG 派生、可逐形状编辑的 DrawingML 对象优先保证 PowerPoint / Keynote / WPS 间的视觉一致性可加--native-charts-and-tables把符合合同的组替换为带数据源和对象专属编辑能力的 PowerPoint 原生 Chart/Table 对象跨软件渲染可能略有差异保存为exports/name_timestamp_native_charts_tables.pptx。这两种导出变体都可编辑区别在于 PowerPoint 对象模型而不是「能否编辑」。已有一份想复用的.pptx把那份 deck 连同素材给 AI说「套模板」即可——它会把新内容文字、表格、图表数据填进你现有的设计只导出你挑选的页面且保持原生可编辑。详见 常见问题 与 套模板工作流。遇到问题AI 迷失上下文时让它先读 skills/ppt-master/SKILL.md其他问题查看 常见问题——涵盖模型选择、排版问题、导出异常等基于真实用户反馈持续更新。5. 图片获取可选非用户自带图片有两条路径可在同一份 deck 里按图混用A) AI 生图— Agent host 提供原生生图工具时可直接使用也可通过image_gen.py配置IMAGE_BACKEND和供应商*_API_KEY。host-native 生图不需要另配供应商生图 API Key直接要求 Agent 使用自身生图工具即可。运行python3 skills/ppt-master/scripts/image_gen.py --list-backends查看供应商后端清单该参数已在 image_gen.py 的命令行入口确认存在。gpt-image-2目前综合质量最佳。从源码结构看image_backends/ 目录实际内置了 13 个供应商实现openai、gemini、qwen、zhipu、volcengine.env.example标注的推荐核心后端以及 minimax、stability、bfl、fal、ideogram、modelscope、openrouter、replicate、siliconflow。B) 网络图片搜索—image_search.py零配置可用建议配置PEXELS_API_KEY/PIXABAY_API_KEY都免费申请以获得稳定的高质量结果不配置时只使用 Openverse / Wikimedia Commons适合作为兜底但容易出现构图随意、清晰度不稳定的图片配置后默认搜索链会追加 Pexels / Pixabay现代商业摄影、人物、办公、生活方式和插画类图片质量明显更稳定对应 image_sources/ 下的provider_openverse.py、provider_wikimedia.py、provider_pexels.py、provider_pixabay.py四个提供者许可自动处理默认把 CC0、公有领域、Pexels / Pixabay 免署名许可、CC BY、CC BY-SA 一起纳入候选选中需署名的图片时Executor 会在该幻灯片自动添加小字署名。只有明确不能出现署名时才使用--strict-no-attribution限制为免署名图片该参数在 image_search.py 的严格模式逻辑中实现对视觉要求高的封面、产品图、人物图和品牌场景优先级建议用户自带高清素材 / AI 生图 配置 Pexels / Pixabay 的网络搜索 零配置网络搜索。完整说明image-generator.mdAI· image-searcher.md网络。API Key 的.env配置上面提到的 API Key 统一通过.env配置模板见仓库根的 .env.example。clone 安装可以用cp .env.example .envskill marketplace 安装建议使用持久的用户级配置mkdir -p ~/.ppt-master cp /path/to/installed/ppt-master/.env.example ~/.ppt-master/.envPPT Master 会优先读取当前进程环境变量然后按顺序读取第一个存在的.env多个.env之间不合并顺序为当前工作目录下的./.envskill 安装目录下的.env如~/.agents/skills/ppt-master/.envclone 仓库根目录的.env~/.ppt-master/.env用户级配置。以生图为例.env.example 中的关键项IMAGE_BACKEND必需选择供应商、IMAGE_CONCURRENCY--manifest批量模式下的最大并发数默认 3命中限流自动减半最低 1 即串行以及各供应商专属的*_API_KEY/*_MODEL注意IMAGE_API_KEY/IMAGE_MODEL/IMAGE_BASE_URL这类通用变量已不再支持请只使用各提供商自己的变量。三、端到端管线脚本视角的印证examples/下每个示例工程如examples/ppt169_swiss_grid_systems/都完整保留了管线各阶段的产物notes/每页讲稿、svg_output/Agent 手写 SVG、svg_final/finalize 后的自包含预览、exports/最终.pptx、design_spec.md与spec_lock.md设计规范与锁定。这与 scripts/README.md 给出的典型端到端命令链一一对应python3 scripts/source_to_md.py file-or-url-or-dir [file-or-url-or-dir ...] # 来源 → Markdown python3 scripts/project_manager.py init project_name --format ppt169 # 初始化项目 python3 scripts/project_manager.py import-sources project_path source_files_or_dirs... python3 scripts/total_md_split.py project_path # 讲稿拆分 python3 scripts/finalize_svg.py project_path # 生成自包含预览 python3 scripts/animation_config.py scaffold project_path # 可选对象级动画覆盖 python3 scripts/svg_to_pptx.py project_path # 导出原生 PPTX几个值得注意的实现事实路由先行SKILL.md 规定强制加载顺序——先读 SKILL.md运行python3 scripts/attribution_guard.py完整性校验非零退出即终止再读 workflows/routing.md 选定唯一顶层路由之后只加载该路由的运行时权威文档绝不跨路由混用确定性路由当 routing 权威已能解析请求时不得额外添加路由选择问题路由前置条件缺失则声明并停止该路线工作流日志init之后项目级 Python CLI 会自动把命令包络和有界的材料结果记录到project_path/validation/workflow.log无需日志包装器Windows 兼容SKILL.md 明确若文档中python3 ...命令在 Windows 上不可用用python重跑同一命令。四、文档导航文档说明快速入门三步做出第一份 deck外加模板、实时预览、动画、旁白、声音复刻的用法新用户从这里开始为什么选 PPT Master为什么选它、以及它不适合的场景项目定位与能力边界长期定位、产品承诺与能力边界Windows 安装指南Windows 用户手把手安装教程SKILL.md核心流程与规则画布格式PPT 16:9、小红书、朋友圈等 10 种格式脚本与工具所有脚本和命令示例所有示例项目技术路线架构、设计哲学、为什么选 SVG常见问题模型选择、费用、排版问题排查、自定义模板完整文档索引见 docs/zh/README.md。五、贡献、协议与致谢贡献流程详见 CONTRIBUTING.md项目采用 MIT 协议LICENSE使用需保留署名。第三方图标SVG Repo、Tabler Icons、Simple Icons、Phosphor Icons 等的固定版本、许可证、署名、兼容层与商标边界详见 第三方图标说明。最后说明一点项目缘起作者何雨果Hugo He是投融资领域从业者工作中经常审阅和修改 PPT因此要求 AI 生成的幻灯片仍能回到 PowerPoint 里继续编辑而不是被压成一张张图片。作者也强调做 PPT 只是载体项目真正想推广的是 Python 和 agent 这套能力组合——零基础上手有一段学习曲线但走完这段你就接上了未来。【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
