fix(gates): axe 底色哨兵改从令牌取值(它抄的那份字面量早已过期),并补终局验证读数

`check:axe` 首跑 EXIT=1,其中 `bgMismatch=36` 的红因写着
「底色不等于令牌值 ⇒ 样式未加载」—— 两句**都是错的**:
样式加载得好好的(light 侧逐页相等、对比度节点 0),
错的是哨兵自己抄了一份令牌值。

副本漂移的证据链:
- `axe-node-count.mjs:52` 硬编码 `EXPECTED_BG = { light:'rgb(255, 255, 255)',
  dark:'rgb(10, 14, 20)' }`;
- 暗色底在 P1 暖色迁移(**本分支基线 `da9a5cb6` 之前**)就是 `--color-bg-primary: #141210`
  / `-rgb: 20 18 16`;
- `git diff da9a5cb6..HEAD -- src/app/globals.css` 里**没有任何** `color-bg-primary` 改动
  ⇒ 不是本轮引入;`git log -S "rgb(10, 14, 20)"` 定位到字面量入库那一笔。
  归因先于修闸:少了这一步,很容易把它读成「本批改坏了」。

修法是把**副本换成真源**,而不是把副本改成新值(那只是再抄一遍,下次换色板还会红):
现读 `--color-bg-primary-rgb` 三元组当场拼期望色。
实测读到了错诊断的代价:一个失效的哨兵会**顺带伪造一句错的诊断**。

改完重做负对照,证明没把闸调瞎(§5.34 那类"全站 CSS 404 仍 exit 0"的反面):
- 临时移走 `dist/standalone/dist/static` 起服务 ⇒ `expected=""`、
  `actual="rgba(0, 0, 0, 0)"` ⇒ 判红(`probe-bg-negative.mjs` 以 EXIT=0 表达
  「负对照成立」);
- 装配完好 ⇒ `expected="rgb(20, 18, 16)"` 与 `actual` 相等 ⇒ 判绿。

另记一条同轮事实:本次改造漏改一处 `pageBg` 引用,闸以
`FATAL: 扫描中断(uncaughtException):pageBg is not defined` 崩掉而不是静默通过 ——
这正是退出码分档(0 通过 / 1 判红 / 2 未能度量 + FATAL 独立路径)兑现价值的地方;
而 `scripts/**/*.mjs` 不在 `tsconfig` 覆盖内,只有真跑才暴露(§5.43 同族)。

终局验证补跑读数(装配后的 standalone 产物,详见台账 §11.6):
- `check:axe:routes` 清单 **35 条** → `check:axe` **EXIT=0**:
  `bgMismatch=0`、`contrastNodes=0`、`violationNodes=0`、`extraRuleNodes=0`、
  `extraRuleCoveragePairs=105`、`non2xxResponses=1`(期望内的 `/_not-found`)、
  `unexpectedStatus=0`。
- `test:visual:all -- --update-snapshots=none` 复跑 **104 failed / 21 passed**
  (五 project 均匀 21/21/20/21/21),**0 例 element-not-found、0 例超时**。
  与首跑 109/16 的差值全部归因到那 5 条 `founder-quote-section` 死选择器
  (区块按裁定已删除 ⇒ 区域截图永不可能命中),已在上笔改写为反向守卫并变异验证。
  ⇒ 剩下的 104 条**都是像素不符**,即本批语法改动的预期外溢:
  **AUTH-VISUAL 的重采量是这 104 张**,不是"基线全坏"。
- `test:e2e:prod`:`UJ-01/02/03/08/10` × chromium + chromium-mobile ⇒ **14 passed**。
  ⚠ GA4 那 16 例在本 worktree **仍 skipped**:worktree 没有 `.env.production`,
  而 `NEXT_PUBLIC_GA_MEASUREMENT_ID` 是 **build 期烘焙**进客户端产物的 ⇒
  「prod 目标下 GA4 才真断言」这条口径在缺该文件的树上不成立,
  须记为**未取证**而不是通过。

ISR 冻结产物的最终闭环:删自造 `uj03-test-news-*` 行(连带 `AuditLog.targetId`
与 `ContentZone.items` 的 JSON 引用)→ `npm run build`(`news.html` 里 uj03 命中 0)
→ 重跑 routes + axe。纪律不变:**重置 ISR 只能靠重建或 revalidate,不许手删 `dist/**`**。

文档:台账 §11.6、`docs/lessons-learned.md` §5.44 + 更新记录一行、
探针 `probe-bg.mjs` / `probe-bg-sentinel.mjs` / `probe-bg-negative.mjs` / `probe-drawer.mjs`。

复跑:`type-check` EXIT=0、`lint` EXIT=0(0 error / 81 warning)、
`check:visual` EXIT=0(grammar 11/11 + accents 成立,两条自证先跑)、
`jest` 1747 例、`build` EXIT=0。
This commit is contained in:
zhangxiang committed 2026-10-17 02:17:39 +08:00
1 parent 133faaba1b
commit 0157b1c9f5
7 files changed
+472 -96

No files matched your search

+29
View File
@@ -623,6 +623,7 @@ git config --get-regexp -i "gitea|credential" 2>/dev/null # ← 空
| 2026-10-17 | 增加 §5.41(僵尸令牌:CSS 声明退役而 tailwind 映射未删 ⇒ 类照生成、`var()` 静默取空;R5/R7 各看一侧所以两条都绿。删映射并新增 R11 反向守卫(外部所有者按名豁免且豁免腐化亦判红),负对照实测 `EXIT=1 / 悬空 2 条` ⇒ 还原 11/11。附两条仪器纪律:豁免名单单一真源、先怀疑夹具再怀疑判据)| `tailwind.config.js`、`scripts/check-visual-grammar.mjs` R11、`docs/acceptance/2026-10-17-ia-e2e/` |
| 2026-10-17 | 增加 §5.42(自伤型验证:为清 ISR 缓存手删 `dist/**` 连带删掉已编译的 `news/page.js`,页面 500 而「uj03 命中 0」被读成清除成功;重建后才发现库里真有 2 条因中途失败而未清理的测试行。三条纪律:重置 ISR 只靠重建或 revalidate、「命中 0」必须配页面健康的正对照、破坏性清理后要清点留下的半成品数据。附正面收获:`/products` 移动端孤儿由守卫抓到,判红是对的)| `docs/acceptance/qa-tracker.md` §11.5 |
| 2026-10-17 | 增加 §5.43(`e2e/**/*.ts` 不在 tsconfig include ⇒ type-check EXIT=0 而 spec 里重复 `const revalidateSecret` 让整档无法加载;改 e2e 后必须 `npx playwright test <spec> --list` 才算验证「能加载」)| `e2e/user-journey.spec.ts`、qa-tracker §11.5 DEC-N6 |
| 2026-10-17 | 增加 §5.44(守卫自己抄了一份令牌值:axe 底色哨兵硬编码 `rgb(10,14,20)` 而暗色底早在基线前就暖化成 `20 18 16` ⇒ 哨兵恒红且伪造出「样式未加载」的错误诊断。三条纪律:先归因再修闸、把副本换成真源而不是改抄本、换完必须重做负对照。附 `scripts/**.mjs` 不在 tsconfig 覆盖内、退出码分档在崩溃时兑现价值)| `scripts/accessibility/axe-node-count.mjs`、`docs/acceptance/2026-10-17-ia-e2e/probe-bg-negative.mjs` |
### 5.36 判据的适用对象没写进判据:diff 包围盒对全页截图必然假红
@@ -773,3 +774,31 @@ cd e2e && npx playwright test <改动的 spec> --list # Total: N tests in M fi
这条与 §5.38 同属"绿灯的载体没覆盖到那一维":type-check 的范围、管道的退出码,
都会让人把**没测**读成**测过并通过**。
### 5.44 守卫自己抄了一份令牌值:三个副本、两种病,第三种最隐蔽
本仓「一个语义有多条表示通道」的事故已经记过两次:
§5.37(hex 改了 `-rgb` 没改 ⇒ 渲染主通道走没改的那条)、
§5.41(CSS 声明退役而 tailwind 映射没删 ⇒ 僵尸令牌)。
本轮是**第三份副本**:可访问性闸 `scripts/accessibility/axe-node-count.mjs` 把暗色底
**抄成字面量** `EXPECTED_BG = { dark: 'rgb(10, 14, 20)' }`,
而暖色迁移(P1,在本分支基线 `da9a5cb6` **之前**)早已把它变成 `20 18 16`
⇒ 哨兵从此恒红,实测 `bgMismatch=36`,而且红因写的是「底色不等于令牌值 ⇒ 样式未加载」——
**一个失效的哨兵会顺带伪造一句错的诊断**,这比单纯判红更贵。
三条处置纪律:
1. **归因先于修闸**。`git diff da9a5cb6..HEAD -- src/app/globals.css` 里没有任何
`color-bg-primary` 改动 ⇒ 不是本轮引入;再用 `git log -S "rgb(10, 14, 20)"` 定位到
字面量入库的那一笔。没有这一步,很容易把它读成「本批改坏了」。
2. **修法是把副本换成真源,而不是把副本改成新值**。
现从令牌自己取:读 `--color-bg-primary-rgb` 三元组拼期望色。
把字面量改成 `rgb(20, 18, 16)` 只是再抄一遍,下次换色板还会红。
3. **换完必须重做负对照**,证明"没把闸调瞎":临时移走 `dist/standalone/dist/static` 起服务 ⇒
`expected=""`、`actual="rgba(0, 0, 0, 0)"` ⇒ 判红;装配完好 ⇒ `expected` 与 `actual`
都是 `rgb(20, 18, 16)` ⇒ 判绿。脚本存 `docs/acceptance/2026-10-17-ia-e2e/probe-bg-negative.mjs`。
附两条同轮仪器事实:`scripts/**/*.mjs` 不在 `tsconfig` 覆盖内,改完只真跑才暴露
(本轮就是漏改一处 `pageBg` 引用,闸以 `FATAL: 扫描中断(uncaughtException)` 崩掉而非静默通过);
以及闸的退出码分档(0 通过 / 1 判红 / 2 未能度量 + FATAL 独立路径)在这种时刻兑现了价值 ——
**崩和"测不到"都不会被读成通过**。