解决什么问题
Cherry Studio 迭代很快，新版本带来功能，也偶尔带来新问题；反过来，有人升级后想退回旧版，又怕把几百条聊天话题弄丢。这篇讲三件事：怎么更新、更新为什么通常不丢数据、想回退时怎么回退才安全。
一句话原则先记住：数据在用户目录，程序在安装目录，两者分开。更新只动后者；回退要防的是数据格式不向前兼容。
环境与版本
- Cherry Studio【待补：写作时最新版本号与本文实际验证的版本，以 GitHub Releases 页为准】；
- 版本号遵循语义化的”主.次.修订”格式，GitHub Releases 页每个版本一个 tag，附各平台的安装包；
- 各平台安装形态与数据的关系（数据目录位置是通用规则，均与本篇操作无关地独立存在）：
| 平台 | 安装形态 | 更新方式 | 回退方式 |
|---|---|---|---|
| Windows | exe 安装版 | 应用内或覆盖安装 | 旧版 exe 覆盖安装 |
| Windows | 便携版 | 解压新包到新目录 | 旧包目录直接可用 |
| macOS | dmg（arm64 / x64 两种包） | 覆盖 Applications | 旧 dmg 覆盖拖回 |
| Linux | AppImage / deb【待补：当前实际格式，以 Releases 页为准】 | 换新包 / 包管理器 | 旧包直接可用 |
安装版与便携版默认共用同一个用户数据目录，所以两形态互相切换也不动数据【待补：以官方文档对数据目录的说明为准】。
分步骤操作
第一步：常规更新（应用内）
设置里检查更新，或等更新提示弹出后确认，应用下载新安装包后重启完成覆盖安装【待补：检查更新入口的准确位置截图】。这套流程基于 Electron 生态通用的自动更新机制：客户端读取发布源上的最新版本元数据，发现新版本就下载安装包，重启时替换程序文件。Windows 覆盖安装只动安装目录，用户目录里的数据原样保留。
不放心就先做一次备份：数据设置里点一次本地备份，不挂知识库时数据目录通常在 500 MB 以内量级，本地盘对拷 60 秒内能完成，成本几乎为零。备份的完整操作见配置备份那篇。
第二步：手动更新（应用内更新失败时）
应用内更新从 GitHub 拉安装包，直连网络不稳时容易卡住或失败。手动方案三步：
- 打开官方 GitHub 仓库的 Releases 页，找到最新版本；
- 按平台选包：Windows 选 exe 安装版；macOS 按芯片选 arm64/x64 的 dmg；
- 下载后直接覆盖安装，数据不动。
Electron 桌面应用的安装包在 100 MB 量级，直连慢就挂代理或换时段。命令行下载示例（URL 从 Releases 页复制实际直链）：
Invoke-WebRequest -Uri "<Releases 页复制的 exe 直链>" -OutFile "$env:TEMP\cherry-studio-setup.exe"第三步：版本回退
回退的动机一般只有一个：新版本引入了影响日常使用的 bug，等修复等不及。安全回退的顺序：
- 先备份：完全退出应用，整目录拷一份（或应用内导出备份文件）：
robocopy "$env:APPDATA\CherryStudio" "D:\Backup\CherryStudio_pre_rollback" /E /R:1 /W:1- 到 Releases 页找目标旧版本，下载对应平台的安装包；
- 直接运行旧版安装包覆盖安装（Windows）；macOS 把 dmg 里的应用拖进 Applications 覆盖；
- 启动确认功能正常，再清理多余的备份。
关键风险只有一个：数据格式不向前兼容。如果新版本升级过本地数据结构，旧版程序读新版数据可能报错或丢字段【待补：实际兼容性表现与官方说明，以 Release Notes 为准】。所以回退前那份备份就是时间机器——真碰到兼容问题，删掉数据目录、恢复备份、再启动旧版，数据回到回退前一刻。
更新前后检查清单
更新不是点完”安装”就完事，前后各花两分钟，能省掉后面几小时的排查：
更新前：
- 看 Release Notes：有没有”破坏性变更""需要重新配置”字样；
- 记下当前版本号（设置关于页可见），出问题要回退时知道退到哪；
- 做一次备份（见上）。
更新后：
- 检查模型服务：随便发一条消息，确认密钥和网关配置还在、能正常回复；
- 检查助手与话题：数量对不对、历史内容能不能打开；
- 用到知识库和 MCP 的，各跑一次确认功能正常【待补：实际界面入口，以当前版本为准】。
常见坑
坑一：便携版用户把更新理解成覆盖解压。 覆盖解压到同一目录残留旧文件的风险比安装版高，更稳妥的做法是解压到全新目录再运行【待补：便携版更新的官方建议，以官方文档为准】。数据目录与便携目录位置无关，换目录不丢数据。
坑二：回退前不备份。 万一旧版把新版数据写坏，就是”两头都回不去”。顺序永远是：备份 → 装旧版 → 确认能正常启动和读取 → 再清理。
坑三：关了自动更新就再也不更。 想稳定可以关自动检查【待补：开关的准确位置】，但别关了就忘。隔好几个版本再升级属于跨级更新，动手前先看 Release Notes 里的破坏性变更说明。
坑四：macOS 下载错芯片的包。 Apple Silicon 机器装成 Intel 包要走转译，性能打折甚至无法启动；dmg 文件名里的 arm64/aarch64 对应 Apple 芯片，x64 对应 Intel。装错了删掉重拖对应架构的包即可。
坑五：把”重装应用”当成”清空数据”。 有人想通过卸载重装解决疑难杂症，其实卸载默认不动用户目录，重装完数据还在；反过来也别以为卸载等于清空——想让下一台电脑上没有你的聊天记录，得去删数据目录。
最终效果
更新流程理顺之后：日常应用内一键更新，失败时手动覆盖安装兜底；每次动手前留一份备份，出任何问题都能回到”上一个能用的状态”。记住分工——更新只是换程序，你的助手、话题、密钥都住在用户目录里，程序怎么换它们都不动。