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

工程分析/实现方案-2026-05-18-19-41-29.md

@@ -0,0 +1,24 @@
+# 实现方案
+
+开始时间：2026-05-18-19-41-29
+
+## 修改内容
+
+1. `scripts/generate_sample.py`
+   - 先用 OpenCV 生成临时 `mp4v` 视频。
+   - 如果系统存在 `ffmpeg`，自动转码为 `libx264`、`yuv420p`、`faststart` 的浏览器友好 MP4。
+   - 如果没有 `ffmpeg`，退回保留 OpenCV 输出，保证脚本仍可运行。
+
+2. `frontend/app.js`
+   - 视频预览设置 `preload = "metadata"`。
+   - 设置 `src` 后调用 `load()`。
+   - `loadedmetadata` 后尝试跳到 `0.1s`，帮助浏览器绘制首个可见帧。
+   - 原始视频弹窗也复用相同逻辑。
+
+3. 重新生成样例
+   - 执行 `bash scripts/generate_sample.sh`。
+   - 使用 `ffprobe` 确认编码为 H.264。
+
+## 说明
+
+这次问题不是用户操作错误，而是样例视频编码格式与浏览器播放兼容性不够稳。