☰
不会做PPT的有救了!Codex 装上这3个 skill,几分钟搞定一个 PPT!
2026/10/7 15:02:51 网站建设 项目流程

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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=,API 基础地址是https://taotoken.net/api。注意 API 地址后面不要加多余的斜杠,也不要带 UTM 参数,直接写https://taotoken.net/api就可以。

你需要先在 TaoToken 的控制台创建一个 API Key。打开https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console,登录后找到 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_source=taotoken_aicg_blog_end&utm_content=model_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_source=taotoken_aicg_blog_end&utm_content=api_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_source=taotoken_aicg_blog_end&utm_content=coding_plan,选一个适合自己使用频率的套餐。模型调用是按量计费的,提前规划好额度,用起来会更顺手。

接入文档在https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc,里面写了不同客户端的配置方式和常见问题。如果你在配置过程中遇到不确定的地方,可以先翻一下文档,大部分问题都有现成的答案。

最后说一个我自己的使用习惯:每次生成完 PPT,我会先翻一遍,把明显不对的地方标出来,然后一次性告诉 Codex 要改哪里。不要一页一页地改,那样反而慢。把修改意见攒在一起发过去,它重新生成一版,通常两三轮就能定稿。这个流程跑顺之后,做 PPT 这件事就不再是负担了。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询