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:
1 parent
133faaba1b
commit
0157b1c9f5
7 files changed
+472
-96
No files matched your search
@@ -612,3 +612,39 @@ D-2 的回归守卫:`solution-detail-content-v3.test.tsx` 新增断言,且**
|
||||
|---|---|---|
|
||||
| DEC-N5 | **后台发布/删除不触发缓存失效**:`DELETE /api/admin/items`(`route.ts:282-311`)与 workflow 发布路由都不调 `revalidatePath`;全仓除 `e2e/user-journey.spec.ts` 外**没有任何生产代码调用 `/api/cms/revalidate`**,而 8 个页面注释都写着「CMS 发布/更新时通过 /api/cms/revalidate 主动刷新」 | 实测后果:最长 1 小时(`s-maxage=3600`)前台上仍是已删/旧内容。修法是把 `modelCode → paths` 的映射从 `api/cms/revalidate/route.ts` 里**提成可导入的函数**(同 §5.30「安全抽象必须可导入」),再在发布/更新/删除三处调用。属生产内容行为变更,本批不擅改 |
|
||||
| DEC-N6 | `e2e/**/*.ts` 不在 `tsconfig` 的 include 内 ⇒ `npm run type-check` 抓不到 e2e 里的类型/重复声明错误 | 本轮实例:teardown 补丁里第二个 `const revalidateSecret` 与既有声明重名,type-check 全程 EXIT=0,只有 `npx playwright test --list` 才报 `Identifier 'revalidateSecret' has already been declared`。口径:**改 e2e 后必须至少跑一次 `--list`**(收集期解析)才算"能加载" |
|
||||
|
||||
### 11.6 终局验证补跑读数(2026-10-17,装配后的 standalone 产物)
|
||||
|
||||
| 门禁 | 读数 | 口径 |
|
||||
|---|---|---|
|
||||
| `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 条**都是像素不符**,即本批语法改动(radius 0–4 / 去彩色阴影 / CTA 直角 / hover 不抬升 / 暖色板)的预期外溢 ⇒ **AUTH-VISUAL 的重采量就是这 104 张**,不是"基线全坏" |
|
||||
| `check:axe:routes` → `check:axe` | 清单 **35 条**;`PASSED=true`、`bgMismatch=0`、`contrastNodes=0`、`violationNodes=0`、`extraRuleNodes=0`、`extraRuleCoveragePairs=105`、`non2xxResponses=1`(= 期望内的 `/_not-found`)、`unexpectedStatus=0` ⇒ **EXIT=0** | 首跑是 `EXIT=2`「未能度量」(清单不存在,须先跑 routes),第二次 `EXIT=1` 抓到两类真问题(见下) |
|
||||
| `test:e2e:prod` | 修完 6 条 IA 连带红 + ISR 装配后,`UJ-01/02/03/08/10` × chromium + chromium-mobile ⇒ **14 passed / 0 failed** | GA4 那 16 例在本 worktree **仍 skipped**:worktree 没有 `.env.production`,而 `NEXT_PUBLIC_GA_MEASUREMENT_ID` 是 **build 期烘焙**进客户端产物的 ⇒ 「prod 目标下 GA4 才真断言」这条口径在缺该文件的树上不成立,须记为**未取证**而不是通过 |
|
||||
|
||||
#### 修掉的两个闸自身缺陷
|
||||
|
||||
1. **`axe-node-count.mjs` 的底色哨兵把令牌值抄成字面量**(`EXPECTED_BG.dark = 'rgb(10, 14, 20)'`),
|
||||
而暗色底早在 P1 暖色迁移(本分支基线 `da9a5cb6` 之前)就变成 `20 18 16`
|
||||
⇒ 哨兵**恒红**,实测 `bgMismatch=36`。
|
||||
归因用 `git diff da9a5cb6..HEAD -- src/app/globals.css` 核过:本批**没有**任何
|
||||
`color-bg-primary` 改动 ⇒ 不是本轮引入。
|
||||
修法不是把字面量改成新值(那只是再抄一遍抄本),而是**改从令牌自己取值**:
|
||||
读 `--color-bg-primary-rgb` 三元组拼期望色。
|
||||
**负对照已做**(`docs/acceptance/2026-10-17-ia-e2e/probe-bg-negative.mjs`):
|
||||
把 `dist/standalone/dist/static` 临时移走起服务 ⇒
|
||||
`expected=""`、`actual="rgba(0, 0, 0, 0)"` ⇒ 哨兵判红(EXIT=0 表示"负对照成立");
|
||||
装配完好时 `expected="rgb(20, 18, 16)"` = `actual` ⇒ 判绿。
|
||||
⇒ 这次改造**没有把闸调瞎**(§5.34 的同类风险)。
|
||||
2. **改哨兵时漏改一处 `pageBg` 引用** ⇒ `check:axe` 以
|
||||
`FATAL: 扫描中断(uncaughtException):pageBg is not defined` 崩掉。
|
||||
这条值得记:闸崩溃与判红在退出码上是两回事(本闸 EXIT=1 判红 / EXIT=2 未能度量 /
|
||||
FATAL 走 uncaughtException),**没有静默把崩当成通过**;
|
||||
同时 `scripts/**.mjs` 不在 `tsconfig` 覆盖内,只有真跑才暴露(同 §5.43)。
|
||||
|
||||
#### ISR 冻结产物的最终处置
|
||||
|
||||
`uj03-test-news-*` 的 URL 会顺着「已发布 → revalidate 落盘 → 删除但没人再刷」这条链
|
||||
被冻进产物,再被 BFS 收进路由清单,最后表现为 404。本轮闭环做法:
|
||||
删自造行(含 `AuditLog.targetId` 与 `ContentZone.items` 的 JSON 引用)→
|
||||
`npm run build` 重建(`news.html` 里 `uj03` 命中 **0**)→ 重跑 routes + axe。
|
||||
纪律仍然成立:**重置 ISR 只能靠重建或 revalidate,不许手删 `dist/**`**(§5.42)。
|
||||
Reference in new issue
Block a user