Cherry Studio Windows / macOS / Linux 三平台安装指南

下载渠道

从 Cherry Studio 官方下载页获取对应平台和芯片的安装包。下载时注意区分：

• Apple Silicon Mac（M1/M2/M3/M4）：选 ARM64 / Apple Silicon 版本
• Intel Mac：选 x86_64 / Intel 版本
• Windows：通常是 x64 版本，旧的 32 位系统看官方支持情况
• Linux：选你的发行版对应的格式（Debian/Ubuntu 用 .deb，RedHat/Fedora 用 .rpm，通用用 .AppImage）

Windows 安装

1. 下载 .exe 安装包
2. 双击运行，可能会弹出 Windows SmartScreen 警告——这是因为官方签名刚注册，点「更多信息」→「仍要运行」即可
3. 按向导完成安装，默认路径是 C:\Users\<你>\AppData\Local\Programs\Cherry Studio
4. 安装完成后桌面和开始菜单都有快捷方式

Windows 上数据目录默认在 %APPDATA%\CherryStudio。

macOS 安装

1. 下载 .dmg 安装包
2. 双击打开 DMG，把 Cherry Studio 图标拖进「应用程序」文件夹
3. 第一次打开时 macOS 会提示"无法验证开发者"——点「系统设置」→「隐私与安全性」→ 拉到底部 →「仍要打开」
4. 右键应用 →「显示简介」→ 点「在隔离区」旁边的按钮可以移除隔离属性，之后就能正常双击打开

macOS 上数据目录默认在 ~/Library/Application Support/CherryStudio。

Apple Silicon 上如果想用 Rosetta 2 运行 Intel 版本，可以右键应用 →「显示简介」→ 勾上「使用 Rosetta 打开」。但官方建议直接用 Apple Silicon 原生版本。

Linux 安装

Ubuntu / Debian（.deb）

sudo dpkg -i cherry-studio_*.deb
sudo apt-get install -f  # 修复可能的依赖

Fedora / RHEL（.rpm）

sudo rpm -i cherry-studio-*.rpm

通用（.AppImage）

chmod +x CherryStudio-*.AppImage
./CherryStudio-*.AppImage

AppImage 不需要安装，直接运行，适合不想动系统包管理器的用户。数据目录默认在 ~/.config/CherryStudio。

Linux Wayland 注意

Wayland 模式下划词助手工具栏可能无法跟随选中文本定位（技术限制），建议用 X11 会话或切换到快捷键触发模式。

安装完成后做什么

能正常打开 Cherry Studio，即表示客户端安装完成。接下来：

1. 配置模型服务商（见 模型服务商统一管理）——或者用内置的免密钥模型先跑起来
2. 打开助手市场选一个预置角色开始对话（见 助手库预置角色）
3. 想让 AI 自主干活就跳去 Agent 工作区（见 Agent 工作区上手）

卸载

• Windows：设置 → 应用 → 找到 Cherry Studio → 卸载
• macOS：把应用程序文件夹里的 Cherry Studio 拖进废纸篓，再手动删除数据目录
• Linux：用对应包管理器卸载（sudo apt remove cherry-studio / sudo rpm -e cherry-studio）

⚠️ 卸载不会自动删除数据目录——助手配置、对话历史、知识库等还在。如果要彻底清理，手动删除数据目录。