[Cocoon-break]

问题

真机反馈：长截图滚得很慢也一直提示“滚得太快没接上”，完成不了；修好第一个问题后，在终端里仍然接不上。

原因与改动

1. 第一帧截到了淡出中的截图遮罩（Chrome 等所有应用）
按 L 后只等 50 ms 就截第一帧，遮罩撤下与窗口服务器的淡出是异步的，截到的是遮罩里的冻结画面：内容一样、每个像素颜色差一点，之后每帧都对不上。

• longshot::settled：等连续两帧完全相同再用，最多 0.6 秒。单元测试 first_frame_waits_until_the_overlay_is_gone。

2. 终端的背景图不随文字滚动
滚过之后没有一行完全相同，精确比对按设计一帧都接不上。

• Stitch::follow：精确比对找不到时，只和上次接上的那帧近似比对。比横向边缘（文字锐利、背景图平滑），不比颜色。
• 防接错：最好的位置要不到次好的一半，次好的又不能好过毫不相干的位置的一半（只有一个像样的位置）。一行行很像的内容错开整行时有好几个像样的位置，报没接上。第一版缺后一条，repetitive_lines_never_misjoin 当场接错，已补上。
• 新测试 text_over_a_fixed_background；fractional_or_noisy_frames_* 改为“按最近的整行接上”（小数像素、噪点帧现在接得上）。

规格说明 v0.1.40、v0.1.41（M23 规则 13），设计文档、已知限制、设备支持、验收记录同步。

验证

开发构建临时逐帧存图（没有提交），用户复现后离线重放：

场景	原来	现在
Chrome 网页	除第一帧外全部没接上	0 帧没接上，1240 px
终端（背景图）	109 / 215 帧没接上	0 帧没接上，1848 px，行号连续
终端（日志输出，背景更亮）	25 / 249 帧没接上，只有 722 px	0 帧没接上，2176 px，时间依次递增、无重复

近似比对的区分度：对的位置与次好位置的比值 0.07–0.23，没有重叠的两帧 0.98–1.00；每帧最慢 15 ms。make check 通过。

🤖 Generated with Claude Code