diff --git a/docs/lessons-learned.md b/docs/lessons-learned.md index 4b01d91..4686c0d 100644 --- a/docs/lessons-learned.md +++ b/docs/lessons-learned.md @@ -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 的页高是否一致」,而不是「换一种并发就绿了」。 +动基线之前这两步都要跑完,否则会把竞态或退化固化成参照。