PPT Master v4.1.0 是 MIT 许可的演示文稿工作流 skill。它不提供一个封闭的在线“输入主题即下载 PPT”页面，而是让具备读写文件、执行 Shell 命令和持续对话能力的 Agent IDE 或 CLI，在本机读取素材、制定叙事与设计规范、生成 SVG，再导出 PowerPoint 可编辑的 .pptx。这条路线适合重视后续编辑、品牌模板与过程可审计性的团队，但 Agent 权限、模型提供商、素材版权和依赖供应链都需要主动治理。

最终产物与边界

默认导出会把 SVG 页面转换为可编辑的 DrawingML 形状，而不是把整页压成一张位图。文本、形状、连接线和部分视觉元素可以在 PowerPoint 中继续修改。可选的 --native-charts-and-tables 路径会把符合条件的内容替换为带数据的原生图表或表格，换来“编辑数据”等控件，但不同 Office 应用之间的渲染差异可能更大。

“原生可编辑”不等于所有对象都拥有手工制作文件的完整语义。复杂效果可能拆成多个形状；图表默认可编辑形状与原生数据图表是两种对象模型；SmartArt 不是承诺能力；动画、母版、字体替换、跨平台布局仍应在目标 PowerPoint 环境验收。正确预期是获得高完成度初稿和可继续加工的结构，而不是免审的一键终稿。

前置条件

Python 3.10 或更高版本，并能为项目创建隔离环境。
一个具备 Agent 能力的 IDE 或 CLI：必须能读写工作目录、执行命令并完成多轮确认，例如 Claude Code、Cursor、GitHub Copilot/Cline 类插件或其他 agent-capable CLI。
PowerPoint 或兼容查看环境，用于检查字体、图表、动画和最终版式。
经批准的大语言模型提供商；需要生成图片时，再配置独立图像模型或合规图库。
对源 PDF、DOCX、网页、图片、字体、品牌资产和最终分发范围拥有足够权利。
一个不含无关机密的专用工作目录，以及模型费用、日志和输出保存策略。

安装

优先从官方仓库固定到 v4.1.0，并在虚拟环境安装依赖：

git clone --branch v4.1.0 --depth 1 https://github.com/hugohe3/ppt-master.git
cd ppt-master
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Windows 可在 PowerShell 中激活 .venv。跨 Agent 的 npx skills add hugohe3/ppt-master 和 Claude Code 插件市场也是可选安装方式，但它们只安装 skill 文件，后处理脚本的 Python 依赖仍需安装。生产团队不应直接跟随 main：记录 tag/commit，审查 requirements.txt 与安装脚本，保留锁定文件或制品哈希，并在升级前重新跑样例。

权限最小化配置

PPT Master 的能力来自 Agent，而风险也来自 Agent。它需要创建项目目录、读取源文件、执行 Python 脚本并写出 PPTX，因此不应在含有 SSH 密钥、浏览器资料、全盘同步文件或生产凭据的高权限目录运行。把工作区限制在单个项目，API key 放在受控环境变量或密钥管理器中，不写入提示词、Markdown、截图和仓库。

如果 Agent 平台支持命令审批，只允许项目目录内的 Python、依赖安装和明确的转换脚本；拒绝任意提权、读取家目录或向未知域名上传文件。首次运行前阅读 skills/ppt-master/SKILL.md 和将要执行的脚本。生成过程中的“读取文件”和“调用模型”应分别记录，因为本地转换并不代表源材料没有发给选定的模型提供商。

使用步骤

在 projects/<项目名>/sources/ 放入已经确认权利和密级的源文件，只保留本次演示需要的版本。
在 Agent 中明确目标受众、时长、页数、语言、品牌模板、必须引用的数据和禁止外发的素材。
要求 Agent 先展示叙事结构、设计方向、模型/图像提供商和预计调用范围，不确认则不进入生成。
确认设计规范后，让工作流生成项目文件、SVG 页面并运行质量检查；对事实、数字、引用和图片来源逐页审核。
导出 PPTX。需要可编辑数据图表时单独尝试原生图表/表格选项，并与默认形状版对比渲染。
在实际交付所用的 PowerPoint 版本打开，检查缺失字体、溢出、遮挡、母版、演讲者备注、动画和宽高比。
清理不再需要的中间文件、缓存与 API 日志，保留来源清单、版本号和审阅记录。

模型、费用与数据

PPT Master 本身免费且采用 MIT 许可证，真实费用来自驱动工作流的大语言模型、图片生成模型、搜索 API 和本地或云端算力。长文档、反复修改、多页视觉生成都会增加 token、图片和等待成本。开始前设定页数、候选图数量、重试次数与预算上限；先用三页样稿验证模型，再运行整套演示。

项目在本机处理文件，但 Agent 所选模型可能接收源文档摘录、设计规范、提示词或图片。不同官方 API、企业租户、第三方中转和网页服务在日志保留、训练使用、数据地域与删除能力上不同。不要因为工作流“本地运行”就宣称数据完全不离机。涉密或个人数据应使用经过批准的提供商与租户配置；无法确认数据处理条款时，先脱敏或改用允许的本地模型。

来源权利与图片治理

能读取网页不代表能把网页图片放进商业演示。用户需要确认源文档、照片、图标、图表、字体、商标和模板的复制、改编与展示权。PPT Master 的图片搜索可使用不同来源并处理部分署名信息，但自动署名不能替代许可证核验，也不能解决人物肖像、品牌或地域性限制。

AI 生成图片同样不是“无版权区”。记录提供商、模型、提示词和生成日期，检查服务条款、相似性、人物与商标风险。对财报、医学、法律和科研演示，模型生成图不能冒充真实证据。最终文件应保留引用页或来源备注，且不得删除许可证要求的署名。

供应链与运行风险

仓库、release ZIP、npx 安装器、Python 包和图片/模型 API 都是独立供应链环节；固定 v4.1.0、核对官方仓库和发布哈希。
在虚拟环境安装，审查新增依赖，不以管理员权限运行未知脚本。
Agent 具备 Shell 与文件权限时，提示词注入可能来自网页或文档内容；把源材料当作数据，不允许其中的指令覆盖系统与用户规则。
外部 URL 抓取、图片下载和模型请求会产生出站连接；企业环境应采用域名允许列表和调用日志。
输出可能含错误事实、伪造引用、错配图像或隐藏元数据，必须由内容负责人和设计负责人双重验收。

验收清单

PPT Master 固定为官方 v4.1.0，MIT 许可证和依赖清单已留档。
Python 版本不低于 3.10，运行在隔离环境与专用目录。
Agent 只获得完成任务所需的文件、Shell 和网络权限。
模型与图像提供商、单次预算、数据保留和训练条款已经确认。
所有数字、引用、图片、字体和模板都有可追溯来源与使用权。
默认形状版与原生图表版的对象差异已理解，并在目标 PowerPoint 中逐页检查。
中间文件、密钥、日志和最终 PPTX 按组织的数据策略保存或删除。

什么时候不该用

如果团队无法授予 Agent 本地 Shell/文件权限、不能向任何模型提供材料、没有人负责最终 PowerPoint 审核，或只需要套用固定模板替换几个字段，PPT Master 可能不是最低风险方案。此时应选择权限更窄的桌面模板、企业批准的演示服务或人工制作流程。对愿意管理 Agent 权限和内容来源、又需要真正可继续编辑 PPTX 的团队，PPT Master v4.1.0 则提供了少见的透明工作流与较高的后期可塑性。

用 PPT Master 生成原生可编辑演示文稿