docs(lessons): §5.51 更正——串行并非全绿,视觉间歇红有两种签名 #56

Merged
zhangxiang merged 1 commits from docs/visual-gate-two-flake-signatures into dev 2026-10-20 22:32:42 +08:00
Owner

变更摘要

更正 docs/lessons-learned.md §5.51 的归因口径。上一笔(9ea8d5f4,随 #32 合入)把视觉层的
间歇红写成「4 worker 并行下的 dwell 竞态,--workers=1 串行 10/10 全绿」,但同树全量串行实测
是 124 passed / 1 failed,且那条红隔离复跑 3/3 通过、在改动前的 3fabb77c 上单跑也通过。
⇒ 「串行即绿」是过强结论,会把下一轮取证直接带到错的方向上。

本 PR 只改这一节文档:把它拆成两种签名(同高空白带 = dwell 竞态;不等高且整段换版式 =
src/app/(marketing)/page.tsx:60 的 getHomePageCopy().catch(() => null) 在负载下退化),
并把通用判据从「换并发复跑」改成「先比对签名(页高是否一致 + 隔离 N 次是否稳定)再归因」。

关联 Issue

N/A:来源是本轮 #32 取证过程中的自我更正,无协作平台 Issue。证据:
/tmp/visual-full-serial.log(124/1)、/tmp/repeat-dev.log(3 passed)、
e2e/test-results/…浅色主题—首页视觉…(actual 1668×14362 vs expected 1668×17476)。

提交前检查

  • bash scripts/check-pr-checklist.sh 对本描述文件 EXIT=0
  • N/A:本 PR 不含代码与配置变更,仅一节文档

全链路检查

  • npm run type-check — N/A:本 PR 零 .ts/.tsx 变更(git show --stat 只有 1 个 md 文件)
  • npm run lint — N/A:同上,无被 lint 的文件
  • 路由/链接真实 — N/A:未新增 href;文档内引用的是 page.tsx:60、visual-regression.spec.ts:54-59 两处已核实存在的行号
  • 涉及 CMS 内容模型 — N/A:不改内容模型与 seed,无需 db:seed
  • 视觉/交互改动 — N/A:无样式与组件变更
  • 暗黑模式 — N/A:无样式变更
  • 动效合规 — N/A:无动效变更
  • 品牌红触达 — N/A:无页面变更
  • 数字与宣称口径 — N/A:未改结果型数字;文档里的读数都是本轮实测值
  • 无遗留 console.log / TODO / .only() — 纯 markdown diff,未触及任何测试或源码

测试分层检查(L0–L3)

  • L0 单元 — N/A:无函数变更
  • L1 组件 — N/A:无组件变更
  • L2 E2E — 本 PR 不改用例;被更正的那条用例已在两种并发下复跑(见「变更摘要」读数)
  • L3 视觉回归 — N/A:无 UI 变更;且本 PR 的动机正是「不要在归因清红之前动基线」
  • 新增机械守卫带正控制 — N/A:无新增守卫;文档给出的判别实验(页高是否一致 + 隔离 N 次)本身就是可失败判据
  • 已运行相关测试并全绿,无 .only() / 跳过态残留 — N/A:本 PR 不新增用例;§5.51 记录的 124/1 与 121/4 均为如实读数,未洗成通过

质量门禁

  • npm run test:unit — N/A:零代码变更,不重跑(同树 149 套件 / 1815 例的读数见 #32)
  • npm run test:coverage — N/A:同上,未改阈值
  • npm run test(Playwright E2E)— N/A:同上;GA4 那 16 例仍只在 test:e2e:prod 口径下断言,本 PR 未改这一层
  • npm run check:contrast / check:headings — N/A:无样式变更
  • npm run lighthouse — N/A:无页面与产物变更
  • npm run test:security:headers — N/A:未触及响应头、CSP 或部署配置
  • 文档已同步 — 本节即 docs/lessons-learned.md §5.51;README/CONTEXT/CLAUDE 无受影响条目(无新命令、无新术语、无架构变化)
  • 提交信息符合 Conventional Commits — 单笔 docs(lessons),是可独立评审的切片
  • 破坏性/共享状态动作已单独授权 — 合并到 dev 与随后的 dev→main release 已在本轮取得授权;无 seed 重跑、无 DB 写入、无部署、无 force push

假绿灯纪律

  • 门禁命令实际执行过并粘贴真实输出 — 本 PR 的实质内容就是两条互相矛盾的读数(124/1 与 3/3),全部如实记录,未择利
  • 未通过删测试、放宽断言、skip 用例或下调阈值让门禁变绿 — 本 PR 不改任何用例,只更正归因
  • 未把误报当问题「修掉」— 两种签名都给了可失败的判别实验,而非「重跑一次绿了就完」
## 变更摘要 更正 `docs/lessons-learned.md` §5.51 的归因口径。上一笔(`9ea8d5f4`,随 #32 合入)把视觉层的 间歇红写成「4 worker 并行下的 dwell 竞态,`--workers=1` 串行 10/10 全绿」,但同树全量串行实测 是 **124 passed / 1 failed**,且那条红隔离复跑 3/3 通过、在改动前的 `3fabb77c` 上单跑也通过。 ⇒ 「串行即绿」是过强结论,会把下一轮取证直接带到错的方向上。 本 PR 只改这一节文档:把它拆成**两种签名**(同高空白带 = dwell 竞态;不等高且整段换版式 = `src/app/(marketing)/page.tsx:60` 的 `getHomePageCopy().catch(() => null)` 在负载下退化), 并把通用判据从「换并发复跑」改成「先比对签名(页高是否一致 + 隔离 N 次是否稳定)再归因」。 ## 关联 Issue N/A:来源是本轮 #32 取证过程中的自我更正,无协作平台 Issue。证据: `/tmp/visual-full-serial.log`(124/1)、`/tmp/repeat-dev.log`(3 passed)、 `e2e/test-results/…浅色主题—首页视觉…`(actual 1668×14362 vs expected 1668×17476)。 ## 提交前检查 - [x] `bash scripts/check-pr-checklist.sh` 对本描述文件 EXIT=0 - [x] N/A:本 PR 不含代码与配置变更,仅一节文档 ## 全链路检查 - [x] `npm run type-check` — N/A:本 PR 零 `.ts/.tsx` 变更(`git show --stat` 只有 1 个 md 文件) - [x] `npm run lint` — N/A:同上,无被 lint 的文件 - [x] 路由/链接真实 — N/A:未新增 href;文档内引用的是 `page.tsx:60`、`visual-regression.spec.ts:54-59` 两处已核实存在的行号 - [x] 涉及 CMS 内容模型 — N/A:不改内容模型与 seed,无需 `db:seed` - [x] 视觉/交互改动 — N/A:无样式与组件变更 - [x] 暗黑模式 — N/A:无样式变更 - [x] 动效合规 — N/A:无动效变更 - [x] 品牌红触达 — N/A:无页面变更 - [x] 数字与宣称口径 — N/A:未改结果型数字;文档里的读数都是本轮实测值 - [x] 无遗留 `console.log` / `TODO` / `.only()` — 纯 markdown diff,未触及任何测试或源码 ## 测试分层检查(L0–L3) - [x] **L0 单元** — N/A:无函数变更 - [x] **L1 组件** — N/A:无组件变更 - [x] **L2 E2E** — 本 PR 不改用例;被更正的那条用例已在两种并发下复跑(见「变更摘要」读数) - [x] **L3 视觉回归** — N/A:无 UI 变更;且本 PR 的动机正是「不要在归因清红之前动基线」 - [x] 新增机械守卫带正控制 — N/A:无新增守卫;文档给出的判别实验(页高是否一致 + 隔离 N 次)本身就是可失败判据 - [x] 已运行相关测试并全绿,无 `.only()` / 跳过态残留 — N/A:本 PR 不新增用例;§5.51 记录的 124/1 与 121/4 均为如实读数,未洗成通过 ## 质量门禁 - [x] `npm run test:unit` — N/A:零代码变更,不重跑(同树 149 套件 / 1815 例的读数见 #32) - [x] `npm run test:coverage` — N/A:同上,未改阈值 - [x] `npm run test`(Playwright E2E)— N/A:同上;GA4 那 16 例仍只在 `test:e2e:prod` 口径下断言,本 PR 未改这一层 - [x] `npm run check:contrast` / `check:headings` — N/A:无样式变更 - [x] `npm run lighthouse` — N/A:无页面与产物变更 - [x] `npm run test:security:headers` — N/A:未触及响应头、CSP 或部署配置 - [x] 文档已同步 — 本节即 `docs/lessons-learned.md` §5.51;README/CONTEXT/CLAUDE 无受影响条目(无新命令、无新术语、无架构变化) - [x] 提交信息符合 Conventional Commits — 单笔 `docs(lessons)`,是可独立评审的切片 - [x] 破坏性/共享状态动作已单独授权 — 合并到 dev 与随后的 dev→main release 已在本轮取得授权;无 seed 重跑、无 DB 写入、无部署、无 force push ## 假绿灯纪律 - [x] 门禁命令实际执行过并粘贴真实输出 — 本 PR 的实质内容就是两条**互相矛盾**的读数(124/1 与 3/3),全部如实记录,未择利 - [x] 未通过删测试、放宽断言、skip 用例或下调阈值让门禁变绿 — 本 PR 不改任何用例,只更正归因 - [x] 未把误报当问题「修掉」— 两种签名都给了可失败的判别实验,而非「重跑一次绿了就完」
zhangxiang added 1 commit 2026-10-20 22:32:33 +08:00
同树全量 `--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 修,也不该由视觉基线来背。
zhangxiang merged commit dee0c4835c into dev 2026-10-20 22:32:42 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novalon/novalon-website#56