故障排除
数据同步 / 缓存问题
收藏数据看起来不是最新的，或者分析图表没有反映最近的变化
常见现象
- 在 B 站官网刚收藏的视频在扩展里看不到；
- 移动过视频之后，回到扩展发现还是旧状态；
- 分析页面上的分类占比没更新。
背后原理
为了减轻对 Bilibili 接口的压力，扩展对 收藏夹视频列表 做了 浏览器本地缓存：
- 缓存存储在
localStorage，以fav-list-cache:<收藏夹 ID>为 key； - 每条缓存记录包含
data（视频列表）与timestamp（写入时间戳）； - 默认有效期为 20 分钟；过期的记录在下次读取时会被自动删除并重新拉取；
- 同一收藏夹的并发请求会共享同一个
Promise，避免重复发起。
此外，扩展在移动视频（包括拖拽、关键字整理、AI 整理）完成后，会同步更新 源 / 目标收藏夹的本地缓存，不需要你手动刷新即可看到变化。
标准排查流程
先给扩展一点时间
如果你刚在 B 站官网做了收藏或移动操作，扩展端可能仍处于缓存有效期内。等待几分钟后再试；若急需最新数据，进入下一步。
使用弹窗顶部的「刷新」按钮
弹窗右上角有 刷新 图标，点击后会 reload 弹窗页面，触发扩展重新发起对 B 站接口的请求（但 不会清空 localStorage 缓存；若缓存仍在有效期内，仍会读到旧数据）。
清空 localStorage 缓存
按 弹窗右键 → 检查，切到 Application → Local Storage，删除所有以 fav-list-cache: 开头的条目，然后再次打开弹窗。
确认 B 站官方端是否也已更新
偶尔 B 站自身的接口会有短暂延迟。可以在 B 站官网刷新收藏夹页，对照一下是否已经是最新状态。
关于缓存容量
- 缓存按 收藏夹级别 存储，数量等于你的收藏夹数；
- 单条缓存大小取决于该收藏夹中的视频数；
- 当浏览器
localStorage容量不足时，扩展会静默忽略 写入失败，不会崩溃；你可能会感觉「刚读过一次，下次又要重新请求」，这种情况清空缓存重试即可。