docs(plans): 留痕 K33-D 首页 feed 精修

This commit is contained in:
Zhou Weidong committed 2026-10-20 14:05:42 +08:00
1 parent 053993dd5f
commit 452fe74b3d
2 files changed
+58

No files matched your search

+28
View File
@@ -1,3 +1,31 @@
## [已处理] 2026-10-20 | K33-D 首页 feed 去底色/整集条透明+居中+圆点/返回续播(仅 App 端)
**用户指令(2026-10-20,原文)**:
> 「1首页整个页面怎么还有背景 吧背景去掉 2观看完整剧集要透明色 而且文字上下不居中 3拖动进度条要有圆点 4点观看完整剧集进去 再返回不会继续播放」
**口径(只改 Flutter,不动后端、不改接口)**
1. 首页 feed 不再有任何页面底色与蒙层:
- `_HomeTabsState._scaffold` 在 `tab == 0` 时背景改为透明(撤销 K33-C 的 `Colors.black`);
- `HomePage` 在首页 Tab 时不绘制 `AppTheme.pageGradient` 暖色渐变(其它 Tab 保留);
- `HomeFeedOverlay` 删除顶部与底部两层黑色渐变 scrim(`_gradient`);
- 首页状态下系统状态栏图标改为浅色(`SystemUiOverlayStyle.light`),避免深色图标压在视频上看不清。
2. 「观看完整剧集」条:
- 背景透明(删除 `0xCC000000` 深色底),高度 44;
- 左侧播放图标、文案「观看完整剧集 · 全{n}集」、右侧箭头在条内**垂直居中**(Row + Center,不要被底部进度线挤偏);
- 进度线 2px 贴条底、可点按/拖动;
- 进度位置显示圆点:常态 6×6 白色圆点,拖动时放大到 10×10,圆点跟随进度;圆点不遮挡点击手势区(手势区仍 ≥20px 高)。
3. 返回续播:点击整集条进入全屏播放页后,`await` 路由返回时恢复 feed 播放(`logic.session.setUserWantsPlay(true)`),且仅在仍停留在首页 Tab 时执行;返回后不重置当前剧/集。
4. 其余结构不变:顶部三 tab、刷新、系列信息、标题、标签、作者声明、右侧 rail、清屏、上下滑动切剧、深色底栏。
**测试/门禁**
- 新增/更新用例:首页无底色(Scaffold 背景透明/无 gradient 容器)、整集条文本垂直居中、圆点存在且随进度变化、从整集条进入播放页返回后恢复播放(`userWantsPlay == true`);
- `dart analyze lib test` 零告警 + `flutter test` 全过 + `flutter build apk --debug`。
**流程**:从 `develop` 拉 `fix/flutter-k33-feed-clean`;作者 `Zhou Weidong <502333560@qq.com>`;`--no-ff` 合回 develop 并 push;PROGRESS 留痕;真机验收由用户执行。
---
## [已处理] 2026-10-20 | K33-C 首页 feed 精修:去弹幕/全屏观看、rail 对齐播放页、进度条可拖动、整集条跳播放页、纯黑底、刷新按钮(仅 App 端)
**用户指令(2026-10-20,原文)**:
+30
View File
@@ -20668,3 +20668,33 @@ Running Gradle task 'assembleDebug'...
- 发现旧批次残留的 `danmaku` l10n key(无代码引用),已用 `fix/flutter-k33-drop-danmaku-key` 提交 `521ebfc fix(flutter): 清理未使用的弹幕文案 key` 并合并(`f94926c`)。
- 合并后复跑 `dart analyze lib test` 零告警、`flutter test` 401 条全过、`flutter build apk --debug` 成功。
## 2026-10-20 ReelShort:K33-D 首页 feed 去底色 + 整集条优化 + 返回续播
- 分支:`fix/flutter-k33-feed-clean`
- 功能提交:`636b369 fix(flutter): 首页 feed 去底色并优化整集条`
- develop 合并提交:`a312672 merge: 合并 K33-D 首页 feed 精修`,已推送。
- 首页无底色:Scaffold 背景回到透明;首页 Tab 不再绘制 `pageGradient`(渐变只在非首页 Tab 绘制,带 Key `home-page-gradient`);`HomeFeedOverlay` 删除顶部/底部黑色 scrim;首页状态栏用 `SystemUiOverlayStyle.light`。
- 整集条:去掉 0xCC000000 深色底,高度 44,图标/文案/箭头垂直居中;2px 进度线贴底,20px 手势区可点按/拖动 seek;新增白色进度圆点 Key `home-feed-progress-thumb`,常态 6×6、拖动 10×10。
- 返回续播:`PlayerPage.onOpenFullPlayer` 改为异步,await 路由返回后仅在 `mounted && widget.active`(仍在首页 Tab)时 `logic.session.setUserWantsPlay(true)`,当前剧/集不重置。
- 其余结构(三 tab、刷新、系列信息、标题、标签、作者声明、rail、清屏、滑动切剧、深色底栏)未变。
测试:新增首页透明底/无渐变、状态栏浅色、切剧场恢复深色状态栏、整集条高 44 且文案垂直居中、圆点 6→10→6、从整集条进入播放页返回后恢复播放。
门禁原始输出:
```text
$ dart analyze lib test
Analyzing lib, test...
No issues found!
$ flutter test
00:37 +403: All tests passed!
$ flutter build apk --debug
Running Gradle task 'assembleDebug'...
7.3s
✓ Built build/app/outputs/flutter-apk/app-debug.apk
```
解读:静态检查零告警,403 条测试全部通过,debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。