Back to Cherry Studio

Skipping migration now discards data the failed run already migrated

v2-refactor-temp/docs/breaking-changes/2026-07-29-skip-migration-clears-migrated-data.md

2.0.01.7 KB
Original Source

What changed

The migration failure screen now provides a "Use V2 without importing V1 data" choice under More options. Selecting it no longer just marks migration finished: it first clears everything the migration had already written to the new database (including scheduled agent tasks) and starts v2 with default data. Original v1 data and any files already copied during the run are still left on disk.

Why this matters to the user

Migration commits each step independently, so a run that failed halfway left some data already imported. Previously, skipping at that point started v2 on top of those partial rows — a mix of imported and default data with no way to tell which was which. Now skipping always produces the same clean starting state, whether it is chosen before migration begins, on a version-incompatible install, or after a failure.

Users who skip after a partial failure will therefore no longer see the handful of assistants, settings, or conversations that happened to be imported before the error.

What the user should do

Nothing — automatic. The confirmation dialog states up front that already migrated records will be cleared, that v1 data is not deleted, and that migration will not be prompted again. It keeps its 10-second countdown before the confirm button becomes clickable, and can still be cancelled.

Users who would rather keep their data can choose Retry instead, or open More options and choose Continue using V1 to reach the v1 download page.

Notes for release manager

The skip action still never deletes the v1 data directory or the files copied during migration; those files simply have no reference in the v2 database. Worth pairing with any future release note about reclaiming that disk space.