迁移指南
本节汇总跨版本、跨框架、跨适配器与跨插件的迁移操作。按你的场景选择：
- v0 → 1.0 升级：破坏性变更清单与升级步骤
- 框架绑定迁移：Angular / React / Vue 之间或版本升级
- 适配器切换与数据迁移：更换存储后端
- Supabase 传输失败错误类型迁移：连不上远端时改抛 core 的
NetworkOfflineError，请用isNetworkError判离线 - HTTP 适配器翻页键改名：
ctx.cursor→ctx.pageToken、nextCursor→nextPageToken，与 core 的 keyset 游标区分开 - 桌面适配器拆包：
rxdb-adapter-desktop拆成-electron/-tauri两个包 - 工作树拆包：工作树与提交历史从核心拆成
@aiao/rxdb-plugin-working-tree，能力守卫取代版本号锁 - 树结构拆包：树实体、
TreeRepository与增量 merge 从核心拆成@aiao/rxdb-plugin-tree，四个树 hook 搬进@aiao/rxdb-plugin-tree-{angular,react,vue} - 插件升级与启用：启用/升级插件（如全文搜索）
- 插件作用域契约迁移：
install(scope)新契约、destroy()废弃与随之而来的行为变化 - 历史与同步拆包：历史/分支搬进
@aiao/rxdb-plugin-history、推拉同步搬进@aiao/rxdb-plugin-sync，同步方法从versionManager移到syncManager - QueryCache 读引擎拆包：
SyncType.QueryCache的读路径搬进@aiao/rxdb-plugin-querycache，用到该策略须装齐 history + sync + querycache 三个包 RemoteSyncOptions移除：孤立类型删除，冲突解决器改经PullOptions.conflictResolver传入，autoSync无替代- 跨 realm writer lease 移除：16 个 writer lease / upgrade guard 符号删除且无替代，跨 realm 排他交给发布系统
RxDBBranch去树化：分支系统表不再是树实体，四个树查询方法与RxDBBranchTreeRuleGroup移除，表结构不变- 生成器
default语义迁移：函数default从静默丢弃改为生成期报错，bigint /Uint8Array/Date不再被改写 - Schema 迁移：实体结构变更时的数据迁移
版本策略与兼容承诺见版本与 API 稳定性策略，各包版本对应关系见兼容矩阵。