Cherry Studio 全攻略

一、平台介绍

1. 基本信息

• 名称：Cherry Studio
• 官网：https://cherryai.com.cn/
• 开发团队：CherryHQ 团队
• 开源状态：托管于 GitHub，拥有 3.3w+ 星标
• 开源协议：AGPL-3.0
• 支持系统：Windows / macOS / Linux 全系统客户端

2. 核心定位

Cherry Studio 是一款国产开源的跨平台 AI 桌面客户端，旨在打造一站式聚合全品类大模型的 AI 工作台。

• 多模型接入：支持接入 300+ 海内外大模型 与 50+AI 服务商。
• 数据隐私：所有聊天与文档数据默认本地存储，不上传厂商云端，主打隐私优先。
• 灵活性：支持云端 API 模型与本地离线模型的自由切换。

3. 支持的模型类型

1. 云端 API 模型：支持 GPT 全系列、Claude、Gemini、DeepSeek、Qwen、GLM、Kimi 等。
2. 本地离线模型：对接 Ollama、LM Studio，支持本地跑大模型，零外网调用，数据全私密。

二、核心主要功能

1. 多模型统一调度（王牌功能）

• 一键切换：支持 300+ 大模型一键切换，界面统一。
• 并排对比：支持并排多窗同提问，横向对比不同模型（如 GPT+Claude+ 通义千问）的输出答案。
• 自定义配置：允许自定义新增 AI 服务商，支持录入小众开源模型或私有 API。
• 按需选择：可区分云端付费 API 与本地 Ollama 离线模型，自由切换使用。

2. 300+ 预制专业 AI 助手（开箱即用）

• 全行业预设：内置代码工程师、法律顾问、营养师、论文润色、UI 设计师、Excel 宏专家、翻译官、项目管理等角色。
• 一键对话：无需编写提示词，即可一键添加角色进行对话。
• 自建助手：支持用户自建专属助手，自定义人设、指令与参数。

3. 本地化知识库（高频刚需）

• 多格式支持：支持导入 PDF、Word、Excel、TXT、Markdown、网页链接及本地文件夹。
• 自动处理：自动分片向量化，实现私有文档问答、论文研读、合同解析及企业资料检索。
• 云端备份：支持 WebDAV 云端备份知识库，实现多设备同步文档数据。

4. 生产力工具合集

• 文档处理：支持图片 OCR 解析、HTML 实时预览、Mermaid 甘特图/流程图渲染、Markdown 全格式渲染及代码高亮。
• AI 翻译：支持全局即时翻译，对话框及文档一键多语种互译（支持百种语言）。
• AI 生图：内置文生图模型，支持提示词绘图及尺寸/种子自定义。
• 话题管理：聊天内容按项目/场景分类归档，支持全局关键词检索全历史对话。

5. 扩展能力：MCP 协议 + 迷你插件生态

• MCP 协议兼容：全兼容 Model Context Protocol，对接数据库、本地文件、第三方网页工具及自动化脚本。
• 自动化办公：实现 AI 自动联网、自动化办公任务。
• 自定义插件：支持自定义小程序拓展功能（例如 QuickMemo 记事本插件）。

6. 智能自主 Agent（自动执行任务）

• 自主拆解：给 AI 下达目标指令，Agent 可自主拆解步骤、调用工具。
• 分步执行：支持自动联网查资料、整理文档、生成报表等复杂任务。
• 项目规划：可自动完成项目规划及数据搜集等工作。

三、适用人群

✅ 首选人群

1. 职场办公党：产品、运营、财务、行政等岗位，用于写周报、做方案、表格处理、合同校对及多语种翻译。
2. 程序员/开发者：用于多模型对比代码、BUG 调试、生成脚本、本地 Ollama 私有化部署及 MCP 工具开发。
3. 学生/科研党：用于论文文献研读、PDF 批量解析、开题报告、文献总结及知识点答疑。
4. 设计师/文案：利用 AI 绘图、文案策划、海报文案及排版设计功能。
5. 隐私敏感用户/中小企业：不愿将公司文档、私密聊天上传 AI 厂商云端，需要本地存储数据的用户。
6. AI 爱好者：批量测试各大模型、自建专属知识库、折腾本地开源大模型的用户。

❌ 不太适合

• 重度移动端用户（目前无手机 APP，仅桌面客户端）。
• 只需要单一免费 AI 对话的用户（单平台官网可能更轻量化）。

四、免费&付费详情

1. 软件本体费用

• 社区版：个人自用永久完全免费 + 开源。无功能阉割，核心功能（多模型、知识库、助手、MCP、翻译）永久开放，遵循 AGPL3.0 开源协议，可自行修改源码。
• 商用规则：企业免费商用需遵守 AGPL-3.0 开源协议（修改代码需开源）。
• 企业版：若不想开源，可采购官方企业付费版，享受定制私有化部署、统一后台管理、细粒度权限管控及专属技术售后。

2. 模型调用费用（软件免费≠模型调用免费）

Cherry Studio 仅为客户端软件，本身不收模型服务费，费用由对应大模型厂商收取：

• 免费公益模型：
• 服务商：硅基流动、BigModel 等提供免费额度。
• 模型：如 GLM-4.5-Flash、Qwen3-8B 等。
• 成本：注册即送免费 Token，零成本试用。
• 付费云端 API：
• 模型：GPT、Claude、Gemini 等。
• 方式：需自行去对应官网（OpenAI/Anthropic）开通账号、充值 API Key。
• 计费：按 Token 计费。
• 本地 Ollama 模型：
• 条件：硬件达标（显存≥8G），本地下载模型。
• 成本：完全零费用，离线无限调用。

3. 重要提醒

误区警示：Cherry 软件本身无会员充值，任何第三方售卖"Cherry 会员/破解版”的行为均为骗局，请务必从官网下载。

五、分步使用指南（新手保姆级）

步骤 1：下载安装

1. 打开官网 https://cherryai.com.cn/。
2. 点击首页 Download 下载对应系统安装包（Windows/macOS/Linux）。
3. 执行傻瓜式安装（一路下一步），安装完成后打开软件（当前最新版 v1.9.6）。

步骤 2：配置 AI 模型（三选一方案）

方案 A：零成本免费入门（推荐新手）

1. 点击左下角【设置】→【模型服务】→【添加服务商】。
2. 选择 SiliconFlow(硅基流动) 或 BigModel。
3. 跳转官网注册账号，领取免费 Token 额度，复制 API Key 粘贴进 Cherry。
4. 勾选 GLM 或 Qwen 免费模型，保存即可配置完成。

方案 B：付费云端模型（GPT/Claude）

1. 前往对应厂商官网（OpenAI/Anthropic）注册并充值获取 API Key。
2. 在 Cherry 设置中添加对应服务商，填入 Key，选择需要的模型。

方案 C：本地离线模型（Ollama）

1. 在电脑安装 Ollama 客户端。
2. 通过终端拉取模型（例如：ollama pull qwen:8b）。
3. Cherry 设置添加 Ollama，默认本地地址 127.0.0.1:11434，软件将自动识别本地模型。

步骤 3：使用 AI 助手与对话

1. 点击左侧栏【助手】→【添加助手】。
2. 在助手广场挑选行业预制助手（如代码专家、文案生成）。
3. 顶部下拉选择已配置好的模型，输入提问即可对话。
4. 进阶技巧：新建多个对话窗口，分别绑定不同模型，一键实现同问题多模型作答。

步骤 4：搭建个人知识库

1. 点击左侧【知识库】→新建知识库。
2. 默认嵌入模型无需修改。
3. 点击【添加资源】：上传 PDF、文档或粘贴网页链接。
4. 返回聊天界面，选中助手后绑定对应知识库，提问时 AI 将基于上传文档回答。

步骤 5：联网搜索配置（可选）

1. 进入【设置】→【网络搜索】。
2. 填入 Tavily 免费 API（每月 1000 次免费调用）。
3. 在聊天页开启联网按钮，AI 可实时搜索最新互联网信息。

六、避坑指南（高频踩坑点+解决方案）

1. 模型配置避坑

• ❌ 错误：API Key 粘贴含有多余空格、选错模型名称导致调用报错。
• ✅ 解决：复制 Key 后手动清除首尾空格，模型名称严格和服务商后台保持一致。
• ❌ 错误：国内网络无法直连 OpenAI/Claude 接口。
• ✅ 解决：改用硅基/DeepSeek 国内代理 API，或直接使用本地 Ollama 离线模型。
• ❌ 错误：免费额度用完无法调用模型。
• ✅ 解决：更换其他免费服务商（如 BigModel），或本地部署 Ollama 零成本调用。

2. 知识库使用避坑

• ❌ 错误：文件路径含中文或特殊符号，文档导入失败。
• ✅ 解决：将文件存放路径改为全英文，例如 D:/docs/file.pdf。
• ❌ 错误：单文件超过 200MB 超大 PDF 导入卡死。
• ✅ 解决：拆分 PDF 为多个小文件，分批上传。
• ❌ 错误：AI 回答脱离上传文档乱编（幻觉）。
• ✅ 解决：在对话设置中开启「仅引用知识库内容」开关，缩小检索片段长度。

3. 软件与数据备份避坑

• ❌ 错误：重装系统前未备份数据，聊天记录/知识库丢失。
• ✅ 解决：进入【设置】→【备份】，开启 WebDAV 自动备份，或手动导出软件本地数据文件夹。
• ❌ 错误：被第三方售卖“会员”或“破解版”误导。
• ✅ 解决：坚持从官网下载，无任何付费会员，谨防诈骗。

4. MCP/拓展功能避坑

• ❌ 错误：MCP 服务启动带有 banner 日志，Cherry 解析报错。
• ✅ 解决：在 MCP 服务配置中关闭 banner 打印（例如 spring.main.banner-mode=off）。
• ❌ 错误：端口冲突导致本地 Ollama 连不上。
• ✅ 解决：使用终端查询端口占用，杀掉占用进程后重启 Ollama。

5. 界面优化小坑

• ❌ 错误：默认话题在左侧折叠，频繁切换助手麻烦。
• ✅ 解决：进入【设置】→【显示设置】，将话题位置调整至右侧，左侧显示助手、右侧显示话题，使用体验更顺滑。