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://wrouter.ai |
Cherry Studio 會自動追加
/v1，所以 API 地址不要帶/v1字尾。
點 檢查，提示「連線成功」即通。
2. 載入模型列表
進入 WRouter 供應商詳情頁：
- 管理 → 從伺服器獲取 —— 自動拉全部可呼叫模型；或
- 新增 —— 手動輸入模型 ID
推薦開啟常用的，關閉不需要的，避免選擇器太長。
3. 預設模型（可選）
設定 → 預設助手 → 預設模型：選 WRouter 下任一模型，作為新建會話的預設。
驗證
- 主介面左上角選擇 WRouter 下任一模型
- 輸入「你好」傳送，應能收到響應
- 頂部狀態列可看到 token 用量與耗時
推薦模型
| 模型 | 用途 |
|---|---|
claude-sonnet-4-6 | 日常對話主力 |
claude-opus-4-8 | 長文寫作、複雜分析 |
gpt-5.4 | 多模態對話（圖片、PDF） |
gemini-2.5-pro | 超長上下文（1M tokens） |
deepseek-v4-pro | 推理任務 |
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
- 部分國產模型的「圖片生成」需在供應商頁單獨開啟「影像」開關