英语 | 中文 | 官方网站 | 文档 | 开发指南 | 反馈

🍒 Cherry Studio

Cherry Studio 是一款支持多种 LLM (Large Language Model, 大型语言模型) 提供商的桌面客户端，适用于 Windows、Mac 和 Linux。

👏 加入 Telegram 群组｜Discord | QQ 群 (575014769)

❤️ 喜欢 Cherry Studio？给它点个星 🌟 或 赞助 以支持开发！

🌠 截图

🌟 主要特性

1. 多样化的 LLM 提供商支持:

• ☁️ 主流 LLM 云服务：OpenAI、Gemini、Anthropic 等
• 🔗 AI Web 服务集成：Claude、Perplexity、Poe 等
• 💻 支持 Ollama、LM Studio 本地模型

2. AI 助手与对话:

• 📚 300+ 预配置 AI 助手
• 🤖 自定义助手创建
• 💬 多模型同时对话

3. 文档与数据处理:

• 📄 支持文本、图片、Office、PDF 等
• ☁️ WebDAV 文件管理与备份
• 📊 Mermaid 图表可视化
• 💻 代码语法高亮

4. 实用工具集成:

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

5. 增强的用户体验:

• 🖥️ 支持 Windows、Mac 和 Linux 跨平台
• 📦 开箱即用 - 无需环境配置
• 🎨 浅色/深色主题及透明窗口
• 📝 完整 Markdown 渲染
• 🤲 便捷内容分享

📝 路线图

我们目前正在积极开发以下功能和改进：

1. 🎯 核心功能

• 选择助手（Selection Assistant），增强智能内容选择功能
• 深度研究（Deep Research），具备高级研究能力
• 记忆系统（Memory System），具备全局上下文感知能力
• 文档预处理（Document Preprocessing），改进文档处理能力
• MCP（Model Context Protocol，模型上下文协议）市场，用于模型上下文协议生态系统

2. 🗂 知识管理

• 笔记与合集
• 动态画布可视化
• OCR（光学字符识别）能力
• TTS（文本转语音）支持

3. 📱 平台支持

• 鸿蒙（HarmonyOS）版（PC）
• Android 应用（第一阶段）
• iOS 应用（第一阶段）
• 多窗口支持
• 窗口置顶功能
• Intel AI PC（Core Ultra）支持

4. 🔌 高级功能

• 插件系统
• ASR（自动语音识别）
• 助手与主题交互重构

在我们的 项目看板 上跟踪我们的进度并做出贡献。

想要影响我们的路线图？加入我们的 GitHub 讨论区 分享您的想法和反馈！

🌈 主题

• 主题画廊：https://cherrycss.com
• Aero 主题：https://github.com/hakadao/CherryStudio-Aero
• PaperMaterial 主题：https://github.com/rainoffallingstar/CherryStudio-PaperMaterial
• Claude 动态风格：https://github.com/bjl101501/CherryStudio-Claudestyle-dynamic
• Maple Neon 主题：https://github.com/BoningtonChen/CherryStudio_themes

欢迎提交 PR（Pull Request，拉取请求）以提供更多主题

🤝 贡献

我们欢迎为 Cherry Studio 做出贡献！您可以通过以下方式参与：

1. 贡献代码：开发新功能或优化现有代码。
2. 修复 Bug：提交您发现的任何 Bug 修复。
3. 维护 Issue：帮助管理 GitHub Issue（议题）。
4. 产品设计：参与设计讨论。
5. 编写文档：改进用户手册和指南。
6. 社区参与：加入讨论并帮助用户。
7. 推广使用：宣传 Cherry Studio。

请参阅 分支策略 了解贡献指南

入门指南

1. Fork（复刻）仓库：Fork 并将其克隆到您的本地机器。
2. 创建分支：用于您的更改。
3. 提交更改：提交并推送您的更改。
4. 发起 Pull Request（拉取请求）：描述您的更改和原因。

如需更详细的指南，请参阅我们的 贡献指南。

感谢您的支持和贡献！

🔧 开发者共创计划

我们正在推出 Cherry Studio 开发者共创计划，旨在开源生态系统中培养健康和积极的反馈循环。我们相信伟大的软件是协作构建的，每一个合并的 Pull Request（拉取请求）都为项目注入了新的活力。

我们诚挚邀请您加入我们的贡献者行列，与我们共同塑造 Cherry Studio 的未来。

贡献者奖励计划

为了回馈我们的核心贡献者并创造良性循环，我们制定了以下长期激励计划。

本计划的首个跟踪周期为 2025 年第三季度（7 月、8 月、9 月）。该周期的奖励将于 10 月 1 日发放。

在任何跟踪周期内（例如第一个周期为 7 月 1 日至 9 月 30 日），任何在 GitHub 上为 Cherry Studio 的任何开源项目贡献超过 30 次有意义提交 的开发者都有资格获得以下福利：

• Cursor 订阅赞助：获得 70 美元 的信用额度或报销您的 Cursor 订阅费用，让 AI 成为您最高效的编码伙伴。
• 无限模型访问：获得 DeepSeek 和 Qwen 模型的 无限 API（应用程序编程接口）调用次数。
• 前沿技术访问：享受偶尔的福利，包括 Claude、Gemini 和 OpenAI 等模型的 API 访问权限，让您保持技术领先地位。

共同成长与未来计划

充满活力的社区是任何可持续开源项目的驱动力。随着 Cherry Studio 的成长，我们的奖励计划也将随之发展。我们致力于不断使我们的福利与行业内最好的工具和资源保持一致。这确保我们的核心贡献者获得有意义的支持，创造一个开发者、社区和项目共同成长的良性循环。

展望未来，该项目还将采取越来越开放的立场，回馈整个开源社区。

如何开始？

我们期待您的第一个 Pull Request（拉取请求）！

您可以从探索我们的仓库开始，选择一个 good first issue，或提出您自己的增强建议。每一次提交都是开源精神的证明。

感谢您的兴趣和贡献。

让我们一起构建。

🏢 企业版

在社区版的基础上，我们自豪地推出 Cherry Studio 企业版——一个专为现代团队和企业设计的可私有化部署的 AI 生产力与管理平台。

企业版通过集中管理 AI 资源、知识和数据，解决了团队协作中的核心挑战。它使组织能够提高效率、促进创新并确保合规性，同时在安全环境中保持对其数据的 100% 控制。

核心优势

• 统一模型管理：集中集成和管理各种基于云的 LLM（大型语言模型）（例如 OpenAI、Anthropic、Google Gemini）和本地部署的私有模型。员工无需单独配置即可开箱即用。
• 企业级知识库：构建、管理和共享团队级知识库。确保知识保留和一致性，使团队成员能够基于统一且准确的信息与 AI 交互。
• 细粒度访问控制：通过统一的管理后台，轻松管理员工账户并为不同的模型、知识库和功能分配基于角色的权限。
• 完全私有化部署：将整个后端服务部署在您本地的服务器或私有云上，确保您的数据保持 100% 私有且受您控制，以满足最严格的安全和合规标准。
• 可靠的后端服务：提供稳定的 API（应用程序编程接口）服务和企业级数据备份与恢复机制，确保业务连续性。

✨ 在线演示

🔗 Cherry Studio 企业版

版本对比

获取企业版

我们相信企业版将成为您团队的 AI 生产力引擎。如果您对 Cherry Studio 企业版感兴趣，想了解更多、获取报价或安排演示，请随时联系我们。

• 商务咨询与采购： 📧 bd@cherry-ai.com

🔗 相关项目

• new-api: 下一代 LLM（大型语言模型）网关和 AI 资产管理系统，支持多种语言。

• one-api: LLM API 管理和分发系统，支持 OpenAI、Azure 和 Anthropic 等主流模型。具有统一的 API 接口，适用于密钥管理和二次分发。

• Poe: Poe 让您在一个地方即可访问最好的 AI。探索 GPT-5、Claude Opus 4.1、DeepSeek-R1、Veo 3、ElevenLabs 以及数百万其他模型。

• ublacklist: 阻止特定网站出现在 Google 搜索结果中

🚀 贡献者

📊 GitHub 统计

⭐️ 星标历史

📜 许可证

Cherry Studio 社区版受标准的 GNU Affero 通用公共许可证 v3.0 (AGPL-3.0) 管辖，详见 https://www.gnu.org/licenses/agpl-3.0.html。

允许将 Cherry Studio 社区版用于商业目的，但须完全遵守 AGPL-3.0 许可证的条款和条件。

如果您需要免除 AGPL-3.0 要求的商业许可证，请通过 bd@cherry-ai.com 联系我们。

# Cherry Studio 快速上手指南

## 🧰 环境准备
- **系统要求**：Windows 10+/macOS 10.15+/Linux (Ubuntu 20.04+/Debian 11+)
- **前置依赖**：
  ```bash
  # 安装 Git（如需源码编译）
  sudo apt install git -y  # Ubuntu/Debian
  brew install git         # macOS

若使用本地模型（Ollama/LM Studio），需额外安装对应运行环境

🚀 安装步骤

1. 下载安装包（推荐使用国内镜像加速）：

   # GitHub 官方下载（替换 {version} 为实际版本号）
   curl -LO https://github.com/CherryHQ/cherry-studio/releases/download/v{version}/Cherry-Studio-Setup-{version}-x64.exe  # Windows
   curl -LO https://github.com/CherryHQ/cherry-studio/releases/download/v{version}/Cherry-Studio-{version}-x64.dmg      # macOS
   curl -LO https://github.com/CherryHQ/cherry-studio/releases/download/v{version}/Cherry-Studio-{version}-x86_64.AppImage # Linux
   

   国内用户可用 ghproxy.com 加速下载：

   # 示例：下载 Windows 安装包
   curl -LO https://ghproxy.com/github.com/CherryHQ/cherry-studio/releases/download/v{version}/Cherry-Studio-Setup-{version}-x64.exe
   

2. 安装：

   • Windows：运行 .exe 安装程序
   • macOS：将 .dmg 拖拽至 Applications 文件夹
   • Linux：赋予 AppImage 执行权限后运行

     chmod +x Cherry-Studio-{version}-x86_64.AppImage
     ./Cherry-Studio-{version}-x86_64.AppImage
     

🧪 基本使用

1. 启动应用：

   # 非必要无需命令行启动，直接运行桌面程序即可
   

2. 配置模型（以本地 Ollama 为例）：

   • 打开软件 → 点击右上角齿轮图标进入 Settings
   • 在 Model Providers 选择 Ollama
   • 设置模型路径（默认 http://localhost:11434）
   • 下载模型（如 Llama3）：

     ollama pull llama3
     

3. 开始对话：

   • 点击主界面 New Chat → 选择已配置的模型
   • 输入提示词（如 Hello, write a Python hello world）
   • 按 Ctrl+Enter 发送请求，等待模型响应

💡 快速体验云端模型：注册 DeepSeek 获取 API Key，配置到 Settings → Model Providers → DeepSeek 即可免部署使用

注：本指南基于 Cherry Studio v1.x 编写，具体版本请参考 [GitHub Releases](https://github.com/CherryHQ/cherry-studio/releases)。