2026-05-18-19-41-29 修复样例视频浏览器显示

工程分析/需求分析-2026-05-18-19-41-29.md

@@ -0,0 +1,23 @@
+# 需求分析
+
+开始时间：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，帮助浏览器显示首帧。
+- 验证样例视频编码和系统功能。