# 需求分析

开始时间：2026-05-18-19-41-29

## 用户反馈

用户点击“加载样例”后，左侧“查看原始视频”面板出现视频控件，但没有显示原始视频画面。

## 问题判断

通过 `ffprobe` 检查当前样例视频：

- `codec_name=mpeg4`
- `codec_tag_string=mp4v`

Chrome 对 OpenCV 直接写出的 `mp4v` MP4 兼容性不稳定，可能出现视频控件可见但首帧/画面不渲染的情况。

## 本轮目标

- 将内置样例视频改为浏览器兼容性更好的 H.264/yuv420p。
- 重新生成 `storage/samples/synthetic_guidewire.mp4`。
- 前端加载视频后主动触发 `load()` 并轻微 seek，帮助浏览器显示首帧。
- 验证样例视频编码和系统功能。