From dee0c4835c8446a46c7694587610876a70b20aa4 Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Tue, 20 Oct 2026 22:31:38 +0800 Subject: [PATCH] =?UTF-8?q?docs(lessons):=20=C2=A75.51=20=E6=9B=B4?= =?UTF-8?q?=E6=AD=A3=E2=80=94=E2=80=94=E4=B8=B2=E8=A1=8C=E5=B9=B6=E9=9D=9E?= =?UTF-8?q?=E5=85=A8=E7=BB=BF=EF=BC=8C=E8=A7=86=E8=A7=89=E9=97=B4=E6=AD=87?= =?UTF-8?q?=E7=BA=A2=E6=9C=89=E4=B8=A4=E7=A7=8D=E7=AD=BE=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 同树全量 `--workers=1` 实测 124 passed / 1 failed,且那条红在同一棵树上 `--repeat-each=3` 隔离复跑 3 passed、在改动前的 3fabb77c 上单跑也 passed ⇒ 上一笔把它归因成「4 worker 的 dwell 竞态」过强,串行全绿不能给并行红背书。 按 actual/expected 的签名拆开:同高 + 带内空白 = dwell 竞态(/team、/about/brand); 不等高(矮 3114px)+ 整段换成另一套版式 = `page.tsx:60` 的 `getHomePageCopy().catch(() => null)` 在负载下退化,页面照常 200 但内容回落成常量版式。 后者不能靠加大 dwell 修,也不该由视觉基线来背。 --- docs/lessons-learned.md | 27 ++++++++++++++++++++++----- 1 file changed, 22 insertions(+), 5 deletions(-) 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 的页高是否一致」,而不是「换一种并发就绿了」。 +动基线之前这两步都要跑完,否则会把竞态或退化固化成参照。 -- 2.54.0