接入 Cherry Studio

Cherry Studio 是一款面向 Windows / macOS / Linux 全平台的开源桌面 AI 客户端，致力于为用户提供统一、高效的AI生产力工具。它支持一站式接入30+主流LLM服务商，无需在多个网页端来回切换；内置300+预设对话助手、原生Agent能力、AI翻译、本地知识库、MCP服务、OpenClaw多平台接入等功能，可满足开发者、内容创作者、办公人群、AI爱好者的各类使用需求，是目前功能最全面的开源桌面AI客户端之一。

• GitHub： https://github.com/CherryHQ/cherry-studio
• 官网： https://cherry-ai.com

将DeepSeek V4系列模型接入Cherry Studio，可充分发挥DeepSeek的强推理能力与百万上下文优势：代码开发场景下可获得媲美专业编程助手的表现，长文档处理场景下可一次性导入整份项目文档、小说、产品需求文档无需拆分，翻译场景下可获得更符合专业语境的高质量翻译结果，同时DeepSeek的高性价比可大幅降低长期使用成本。

通过本教程，你将掌握Cherry Studio的安装方法、DeepSeek模型的配置流程、基础对话与进阶功能的使用方法，全程可视化操作，无需代码基础即可完成。

💡 前置准备

1. 提前获取DeepSeek API Key：前往DeepSeek开放平台创建并复制，确保已开启V4系列模型的访问权限。
2. 环境要求：
   • Windows：Windows 10 及以上版本（可执行winver命令查看版本）；
   • macOS：macOS 11.0（Big Sur）及以上版本（可点击桌面左上角苹果图标→关于本机查看版本）；
   • Linux：Ubuntu 20.04+、Fedora 34+、Debian 11+等主流发行版（可执行lsb_release -a查看版本）。
3. 网络要求：确保可正常访问GitHub与DeepSeek API地址https://api.deepseek.com，若访问速度慢可在Cherry Studio设置中配置代理。

1. 安装 Cherry Studio

请从 Cherry Studio Releases 或 官网 下载对应平台的安装包：

• Windows（.exe）
• macOS（.dmg，支持 Intel 与 Apple Silicon）
• Linux（.AppImage / .deb / .rpm）

操作目的：从官方渠道获取安装包，避免第三方渠道的恶意修改与版本滞后问题。 预期结果：下载对应系统的安装包后可正常打开安装向导。 注意事项：

• macOS用户若打开安装包时提示「无法验证开发者」，可右键点击安装包选择「打开」，或前往「系统设置→隐私与安全性」中允许该应用运行；
• Linux用户若.AppImage文件无法运行，可右键点击文件→属性→权限，勾选「允许作为程序执行」，或执行chmod +x 文件名.AppImage命令添加执行权限；
• 国内用户若GitHub下载速度慢，可从官网镜像地址下载安装包。

2. 配置 DeepSeek 模型服务

打开 Cherry Studio，点击左下角的齿轮图标进入 设置。

1. 在左侧导航中打开 模型服务，在内置 Provider 列表里找到 深度求索（DeepSeek）。 操作目的：进入模型服务管理页面，Cherry Studio已内置DeepSeek的官方适配，无需手动配置API地址。 预期结果：找到DeepSeek条目，点击进入配置页面。

2. 将 DeepSeek API Key 粘贴到 API 密钥 字段，API 地址 保持默认值 https://api.deepseek.com。 参数说明：

• API密钥：用于DeepSeek API的身份认证，需确保与你在开放平台创建的密钥一致，无前后空格；
• API地址：DeepSeek官方接口地址，无需修改，若使用私有部署的DeepSeek服务可替换为对应地址。 预期结果：API密钥与地址填写完成，无报错。

3. 点击 获取模型列表 拉取可用模型，将 deepseek-v4-pro 与 deepseek-v4-flash 添加到模型列表。 操作目的：拉取DeepSeek官方提供的可用模型列表，选择需要使用的模型添加到本地模型库。 参数说明：

• deepseek-v4-pro：专业版模型，推理能力强，支持百万上下文，适合复杂推理、代码开发、长文档处理场景；
• deepseek-v4-flash：轻量版模型，响应速度快、成本低，适合日常问答、简单任务处理场景。 预期结果：模型列表加载完成，勾选的两个模型已出现在「已添加模型」列表中。 注意事项：若拉取模型列表失败，检查网络是否正常，是否可访问https://api.deepseek.com，可尝试在设置→网络中配置代理后重试。

4. 打开 DeepSeek 服务页面右上角的开关，启用该 Provider。 操作目的：启用DeepSeek服务，后续即可在对话中选择该服务商的模型。 预期结果：开关显示为开启状态，模型服务页面的DeepSeek条目状态为「已启用」。

3. 开始对话

进入顶部 智能体 页面，点击 + 智能体，填写名称，模型 选择 deepseek-v4-pro（或 deepseek-v4-flash），按需选择权限模式，点击 添加。 操作目的：创建独立的智能体配置，每个智能体可单独设置模型、系统提示词、权限、工具调用能力，方便不同场景下快速切换使用。 配置建议：

• 可创建多个智能体适配不同场景，比如「代码助手」用deepseek-v4-pro，设置系统提示词为「你是专业的编程助手，擅长代码生成、Debug、重构」；「日常问答」用deepseek-v4-flash，设置系统提示词为「你是实用的生活助手，回答简洁准确」。
• 权限模式建议选择「询问确认」，模型在执行文件操作、工具调用前会先获得你的确认，避免误操作。 预期结果：智能体页面出现你创建的智能体卡片，点击可进入对话界面。

打开新建的 Agent 即可开始对话。DeepSeek V4 默认开启深度思考，且原生支持最高 100 万 token 的上下文窗口，Cherry Studio 默认基于完整窗口运行，无需额外配置。 使用说明：对话过程中可直接拖拽文件到输入框，DeepSeek V4的百万上下文可直接处理整份文档，无需手动拆分；若需切换模型，可点击对话界面顶部的模型下拉框直接切换。

如需在编码或复杂任务中获得最强推理表现，点击输入框工具栏中的灯泡图标，在弹出的 思维链长度 菜单中选择 穷究。Cherry Studio 会自动把它映射为 DeepSeek API 的 reasoning_effort: "max"。 参数说明：reasoning_effort是DeepSeek V4专属的推理强度参数，可选值为low/medium/high/max，强度越高模型思考越深入，推理准确率越高，但响应时间越长、消耗token越多。「穷究」对应最高强度max，适合复杂数学题、代码Debug、逻辑推理、方案设计等场景。 预期结果：选择「穷究」后，模型的回复会包含更详细的思考过程，推理准确率显著提升。

4. 进阶用法

完成 DeepSeek V4 配置后，你可以在 Cherry Studio 的其他场景中复用它：

• 知识库：将 PDF、Markdown、Office 文件拖入 知识库 页面，即可基于 DeepSeek V4 进行 RAG 检索。 功能说明：支持单文件最大1GB，批量上传无数量限制，RAG检索会自动将文件内容切块并匹配你的问题，结合DeepSeek V4的百万上下文，可实现整本书、整个代码仓库文档、整份产品需求集的智能问答，无需手动拆分内容。适合做文献综述、代码库梳理、项目文档查询等场景。 最佳实践：上传知识库时可选择「自动生成摘要」，后续检索效率更高；对于代码库可直接上传整个文件夹，模型会自动识别代码结构。

• AI 翻译：进入 翻译 页面，将翻译引擎切换为 DeepSeek V4 模型，即可获得高质量、低延迟的翻译体验。 功能说明：支持100+语言互译，支持文本翻译、文件批量翻译、划词翻译，DeepSeek V4对专业术语、代码注释、技术文档的翻译准确率远高于通用翻译工具，且支持自定义术语库，适合开发者、翻译工作者使用。 最佳实践：翻译技术文档时选择deepseek-v4-pro，翻译准确率更高；翻译日常内容时选择deepseek-v4-flash，速度更快成本更低。

• MCP 服务：在 设置 → MCP 中添加 MCP 服务，所有由 DeepSeek 驱动的会话都可以调用其中的工具。 功能说明：MCP（Model Context Protocol）是开放的模型上下文协议，支持接入本地文件系统、操作系统命令、第三方API、数据库等工具，配置后DeepSeek模型可自动调用这些工具完成复杂任务，比如读取本地项目文件、修改代码、调用天气API、发送邮件、查询数据库等，实现真正的Agent自动化能力。 最佳实践：新手可先添加官方提供的「文件系统」MCP服务，让模型可以直接操作本地项目文件，大幅提升编码效率。

• OpenClaw：Cherry Studio 内置 OpenClaw —— 一个可接入飞书、微信等聊天平台的个人 AI 助手。在侧边栏的 OpenClaw 页面安装并启动 OpenClaw，将其默认模型设置为 DeepSeek V4，即可让你的 IM 机器人由 DeepSeek 驱动。 功能说明：无需自行部署服务，只需简单配置即可将DeepSeek的能力接入你日常使用的IM软件，实现微信、飞书等平台内直接与DeepSeek对话，适合个人日常使用或小团队内部协作场景。 注意事项：使用OpenClaw接入IM平台时需遵守对应平台的使用规则，避免账号被风控。

💡 避坑指南

1. 拉取不到模型列表：检查网络是否可访问https://api.deepseek.com，是否配置了正确的代理，可尝试切换网络后重试。
2. 发送消息报错401：检查API Key是否正确，有无前后空格，是否已开启DeepSeek V4模型的访问权限。
3. 知识库上传失败：检查文件大小是否超过1GB限制，文件是否加密或损坏，是否为支持的格式。
4. OpenClaw登录失败：检查IM账号是否处于正常状态，是否需要二次验证，是否被平台风控，可尝试重新登录。
5. 模型回复被截断：可在模型配置中调大max_tokens参数，最大可设置为384000，匹配DeepSeek V4的最大输出token限制。

❓ 常见问题

• Q：可以导入自定义的DeepSeek模型吗？ A：可以，在DeepSeek模型服务配置页面，点击「添加自定义模型」，输入模型ID（如deepseek-v4-pro[1m]）即可添加。
• Q：Cherry Studio的数据会上传到第三方服务器吗？ A：不会，所有配置、会话、知识库数据都存储在本地，仅在调用模型时将请求内容发送到你配置的模型服务商（即DeepSeek）的API接口，不会上传到Cherry Studio的服务器，隐私安全有保障。
• Q：如何备份我的数据？ A：前往「设置→通用」，点击「导出数据」，可将所有配置、智能体、知识库、会话导出为压缩包，重装或换设备时直接导入即可恢复所有数据。
• Q：可以同时接入多个模型服务商吗？ A：可以，在「模型服务」页面添加多个服务商即可，使用时可随时切换。

参考资料

• awesome-deepseek-agent

---

✨ 教程总结 本教程覆盖了Cherry Studio的安装、DeepSeek模型配置、基础对话与进阶功能使用的全流程，你现在已经可以在Cherry Studio中使用DeepSeek V4系列模型完成各类生产力任务。下一步你可以：

1. 访问Cherry Studio GitHub仓库查看更多功能说明、预设智能体与插件资源；
2. 查看awesome-deepseek-agent获取更多DeepSeek Agent的使用案例与最佳实践；
3. 若遇到问题可前往Cherry Studio官方Discord社区或GitHub Issue提交反馈。