展开本页目录
开始前准备什么
- 官方固定V1.9.13→V2.0.2迁移路径；V2.1.x不能跳过兼容门禁。桌面客户端AGPL-3.0；需要足够空间保留原目录与备份，迁移不需要购买模型调用。
- 本包仅在独立教学目录复制3份原创文本并对比SHA256；不是Cherry原生备份ZIP或V1/V2数据库。未读取用户资料、执行应用备份、迁移、恢复或知识库索引。
- 使用原创或获授权资料；实际目标工具运行记录与本包参考分别保存。
- 确认当前版本和是否真的需要迁移
- 停止任务并在V1做完整备份
- 完全退出后复制整个V1数据目录
- 使用V2.0.2读取原目录迁移
- 查看完成警告后重启
- 逐项找回会话和知识来源
- 先新建V2完整备份，再考虑重迁移
- 保存核对表与原件，恢复工作
原生输入、提示词、8步说明、独立参考和材料检查；运行范围见README。
区分目标工具操作、人工参考和本地实际执行。
本题独立原生输入或参考文件；身份和使用方法见README。
本题独立原生输入或参考文件；身份和使用方法见README。
1. 确认当前版本和是否真的需要迁移
在Cherry Studio查看实际版本。仍在V1且要保留数据才按本题；已经正常使用V2不要点击重新迁移。本题遵循官方V1.9.13→V2.0.2路线，不直接从V1跳到2.1.x。
2. 停止任务并在V1做完整备份
让对话、文件处理和知识库任务结束。在V1数据备份页关闭精简备份，创建完整备份并存到应用目录之外。备份完成后核对文件可读和容量，不能只拍一个备份按钮就说已保住数据。
3. 完全退出后复制整个V1数据目录
在数据设置确认自定义路径，彻底退出应用，再复制整个数据目录；不能只拷数据库。外置卷必须已挂载且可读写，源目录不可访问时不要随意改成默认目录继续。
4. 使用V2.0.2读取原目录迁移
获取官方匹配系统/芯片的V2.0.2，首次启动检查向导显示的来源目录再开始。向导读取V1原数据目录，不直接读取完整备份ZIP。迁移期间不关闭应用或断开外置盘。
5. 查看完成警告后重启
真实向导完成后展开警告信息再重启；失败先保留原数据和日志，根据官方重试/回V1路径处理。不把本包snapshot_reference.py的3文件复制输出当作原生迁移回执。
6. 逐项找回会话和知识来源
打开常用会话、知识来源和文件，核对内容标记、附件及有效索引；再查助手分组、默认模型和绑定权限。无需把全部来源都重建，官方说明有效索引可迁移，只处理失败来源。
7. 先新建V2完整备份，再考虑重迁移
确认结果后创建新的V2完整备份。重新迁移会永久删除当前V2数据，不会合并V1/V2；仅此前迁移失败/遗漏时，保留当前V2备份与新内容导出后按官方说明处理。
8. 保存核对表与原件，恢复工作
migration-checklist.csv逐项填写真实状态和证据位置。运行snapshot_reference.py仅演示教学目录复制和哈希比较，不验证Cherry兼容性；在应用实际检查通过前保留V1原目录和全部备份。
怎样确认已经完成
- 真实向导完成后展开警告信息再重启；失败先保留原数据和日志，根据官方重试/回V1路径处理。不把本包snapshot_reference.py的3文件复制输出当作原生迁移回执。
- 确认结果后创建新的V2完整备份。重新迁移会永久删除当前V2数据，不会合并V1/V2；仅此前迁移失败/遗漏时，保留当前V2备份与新内容导出后按官方说明处理。
- 本包仅在独立教学目录复制3份原创文本并对比SHA256；不是Cherry原生备份ZIP或V1/V2数据库。未读取用户资料、执行应用备份、迁移、恢复或知识库索引。
常见问题
Cherry Studio V2 数据迁移需要什么版本和条件？
官方固定V1.9.13→V2.0.2迁移路径；V2.1.x不能跳过兼容门禁。桌面客户端AGPL-3.0；需要足够空间保留原目录与备份，迁移不需要购买模型调用。
Cherry Studio升级以后聊天记录怎么保留，这份练习能证明哪些部分？
本包仅在独立教学目录复制3份原创文本并对比SHA256；不是Cherry原生备份ZIP或V1/V2数据库。未读取用户资料、执行应用备份、迁移、恢复或知识库索引。
V2升级先备份别丢知识库？
确认结果后创建新的V2完整备份。重新迁移会永久删除当前V2数据，不会合并V1/V2；仅此前迁移失败/遗漏时，保留当前V2备份与新内容导出后按官方说明处理。
Cherry Studio V1.9.13 V2.0.2 data migration backup custom directory 对应哪份可下载材料？
从本题独立练习包开始，先看migration-checklist.csv；按正文目标工具步骤生成自己的结果，不能把人工或参考算法文件改名当成模型输出。