docs(plans): 记录 K25 详情页与播放器

docs/plans/PROGRESS.md

@@ -4945,3 +4945,66 @@ ReelShort `develop` 与 `feature/flutter-k24-design-system` 已推送。
    清空恢复；有观看记录时显示 Continue Watching，无记录时不显示。
 4. 点 Me，确认账号内容与 History/Watchlist/Liked 在同一页；切回 Home 播放进度与收藏状态保留。
 5. 深色/浅色系统、320×568 与 390×844 小屏检查无溢出、文字不截断。
+
+### K25 客户端详情页 + 播放器（2026-10-19）
+
+范围：详情页与 `homeMode=false` 卡片播放器；`homeMode=true` 首页沉浸 feed 保持 K24 现状。
+
+详情页：
+
+- 16:9 hero（当前模型只有 `posterUrl`）、底部渐变、玻璃返回/分享/收藏/更多。
+- 集数 pill、24px 标题、Season 副标题、`viewCount`、题材标签；评分/完结/榜单项无字段隐藏。
+- 16px 玻璃简介卡，2 行 + More/Less。
+- 橙色全宽 Start Watching/继续观看 + 48×48 收藏/下载；举报保留在更多菜单。
+- Episodes 标题 + All 范围 chip；46×44 横向集数 chips，锁定项紫色；2 列剧集卡，
+  390 宽下缩略图实测 96×64，含 Free/Coin、时长、锁态与下载入口。
+
+播放器（从详情进入）：
+
+- 顶部返回、剧名 + Ep.x、更多（下载/PiP）。
+- 9:10 圆角 16 视频框、Auto-Next/1.0x pill、中心橙色播放、右侧 36px 点赞/全屏。
+- 1.5px 进度条：白色 30% 缓冲、`#FF5B3D` 播放段、白色 thumb；左中右时间/集数信息，保留拖动 seek。
+- Episodes / Comments / Next Ep 三按钮；末集 Next 置灰。
+- `PlayerFeaturedComment` 复用 `CommentController`，无评论隐藏；VIP/总数无字段不显示。
+- 保留票据三态、自动连播、PiP、下载、点赞/收藏/评论与播放会话协议。
+
+数据缺口：`coverUrl`、评分、完结、Top 排名、Trailer/4K、VIP、剧级点赞/评论总数、场景标签、
+集数范围、倍速能力均无模型字段；按 INBOX 隐藏或不伪造。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test
+00:30 +352: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'...                             26.3s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+构建说明：主工作区仍有用户侧 `flutter run`，因此在 `/tmp/reelshort-k25-final`
+独立 worktree 执行 `flutter pub get` 与 `flutter build apk --debug`，避免并发占用 `build/`。
+
+Git：
+
+```text
+ec163f9 feat(detail): 重做详情页视觉结构
+689063a feat(player): 新增卡片式播放器
+04fddce merge: K25 客户端详情页与播放器
+```
+
+提交与合并 author/committer 均为 `Zhou Weidong <502333560@qq.com>`。
+ReelShort `develop` 与 `feature/flutter-k25-detail-player` 已推送。
+
+真机验收步骤（设备侧取证由用户执行）：
+
+1. 从首页/发现进入详情，检查 16:9 hero、玻璃按钮、集数/播放量/题材、简介展开。
+2. 点 Start Watching，确认进入卡片播放器：9:10 视频框、进度条、三按钮行。
+3. 拖动进度条、切换下一集、末集按钮置灰；点 Episodes/Comments 打开现有弹窗。
+4. 有评论时检查精选评论卡与 View all；无评论时应隐藏。
+5. 从播放器更多菜单验证下载/PiP；点全屏进入横屏，退出后回到卡片布局。
+6. 检查收藏、举报、续看进度、票据失败重试与自动连播未回退。