1. 为什么要把 ppt-master 接进智能体以及多工具 Key 分散的真实痛点ppt-master 是一个开源的 PPT 生成技能它能读取你准备好的 Markdown 素材按照指定模板自动排版出一份可用的演示文稿。适合谁用经常要出周报、方案、课程讲义又不想在排版上耗时间的人。它的核心检索词就是「ppt-master 接入智能体」本质是把一个本地 Python 技能挂到 Claude Code 或 WorkBuddy 这类智能体里让模型自己调用它干活。我最早是在 Claude Code 里跑通 ppt-master 的后来想在 WorkBuddy 里也复用同一套能力问题就来了两个智能体各自要配模型通道Key 分散在不同配置文件里改一次要动两三个地方。更麻烦的是ppt-master 生成一份十几页的 PPT 会消耗大量 token如果每个工具都单独接一个通道额度、计费、限流全都不好统一管理。所以这篇的重点不是单纯教你把 skills 文件夹复制过去而是解决「一次配置、多智能体复用同一通道」这件事。我会给出 TaoToken 统一 Key 的 settings.json 和 config.toml 可复制骨架再演示通过 skills 方式调用 ppt-master 生成 PPT 的完整验证动作。你跟着做能在 Claude Code 和 WorkBuddy 之间共用同一个 API 通道不用来回换 Key。先说清楚整体链路下载 ppt-master 源码 → 把 skills 子目录复制到智能体的 skills 路径 → 安装 Python 依赖 → 配置统一 Key 通道 → 用提示词触发技能 → 验证生成的 PPT 文件。每一步我都会给具体命令和路径避免你卡在「复制哪个文件夹」这种细节上。2. TaoToken 前置准备统一 Key 与通道解决多工具分散配置在动手接 ppt-master 之前先把通道这件事理顺。TaoToken 的作用是提供一个统一的 API 入口你只需要申请一个 Key就能在 Claude Code、WorkBuddy 等多个智能体里复用同一条通道。这样做的直接好处是额度集中、计费清晰、换模型时只改一处。你需要先拿到两样东西API Key 和 Base URL。Key 在控制台的 API Keys 页面创建Base URL 固定为https://taotoken.net/api。注意这里不要加任何多余路径后面配置文件里填的就是这个地址。创建 Key 的入口在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite拿到 Key 之后先别急着往智能体里塞。建议你先在模型对话页面做一次最小验证确认这个 Key 能正常返回内容再去配 Claude Code 和 WorkBuddy。验证入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite为什么强调先验证因为后面如果 ppt-master 调用失败你要能快速判断是「Key 通道问题」还是「技能配置问题」。如果 Key 本身就没通排查 skills 路径就是白费功夫。关于模型选择ppt-master 生成 PPT 属于长输出任务对模型的上下文和输出长度有要求。建议选支持长输出的模型具体模型 ID 以你控制台里可用的为准。如果你打算长期跑编码和 Agent 类任务可以考虑 Coding Plan额度更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite这里有个关键点Claude Code 和 WorkBuddy 读取配置的方式不一样。Claude Code 走的是 settings.jsonWorkBuddy 走的是 config.toml。你要做的是把同一个 Base URL 和同一个 Key 分别写进这两个文件而不是给每个工具单独申请 Key。这就是「统一通道」的核心。顺便提醒一句ppt-master 本身是本地技能它不直接联网调模型真正调模型的是智能体本身。所以 Key 配在智能体层ppt-master 只负责读素材、套模板、生成文件。理解这个分层后面排错会轻松很多。3. 可复制配置settings.json 与 config.toml 骨架这一节是全文最需要你动手的部分。我会给出 Claude Code 的 settings.json 和 WorkBuddy 的 config.toml 两个可复制骨架路径和字段都按实际配置来写。你只需要把 Key 替换成自己的即可。先看 Claude Code 的配置。settings.json 一般放在用户目录下的.claude文件夹里。Windows 路径是C:\Users\你的用户名\.claude\settings.jsonmacOS 和 Linux 是~/.claude/settings.json。如果文件不存在就新建一个。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: 你的模型ID } }这里三个字段都要写全Base URL、Key、Model ID。少任何一个Claude Code 都可能报 401 或者找不到模型。注意ANTHROPIC_AUTH_TOKEN填的是你的 TaoToken Key不要填成别的。再看 WorkBuddy 的配置。config.toml 一般放在用户目录下的.workbuddy文件夹里路径是C:\Users\你的用户名\.workbuddy\config.toml或~/.workbuddy/config.toml。[model] base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_id 你的模型ID [agent] skills_dir C:\\Users\\你的用户名\\.workbuddy\\skills同样三件套齐全Base URL、Key、Model ID。skills_dir指向你的技能目录后面复制 ppt-master 就放到这里。配置写完后把两个文件都保存。此时你还没有复制 ppt-master先确认配置文件本身没写错。一个常见错误是 JSON 里多了逗号或者少了引号导致整个文件解析失败。你可以用编辑器自带的 JSON 校验看一眼。如果你用的是 CC Switch 这类配置切换工具逻辑是一样的Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填你要用的模型。三件套缺一不可这是所有智能体接入的通用规则。配置完成后建议先重启一次 Claude Code 和 WorkBuddy让它们重新读取配置文件。有些工具是启动时加载配置不重启不生效。这一步别省。4. 下载 ppt-master 并复制 skills安装依赖配置通道搞定后开始处理 ppt-master 本体。先克隆源码git clone https://gitee.com/zsz083/ppt-master.git如果没装 git直接去仓库页面下载压缩包解压也行。解压后你会看到目录里有一个skills文件夹注意关键点要复制的是 skills 文件夹下的ppt-master子目录不是整个源码文件夹。这是很多人第一次接会踩的坑。Claude Code 的 skills 路径C:\Users\你的用户名\.claude\skillsWorkBuddy 的 skills 路径C:\Users\你的用户名\.workbuddy\skills把ppt-master这个子目录分别复制到上面两个路径下。复制完成后目录结构应该是.claude\skills\ppt-master\...而不是.claude\skills\ppt-master\ppt-master\...。多套一层会导致智能体识别不到技能。复制完进入 ppt-master 目录安装依赖。Python 需要 3.10 及以上版本先确认版本python --version确认没问题后安装依赖cd ppt-master pip install -r requirements.txt国内网络慢的话用加速源pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple依赖装完技能本体就就绪了。如果 WorkBuddy 识别不了新技能在对话框里输入提示词「加载所有技能」它会自动扫描 skills 目录并加载。这个动作我试过确实能解决大部分「技能不出现」的问题。到这里通道配置 技能复制 依赖安装三件事都完成了。接下来进入验证环节。5. 验证请求与成功结果用 skills 调用 ppt-master 生成 PPT验证分两步先确认智能体能调通模型再确认 ppt-master 技能能被触发。第一步在 Claude Code 或 WorkBuddy 里发一句简单的话比如「你好确认一下通道是否正常」。如果模型能正常回复说明 settings.json 或 config.toml 里的三件套配置生效了。如果这里就报错先回到第 3 节检查配置别往下走。第二步导入自定义模板。以 WorkBuddy 为例先准备一份.pptx模板文件页数不要太多放到 WorkBuddy 的工作空间。然后输入提示词/ppt-master 将我空间已经存在的 XX科技_客户发展规划.pptx 导入到 ppt-master 中后续作为模版使用。它会自动调用create-template创建模板生成的文件在C:\Users\你的用户名\.workbuddy\skills\ppt-master\templates\decks第三步用模板生成 PPT。素材尽量准备成 Markdown 格式省 token。提示词/ppt-master 用 XX科技 模版根据 XXX素材帮我做 XXX 的 ppt。模型会自动调用 ppt-master 技能读取素材、套用模板、生成文件。生成成功后你会在工作空间或指定输出目录看到.pptx文件。打开检查一下页数和排版是否符合预期。这里要提醒 token 消耗问题。生成 PPT 属于长输出任务我在 Claude Code 里测试时用免费模型生成了一个 11 页的 PPT前后消耗了相当可观的额度。如果你用的是按量计费的模型建议先拿小素材试跑确认流程通了再上大任务。用免费额度的话一定要打开「额度用完即停」的开关避免产生意外账单。验证成功的标志有三个模型能正常回复、/ppt-master提示词能被识别、输出目录出现.pptx文件。三个都满足说明整条链路通了。6. 本篇常见错排查401、技能不识别、依赖报错这一节按真实报错来对照遇到问题直接对号入座。报错一401 Unauthorized。这是最常见的。原因通常是 Key 填错、Key 过期或者 Base URL 写成了带多余路径的地址。检查 settings.json 里的ANTHROPIC_AUTH_TOKEN和 config.toml 里的api_key是否为你自己的 TaoToken KeyBase URL 是否严格为https://taotoken.net/api。改完重启智能体。报错二local proxy failed 或连接失败。这类报错一般是 Base URL 不可达或网络层问题。先确认地址没写错再确认你的网络能正常访问该地址。如果模型对话页面能正常用但智能体里报这个错多半是配置文件里的地址和实际不一致。报错三reading choices 相关错误。这通常出现在模型返回结构不符合预期时可能是 Model ID 填错或者选了一个不支持当前调用方式的模型。回到配置里核对 Model ID换成控制台里确认可用的模型再试。报错四OAuth 相关提示。如果你之前用过其他登录方式残留的认证信息可能和当前 Key 冲突。清理旧的认证缓存确保走的是 Key 认证而不是 OAuth 流程。报错五WorkBuddy 识别不了新技能。先确认ppt-master目录层级对不对是不是多套了一层。再输入「加载所有技能」触发扫描。还不行就重启 WorkBuddy。报错六pip 安装依赖失败。先确认 Python 版本是 3.10再换清华源重试。如果是某个包编译失败看具体报错缺什么系统依赖按提示补上。报错七生成 PPT 中途中断。多半是 token 额度耗尽或输出长度超限。换支持更长输出的模型或者把素材拆小分批生成。排查顺序建议先验证 Key 通道模型对话页面再验证智能体配置简单对话最后验证技能/ppt-master提示词。逐层排除比一上来就翻 skills 目录高效得多。7. 一次配置多端复用把通道和技能固化成习惯整条链路跑通后你会发现真正省事的地方在于「复用」。同一个 TaoToken Key 写进 Claude Code 的 settings.json 和 WorkBuddy 的 config.toml两个工具共用一条通道额度、计费、模型切换都集中管理。ppt-master 的 skills 目录复制两份但技能本体是同一套源码更新时同步一次即可。如果你后面还要接更多智能体逻辑完全一样Base URL 填https://taotoken.net/apiKey 填同一个Model ID 按需选。三件套配好技能目录指对就能跑。接入文档在这里遇到新工具可以对照看https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后给个实用建议把 settings.json 和 config.toml 里的 Key 单独抽出来管理别硬编码在多个地方。换 Key 时只改一处其余引用同一份。ppt-master 的模板文件也建议统一放一个目录多个智能体共享避免每个工具各存一份导致版本不一致。这样你下次再接入新工具基本就是复制配置 复制技能两步几分钟搞定。