docs(plans): 留痕 K33-E 首页 feed 刷新与进度优化

This commit is contained in:
Zhou Weidong committed 2026-10-20 14:12:00 +08:00
1 parent 452fe74b3d
commit d82d5c76be
2 files changed
+56

No files matched your search

+26
View File
@@ -1,3 +1,29 @@
## [已处理] 2026-10-20 | K33-E 首页 feed 无感刷新 / rail 下移 / 进度圆点与整集条底(仅 App 端)
**用户指令(2026-10-20,原文)**:
> 「1刷新要无感刷新 现在刷新会白屏 2而且 收藏 评论喜欢 分享位置太靠上 3 拖动圆点不居中 拖动的时候放大进度条 观看完整剧集的背景不明显」
**口径(只改 Flutter,不动后端、不改接口)**
1. 无感刷新:
- `CatalogController` 新增 `Future<bool> refresh()`:静默请求 `repository.fetchHomeFeed()`,成功则替换 `feed` 并 `notifyListeners()`,失败返回 false,**不修改 `loading`、不置 `error`、不清空旧数据**;
- feed 刷新按钮改为调用 `catalog.refresh()`(`HomePage` 透传给 `_HomeTabs` 的 `onRefreshFeed` 改用它,不再用 `load`);
- 刷新期间不出现全屏 loading/白屏,当前视频与页面保持;失败时 SnackBar 轻提示(复用 `catalogError`)。
2. 右侧互动栏下移:`HomeFeedOverlay` 的 rail 对齐由 `Alignment(1.0, 0.45)` 改为更靠下(约 `Alignment(1.0, 0.68)`,以底部信息区上方留 12 为界),不得压到底部信息或整集条。
3. 整集条与进度:
- 圆点垂直居中:圆点中心必须与进度线中心重合(`Positioned` 用 `top: (trackHeight - dot) / 2` 或 `Align(center)`,不能出现上下偏移);
- 拖动时放大:常态轨道 2px、圆点 6px;拖动中轨道 4px、圆点 10px,松手回落;
- 「观看完整剧集」条背景要明显:半透明深色 `0x4D000000`、圆角 0(整条通栏),高度 44,文字与箭头仍垂直居中;
- 点击/拖动手势区高度保持 ≥24px。
**测试/门禁**
- 新增/更新:`CatalogController.refresh` 不改变 `loading` 且失败保留旧数据;刷新点击不出现全屏 loading;rail 位置断言(位于底部信息区上方);圆点中心与轨道中心一致;拖动时轨道/圆点尺寸变化;
- `dart analyze lib test` 零告警 + `flutter test` 全过 + `flutter build apk --debug`。
**流程**:从 `develop` 拉 `fix/flutter-k33-feed-refresh`;作者 `Zhou Weidong <502333560@qq.com>`;`--no-ff` 合回 develop 并 push;PROGRESS 留痕;真机验收由用户执行。
---
## [已处理] 2026-10-20 | K33-D 首页 feed 去底色/整集条透明+居中+圆点/返回续播(仅 App 端)
**用户指令(2026-10-20,原文)**: