Cherry Studio 快速上手：多模型 AI 聊天桌面客户端，本地完整跑起来

Cherry Studio 快速上手多模型 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 是一款跨 Windows、macOS、Linux 的桌面 AI 客户端基于 Electron 构建统一接入 OpenAI、Gemini、Anthropic 等云端模型与 Ollama、LM Studio 本地模型内置 300 现成助手。本文带你把源码从零跑起来。适合谁、能做什么️一个窗口切换所有模型不想在多个网页后台之间来回登录把 OpenAI、Gemini、Anthropic、DeepSeek 等云端服务和 Ollama、LM Studio 本地模型装进同一个客户端随选随用。喂文件、查资料、做研究把 PDF、Office、图片直接丢给 AI 问答还能让它调用联网搜索和知识库检索通过 MCP 工具扩展适合整理资料和写长文。直接用现成角色内置 300 预配置助手翻译、写作、编程等也能自己定义一个专属助手。离线也能跑这是一个跨平台的桌面应用基于 Electron支持 Windows / macOS / Linux接上本地模型后不依赖外网。动手前先检查这些依赖要求版本没装 / 不对怎么确认和补上Node.js24.11.1需 ≥24.11.1 且 24.16.0终端跑node -v看版本不对就用 nvm 管理器nvm install会按项目里的.node-version自动装到 24.11.1pnpm11.8.0跑pnpm -v确认没有就先corepack enableNode 自带会自动对齐到锁定版本Git任意近期版本git --version确认没有去 Git 官网下载安装Windows 额外一步—项目用符号链接同步文件Windows 需先开「开发者模式」并执行git config --global core.symlinks true再克隆否则个别文件缺失把它跑起来先拿到源码并把运行环境对齐到项目锁定的版本——这几条命令一次跑完即可。git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio cd cherry-studio nvm install # 按 .node-version 装 Node 24.11.1 corepack enable # 激活锁定的 pnpm 11.8.0 pnpm install # 拉全部依赖并重建 better-sqlite3 等原生模块pnpm install会自动触发postinstall和原生模块重建所以不用你手动编译。本项目是 pnpm monorepo依赖里含workspace:*换用 npm 或 yarn 会装错依赖统一走 pnpm。接着给它一份模型配置应用才知道去调哪个模型。cp .env.example .env # Windows 用 copy .env.example .env打开.env把API_KEY、BASE_URL、MODEL换成你实际用的模型服务信息。最后启动Cherry Studio 的窗口就会弹出来。pnpm devpnpm dev会先重建原生模块、下载附带二进制再启动开发实例看到桌面窗口即成功。跑起来之后先看这几处窗口打开后先在设置里把模型服务商接上也就是.env里配的那套或界面里新增选个默认模型就能在对话区开聊。想搞懂「一条消息背后发生了什么」看这张时序图——大模型回复、联网搜索、知识库检索、MCP 工具是并行分步完成的图一次对话里大模型、知识库、网络搜索和 MCP 工具如何分步协作对应界面里的「外部工具」入口。除了聊天它还内置 AI 绘画模板下面这张水彩风海报就是内置模板能产出的风格图内置绘画模板的生成效果可在「绘画」功能里直接套用。想继续深入这几个入口值得点进去全局功能与架构官方文档开发环境、打包与调试命令开发指南模型与服务商接入的实现AI 管线源码常见卡点启动报 Node 版本不兼容或直接崩溃→ 多半是 Node 不在 24.11.1nvm install切到项目锁定版本后再nvm use。pnpm命令找不到→ 先执行corepack enable让 Node 自带的 corepack 激活锁定的 pnpm 11.8.0。窗口出来了却没法对话、没有模型可选→ 说明.env没配好复制.env.example为.env并填上API_KEY、BASE_URL、MODEL再重新pnpm dev。跑通之后建议顺着官方文档把 MCP 服务器、知识库和 WebDAV 备份这几块点出来各试一遍打算改代码的话从开发指南里的打包与调试流程入手配合项目的贡献指南提交你的第一个 PR。【免费下载链接】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），仅供参考