企业官网建设流程全解析

5 分钟跑通 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

想在桌面端把云端大模型和本地 Ollama 模型收进同一个聊天框？Cherry Studio 是一款跨平台的 AI 生产力客户端，这份 Cherry Studio 安装教程带你从源码到启动只走 5 条命令。

📦 功能速览：三个值得装它的理由

• 多模型同框：OpenAI、Gemini、Anthropic 等云服务，加上本地 Ollama、LM Studio，全接进同一个对话，还支持多模型同时对话。
• 300+ 预配置助手：写作、翻译、编程场景开箱即用，也可以自己造一个。
• 文档级处理：PDF、Office、图片直接丢进对话；WebDAV 备份、Mermaid 图表、完整 Markdown 渲染都内置。

技术栈一句话带过：Electron + React + TypeScript，本地数据落在 SQLite，你不需要为客户端本身再配运行环境。

🧰 装前 30 秒自检清单

• Node.js 24.11.1（仓库engines锁定>=24.11.1 <24.16.0，.node-version就是标准答案）
• pnpm 11.8.0（corepack 会自动装对版本，不用手敲版本号）
• Git
• Windows 用户额外一步：开启开发者模式并设git config --global core.symlinks true，项目靠符号链接同步文件

环境确认无误，下面只剩 5 条命令。

⚡ 5 条命令跑通 Cherry Studio

拉代码：

git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio && cd cherry-studio

终端刷完克隆进度停在 Done，人已经在项目目录里。

解锁 pnpm：

corepack enable

没有任何报错输出，此时pnpm -v会显示 11.8.0，说明版本对上了。

复制环境模板：

cp .env.example .env

目录里多出.env文件，后续开发脚本靠它启动。

装依赖：

pnpm install

终端刷出一长串依赖下载进度，better-sqlite3 等原生模块会现场编译，最后以 Done 收尾，说明依赖就位。

启动：

pnpm dev

先重建数据库模块、再下载本地二进制依赖，随后 Cherry Studio 窗口弹出、看到主界面，它就跑起来了。

🩹 首次运行常见小状况

Q：pnpm install 报 Node 版本错误？版本没对上。用版本管理器先切版本，nvm install会自动读.node-version装 24.11.1，再重跑pnpm install。

Q：下载慢或超时？给终端配上代理，或把 npm registry 切到国内镜像再重试；pnpm dev里的download:binaries环节同样吃网络。

Q：Windows 上符号链接报错、目录结构不对？按 开发文档 开好开发者模式后重新克隆仓库即可。

🧭 下一步往哪走

• 想学调试与打包：读 开发文档，里面覆盖pnpm debug、各平台打包命令。
• 想看懂消息与 Provider 内部：从 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