docs(plans): 下发 K25 详情页与播放器任务
This commit is contained in:
1 parent
cd711c5d5c
commit
f21a334ca8
1 file changed
+59
-1
+59
-1
@@ -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」。
|
||||
> 设计权威文件(已全部读取):
|
||||
|
||||
Reference in new issue
Block a user