Cherry Studio 快速上手：三步本地跑通这个 300+ 助手的 AI 桌面工作台
【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio
Cherry Studio 是一个跨平台的 LLM 桌面客户端，把 OpenAI、Gemini、Anthropic 等云端模型和 Ollama 本地模型收进同一个界面。想自己改配置、看源码或参与开发的开发者，跟着本文就能从零把它跑起来。
30秒认识它：一个客户端管住所有大模型
Cherry Studio 解决的核心问题是"模型太散"：云端 API、网页版 AI、本地 Ollama/LM Studio，你不用在十几个标签页之间来回切，一个窗口全部接入。它还内置了 300+ 预配置 AI 助手、MCP 工具服务器、WebDAV 云端备份和 Mermaid 图表渲染，开箱即用，无需额外环境配置。
底层都是谁：技术栈一张表看懂
| 技术 | 在 Cherry Studio 里的角色 |
|---|---|
| Electron | 构建 Windows / Mac / Linux 三端桌面壳 |
| React + TypeScript | 渲染层 UI 与全项目静态类型 |
| electron-vite | 本地开发与打包构建工具链 |
| pnpm | 唯一推荐的包管理器（版本已锁死） |
| better-sqlite3 | 本地数据库，存储会话与配置 |
消息在进程间如何流转，可以再看这张 Cherry Studio 的聊天管线图：
动手前：环境自检清单
按 官方开发文档 的要求，开始前确认下面几项：
- Git— 终端执行
git --version能打印版本号即可 - Node.js 24.11.1（要求
>=24.11.1 <24.16.0）— 建议用 nvm 管理，在项目目录执行nvm install会按.node-version自动装对版本；node -v确认 - pnpm 11.x— 版本锁在
package.json的packageManager字段，执行corepack enable后自动启用正确版本；pnpm -v确认 - 磁盘空间 ≥ 4GB— 依赖与二进制文件较多，
df -h（macOS/Linux）或"此电脑"（Windows）确认
三步跑起来
第 1 步：取代码，克隆 Cherry Studio 仓库
git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio进入目录：cd cherry-studio。看到终端没有报错、目录下出现src/、packages/等文件夹，说明克隆成功。
第 2 步：装依赖，一条命令搞定
pnpm install安装过程会自动触发原生模块（better-sqlite3）编译和子包构建，看到结尾出现Done in ...且无红色报错，说明依赖就绪。
第 3 步：启动开发模式
cp .env.example .env && pnpm dev等待几十秒后，会弹出一个 Cherry Studio 的 Electron 窗口：左侧是会话列表和助手库，主区域是聊天输入框——看到完整主界面，就跑通了。开发模式的数据目录会自动带Dev后缀，与你日后安装的正式版互不干扰。
卡住先看这里：三个高频问题
node -v版本不对或 pnpm 报版本错误：回到自检清单，nvm install和corepack enable重跑一遍，再执行pnpm install。better-sqlite3编译失败 / 启动后数据库打不开：通常是 Electron 原生模块没按当前环境重新编译，执行pnpm rebuild:electron后再pnpm dev即可（pnpm dev本身也会自动跑一次）。- Windows 克隆后文件缺失或符号链接报错：项目用 symlink 同步文件，需开启开发者模式并执行
git config --global core.symlinks true，然后重新克隆，详见 开发文档。
跑通只是开始：想改界面，从 渲染层源码 入手；想理解消息怎么从输入框流到各家大模型，AI 主进程逻辑 和 贡献者文档 是最好的两张地图。
【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
