十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Cherry Studio 安装与配置完整指南:从零跑通这个 AI 聊天桌面客户端

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 是一款支持 300 个 AI 助手的跨平台 AI 生产力桌面应用OpenAI、Gemini、Anthropic 等云端模型和 Ollama、LM Studio 本地模型都能接进来。这篇文章带你在一台干净的机器上把源码装好并启动它只需要最基本的命令行操作。Cherry Studio 使用场景它上手就能干的三件事多模型对比同一个问题同时发给多个模型并排对比输出帮你快速判断哪个模型适合手头的任务。本地模型更省心电脑上跑着 Ollama 或 LM Studio 的话直接指向它提示词和文件都不用离开本机。不只是聊天框PDF、Office 文档、图片可以直接丢进去问答还内置了翻译和 Mermaid 图表渲染。技术上只说一句它是 Electron React TypeScript 构建的桌面应用装好 Node.js 就能编译运行。Cherry Studio 安装前环境自检先备齐这 3 样对照下面清单检查一遍缺哪个补哪个。依赖版本建议说明Node.js24.11.1项目锁定在 24.11.1 ~ 24.15 之间编译工具链pnpm11.8.0装依赖用corepack 自动管理版本Git任意较新版本拉取仓库项目是 pnpm monorepo所以本文只走 pnpm 这条路你习惯 npm 或 yarn 也可以了解但这里不展开。版本管理推荐用 nvmfnm 也行下一步就要用到。如果你是 Windows还需要提前开启开发者模式因为仓库里用了符号链接详见 docs/contrib/development.md。Cherry Studio 开发环境搭建六条命令跑起来把仓库拉到本地先拿到源码后面所有命令都在这个目录里执行。git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio cd cherry-studio执行后当前目录下能看到package.json、electron.vite.config.ts等文件说明仓库完整。切到 Node.js 24.11.1项目把版本写死在.node-version文件里Node 版本不对后面的原生模块会编译失败。nvm install nvm use 24.11.1nvm use执行完终端会提示Running node v24.11.1。用 corepack 启用 pnpmpackage.json里锁定了 pnpm 11.8.0开启 corepack 后它会自动下载对应版本不用手动装。corepack enable执行pnpm -v能看到版本号说明已生效。安装项目依赖pnpm install这一步耗时最长几分钟正常。执行完会滚动安装进度最后打印Done。创建本地配置文件把模板复制成.env以后你的模型 API Key 就填在这里。cp .env.example .env启动开发服务pnpm dev首次启动会自动下载辅助二进制文件稍慢属正常现象。完成后会弹出 Cherry Studio 的桌面窗口且本地数据目录带Dev后缀不会和正式安装的版本混在一起。Cherry Studio 首次启动成功标志与新手常踩的 3 个坑✅成功标志Electron 窗口打开看到 Cherry Studio 的界面。进设置页添加一个服务商、填上 API Key就能发出第一条消息。⚠️常见的坑better-sqlite3 等原生模块报编译错误几乎都是 Node 版本不对。重新执行nvm use 24.11.1再跑一次pnpm install。Windows 克隆时符号链接报错开启开发者模式并执行git config --global core.symlinks true然后重新克隆。pnpm dev长时间卡住首次启动在下载二进制网络差会卡在进度上。耐心等或手动执行node scripts/download-binaries.js再启动。绕过这三个坑之后日常开发基本不会再报环境类错误。写在最后clone、切版本、装依赖、启动六条命令之后你桌面就多了一个可以接任意大模型的 AI 聊天客户端。想继续深入可以读 docs/contrib/development.md 里的完整开发约定或翻翻 docs/ 下的架构文档。【免费下载链接】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),仅供参考
返回列表