拾光小屋

CherryStudio 从入门到精通教程

Mon, 11 May 2026 00:00:00 GMT

> 🍒 CherryStudio 是一款支持多个大语言模型（LLM）服务商的桌面客户端，兼容 Windows、Mac 和 Linux 系统。本教程将从零开始，带你全面掌握 CherryStudio 的所有功能。

📑 目录

第一章 CherryStudio 简介
第二章下载与安装
第三章首次启动与界面认知
第四章模型配置
第五章基础对话功能
第六章助手与智能体系统
第七章知识库
第八章 MCP 工具与办公自动化
第九章绘图功能
第十章高级设置与个性化
第十一章快捷键大全
第十二章实用技巧与常见问题

第一章 CherryStudio 简介

1.1 什么是 CherryStudio？

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

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

1.2 核心优势

优势	说明
🌐 全模型统一管理	一个客户端同时兼容 OpenAI、Claude、Gemini、DeepSeek、通义千问、豆包等几乎所有主流云端大模型
🔌 MCP 协议支持	内置 MCP 工具市场，一键启用文件操作、数据分析、邮件发送等上百种工具，零代码实现办公自动化
🔒 数据隐私安全	所有会话数据、模型配置、知识库文件全部存储在本地电脑，不会上传到任何云端服务器
💰 永久免费开源	核心功能 100% 开源免费，无会员、无内购、无使用次数限制，个人与企业均可免费商用
🖥️ 跨平台支持	完美适配 Windows、macOS、Linux 三大操作系统
🎨 高度可定制	支持明暗主题、透明窗口、自定义 CSS、主题库等个性化设置

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 系统要求

操作系统	最低配置	推荐配置
Windows	Windows 10 及以上，4GB 内存，2GB 磁盘空间	Windows 11，8GB+ 内存，10GB+ SSD
macOS	macOS 12.0 及以上，4GB 内存，2GB 磁盘空间	macOS 14.0+，8GB+ 内存，10GB+ SSD
Linux	Ubuntu 20.04+，4GB 内存，2GB 磁盘空间	Ubuntu 22.04+，8GB+ 内存，10GB+ SSD

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

2.2 下载方式

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

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

方式二：GitHub 下载

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

2.3 Windows 安装步骤

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

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

2.4 macOS 安装步骤

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

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

2.5 Linux 安装步骤

Debian/Ubuntu 系统：

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

AppImage 通用版：

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

第三章首次启动与界面认知

3.1 首次启动

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

3.2 界面五大核心区域

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

区域	位置	核心功能
功能导航栏	最左侧	核心功能入口：会话、模型管理、MCP 工具、知识库、提示词模板、设置
会话管理区	左侧栏	历史会话列表、文件夹分类、知识库列表，快速切换和管理
会话主界面	中间区域	核心对话区域，支持多轮对话、文件上传、代码块复制、内容编辑与导出
参数设置区	右侧栏	切换模型、调整参数（温度值、Top-P、最大输出长度）、设置提示词、开启 MCP 工具
输入框	底部	对话输入区域，支持文本输入、文件上传、图片插入、快捷短语、翻译

3.3 左侧导航栏功能说明

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

图标	功能名称	说明
💬	会话	管理所有对话，创建新话题，切换助手
🤖	智能体	浏览和使用 300+ 预设 AI 助手，或创建自定义助手
🎨	绘图	AI 图片生成功能，输入描述即可生成图片
📚	知识库	管理本地知识库，上传文档建立索引，实现基于文档的智能问答
🔧	工具	MCP 工具管理，安装和启用各种扩展工具
📝	提示词	管理提示词模板，快速复用常用提示词
⚙️	设置	软件全局设置，包括模型服务、通用设置、备份等

3.4 新手快速上手建议

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

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

第四章模型配置

CherryStudio 的核心能力基于大模型实现。它支持云端 API 模型和本地开源模型两大类型。本章将详细介绍如何配置各种模型。

4.1 什么是模型服务商？

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

服务商	代表模型	特点
OpenAI	GPT-4o、GPT-4o-mini	综合能力强，但需要海外网络
Anthropic	Claude 3.5 Sonnet	长文本处理优秀，需要海外网络
Google	Gemini Pro	Google 出品，多模态能力强
DeepSeek	DeepSeek-V3、DeepSeek-R1	国产模型，代码和推理能力强，价格极低
阿里云	通义千问	国产模型，中文能力强
字节跳动	豆包（Doubao）	国产模型，新用户免费额度充足
硅基流动	多模型聚合	国内平台，可访问多种模型

4.2 获取 API Key

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

以 DeepSeek 为例（推荐新手使用）：

打开 DeepSeek 开放平台：https://platform.deepseek.com/
使用手机号注册并登录
进入「API Keys」页面
点击「创建新的 API Key」
复制生成的密钥并保存好（⚠️ 密钥只显示一次，丢失需重新生成）
新用户注册赠送 500 万免费 tokens

以豆包（字节跳动）为例：

打开火山引擎方舟平台：https://www.volcengine.com/ark
注册并登录
进入「API 密钥管理」→「新建密钥」
复制密钥并保存

4.3 在 CherryStudio 中添加模型

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

4.4 各大模型配置要点

模型厂商	官方 API 平台	配置核心要点
DeepSeek	https://platform.deepseek.com/	厂商选 DeepSeek，填入 API Key
豆包	https://www.volcengine.com/ark	厂商选豆包，填入 API Key
通义千问	https://dashscope.aliyun.com/	厂商选通义千问，填入 DashScope API Key
OpenAI	https://platform.openai.com/	需海外网络，国内可使用中转地址填入 base_url
Anthropic	https://console.anthropic.com/	需海外网络，国内可使用代理接入
硅基流动	https://siliconflow.cn/	国内平台，支持多种模型，注册即有免费额度
腾讯混元	https://cloud.tencent.com/product/hunyuan	填入腾讯云 API 密钥与 APPID
Ollama（本地）	https://ollama.com/	需先安装 Ollama 并下载模型，地址默认 127.0.0.1:11434

4.5 本地模型配置（Ollama）

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

第一步：安装 Ollama

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

第二步：下载模型

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

第三步：在 CherryStudio 中接入

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

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

4.6 模型参数详解

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

🌡️ 温度（Temperature）

控制 AI 回复的「创造性」程度：

温度范围	效果	适用场景
0 - 0.3（低温）	输出更确定、更专注	代码生成、数据分析、翻译
0.4 - 0.7（中温）	平衡创造性和连贯性	日常对话、一般写作（默认 0.7）
0.8 - 1.0（高温）	更具创造性和多样性	创意写作、头脑风暴

🎯 Top P（核采样）

控制 AI 使用的词汇范围：

Top P 范围	效果
0.1 - 0.3	只使用最高概率的词汇，输出更保守可控
0.4 - 0.6	平衡词汇多样性和准确性
0.7 - 1.0	考虑更广泛的词汇选择，内容更丰富多样

📏 上下文数量

保留在上下文中的消息数量。数值越大，AI 能"记住"的对话内容越多，但消耗的 token 也越多。

5-10 条：适合普通对话
10 条以上：适合需要长记忆的复杂任务（如分步写长文）

📏 最大输出长度（Max Tokens）

单次回复的最大字数限制：

使用场景	建议 Token 数
普通聊天	500 - 800
短文生成	800 - 2000
代码生成	2000 - 3600
长文生成	4000+

🔄 串流输出（Stream）

开启（推荐）：AI 的回复会像打字机一样逐字显示，体验更流畅
关闭：AI 生成完所有内容后一次性显示

第五章基础对话功能

5.1 创建第一个对话

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

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

5.2 对话框按钮详解

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

按钮	功能	详细说明
📄 新话题	创建新对话	在当前助手下创建一个新的对话话题
📎 上传图片/文件	上传附件	支持上传图片（需模型支持多模态）和文档（PDF、Word、Excel 等），文档会自动解析为文字提供给模型
🌐 网络搜索	联网搜索	开启后，AI 会先在互联网上搜索相关信息，再基于搜索结果回答你的问题（需在设置中配置搜索服务）
📚 知识库	关联知识库	开启后，AI 会基于你创建的知识库文档来回答问题
🔧 MCP 服务器	启用工具	开启后，AI 可以调用已配置的 MCP 工具来执行操作
🎨 生成图片	AI 绘图	输入描述文字，AI 会为你生成图片（仅当所选模型支持时显示）
🤖 选择模型	切换模型	在对话过程中临时切换到其他模型，保留当前上下文
💬 快捷短语	快速插入	调用预设的常用提示词短语，支持变量替换
🗑️ 清空消息	删除对话	清空当前话题下的所有对话内容
⬆️ 展开	放大输入框	将输入框变大，方便输入长文本
✂️ 清除上下文	重置记忆	不删除内容，但让 AI "忘记"之前的对话内容
🔤 翻译	翻译输入	将输入框中的内容翻译为英文（可在设置中更改目标语言）

5.3 对话中的实用操作

右键菜单

在 AI 的回复消息上右键点击，可以进行以下操作：

复制：复制回复内容
重新生成：让 AI 重新回答同一个问题
编辑：修改 AI 的回复内容
翻译：将回复翻译为其他语言
导出：将对话导出为 Markdown、图片等格式

消息操作栏

每条 AI 回复下方都有操作按钮：

📋 复制：一键复制回复内容
🔄 重新生成：重新生成回复
✏️ 编辑：手动编辑回复
👍👎 点赞/点踩：对回复质量进行评价

5.4 多模型同时对话

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

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

5.5 文件上传与解析

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

文件类型	支持格式	说明
📄 文档	PDF、Word（.docx）、TXT	自动提取文字内容
📊 表格	Excel（.xlsx）、CSV	自动解析表格数据
🖼️ 图片	PNG、JPG、GIF、WebP	需模型支持多模态（视觉理解）
💻 代码	各种编程语言源文件	自动识别语法高亮

使用方法：

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

5.6 对话设置详解

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

消息设置

设置项	说明
消息分割线	用分割线将消息正文和操作栏隔开
使用衬线字体	切换消息显示的字体样式
代码显示行号	在代码块中显示行号
代码块可折叠	长代码自动折叠，减少占用空间
代码块可换行	超长代码行自动换行显示
思考内容自动折叠	支持「思考」的模型（如 DeepSeek-R1）思考完成后自动折叠思考过程
消息样式	切换「气泡样式」或「列表样式」
代码风格	切换代码块的显示风格
数学公式引擎	选择 KaTeX（快速）或 MathJax（功能全面）
消息字体大小	调整对话界面文字大小

输入设置

设置项	说明
显示预估 Token 数	在输入框显示预估消耗的 Token 数量
长文本粘贴为文件	粘贴长文本时自动显示为文件样式，减少干扰
Markdown 呈现输入消息	是否将你发送的消息也以 Markdown 格式渲染
快速敲击 3 次空格翻译	在输入框连按 3 次空格，自动将内容翻译为目标语言
目标语言	设置翻译功能的目标语言

5.7 Token 预估显示

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

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

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

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

第六章助手与智能体系统

6.1 什么是助手？

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

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

6.2 助手与话题的关系

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

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

6.3 使用预设助手

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

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

常用预设助手推荐：

分类	推荐助手	用途
✍️ 写作	文章润色助手、文案撰写助手	优化文章、撰写文案
💻 编程	代码审查助手、Bug 修复助手	代码质量检查、问题排查
🌐 翻译	英中翻译助手、日中翻译助手	多语言翻译
📚 学习	英语学习助手、数学解题助手	学习辅导
💼 办公	周报生成助手、会议纪要助手	办公效率提升

6.4 创建自定义助手

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

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

提示词设置

名称：给助手起一个容易识别的名字（如「我的翻译助手」）
提示词（Prompt）：告诉 AI 它的角色和行为规则

提示词编写技巧：

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

你的工作规则：
1. [规则1]
2. [规则2]
3. [规则3]

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

示例 - 创建一个代码审查助手：

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

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

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

模型设置

设置项	说明
默认模型	为该助手固定一个默认模型
自动重置模型	新建话题时是否重置为助手默认模型
温度	控制回复的创造性（详见 4.6 节）
Top P	控制词汇选择范围（详见 4.6 节）
上下文数量	保留多少轮对话记忆
最大输出长度	单次回复的最大 Token 数
串流输出	是否开启打字机效果

6.5 管理助手

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

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

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

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

第七章知识库

7.1 什么是知识库？

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

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

7.2 知识库的适用场景

场景	说明
📋 企业文档问答	上传公司规章制度、产品手册，AI 基于文档回答员工问题
📚 学习资料助手	上传教材、笔记，AI 帮你解答学习中的疑问
📄 合同/法律文档	上传合同文本，快速查询特定条款和内容
💼 项目文档管理	上传项目文档，快速检索项目相关信息
🔬 技术文档查询	上传 API 文档、技术规范，快速查找技术细节

7.3 创建知识库

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

7.4 上传文档

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

7.5 在对话中使用知识库

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

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

7.6 知识库管理

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

第八章 MCP 工具与办公自动化

8.1 什么是 MCP？

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

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

8.2 MCP 工具市场

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

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

8.3 办公高频必备工具推荐

工具名称	核心功能	使用场景
📁 本地文件系统	读取、写入、修改、删除本地文件	文档批量处理、文件整理、代码读写
📊 Excel/CSV 数据处理	读取、分析、统计 Excel 数据	财务报表分析、销售数据统计
📧 邮件发送	自动撰写和发送邮件	客户邮件批量发送、通知推送
🌐 网页浏览器	打开网页、抓取内容、搜索信息	信息收集、数据抓取
💻 系统命令	执行系统命令、进程管理	电脑运维、批量文件处理
🗄️ 数据库工具	连接和查询数据库	业务数据查询、报表生成

8.4 使用 MCP 工具

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

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

使用示例：

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

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

8.5 添加自定义 MCP 服务

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

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

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

第九章绘图功能

9.1 什么是绘图功能？

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

9.2 使用方法

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

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

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

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

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

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

要素	说明	示例
主体	图片的核心内容	「一只橘猫坐在窗台上」
风格	图片的艺术风格	「水彩画风格」「赛博朋克风」
细节	具体的细节描述	「阳光透过窗户洒在猫身上」
构图	画面的布局方式	「特写镜头」「广角全景」
色调	图片的色彩倾向	「暖色调」「冷蓝色调」

好的描述示例：

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

第十章高级设置与个性化

10.1 通用设置

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

基础环境配置

设置项	说明	建议
语言	切换界面显示语言，支持简中、繁中、英、日、德、法等 10 种语言	根据需要选择
代理模式	网络连接方式，使用海外模型时需配置代理	使用海外模型选「系统代理」
拼写检查	输入时自动检测拼写错误（主要针对英文）	主要用中文可关闭
禁用硬件加速	强制使用 CPU 渲染界面	正常保持关闭，画面异常时开启

消息与提醒

设置项	说明	建议
助手消息通知	AI 生成完回复时弹出通知	✅ 推荐开启
备份通知	数据备份完成时通知	✅ 推荐开启
知识库通知	知识库索引构建完成时通知	✅ 推荐开启

启动与托盘

设置项	说明	建议
开机自动启动	电脑开机时自动运行 CherryStudio	重度用户推荐开启
启动时最小化到托盘	开机时后台静默启动，不弹出窗口	配合开机自启使用
显示托盘图标	在系统托盘显示图标	✅ 推荐开启
关闭时最小化到托盘	点 X 不退出，缩到托盘	✅ 强烈推荐开启

10.2 默认模型设置

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

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

10.3 数据备份与同步

本地备份

CherryStudio 会自动保存你的所有对话和设置
你可以在设置中配置自动备份的频率和路径
也可以手动导出数据（设置 → 数据管理 → 导出）

WebDAV 云同步

如果你使用 WebDAV 服务（如坚果云），可以实现多设备间数据同步：

在设置中找到 「WebDAV」 配置
填入 WebDAV 服务器地址、用户名、密码
配置同步频率
开启同步后，对话记录和设置会自动在设备间同步

10.4 主题与外观

内置主题

CherryStudio 支持明暗两种主题：

🌙 暗色主题（默认）：深色背景，适合长时间使用
☀️ 亮色主题：浅色背景，适合白天使用

自定义主题

访问 主题库：https://cherrycss.com
下载喜欢的主题并导入
也可以通过自定义 CSS 来完全定制界面样式

透明窗口

在设置中可以开启窗口透明效果，让 CherryStudio 的窗口呈现毛玻璃效果，更加美观。

10.5 联网搜索设置

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

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

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

10.6 快捷短语设置

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

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

示例：

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

第十一章快捷键大全

掌握快捷键可以大幅提升使用效率。以下是 CherryStudio 的完整快捷键列表：

11.1 全局快捷键

快捷键	功能
`Ctrl + Shift + F`	全局搜索
`Ctrl + N`	新建话题
`Ctrl + ,`	打开设置

11.2 对话快捷键

快捷键	功能
`Enter`	发送消息
`Shift + Enter`	换行（不发送）
`Ctrl + L`	聚焦输入框
`Ctrl + K`	清空当前会话
`Ctrl + S`	保存/导出对话
`Ctrl + Shift + [`	切换到上一个会话
`Ctrl + Shift + ]`	切换到下一个会话

11.3 编辑快捷键

快捷键	功能
`Ctrl + C`	复制选中文本
`Ctrl + V`	粘贴
`Ctrl + X`	剪切
`Ctrl + Z`	撤销
`Ctrl + Shift + Z`	重做
`Ctrl + A`	全选

11.4 自定义快捷键

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

第十二章实用技巧与常见问题

12.1 高效使用技巧

💡 技巧1：善用提示词模板

不要每次都从头写提示词。在「提示词」页面创建常用模板，使用时一键插入，大幅提升效率。

💡 技巧2：多模型对比

遇到重要问题时，同时选择 2-3 个模型回答，对比结果，选择最佳答案。

💡 技巧3：合理设置温度

写代码、翻译、数据分析时用低温（0.1-0.3）
日常聊天用中温（0.5-0.7）
创意写作、头脑风暴用高温（0.8-1.0）

💡 技巧4：利用上下文管理

长任务开始前点击「清除上下文」，避免 token 浪费
需要参考之前对话时，保持足够的上下文数量

💡 技巧5：文件拖拽上传

直接把文件从桌面拖到输入框，比点击上传按钮更快。

💡 技巧6：快捷翻译

在输入框中写好中文内容，连按 3 次空格键，自动翻译为英文。

💡 技巧7：对话导出

重要的对话记得导出保存。右键对话 →「导出」→ 选择 Markdown 或图片格式。

12.2 常见问题解答

❓ Q1：为什么发送消息后没有响应？

可能原因和解决方法：

API Key 无效：检查模型设置中的 API Key 是否正确
网络问题：检查网络连接，使用海外模型需确保代理正常
余额不足：检查模型服务商账户余额
模型未启用：确认模型已在模型管理中启用

❓ Q2：如何解决"连接超时"错误？

检查网络连接是否正常
如果使用海外模型，确保代理设置正确（设置 → 通用 → 代理模式 → 系统代理）
尝试切换到国内模型（如 DeepSeek、豆包）

❓ Q3：AI 回复被截断了怎么办？

增大「最大输出长度」（Max Tokens）设置
在提示词中告诉 AI：「请继续」或「请接着上面的内容继续」

❓ Q4：如何备份数据？

设置 → 数据管理 → 导出数据
或配置 WebDAV 自动同步
也可以手动复制 CherryStudio 的数据目录

❓ Q5：本地模型运行很慢怎么办？

确认你的电脑配置满足最低要求
尝试使用更小的模型（如 7B 而不是 14B）
关闭其他占用资源的程序
确保使用 GPU 加速（检查 Ollama 是否正确识别显卡）

❓ Q6：如何更新 CherryStudio？

CherryStudio 通常会自动检测更新
也可以手动去官网下载最新版本覆盖安装
数据会自动保留，不用担心丢失

❓ Q7：支持哪些语言？

界面支持：简体中文、繁体中文、英语、日语、德语、法语、西班牙语、葡萄牙语、俄语、希腊语对话支持：取决于所选模型的能力，大多数模型都支持中英文

12.3 进阶使用建议

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

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

📌 附录

A. 常用模型 API 平台汇总

模型	平台地址	免费额度
DeepSeek	https://platform.deepseek.com/	新用户 500 万 tokens
豆包	https://www.volcengine.com/ark	新用户免费额度
通义千问	https://dashscope.aliyun.com/	新用户 100 万 tokens
硅基流动	https://siliconflow.cn/	注册送额度
OpenAI	https://platform.openai.com/	需付费
Anthropic	https://console.anthropic.com/	需付费
Google Gemini	https://ai.google.dev/	有免费层级
Ollama（本地）	https://ollama.com/	完全免费

B. 术语表

术语	解释
LLM	Large Language Model，大语言模型，即 ChatGPT 这类 AI 的技术名称
API Key	应用程序接口密钥，用来验证你有权使用某个服务
Token	令牌，AI 处理文本的基本单位，大约 1 个汉字 ≈ 1-2 个 Token
Prompt	提示词，你输入给 AI 的指令或问题
Temperature	温度，控制 AI 回复随机性的参数
MCP	Model Context Protocol，模型上下文协议，让 AI 能调用外部工具
上下文	AI 在当前对话中能"看到"的历史消息范围
流式输出	AI 逐字输出回复，而不是一次性全部显示

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 月

New API + Cherry Studio 使用指南

Sun, 10 May 2026 00:00:00 GMT

📣 致读者：本文档专为非开发者（普通用户）编写。 本文不涉及任何代码、命令行操作或 Docker 部署等技术内容。您只需拥有一台电脑，按照下面的图文指引一步步操作，即可轻松使用 Cherry Studio 客户端畅享 New API 提供的各种 AI 大模型服务。

一、准备工作

在正式开始之前，请您准备好以下两样东西：

序号	需要什么	去哪里获取
①	New API 的访问地址（URL）	`https://api-1.yjs.im`
②	New API 的令牌（Key）	登录 New API 管理后台后，在「令牌管理」页面创建（详见下文）

二、在 New API 中获取令牌（Key）

💡 请按以下步骤操作：

2.1 登录 New API 管理后台

在浏览器中打开您的 New API 地址（ https://api-1.yjs.im），使用您的账号登录。

2.2 进入令牌管理页面

登录后，在左侧菜单栏中找到并点击 「令牌管理」 或 「令牌」。

2.3 创建一个新令牌

点击页面上的 「添加令牌」 按钮

填写以下信息：

名称：给令牌起个名字，比如"我的CherryStudio"（方便以后识别）
分组：⚠️ 这是控制该令牌能使用哪些模型的核心设置！ 分组决定了令牌可以调用的模型范围。(分组可以在模型广场查看)
额度：设置使用额度。如果是无限额使用，可以留空或设为 0（代表不限）
过期时间：设置令牌的有效期，也可以选择"永不过期"
模型权限：勾选允许使用的模型（不确定就留空）

点击 「提交」 或 「保存」

2.4 复制令牌（Key）

创建成功后，页面会显示一串以 sk- 开头的密钥。点击复制按钮，把这串密钥保存好！

⚠️ 重要提醒： 这串密钥相当于您的"银行卡密码"，千万不要泄露给不信任的人。

三、下载安装 Cherry Studio（或其它客户端）

3.1 下载 Cherry Studio

打开浏览器，访问 Cherry Studio 官方网站：

🌐 官方下载地址：https://www.cherry-ai.com/

在首页找到「下载」按钮，根据您的操作系统选择对应版本：

操作系统	下载文件名示例
🪟 Windows	`Cherry-Studio-Setup-x.x.x.exe`
🍎 macOS (Intel 芯片)	`Cherry-Studio-x.x.x-x64.dmg`
🍎 macOS (Apple M 芯片)	`Cherry-Studio-x.x.x-arm64.dmg`
🐧 Linux	`Cherry-Studio-x.x.x.AppImage`

如果不确定自己的 Mac 是什么芯片：点击屏幕左上角苹果图标 →「关于本机」→ 查看「芯片」一栏。

3.2 安装 Cherry Studio

Windows 用户：双击下载的 .exe 文件，按照安装向导点击「下一步」直到完成
Mac 用户：双击下载的 .dmg 文件，把 Cherry Studio 图标拖拽到「应用程序」文件夹
Linux 用户：右键 .AppImage 文件 → 属性 → 勾选「允许作为程序执行」，然后双击运行

安装完成后，双击桌面图标（或从开始菜单/启动台找到 Cherry Studio）打开软件。

四、在 Cherry Studio 中配置 New API

这是最关键的一步，请仔细按顺序操作：

4.1 打开设置

启动 Cherry Studio 后，点击软件界面左侧或底部的 「设置」 图标（⚙️ 齿轮图标）。

4.2 添加 New API 作为模型提供商

在设置页面中，找到 「模型服务」 或 「API 提供商」 选项卡
点击 「添加」 按钮
在提供商列表中找到并选择 「New API」 或 「OpenAI 兼容接口」（因为 New API 完全兼容 OpenAI 格式）
选择后点击 「确定」

4.3 填写连接信息

在弹出的配置表单中，填写以下三项关键信息：

配置项	填写内容	说明
API 地址	您拿到的 New API 地址	例如：`https://api-1.yjs.im`
API 密钥	之前复制的令牌（以 `sk-` 开头的那串）	粘贴进来即可

4.4 添加模型

点击 「获取模型列表」 添加自己需要的模型

五、开始使用 Cherry Studio 聊天

5.1 新建对话

回到 Cherry Studio 主界面，点击 「新对话」 或 「+」 按钮。

5.2 选择模型

在对话界面的顶部或设置中，找到 模型选择器（下拉菜单），选择您想使用的 AI 模型。

💡 不同模型各有擅长：写代码选 Claude，日常聊天选 GPT5，深度推理选 DeepSeek-Reasoner，您可以多试试看哪个更适合自己的需求。

5.3 开始聊天

在底部的输入框中输入您的问题，按 Enter（回车键） 发送。AI 模型就会开始回复您啦！

5.4 Cherry Studio 特色功能速览

Cherry Studio 作为专业客户端，提供了很多便捷功能：

功能	说明
📝 多会话管理	可以同时开启多个对话，左侧列表轻松切换
📎 文件上传	支持上传图片、PDF、Word 等文件让 AI 阅读分析
🔍 联网搜索	部分模型支持开启联网搜索功能
📚 知识库	可以搭建自己的知识库，让 AI 基于您的资料回答
🎨 AI 绘画	如 New API 集成了 Midjourney，可在 Cherry Studio 中生成图片
🎵 AI 音乐	如 New API 集成了 Suno，可生成音乐
📊 Prompt 模板	内置丰富的提示词模板，一键套用

六、常见问题解答（FAQ）

确认 New API 服务器是否在正常运行——在浏览器中直接访问该地址看看能否打开
检查本地网络连接是否正常
如果服务器在国外，可能需要科学上网工具 </details>

<details> <summary>Q2：模型列表加载不出来？</summary>

令牌（Key）可能已过期或额度用完，请登录 New API 后台检查
令牌的模型权限可能被限制，确认已勾选需要使用的模型 </details>

<details> <summary>Q3：聊天时提示"余额不足"或"额度已用完"？</summary>

您的令牌额度已耗尽。请登录 New API 管理后台，在「令牌管理」中找到您的令牌，点击「充值」增加额度。 </details>

<details> <summary>Q4：如何切换不同的 AI 模型？</summary>

在 Cherry Studio 的对话界面顶部，有一个模型选择的下拉菜单，点击即可切换。切换后发送的新消息将使用新选择的模型。 </details>

这取决于您的 New API 管理员配置了哪些渠道。常见的有 OpenAI GPT 系列、Anthropic Claude 系列、Google Gemini 系列、DeepSeek 系列、Midjourney（AI 绘画）、Suno（AI 音乐）等几十种模型。具体可咨询您的服务商。 </details>

<details> <summary>Q6：令牌（Key）不小心泄露了怎么办？</summary>

立即登录 New API 管理后台，在「令牌管理」中找到对应的令牌，点击「禁用」或「删除」，然后重新创建一个新的令牌。 </details>

<details> <summary>Q7：Cherry Studio 收费吗？需要付费吗？</summary>

Cherry Studio 是完全免费的客户端软件。您只需要为使用 AI 模型的费用付费（通过 New API 的令牌额度）。也就是说，费用来自 New API 端，不是 Cherry Studio 端。 </details>

七、快速操作检查清单

步骤	操作	✓ 完成
1	获取 New API 的访问地址	☐
2	登录 New API 后台，创建并复制令牌（Key）	☐
3	在 cherry-ai.com 下载 Cherry Studio	☐
4	安装 Cherry Studio	☐
5	在 Cherry Studio 设置中添加 New API 提供商	☐
6	填写 API 地址（记得加 `/v1`）+ 粘贴 API Key	☐
7	测试连接，刷新模型列表	☐
8	新建对话，选择模型，开始聊天 🎉	☐

八、获取帮助

🌐 New API 官方文档：https://docs.newapi.pro/
🌐 New API 官方网站：https://www.newapi.ai/
🌐 Cherry Studio 官网：https://www.cherry-ai.com/
🐙 New API GitHub 仓库：https://github.com/QuantumNous/new-api

📝 文档版本：v1.0 | 适用对象：非开发者 / 普通用户 | 推荐客户端：Cherry Studio

拾光小屋

CherryStudio 从入门到精通教程

📑 目录

第一章 CherryStudio 简介

1.1 什么是 CherryStudio？

1.2 核心优势

1.3 主要功能一览

第二章 下载与安装

2.1 系统要求

2.2 下载方式

2.3 Windows 安装步骤

2.4 macOS 安装步骤

2.5 Linux 安装步骤

第三章 首次启动与界面认知

3.1 首次启动

3.2 界面五大核心区域

3.3 左侧导航栏功能说明

3.4 新手快速上手建议

第四章 模型配置

4.1 什么是模型服务商？

4.2 获取 API Key

以 DeepSeek 为例（推荐新手使用）：

以豆包（字节跳动）为例：

4.3 在 CherryStudio 中添加模型

4.4 各大模型配置要点

4.5 本地模型配置（Ollama）

4.6 模型参数详解

🌡️ 温度（Temperature）

🎯 Top P（核采样）

📏 上下文数量

📏 最大输出长度（Max Tokens）

🔄 串流输出（Stream）

第五章 基础对话功能

5.1 创建第一个对话

5.2 对话框按钮详解

5.3 对话中的实用操作

右键菜单

消息操作栏

5.4 多模型同时对话

5.5 文件上传与解析

5.6 对话设置详解

消息设置

输入设置

5.7 Token 预估显示

第六章 助手与智能体系统

6.1 什么是助手？

6.2 助手与话题的关系

6.3 使用预设助手

6.4 创建自定义助手

提示词设置

模型设置

6.5 管理助手

第七章 知识库

7.1 什么是知识库？

7.2 知识库的适用场景

7.3 创建知识库

7.4 上传文档

7.5 在对话中使用知识库

7.6 知识库管理

第八章 MCP 工具与办公自动化

8.1 什么是 MCP？

8.2 MCP 工具市场

8.3 办公高频必备工具推荐

8.4 使用 MCP 工具

8.5 添加自定义 MCP 服务

第九章 绘图功能

9.1 什么是绘图功能？

9.2 使用方法

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

第十章 高级设置与个性化

10.1 通用设置

基础环境配置

消息与提醒

启动与托盘

10.2 默认模型设置

10.3 数据备份与同步

本地备份

WebDAV 云同步

10.4 主题与外观

内置主题

第二章下载与安装

第三章首次启动与界面认知

第四章模型配置

第五章基础对话功能

第六章助手与智能体系统

第七章知识库

第九章绘图功能

第十章高级设置与个性化

第十一章快捷键大全

第十二章实用技巧与常见问题