本文是一份 CherryStudio 桌面 AI 客户端的完整使用指南。文章从 CherryStudio 的核心定位与亮点讲起详细介绍了其下载安装、如何通过星途AI平台低成本接入海内外 大模型 API、配置联网搜索Tavily、构建私有知识库RAG、使用 MCP 工具调用以及多端配置迁移等核心功能。通过本文读者可以一站式掌握这款开源、免费且功能强大的 AI 聚合工具实现高效、低成本、保护隐私的 AI 应用体验。一、CherryStudio 是什么CherryStudio 是一款开源的桌面 AI 客户端支持 Windows、macOS 和 Linux 三大平台。它的核心定位是AI 能力聚合器——不自己做大模型而是把各家大模型统一到一个界面里让你像用聊天软件一样无缝切换不同模型。核心亮点多模型同时对话同一界面切换 DeepSeek、Claude、Gemini 等模型对比回答质量本地隐私保护所有对话记录、配置文件存储在本地不经过第三方服务器RAG 知识库上传文档构建私有知识库AI 回答时自动引用来源MCP 工具调用通过 Model Context Protocol 让 AI 调用外部工具联网搜索增强接入 Tavily 等搜索引擎让 AI 获取实时信息配置一键迁移支持备份恢复多台电脑无缝切换二、下载与安装2.1 下载前往 CherryStudio 官方下载页面https://cherry-ai.com/download根据你的操作系统选择对应版本操作系统文件格式说明Windows.exe支持 x64 架构macOS.dmgIntel 和 Apple Silicon 分别有对应版本Linux.AppImage/.deb支持 Debian 系发行版2.2 安装Windows 下的安装流程非常简单双击下载好的.exe安装包​选择安装模式——建议选「为所有用户安装」​安装路径建议改到非 C 盘避免占用系统盘空间​点击「安装」等待进度条走完即可安装完成后首次启动CherryStudio 会初始化本地数据库和配置文件稍等几秒就能看到主界面。小提示macOS 用户安装后如果提示「无法验证开发者」前往「系统设置 → 隐私与安全性」点击「仍要打开」即可。三、接入海内外模型API4.1 在 CherryStudio 中配置自定义模型第一步打开模型服务设置打开 CherryStudio点击界面左下角的齿轮图标进入设置​在左侧菜单选择【模型服务】点击【添加】按钮​选择「自定义」提供商 兼容 OpenAI 协议使用自定义接入提供商名称自己起就好了​添加好之后那问题来了API地址和API密钥去哪儿获取呢我这儿接入的是星途的api服务操作便捷调用成本仅需几分钱是 CherryStudio 的最佳搭档。​要想在cherry studio上正确使用各类大模型我们需要购买官方平台提供的API或者第三方提供的API大家可以根据自己的需求选择合适的平台。我通过对比价格稳定性速度三方面后我决定选择的第三方星途平台来获取API key。复制链接前往api平台https://xingtu.lk888.ai/优势说明模型超全聚合 500 模型覆盖 DeepSeek、Claude、Gemini、GPT、通义千问、等海内外500主流大模型价格极低调用成本仅需几分钱比官方渠道便宜数倍操作便捷注册即用API Key 一键生成文档完善兼容 OpenAI 协议完全兼容 OpenAI API 格式CherryStudio 可直接接入国内访问稳定服务器部署合理国内访问速度快不需要额外代理4.2 获取 API Key第一步注册账号打开浏览器访问https://xingtu.lk888.ai/点击右上角「注册」按钮使用邮箱或手机号完成注册注册完成后登录进入控制台首页第二步获取 API Key在控制台左侧菜单找到【智能体】--【API开放接口】​点击【管理 API 密钥】按钮新建一个key给密钥起个名字如「CherryStudio」复制生成的 API Key 字符串注意保密不要泄露 星途AI 的新用户通常会有免费额度或体验金注册后可以先免费试用感受一下各模型的效果。第三步配置在自定义提供商配置面板中填入以下信息配置项填写内容提供商名称星途AI自定义随便起API 地址https://api.lk888.aiAPI 密钥粘贴你刚才在管理密钥那儿创建的key提供商类型选择OpenAI兼容模式​第四步添加模型配置完 API 地址和密钥后还需要手动添加你想用的模型在星途AI 控制台智能体的「【API开放文档】页面查看所有可用模型复制模型 ID如 claude-opus-4-8、fable5、GPT-5.5 等​回到 CherryStudio在刚才添加的【星途AI】提供商下点击【添加模型】​输入模型 ID必须与星途AI 模型列表中的 ID 完全一致重复添加你需要的多个模型详情内容可以参考技术文档AI Model HubAll-in-one AI platform with 500 models: Sora 2, Veo 3.1, Kling and Grok video generation; GPT-5.5, Claude Opus and Gemini 3 chat; GPT Image 2, Nano Banana and Midjourney image generation; Suno music, TTS voice, AI agents and one unified API.https://xingtu.lk888.ai/apidoc#model/claude-fable-5第五步测试连通性添加完模型后点击「检查」按钮​如果显示绿色对勾说明配置成功​点击右上角的开关按钮将星途AI 服务设为「启用」状态4.3 配置完成就可以开始使用了配置完成后回到 CherryStudio 主界面顶部下拉菜单可以切换所有已添加的星途AI 模型支持同一个对话中随时切换不同模型对比回答效果​ 想了解更多模型详情和价格直接访问星途AI官网查看完整的模型列表和定价说明。五、联网搜索让 AI 实时上网有些大模型自带联网功能比如 GPT-5.5模型名旁边有个小地球图标但部分模型是不带联网能力的。这时候就需要接入外部搜索引擎。​5.1 接入 Tavily 搜索Tavily 是一款专为 AI 设计的搜索引擎返回的结果是结构化数据比传统搜索更适合 AI 消费。​配置步骤前往Tavily 官网使用 Google 账号登录在 Dashboard 中复制你的 API Key回到 CherryStudio → 设置 → 网络搜索搜索服务默认就是 Tavily将 API Key 填入输入框点击保存​额度说明Tavily 免费账户提供 1000 次搜索额度每次搜索消耗 1 次。对于日常使用来说基本够用。5.2 使用联网搜索配置完成后在聊天输入框下方有一个地球图标按钮点击它打开联网开关高亮状态表示已启用。用中文提问「最新的 AI 绘画工具有哪些」AI 会结合实时搜索结果回答每条搜索结果都会以引用编号的形式附在回答末尾方便点击查看原文注意联网搜索会产生额外的 Token 消耗。不过好消息是如果你用的是星途AI 的 API 服务调用成本本来就很低再加上搜索增强整体费用仍然非常可控。六、知识库RAG 实战6.1 RAG 原理简述知识库的核心技术是RAGRetrieval-Augmented Generation检索式增强生成。简单来说它的工作流程是入库阶段上传文档 → 拆分成文本块 → 用嵌入模型将文本块向量化 → 存入向量数据库检索阶段用户提问 → 将问题向量化 → 在向量数据库中匹配最相似的文本块生成阶段将匹配到的文本块作为上下文连同问题一起发给大模型 → AI 基于上下文生成回答​RAG 的三大痛点痛点表现解决方案切片粗暴文本块边界不合理截断语义调整 Chunk Size 和 Overlap 参数检索不精准召回了无关内容接入重排模型Rerank做二次过滤缺乏大局观只能回答片段级问题结合 MCP 工具做全文级查询6.2 配置嵌入模型和重排模型构建知识库前需要先准备好嵌入模型和重排模型。这里同样推荐使用星途AI平台提供的嵌入模型登录 控制台在模型列表中找到带embedding标签的模型推荐BAAI/bge-large-zh-v1.5中文效果好重排模型推荐BAAI/bge-reranker-v2-m3 星途AI 不仅提供对话模型还提供嵌入和重排模型一套 API 搞定 CherryStudio 的全部模型需求非常方便。6.3 创建知识库点击 CherryStudio 左侧边栏的「知识库」图标点击「添加」按钮输入知识库名称如「项目文档」选择嵌入模型和重排模型如果你用的是星途AI 的嵌入模型填入对应的 API 地址和 Key将文档拖入上传区域——支持 PDF、TXT、Markdown、DOCX 等格式上传注意事项文件编码必须是UTF-8使用 GB2312 会导致乱码上传后每个文件会显示蓝色圆点表示正在向量化处理处理时间取决于文档大小和模型的响应速度大文件可能需要几分钟蓝点变绿点表示向量化完成知识库可以使用了6.4 在对话中使用知识库回到聊天界面在输入框下方找到知识库图标点击「添加知识库」选择刚才创建的知识库正常提问即可——AI 会优先从知识库中检索相关内容并在回答中标注引用来源七、MCP 工具调用MCPModel Context Protocol是 Anthropic 提出的开放协议允许大模型通过标准化接口调用外部工具。CherryStudio 内置了 MCP 支持可以让 AI 读取文件系统、查询数据库、调用 API 等。配置概要在设置中找到「MCP 服务器」添加 MCP 服务器配置JSON 格式配置工具权限和访问范围在对话中即可触发工具调用常见的 MCP 用例包括让 AI 读取本地代码仓库、查询数据库表结构、操作浏览器自动化等。MCP 的存在极大扩展了 AI 的能力边界从「只能聊天」变成了「能干活」。八、配置迁移多端同步如果你有多台电脑比如公司台式机 家里笔记本逐个配置模型和知识库非常耗时。好在 CherryStudio 内置了备份恢复功能。8.1 备份打开设置 → 数据设置点击「备份」按钮选择一个文件夹保存备份文件等待备份完成——会生成一个.zip压缩包备份文件包含所有模型服务配置含星途AI 的 API Key、知识库数据、MCP 服务器配置、提示词库、对话历史记录。8.2 恢复在另一台电脑上安装 CherryStudio打开设置 → 数据设置点击「恢复」按钮选择之前备份的.zip文件等待数据恢复——大知识库可能需要较长时间恢复完成后所有配置会完整迁移过来无需重新设置。九、常见问题与排查问题原因解决方案模型列表为空API Key 无效或未启用服务检查星途AI 控制台确认 Key 有效且余额充足对话报错 401API Key 填写错误重新复制星途AI 的 API Key 粘贴知识库文件乱码文件编码不是 UTF-8用编辑器另存为 UTF-8 编码后重新上传联网搜索无结果Tavily 额度用尽登录 Tavily 官网查看 credits 余额向量化速度极慢嵌入模型响应慢换用更轻量的嵌入模型或使用星途AI 的高速版本对话报错 429API 请求频率超限降低请求频率或联系星途AI 升级套餐备份恢复失败zip 文件损坏或版本不兼容确保两端 CherryStudio 版本一致总结CherryStudio 的核心价值在于聚合——把分散的 AI 能力收拢到一个桌面应用里同时保持了本地隐私和多模型灵活性。完整工具链​