标签：向前兼容

没有服务端可以登入的迁移窗口，是离线产品的固有约束。本文以密旋科技 TagWorks 与 SlingGuard 的端侧登记册为样本，拆开一个 JSON 文件从落盘到被新版本读回的整条路径：可整体替换的快照与原子写、必填键与新增键的解码边界、属性默认值为什么不参与回填、枚举 rawValue 作为冻结存储格式、派生字段如何让一类变更不成为迁移，以及“保留原文件”与“静默返回”两种失败语义的代价。