release: §5.51 归因更正同步 main(#56,仅文档) #57

Merged
zhangxiang merged 1 commits from dev into main 2026-10-20 22:33:04 +08:00
+22 -5
View File
@@ -924,7 +924,7 @@ if [ "$A" -eq 0 ] && [ "$B" -eq 0 ]; then git add … && git commit … && git p
⇒ 通用判据:**跨路由的「等旧页退场再挂新页」不能依赖 framer 的 presence 状态机;
新页面挂载不得以旧页面的动画完成作为前置条件。**
### 5.51 视觉门禁在 4 worker 并行下可红可绿:是 dwell 不够,不是内容漂移(2026-10-20)
### 5.51 视觉门禁的间歇红有两种签名:dwell 竞态与 CMS 取数退化,都不是像素回归(2026-10-20)
**现象**:在 `3fabb77c` 上只读比对 `visual-regression.spec.ts`(本批未碰 `/team`、`/about/brand`
任何文件)得 **121 passed / 4 failed / EXIT=1**;紧接着原样重跑同一批用例,失败集合换了一批
@@ -943,11 +943,28 @@ expected 是已显影正文 ⇒ 内容停在 `opacity:0` 初始态,而不是
目标),但 IO 回调与 framer 的 `whileInView` 提交都要排帧;4 worker 抢 CPU 时 dwell 不够,
中间某屏就被跳过。判别实验:同一批用例 `--workers=1` 重跑 **10 passed / 0 failed / EXIT=0**。
**修法**(独立动作,未随本批落地):dwell 提到 ≥250ms 且每步排空一帧
**修法①**(只覆盖下面签名 1;独立动作,未随本批落地):dwell 提到 ≥250ms 且每步排空一帧
(`requestAnimationFrame`);或给 `ScrollReveal` 加一个「已显影」可查询标记供用例等待——
现在 `src/components/ui/scroll-reveal.tsx:80-96` 只透传 `className`,这条写不出来。
门禁口径:视觉层默认执行方式钉成 `--workers=1`,否则 `test:all` 里这一层可红可绿。
⇒ 通用判据:**失败集合会随并行漂移 = 装配竞态,不是被测对象的缺陷。**动基线之前先用
`--workers=1` 复跑一次;「换 project 后红位是否移动」就是竞态的判别实验,而「基线过期」
的红位是稳定的。
**补测(同日 22:20–22:35,同一棵树 `9ea8d5f4`)**:把整层改成 `--workers=1` 全量复跑,
得 **124 passed / 1 failed** —— 上面「串行即绿」的说法过强,必须更正。且那一条红
(`L2 主题切换 › 浅色主题 - 首页视觉` @ `visual-chromium-tablet`)在同一棵树上
`--repeat-each=3` 隔离复跑是 **3 passed**,在改动前的 `3fabb77c` 上单跑也是 passed。
⇒ 它是**负载相关的间歇红**,不是 worker 数目的函数。
**两种签名必须分开归因**(都不是像素回归):
1. **同高、带内空白**(`/team`、`/about/brand`):页高与基线一致,差异只在一条带内,
带内 actual 是 `opacity:0` 的空白 ⇒ `waitForPageStable` 的 120ms dwell 没把
`whileInView` 提交完。
2. **不等高、整段换版式**(首页 `theme-light-main` @ tablet):actual 比基线**矮 3114px**,
且带内不是空白而是**另一套版式**(浅色无图 hero、`还没有可以公开的成果` 占位区)。
根因在 `src/app/(marketing)/page.tsx:60` 的 `await getHomePageCopy().catch(() => null)`
——CMS 取数在负载下退化即静默回落成常量版式,页面照常 200、只是内容换了。
这一类**不能**用「加大 dwell」修,也不该由视觉基线去背。
⇒ 通用判据:**「串行复跑变绿」不足以给并行红背书,先比对签名再归因。**
同高空白带 = 装配竞态;不等高且内容换了一套 = 数据侧退化。判据实验是
「隔离复跑 N 次是否稳定 + actual/expected 的页高是否一致」,而不是「换一种并发就绿了」。
动基线之前这两步都要跑完,否则会把竞态或退化固化成参照。