Cherry Studio LLM 桌面客户端安装完全指南三步跑起来【免费下载链接】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 桌面客户端把 300 多个 AI 助手、云端模型和本地模型装进同一个窗口。下面带你把它跑起来。这个项目到底能干什么Cherry Studio 是一个 AI 生产力桌面应用接入 OpenAI、Gemini、Anthropic 等云服务或者 Ollama、LM Studio 这类本地模型对话、知识库、话题都在同一个地方管理。它还带 WebDAV 备份、Mermaid 图表渲染和 MCP 服务器支持。适用平台Windows、macOS、Linux。技术作用Electron桌面应用框架提供跨平台窗口与原生能力React 19渲染进程 UI 框架负责聊天面板、设置页等界面TypeScript主进程与渲染进程的统一开发语言pnpm Workspaces管理packages/下多个子包的 monorepo 方案better-sqlite3本地数据库存放会话与配置electron-vite构建与启动工具串起编译、热更新和打包点火前检查单必备工具推荐版本一句验证命令Node.js24.x≥24.11.1node -vpnpm11.8.0corepack 自动锁定pnpm -vGit任意较新版本git --version⚠️ 项目用.node-version把 Node 锁在 24.11.1装常见的 18/20 LTS 会直接起不来建议用 nvm 或 fnm 管理版本。三步跑起来第一步把源码放到本地在一个空目录里执行下面这条命令然后进入项目git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio cd cherry-studio终端里应该能看到package.json、electron.vite.config.ts这些项目文件。Windows 用户注意先开启「开发者模式」并执行git config --global core.symlinks true否则部分符号链接文件会拉不下来。第二步备齐 Node 和依赖pnpm 版本写在package.json的packageManager字段里corepack 会直接按这个版本提供不用手动装。接着安装依赖nvm use corepack enable pnpm install安装结束后项目根目录会出现node_modules终端末尾还能看到 postinstall 自动构建dsh-bridge子包的过程。第三步复制配置并点火项目自带示例环境变量拷一份再启动开发模式cp .env.example .env pnpm devWindows 上把第一行换成copy .env.example .env。第一次pnpm dev会比较慢它要先重新编译 better-sqlite3 原生模块、下载运行时二进制。等它跑完一个标题为 Cherry Studio 的 Electron 窗口会弹出来。没跑起来看这里npm install报一大串错这是 pnpm monorepo不支持 npm 或 yarn 安装。已经装乱的话删掉node_modules回到第二步用pnpm install重来一遍即可。pnpm install网络超时或卡在下载依赖和 Electron 二进制大多走 npm 仓库先原样重跑一次持续失败就给 npm 配置一个国内镜像源再试。pnpm dev阶段的download-binaries步骤同理超时重试或换网络。窗口打开是空白、或 better-sqlite3 编译报错原生模块要针对当前 Node 和 Electron 版本重编重跑一次pnpm rebuild:electronpnpm dev本身就包含这步仍报错就检查 Node 是否落在 24.11.1 至 24.15 的区间内。跑起来之后窗口起来后先去设置页填一个 API Key、挑个默认模型就能和预置助手开聊了。想弄清一条消息从输入框到本地数据库走了哪些环节仓库里的架构图已经画好更多细节可以看 开发指南 docs/contrib/development.md以及 消息生命周期图。源码都摊在这里了接下来怎么玩由你定。【免费下载链接】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），仅供参考