CherryINWorkBuddy 配置教程
在 WorkBuddy 中通过自定义模型接入 CherryIN，配置接口地址、API Key 和模型能力
接入方式
WorkBuddy 支持在图形界面中添加自定义模型，无需手动编辑配置文件。按照 WorkBuddy 官方模型配置说明，选择 自定义 / Custom 后，可以填写第三方服务的接口地址、API Key 和模型名称。
CherryIN 提供 OpenAI 兼容接口，下面介绍如何将它配置到 WorkBuddy。本文使用 Chat Completions 聊天接口，模型需支持该接口；需要读写文件等操作时，还需支持工具调用。
开始之前
- 从 WorkBuddy 官网 下载或更新客户端，并完成登录。
- 按照 快速上手 创建 CherryIN API Key，确认账户余额和令牌额度可用。
- 在 CherryIN 控制台 确认要使用的完整模型 ID，以及当前令牌是否有权调用它。
配置步骤
打开模型设置
进入 WorkBuddy 的 设置 → 模型，点击 添加模型，在「供应商」下拉菜单的「其他」分组中选择 自定义 / Custom。
不同版本的入口文字可能略有差异。如果没有自定义模型入口，请先升级客户端。
填写 CherryIN 接口信息
| 字段 | 填写内容 |
|---|---|
| 供应商 | 自定义 / Custom |
| 接口地址 | https://open.cherryin.net/v1/chat/completions |
| API Key | 你在 CherryIN 创建的 API Key，只粘贴密钥本身 |
| 模型名称 | 例如 deepseek/deepseek-v4-flash，填写 CherryIN 控制台中的完整模型 ID |
这里使用的是 CherryIN 地址和密钥，不要选择腾讯云 Token Plan、Coding Plan 或其他厂商的预设入口。
接口地址与 Base URL 的区别
WorkBuddy 的「接口地址」可填写完整的聊天接口地址，如上表所示。其他教程中的 https://open.cherryin.net/v1 是基础地址（Base URL）；本教程直接填写完整地址，避免漏掉接口路径。不要重复拼接 /v1 或 /chat/completions。
模型名称要与 CherryIN 一致；如果 ID 包含厂商前缀，请一并保留，不要填写自定义昵称。
按模型能力设置高级选项
展开高级配置，按所选模型实际支持的能力填写：
| 选项 | 配置建议 |
|---|---|
| 工具调用 | 需要让 WorkBuddy 读写文件、执行任务时，选择支持工具调用的模型并勾选 |
| 图片输入 | 只有模型支持图片输入时才勾选；纯文本任务可先关闭 |
| 思考模式 | 按模型及接口支持情况开启，不确定时先关闭并验证普通对话 |
| 自定义协议 | 保持关闭，CherryIN 使用标准 Chat Completions 路径 |
| 输入 / 输出 | 分别对应上下文和输出长度配置；不要超过模型支持的上限，不确定时先保留默认值 |
这些选项用于声明模型能力，勾选它们不会让模型获得原本不支持的功能。字段说明可对照 官方自定义模型配置界面。
以 deepseek/deepseek-v4-flash 为例，开启工具调用，关闭图片输入、思考模式和自定义协议，输入 / 输出保留默认值。
点击 测试连接，连接成功后点击 保存。
开始使用
回到对话界面，在模型选择器的 自定义模型 分组中选中刚添加的模型，即可通过 CherryIN 发送消息。
可以先发送一条简单消息检查连接：
请只回复：CherryIN 连接成功。不要调用工具。收到回复后，再到 CherryIN 控制台查看是否出现对应模型的调用记录，确认请求确实经过 CherryIN。
回复下方会显示当前使用的模型：
需要处理本地文件时，在新建任务中通过 选择工作空间 → 打开本地文件夹 选择文件所在目录。
例如，目录中有以下销售数据：
product,quantity,unit_price
notebook,3,20
pen,5,4可以让 WorkBuddy 读取并汇总：
读取当前工作空间中的 sales.csv，按 quantity × unit_price 计算每项金额及总金额，不要修改原文件。这份数据中，两项金额分别为 60、20，总金额为 80。
处理本地文件需要模型支持工具调用，并允许 WorkBuddy 访问所选目录。
模型与协议怎么选？
- 优先选择当前令牌可用、支持 Chat Completions + 工具调用 的模型，再验证所需的图片或推理能力。
- 不能仅凭「模型已在 CherryIN 上架」就判断它适用于本教程。如果模型要求使用 Responses API，请改用支持该接口的客户端或接入方式，参见 OpenAI 兼容接入指南。
- WorkBuddy 的「自定义协议」开关控制 URL 校验和路径补全，并不等于切换成 Responses 或 Anthropic 协议。不要只把地址改成
/v1/responses或/v1/messages来尝试转换协议。官方说明
常见问题
| 问题 | 排查方法 |
|---|---|
提示 401 Unauthorized | 确认使用 CherryIN 密钥，没有多余空格、换行或手动添加的 Bearer 前缀，且令牌未过期或被禁用 |
提示 404 或接口不存在 | 核对完整地址为 https://open.cherryin.net/v1/chat/completions，没有重复路径，且「自定义协议」保持关闭 |
| 提示模型不存在或无权访问 | 从 CherryIN 复制完整模型 ID，检查令牌分组和模型限制，不要使用 WorkBuddy 内置模型的显示名称 |
提示额度不足或 429 | 检查 CherryIN 账户余额、令牌额度和并发限制；遇到限流时减少并行任务后重试 |
| 任务长时间停在「准备中」 | 停止后新建任务重试，检查客户端网络与工作空间，并通过 CherryIN 调用记录确认请求是否发出 |
| 能聊天，但无法操作文件 | 检查模型是否支持工具调用、是否勾选对应选项，以及 WorkBuddy 是否获得当前目录的访问权限 |
| 保存后仍未使用 CherryIN | 在当前对话中重新选中自定义模型，并通过 CherryIN 调用记录确认，不要仅依靠模型自述判断 |
费用与后续使用
通过此配置发出的模型请求按 CherryIN 的用量规则计费，相关用量在 CherryIN 控制台查看；WorkBuddy 自身的订阅或其他功能费用以其官方说明为准。WorkBuddy 自定义模型费用说明
- 添加其他模型时，重复以上步骤并填写各自的完整模型 ID 和能力配置。
- 需要了解令牌分组：查看 快速上手。
- 需要排查通用接口问题：查看 OpenAI 兼容接入指南。