docs(plans): 下发 K25 详情页与播放器任务

This commit is contained in:
Zhou Weidong authored and trae-solo-agent committed 2026-10-19 15:07:40 +08:00
1 parent cd711c5d5c
commit f21a334ca8
1 file changed
+59 -1
+59 -1
View File
@@ -20,7 +20,65 @@
---
## [已完成·待用户验收] 2026-10-19 | K24 客户端 UI 对齐设计稿(设计系统 + 首页 + 发现)
## [待处理] 2026-10-19 | K25 客户端详情页 + 播放器对齐设计稿
**用户指令(2026-10-19)**:「开始实现详情页和播放器」。
> 设计权威:`docs/design/screens/03-detail.html`、`04-player.html`(origin/main 或 `/tmp/specs-design/docs/design/screens/`)。
> 设计系统沿用 K24 的 Obsidian Flare token、Outfit/Plus Jakarta Sans、GlassPanel;不改后端接口/模型字段,缺失数据不伪造。
### 一、详情页(`03-detail.html`)
1. **Hero**:16:9 横版头图(优先 `drama.coverUrl`,无则 `posterUrl`),底部渐变;
左上玻璃返回、右上玻璃分享/收藏;图上叠加 `Trailer 0:45`、`4K UHD` 玻璃 pill(无数据时只显示 4K/隐藏)。
2. **元数据**:集数 pill(`N Episodes`)、完结/榜单名次(模型无字段则隐藏)、标题 24px、
`Season 1 • DramaPulse Original Release`、播放量(`viewCount`)、题材标签;评分无字段则隐藏。
3. **简介卡**:`#12141A`/GlassPanel 圆角 16、正文 14px、默认 2 行 + `More` 展开;保留现有 l10n 文案。
4. **CTA 行**:`Start Watching`(或继续观看集数)橙色全宽胶囊 + 48×48 收藏 + 48×48 下载;
举报入口收进右上“更多”;保留现有 Favorite/Download/Report 逻辑。
5. **Episodes 区**:标题 `Episodes (N)` + 范围 chips(如 `1-30`,无数据可只显示全部);
横向集数 chips(46×44、选中橙色、锁定紫色);下方 2 列剧集预览卡(96×64 缩略图、Free/Coin、
时长、锁态);保留现有选集跳转与下载入口。
6. 详情页为 push 页面,不加底部 Tab;加载/失败/空态保留返回按钮(现状已有)。
### 二、播放器(`04-player.html`)
1. **模式拆分**:
- `homeMode=true`(首页沉浸 feed)保持现状全屏竖滑;
- `homeMode=false`(从详情进入)改为设计稿的“卡片式播放器”:
顶部导航(返回、居中剧名 + `Ep.x`、更多)、9:10 圆角 16 视频框、下方进度与操作区、评论卡。
2. **顶部/视频框**:`Auto-Next On` 紫色 pill、`1.0x` 倍速 pill、中心橙色播放按钮、
右侧 36px 点赞/全屏;场景标签(无数据隐藏)。
3. **进度条**:1.5px 轨、缓冲段 white/30、播放段 `#FF5B3D`、白色 thumb;
左侧当前时间、中间 `Ep x / N`、右侧总时长;保留拖动 seek。
4. **三按钮行**:`Episodes` 玻璃胶囊、`Comments (count)` 玻璃胶囊、`Next Ep` 橙色胶囊;
分别打开现有选集、评论弹窗、下一集;没有下一集时置灰。
5. **精选评论卡**:`#14161E` 16px 圆角、VIP 标记(有数据才显示)、点赞数、`View all N`;
复用 `CommentController`;无评论时隐藏。
6. 保留现有播放票据、自动连播、PiP、下载、互动逻辑;下载/PiP 收进顶部“更多”。
7. 不要改 `playback_session`/ticket 协议;只改 UI 组织与控件。
### 三、数据缺口(不得伪造)
- 评分、完结状态、Top 排名、VIP、剧级点赞/评论计数、场景标签:模型/接口没有就隐藏;
- `viewCount`、集数、题材、`Episode.locked`、`freeEpisodes/unlockCoin` 已有,按现有字段渲染。
### 四、测试与门禁
- 更新详情/播放器相关 widget 测试;保留 PiP、进度、票据错误、收藏/下载等既有行为断言;
- 新增:16:9 hero、CTA 行、剧集 chips、播放器卡片模式、三按钮行、进度条颜色;
- `dart analyze lib test` 零告警;`flutter test` 全过;`flutter build apk --debug` 通过。
- 真机验收由用户执行;不伪造设备侧证据。
### 五、Git 与回执
- 从干净 `develop`(基线 `4553606`)拉 `feature/flutter-k25-detail-player`,小步提交;
完成后 `--no-ff` 合并回 develop 并 push;作者 `Zhou Weidong <502333560@qq.com>`;不动 main。
- 计划文档 `FruitServer/docs/plans/2026-10-19-K25.md`;留痕写 `PROGRESS.md`。
- 回执:详情/播放器结构、保留/新增的 Key、测试条数与门禁原始输出、数据缺口、真机验收步骤。
---
## [待处理] 2026-10-19 | K24 客户端 UI 对齐设计稿(设计系统 + 首页 + 发现)
**用户指令(2026-10-19)**:「修改客户端 UI,读 specs 下 docs 下的 screens」。
> 设计权威文件(已全部读取):