破坏性更新提醒
V2 不是普通的覆盖更新。它更换了数据结构，也调整了助手、Agent、知识库、网络搜索和文件等功能的入口与行为。
V2.0.2 可以直接迁移 V1
需要保留 V1 数据时，按 V1.9.13 → V2.0.2（直接完成数据迁移） 操作，不再需要 V2.0.0 中转。
| 当前情况 | 应该怎么做 |
|---|---|
| 仍在 V1，需要保留数据 | 将 V1 更新到 1.9.13，完整备份后直接安装 V2.0.2。 |
| 已经在使用 V2 | 正常升级 V2.0.2，继续使用当前 V2 数据。 |
| 之前迁移 V1 失败或遗漏数据 | 先完整备份当前 V2，再考虑使用【重新迁移】。 |
| 不需要 V1 数据 | 可以选择【忽略并使用默认值】，但 V1 数据不会迁入。 |
升级前必须完成
- 将 V1 更新到 1.9.13，并至少正常启动一次。
- 关闭【精简备份】，创建 V1 完整备份。
- 完全退出 Cherry Studio，再复制整个 V1 数据目录。
- 使用自定义目录或外置磁盘时，确认路径已挂载且可以读写。
迁移向导读取当前 V1 数据目录，不读取备份 ZIP。备份用于意外恢复，不能代替原数据目录参与迁移。
【重新迁移】不是数据合并
V2.0.2 在【设置】→【数据】中增加【重新迁移】。它只用于修复此前 V1 迁移失败或遗漏数据的情况。
操作前会要求确认以下事项：
- 当前 V2 数据将被永久删除，且无法撤销。
- 原始 V1 数据会保留，并在重启后重新导入。
- 必须先为当前 V2 创建完整备份。
完整备份不会让 V1 与 V2 数据自动合并。需要保留的 V2 新内容，请先单独导出或保留完整备份。
升级后重点检查
- 模型服务、API Key 和默认模型；Anthropic OAuth 不会迁移，需要改用 API Key。
- 助手分组、提示词顺序、Agent 工具权限和知识库绑定。
- 知识库失败来源、网络搜索的关键词搜索与网址读取服务。
- 自定义 CSS、侧栏收藏和缺失文件。
完整对照见 【功能差异】。
迁移失败或需要回退
- 优先使用【重试】，修复数据目录、磁盘或数据问题后继续。
- 【保存问题信息】只会保存到本地；文件可能包含路径、内容或凭据，只提供给 Cherry Studio 支持团队。
- 【忽略并使用默认值】会从默认配置开始，V1 数据不会迁入。
- 正常返回 V1 不需要删除数据库，也不要把 V2 备份恢复到 V1。