PPT Master 完全上手指南用 AI 工作流从任意文档生成原生可编辑 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 是一个开源的 AI 演示文稿工作流它作为技能skill运行在任意具备 Agent 能力的 AI 工具中把 PDF、DOCX、网页或一段文字转化为带真实 PowerPoint 对象模型的.pptx—— 原生形状、基于数据的图表与表格、可选动画、由演讲者备注合成的语音旁白并支持沿用你自己的 PPT 模板。本文基于仓库根目录的 README 完整展开其产品定位、安装与三种安装方式的差异、生成流程含快速生成模式、导出变体与图片获取配置并结合skills/ppt-master/下的源码与依赖清单讲清AI 生成 SVG → 工程化转换为 DrawingML这条流水线在底层是如何落地的。产品定位可编辑只是起点原生深度才是卖点README 开篇给出了一句核心判断Editable is already table stakes — what sets PPT Master apart is native depth.可编辑在 2026 年已经是 AI 演示工具的基本线PPT Master 的差异在于交付的是 PowerPoint 的原生对象模型本身原生形状与连接线且带可用的调整手柄按需生成数据驱动的原生图表与表格对象不只是画出来的图形完整的文本 / 图片 / 填充 / 效果模型点击任意元素即按原生 PowerPoint 对象继续编辑走模板 / 结构化路线时能交付带真实幻灯片母版与版式p:sldMaster/p:sldLayout继承的 PPTX。这份原生深度被定位为**行进方向而非固定清单**项目的北极星是持续向 PowerPoint 本身收敛版本一个接一个地补齐其原生能力。仓库中 PowerPoint ↔ SVG 映射指南 是逐项记录当前覆盖边界的官方文档SmartArt 是刻意不做的功能而非遗漏。在产品形态上PPT Master 是一个工作流skill运行在任意 Agent 工具里你在聊天框里说用这份 PDF 做一份 deck它就在你本机跑完整个工作流并导出.pptx。用户不需要写代码只做三件事——装 Python、装一个 AI 工具、放入素材。此外从新文档生成 deck 是主路线但不是唯一路线。SKILL.md 的路由表定义了三条并列的顶层路线各有明确的保留什么契约路线说明Fill Native PPTXtemplate-fill-pptx.md已有.pptx 新素材克隆指定源页并在 OOXML 层直接打补丁替换文本 / 表格 / 图表数据保留原有设计Create Templatecreate-template.md从参考物中提炼可复用的 Brand / Style / Layout / Deck 工作区再基于工作区生成新 deckEnhance Native PPTXnative-enhance-pptx.md给完成的 deck 追加原生转场、动画、旁白布局与内容保持稳定README 同时列出三项承诺成本透明可预测开源免费唯一成本是你的 AI 模型用量不叠加 PPT 订阅费、数据留在本地除与 AI 模型通信外整条流水线在本机运行、无平台锁定任何 Agent 工具都能驱动Claude / GPT / Gemini / Kimi 等模型均可。详细的取舍分析见 Why PPT Master 与 Project Positioning。README 中有一条!IMPORTANT提示值得原样保留这是一个工具不是许愿池。harness model agent—— PPT Master 只拥有工作流模型决定质量上限。官方推荐组合是Kimi K3或 Claude这类 ~1M token 大上下文模型 AI 图像生成gpt-image-2或 Googlegemini-3.1-flash-image其他模型能跑通流水线但存在质量差距。也不应期望一次生成即得完美成品——工具的價值在于替你做掉大部分繁琐工作剩余打磨靠原生可编辑这一前提来完成结果不理想时先升级模型再对照 Getting Started 与示例项目自查。底层原理速览为什么中间层是 SVG最终产物怎么变成原生对象README 描述的AI 处理内容分析、视觉设计、SVG 生成、PPTX 导出背后是一条明确的三阶段流水线完整架构见 Technical DesignStage 1 — 内容理解与设计规划源文档PDF/DOCX/XLSX/PPTX/URL/Markdown/主题文本经source_to_md.py分派转换为 Markdown 与事实基线Strategist 角色确认沟通契约并产出design_spec.mdspec_lock.mdStage 2 — AI 视觉生成Executor 角色把每一页生成为svg_output/下的 SVG设计稿而非成品Stage 3 — 工程化转换后处理脚本把受支持的 SVG 矢量元素编译为 DrawingML文本和矢量形状保持原生 PowerPoint 对象栅格资源作为图片媒体复制进包而不是把整页压成一张图。Technical Design 解释了为什么中间层选 SVG 而非直接生成 DrawingMLXML 过于冗长、AI 训练数据少、HTML文档流与画布绝对定位是世界观不匹配或 WMF/EMFAI 几乎无训练数据SVG 与 DrawingML 共享同一套绝对坐标 2D 矢量图形世界观如rect rx...映射到a:prstGeom prstroundRect。关键工程决策是项目不追求转换任意 SVG而是定义了一套项目规范化 SVG 中间语言SVG 适配 PPT Master而不是 PPT Master 去扩张兼容整个 SVG 标准。从源码结构看这条流水线的关键节点都在 scripts 目录 中有对应脚本与索引文档环节脚本职责源文档转换source_to_md.py及其子模块pdf_to_md.py/doc_to_md.py/excel_to_md.py/ppt_to_md.py/web_to_md.py按文件类型分派转 Markdown项目管理project_manager.pyinit建项目、import-sources归档素材并产出分析文件质量检查svg_quality_checker.py对 SVG 中间语言执行项目契约错误阻断、警告放行预览物化finalize_svg.py从svg_output/派生自包含的svg_final/预览内联图片/图标核心转换svg_to_pptx.py防御性校验后把 SVG 编译为原生 DrawingML 并写入exports/动画 / 旁白pptx_animations.py/notes_to_audio.py/narration_sync.py对象级动画预设、逐页 TTS 与音频回填依赖层面根目录 requirements.txt 仅包含一行-r skills/ppt-master/requirements.txt保证单装 skill 也具备完整能力skill 内置依赖清单 则逐项标注了各依赖服务的脚本python-pptx0.6.21与XlsxWriter3.0.0PPTX 写出与图表数据工作簿、PyMuPDF1.23.0PDF 转 Markdown、mammoth/markdownify/ebooklib/nbconvertDOCX/HTML/EPUB/IPYNB 原生纯 Python 路径、edge-tts7.2.8默认旁白引擎、Pillow/numpy图片处理、flask3.0.0SVG 本地编辑器等。这也印证了 README 的说法.docx、.html、.epub、.ipynb走纯 Python 原生路径Pandoc 只用于.doc、.odt、.rtf、.tex、.rst、.org、.typ等小众格式。快速开始五步生成第一份 deck1. 前置条件只装 Python 3.10README 明确All you need to install is Python 3.10其余依赖在第三步用一行pip install -r requirements.txt装齐。macOS / Linuxbrew install pythonmacOS或sudo apt install python3 python3-pipUbuntu / Debian。Windows需要额外处理 PATH、执行策略等仓库提供了专门的 Windows 安装分步指南。速记版从 python.org 下载 → 安装时勾选Add to PATH→ 完成。边缘情况兜底99% 用户不需要仅当要处理.doc/.odt/.rtf/.tex/.rst/.org/.typ等遗留格式时才需要 Pandocbrew install pandoc或sudo apt install pandoc。2. 选一个 Agent 工具PPT Master 运行在任何有 Agent 能力的工具里要求只有三条能读写文件、能执行命令、能维持多轮对话。README 用一句话降低了理解门槛这些工具在本项目中只扮演一个角色——一个能读写文件的 AI 聊天窗口你只会用到它的聊天面板无需编程。类型示例备注IDE 内置 AgentVS Code 系Cursor、Trae、Windsurf 等、Zed 等编辑器自带 AgentIDE 插件 / 扩展Claude CodeVS Code / JetBrains 扩展、GitHub Copilot、Cline 等装在 VS Code / JetBrains 等宿主内CLI AgentClaude Code CLI、Codex CLI、Gemini CLI 等跑在终端适合脚本化 / 远程 / 服务器场景作者自己的选择是Claude Code——本项目开发中测试最充分的环境。模型推荐同上Kimi K3或 Claude驱动 gpt-image-2/gemini-3.1-flash-image图像生成。3. 安装三种方式及其差异方式 A — Git clone推荐可随时pull最新版git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master.git cd ppt-master pip install -r requirements.txt方式 B — 下载 ZIP无需 Git适合快速试用从仓库页面 Code → Download ZIP 下载解压后同样执行pip install -r requirements.txt。ZIP 没有 Git 历史不能git pull若完整仓库下载过大或失败可从 Releases 页面拿ppt-master-skill-*.zip约 56 MB功能完整但不含捆绑的示例 deck。方式 C — Skill 市场仓库自带 .claude-plugin/marketplace.json可经 Claude Code 插件市场生态安装# 跨 Agent 的 CLIClaude Code、Cursor、Codex 等 npx skills add hugohe3/ppt-master # 或在 Claude Code 内部 /plugin marketplace add hugohe3/ppt-master /plugin install ppt-masterppt-master注意方式 C 只拉取 skill 文件而非整个仓库安装后仍需在安装位置执行pip install -r requirements.txt后处理脚本才能运行。后续更新# Git clone 安装一条命令拉最新版并在 requirements.txt 变化时同步 Python 依赖 python3 skills/ppt-master/scripts/update_repo.pyZIP 安装则需下载新 ZIP 解压到目录、把旧的.env与projects/复制过去再pip install -r requirements.txt。从 requirements.txt 头部注释看update_repo.py会对该文件及其递归-r引用树做指纹比对来决定是否重装依赖。4. 创建整个交互发生在聊天框里首先在 Agent 中打开ppt-master目录IDE 类工具用 File → Open FolderCLI Agent 先cd ppt-master再启动之后一切都在聊天里进行。提供源素材推荐把 PDF、DOCX、图片等放入projects/目录然后在聊天中指明用哪个文件——最省事的方式是在文件管理器或 IDE 侧边栏右键 →复制路径直接粘贴进聊天You: Please create a PPT from projects/q3-report/sources/report.pdf直接粘贴文本也可以You: Please turn the following into a PPT: [粘贴你的内容...]默认流程会先确认设计规范除非你明确要求快速生成AI: Sure. Lets confirm the design spec: [Template] B) Free design [Format] PPT 16:9 [Pages] 8-10 pages ...之后内容由 AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。快速生成模式跳过确认但保留全部表现力明确说出快速生成即可跳过确认回合You: Quickly generate a 5-page deck from projects/q3-report/sources/report.pdf — no need to confirm with meREADME 对 Quick 模式的契约表述非常精确值得逐条拆解你明确说出的都会照做你没有指定的Agent 直接自行决定而不是回头来问。它跳过的是交互与持久化规划Strategist 记录、design_spec.md、spec_lock.md、finalize_svg.py、svg_final/预览而不是表现力——源文档转换、事实缺口检索、共享视觉基线、图片/图标/原生形状/图表/表格/原生公式照常按需使用。代价是单程、不可恢复——上下文丢失后不能续跑。完整说明见 Quick mode 与 quick-generate profile。输出与导出契约一个转换器多个变体README 用一整段说明了导出契约这是理解产物文件命名和差异的关键唯一的 PPTX 转换器读取svg_output/把可直接编辑的原生 DrawingML deck 写到exports/name_timestamp.pptx。默认 Generate 流程会先跑finalize_svg.py产出svg_final/自包含预览PowerPoint 手动的Convert to Shape命令不在支持契约之内。图表 / 表格默认形态默认导出为独立可编辑的 SVG 派生 DrawingML 形状优先保证跨应用视觉一致性。传--native-charts-and-tables则把符合条件的组替换为带数据支撑的 PowerPoint 原生 Chart/Table 对象提供 Edit Data 与对象级控制但跨应用渲染可能不一致该变体另存为exports/name_timestamp_native_charts_tables.pptx。两者的区别是PowerPoint 对象模型而非可编辑性——两种形态都完全可编辑。普通导出能力按需可用原生图表/表格替换、备注、动效、旁白、诊断其中备注、自定义对象动画、旁白默认关闭Agent 会在请求或 deck 有需要时启用。默认路径的 Quick 导出会写标准 postflight 报告并把svg_output/快照到backup/timestamp/svg_output/成功拷贝后可不重跑 LLM 直接重导。已有.pptx想复用把该 deck 加素材交给 AI要求用新内容填充这份 deck——它会填充文本、表格与图表数据只导出你挑选的页并保持原生可编辑见 FAQ 与 template-fill 工作流。出问题了若 AI 丢失上下文让它重读 SKILL.md其余情况查 FAQ——它覆盖模型选择、布局问题、导出问题且持续从真实用户反馈更新。从源码结构看svg_to_pptx.py在 Technical Design 中被明确赋予了防御性校验编译映射与包、要求当前匹配的最终质量报告、并把报告链接进 postflight的职责validation/目录会落盘workflow.log、svg_quality_report.json与output_stem.report.json三类审计产物为每次导出留下可复查的证据链。图片获取AI 生成与网络检索两条路可混用README 把图片获取Image Acquisition列为独立可选章节同一 deck 内可逐张混用两条路径AAI 生成— 优先使用 Agent 宿主自带的图像工具无需单独的图像 API key或用image_gen.py配合IMAGE_BACKEND与各提供商的*_API_KEY。运行python3 skills/ppt-master/scripts/image_gen.py --list-backends可列出已配置后端README 认为gpt-image-2目前是最优默认。B网络图片搜索—image_search.py零配置可用配置PEXELS_API_KEY/PIXABAY_API_KEY均免费可显著提升质量无 key 时只走 Openverse / Wikimedia Commons——可用但质量参差很多结果是普通用户上传有 key 时默认提供商链自动追加 Pexels / Pixabay对现代商业图库类题材人物、职场、生活方式、插画覆盖显著改善授权自动处理CC0、公共领域、Pexels / Pixabay 免署名许可、CC BY、CC BY-SA 一并考虑Executor 会为需要署名的图片加一行小型内联署名仅当某页完全容不下署名时再用--strict-no-attribution高影响位封面、产品照、人像、品牌场景的推荐顺序用户提供的高清素材 / AI 生成 带 Pexels / Pixabay key 的网络搜索 零配置网络搜索。.env的解析规则README 与 .env.example 一致PPT Master 先读当前进程环境变量然后只读第一个命中的.env多个文件之间不合并查找顺序为当前工作目录的./.envskill 安装目录如~/.agents/skills/ppt-master/.envclone 仓库根目录的.env~/.ppt-master/.env用户级配置clone 安装直接cp .env.example .env即可skill 市场安装建议用持久用户配置mkdir -p ~/.ppt-master cp /path/to/installed/ppt-master/.env.example ~/.ppt-master/.env从 .env.example 可以看到具体配置面IMAGE_BACKENDopenai / gemini / minimax / qwen / zhipu / volcengine 等 对应提供商的*_API_KEY/*_MODEL/*_BASE_URL以及IMAGE_CONCURRENCY--manifest批量模式最大并发默认 3限流自动减半最低 1。示例文件还特别注明IMAGE_API_KEY/IMAGE_MODEL/IMAGE_BASE_URL已不再支持只能使用提供商专属变量。完整参考见 image-generator.mdAI 生成与 image-searcher.md网络搜索。文档地图与常见问题入口README 维护了一张官方文档索引表按先读什么排序文档说明Getting Started三步出第一份 deck模板、实时预览、动画、旁白、声音克隆新用户从这里开始Why PPT Master为什么选它以及它不适合的场景Project Positioning长期定位、产品承诺与能力边界Windows InstallationWindows 分步安装SKILL.md核心工作流与规则强制加载顺序、路由表、全局执行纪律Canvas FormatsPPT 16:9、小红书、微信等 10 画幅格式Scripts Tools全部脚本与命令索引Examples全部示例项目Technical Design架构、设计哲学、为什么是 SVGFAQ模型选择、成本、布局排障、自定义模板完整索引在 docs/README.md。几个 FAQ 中值得提前知道的答案字体尺寸全链路用无单位 px画布就是 1280×720 px导出时自动按pt px × 0.75换算所以 PowerPoint 里出现13.5pt、31.5pt这类非整点是刻意设计正文基线按阅读模式固定取值text20px≈15pt /balanced24px≈18pt /presentation32px≈24ptdeck 风格由两个独立维度决定——Modepyramid/narrative/instructional/showcase/briefing决定怎么论证与Visual styleswiss-minimal/editorial/soft-rounded/dark-tech等决定看起来什么样任意组合。从源码与示例仓库验证能力README 强调下载任意一份.pptx在 PowerPoint 里打开是看它真实能力最快的方式。仓库 examples/ 目录保留了 20 个完整示例项目如 ppt169_attention_is_all_you_need、ppt169_global_ai_capital_2026、ppt169_cangzhuo 等每个示例都遵循统一结构project_name/ ├── design_spec.md # 设计规范人可读 ├── spec_lock.md # 机器可读执行契约 ├── images/ # 图片资产 ├── notes/ # 每页演讲者备注 ├── svg_output/ # 原始 SVG带占位符 ├── svg_final/ # 自包含预览 SVG内联图标与图片 └── exports/ # 最终 PPTX 输出这个结构正好与上文数据流一一对应svg_output/是创作态authoring statesvg_final/、exports/、backup/是派生交付态——Technical Design 特别强调区分二者否则校验、重导出与手工修复都会变得难以推理。示例项目可用本地静态服务直接预览python -m http.server --directory examples/project_name/svg_final 8000examples.json 是在线目录的数据源。最后关于 SKILL.md 的强制加载顺序它规定了 Agent 每次运行的入口纪律先读本文件 → 运行attribution_guard.py完整性闸门非零结果立即停止禁止绕过→ 读 workflows/routing.md →恰好选定一条顶层路线及其 profile → 只加载对应的运行时权威文档。配合全局执行纪律串行执行、⛔ BLOCKING门处必须停下等用户确认、禁止跨阶段合并、禁止投机执行、失败时修复拥有该产物的源工件而不是静默降级这套机制解释了 README 反复强调的工具只拥有工作流、质量上限在模型是如何在工程侧被兜住的。小结PPT Master 把AI 做 PPT从生成好看的静态页面推进到生成 PowerPoint 原生对象模型一条SVG 中间语言 → DrawingML的可审计流水线三条带明确保留契约的 PPTX 路线一份零订阅成本、数据留在本机、可被任何 Agent 工具驱动的技能。上手路径很短——装 Python 3.10、装一个 Agent 工具、pip install -r requirements.txt、把素材丢进projects/然后聊天——但值得花时间精读的三篇文档是 Getting Started、Technical Design 和 FAQ它们分别覆盖了操作、原理与排障的完整知识面。【免费下载链接】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），仅供参考 PPT Master 完全上手指南：用 AI 工作流从任意文档生成原生可编辑 PowerPoint
PPT Master 完全上手指南用 AI 工作流从任意文档生成原生可编辑 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 是一个开源的 AI 演示文稿工作流它作为技能skill运行在任意具备 Agent 能力的 AI 工具中把 PDF、DOCX、网页或一段文字转化为带真实 PowerPoint 对象模型的.pptx—— 原生形状、基于数据的图表与表格、可选动画、由演讲者备注合成的语音旁白并支持沿用你自己的 PPT 模板。本文基于仓库根目录的 README 完整展开其产品定位、安装与三种安装方式的差异、生成流程含快速生成模式、导出变体与图片获取配置并结合skills/ppt-master/下的源码与依赖清单讲清AI 生成 SVG → 工程化转换为 DrawingML这条流水线在底层是如何落地的。产品定位可编辑只是起点原生深度才是卖点README 开篇给出了一句核心判断Editable is already table stakes — what sets PPT Master apart is native depth.可编辑在 2026 年已经是 AI 演示工具的基本线PPT Master 的差异在于交付的是 PowerPoint 的原生对象模型本身原生形状与连接线且带可用的调整手柄按需生成数据驱动的原生图表与表格对象不只是画出来的图形完整的文本 / 图片 / 填充 / 效果模型点击任意元素即按原生 PowerPoint 对象继续编辑走模板 / 结构化路线时能交付带真实幻灯片母版与版式p:sldMaster/p:sldLayout继承的 PPTX。这份原生深度被定位为**行进方向而非固定清单**项目的北极星是持续向 PowerPoint 本身收敛版本一个接一个地补齐其原生能力。仓库中 PowerPoint ↔ SVG 映射指南 是逐项记录当前覆盖边界的官方文档SmartArt 是刻意不做的功能而非遗漏。在产品形态上PPT Master 是一个工作流skill运行在任意 Agent 工具里你在聊天框里说用这份 PDF 做一份 deck它就在你本机跑完整个工作流并导出.pptx。用户不需要写代码只做三件事——装 Python、装一个 AI 工具、放入素材。此外从新文档生成 deck 是主路线但不是唯一路线。SKILL.md 的路由表定义了三条并列的顶层路线各有明确的保留什么契约路线说明Fill Native PPTXtemplate-fill-pptx.md已有.pptx 新素材克隆指定源页并在 OOXML 层直接打补丁替换文本 / 表格 / 图表数据保留原有设计Create Templatecreate-template.md从参考物中提炼可复用的 Brand / Style / Layout / Deck 工作区再基于工作区生成新 deckEnhance Native PPTXnative-enhance-pptx.md给完成的 deck 追加原生转场、动画、旁白布局与内容保持稳定README 同时列出三项承诺成本透明可预测开源免费唯一成本是你的 AI 模型用量不叠加 PPT 订阅费、数据留在本地除与 AI 模型通信外整条流水线在本机运行、无平台锁定任何 Agent 工具都能驱动Claude / GPT / Gemini / Kimi 等模型均可。详细的取舍分析见 Why PPT Master 与 Project Positioning。README 中有一条!IMPORTANT提示值得原样保留这是一个工具不是许愿池。harness model agent—— PPT Master 只拥有工作流模型决定质量上限。官方推荐组合是Kimi K3或 Claude这类 ~1M token 大上下文模型 AI 图像生成gpt-image-2或 Googlegemini-3.1-flash-image其他模型能跑通流水线但存在质量差距。也不应期望一次生成即得完美成品——工具的價值在于替你做掉大部分繁琐工作剩余打磨靠原生可编辑这一前提来完成结果不理想时先升级模型再对照 Getting Started 与示例项目自查。底层原理速览为什么中间层是 SVG最终产物怎么变成原生对象README 描述的AI 处理内容分析、视觉设计、SVG 生成、PPTX 导出背后是一条明确的三阶段流水线完整架构见 Technical DesignStage 1 — 内容理解与设计规划源文档PDF/DOCX/XLSX/PPTX/URL/Markdown/主题文本经source_to_md.py分派转换为 Markdown 与事实基线Strategist 角色确认沟通契约并产出design_spec.mdspec_lock.mdStage 2 — AI 视觉生成Executor 角色把每一页生成为svg_output/下的 SVG设计稿而非成品Stage 3 — 工程化转换后处理脚本把受支持的 SVG 矢量元素编译为 DrawingML文本和矢量形状保持原生 PowerPoint 对象栅格资源作为图片媒体复制进包而不是把整页压成一张图。Technical Design 解释了为什么中间层选 SVG 而非直接生成 DrawingMLXML 过于冗长、AI 训练数据少、HTML文档流与画布绝对定位是世界观不匹配或 WMF/EMFAI 几乎无训练数据SVG 与 DrawingML 共享同一套绝对坐标 2D 矢量图形世界观如rect rx...映射到a:prstGeom prstroundRect。关键工程决策是项目不追求转换任意 SVG而是定义了一套项目规范化 SVG 中间语言SVG 适配 PPT Master而不是 PPT Master 去扩张兼容整个 SVG 标准。从源码结构看这条流水线的关键节点都在 scripts 目录 中有对应脚本与索引文档环节脚本职责源文档转换source_to_md.py及其子模块pdf_to_md.py/doc_to_md.py/excel_to_md.py/ppt_to_md.py/web_to_md.py按文件类型分派转 Markdown项目管理project_manager.pyinit建项目、import-sources归档素材并产出分析文件质量检查svg_quality_checker.py对 SVG 中间语言执行项目契约错误阻断、警告放行预览物化finalize_svg.py从svg_output/派生自包含的svg_final/预览内联图片/图标核心转换svg_to_pptx.py防御性校验后把 SVG 编译为原生 DrawingML 并写入exports/动画 / 旁白pptx_animations.py/notes_to_audio.py/narration_sync.py对象级动画预设、逐页 TTS 与音频回填依赖层面根目录 requirements.txt 仅包含一行-r skills/ppt-master/requirements.txt保证单装 skill 也具备完整能力skill 内置依赖清单 则逐项标注了各依赖服务的脚本python-pptx0.6.21与XlsxWriter3.0.0PPTX 写出与图表数据工作簿、PyMuPDF1.23.0PDF 转 Markdown、mammoth/markdownify/ebooklib/nbconvertDOCX/HTML/EPUB/IPYNB 原生纯 Python 路径、edge-tts7.2.8默认旁白引擎、Pillow/numpy图片处理、flask3.0.0SVG 本地编辑器等。这也印证了 README 的说法.docx、.html、.epub、.ipynb走纯 Python 原生路径Pandoc 只用于.doc、.odt、.rtf、.tex、.rst、.org、.typ等小众格式。快速开始五步生成第一份 deck1. 前置条件只装 Python 3.10README 明确All you need to install is Python 3.10其余依赖在第三步用一行pip install -r requirements.txt装齐。macOS / Linuxbrew install pythonmacOS或sudo apt install python3 python3-pipUbuntu / Debian。Windows需要额外处理 PATH、执行策略等仓库提供了专门的 Windows 安装分步指南。速记版从 python.org 下载 → 安装时勾选Add to PATH→ 完成。边缘情况兜底99% 用户不需要仅当要处理.doc/.odt/.rtf/.tex/.rst/.org/.typ等遗留格式时才需要 Pandocbrew install pandoc或sudo apt install pandoc。2. 选一个 Agent 工具PPT Master 运行在任何有 Agent 能力的工具里要求只有三条能读写文件、能执行命令、能维持多轮对话。README 用一句话降低了理解门槛这些工具在本项目中只扮演一个角色——一个能读写文件的 AI 聊天窗口你只会用到它的聊天面板无需编程。类型示例备注IDE 内置 AgentVS Code 系Cursor、Trae、Windsurf 等、Zed 等编辑器自带 AgentIDE 插件 / 扩展Claude CodeVS Code / JetBrains 扩展、GitHub Copilot、Cline 等装在 VS Code / JetBrains 等宿主内CLI AgentClaude Code CLI、Codex CLI、Gemini CLI 等跑在终端适合脚本化 / 远程 / 服务器场景作者自己的选择是Claude Code——本项目开发中测试最充分的环境。模型推荐同上Kimi K3或 Claude驱动 gpt-image-2/gemini-3.1-flash-image图像生成。3. 安装三种方式及其差异方式 A — Git clone推荐可随时pull最新版git clone https://gitcode.com/GitHub_Trending/ppt/ppt-master.git cd ppt-master pip install -r requirements.txt方式 B — 下载 ZIP无需 Git适合快速试用从仓库页面 Code → Download ZIP 下载解压后同样执行pip install -r requirements.txt。ZIP 没有 Git 历史不能git pull若完整仓库下载过大或失败可从 Releases 页面拿ppt-master-skill-*.zip约 56 MB功能完整但不含捆绑的示例 deck。方式 C — Skill 市场仓库自带 .claude-plugin/marketplace.json可经 Claude Code 插件市场生态安装# 跨 Agent 的 CLIClaude Code、Cursor、Codex 等 npx skills add hugohe3/ppt-master # 或在 Claude Code 内部 /plugin marketplace add hugohe3/ppt-master /plugin install ppt-masterppt-master注意方式 C 只拉取 skill 文件而非整个仓库安装后仍需在安装位置执行pip install -r requirements.txt后处理脚本才能运行。后续更新# Git clone 安装一条命令拉最新版并在 requirements.txt 变化时同步 Python 依赖 python3 skills/ppt-master/scripts/update_repo.pyZIP 安装则需下载新 ZIP 解压到目录、把旧的.env与projects/复制过去再pip install -r requirements.txt。从 requirements.txt 头部注释看update_repo.py会对该文件及其递归-r引用树做指纹比对来决定是否重装依赖。4. 创建整个交互发生在聊天框里首先在 Agent 中打开ppt-master目录IDE 类工具用 File → Open FolderCLI Agent 先cd ppt-master再启动之后一切都在聊天里进行。提供源素材推荐把 PDF、DOCX、图片等放入projects/目录然后在聊天中指明用哪个文件——最省事的方式是在文件管理器或 IDE 侧边栏右键 →复制路径直接粘贴进聊天You: Please create a PPT from projects/q3-report/sources/report.pdf直接粘贴文本也可以You: Please turn the following into a PPT: [粘贴你的内容...]默认流程会先确认设计规范除非你明确要求快速生成AI: Sure. Lets confirm the design spec: [Template] B) Free design [Format] PPT 16:9 [Pages] 8-10 pages ...之后内容由 AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。快速生成模式跳过确认但保留全部表现力明确说出快速生成即可跳过确认回合You: Quickly generate a 5-page deck from projects/q3-report/sources/report.pdf — no need to confirm with meREADME 对 Quick 模式的契约表述非常精确值得逐条拆解你明确说出的都会照做你没有指定的Agent 直接自行决定而不是回头来问。它跳过的是交互与持久化规划Strategist 记录、design_spec.md、spec_lock.md、finalize_svg.py、svg_final/预览而不是表现力——源文档转换、事实缺口检索、共享视觉基线、图片/图标/原生形状/图表/表格/原生公式照常按需使用。代价是单程、不可恢复——上下文丢失后不能续跑。完整说明见 Quick mode 与 quick-generate profile。输出与导出契约一个转换器多个变体README 用一整段说明了导出契约这是理解产物文件命名和差异的关键唯一的 PPTX 转换器读取svg_output/把可直接编辑的原生 DrawingML deck 写到exports/name_timestamp.pptx。默认 Generate 流程会先跑finalize_svg.py产出svg_final/自包含预览PowerPoint 手动的Convert to Shape命令不在支持契约之内。图表 / 表格默认形态默认导出为独立可编辑的 SVG 派生 DrawingML 形状优先保证跨应用视觉一致性。传--native-charts-and-tables则把符合条件的组替换为带数据支撑的 PowerPoint 原生 Chart/Table 对象提供 Edit Data 与对象级控制但跨应用渲染可能不一致该变体另存为exports/name_timestamp_native_charts_tables.pptx。两者的区别是PowerPoint 对象模型而非可编辑性——两种形态都完全可编辑。普通导出能力按需可用原生图表/表格替换、备注、动效、旁白、诊断其中备注、自定义对象动画、旁白默认关闭Agent 会在请求或 deck 有需要时启用。默认路径的 Quick 导出会写标准 postflight 报告并把svg_output/快照到backup/timestamp/svg_output/成功拷贝后可不重跑 LLM 直接重导。已有.pptx想复用把该 deck 加素材交给 AI要求用新内容填充这份 deck——它会填充文本、表格与图表数据只导出你挑选的页并保持原生可编辑见 FAQ 与 template-fill 工作流。出问题了若 AI 丢失上下文让它重读 SKILL.md其余情况查 FAQ——它覆盖模型选择、布局问题、导出问题且持续从真实用户反馈更新。从源码结构看svg_to_pptx.py在 Technical Design 中被明确赋予了防御性校验编译映射与包、要求当前匹配的最终质量报告、并把报告链接进 postflight的职责validation/目录会落盘workflow.log、svg_quality_report.json与output_stem.report.json三类审计产物为每次导出留下可复查的证据链。图片获取AI 生成与网络检索两条路可混用README 把图片获取Image Acquisition列为独立可选章节同一 deck 内可逐张混用两条路径AAI 生成— 优先使用 Agent 宿主自带的图像工具无需单独的图像 API key或用image_gen.py配合IMAGE_BACKEND与各提供商的*_API_KEY。运行python3 skills/ppt-master/scripts/image_gen.py --list-backends可列出已配置后端README 认为gpt-image-2目前是最优默认。B网络图片搜索—image_search.py零配置可用配置PEXELS_API_KEY/PIXABAY_API_KEY均免费可显著提升质量无 key 时只走 Openverse / Wikimedia Commons——可用但质量参差很多结果是普通用户上传有 key 时默认提供商链自动追加 Pexels / Pixabay对现代商业图库类题材人物、职场、生活方式、插画覆盖显著改善授权自动处理CC0、公共领域、Pexels / Pixabay 免署名许可、CC BY、CC BY-SA 一并考虑Executor 会为需要署名的图片加一行小型内联署名仅当某页完全容不下署名时再用--strict-no-attribution高影响位封面、产品照、人像、品牌场景的推荐顺序用户提供的高清素材 / AI 生成 带 Pexels / Pixabay key 的网络搜索 零配置网络搜索。.env的解析规则README 与 .env.example 一致PPT Master 先读当前进程环境变量然后只读第一个命中的.env多个文件之间不合并查找顺序为当前工作目录的./.envskill 安装目录如~/.agents/skills/ppt-master/.envclone 仓库根目录的.env~/.ppt-master/.env用户级配置clone 安装直接cp .env.example .env即可skill 市场安装建议用持久用户配置mkdir -p ~/.ppt-master cp /path/to/installed/ppt-master/.env.example ~/.ppt-master/.env从 .env.example 可以看到具体配置面IMAGE_BACKENDopenai / gemini / minimax / qwen / zhipu / volcengine 等 对应提供商的*_API_KEY/*_MODEL/*_BASE_URL以及IMAGE_CONCURRENCY--manifest批量模式最大并发默认 3限流自动减半最低 1。示例文件还特别注明IMAGE_API_KEY/IMAGE_MODEL/IMAGE_BASE_URL已不再支持只能使用提供商专属变量。完整参考见 image-generator.mdAI 生成与 image-searcher.md网络搜索。文档地图与常见问题入口README 维护了一张官方文档索引表按先读什么排序文档说明Getting Started三步出第一份 deck模板、实时预览、动画、旁白、声音克隆新用户从这里开始Why PPT Master为什么选它以及它不适合的场景Project Positioning长期定位、产品承诺与能力边界Windows InstallationWindows 分步安装SKILL.md核心工作流与规则强制加载顺序、路由表、全局执行纪律Canvas FormatsPPT 16:9、小红书、微信等 10 画幅格式Scripts Tools全部脚本与命令索引Examples全部示例项目Technical Design架构、设计哲学、为什么是 SVGFAQ模型选择、成本、布局排障、自定义模板完整索引在 docs/README.md。几个 FAQ 中值得提前知道的答案字体尺寸全链路用无单位 px画布就是 1280×720 px导出时自动按pt px × 0.75换算所以 PowerPoint 里出现13.5pt、31.5pt这类非整点是刻意设计正文基线按阅读模式固定取值text20px≈15pt /balanced24px≈18pt /presentation32px≈24ptdeck 风格由两个独立维度决定——Modepyramid/narrative/instructional/showcase/briefing决定怎么论证与Visual styleswiss-minimal/editorial/soft-rounded/dark-tech等决定看起来什么样任意组合。从源码与示例仓库验证能力README 强调下载任意一份.pptx在 PowerPoint 里打开是看它真实能力最快的方式。仓库 examples/ 目录保留了 20 个完整示例项目如 ppt169_attention_is_all_you_need、ppt169_global_ai_capital_2026、ppt169_cangzhuo 等每个示例都遵循统一结构project_name/ ├── design_spec.md # 设计规范人可读 ├── spec_lock.md # 机器可读执行契约 ├── images/ # 图片资产 ├── notes/ # 每页演讲者备注 ├── svg_output/ # 原始 SVG带占位符 ├── svg_final/ # 自包含预览 SVG内联图标与图片 └── exports/ # 最终 PPTX 输出这个结构正好与上文数据流一一对应svg_output/是创作态authoring statesvg_final/、exports/、backup/是派生交付态——Technical Design 特别强调区分二者否则校验、重导出与手工修复都会变得难以推理。示例项目可用本地静态服务直接预览python -m http.server --directory examples/project_name/svg_final 8000examples.json 是在线目录的数据源。最后关于 SKILL.md 的强制加载顺序它规定了 Agent 每次运行的入口纪律先读本文件 → 运行attribution_guard.py完整性闸门非零结果立即停止禁止绕过→ 读 workflows/routing.md →恰好选定一条顶层路线及其 profile → 只加载对应的运行时权威文档。配合全局执行纪律串行执行、⛔ BLOCKING门处必须停下等用户确认、禁止跨阶段合并、禁止投机执行、失败时修复拥有该产物的源工件而不是静默降级这套机制解释了 README 反复强调的工具只拥有工作流、质量上限在模型是如何在工程侧被兜住的。小结PPT Master 把AI 做 PPT从生成好看的静态页面推进到生成 PowerPoint 原生对象模型一条SVG 中间语言 → DrawingML的可审计流水线三条带明确保留契约的 PPTX 路线一份零订阅成本、数据留在本机、可被任何 Agent 工具驱动的技能。上手路径很短——装 Python 3.10、装一个 Agent 工具、pip install -r requirements.txt、把素材丢进projects/然后聊天——但值得花时间精读的三篇文档是 Getting Started、Technical Design 和 FAQ它们分别覆盖了操作、原理与排障的完整知识面。【免费下载链接】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），仅供参考