V1 升级到 V2

根据当前情况选择

当前情况	操作
仍在 V1，需要保留数据	将 V1 更新到 1.9.13，按本页步骤直接安装 V2.0.2。
已经在使用 V2	正常升级 V2.0.2，继续使用当前 V2 数据；不要点击【重新迁移】。
之前迁移 V1 失败或遗漏数据	完整备份当前 V2 后，才可使用【重新迁移】从 V1 重新开始。
不需要 V1 数据	可以选择【忽略并使用默认值】，从默认配置开始；V1 数据不会迁入。

将 V1 更新到 1.9.13。在数据备份页面关闭【精简备份】，创建完整备份，并把备份保存在应用数据目录之外。

在 V1 的数据设置中确认目录位置，完全退出 Cherry Studio 后复制整个目录。不要只复制数据库文件。

使用移动硬盘、网络卷或其他自定义位置时，确认路径已挂载且可读写。路径不可访问时不要改用默认目录继续迁移。

从 V2 官方下载获取匹配系统和芯片的 V2.0.2 安装包，也可以使用 GitCode 发布页或 GitHub 发布页。完全退出 V1 后安装并启动。

核对向导显示的数据位置，再选择【开始迁移】。迁移期间不要关闭应用、移动数据目录或断开外置磁盘。

迁移完成后先展开警告信息，再选择【重启应用】。

更多入口变化见【功能差异】。

如果此前 V1 迁移失败或遗漏数据，V2.0.2 可在【设置】→【数据】选择【重新迁移】。该操作会重启应用，并从保留的 V1 数据重新执行迁移。

选项	什么时候用	注意事项
【重试】	修复目录、磁盘或临时数据问题后	优先选择，不会退出迁移流程。
【保存问题信息】	重试仍失败，需要求助	文件只保存到本地，可能包含路径、内容或凭据，只提供给 Cherry Studio 支持团队。
【忽略并使用默认值】	明确放弃导入 V1 数据	清除本次已写入的部分 V2 数据并从默认配置开始；之后不再自动提示迁移。
【继续使用 V1】	暂时无法迁移，需要恢复工作	重新安装 V1 并继续使用原 V1 数据目录。

只有 V1 备份 ZIP，可以直接迁移吗？

不可以。先在兼容的 V1 中恢复并确认数据正常，再保留完整数据目录，然后启动 V2 迁移。

知识库都要重建索引吗？

不需要。有效索引会迁移；只处理显示失败、缺少嵌入模型或无法读取的来源。