2026-05-18-21-20-13 改为逐帧生成结果视频

工程分析/实现方案-2026-05-18-21-20-13.md

@@ -0,0 +1,17 @@
+# 实现方案
+
+开始时间：2026-05-18-21-20-13
+
+## 后端改造
+
+1. `_process_video` 每一帧都执行当前方法分割，用当前帧的 overlay 写入右侧结果视频。
+2. `max_frames` 仅控制下方结果卡片保存数量，不再控制结果视频中哪些帧执行分割。
+3. 对 `compare` 方法：
+   - 抽样关键帧保存多方法结果。
+   - 结果视频仍使用该帧或非关键帧的 fusion overlay。
+4. 移除“最近掩膜持续叠加”的逻辑，避免运动帧错位。
+
+## 测试增强
+
+- 对选中的关键帧，读取结果视频同一帧并与保存的 overlay 图比较，确保视频画面和下方卡片一致。
+- 保留完整视频时长、fps 和多方法对比接口测试。

工程分析/测试方案-2026-05-18-21-20-13.md

@@ -0,0 +1,30 @@
+# 测试方案
+
+开始时间：2026-05-18-21-20-13
+
+## 自动化测试
+
+- `python3 -m compileall backend tests`
+- `node --check frontend/app.js`
+- `pytest -q`
+
+## 接口验证
+
+- 使用内置样例视频调用 `/api/segment`。
+- 检查结果视频时长仍为 6 秒。
+- 检查第 25、55、70 帧附近有当前帧分割叠加。
+
+## 浏览器验证
+
+- 加载样例并运行分割。
+- 点击第 25、55、70 帧。
+- 确认右侧视频与下方对应卡片更一致，不再使用旧掩膜造成明显错位。
+
+## 执行结果
+
+- `python3 -m compileall backend tests`：通过。
+- `node --check frontend/app.js`：通过。
+- `pytest -q`：5 passed。
+- API 样例分割：结果视频仍为 6 秒，关键帧为 `[0, 5, 15, 20, 25, 30, 40, 45, 50, 55, 65, 70]`。
+- 第 25、55、70 帧：右侧视频帧与下方卡片 overlay 的平均像素差分别为 `3.184`、`3.45`、`3.464`，属于 H.264 压缩误差级别。
+- Chrome headless 页面验证：点击第 25、55、70 帧后，右侧时间分别为 `2.0833`、`4.5833`、`5.8333` 秒，并检测到稳定黄色叠加像素。

工程分析/经验记录.md

@@ -163,3 +163,15 @@ B. 产生问题原因：上一版结果视频为了保持 6 秒完整时间轴
 C. 解决问题方案：后端在生成完整结果视频时维护最近一次分割掩膜；关键帧写真实叠加图，非关键帧用最近掩膜叠加到当前原始帧后写入，从而在关键帧之间持续显示分割提示。
 
 D. 后续如何避免问题：当主视频播放器用于人工查看结果时，抽帧算法的关键帧结果不能只显示单帧；应使用持续叠加、插值或显式关键帧段落，保证用户拖动时能稳定看到结果。
+
+## 2026-05-18-21-20-13 运动帧结果仍显得不匹配
+
+### 1. 第 25、55、70 帧叠加结果与原始导丝位置有错位感
+
+A. 具体问题：虽然关键帧附近不再空白，但用户观察第 25、55、70 帧时，右侧结果视频仍和左侧原始视频有不贴合的感觉。
+
+B. 产生问题原因：上一版使用“最近一次分割掩膜持续叠加”来填充关键帧之间的视频画面。导丝是运动结构，旧掩膜套到后续当前帧上会形成残留或错位，尤其在弯曲和末端位置变化明显的帧上更突出。
+
+C. 解决问题方案：后端生成右侧完整结果视频时改为每一帧都运行当前方法分割；`max_frames` 只控制下方结果卡片保存数量，不再控制主结果视频是否分割。关键帧卡片与视频对应帧用像素差测试校验一致性。
+
+D. 后续如何避免问题：用于播放的结果视频必须逐帧使用当前帧结果；抽帧限制只能用于结果列表、调参预览或摘要，不应用来偷换主视频的逐帧分割语义。

工程分析/需求分析-2026-05-18-21-20-13.md

@@ -0,0 +1,17 @@
+# 需求分析
+
+开始时间：2026-05-18-21-20-13
+
+## 用户问题
+
+用户反馈：第 25、55、70 帧的右侧结果视频仍然感觉和左侧原始视频不匹配。
+
+## 判断
+
+上一版为了解决关键帧附近“空白”问题，在完整 6 秒结果视频中复用了最近一次分割掩膜。这个策略能避免纯原图，但会把旧掩膜套到后续运动帧上；当导丝位置变化明显时，结果就会出现视觉错位。
+
+## 期望
+
+- 右侧结果视频仍保持与原始视频同一时长、同一时间轴。
+- 右侧视频的每一帧都应使用当前帧自身的分割结果，而不是复用旧掩膜。
+- 下方结果卡片仍只保留抽样关键帧，避免界面过多图片。