# K95.2 首切频道用封面过渡

## 目标

- 首页频道切换后立即显示目标短剧封面，视频首帧就绪后再淡入。
- 首页模式视频初始化期间不再显示 `player-session-loading` 大转圈。
- 非首页播放器及票据加载状态保持现有行为。

## 分支

- ReelShort：`fix/k95.2-poster-transition`，从最新 `origin/develop` 创建。
- FruitServer 仅写计划与 PROGRESS 留痕，不改后端功能代码。

## A. PlayerVideoSurface

- 新增可选参数 `posterUrl = ''`。
- 未 reveal 时：
  - `posterUrl` 非空显示 `RemoteImage(path: posterUrl, fit: BoxFit.cover)`，
    Key 为 `player-video-poster`。
  - `posterUrl` 为空继续显示黑色 `ColoredBox`，保留
    `player-fallback-background` Key。
- 视频 reveal 后继续通过现有 200ms `AnimatedOpacity` 淡入覆盖封面。

## B. PlayerPage

- `PlayerVideoSurface` 传入当前 `drama.posterUrl`。
- `player-session-loading` 条件增加 `!widget.homeMode`：
  - 首页模式视频初始化期间只显示封面。
  - 非首页播放器继续显示原 session loading。
- 首页 `player-ticket-loading` 不变。

## C. 测试

- 视频表面：非空 poster 显示 `player-video-poster`，空 poster 保留黑底且无封面。
- 首页模式：视频未就绪时不出现 `player-session-loading`。
- 非首页模式：视频未就绪时仍出现 `player-session-loading`。
- 复跑既有播放器、首页相关测试。

## 门禁

- `dart analyze lib test`
- `flutter test`
- `flutter build apk --debug`

## Git

- ReelShort 提交：`fix(home): 频道切换用封面过渡`
- `--no-ff` 合回 `develop` 并 push。
- 作者 `Zhou Weidong <502333560@qq.com>`；禁止 `git add -A`。

## 约束

- 全程中文；不改后端、ReelShortWeb、specs。
- 不安装或操作真机；完成后停住等待验收。