docs(lessons): §5.51 视觉门禁的红位会随并行漂移——是 dwell 竞态,不是基线过期

只读比对在 4 worker 下给出 121 passed / 4 failed,原样重跑红位换了一批
(chromium-tablet 两例转绿),同一批用例 --workers=1 重跑 10/10 通过。逐行差分
显示差异只在长页中部一条带内、带内 actual 是空白 ⇒ 内容停在 opacity:0,
即 waitForPageStable 的 120ms dwell 在 CPU 争用下没能把 whileInView 提交完。

同时更正 §5.50 末尾「视觉全量 125/125」的口径:那是并行下偶然取到的一次读数,
不能当可复现证据。
This commit was merged in pull request #32.
This commit is contained in:
zhangxiang committed 2026-10-20 22:13:10 +08:00
1 parent 97a3c1bda9
commit 9ea8d5f495
1 file changed
+28
+28
View File
@@ -923,3 +923,31 @@ if [ "$A" -eq 0 ] && [ "$B" -eq 0 ]; then git add … && git commit … && git p
⇒ 通用判据:**跨路由的「等旧页退场再挂新页」不能依赖 framer 的 presence 状态机;
新页面挂载不得以旧页面的动画完成作为前置条件。**
### 5.51 视觉门禁在 4 worker 并行下可红可绿:是 dwell 不够,不是内容漂移(2026-10-20)
**现象**:在 `3fabb77c` 上只读比对 `visual-regression.spec.ts`(本批未碰 `/team`、`/about/brand`
任何文件)得 **121 passed / 4 failed / EXIT=1**;紧接着原样重跑同一批用例,失败集合换了一批
——`chromium-tablet` 的两例转绿,红位移到 `chromium-mobile` 与 `webkit`。
**误判风险**:这种红最容易被读成「基线过期 / seed 内容漂移」,进而 `--update-snapshots` 重写
基线,把竞态固化成参照。§5.50 的「视觉全量 125/125」正是并行下偶然取到的一次读数,
不足以当可复现证据——本条更正它。
**取证**:对 actual/expected 做逐行差分 ⇒ 差异只落在长页中部约 1.4k px 的一条带内
(`/team` 的「团队文化」段;两图页高都是 12638,不是整体位移)。带内 **actual 是空白**,
expected 是已显影正文 ⇒ 内容停在 `opacity:0` 初始态,而不是像素变了。
**机理**:`waitForPageStable`(`e2e/visual-regression.spec.ts:54-59`)逐屏滚动的步长 dwell 只有
120ms。§5.50 把「直接跳到底」改成逐屏滚的方向是对的(IntersectionObserver 只回调当前视口内的
目标),但 IO 回调与 framer 的 `whileInView` 提交都要排帧;4 worker 抢 CPU 时 dwell 不够,
中间某屏就被跳过。判别实验:同一批用例 `--workers=1` 重跑 **10 passed / 0 failed / EXIT=0**。
**修法**(独立动作,未随本批落地):dwell 提到 ≥250ms 且每步排空一帧
(`requestAnimationFrame`);或给 `ScrollReveal` 加一个「已显影」可查询标记供用例等待——
现在 `src/components/ui/scroll-reveal.tsx:80-96` 只透传 `className`,这条写不出来。
门禁口径:视觉层默认执行方式钉成 `--workers=1`,否则 `test:all` 里这一层可红可绿。
⇒ 通用判据:**失败集合会随并行漂移 = 装配竞态,不是被测对象的缺陷。**动基线之前先用
`--workers=1` 复跑一次;「换 project 后红位是否移动」就是竞态的判别实验,而「基线过期」
的红位是稳定的。