Cherry Studio
Cherry Studio 是一款开源跨平台桌面客户端（macOS / Windows / Linux），主打多模型对话、知识库、智能体。通过 OpenAI 兼容端点接入 wrouter 即可调度全部 wrouter 支持的模型。
前置要求
| 项 | 要求 |
|---|---|
| Cherry Studio | ≥ 1.0.0 |
| wrouter | 一把可用 Token |
安装
从官网下载对应平台安装包：https://cherry-ai.com
配置
1. 添加 wrouter 模型供应商
设置（齿轮）→ 模型服务 → 添加：
| 字段 | 值 |
|---|---|
| 类型 | OpenAI |
| 名称 | wrouter |
| API 密钥 | sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| API 地址 | https://api.wrouter.io |
Cherry Studio 会自动追加
/v1，所以 API 地址不要带/v1后缀。
点 检查，提示「连接成功」即通。
2. 加载模型列表
进入 wrouter 供应商详情页：
- 管理 → 从服务器获取 —— 自动拉全部可调用模型；或
- 添加 —— 手动输入模型 ID
推荐打开常用的，关闭不需要的，避免选择器太长。
3. 默认模型（可选）
设置 → 默认助手 → 默认模型：选 wrouter 下任一模型，作为新建会话的默认。
验证
- 主界面左上角选择 wrouter 下任一模型
- 输入「你好」发送，应能收到响应
- 顶部状态栏可看到 token 用量与耗时
推荐模型
| 模型 | 用途 |
|---|---|
claude-sonnet-4-5 | 日常对话主力 |
claude-opus-4-1 | 长文写作、复杂分析 |
gpt-4o | 多模态对话（图片、PDF） |
gemini-2.5-pro | 超长上下文（1M tokens） |
deepseek-reasoner | 推理任务 |
text-embedding-3-small | 知识库 Embeddings |
tts-1 | 语音合成（朗读响应） |
进阶：知识库与语音
知识库（Embeddings）
设置 → 知识库 → 嵌入模型：
- 推荐
text-embedding-3-small（性价比）或bge-large-zh（中文场景） - 重排序模型 选
bge-reranker-v2-m3（参见 Rerank API）
TTS / STT
设置 → 语音：
- TTS 模型：
tts-1或tts-1-hd - 音色：
alloy/nova/shimmer等 - STT 模型：
whisper-1
故障排查
| 现象 | 处理 |
|---|---|
| 检查报「连接失败 401」 | 核对 API 密钥；末尾不要有空格 |
| 检查报「连接失败 404」 | API 地址带了 /v1，去掉 |
| 模型列表为空 | 点「从服务器获取」重试；或检查 Token 分组权限 |
| 知识库索引失败 | Embeddings 模型未设；或上下文超长，切片更小 |
| TTS 播放无声 | 浏览器自动播放策略限制；点一次界面再试 |
已知限制
- Cherry Studio 的「联网搜索」依赖第三方搜索 API，不通过 wrouter
- 部分国产模型的「图片生成」需在供应商页单独开启「图像」开关