1.1 什么是 CherryStudio？#

CherryStudio 是一款由国内开发者开源的跨平台、完全免费的 AI 桌面客户端，核心定位是「一站式 AI 办公自动化中枢」。它打破了传统 AI 工具「多模型来回切换、工具调用门槛高」的痛点，让你在一个软件中就能使用全球主流的 AI 大模型。

官方开源仓库：https://github.com/CherryHQ/cherry-studio 官方下载地址：https://cherry-ai.com/

1.2 核心优势#

1.3 主要功能一览#

CherryStudio 提供了以下核心功能模块：

🤖 多样化 LLM 服务支持

• ☁️ 支持主流 LLM 云服务：OpenAI、Gemini、Anthropic、硅基流动、DeepSeek 等
• 🔗 集成流行 AI Web 服务：Claude、Perplexity、Poe、腾讯元宝、知乎直答等
• 💻 支持 Ollama、LM Studio 本地模型部署

💬 智能助手与对话

• 📚 内置 300+ 预配置 AI 助手
• 🤖 支持自定义创建专属助手
• 💬 多模型同时对话，获得多样化观点

📄 文档与数据处理

• 📄 支持文本、图片、Office、PDF 等多种格式
• ☁️ WebDAV 文件管理与数据备份
• 📊 Mermaid 图表可视化
• 💻 代码高亮显示

🔧 实用工具集成

• 🔍 全局搜索功能
• 📝 话题管理系统
• 🔤 AI 驱动的翻译功能
• 🎯 拖拽排序
• 🔌 小程序支持
• ⚙️ MCP（模型上下文协议）服务

2.1 系统要求#

> 💡 提示：如果需要使用本地开源大模型（如 Ollama），需配备 NVIDIA RTX 3060 及以上显卡（12GB+ 显存），或 Apple Silicon M 系列芯片。

2.2 下载方式#

方式一：官方网站下载（推荐）

1. 打开浏览器，访问 CherryStudio 官网：https://cherry-ai.com/
2. 点击页面上的「下载」按钮
3. 根据你的操作系统选择对应版本

方式二：GitHub 下载

1. 访问 GitHub 仓库：https://github.com/CherryHQ/cherry-studio/releases
2. 找到最新版本（Latest Release）
3. 在 Assets 中下载对应系统的安装包

2.3 Windows 安装步骤#

1. 下载安装包：选择 CherryStudio-Setup-x.x.x.exe 安装包
   • 也可以选择便携版 CherryStudio-win-x64-x.x.x.zip，解压即用，无需安装
2. 运行安装程序：双击 .exe 文件
3. 安装向导：按照提示点击「下一步」，使用默认安装路径即可
4. 完成安装：桌面会自动生成 CherryStudio 快捷方式

> ⚠️ Windows Defender 提示：如果系统提示「有风险」，点击「更多信息」→「仍要运行」即可。CherryStudio 是完全开源的程序，属于正常误报。

2.4 macOS 安装步骤#

1. 下载安装包：
   • Intel 芯片 Mac：下载 CherryStudio-x.x.x.dmg
   • Apple Silicon（M1/M2/M3/M4）：下载 CherryStudio-arm64-x.x.x.dmg
2. 安装：双击打开 .dmg 文件，将 CherryStudio 图标拖拽到「应用程序」文件夹
3. 启动：在启动台中找到 CherryStudio，点击启动

> ⚠️ macOS 安全提示：如果提示「无法打开，因为开发者无法验证」，打开「系统设置」→「隐私与安全性」→ 找到被阻止的 CherryStudio → 点击「仍要打开」→ 输入密码确认。

2.5 Linux 安装步骤#

Debian/Ubuntu 系统：

1
cd ~/Downloads
2
sudo dpkg -i CherryStudio_x.x.x_amd64.deb
3
sudo apt install -f  # 修复依赖

AppImage 通用版：

1
chmod +x CherryStudio-x.x.x.AppImage
2
./CherryStudio-x.x.x.AppImage

3.1 首次启动#

1. 双击桌面 CherryStudio 图标启动软件
2. 首次启动会进入初始化引导界面
3. 选择界面语言（推荐选择「简体中文」）
4. 完成基础设置后进入主界面

3.2 界面五大核心区域#

CherryStudio 的主界面分为以下五大区域，逻辑清晰，零基础也能快速上手：

3.3 左侧导航栏功能说明#

从上到下，左侧导航栏包含以下功能模块：

3.4 新手快速上手建议#

首次使用 CherryStudio，建议按以下顺序操作：

1. 第一步：点击左下角「设置」→ 配置模型服务（详见第四章）
2. 第二步：回到会话界面，选择一个已配置的模型
3. 第三步：在输入框中输入你的问题，按回车发送
4. 第四步：尝试上传文件、切换助手、调整参数等操作

4.1 什么是模型服务商？#

简单来说，模型服务商就是提供 AI 大脑的「供应商」。就像你可以选择中国移动或中国联通的手机服务一样，你可以选择不同的 AI 模型来为你服务。常见的模型服务商包括：

4.2 获取 API Key#

> 💡 什么是 API Key？ API Key 就像是一把「钥匙」，用来证明你有权使用某个 AI 模型服务。你需要到对应服务商的官网注册账号并获取这把钥匙。

4.3 在 CherryStudio 中添加模型#

1. 点击左侧导航栏的 「模型」 图标，进入模型管理界面
2. 点击右上角的 「添加模型」 按钮
3. 在厂商列表中选择你的模型服务商（如 DeepSeek、豆包等）
4. 在 「API Key」 输入框中粘贴你获取的密钥
5. 点击 「获取模型列表」 按钮
6. 在弹出的模型列表中，勾选你想使用的模型
7. 点击 「确认添加」
8. 添加完成后，在模型列表中点击 「启用」 开关

4.4 各大模型配置要点#

4.5 本地模型配置（Ollama）#

如果你想完全离线使用 AI，不依赖任何网络服务，可以配置本地模型：

第一步：安装 Ollama

1. 访问 https://ollama.com/ 下载对应系统的安装包
2. 一键完成安装
3. 打开终端/命令提示符，输入 ollama -v，输出版本号即安装成功

第二步：下载模型

1
# 推荐新手使用的模型
2
ollama pull qwen2.5:7b        # 通义千问2.5，中文能力强，8GB显存可运行
3
ollama pull deepseek-r1:7b    # DeepSeek推理模型，8GB显存可运行
4
ollama pull llama3.1:8b       # Llama 3.1，通用能力均衡

第三步：在 CherryStudio 中接入

1. 进入「模型」→「添加模型」
2. 厂商选择「Ollama」
3. 基础地址保持默认 http://127.0.0.1:11434
4. 点击「获取模型列表」→ 勾选已下载的模型 →「确认添加」→「启用」

> 💡 本地模型优势：完全离线使用、数据 100% 本地、无使用次数限制、无 API 费用。

4.6 模型参数详解#

在对话界面的右侧参数设置区，你可以调整以下关键参数：

5.1 创建第一个对话#

1. 在左侧导航栏点击 「会话」 图标
2. 点击左上角的 「新建话题」 按钮（或使用快捷键 Ctrl + N）
3. 在右侧模型选择器中选择你已配置的模型
4. 在底部输入框中输入你的问题
5. 按 Enter 键发送（或点击发送按钮）

🎉 恭喜！你已经完成了第一次 AI 对话！

5.2 对话框按钮详解#

在输入框上方有一排功能按钮，每个按钮都有特定用途：

5.3 对话中的实用操作#

5.4 多模型同时对话#

CherryStudio 的一大亮点功能是多模型同时对话——同一个问题，同时让多个 AI 模型回答，方便你对比不同模型的表现：

1. 在对话界面顶部，点击模型选择器
2. 按住 Ctrl（Mac 为 Cmd）键，同时选择多个模型
3. 输入你的问题并发送
4. 多个模型的回复会同时显示，方便对比

5.5 文件上传与解析#

CherryStudio 支持上传多种格式的文件，AI 会自动解析文件内容：

使用方法：

• 方式一：点击输入框上方的 📎 按钮，选择文件上传
• 方式二：直接将文件从文件管理器拖拽到输入框中

5.6 对话设置详解#

点击对话界面右上角的设置图标，可以调整对话相关设置：

5.7 Token 预估显示#

在输入框下方，CherryStudio 会显示 Token 预估信息，格式为：

1
当前上下文数 / 最大上下文数 | 输入字数 | 预估 Token 数

• 当前上下文数：当前对话已消耗的 Token 数量
• 最大上下文数：模型支持的最大上下文长度（∞ 表示无限）
• 输入框字数：当前输入框中的字符数
• 预估 Token 数：发送后预计消耗的 Token 数

> 💡 注意：这只是预估值，实际 Token 消耗以模型服务商的数据为准。

6.1 什么是助手？#

助手（Assistant） 是对所选模型做个性化设定后使用的「定制版 AI」。通过设置不同的提示词和参数，你可以让同一个模型变成不同领域的专家。

打个比方：模型就像一个「通才」，而助手就是给这个通才穿上不同的「职业装」——穿上程序员装就是编程助手，穿上翻译装就是翻译助手。

6.2 助手与话题的关系#

• 助手是「父级」，一个助手下面可以有多个话题（即多个对话）
• 所有话题共用该助手的参数设置和提示词
• 你可以为不同的工作场景创建不同的助手

1
📁 写作助手
2
  ├── 📄 话题1：写一篇产品介绍
3
  ├── 📄 话题2：修改一封邮件
4
  └── 📄 话题3：写周报
5
📁 编程助手
6
  ├── 📄 话题1：Python 爬虫代码
7
  └── 📄 话题2：修复 Bug

6.3 使用预设助手#

CherryStudio 内置了 300+ 预配置助手，涵盖各种场景：

1. 点击左侧导航栏的 「智能体」 图标
2. 浏览助手分类（写作、编程、翻译、学习、营销等）
3. 找到需要的助手，点击 「添加」 或 「使用」
4. 助手会自动出现在左侧会话列表中

常用预设助手推荐：

6.4 创建自定义助手#

如果你有特定需求，可以创建自己的专属助手：

1. 在左侧会话列表中，右键点击空白处
2. 选择 「新建助手」
3. 在弹出的编辑面板中配置以下内容：

1
你是一个专业的 [角色]，擅长 [技能]。
2

3
你的工作规则：
4
1. [规则1]
5
2. [规则2]
6
3. [规则3]
7

8
回答风格：[正式/轻松/幽默等]
9
语言：[中文/英文等]

1
你是一位资深的全栈开发工程师，拥有 10 年以上的代码审查经验。
2

3
你的任务是审查用户提供的代码，并给出以下反馈：
4
1. 代码质量评分（1-10分）
5
2. 发现的 Bug 和潜在问题
6
3. 性能优化建议
7
4. 代码风格和最佳实践建议
8
5. 改进后的代码示例
9

10
请用清晰的结构化格式输出，使用中文回答。

6.5 管理助手#

编辑助手：右键点击助手名称 →「编辑助手」

复制助手：右键点击助手名称 →「复制」，快速创建相似配置的新助手

删除助手：右键点击助手名称 →「删除」

导出/导入助手：可以将助手配置导出为 JSON 文件，分享给其他人使用

7.1 什么是知识库？#

知识库是 CherryStudio 的一个强大功能，它允许你上传自己的文档（PDF、Word、Excel 等），AI 会自动对这些文档建立索引。之后在对话中，AI 就能基于你的文档内容来回答问题。

通俗理解：就像给 AI 喂了一堆参考书，之后它就能根据这些书来回答你的问题。

7.2 知识库的适用场景#

7.3 创建知识库#

1. 点击左侧导航栏的 「知识库」 图标
2. 点击 「创建知识库」 按钮
3. 输入知识库名称（如「公司文档库」）
4. 选择嵌入模型（推荐使用默认的 BAAI/bge-m3）
5. 点击 「创建」

7.4 上传文档#

1. 进入已创建的知识库
2. 点击 「添加文件」 或直接拖拽文件到上传区域
3. 支持的文件格式：
   • 📄 PDF 文档
   • 📝 Word 文档（.docx）
   • 📊 Excel 表格（.xlsx）
   • 📃 纯文本（.txt、.md）
   • 🌐 网页内容（通过 URL 导入）
4. 上传后，系统会自动对文档进行分段处理和向量化索引
5. 索引构建完成后（可能需要几分钟），你会收到通知

7.5 在对话中使用知识库#

1. 在对话界面，点击输入框上方的 📚 知识库 按钮
2. 选择你想使用的知识库
3. 输入你的问题，AI 会自动在知识库中搜索相关内容并基于文档回答

> 💡 提示：开启知识库后，AI 的回答会标注信息来源（来自哪个文档的哪部分），方便你核实。

7.6 知识库管理#

• 添加/删除文件：随时向知识库中添加新文件或移除旧文件
• 重建索引：当文档内容更新后，需要重新构建索引
• 设置分段规则：可以自定义文档分段的长度和重叠量，影响检索精度

8.1 什么是 MCP？#

MCP（Model Context Protocol，模型上下文协议） 是一种让 AI 模型能够调用外部工具的标准协议。简单来说，MCP 就像 AI 的「手和脚」，让 AI 不只能”说话”，还能”做事”。

通俗理解：没有 MCP 的 AI 只能给你建议（比如”你可以这样整理文件”），有了 MCP 的 AI 可以直接帮你操作（比如直接帮你整理文件）。

8.2 MCP 工具市场#

CherryStudio 内置了 MCP 工具市场，提供了大量预配置好的工具，一键安装即可使用：

1. 点击左侧导航栏的 「工具」 图标
2. 界面分为两大板块：
   • 内置工具市场：预配置好的工具，一键安装
   • 我的工具：已安装的工具列表
3. 找到需要的工具，点击 「安装」
4. 安装完成后，在「我的工具」中点击 「启用」 开关

8.3 办公高频必备工具推荐#

8.4 使用 MCP 工具#

安装并启用工具后，在对话中使用：

1. 在对话界面右侧参数区，开启 「工具调用」 开关
2. 勾选你想要使用的工具
3. 用自然语言告诉 AI 你想做什么，AI 会自动判断是否需要调用工具

使用示例：

1
「帮我读取桌面上的销售数据.xlsx，统计每个月的总销售额，生成一个排名表」

AI 会自动调用 Excel 工具读取文件、分析数据、生成结果。

8.5 添加自定义 MCP 服务#

如果内置市场没有你需要的工具，可以添加自定义 MCP 服务：

1. 在「工具」页面，点击 「添加自定义服务」
2. 填写以下信息：
   • 服务名称：自定义名称
   • 启动命令：MCP 服务器的启动命令（如 npx、python 等）
   • 传输协议：选择 stdio 或 sse
   • 参数：根据 MCP 服务器的要求填写
3. 点击 「保存」

> ⚠️ 安全提醒：启用文件系统、系统命令等高权限工具时，建议先在测试环境中验证，避免 AI 误操作导致数据丢失。

9.1 什么是绘图功能？#

CherryStudio 内置了 AI 图片生成功能，你只需要用文字描述你想要的图片，AI 就能自动生成对应的图片。

9.2 使用方法#

方式一：在对话中生成图片

1. 确保你选择的模型支持图片生成
2. 在对话输入框中，点击 🎨 生成图片 按钮
3. 输入图片描述（Prompt）
4. 等待 AI 生成图片

方式二：使用专门的绘图页面

1. 点击左侧导航栏的 「绘图」 图标
2. 在绘图页面中：
   • 选择绘图模型（如 DALL-E、Stable Diffusion 等）
   • 输入图片描述
   • 设置图片尺寸和参数
3. 点击 「生成」 按钮
4. 等待生成完成后，可以下载或保存图片

9.3 编写好的图片描述（Prompt）#

好的描述是生成高质量图片的关键：

好的描述示例：

1
一只橘猫坐在老式木窗台上，阳光透过蕾丝窗帘洒在它身上，
2
水彩画风格，暖色调，柔和的光影效果，特写镜头，背景是模糊的花园

10.1 通用设置#

点击左下角 ⚙️ 设置 → 「通用」 标签页：

10.2 默认模型设置#

在设置 → 「默认模型」 中，可以配置：

• 默认助手模型：新建对话时默认使用的模型
• 默认绘图模型：使用绘图功能时默认使用的模型
• 默认嵌入模型：创建知识库时默认使用的嵌入模型

10.3 数据备份与同步#

10.4 主题与外观#

10.5 联网搜索设置#

要让 AI 能够联网搜索，需要在设置中配置搜索服务：

1. 进入设置 → 「联网搜索」
2. 选择搜索引擎（如 Tavily、SearXNG 等）
3. 填入对应的 API Key
4. 配置搜索参数（每次搜索结果数量等）
5. 保存设置

配置完成后，在对话中开启「网络搜索」按钮，AI 就能在回答前先搜索互联网获取最新信息。

10.6 快捷短语设置#

快捷短语功能可以让你快速插入常用的提示词：

1. 进入设置 → 「快捷短语」
2. 点击「添加短语」
3. 输入短语名称和内容（支持变量，如 {{input}}）
4. 保存后，在对话界面点击「快捷短语」按钮即可快速调用

示例：

• 名称：「翻译为英文」
• 内容：「请将以下内容翻译为英文，保持原文格式和语气：\n{{input}}」

11.1 全局快捷键#

11.2 对话快捷键#

11.3 编辑快捷键#

11.4 自定义快捷键#

你可以在设置 → 「快捷键」 中自定义各种操作的快捷键绑定，打造最适合自己的操作方式。

12.1 高效使用技巧#

12.2 常见问题解答#

12.3 进阶使用建议#

当你熟悉了基础操作后，可以尝试以下进阶玩法：

1. 搭建个人知识管理系统：将常用文档全部导入知识库，打造个人 AI 知识助手
2. 创建专业工作流：为不同工作场景创建专属助手，配置不同的提示词和工具
3. 利用 MCP 实现自动化：配置文件系统、Excel 等工具，让 AI 帮你自动处理重复性工作
4. 多设备同步：配置 WebDAV，在办公电脑和家用电脑间同步对话和设置
5. 参与社区：加入 CherryStudio 的 Telegram、Discord 或 QQ 群（575014769），与其他用户交流经验

A. 常用模型 API 平台汇总#

B. 术语表#

C. 相关链接#

• 🏠 官方网站：https://cherry-ai.com/
• 📖 使用文档：https://docs.cherry-ai.com/
• 🐙 GitHub 仓库：https://github.com/CherryHQ/cherry-studio
• 🎨 主题库：https://cherrycss.com
• 💬 Telegram 群组：通过官网加入
• 💬 QQ 群：575014769

> 🍒 CherryStudio —— 让 AI 触手可及，让效率无限提升！ > > 本教程持续更新中，如有问题欢迎到 GitHub Issues 或社区群组反馈。

最后更新：2026 年 5 月