# 收藏与观看历史分页 UI

## 目标

- `/app/favorites` 与 `/app/watch/recent` 按 `PageResult{total,list}` 分页接入。
- 收藏页、观看历史页支持首屏、触底加载、无更多、刷新、失败重试和总数展示。
- 观看记录直接使用后端 `dramaTitle/dramaCover/episodeNumber`，缺失时安全兜底。

## 实现步骤

1. 新增通用 `PageResult<T>`，更新 LibraryApi、WatchApi、Repository 与内存替身。
2. FavoriteController、WatchRecordsController 增加分页状态、请求代次、dramaId 去重。
3. 页面通过滚动通知触发 `loadMore`，复用下拉刷新并增加通用分页 footer。
4. 观看卡片优先渲染接口字段，标题为空时用本地化“第 N 集”，封面为空显示占位。
5. 补 API、Controller 和 widget 测试，运行 analyze 与全量 flutter test。

## 风险与约束

- 刷新期间保持旧列表，成功后原子替换并回到第 1 页；失败保留旧数据。
- loadMore 与 refresh 通过请求代次隔离，旧响应不得覆盖新列表。
- 空页立即停止加载；`loaded >= total` 后不再请求。
- 不新增依赖、不提交现有 `pubspec.lock`，不启停服务、不操作真机。