Cherry Studio 项目介绍

项目定位

Cherry Studio 是一款面向内容创作者的 AI 桌面客户端，支持 Windows、Mac 和 Linux 三大平台。它的核心价值在于：无需配置环境即可开箱使用，同时集成 20+ 主流 LLM 提供商于一处。

核心能力

多 LLM 提供商支持 — OpenAI、Anthropic、Google、Gemini、Ollama、Perplexity、Poe、Claude 等，以及通过 Vercel AI SDK v5 接入的 Bedrock、Vertex、Mistral、xAI、HuggingFace、OpenRouter、Cerebras、Copilot 等
AI 助手与对话 — 300+ 预配置 AI 助手，支持自定义助手创建与多模型同时对话
MCP 协议集成 — 完整的 Model Context Protocol 客户端实现，支持 Stdio/SSE/StreamableHTTP 三种传输方式，内置 OAuth 认证
知识库与 RAG — 基于自研 @cherrystudio/embedjs 的 RAG 引擎，支持文件、目录、URL、站点地图等多种数据源
记忆系统 — 基于 SQLite + 向量嵌入的全局记忆，支持语义搜索与用户级隔离
多窗口架构 — 主窗口、悬浮小窗、选中文本工具栏、MCP Trace 查看器等多窗口协同
实用工具 — WebDAV 备份、代码高亮、Mermaid 图表、AI 翻译、OCR、Telegram 集成等

技术栈

层级	技术
运行时	Electron 41, Node ≥24
前端	React 19, TypeScript ~5.8
UI	Ant Design 5.27, styled-components 6, TailwindCSS v4
状态管理	Redux Toolkit, redux-persist, Dexie (IndexedDB)
AI SDK	Vercel AI SDK v5 (`ai`), `@cherrystudio/ai-core` 自封装
构建	electron-vite 5 + rolldown-vite 7 (experimental)
测试	Vitest 3 (单元), Playwright (E2E)
数据库 (主进程)	Drizzle ORM + LibSQL (SQLite)
数据库 (渲染进程)	Dexie (IndexedDB)
MCP	`@modelcontextprotocol/sdk` 1.27.1
日志	Winston + winston-daily-rotate-file
追踪	OpenTelemetry
国际化	i18next + react-i18next
包管理	pnpm monorepo (workspace)

架构概览

快速体验

# 前提: Node.js >= 24, pnpm >= 10.27.0

# 1. 克隆项目
git clone https://github.com/CherryHQ/cherry-studio.git
cd cherry-studio

# 2. 安装依赖
pnpm install

# 3. 启动开发模式（热重载）
pnpm dev

# 4. 调试模式（Chrome DevTools 连接端口 9222）
pnpm debug

零环境配置：Cherry Studio 作为桌面应用分发，普通用户直接下载安装包即可使用，无需配置 Python 环境、API Key 以外的任何依赖。

教程导读

本教程从 Cherry Studio 源码中提炼两类知识：

AI 应用通用知识（从项目抽象）

章节	知识点	与 Common 的关系
01	Vercel AI SDK v5 多 Provider 架构	补充 — 现有 common 教程未覆盖 AI SDK v5 HubProvider 模式
02	MCP 协议深度集成	引用 — 已有 MCP 协议
03	RAG 知识库系统	补充 — 已有 RAG 通用原理，需补充 embedjs 具体实现
04	向量记忆系统	引用 — 已有记忆系统
05	工具调用与安全权限	引用 — 已有工具调用

编程核心技术（项目工程实践）

章节	知识点
01	Electron 三进程安全架构
02	多窗口架构与生命周期管理
03	DXT 插件系统与路径安全校验
04	状态管理与数据迁移策略
05	electron-vite 多入口构建管线
06	国际化与硬编码检测

引用的 Common 教程

本教程中的 AI 通用知识部分引用以下 Common 教程：