NocoBase 模板打印插件安装指南：商业插件激活、LibreOffice 与 Docker 环境配置
2026/9/18 23:03:10
打开 WorkBuddy，随便点进一个 Skill 的模型设置，你会看到三个输入框：Base URL、API Key、Model。Model 一般有下拉默认值，API Key 你能猜到是粘贴一串字符，唯独 Base URL 这个框最让人犹豫——填官网首页？填带 /v1 的？末尾要不要留斜杠？我第一次配的时候在这上面来回改了三轮，Skill 调用一直返回 404，日志里只有一行看不懂的 not found。后来在 TaoToken 官网 拿到 Key，把 Base URL 统一填成https://taotoken.net/api，十个 Skill 一次性全通了。
这篇就按“装完十个 Skill 之后怎么把模型接上”这个视角写，重点解决三件事：Base URL 这个字段到底代表什么、Key 从哪里取、填完之后怎么用一条命令验证它真的通了。文中出现的所有地址、字段名、配置片段都可以直接复制到本地使用。
1. WorkBuddy 的 Skill 模型设置里，Base URL 到底该填哪一串
1.1 先搞清楚这个字段在链路的哪个位置
WorkBuddy 的 Skill 本质上是一段“任务说明 + 工具调用约定”，它本身不含模型能力。你让 Skill 去整理会议纪要、批量重命名文件、定时抓取某个页面的更新，真正干活的那次推理请求，是被发到某个 HTTP 端点上去的。Base URL 就是这次请求的根地址。
链路可以简化成这样：
WorkBuddy Skill │ 读取 Skill 里的模型设置 ▼ Base URL = https://taotoken.net/api ← 请求根地址 API Key = YOUR_API_KEY ← 身份凭证 Model = 你在控制台里选定的模型名 ← 具体用哪个模型 │ ▼ POST {Base URL}/v1/chat/completions所以这个框里要填的，不是网页地址，不是控制台地址，而是一个能被 HTTP 客户端直接拼接路径的 API 根地址。
1.2 三个字段分别怎么填
| 字段 | 该填什么 | 常见填错 |
|---|---|---|
| Base URL | https://taotoken.net/api | 填成官网首页、填成控制台页面地址、末尾多写一个/、后面又接/v1/chat/completions |
| API Key | 控制台里创建后复制出来的那串字符，形如YOUR_API_KEY | 把账号密码填进去、复制时带了首尾空格、复制了被截断的半截 |
| Model | 控制台模型列表里实际存在的模型名 | 凭印象手写一个不存在的名字 |
关于要不要带/v1，记一条简单的判断原则就够了：Base URL 只填到根，路径由客户端自己拼。也就是说这个框里写https://taotoken.net/api，客户端会在发请求时补上/v1/chat/completions或者/v1/messages这类后缀。你如果在框里提前把/v1写死了，某些客户端再拼一次，就会变成/v1/v1/...，那基本就是 404 的来源。
还有一点容易被忽略：Base URL 里不要带任何跟踪参数。从浏览器地址栏复制链接时，很容易把后面那串?utm_source=...一起粘进去，结果请求变成了一个带查询串的奇怪路径。填的时候只保留https://taotoken.net/api这一段。
1.3 为什么建议十个 Skill 用同一个 Base URL
有人会想，十个 Skill 是不是要配十个不同的端点？不需要。Skill 之间是任务逻辑的差异，模型调用走的是同一套网关。十个 Skill 共用同一个 Base URL 和同一个 Key，带来的好处很实际：
- 排障只需要看一个地方，日志里出现异常不用先判断是哪个 Skill 配错了；
- 额度集中在一个 Key 上，不会出现“A Skill 用光了、B Skill 还剩一半”的尴尬；
- 将来要轮换 Key，只改一处，不用挨个 Skill 翻。
真正需要区分的，是每个 Skill 里的Model字段——摘要类任务用便宜快速的模型，代码生成类任务换更强的模型，这个按需分配就好。
2. 从 TaoToken 拿到 Key：控制台路径与命名习惯
2.1 完整获取路径
获取 Key 的入口在控制台的 API Keys 页面，路径固定：
- 从 TaoToken 官网 进入并登录；
- 进入控制台，找到 API Keys 页面：创建和管理你的 Key；
- 点新建，给这个 Key 起个能一眼认出来的名字，比如
workbuddy-skill-shared； - 复制出来的字符串就是你要填进 WorkBuddy 的那一份。
这一步有两个细节值得单独说。第一，Key 通常只在创建时完整展示一次，页面刷新后就只剩一个掩码。所以复制的动作要当场完成，别先关页面回头再找。第二，如果只是想先看看模型列表、确认自己该选哪个 Model，可以先打开 模型对话页面，在那里试着聊两句，确认某个模型的表现符合预期，再回到 WorkBuddy 里把 Model 字段填成它。
2.2 命名和保存的习惯
十个 Skill 共用一个 Key，命名上建议带上用途和创建时间，例如workbuddy-skill-shared-2024。这样做的好处是将来排查时，你能从日志或者用量记录里一眼看出这个 Key 是给谁用的。
保存方式上，不要在多个地方手抄。本地验证阶段可以放进环境变量：
export TAOTOKEN_BASE_URL="https://taotoken.net/api" export TAOTOKEN_API_KEY="YOUR_API_KEY"写进~/.bashrc或者~/.zshrc之后，新开的终端就自动带上了。注意别把 Key 提交到任何公开的代码仓库里，哪怕只是随手传了个测试文件——这类泄露是最常见的。
3. 十个 Skill 批量配置的顺序：先通一个，再复制九个
3.1 为什么不要十个一起改
如果你把十个 Skill 的模型设置同时改完，然后发现调用失败，这时候你面对的是一个多变量问题：可能是个别 Skill 写错了 Base URL，可能是 Key 有问题，可能是某个 Skill 用的 Model 名字不存在。三种原因混在一起，排查成本会翻好几倍。
正确顺序是：先拿一个最不重要的 Skill 做试点，跑通之后再把配置复制到其余九个。
3.2 试点 Skill 的配置步骤
以“每日自动整理收件箱摘要”这个 Skill 为例：
Step 1 打开该 Skill 的模型设置面板 Step 2 Base URL -> https://taotoken.net/api Step 3 API Key -> YOUR_API_KEY Step 4 Model -> 你控制台里确认过的模型名 Step 5 保存，手动触发一次该 Skill Step 6 看返回结果和日志，确认没有报错第 5 步一定要手动触发，不要等定时任务。手动触发能立刻拿到反馈，省去等待时间。跑通之后，把这个 Skill 的三个字段值记下来，其余九个直接照抄——Base URL 和 Key 完全一致，只有 Model 按任务类型调整。
3.3 如果 Skill 里支持环境变量引用
部分版本的模型设置允许用${VAR}形式引用环境变量。如果 WorkBuddy 的这一版支持，可以把 Key 只写一份，其余 Skill 引用变量名。这样将来轮换 Key，改一个地方就行。不支持的版本，就老老实实逐个粘贴，粘贴时注意别带空格——这是隐蔽性很高的一类错误，肉眼几乎看不出来，但请求一定失败。
4. 跑起来之后：一条 curl 命令和它的日志
4.1 先用 curl 验证 Base URL 和 Key
在把问题归咎于 WorkBuddy 之前，先用 curl 直接打一次接口。这能帮你把“配置问题”和“客户端问题”一刀切开：
export TAOTOKEN_BASE_URL="https://taotoken.net/api" export TAOTOKEN_API_KEY="YOUR_API_KEY" export TAOTOKEN_MODEL="YOUR_MODEL_NAME" curl -sS "$TAOTOKEN_BASE_URL/v1/chat/completions" \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d "{ \"model\": \"$TAOTOKEN_MODEL\", \"messages\": [{\"role\": \"user\", \"content\": \"ping\"}], \"max_tokens\": 16 }"正常返回大致长这样：
{ "id": "chatcmpl-xxxxxxxx", "object": "chat.completion", "created": 1700000000, "model": "your-model-name", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "pong" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } }只要这个 curl 能返回内容，就说明 Base URL 和 Key 都没问题，WorkBuddy 那边再报错就属于客户端配置层面的事。
4.2 Skill 触发后的日志该怎么读
WorkBuddy 触发一次 Skill，日志里通常有几类关键行：
[skill] start task=inbox_digest [http] POST https://taotoken.net/api/v1/chat/completions [http] status=200 latency=1.42s [usage] prompt=830 completion=210 total=1040 [skill] done task=inbox_digest elapsed=1.6s重点看三行：请求的完整 URL 有没有拼错、状态码是不是 200、usage 里有没有正常计数。如果 URL 里出现了两段/v1，回去检查 Base URL 是不是多写了；如果状态码是 401，问题在 Key；如果是 404，问题在路径拼接；如果是 429，说明触发了频率或额度限制。
4.3 常见报错对照表
| 现象 | 大概率原因 | 处理方式 |
|---|---|---|
| 404 not found | Base URL 多写了/v1、或多写了尾斜杠、或混入了查询参数 | 清理成https://taotoken.net/api后重试 |
| 401 unauthorized | Key 复制不完整、含空格、已删除或已失效 | 回到控制台重新创建一个并完整复制 |
| 403 forbidden | Key 权限或所属配置不匹配 | 检查 Key 绑定的范围设置 |
| 429 too many requests | 短时间内请求过于密集，或额度触顶 | 降低并发、错开定时任务时间，或查看额度情况 |
| 请求长时间无响应 | 网络策略限制或目标不可达 | 用同一台机器跑 curl 复现，先确认网络层是否通 |
排查时按“curl 能不能通 → 能通就是客户端配置问题 → 客户端配置里先看 Base URL 再看 Key”这个顺序走，基本不会绕远路。
5. 同一个 Key 给别的工具用：Claude Code、Codex、CC Switch 的写法
十个 Skill 配好之后，很多人会顺手把同一份凭证接到别的开发工具上。这几个客户端的配置文件格式完全不同，千万不要把某一套环境变量名照搬到另一个工具上，这是最容易踩的坑。
5.1 Claude Code：写进 settings.json
Claude Code 认的是ANTHROPIC_*这一组变量，通常写在settings.json的env段里：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_MODEL_NAME" } }要点是ANTHROPIC_BASE_URL同样只填到根，不要在后面手写/v1/messages。更细的字段说明和版本差异，可以对照 Claude Code 文档 来核。
5.2 Codex：写进 config.toml
Codex 用的是 TOML 格式，走的是自定义 provider 的结构：
model = "YOUR_MODEL_NAME" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api/v1" env_key = "TAOTOKEN_API_KEY" wire_api = "chat"这里有两点要强调。第一，Codex 的 provider 配置里，OpenAI 兼容路径的前缀一般要补全，所以base_url写成了带/v1的形式——但这跟 WorkBuddy 里那个 Base URL 框是两回事，别互相套用。第二，不要把ANTHROPIC_*那组变量名填进 Codex 的配置里，Codex 根本不读它们，写进去只会让你以为配好了、实际完全没生效。Key 通过env_key指向的环境变量传入：
export TAOTOKEN_API_KEY="YOUR_API_KEY"5.3 CC Switch：三件套一起切
如果你在用 CC Switch 管理多个供应商配置，它在切换时看的是三件套：基础地址、凭证、模型。把这三项一次性填成同一套值，切换时就不会出现“地址换了、模型名还是旧的”这种半生效状态：
Base URL : https://taotoken.net/api Token : YOUR_API_KEY Model : YOUR_MODEL_NAME三件套要么一起改，要么一起不改。只改其中一项，是这类配置工具最常见的误操作。
6. 十个 Skill 跑稳之后：额度、轮换与日常维护
十个 Skill 一旦跑起来，请求量就不再是零星几次了。按频率分个类会更容易管理：高频短任务（比如每次保存文件都触发一次检查）、中频任务（每小时一次的数据整理）、低频任务（每天一次的汇总）。优先把高频任务的 Model 换成更轻的选择，成本差异会非常明显。
Key 的轮换也有节奏。建议的做法是：新建一个 Key、把 WorkBuddy 和各个客户端的配置切过去、观察一天确认没有异常、再删掉旧 Key。不要反过来先删旧的——那样一旦新 Key 有问题，你的十个 Skill 会同时停摆。
另外，把 Key 的使用情况定期看一眼。哪些 Skill 消耗多、哪些几乎没动静，这些信息只有集中在一个 Key 上才看得清。如果发现某个任务长期用不上但一直在占配置，直接停掉它，比留着更清爽。
如果后续打算把更多任务交给 Coding Plan 统一管理，这里 有对应的方案说明，可以先对比一下自己的调用量再决定。
7. 回头看：那三个输入框其实不难
回到最开始的问题。WorkBuddy 的 Skill 模型设置里，三个框各管一件事：
- Base URL填
https://taotoken.net/api，只到根，不带/v1，不带尾斜杠，不带查询参数； - API Key从 控制台的 API Keys 页面 创建后完整复制；
- Model从控制台确认过的模型列表里选。
配的时候按“curl 先验证 → 单个 Skill 试点 → 复制到其余九个”的顺序来，遇到报错就按 401 / 404 / 429 三类分开处理。同一份 Key 接到别的工具时，注意每个客户端的配置格式各不相同，Claude Code 用ANTHROPIC_*、Codex 用config.toml、CC Switch 用三件套，不要互相照搬变量名。
想先确认模型表现，可以打开 模型对话页面 试两句；想把 Key 管起来，就去 创建并管理 API Keys；需要按调用量做长期规划，可以参考 Coding Plan；如果还要把同一套配置接到 Claude Code，这份文档 里有更细的字段说明。