GitShelf — GitHub 项目目录

项目概述

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 下载对应平台的安装包（Windows、macOS、Linux），安装后即可使用，无需额外环境配置。

开发者环境

# 安装依赖
pnpm install

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

# 启动开发模式
pnpm dev

# 运行测试
pnpm test

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

典型使用方法

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

配置与部署要点

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

限制、风险与许可证

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

官方链接

信息来源和分析时间

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

CherryHQ/cherry-studio

项目概览