NekoAnime v0.4.0 数据源大迁移：为什么旧数据全部失效
在 NekoAnime 的版本史上，2024 年 9 月 30 日发布的 v0.4.0 是一道分水岭：它让老用户的数据一夜清零，也让应用的播放可靠性上了新台阶。复盘这次「数据源大迁移」，能看懂这类应用的结构性风险。
事件背景：旧源失效
v0.4.0 的更新日志把变更说明放在最顶部：从这一版开始，应用切换到全新的樱花动漫数据源，原因是旧数据源出了问题（对应仓库 Issues 里的第 21 号讨论）。第三方资源站因为各种原因更换域名、调整结构乃至关停，是这类应用的常态——应用本身没法控制，只能跟着迁移。
代价：用户数据整体失效
日志原文很直白：「与旧数据源相关的所有用户数据（包括追番信息、番剧缓存、观看历史）都会失效，请先卸载后再安装新版本」。
为什么必须卸载？因为新旧源的数据结构完全对不上：旧源时代的番剧条目在新源里查无此人，硬保数据的结果是列表里全是加载失败的僵尸条目。先卸载再安装是干净利落的止损方案。
对用户来说，失效清单包括：
- 追番列表——需要按追番教程重新追一遍；
- 观看历史与进度记忆——回不去上次看到的位置了；
- 已缓存的番剧——全部作废，需要重新下载（好在缓存本来就可再生）。
补偿：两个硬功能随版上线
拆屋的同时也盖了新房，v0.4.0 带来：
- 播放线路自动切换——多线路自动匹配兜底，播放成功率显著提升，机制见线路自动切换；
- 支持播放缓存——为后来 v0.5.0 的离线缓存打了地基。
这次事件留下的经验
对用户，三条：
- 升级前必读更新日志——「数据源切换」四个字出现时，先截图追番列表再动手；
- 追番列表的价值在「重建成本低」：番名都是常见的，重新追一遍十几分钟的事，不必因噎废食；
- 长期缓存大量番剧有风险——存储换来的离线自由，在换源时可能一夜清零，缓存规模量力而行。
对理解这类应用，一条：数据源是所有第三方追番工具的共同命门——v0.4.0 的换源如此，v0.5.2 的源加密危机（见版本演进史）亦如此。用这类工具，就要接受「可用性随源波动」的现实。
之后再没发生过全量失效
值得一提的是，v0.4.0 之后的版本更新（v0.5.x 系列）都是平滑覆盖安装——数据源架构稳定后，类似的全量数据失效没有重演。这份稳定延续到了 v0.5.2。