# Cherry Studio V2 数据迁移：从 V1 完整备份后核对对话和知识库

本包仅在独立教学目录复制3份原创文本并对比SHA256；不是Cherry原生备份ZIP或V1/V2数据库。未读取用户资料、执行应用备份、迁移、恢复或知识库索引。

## 版本与门槛

官方固定V1.9.13→V2.0.2迁移路径；V2.1.x不能跳过兼容门禁。桌面客户端AGPL-3.0；需要足够空间保留原目录与备份，迁移不需要购买模型调用。

## 操作步骤

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原目录和全部备份。

## 本地参考与运行

本包仅在独立教学目录复制3份原创文本并对比SHA256；不是Cherry原生备份ZIP或V1/V2数据库。未读取用户资料、执行应用备份、迁移、恢复或知识库索引。

运行 `python3 verify.py` 检查材料；原生文档检查需要pypdf、openpyxl或lxml。需要重建参考时运行本包对应reference.py；这些脚本不调用模型。

## 官方来源

- https://docs.cherryai.com.cn/cherry-studio/installation/v1-to-v2-migration
- https://github.com/CherryHQ/cherry-studio/releases/tag/v2.0.2
- https://github.com/CherryHQ/cherry-studio/blob/v2.0.2/src/main/data/migration/v2/README.md
- https://github.com/CherryHQ/cherry-studio/blob/main/LICENSE

## 素材身份与许可

本站原创教学输入与参考代码采用CC0-1.0；官方截图仅用于识别软件和说明操作入口，其版权归相应项目。工具与模型许可分别按官方来源执行。请勿将人工/参考算法文件描述成目标软件或模型的实际结果。