cherry-studio

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 一台可正常联网的桌面电脑（Windows / macOS / Linux）
• 可访问 GitHub Releases 页面或官网 cherryai.com
• 已准备好所接入大模型服务的 API Key
• 如需参与源码开发，需按 docs/contrib/development.md 准备开发环境

安装与启动步骤

1. 1下载安装包

   README 未给出安装命令，需打开 GitHub Releases 页面，挑选与你的操作系统匹配的安装包下载。

2. 2安装并启动

   运行已下载的安装包按提示完成安装，然后双击启动 Cherry Studio 桌面客户端。

3. 3接入模型服务

   在客户端中添加你使用的 LLM 服务商并填入对应 API Key，即可开始多模型对话。

4. 4查阅官方文档

   遇到界面功能、配置项或使用疑问时，访问官方文档站点核对最新说明。

5. 5克隆源码（可选）

   想参与开发，先 Fork 仓库再克隆到本地，随后参照开发文档搭建环境。

   git clone https://github.com/CherryHQ/cherry-studio.git
   cd cherry-studio

   复制

6. 6提交改动（可选）

   新建分支完成修改，提交推送后在 GitHub 发起 Pull Request 并说明改动与原因。

   git checkout -b feature/my-change
   git commit -m "describe your change"
   git push origin feature/my-change

   复制

关键配置

如何确认成功

安装包正常执行完毕，Cherry Studio 桌面窗口能成功打开并进入主界面。

常见问题

注意事项

• README 节选中没有安装步骤，本教程的安装部分依据其 Releases 链接与项目形态推断，具体以官方文档为准。
• 官方文档地址为 docs.cherry-ai.com，二次开发说明见仓库内 docs/contrib/development.md。
• 提交 PR 前请阅读 CONTRIBUTING.md，按其指引组织提交内容。