2026-05-18-20-35-32 修复结果视频关键帧空白

工程分析/经验记录.md

@@ -151,3 +151,15 @@ B. 产生问题原因：后端把已抽取并分割的结果帧直接按固定 8
 C. 解决问题方案：后端改为按原视频 `source_fps` 写完整结果视频；抽中的帧写入分割叠加画面，未抽中的帧写入原始画面；`result_fps`、`result_duration`、`result_time` 与源视频时间轴保持一致。前端双视频 seek 同步改为同一时间点同步。
 
 D. 后续如何避免问题：任何面向并排对照的视频结果，都应优先保持与源视频相同时间轴；抽帧结果可以作为下方帧卡片展示，但主视频播放器不应只由抽帧结果压缩拼接。
+
+## 2026-05-18-20-35-32 结果视频关键帧附近空白
+
+### 1. 点击第 40 帧后右侧结果视频看起来没有叠加
+
+A. 具体问题：下方结果列表中第 40 帧存在分割结果，但点击后右侧完整结果视频画面可能显示为纯原图，用户感知为“空白”。
+
+B. 产生问题原因：上一版结果视频为了保持 6 秒完整时间轴，只在被抽中的关键帧写入一帧叠加图，其他帧写原始图。浏览器 seek 到关键帧附近时可能显示相邻未抽中帧，因此叠加结果只闪一帧，难以稳定看到。
+
+C. 解决问题方案：后端在生成完整结果视频时维护最近一次分割掩膜；关键帧写真实叠加图，非关键帧用最近掩膜叠加到当前原始帧后写入，从而在关键帧之间持续显示分割提示。
+
+D. 后续如何避免问题：当主视频播放器用于人工查看结果时，抽帧算法的关键帧结果不能只显示单帧；应使用持续叠加、插值或显式关键帧段落，保证用户拖动时能稳定看到结果。