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