大家好，我是王小二，今天给大家分享如何使用另外一个ppt-master技能讲ppt做成可以修改的ppt

孩子学校要你做「亲子阅读分享」幻灯片，或者领导把一份培训 Word 丢过来让你上台讲——内容有了，一到 PowerPoint 就卡在排版：一页页贴字、调字号、找配图，半天出不来。更烦的是，很多 AI 工具给的是「一页一张大图」，双击进去改不了字，只能重做。

ppt-master 是什么

你在 Cursor、Claude Code 或 Codex 里跟 AI 聊天，它本来就能帮你想文案、改语气。但一到「做 PPT」，常见两种结果：要么只吐一段文字大纲，要么给你一份「看起来能打开、其实每页都是图片」的文件——字改不了，版式动不了。

ppt-master 是 GitHub 上 3 万+ Star 的开源项目（作者 Hugo He），干一件事：把 PDF、Word、Markdown 或你粘贴的文字，做成真正能在 PowerPoint / WPS 里逐元素编辑的 .pptx。

跟普通 AI 做 PPT 不一样的地方：

• • 真 PPT，不是图片：输出的是文本框、形状、图表，点哪改哪
• • 有转场和入场动画：不是静态截图拼起来
• • 能套你自己的模板：公司或活动给了标准 .pptx，可以只换内容、保留版式
• • 演讲备注能变旁白：可选把备注合成音频，PowerPoint 里直接放映
• • 资料不出本地：除了跟 AI 模型对话，流程在你电脑上跑

打个比方：没装之前，AI 像个只会写讲稿的文案；装了 ppt-master 之后，旁边多了个会做 PowerPoint 的搭档——你说「用这份 PDF 做 8 页分享稿」，它出的是能直接发微信、能上台投影的真文件。

开源地址：github.com/hugohe3/ppt-master · 中文说明：README_CN.md

ppt-master 能解决什么问题

• • AI 只会写大纲，给不出能改的 PPT：你要的是 .pptx，不是 bullet 列表，更不是整页大图。
• • 网上 AI PPT 工具改不了字：很多产品一页一张图，打开 PowerPoint 只能看，不能改标题、换配图。
• • 有标准模板不敢乱动：学校、公司给了固定模板，自己改容易把版式弄乱。ppt-master 支持「套模板填内容」。
• • 从零排版太费时间：资料在 Word / PDF 里已经有了，还要一页页复制粘贴、调对齐——交给 AI 按工作流走，你只管最后微调。

如何安装

前置条件

你需要：

1. 1. 电脑上已经装了 Cursor、Claude Code 或 Codex 之一（下文以 Codex 为例，另两个平台把工具名换掉即可）
2. 2. 装了 Python 3.10 或以上（Mac 多半自带；没有就去 python.org 下载，Windows 安装时记得勾选 Add to PATH）
3. 3. 能上网（下载项目、安装依赖、AI 生图时可能需要）

下面这些按需准备，不装也能先跑起来：

ppt-master 工具本身免费开源（MIT 协议）。唯一成本是你用的 AI 模型按量计费——跟 Cursor / Codex 等产品规则一样。

安装步骤

最简单：复制这段话，让 AI 帮你装

在 Cursor / Claude Code / Codex 里粘贴（把「Codex」换成你正在用的工具名）：

帮我安装 ppt-master仓库：https://github.com/hugohe3/ppt-master1. 克隆或下载 ZIP 到 ~/Documents/ppt-master2. 进入目录执行 pip install -r requirements.txt3. 把 ppt-master skill 装到 Codex 全局目录

AI 会帮你下载项目、装 Python 依赖、放好 skill。你等着就行。

手动安装（分两步）

第一步：下载完整项目

不会 Git？打开 github.com/hugohe3/ppt-master → 点 Code → Download ZIP，解压到比如 ~/Documents/ppt-master。

会 Git 的话：

git clone https://github.com/hugohe3/ppt-master.git ~/Documents/ppt-mastercd ~/Documents/ppt-masterpip install -r requirements.txt

第二步：把 skill 装进 AI 工具（三平台对照）

说明：npx skills add 只拉 skill 文件；完整工作流（projects/、exports/、脚本）仍建议保留克隆下来的整个仓库。日常用法：用 Cursor / Codex 打开 ppt-master 文件夹，在对话里让 AI 做 PPT。

skill 装好后，如果脚本路径在全局目录，还需在 skill 所在位置执行一次：

pip install -r requirements.txt

（路径换成你的安装位置，比如 ~/.codex/skills/ppt-master/ 或克隆仓库根目录。）

Windows 用户：PATH、执行策略等容易踩坑，项目有专门指南 → Windows 安装指南

验证安装

看 skill 在不在（把路径换成你的平台）：

# Codexls ~/.codex/skills/ppt-master/SKILL.md# Cursorls ~/.cursor/skills/ppt-master/SKILL.md# Claude Codels ~/.claude/skills/ppt-master/SKILL.md

看已安装列表（-a 换成你的平台）：

npx skills list -a codex | grep ppt-master

跑一句试做 PPT（在对应工具里说，三平台话术一样；需先打开克隆好的 ppt-master 文件夹）：

请根据以下内容做一份 5 页 PPT，16:9，暖色简洁风格：主题：亲子阅读分享会，受众是家长。输出 .pptx 文件。

如果 AI 先跟你确认「模板、格式、页数」等设计规范，然后开始分析内容、生成文件，说明 ppt-master 生效了。

如何使用

日常用法三个平台一样：把资料放进项目，在对话里说要做 PPT。下文以 Codex 为例；用 Cursor 或 Claude Code 的话，话术不用改，记得用对应工具打开 ppt-master 项目文件夹。

步骤 1：直接对话（日常就这么用）

从文件做 PPT（推荐）

先把 PDF、Word、图片等放进项目里的 projects/ 目录（没有就新建一个子文件夹，比如 projects/我的分享/）。在文件管理器或 IDE 侧边栏右键文件 → 复制路径，粘贴进对话：

请用 projects/我的分享/培训稿.docx 这份文件生成一份 PPT格式 16:9，大约 8–10 页，自由设计风格

直接粘贴文字

请根据以下内容制作成 PPT：[在这里粘贴你的大纲或正文...]格式 16:9，大约 6 页，风格简洁暖色

套现有模板填内容

用 ~/Documents/活动模板.pptx 做模板，内容换成「社区读书日活动总结」，保留原有配色和版式，输出可编辑的 .pptx

AI 一般会先确认设计规范（模板、比例、页数等），再自动走内容分析 → 排版 → 导出。成品在项目的 exports/ 目录，文件名带时间戳，双击就能用 PowerPoint 或 WPS 打开。

三平台触发方式对照：

实战例子 1：从 Word 做培训分享 PPT

最常见：资料在 Word 里写好了，缺的是能直接上台的幻灯片。

第一步：放文件

把 培训稿.docx 复制到 ~/Documents/ppt-master/projects/亲子阅读/

第二步：复制这段话发给 Codex

请用 projects/亲子阅读/培训稿.docx 生成一份 PPT主题：亲子阅读分享会受众：家长，风格暖色、简洁大约 8 页，16:9

第三步：看结果

AI 会先确认页数、风格，然后生成。完成后到 exports/ 找最新的 .pptx，双击打开——标题、要点都能改，不用从图片里抠字。

实战例子 2：粘贴大纲，快速出稿

临时要个分享稿，大纲在备忘录里，还没整理成 Word。

对话：

请根据以下内容做 6 页 PPT，16:9，商务简洁风：1. 封面：新手怎么写公众号2. 为什么值得写3. 怎么选题4. 标题怎么起5. 正文结构6. 谢谢输出 .pptx

适合内部分享、读书会这类「内容比视觉更重要」的场景。出稿后你可以自己在 PowerPoint 里换字体、加 logo。

实战例子 3：用公司模板换新内容

公司给了标准模板 公司模板.pptx，你只要换文字、保留版式。

对话：

用 ~/Documents/公司模板.pptx 套模板，内容换成「2026 年第一季度工作总结」，保留原有配色、页脚和版式，输出可编辑的 .pptx 到 exports/

比从零排版省事，也不容易把母版弄乱。

步骤 2：进阶用法（可跳过）

下面给想多控制一点的人看。小白日常用不到，直接对话就行。

可选：配图 API（不配也能用）

想要 AI 自动生图，在项目根目录或 ~/.ppt-master/ 放 .env，配置例如 OPENAI_API_KEY 和 IMAGE_BACKEND。不配 Key 时，会用免费图库搜索兜底，质量参差一些，但能用。

手动更新项目（进阶）

cd ~/Documents/ppt-masterpython3 skills/ppt-master/scripts/update_repo.py

其他平台用法（可跳过）

安装、验证、日常对话跟上文三平台对照表一致，下面只列跟 Codex 不一样的地方。

Cursor

• • 打开方式：用 Cursor 打开克隆下来的 ppt-master 文件夹（不是随便一个空目录）
• • 项目里装 skill时，路径是 .agents/skills/ppt-master/（不是 .claude/skills/）
• • 对话安装时把「Codex」改成「Cursor」
• • 其余话术、例子不用改

Claude Code

• • 打开方式：同样打开完整的 ppt-master 项目文件夹
• • 项目里装 skill时，路径是 .claude/skills/ppt-master/
• • 插件市场（进阶）：在 Claude Code 内还可 /plugin marketplace add hugohe3/ppt-master → /plugin install ppt-master@ppt-master
• • 对话用法跟 Codex 完全一样

使用后效果

装之前： 你说「用这份 Word 做 PPT」，AI 往往给你文字大纲，或者一份每页都是大图的「假 PPT」——看起来能放映，改一个字都得重做。

装之后： 把 PDF / Word / 文字丢进去，AI 按工作流生成原生可编辑的 .pptx。标题、 bullet、图表都能点；有模板就套模板；想精修自己在 PowerPoint 里改几笔就能上台。

做完之后，项目文件夹大概长这样：

ppt-master/├── projects/│   └── 我的分享/│       └── 培训稿.docx      ← 你放进去的原材料├── exports/│   └── 分享会_20260324.pptx  ← 生成的成品，直接打开├── backup/                   ← 中间文件备份（可不管）└── skills/ppt-master/        ← 工作流规则

在线示例（感受上限）：hugohe3.github.io/ppt-master — 杂志风、数据新闻风、瑞士网格风等，都是真 .pptx 可下载。

常见问题

我完全不懂编程，能用吗？

能。日常就是：下载项目 → 装 Python 依赖（复制命令粘贴即可）→ 用 Cursor / Codex 打开文件夹 → 复制文章里那些对话。不用自己写代码。

需要学命令吗？

不用。只有装依赖、更新项目时才偶尔复制一条 pip 或 git 命令，AI 也会帮你跑。

必须配 API Key 吗？

做 PPT 本身：不必须。不配 Key 也能生成，配图会走免费图库搜索。

想要更好看的配图：可选配 OpenAI / Gemini 等生图 Key，写在 .env 里。

跟 Anthropic 官方的 pptx skill 有什么区别？

简单记：要「从文档做出好看又能改的真 PPT」→ ppt-master；要「在 AI 里随手操作 pptx 文件」→ Anthropic pptx。

一把就能出完美 PPT 吗？

不能指望一次就完美——作者也说了，这是工具不是许愿池。它帮你干掉大部分枯燥排版，最后微调留给你；模型越好，起点越高。Claude Opus + 生图效果最佳，其他模型也能跑，质量会有差异。

做出来的 PPT 会不会很丑？

项目 GitHub 上有 6 套示例（杂志风、数据仪表盘、孟菲斯波普等），说明上限不低。小白第一次用可能偏简洁，多跑一轮、在 PowerPoint 里改几个字，通常就能上台。

能不能用在别的工具？

能。Cursor、Claude Code、Codex 安装时只差对照表里的 -a 参数。VS Code + Copilot、Cline 等带 agent 能力的工具也能驱动，见项目 README。

要钱吗？

项目 MIT 开源免费。AI 对话和可选生图按你用的模型产品计费。

总结

ppt-master 让 AI 真能帮你做 PowerPoint——丢 Word、PDF 或文字进去，出来的是能在 PowerPoint 里逐页改的真 .pptx，不是改不动的图片。装一次 Python 依赖，打开项目文件夹，以后做分享稿多半一轮对话就够；有模板就套模板，出稿后再自己微调几笔就能讲。