1. 为什么你做的 PPT 总是差点意思做 PPT 这件事卡住大多数人的从来不是内容本身。你脑子里明明知道要讲什么可一打开空白页面手就停住了。配色选哪个、字号多大、图文怎么排、留白留多少每一个决定都在消耗你的精力。等你好不容易拼出一版发给同事对方一句“感觉有点乱”你又得从头再来。我身边不少开发者朋友都有这个困扰。写代码的时候思路清晰一到做汇报材料就犯怵。不是不会用 PowerPoint而是没有设计感也没有一套稳定的排版逻辑。每次做 PPT 都像重新学一遍做完还不满意。最近 Codex 的 skill 生态里有几个专门解决 PPT 生成问题的技能包被频繁讨论。它们的思路不是让你去学设计而是把“大纲到成稿”的流程交给模型你只需要说清楚要讲什么、给谁看、最后怎么交付。我实测下来从安装到拿到能打开的成品快的三分钟慢的九分钟中间不需要你手动调任何样式。这篇文章会带你走完三个 skill 的完整接入路径Guizang PPT Skill、Frontend Slides 和 PPT Master。每个都会给出可复制的配置片段、Codex 调用示例以及从大纲到成稿的验证动作。你跟着做就能跑通一套可复用的 PPT 生成流程。适合谁看不擅长排版的开发者、需要频繁做汇报的职场人、想把课件做得好看一点的老师以及任何觉得“做 PPT 比写代码还累”的人。在开始之前你需要先有一个能正常调用模型的 Codex 环境。如果你还没配好后面第二节会讲怎么用 TaoToken 把这一步补上。已经能跑 Codex 的可以直接跳到第三节看配置。2. 用 TaoToken 把 Codex 的模型调用准备好Codex 本身是一个客户端工具它需要连接一个能提供模型能力的中转服务才能工作。TaoToken 做的就是这件事它提供一个兼容 OpenAI 接口规范的 API 地址你把自己的 Key 填进 Codex 的配置里Codex 就能正常调用模型来执行 skill。这一步不复杂但有几个细节容易出错。我先把关键信息列出来你照着填就行。官网地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址是https://taotoken.net/api。注意 API 地址后面不要加多余的斜杠也不要带 UTM 参数直接写https://taotoken.net/api就可以。你需要先在 TaoToken 的控制台创建一个 API Key。打开https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsole登录后找到 API Keys 页面点新建复制生成的 Key。这个 Key 只显示一次记得先存到安全的地方。拿到 Key 之后Codex 的配置方式取决于你用的是哪种客户端。如果你用的是 Claude Code 类的工具配置文件通常在~/.claude/settings.json或者项目根目录的.claude/settings.json。如果你用的是 Codex CLI配置在~/.codex/auth.json或者环境变量里。下面给一个通用的 JSON 配置片段你可以直接复制到对应的配置文件里{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514 }如果你用的是 TOML 格式的配置比如某些 Codex 版本支持config.toml写法是这样的[model] base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514模型 ID 这一栏你可以根据自己订阅的套餐来选。TaoToken 支持多个主流模型填的时候注意大小写和版本号要完全一致。如果你不确定该填哪个可以先打开模型对话页面https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chat试一下能正常回复就说明 Key 和模型都没问题。配置写完之后怎么验证在终端里跑一条最简单的请求curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复一个字好}] }如果返回的 JSON 里choices字段有内容说明链路通了。如果返回 401检查 Key 有没有复制完整如果返回local proxy failed检查你的网络环境是否能正常访问taotoken.net如果返回reading choices相关的错误多半是模型 ID 写错了换一个确认可用的模型再试。这一步做完你的 Codex 就有了稳定的模型调用能力。接下来装 skill 的时候Codex 才能正常执行安装指令和生成任务。如果你还没有 API Key可以先到https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keys创建一个整个过程不到一分钟。3. 三个 PPT Skill 的可复制配置与调用示例这一节是全文的核心。我会把三个 skill 的安装指令、配置片段和调用示例都写清楚你复制粘贴就能用。每个 skill 的定位不同我按“适合什么场景”来排你可以根据自己的需求选一个先跑通。3.1 Guizang PPT Skill电子杂志风适合自己讲Guizang PPT Skill 的输出是 HTML打开浏览器就能演示动效自然适合现场分享。它的安装指令很简单把下面这段直接发给 Codex请帮我查找并自动安装 https://github.com/op7418/guizang-ppt-skill.git 这个 Skill。 安装前告诉我会写入哪个目录、需要执行哪些命令 安装完成后请确认这个 Skill 是否已经可以使用。Codex 会先告诉你它准备把文件写到哪个目录通常是~/.codex/skills/下面。确认之后它执行 git clone然后检查 skill 的入口文件是否存在。安装完成后你可以用这条指令验证请列出当前已安装的所有 Skill并告诉我 Guizang PPT Skill 的调用方式。调用的时候你需要给 Codex 一份素材。比如你有一篇 Markdown 格式的大纲直接告诉它使用 Guizang PPT Skill把下面这份大纲生成一份 10 页、16:9、中文的电子杂志风 PPT。 输出 HTML 文件保存到当前目录。 大纲内容 # 普通人使用 Codex 的 10 个场景 ## 1. 整理电脑文件 ...生成过程中Codex 会先解析大纲结构然后逐页套用杂志风的排版规则。你可以在它生成第一页之后先看一眼效果如果标题太挤或者留白不够直接告诉它“标题字号调小两号页边距加大”它会重新生成。最终你会得到一个 HTML 文件双击就能在浏览器里翻页。3.2 Frontend Slides先选风格再生成适合找感觉Frontend Slides 的特点是它会先给你几个风格方向让你选而不是直接套一个固定模板。安装指令请帮我查找并自动安装 https://github.com/zarazhangrui/frontend-slides.git 这个 Skill。 安装前告诉我会写入哪个目录、需要执行哪些命令 安装完成后请确认这个 Skill 是否已经可以使用。安装完成后调用的时候要明确告诉它“先给风格选项”使用 Frontend Slides根据下面这份大纲生成 PPT。 先给我 3 个风格方向每个方向用一句话描述视觉特点我选完再生成。 要求10 页、16:9、中文、输出 HTML 和 PDF。 大纲内容 ...它会返回类似这样的选项Notebook Tabs、Swiss Grid、Soft Glass。你选一个它再开始生成。生成出来的 HTML 里保留了文字编辑能力你可以在网页里直接改字再保存。PDF 是自动导出的方便你发给别人预览。3.3 PPT Master原生 PPTX适合正式交付PPT Master 是三个里面最慢的但它的输出是原生 PPTX文字和图形都是 PowerPoint 对象不是图片。这意味着别人拿到文件后可以继续改。安装指令请帮我查找并自动安装 https://github.com/hugohe3/ppt-master.git 这个 Skill。 安装前告诉我会写入哪个目录、需要执行哪些命令 安装完成后请确认这个 Skill 是否已经可以使用。PPT Master 在生成前会先锁定页数、内容结构、字体、配色、阅读密度和输出方式。你需要给它更详细的指令使用 PPT Master根据下面这份大纲生成一份 10 页的 PPTX。 要求 - 16:9中文 - 字体标题用思源黑体 Bold正文用思源宋体 Regular - 配色深蓝主色浅灰辅助色 - 阅读密度每页不超过 80 字 - 输出原生 PPTX带演讲备注 大纲内容 ...它会在当前目录创建一个项目文件夹里面包含源文件、预览服务和导出脚本。如果实时预览启动失败通常是 Python 环境缺少 Flask补一句pip install flask再重新启动就行。生成完成后你会在输出目录看到.pptx文件用 WPS 或 PowerPoint 打开检查缩略图和备注是否正常。三个 skill 的配置和调用方式都给了你可以先选一个跑通。如果你不确定选哪个我的建议是要自己讲选 Guizang要别人改选 PPT Master想先看风格选 Frontend Slides。4. 从大纲到成稿验证请求与成功结果装好 skill 只是第一步真正要确认的是“它能不能稳定产出可用的文件”。这一节我带你走一遍完整的验证流程从发请求到检查成品每一步都有明确的成功标志。先确认你的 Codex 能正常调用模型。在终端里跑一条最简单的对话请求codex chat 回复环境正常如果返回了“环境正常”四个字说明模型链路没问题。如果报错回到第二节检查base_url和api_key是否写对。接下来验证 skill 是否被正确加载。给 Codex 发一条指令请列出当前可用的 Skill 列表并告诉我每个 Skill 的用途。成功的话你会看到 Guizang PPT Skill、Frontend Slides、PPT Master 都在列表里。如果某个 skill 没出现检查它的目录下是否有skill.json或README.md入口文件。有些 skill 需要重启 Codex 才能被识别。然后跑一次完整的生成请求。以 Guizang 为例准备一份 10 页的大纲保存为outline.md然后执行读取当前目录的 outline.md使用 Guizang PPT Skill 生成 10 页 HTML PPT。 输出文件名demo.html。 生成完成后告诉我文件路径和页数。成功的结果是这样的Codex 先返回它解析到的大纲结构然后逐页生成最后告诉你demo.html已保存到当前目录共 10 页。你打开这个文件用键盘左右键翻页每一页的内容都和大纲对应没有空白页或重复页。如果你用的是 PPT Master验证动作要多一步检查导出的 PPTX 是否包含演讲备注。用 WPS 打开文件点击“备注”视图如果每一页下面都有对应的文字说明生成完整。再检查一下文字是不是可选中、可编辑的如果是图片格式说明导出配置有问题需要回到 skill 的设置里把输出模式改成 Native DrawingML。Frontend Slides 的验证重点是 PDF 导出。生成完成后检查当前目录是否有.pdf文件打开后翻到最后一页确认没有内容被截断。再在手机浏览器里打开 HTML 版本看看窄屏下有没有横向滚动条。如果没有说明响应式布局正常。三个 skill 都跑通一遍之后你会得到三种不同格式的成品HTML、PDF、PPTX。这时候你可以根据实际交付需求来选。自己讲用 HTML发给别人预览用 PDF正式交付用 PPTX。整个流程从发请求到拿到文件快的话三分钟慢的话九分钟中间不需要你手动调样式。5. 常见报错与排查401、local proxy failed、reading choices这一节整理的是我在实测过程中真实遇到的报错以及对应的排查动作。你如果卡在某一步可以先在这里找找有没有相同的错误信息。401 Unauthorized这是最常见的错误意思是你的 API Key 没有被识别。先检查 Key 有没有复制完整前后有没有多余的空格。然后确认你填的base_url是https://taotoken.net/api不是https://taotoken.net/api/v1或者别的变体。如果 Key 确认没问题到控制台看一下这个 Key 是否被禁用或者额度用完了。重新生成一个 Key 再试一次。local proxy failed这个报错通常出现在网络请求发不出去的时候。先确认你的终端能正常访问taotoken.net可以用curl -I https://taotoken.net/api测试一下。如果返回超时检查你的 DNS 设置或者换一个网络环境。如果你在公司内网可能需要配置代理白名单。注意不要使用任何非官方的网络工具直接访问即可。reading choices 相关错误这个报错说明请求发出去了但返回的 JSON 结构不对。最常见的原因是模型 ID 写错了。比如你填了claude-sonnet-4但实际可用的 ID 是claude-sonnet-4-20250514。回到 TaoToken 的模型列表页面复制准确的模型 ID 再填一次。另一个可能是请求体格式不对检查messages字段是不是数组role和content有没有拼错。OAuth 相关报错如果你用的是 Claude Code 类工具可能会遇到 OAuth 认证失败。这时候不要反复重试先检查~/.claude/settings.json里的api_key字段是不是被 OAuth 流程覆盖了。有些版本的 Claude Code 会优先走 OAuth你需要把配置改成显式使用 API Key 的模式。具体做法是在 settings 里加上auth_mode: api_key然后重启工具。skill 安装后不生效把 GitHub 链接发给 Codex 之后它说安装完成了但调用的时候找不到这个 skill。先确认 skill 的目录是不是在 Codex 的搜索路径下通常是~/.codex/skills/。然后检查目录里有没有入口文件比如skill.json、manifest.json或者README.md。有些 skill 需要手动执行一次初始化脚本看看它的 README 里有没有npm install或pip install的步骤。最后重启 Codex让它重新扫描 skill 目录。PPT Master 预览启动失败这个我在实测中也遇到了报错信息是ModuleNotFoundError: No module named flask。解决方法是进入 skill 的目录执行pip install flask然后重新启动预览服务。如果还报别的缺包错误把缺的包名记下来用 pip 补上就行。PPT Master 依赖的 Python 包比较多建议在一个干净的虚拟环境里安装。生成的 PPTX 打开后是图片这说明导出模式没有设成 Native DrawingML。回到 PPT Master 的配置里找到输出相关的设置把export_mode改成native或者drawingml。重新生成一次再用 WPS 打开文字应该就可以选中和编辑了。上面这些报错覆盖了大部分常见情况。如果你遇到的错误不在列表里把完整的报错信息复制给 Codex让它帮你分析。大多数时候错误信息本身就已经说明了问题所在。6. 把流程固定下来下次直接复用三个 skill 跑通之后你可以把常用的调用指令保存成模板。比如我自己的做法是在项目目录下建一个ppt-prompts文件夹里面放三个文件guizang.txt、frontend.txt、ppt-master.txt。每个文件里写清楚对应的调用指令和大纲格式要求。下次要做 PPT直接把大纲内容替换进去复制整段发给 Codex 就行。如果你经常做类似主题的汇报还可以把大纲模板也固定下来。比如“季度总结”用一套结构“项目复盘”用另一套。Codex 拿到结构清晰的大纲生成出来的 PPT 质量会稳定很多。另外如果你需要长期、高频地使用 Codex 来做这类任务可以看一下 Coding Plan 页面https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_plan选一个适合自己使用频率的套餐。模型调用是按量计费的提前规划好额度用起来会更顺手。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc里面写了不同客户端的配置方式和常见问题。如果你在配置过程中遇到不确定的地方可以先翻一下文档大部分问题都有现成的答案。最后说一个我自己的使用习惯每次生成完 PPT我会先翻一遍把明显不对的地方标出来然后一次性告诉 Codex 要改哪里。不要一页一页地改那样反而慢。把修改意见攒在一起发过去它重新生成一版通常两三轮就能定稿。这个流程跑顺之后做 PPT 这件事就不再是负担了。