社区工具说明书
Cherry Studio 入门说明书
接通一个模型，把活动记录整理成待办，再了解知识库。
先了解它能做什么
Cherry Studio 是一个桌面 AI 客户端。你可以在同一个窗口里连接不同模型、保存对话，也可以用自己的资料提问。它适合已经有模型账号，希望把日常对话集中管理的人。
安装客户端和开通模型服务是两件事。 客户端开源免费；使用云端模型时，费用和额度由模型服务商决定。如果软件提供免费体验入口，先看当前规则，不要默认所有模型都能免费使用。
这篇先带你接通一个模型，再把一小段活动记录整理成待办清单。知识库和本地模型放在最后，第一次使用可以暂时跳过。
下载并打开软件
- 进入 Cherry Studio 官方下载页，或从 官方 GitHub Releases 下载安装包。
- 选择自己的系统和芯片类型。Windows 按发布页选择安装版；macOS 区分 Apple 芯片和 Intel 芯片；Linux 按发行版选择支持的格式。不确定芯片时，先在电脑的系统信息里查看。
- Windows 按安装向导完成安装；macOS 打开下载的安装包，把应用放入“应用程序”；Linux 按发布页对应格式的说明安装。
- 打开 Cherry Studio，找到“设置”中的“模型服务”。能进入这个页面，就可以继续配置。
遇到系统安全提示时，先核对下载来源和当前版本的官方说明。不要因为教程说“可信”就关闭系统保护或运行来历不明的安装包。
接通一个模型
第一次只配置一家服务商。下面以已经有 DeepSeek 开放平台账号的情况为例；如果你用其他服务商，流程相似，但密钥、地址和模型要使用同一家服务商提供的信息。
- 在 DeepSeek 开放平台 登录，查看 API 服务是否有可用额度，再创建 API 密钥。聊天产品的会员或登录状态不代表 API 已开通。
- 回到 Cherry Studio，打开 设置 → 模型服务，找到 DeepSeek。优先用内置配置；没有对应项时，再按服务商文档添加自定义提供商。
- 将密钥粘贴到“API 密钥”栏。使用官方服务时保留对应的官方地址；不要把密钥填进备注、聊天输入框或其他网站。
- 点击“获取模型列表”，把一个可用的对话模型加入列表。如果不能自动获取，按服务商文档填写准确的模型 ID。嵌入模型用于资料检索，不能代替普通对话模型。
- 确认服务商已启用，点击“检测”，选择刚才的模型。检测可能产生少量模型调用费用。
- 回到对话页，在模型选择器中选中它。发出一条简短消息，收到正常回答后再做下一节练习。
图：Cenry 原稿中的桌面版界面。这里展示的是自定义配置；能找到内置服务商时优先用内置项。界面名称可能随版本变化。
地址填错比参数没调好更常见。 不同服务商可能要求根地址、带 /v1 的地址或指定端点。按对应官方文档填写，不要统一删掉后缀，也不要把一种接口格式强行用于另一种服务。
第一次练习：整理活动待办
新建一个话题，选择已接通的模型，把下面整段文字发给它。人名、日期和活动均为虚构，不需要上传自己的工作材料。
请只根据下面这段活动记录，整理一张待办表，列为“事项、负责人、截止日期”。
没有写明的信息填“待确认”，不要自行补人名或日期。
表格后列出需要向组织者确认的问题。
活动记录：
9 月 10 日，小林负责提交读书会海报。
阿青负责确认活动场地，截止日期还没有定。
报名表需要在 9 月 12 日前准备好，还没决定由谁负责。
检查输出是否保留了这三项任务：
| 事项 | 负责人 | 截止日期 |
|---|---|---|
| 提交读书会海报 | 小林 | 9 月 10 日 |
| 确认活动场地 | 阿青 | 待确认 |
| 准备报名表 | 待确认 | 9 月 12 日 |
措辞可以不同，但负责人和日期不能变。还应有两个待确认问题：场地何时确认、报名表由谁负责。如果模型补了不存在的信息，继续告诉它：
请对照原始记录检查表格。删掉原文没有提供的信息，并把缺失项改成“待确认”。只输出修正后的表格和待确认问题。
能发送消息、继续追问，并核对出正确表格，就完成了第一次练习。可以给话题改一个容易找到的名字，例如“读书会待办练习”。
熟悉后再用知识库
知识库适合反复查询一组资料。它通常先把文档转成便于检索的数据，再把找到的片段交给对话模型回答。
- 先准备一份内容很短、你能核对答案的公开或虚构文档。
- 进入“知识库”，新建一个库。当前版本可以把嵌入模型设为“不使用”，先用关键词检索；需要匹配不同措辞的相近意思时，再配置嵌入模型。
- 添加文档，等待处理完成，抽查提取出的文字。通过“召回测试”问一个已知答案的问题，确认能找到正确片段；这里的“召回”就是从资料里找出相关内容。
- 回到对话，通过输入框附近的知识库入口选择这个库，再问同一个问题。查看引用或检索片段，确认回答确实来自这份文档；没有依据的部分让模型明确写“资料中未提到”。
文档保存在电脑上，不代表处理过程完全离线。使用云端嵌入模型时，文档文本可能被发送给服务商；使用云端对话模型时，检索到的片段也可能随请求发出。只有各个处理环节都使用本地服务，且未启用联网或外部工具，才有条件离线完成任务。
遇到问题时怎么查
| 现象 | 先检查什么 |
|---|---|
| 对话页没有模型 | 服务商是否启用，模型是否已加入列表，是否选了对话模型 |
| 检测或对话报 401、403 | 密钥是否完整，是否过期，账号是否有对应权限 |
| 提示额度不足或限流 | 到服务商后台看余额、配额和调用记录；不要靠反复重试解决 |
| 模型不存在 | 对照服务商文档核对模型 ID，确认自己的账号有权限使用 |
| 知识库处理失败 | 文件格式是否支持，文档是否过大或无法提取文字；启用了嵌入模型时，再检查该模型是否可用 |
| 想切换另一家模型 | 新增对应服务商，再在对话页选择它；不要只改模型名称 |
准备分享截图或备份时，检查是否包含密钥和私人对话。密钥一旦泄露，应在服务商后台撤销并重新创建。