台账 §9.4 初稿把 chromium-mobile 两页 +30/+21px 记为「零源码改动 ⇒ 只能来自
运行期」,参照系用错:旧参照的采集树是 040951c(09-22),当前树含 a366bd1
(09-28 第五轮),参照比树旧了一个修复轮次。
- 实测归因:row-diff.cjs(sharp 逐行比对)定位发散行 y=7440 落在 /products/erp
的 benefits 段;git diff 显示 Q-6 把指标 count-up 从 render 体迁入 useEffect
并加取消 ⇒ 旧参照冻结的是动画中间帧,新参照是稳定终态,属预期改进
- 排除数据侧:prisma/seeds/products.ts 在该窗口零改动
- 三条口径落到 lessons §5.33:归因须对「采集树 vs 当前树」;基线数量须标「例/张」
(本轮 38 张 = 31 例);裸 --update-snapshots 实为 changed 模式,不重写通过项
- §9.5 的 G 项就此关闭,取证脚本随证据目录入库
7.3 KiB
7.3 KiB
2026-10-08 视觉基线写入(AUTH-D3 / 台账 §8.5 D)归因与取证
- 授权:用户裁定「两者都授权」= 写入 20 例缺参照 并 覆盖 11 例已过时参照;§8.5 E(healer 清死选择器)裁定本轮不动。
- 生成树:
1396666(见head.txt),采集前后工作树对e2e/visual-snapshots干净(pre-run-worktree.txt空、pre-run-count.txt= 107)。 - 命令:
npm run test:visual:all -- --update-snapshots(dev 目标,5 project × 25 例 = 125)。日志update-run.txt,125 passed / 4.3m / EXIT=0。 - 复核:
npm run test:visual:all -- --update-snapshots=none。日志readonly-rerun.txt,125 passed / 0 failed / 4.1m / EXIT=0,复跑期间git status --porcelain e2e/visual-snapshots仍为 25??+ 13M⇒ 只读性成立,零写入。
1. -u 的真实语义(决定「13 张覆盖是否都是真判红」)
node_modules/playwright/lib/program.js:202 实读:["-u, --update-snapshots [mode]", { choices: ["all","changed","missing","none"], preset: "changed" }],node_modules/playwright/lib/common/index.js:584 缺省为 missing。
⇒ 裸 --update-snapshots = changed,只在「缺参照」或「比对不符」时写盘,不会重写通过的参照。因此 13 张覆盖全部是真判红,不存在「通过但被顺手改写」的污染。
2. 38 张文件 vs 台账 31 例的对账
台账 §8.3 的 20 缺参照 + 11 已过时 = 31 是用例级读数,本轮写盘是文件级(一例可含多张 shot),两者不矛盾:
| 组 | 用例 | shot 文件 | 说明 |
|---|---|---|---|
| 缺参照 | 20(4 subject × 5 project) | 25 | 「L2 输入框」一例两 shot(input-default + input-focused,e2e/visual-regression.spec.ts:200,204)⇒ 每 project 5 张 |
| 已过时 | 11 | 13 | product-erp-fullpage ×5 + solution-manufacturing-fullpage ×5 = 10 例 10 张;chromium-mobile「按钮组件」一例三 shot(button-default/hover/focus,:112,116,120)= 1 例 3 张 |
| 合计 | 31 | 38 | update-run.txt 内 writing actual 行数现取 = 38,与 git status 的 25 ?? + 13 M 逐项吻合 |
新参照 subject(每 project 5 张,共 25):about-brand-fullpage、product-erp-upgrade-fullpage、product-card、input-default、input-focused。磁盘参照总数 105(visual-regression.spec.ts 目录内)+ 25 = 130,另 manual-acceptance/ 2 张 = 132。
3. 13 张覆盖的像素级归因(sips 现取,宽×高)
| 参照 | 旧 | 新 | 定性 |
|---|---|---|---|
product-erp-fullpage chromium-desktop |
1280x9211 | 1280x7194 | −2017px,Q-5/S-2 网格修复的预期版面收缩 |
product-erp-fullpage firefox-desktop |
1280x9211 | 1280x7194 | 同上,跨引擎同数 |
product-erp-fullpage webkit-desktop |
2548x18422 | 2548x14388 | 同上(DPR 2 档) |
product-erp-fullpage chromium-tablet |
1668x16326 | 1668x14426 | 同上 |
product-erp-fullpage chromium-mobile |
1170x24453 | 1170x24483 | +30px,非收缩形态,见 §5 观察项 |
solution-manufacturing-fullpage desktop / firefox |
1280x9287 | 1280x8282 | −1005px,同族网格收缩 |
solution-manufacturing-fullpage webkit |
2548x18572 | 2548x16562 | 同上 |
solution-manufacturing-fullpage tablet |
1668x18904 | 1668x16710 | 同上 |
solution-manufacturing-fullpage mobile |
1170x27759 | 1170x27780 | +21px,同 §5 |
button-default/focus/hover chromium-mobile |
186x96 | 132x132 | N-15(c) :visible 修正后目标元素变更:旧参照拍桌面导航下拉触发器(186x96),新参照拍 390px 下真实可见的 mobile-menu-button(44x44 CSS 逻辑像素 × DPR3 = 132) |
4. 人工核看(本轮以「逐张读图」代替批量放行)
input-default-visual-chromium-desktop.png:真实姓名框,placeholder「请输入您的姓名」⇒ 未拍成反垃圾蜜罐。规格侧有双护栏:visual-regression.spec.ts:197-199断言name ∈ /^(name|email|phone|subject)$/且not aria-hidden。product-card-visual-chromium-desktop.png:bento-product-card-erp卡(标题 + 研发中/企业套装徽标 + 指标三格 + 目标口径注 + 能力标签)。中部留白不是渲染缺失:products-content-v3.tsx:137的<p className="... flex-1">在 large 卡里撑高,文本仅占顶部一行——同一形态在已批准的products-fullpage-visual-chromium-desktop.png里逐字一致,故新参照与既有批准基线同形。选择器锚点为[data-testid^="bento-product-card-"]+role="listitem"+data-bento-size三重钉住(:154-157)。button-default-visual-chromium-mobile.png:44x44 汉堡按钮(三横线),与 N-15(c) 实测结论一致。
5. 观察项与归因更正(2026-10-08 本轮内自我改判)
- chromium-mobile 两页 +30 / +21px 已归因,且不是运行期漂移(本条初稿曾误判为「位移只能来自运行期」,已作废):
- 归因错在参照系。旧参照的采集树是
040951c(2026-09-22 规范模式重生成),最后一次被改动是6bb7c55(2026-09-28 10:48);而当前树含a366bd1(第五轮修复,2026-09-28 10:48:07)与a0328a6。⇒ 判红须对「采集树 vs 当前树」做 diff,而不是「上一轮提交 vs 本轮提交」。本轮「相对a0328a6零生产源码改动」只保证门禁绿灯可平移,不保证参照与树同源。 - 机理已定位:
src/components/detail/detail-product-value.tsx在a366bd1里做了 Q-6 修复——指标数字 count-up 动画原先写在 render 体内(每帧setState再 spawn 一条从 0 开始的 rAF 链、从不取消),改为useEffect驱动并在卸载/重跑时取消(diff 见:70-100)。旧参照拍到的是动画竞态中的中间帧,新参照拍到稳定终态 ⇒ 指标卡文本/高度小幅位移,属预期改进。 - 现场取证:
node docs/acceptance/2026-10-08-baselines/row-diff.cjs <参照路径> <outdir>(sharp 逐行比对)现取首个发散行 = y 7440(product-erp-fullpagemobile,共 24453/24483 行),该处正是/products/erp的benefits价值列表段;裁图对照显示新参照出现发丝分隔线且条目间距收紧。
- 归因错在参照系。旧参照的采集树是
- 仓库体积:新增 25 张 PNG 共 17,192 KB(最大单张
product-erp-upgrade-fullpage-visual-chromium-mobile.png2,472 KB),13 张覆盖净变化为负(如 webkit erp 2,303,020 → 2,066,938 字节)。 - 采集口径:dev 目标。
docs/testing.md§确定性约束 1 已实证「快照与E2E_TARGET无关」(e2e/fixtures.ts剥nextjs-portal),故 production 复核不会因此全红;e2e/visual-snapshots现共 132 张(含manual-acceptance/2 张)。 - 只读比对的前置:跑前
lsof :3000空闲、无next-server残留 ⇒ 未落入reuseExistingServer静默复用旧构建的坑(docs/development/quality-gates.md:163)。 - 残留风险(改判后仍留一条):Q-6 族的其他 count-up 消费点若仍有 render 体内动画,基线仍可能拍到中间帧。本轮 125/0 只证明当前树自洽可复现,不证明「参照=用户所见」;下一次跨树复核(如 production 目标或换 DPR 档)若出现指标卡判红,按本条查。