Animeko 播放卡顿 / 失败排查 - 转圈、白框、播几秒就停的诊断顺序
先说最重要的一条
遇到播放问题先更版本。更新日志里几乎每版都修播放相关的 bug：
- 旧版本有在线源白框问题
- 旧版本有剧集自动切换错误
- 旧版本有暂停后无法继续播放
- 旧版本有缓存页闪退
升级到较新版本是最常用的「万能解法」。
排查顺序表
| 现象 | 先判断什么 | 动作 |
|---|---|---|
| 第一次点播放一直转圈 | BT 源还是在线源 | 在线源本来就要等一段；BT 源等更久，先让它缓一会儿 |
| 转了很久还是不动 | 是不是冷门老番 | 老番无人做种 → 改用缓存或换在线源 |
| 播几秒就停、反复缓冲 | 网络到该源的连通性 | 换一条源；仍然如此 → 考虑代理 |
| 只有某一条源不行 | 单源问题 | 直接换源，不必折腾网络 |
| 所有源都不行 | 网络出口问题 | 先确认其他应用能正常联网，再考虑代理 |
| 加载出来是白框 | 版本偏旧 | 更新到较新版本（官方 明确指出旧版有此问题） |
| 弹幕对不上画面 | 时间轴问题 | 用时间偏移校准（见 06-弹幕 组） |
| 播着播着卡住 | 网络波动 | 暂停等一会儿、或换源 |
BT vs 在线源的典型问题
BT 源
| 问题 | 原因 | 解决 |
|---|---|---|
| 一直不动、速度几 KB/s | 冷门老番无人做种 | 先缓存慢慢下，或换在线源 / PikPak |
| 首次加载特别慢 | BT 要等做种者响应 | 耐心等，热门新番通常较快 |
| 下到一半断了 | 做种者突然离线 | 继续等（BT 会重连其他节点） |
在线源
| 问题 | 原因 | 解决 |
|---|---|---|
| 白框 / 加载失败 | 版本偏旧或源下线 | 更新版本；换源 |
| 速度忽快忽慢 | 该站带宽波动 | 换源或缓存后离线看 |
| 一直转圈不出画面 | 该源与你的网络不连通 | 换源、考虑代理 |
官方的口径
官方 里对播放问题的总体建议是：
- 先检查自己的网络
- 不保证每个在线源的连通性——源的可用性取决于第三方，Animeko 无法控制
- 遇到问题先更新到最新版
- 还不行再换源或使用代理
记录日志反馈 Bug
如果确实是 Animeko 本身的 bug（不是源或网络问题），可以：
- 设置 → 关于 → 分享日志
- 把日志附上，在 GitHub Issues 里提 Bug
- 反馈前必须先更新到最新版，否则官方可能不受理
别把源的问题当应用的问题
这是最常见的误区：
| 你看到的现象 | 实际原因 | 不是 |
|---|---|---|
| 播不动 | 那条源挂了 / 没人做种 | Animeko 坏了 |
| 弹幕不显示 | 条目匹配不上 / 该集本来就没弹幕 | Animeko 坏了 |
| 加载白框 | 版本偏旧（已知 bug） | Animeko 坏了 |
换源、更新版本、等一会儿，这三步解决 90% 的播放问题。