## 项目概述

Cherry Studio 是一款跨平台（Windows、Mac、Linux）的桌面 AI 生产力客户端，支持多种 LLM 提供商（如 OpenAI、Gemini、Anthropic 等），提供智能聊天、自主智能体、300+ 预配置 AI 助手，并统一访问前沿大模型。项目采用 AGPL-3.0 许可证，社区版开源，并提供企业版。

## 核心功能

- **多 LLM 提供商支持**：集成 OpenAI、Gemini、Anthropic 等云服务，支持 Claude、Perplexity、Poe 等 AI 网络服务，以及 Ollama、LM Studio 本地模型。
- **AI 助手与对话**：提供 300+ 预配置 AI 助手，支持自定义助手创建和多模型同时对话。
- **文档与数据处理**：支持文本、图片、Office、PDF 等文件，提供 WebDAV 文件管理和备份、Mermaid 图表可视化、代码语法高亮。
- **实用工具集成**：全局搜索、主题管理、AI 翻译、拖拽排序、小程序支持、MCP（Model Context Protocol）服务器。
- **增强用户体验**：跨平台支持、开箱即用、明暗主题和透明窗口、完整 Markdown 渲染、内容分享。

## 适用与不适用场景

**适用场景：**

- 需要统一管理多个 LLM 提供商 API 的个人用户或开发者。
- 需要本地部署、数据隐私要求高的企业或团队。
- 需要智能体（Agent）和技能（Skills）进行自动化任务处理的场景。
- 需要跨平台桌面客户端进行 AI 对话和文档处理的用户。

**不适用场景：**

- 需要移动端（iOS/Android）原生应用的用户（目前仅规划中）。
- 需要完全离线运行、不依赖任何云服务的场景（本地模型支持有限）。
- 需要商业许可证豁免 AGPL-3.0 限制的企业（需联系购买企业版）。

## 技术架构与依赖

- **语言**：TypeScript
- **框架**：Electron（桌面客户端）
- **AI 集成**：AI SDK（@ai-sdk/*）、Claude Code、DeepSeek Harness、Pi 等运行时
- **数据存储**：SQLite（通过 better-sqlite3）
- **包管理**：pnpm
- **构建工具**：electron-builder
- **其他**：MCP（Model Context Protocol）、OTel 追踪、WebDAV

## 安装与快速开始

### 用户安装

从 [GitHub Releases](https://github.com/CherryHQ/cherry-studio/releases) 下载对应平台的安装包（Windows、macOS、Linux），安装后即可使用，无需额外环境配置。

### 开发者环境

```bash
# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env

# 启动开发模式
pnpm dev

# 运行测试
pnpm test

# 构建（按平台）
pnpm build:win  # Windows
pnpm build:mac  # macOS
pnpm build:linux # Linux
```

## 典型使用方法

1. **配置模型提供商**：在设置中添加 OpenAI、Anthropic 等 API 密钥，或配置本地 Ollama 服务。
2. **创建或选择助手**：从 300+ 预配置助手中选择，或创建自定义助手。
3. **开始对话**：在聊天界面输入消息，支持多模型同时对话。
4. **使用智能体**：创建 Agent 会话，利用 Claude Code、Pi 等运行时执行复杂任务。
5. **管理文档**：上传文件进行问答，使用 WebDAV 备份数据。

## 配置与部署要点

- **更新机制**：客户端通过 `https://releases.cherry-ai.com` 检查更新，支持 latest、rc、beta 三个渠道。
- **数据存储**：使用 SQLite 存储消息、配置等数据，支持 WebDAV 备份。
- **企业版部署**：支持私有化部署，提供统一模型管理、知识库、访问控制等功能。
- **开发配置**：Windows 开发需启用符号链接支持；Node.js 版本见 `.node-version`。

## 限制、风险与许可证

- **许可证**：社区版采用 AGPL-3.0 许可证，商业使用需遵守其条款；如需豁免，可联系购买商业许可证。
- **数据安全**：本地数据存储，但云服务调用会发送数据至第三方提供商，需注意隐私风险。
- **平台限制**：目前仅支持桌面端，移动端应用尚在规划中。
- **测试版风险**：测试计划（RC/Beta）版本可能不稳定，使用前需备份数据。

## 官方链接

- [GitHub 仓库](https://github.com/CherryHQ/cherry-studio)
- [官方网站](https://cherry-ai.com)
- [官方文档](https://docs.cherry-ai.com/docs/en-us)
- [GitHub Releases](https://github.com/CherryHQ/cherry-studio/releases)
- [Telegram 群组](https://t.me/CherryStudioAI)
- [Discord](https://discord.gg/wez8HtpxqQ)

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README、文档目录、贡献指南、开发文档、AI 参考文档等。
- 分析时间：2026-08-19（基于最新 Release v2.0.8 发布时间）