docs(plans): 下发 K27.6 集数左贴与清屏跨集共享

This commit is contained in:
Zhou Weidong authored and trae-solo-agent committed 2026-10-19 17:26:19 +08:00
1 parent 19c608fb31
commit 4081b9c893
1 file changed
+28
+28
View File
@@ -20,6 +20,34 @@
---
## [待处理] 2026-10-19 | K27.6 首页集数文案左贴 + 清屏状态跨集共享
**用户指令(2026-10-19,原文)**:
> 「首页的底部的卡片 第n集/共n集 要紧挨着左侧啊 还有 选集进去播放页面还是 点击清屏后 再次滑动 还不是清屏状态」
**问题定位(Trae 勘察)**
1. `home_feed_overlay.dart` 的 `_infoCard` 用 `Row` + `Expanded` + 右对齐 `Flexible`,把「第 n 集 / 共 n 集」顶到了卡片最右侧。
2. 选集进入的播放页(`homeMode=false`)是 `PlaybackQueue.series`,上下滑动按集切换;每集各自渲染一个 `_PlaybackOverlay`,而 `_controlsVisible` 是 `_PlaybackOverlayState` 的局部状态,所以清屏只作用于当前集,滑到下一集又恢复控件。
**口径**
1. 首页底部卡片:剧集类型标签与「第 n 集 / 共 n 集」放在同一个 `Wrap`(spacing 6、runSpacing 4、交叉轴居中),集数文案紧跟标签左侧排列,**不再右对齐/推到最右**;标签过长时允许整体换行,不得溢出。
2. 清屏状态提升为播放页级别:把 `_controlsVisible` 从 `_PlaybackOverlayState` 移到 `_PlayerPageState`,与首页 `_feedChromeVisible` 合并为同一个 `_chromeVisible`(或等价命名)。
- `_PlaybackOverlay` 改为无内部显隐状态,接收 `controlsVisible`、`onClear`、`onTogglePlay` 等参数。
- 播放页清屏后,上下滑动切集 / 切剧仍保持清屏;退出清屏按钮恢复后所有页面同步显示控件。
- 首页与选集两种入口共用同一状态来源。
3. 已确认的规则不变:播放中不显示中心按钮、暂停时显示播放按钮、清屏点画面切播放、右上角退出清屏、无定时器。
**测试**
1. 首页 `home-feed-episode` 的左边缘紧贴标签区(与 `home-feed-info-card` 左内边距接近,不得落在卡片右半区)。
2. 选集进入播放页 → 点 `player-clear-screen` → 上滑切到下一集 → 仍无 `player-controls-top` / `player-controls-bottom`,`player-exit-clear-screen` 仍在;点退出后恢复。
3. 首页清屏后滑动切剧仍保持清屏(回归)。
4. 中心按钮仅暂停时显示(回归)。
5. 既有测试全过。
**流程**:从最新 `develop` 拉 `fix/flutter-clear-screen-shared`;门禁 `dart analyze lib test` 零告警 + `flutter test` 全过 + `flutter build apk --debug`;`--no-ff` 合回 develop 并 push;作者 `Zhou Weidong <502333560@qq.com>`;PROGRESS 留痕;真机验收由用户执行。
---
## [待处理] 2026-10-19 | K27.5 中心按钮只在暂停时显示(播放状态一律不显示)
**用户指令(2026-10-19,原文)**: