# YMB 站点运行态与 Shorts 体验优化计划

## 目标

- 让 Shorts 与观看页统一使用 `/app/episodes/{id}/play` 的最新签名播放地址。
- 优化播放等待、播放失败、空结果和移动端手势反馈，减少“像演示数据”的体验。
- 保持现有深色品牌、YouTube 式信息架构、多语言、匿名浏览和无底部导航。

## 范围

- `src/features/shorts/**`
- `src/shared/components/player/**`
- `src/features/search/**`
- 必要的共享样式与本计划文件

## 约束

- 不修改 FruitServer 接口契约，不自行拼接签名播放地址。
- 播放地址只使用接口返回值；预览流只作为接口失败时的兼容回退。
- 不引入新的状态管理或重量级 UI 依赖。
- 保持当前分支 `dev`，只提交 YMB 子项目本轮文件。

## 验证

- `pnpm lint`
- `pnpm build`
- `git diff --check`
- 本地验证 `/app/feed`、`/app/episodes/{id}/play`、HLS 清单响应和前端首页可访问。

## 风险 / 待确认

- Shorts 每次激活视频会请求一次播放票据；使用现有请求取消机制，避免切换页面后写入失效状态。
- 当前浏览器自动播放策略仍可能要求静音启动，保留现有声音提示和手动开启逻辑。

## 实施回执

- 已完成：Shorts 当前激活视频改为调用 `/app/episodes/{id}/play` 获取最新签名地址，切换激活项时复用 `useRequest` 的取消机制；接口失败时仅回退到推荐流已有播放地址。
- 媒体解析：图片 `resolveMedia` 与播放 `resolvePlaybackUrl` 分离，缺失播放地址返回空字符串，不再把 `hero.jpg` 送入 HLS；锁定集和无地址分集保持占位状态。
- 交互：Shorts 当前视频播放结束后自动进入下一条，手势、键盘方向键和桌面箭头控制保持不变；等待和播放失败状态在卡片内可见。
- 真实链路：`/app/feed?size=6` 返回 6 条并带游标；首条 `/app/episodes/{id}/play` 返回 `accessible=true`、签名 `playUrl` 和多清晰度；HLS 清单响应 `application/vnd.apple.mpegurl`；前端 `http://127.0.0.1:4179/` 返回 200。
- 门禁：`pnpm lint` 通过；`pnpm build` 通过（仅有既有大 chunk 提示）；`git diff --check` 通过。
- 当前状态：本轮源码与计划文件已提交并推送到 `origin/dev`（提交 `ebf7886`）；未修改 FruitServer 契约，未增加底部导航。