升级与降级
根据当前版本和目标选择对应说明。V1 与 V2 使用不同的数据结构，跨大版本切换前必须先备份。
V2.0.2 升级与迁移
| 当前情况 | 应该怎么做 |
|---|---|
| 仍在 V1，需要保留数据 | 将 V1 更新到 1.9.13，再直接安装 V2.0.2 完成迁移。 |
| 已经在使用 V2 | 正常升级 V2.0.2，继续使用当前 V2 数据；不要点击【重新迁移】。 |
| 之前迁移 V1 失败或遗漏数据 | 完整备份当前 V2 后，才可在【设置】→【数据】使用【重新迁移】。 |
| 不需要 V1 数据 | 可以选择【忽略并使用默认值】，但 V1 数据不会迁入。 |
选择路径
破坏性更新提醒
先确认数据不互通、重新迁移和回退限制。
功能差异
了解界面、Agent、知识库等变化和升级后需要复核的项目。
V1 升级到 V2
备份 V1 数据，直接使用 V2.0.2 完成迁移。
V2 降级到 V1
返回原 V1 数据，并了解什么时候才需要处理 V2 数据库。
切换前准备
- 结束正在运行的对话、Agent、知识库导入和文件处理任务。
- 为当前版本创建一份新的完整备份，并保存在应用数据目录之外。
- 记录当前应用数据目录；使用自定义目录或外置磁盘时，确认路径可以正常访问。
下载入口
- Cherry Studio V2 官方下载
- Cherry Studio V1 官方下载
- V2.0.2 发布页：GitCode · GitHub