追番进度同步 — 跟官方 App 保持一致
追番数据从哪里来
BiliPai 不自己维护追番数据库，而是通过 B 站公开接口获取：
- 你在 B 站标记追番的所有番剧列表
- 每部番剧的当前追番状态
- 每一集的观看进度（精确到秒）
- 已更新集数 vs 已观看集数
这意味着：
- 官方 App 上标记的追番 → BiliPai 里能看到
- BiliPai 里标记的追番 → 官方 App 里也能看到
- 两边看到的进度是同一份数据
标记追番
方式一：番剧详情页
进入番剧详情页 → 点击右上角"追"图标 → 标记成功后图标变成"已追"。
方式二：播放页
在番剧播放页 → 点击屏幕中央显示追番按钮 → 一键追番。
取消追番
在追番面板或番剧详情页再次点击"已追"按钮 → 确认后取消。
追番进度怎么更新
你播放完某集后，BiliPai 会：
- 在本地 Room 数据库里先写入进度
- 网络空闲时通过 B 站 API 把进度上报到 B 站服务器
- 下次在官方 App 或 BiliPai 里打开同一番剧，能看到相同的进度
断网时的行为
如果播放时没有网络：
- 本地进度照常保存
- 等下次有网络时（进入番剧详情页或下拉刷新追番列表）再上报
- 不会丢失数据，也不会重复上报（有去重机制）
追番面板
底部导航栏 → 番剧 → 进入追番面板，显示：
| 区域 | 内容 |
|---|---|
| 顶部横幅 | 当前正在追的番剧封面轮播（更新了新集的排最前） |
| 全部追番 | 按更新时间倒序列出所有番剧 |
| 继续观看 | 正在看的番剧（有未看的集） |
| 已完结 | 追过但已完结的番剧 |
每部番剧条目显示：
- 封面图
- 番剧名
- 最新集数 / 总集数
- "继续观看"按钮（如果有未看的）
追番 vs 稍后再看
B 站有两个"收藏视频"的概念，容易混淆：
| 功能 | 用途 | 粒度 |
|---|---|---|
| 追番 | 标记"这部番我要追"，自动跟踪更新 | 整部番剧 |
| 稍后再看 | 标记"这个视频我以后要再看" | 单个视频 |
| 收藏夹 | 把多个视频组织到同一个分类下 | 任意数量 |
BiliPai 完整支持追番、稍后再看和收藏夹三个功能，都从 B 站服务器同步。
追番进度丢失排查
如果你发现某部番剧的追番进度被重置：
- 确认你没有手动清除历史记录
- 确认没有在 B 站官方网页版取消追番（服务器端会同步）
- 检查 BiliPai 版本是否过旧（旧版有追番进度 bug）
- 下拉刷新追番面板看看是否是显示延迟
一般来说，追番进度丢失很少见——因为它和 B 站服务器同步，不像纯本地记录那样容易丢。