Animeko 缓存引擎重构的坑 - v5.3.1 升级注意事项
事情的经过
v5.3.1 版本更新日志里有这样一段（原文带感叹号）：
重构缓存引擎，全新缓存页面。！！更新会导致缓存失效，请提前备份！！
这不是普通的 bug 修复，是缓存底层实现的彻底重写——旧缓存格式和新引擎完全不兼容，升级后所有旧缓存会被自动清理，需要重新缓存。
影响范围
| 情况 | 影响 |
|---|---|
| 从 v5.3.0 及以前升级到 v5.3.1+ | 旧缓存全部丢失，需要重新缓存 |
| 已经在 v5.3.1+ 上 | 后续版本（v5.3.2 → v5.4.x → v5.5.x → v6.x）的升级不会再清缓存 |
| 新安装 v5.3.1+ | 不受影响，直接用新引擎 |
应对策略
| 场景 | 建议 |
|---|---|
| 手上有很多缓存没看完 | 先看完再升级。缓存重下可能需要很久（尤其冷门番） |
| 缓存不重要、重下也无所谓 | 直接升级，接受全部重新缓存 |
| 想"备份缓存然后迁移" | 行不通——格式不兼容，备份了新引擎也认不出来 |
为什么要重做缓存引擎
官方没有给出详细原因，但从 v5.3.1 后续几个版本的更新日志来看，旧缓存引擎确实有不少问题：
- v5.3.1 同时重做了缓存页面（说明页面和引擎一起改）
- v5.4.0 修复了「缓存页闪退、缓存消失」
- v5.4.0 修复了「iOS 缓存无法播放」和「Web 缓存视频元信息错误」
- 新引擎应该更稳定，修复了之前的多种 bug
后续还会有类似重构吗
目前来看不会。v5.3.1 之后的版本更新日志里没有再出现「缓存引擎重构」这类级别的变更——都是 bug 修复和功能小改。缓存引擎已经稳定下来了。
升级后缓存消失怎么办
如果你不小心直接升到了 v5.3.1+ 发现缓存全没了：
- 回版本恢复旧缓存？不行——新旧缓存格式不兼容，回版本也认不出来
- 接受事实，重新缓存需要的内容
- 下次升级前关注更新日志的「⚠️ 缓存可能失效」之类警告
给长期用户的建议
养成一个习惯：升级前扫一眼更新日志。重点看有没有：
- 缓存 / 数据相关的重大变更
- 需要手动操作的一次性步骤（比如 v4.x 升级 v5.0.1 需要重新 Bangumi 登录）
- 明确标注感叹号或 ⚠️ 的变更提示
Animeko 的更新日志写得很详细，重点变更都会提前标出来，花 30 秒扫一遍能省很多麻烦。