Cherry Studio 完全指南:桌面端 300+ 模型统一调用,本地知识库 + MCP 工具链零成本跑通
一句话总结:Cherry Studio 是开源的桌面 AI 助手(Electron + 300+ 提供商),把 OpenAI、Claude、Gemini、DeepSeek、Groq、OpenRouter 等收敛为一个界面,支持本地知识库、MCP 工具调用与多模型并发对比,适合把“统一调用”从网关层下沉到桌面端。
为什么选 Cherry Studio?
- 300+ 提供商一键切:内置 OpenAI、Anthropic、Gemini、DeepSeek、Groq、Together、OpenRouter、Ollama 等模板,填 Key 即用,无需手写 base_url。
- 本地知识库 RAG:支持 PDF/Word/Markdown/Excel 导入,向量检索 + 引用溯源,离线可用。
- MCP 工具链:原生支持 Model Context Protocol,文件读写、联网搜索、代码执行可插拔。
- 多模型并发:同一问题可同时发给 3-5 个模型,分栏对比回答质量与速度。
- 完全本地:数据存本地 SQLite,Key 本地加密,不经过第三方中转。
安装与初始化
下载
- 官网:https://cherry-ai.com 或 GitHub
CherryHQ/cherry-studio - 支持 Windows / macOS / Linux(.exe / .dmg / .AppImage)
添加提供商(统一调用核心)
- 设置 → 模型服务 → 添加 → 选择
OpenAI/DeepSeek/Groq/OpenRouter - 填入
API Key与Base URL(如 DeepSeekhttps://api.deepseek.com/v1,Ollamahttp://localhost:11434/v1) - 点击“检查”拉取模型列表,勾选常用模型(如
deepseek-chat、gpt-4o-mini、gemini-2.0-flash) - 顶部模型切换器即可一键切模型,无需改代码。
示例:OpenRouter 统一入口
Type: OpenAI Compatible
Base URL: https://openrouter.ai/api/v1
Key: sk-or-v1-xxx
Models: deepseek/deepseek-r1:free, qwen/qwen3-235b:free, moonshotai/kimi-k2:free
统一调用实战
多模型对比
在对话输入框上方点“多模型”→ 勾选 deepseek-chat + gpt-4o-mini + gemini-2.0-flash → 发送同一 prompt,三栏并行返回,可直观对比延迟与质量。
本地知识库
- 左侧“知识库”→ 新建 → 拖入 PDF/文档
- 对话时 @知识库,Cherry 会先检索再生成,回答附引用片段。
- 支持混合检索(向量 + 关键词),适合把免费 API 的长文档先本地索引再提问。
MCP 扩展
设置 → MCP → 添加服务器(如 filesystem、brave-search、python),对话中模型可自动调用工具完成“搜资料→读文件→写报告”闭环,无需网关层二次开发。
与 OneAPI / LiteLLM 对比
| 方案 | 形态 | 统一层级 | 适合 |
|---|---|---|---|
| Cherry Studio | 桌面客户端 | 客户端聚合 | 个人多模型对话、本地 RAG、离线使用 |
| OneAPI Gateway | 单二进制网关 | 服务端聚合 | 团队自托管、一个 Key 管所有模型、可卖算力 |
| LiteLLM Proxy | Python 代理 | 服务端聚合 | Python 团队需 100+ 模型覆盖 |
| Portkey | 企业网关 | 服务端聚合 + 治理 | 企业级可观测与 Guardrails |
选型:个人日常用 Cherry Studio 最轻;团队共享与计费走 OneAPI/LiteLLM;强治理选 Portkey。
最佳实践
- 免费优先:在 Cherry 中把
OpenRouter :free模型置顶,日常用免费,复杂任务切付费。 - 模型别名:给常用模型改短名(如
r1-free、k2),切换更快。 - 备份配置:设置 → 备份 → 导出
config.json,Key 与知识库一键迁移。 - Ollama 联动:本地跑
ollama run qwen3:8b,Cherry 直连localhost:11434,离线也能用统一界面。
总结
- 想零成本体验多模型:Cherry Studio + OpenRouter :free,一次安装对比 10+ 模型。
- 想本地知识库:拖入文档即 RAG,无需搭向量数据库。
- 想与网关联动:Cherry 的 Base URL 填 OneAPI
http://localhost:3000/v1,桌面端也能走统一网关的mymodel路由。
下一篇:Lobe Chat 完全指南(Web 端插件化统一调用,团队知识库与可视化工作流)。
🚀 立即开始:免费 API 一键调用
想要无需逐一注册、统一鉴权调用以上全部免费模型?Apishare.cc 提供统一 API Key,一个 Key 调用 100+ 模型,免费模型零成本直连。
👉 立即注册 Apishare.cc → 获取你的统一 API Key
📊 想看更多免费模型排行?查看 2026年9月 免费 LLM API 综合实力榜单 →
免费 API 聚合平台说明
本文涉及的模型均由 APIShare 免费 API 聚合平台 统一接入,一份 Key 调用全站模型。
- 完整模型目录:APIShare 免费 API 目录
- 注册即送免费额度:注册领取 API Key