← 返回文章列表
统一调用API

Cherry Studio 完全指南:桌面端 300+ 模型统一调用,本地知识库 + MCP 工具链零成本跑通

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)

添加提供商(统一调用核心)

  1. 设置 → 模型服务 → 添加 → 选择 OpenAI / DeepSeek / Groq / OpenRouter
  2. 填入 API Key 与 Base URL(如 DeepSeek https://api.deepseek.com/v1,Ollama http://localhost:11434/v1)
  3. 点击“检查”拉取模型列表,勾选常用模型(如 deepseek-chat、gpt-4o-mini、gemini-2.0-flash)
  4. 顶部模型切换器即可一键切模型,无需改代码。
示例: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,三栏并行返回,可直观对比延迟与质量。

本地知识库

  1. 左侧“知识库”→ 新建 → 拖入 PDF/文档
  2. 对话时 @知识库,Cherry 会先检索再生成,回答附引用片段。
  3. 支持混合检索(向量 + 关键词),适合把免费 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 调用全站模型。

相关文章

Lobe Chat 完全指南:Web 端插件化统一调用,团队知识库与可视化工作流零代码跑通Open WebUI 完全指南:本地 Ollama + 云端免费 API 同池,隐私优先的统一调用Portkey AI Gateway 完全指南:250+ 模型企业级统一调用,缓存 + Guardrails + 可观测一站式LiteLLM Proxy 完全指南:Python 100+ 模型统一网关,OpenAI 兼容 + 智能路由零改动接入NextChat 完全指南:轻量 Web 统一调用,一键切模型 + prompt 市场零门槛上手

想立即用上免费 LLM API?

APIShare 聚合全球免费 AI 接口,注册即送额度。