Cherry Studio 快速上手：三步本地跑通这个 300+ 助手的 AI 桌面工作台

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-studioCherry 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 -hmacOS/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），仅供参考