Back to Cherry Studio

v1 migration can be run again

v2-refactor-temp/docs/breaking-changes/2026-08-06-rerun-v1-migration.md

2.0.2890 B
Original Source

What changed

Settings > Data now offers a rerun-migration action when retained v1 Redux data is detected. The action discards the current v2 data, then restarts into the existing migration flow.

Why this matters to the user

Users who need to recover data missed by an earlier v1 migration can migrate from their retained v1 sources again. Current v2 data is discarded, so a three-step wizard requires explicit risk acknowledgement, offers a full-backup shortcut, and asks for final confirmation.

What the user should do

Create a full backup if the current v2 data may be needed, review the warning, then confirm the rerun from Settings > Data.

Notes for release manager

The entry is shown when the exact persist:cherry-studio Local Storage key or CherryStudio IndexedDB database exists. Original v1 browser and filesystem sources are preserved for the next migration.