Files
novalon-website/docs/acceptance/qa-tracker.md
T
zhangxiang fadc35b980 test(e2e): 修 pollBoundingBox 自身的二次读取竞态,§14.2 登记逐条处置与探针否证
- 探针 docs/acceptance/2026-10-17-final/probe-logo.mjs 实测加载期无双字标可见窗口
  (390x844 与 1280x800 各 60 次采样,双可见 0;唯一零可见是 t≈43ms header 尚未进 DOM)
  ⇒ 产品不闪,红来自辅助函数:expect.poll 等到非空后再单独读一次 boundingBox,
  hydration 亚 60ms 的重挂让第二次读取返回 null,被误报成「元素在断言瞬间消失」。
- 改为在同一次读取里既判非空又产出值;超时才 throw,且 throw 文案带轮询次数。
  判据不降:仍要求非空 box + 原几何断言,没有 catch、没有静默通过。
- website-acceptance × 4 project 连跑两次各 56 passed。
- §14.2 表逐条登记:fail-open 修复 / 触摸目标与 region 命名 / 限流真因与双向用例 /
  锚点重锚 / 引擎差异取证法(我上一个假设被自己的读数否掉)/ 本条竞态。
2026-10-17 10:59:50 +08:00

1049 lines
142 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# QA 问题跟踪台账(系统性质量保障 · 单一真源)
- 分支:`qa/seal-2026-09-28`,**与 `origin` 同步**(2026-10-08 两次快进推送完成,见 §9.5 F 行)。代码封版点仍是 `a0328a6`;其后的 2026-10-08 收尾链起点为 `1396666`(数字校正)→ `6ff19d1`(视觉基线 38 张入库)→ §9 记录 / 归因改判 / 四处文档同步等数笔,**完整序列现取 `git log --oneline a0328a6..HEAD`,不在本行复制笔数**
- 树状态(2026-10-08 现取,`6ff19d1` 上):`git diff --stat HEAD` 空 + `git status --porcelain` = 3 条未跟踪(`.pr-seal-2026-09-28.md`、`.pr-seal-2026-09-30.md`、`deliverables/`,**用户裁定保持未跟踪**)⇒ **代码树干净**;仓库无自定义 `clean/smudge` filter ⇒ 上面的「干净」可直接采信。领先关系**不写死笔数**(本文件所在提交自身会让笔数过期):现取用 `git rev-list --count origin/qa/seal-2026-09-28..HEAD` 与 `git rev-list --count origin/main..HEAD`。视觉参照现取 `git ls-files e2e/visual-snapshots` = **132 张**(`visual-regression.spec.ts` 目录内 130 + `manual-acceptance/` 2)
- **视觉门禁口径变更(2026-10-08)**:由历轮的 `94 passed / 31 failed / EXIT=1` 变为 **`125 passed / 0 failed / EXIT=0`**,AUTH-D3 就此判定完成;取证与逐张核看记录见 §9 与 `docs/acceptance/2026-10-08-baselines/attribution.md`
- 上游报告:
- 周期 1:`docs/acceptance/2026-09-23-gates/final-verdict.md`(发现 N-1…N-33;对 2026-09-21 阻断 A-*/R-*/B-* 的闭环)
- 周期 2:`docs/acceptance/2026-09-23-cycle2/final-verdict.md`(新增表现层/领域层轴:A-1…A-4、C-1、P-*、D-1(defect)、L-1…L-5、Sentry 接线;决策清单 D-1…D-11)
- 本台账的作用:把上述**分散编号统一到一处**,作为「问题跟踪机制」的执行面;**不重复**两份报告的证据叙述,只登记**状态 + 归属阶段 + 闭合阻塞项**。
- 编号消歧:周期 2 的缺陷 `D-1`(detail-trust-section)与决策清单 `D-1`(入库)同名,本台账分别记为 **DEF-D1**(缺陷)与 **AUTH-D1**(决策/授权项)。
## 0. 验收判定(对齐 objective 五阶段)
| objective 阶段 | 交付物 | 状态 |
|---|---|---|
| 1 代码审查 | 两份周期报告 + 本台账 §1 | **已达成**(多轴、subagent + 主线逐条复核) |
| 2 测试 | 门禁实测表(周期 1 §1 / 周期 2 §0)+ `docs/testing.md` | **已达成**(可自主执行的门禁全部出数;写库/基线/线上/全量变异等需授权项见 §3) |
| 3 修复 + 跟踪机制 | 本台账(单一真源) | **机制已建立**;修复的**可复现性未达成**(未入库) |
| 4 优化 | 性能(Lighthouse 9/9=100、a11y 节点计数、限流键、死资源清理)+ 安全(提权/XSS/越权/令牌/开放重定向) | **已达成**,余留项见 §2/§3 |
| 5 验收确认 | 本报告 + 门禁凭据 | **封版通过(含例外清单)**——AUTH-D1 已闭合,2026-09-30 补齐从未在 sealed 树上跑过的 4 项门禁;判定书见 `docs/acceptance/2026-09-30-seal/final-verdict.md`,例外见其 §4 |
> **【2026-09-30 改判 · 现行判定】封版通过(含例外清单)**。AUTH-D1 已于 2026-09-28 闭合(三笔提交入 `qa/seal-2026-09-28`,`a0328a6`);本轮补齐 sealed 树上从未跑过的全站 `check:axe`、生产目标 E2E、视觉只读比对、产物安全头、`check:motion` 五项,三处判红已逐条定性。判定书:`docs/acceptance/2026-09-30-seal/final-verdict.md`。**下面两条历史结论仅作过程留痕,不再代表现状。**
>
> ~~**结论不变**~~(历史,2026-09-30 作废;承接周期 1「有条件通过」/周期 2「未达可判验收通过」):技术面已闭环并有实测凭据;验收不能判完成的**唯一实质原因**是 §3 AUTH-D1(约 363 条改动未提交,评审者/CI/下一位开发者无法复现本台账任何结论)。
>
> ~~**2026-09-28 更新**~~(历史:该轮改动随后即入库):第三/四/五轮(§4/§5/§7)在此结论上继续累积修复(第五轮再修 S-21/S-22/Q-10②/S-3 两个 P2 + 12 个 P3,全带判别测试与门禁凭据),未提交的工作树现 **394 条**——AUTH-D1 仍是唯一硬阻断。
## 1. 本台账建立时的独立复核(trust-but-verify,2026-09-25)
对**最高后果**的 12 项「已修」声明做了只读源码复核(读当前工作树,未采信报告自述),结论:
| ID | 声明 | 复核结果 | 证据(本次亲读) |
|---|---|---|---|
| N-18 | draft/disable 开放重定向防护 | **CONFIRMED** | `src/lib/cms/internal-redirect.ts:8`;`disable/route.ts:13-21` 先校验后副作用 |
| N-19 | admin/stats 越权读取 | **CONFIRMED** | `src/app/api/admin/stats/route.ts:11` 用 `requirePermission('content-model','read')` |
| N-20 | 停用账号令牌仍可用 | **CONFIRMED** | `src/lib/permissions.ts:41-45` 读 `User.status`,早于 `:52` 的 super_admin 短路 |
| N-25 | 限流 XFF 伪造绕过 | **CONFIRMED** | `src/lib/client-ip.ts:14-23` 优先 `x-real-ip`、XFF 取最右;`contact/route.ts:4,51` 消费 |
| N-22 | 安全头门禁恒不成立 | **CONFIRMED** | `check-security-headers.ts:63-78,101,128-132` cookie 状态按 flag 推导并计入退出码;缺 CSP=fail;HSTS 分 http/https |
| N-1 | JSON-LD `</script>` 注入 | **CONFIRMED** | `src/components/seo/structured-data.tsx:8-9` `jsonLd()` 转义 `<`/`>`,8 个 sink 全用 |
| DEF-A1..A4 | 后台编辑器定位/守卫 | **CONFIRMED** | `admin/content/[modelCode]/[itemId]/page.tsx` `id` 过滤 + `itemNotFound`(:691) + `canEdit`(:252,736,917) 收口 |
| C-1 | 案例页缺键整页崩溃 | **CONFIRMED(边界归一)** | 归一在唯一 importer `(marketing)/cases/[slug]/client.tsx:22,30-35`,恰在未受信任 CMS 强转处;报告所称组件文件为归属笔误,非漏洞(见 §2.2 REG-C1) |
| L-5 | 媒体派生命名冲突 | **CONFIRMED** | `src/lib/media/image-processor.ts:75` 追加 `Math.random()` 后缀 |
| L-1 | admin-api 吞掉 4xx/5xx | **CONFIRMED** | `src/lib/admin-api.ts:85-102` 解密后按 `res.ok` 抛错 |
| N-4/5/6 | 保存/发布状态通道 | **CONFIRMED** | 保存载荷无 `status`;发布走 `runWorkflow`;POST 拒非 draft |
| DEF-D1 | 指标前导符号错位 | **CONFIRMED** | `detail-trust-section.tsx:26-48` 用 `[^0-9.]` 否定类 + prefix/suffix 分列 |
> Sentry 接线亦复核为真:`src/instrumentation.ts`、`src/instrumentation-client.ts` 存在且 import `@sentry/nextjs`;`next.config.mjs:131` `export default withSentryConfig(nextConfig)`。
> 覆盖扫描(非定点复核):`src/`+`scripts/` 内无条件 `status:'pass' as const` = **0**;`\|\| echo` = 12(均在 CI/部署 shell 的信息性回退,非门禁判据);`e2e/*.spec.ts` 内 `if (.count()>0)` 守卫 = 11 处(周期 1/2 已逐条定性为视口/角色合法分支,见 N-27)。
## 2. 缺陷登记(按闭合状态分组)
图例 · 状态:`FIXED-UNCOMMITTED`=已修且§1或原报告有 RED/GREEN 凭据,但未入库;`DECISION`=待产品/设计裁定;`AUTH`=待单独授权动作;`RECORDED`=已知、诚实披露、本轮不动。
### 2.1 已修复(代码在工作树内,含 §1 复核标记)
| ID | 级别 | 类别 | 摘要 | 状态 | 凭据 |
|---|---|---|---|---|---|
| N-18/19/20/25 | P1 | 安全 | 开放重定向 / 越权读取 / 停用账号令牌 / 限流绕过 | FIXED-UNCOMMITTED | §1 全部 CONFIRMED + 原报告 RED 实测 |
| N-22 | P1 | 门禁可信度 | 安全头门禁恒不成立断言 | FIXED-UNCOMMITTED | §1 CONFIRMED + 双向对照 |
| N-1 | P1 | 安全 | JSON-LD 存储型 XSS 面 | FIXED-UNCOMMITTED | §1 CONFIRMED |
| N-4/5/6/7 | P0/P1 | 功能 | 后台保存必 400 / 发布必失效 / 状态死控件 / 状态回写 | FIXED-UNCOMMITTED | page.test.tsx |
| N-9 | P0 | 门禁可信度 | standalone 产物缺 `dist/static`(CSS 404) | FIXED-UNCOMMITTED | postbuild 落地 |
| N-11 | P2 | 性能/BP | `/contact` CSP 违规(Zod eval 探测) | FIXED-UNCOMMITTED | `z.config({jitless})` + Lighthouse A/B |
| N-12 | P1 | 门禁可信度 | 补测自身把 rAF 变只读致套件静默不跑 | FIXED-UNCOMMITTED | 隔离复跑 |
| N-17 | P2 | 测试诚实性 | security-headers 裸 `return` 伪装通过 | FIXED-UNCOMMITTED | 68 passed + 4 skipped |
| N-24②③④ | P2 | 门禁可信度 | 404 即就绪 / 不受支持的 next start / pr-checklist 空转 | FIXED-UNCOMMITTED | 双向对照 |
| N-27(部分)| P2 | 测试装配 | 零断言用例 / `expect()\|\|expect()` JS bug / 死选择器 | FIXED-UNCOMMITTED | 四 project 实测 |
| N-30(删兜底)| P1 | 内容零编造 | 两处凭空 `40%` 兜底已删(含反转被锁死的测试) | FIXED-UNCOMMITTED | 23→23 通过 |
| N-31 / N-33(部分)| P2 | 文档一致性 | 不可执行命令 / 假阈值 / 口径回填 | FIXED-UNCOMMITTED | 机械比对 |
| A-1..A-15, R-1..R-5, B-1/3/4/7 | P0-P2 | 安全/功能/规范/UI | 2026-09-21 阻断项 | FIXED-UNCOMMITTED | 周期 1 §2 |
| DEF-A1..A4, C-1, P-1/4/5, DEF-D1, L-1, L-5 | P1-P2 | 表现/领域层 | 后台编辑器数据损毁 / 案例页崩溃 / 滑动 / 进度条 / 前导符号 / 错误吞没 / 命名冲突 | FIXED-UNCOMMITTED | 周期 2 §1;C-1 见 §2.2 REG-C1 |
| Sentry 接线 | P1 | 可观测性 | 「声明未接线」→ 已接(含 Turbopack 约定文件) | FIXED-UNCOMMITTED | 周期 2 §1.3;§1 复核存在 |
| N-24① | P2 | 门禁可信度 | axe 逐页状态断言(期望集感知) | FIXED-UNCOMMITTED | 周期 2 §3.7 双向对照 |
### 2.2 待产品 / 设计决策(代码侧不该替业务作答)
| ID | 级别 | 事项 | 入口 |
|---|---|---|---|
| REG-C1 | P3(**已复核,非活跃缺陷**) | C-1 归一在 `cases/[slug]/client.tsx:22,30-35`(唯一 importer),位置**正确**:恰在未受信任的 CMS 强转 `item.data as unknown as CaseStudyData` 边界处 `?? ''`/`?? []` 一次归一,`case-detail-page.tsx` 消费已定型 props 可信任(无第二个真实调用方)。周期 2 报告把它记在组件文件属**归属笔误**,非漏洞;**不**在组件内加冗余守卫(违反"不为不可能发生的场景加校验") | 仅更正周期 2 §1.2 的 file:line 归属 |
| DEC-N21 | P2→潜伏 | `'content-item'` 幻影 modelCode:周期 2 §5.3 以源码推翻「越权」定性,实为 **fail-closed**;真风险是将来被补进种子即成跨模型读取闸口。建议「缺 modelCode ⇒ 400」 | `admin/items/route.ts:79` |
| DEC-N21b | ~~P2~~ **2026-09-30 撤销该定性(原为假事实)** | 原文称「`/admin` 无服务端 gating、HTML 外壳无会话也下发,入口=无 `middleware.ts`」——**不成立**:Next 16 已把该约定文件更名为 `src/proxy.ts`(在 HEAD 内、已跟踪,`2297f01` 迁入),`:77-105` 对 `matcher: ['/admin/:path*']` 做 Edge HS256 校验并在缺令牌/验签失败时重定向登录页 ⇒ 服务端 gating **存在**。**改登记两条真残留**:① 只验签名与 `exp`、**不查 `User.status`** ⇒ 停用令牌的持有者仍能拿到 `/admin` 外壳 HTML(数据面由 Q-4 的 `authenticateActiveRequest` fail-closed 兜住);② `src/proxy.ts` **零测试**(`git ls-files` 无任何 proxy 测试) | `src/proxy.ts:77-105` |
| DEC-N30 | P1 | 四条互斥 SLA(工作日 2h / <4h / 48h / <2h·7×24)留哪一条 | 周期 1 §8.2 / 周期 2 §5.2 |
| DEC-D5 | P1 | `/products/erp-upgrade` 在线数字(`99.2%`/`40%+`/`从5天到1天`)在**活组件** `erp-upgrade-content-v2.tsx:63,69,77`,无 basis 无 MetricsBasisNote,且该路由无视觉基线 | 周期 2 §5.1 |
| DEC-D7 | P2 | news 正文字段声明 `richtext` 而 `renderField` 无该分支(能力缺口) | 周期 2 §5.3 |
| DEC-P2-motion | P2 | 动效门禁 23 处判红(20 缓动曲线 + 2 裸时长 + `--transition-gentle:1000ms`):改代码 or 承认为设计例外 | 周期 2 §3.5 |
| DEC-L3 | P3 | `client-ip.ts` 头部信任无条件;直暴露(非 nginx)时限流可被 `X-Real-IP` 自报绕过(须与部署协同,勿单独改) | 周期 2 §5.3 |
| DEC-L4 | P3 | 对称加密密钥来自公开 bundle 的 `NEXT_PUBLIC_ENCRYPTION_SECRET` ⇒ 仅混淆无机密性,文档口径不得当安全控制引用 | `crypto.ts:36` |
| DEC-P-2 | P3 | 死码族删除(`loading-state` 是 brand-token 唯一白名单豁免 N-8;另有 hero-section-v2/insight-card/industry-grid/三份 product-card/breadcrumb/micro-interactions/PullToRefresh 等) | 周期 2 §5.3 |
| DEC-N4-N23 | P1 | 安全头门禁默认打**线上** `novalon.cn` 而非本分支产物(声明与行为相反);改法涉 CI/`test:all` 语义 | 周期 1 N-23 |
### 2.3 待授权动作(阻塞验收;须逐项明文批准)
| ID | 动作 | 命令 | 为何阻塞 |
|---|---|---|---|
| **AUTH-D1** | ~~入库 / PR(验收唯一硬阻断)~~ **已闭合(2026-09-28)** | 三笔提交 `a366bd1`/`6bb7c55`/`a0328a6` 已入 `qa/seal-2026-09-28` 并推到 origin;工作树现仅 2 条未跟踪(PR 描述文件、`deliverables/`) | 原「363 条只在工作树 ⇒ 不可复现」的前提消失。**分叉真相已查明(2026-09-30 复核)**:内容层面 `git diff --name-status f543e47 origin/dev` = **15 文件全为新增(A)、+2092/−0**,即 origin/dev 是本链 rebase 后版本 + 一条 `chore(infra)`;但拓扑层面 `f543e47` **仍不是** `origin/dev` 的祖先(`rev-list --left-right` = 30↔31,同标题异 hash 的 rebase 残留)。⇒ 上面「须逐笔裁定冲突」的配方对本轮不再适用:实际做法是从 `origin/dev` 新切分支 + cherry-pick 三笔,PR diff 只含本轮 QA |
| AUTH-D2 | 重跑 seed | `npm run db:seed` | **2026-09-30 用户已裁定本轮含「生产库重 seed」**(前置硬条件:先 `cp data/prod.db prod.db.bak-<ts>` 快照——现网**无任何 DB 备份机制**)。必要性已升级:本分支改过 `prisma/seed.ts` 与 `prisma/seeds/*`(`team→team-page`、`legal→legal-page`、`+contact-page`、`+shellReadModels`),而 `src/lib/permissions.ts:26` 按 `modelCode` **精确匹配** ⇒ 不重 seed 则生产非 super_admin 角色继续持失效授予且缺 `content-model`/`content-zone` 读权(`admin/models`、`admin/stats`、`zones` 三处消费)。本地 `dev.db` 同样仍旧权限行 |
| AUTH-D3 | 视觉基线写入 | `npx playwright test visual-regression.spec.ts --update-snapshots` | **2026-09-30 实测口径(只读比对:94 passed / 31 failed)**:31 = **20 缺参照**(4 subject × 5 project:`/products/erp-upgrade` 全页、`/about/brand` 全页、L2 `product-card`、L2 `input-default`)+ **11 张已过时参照**(`/products/erp` ×5、`/solutions/manufacturing` ×5 = Q-5/S-2 网格修复的预期版面收缩,真实浏览器实证 computed 3/4/12 列;chromium-mobile `button-default` ×1 = 基线早于 N-15(c) `:visible` 选择器修正)。**两处更正**:① 原记「85 张 modified 未提交、视觉通过依赖未提交状态」**已失效**——107 张基线全部在库(`git ls-files e2e/visual-snapshots`),工作树干净;② 原记「`cases/[slug]` 从无基线」不准——`/cases` 与 `/cases/[slug]` **根本不在 `VISUAL_TEST_PAGES`(`e2e/visual-regression.spec.ts:26-43`)内**,属覆盖缺口而非缺参照 |
| AUTH-D4 | 写库 E2E | 完整 `npm run test` / `test:e2e:prod`(差 `cms-workflow`+`user-journey` 共 11 例) | 真写 `prisma/dev.db`;只读边界已实证,此 11 例是唯一未执行的功能层 |
| AUTH-D9 | Sentry 实投递 | 真实 DSN 起服务验证事件与 source map 上传 | 接线惰性有码路证据已足,但投递未线上验证 |
| AUTH-D10 | 全量变异测试 | 去 `--inPlace`(config 默认沙箱)跑 `mutate` 全集 | 成本/磁盘(峰值 1.7G 曾致 ENOSPC,周期 2 §3.9);须 ≥2G 余量与无并发门禁窗口 |
| AUTH-D11 | 门禁证据落盘 | `check:axe` 默认 `OUT` 按日期分目录(同步 Jenkinsfile);`docs/acceptance/**` 是否纳入版本控制 | 现固定目录互相覆盖证据且未跟踪(周期 2 §3.9) |
### 2.4 已知不稳定清单(**禁止用 retry / 放宽阈值「修」**)
- `mobile-user-journeys` UJ-10(firefox,隔离复跑通过)、`website-acceptance:111` 响应式(隔离通过)、`@accessibility` webkit 四例(周期 1 N-32,隔离不复现)。同属**并发 / 墙钟**族(周期 1 N-28:同一代码三轮失败数 8→1→5)。墙钟型用例(`p4:31`、`p4:68`)不该进共享并发门禁。
- **2026-09-30 新增同族实例**:`[firefox] uj-09-product-browsing.spec.ts:124` 在生产目标 92 例满并发批次里判红(`toHaveURL(/\/products\/?$/)` 收到 `""`,15s 等「返回 /products」的导航没完成),而**同批次另三引擎全绿、隔离单跑 1 passed(11.5s)、该文件 4-project 并发复跑两次各 4 passed**。⇒ 定性为并发/墙钟族而非代码回归;本轮 E2E 诚实口径是 **91 passed / 1 failed**,不得写成「92 例全绿」。取证:`docs/acceptance/2026-09-30-seal/e2e-production-writefree.txt`。
## 3. 提交前强制提醒(承接 memory 纪律)
- 提交只加自己的路径,**勿 `git add -A`**:`prisma/dev.db-shm`/`-wal` 未被 `.gitignore` 覆盖(周期 1 §7),`git add -A` 会把 SQLite 边车与陈旧 `dev.db`/`data.db`(周期 2 §3.9)扫入。
- 破坏性 / 共享状态动作(fetch/rebase/commit/push/merge/seed/写库 E2E/写基线/force-push)须**单独明文授权**,不夹带在常规变更里。
- 会话结束前披露工作树状态(本台账 §0/§2.3 AUTH-D1 即披露)。
## 4. 第三轮审查轴(2026-09-25 本会话,subagent 并行 + 主线逐条复核)
两条并行 subagent:① 全部 `src/app/api/**` 路由处理器安全/正确性审计;② `src/lib/**`+`src/components/**` 逻辑缺陷狩猎。均要求 CONFIRMED 附 file:line + 触发条件,并给出已知项围栏以防重报。**主线未照抄任何一条子代理结论**:定点复核 → 对拟修复项做 RED→GREEN。
### 4.1 主线已复核确认 + 已修 + RED 测试(工作树内,未提交)
| ID | 级别 | 缺陷 | 触发/影响 | 修复 | RED→GREEN 凭据 |
|---|---|---|---|---|---|
| **Q-1** | **P1** | **登出未清除服务端 httpOnly cookie**:`auth-context.tsx` `logout()` 只清 localStorage;但 login 经 `setTokenCookie` 写 `novalon_token`(24h)/`novalon_refresh`(7d),而 `authenticateRequest`(`auth.ts:74`) 回退读 cookie。`/api/auth/logout` 路由**存在却从无调用者** ⇒ 点「登出」后全站受守卫 API 仍凭 cookie 放行至多 24h/7d | 后台「登出」是**假登出**;共享/被盗机器上会话延续 | `logout()` 先 `POST /api/auth/logout`(触发 `clearTokenCookie`),网络失败也清本地并跳转 | 新增 `auth-context.test.tsx`(2 例):断言 fetch 到 `/api/auth/logout`+POST 与网络失败仍清理;**改前 1 failed(fetch 0 calls)→ 改后 2 passed** |
| **Q-2** | **P2** | **缩略图格式伪标**:`image-processor.ts` thumbnail 声明 ext `'webp'`(`buildDerivative(..., 'webp', ...)`)但缓冲只 `.resize().toBuffer()` 未调 `.webp()` ⇒ PNG/JPEG 上传的 `-thumbnail.webp` 实为原格式字节,Content-Type 与内容不符、零 WebP 压缩收益 | 落盘文件内容 ≠ 扩展名/MIME;`source type` 消费方受影响 | 缩略图管道加 `.webp({quality:80})` | 既有测试只断路径/尺寸、**从不验格式**(覆盖空洞);新增例断 `sharp(thumb.buffer).metadata().format==='webp'`(PNG/JPEG 双输入);**改前 `Received:"png"` → 改后 media 4 套件/60 例全通过** |
| **Q-3** | **P2** | **登录端点无限流**:`contact` 有 IP 限流但 `POST /api/auth/login` 无任何节流 ⇒ 匿名者可无限驱动 cost-10 bcrypt(CPU DoS)+ 离线式撞库 | 凭据填充 / CPU 耗尽 | 抽出可复用 `src/lib/rate-limit.ts`(时钟可注入 + `reset()`,**放进覆盖率棘轮内**),登录按 IP `max:10/15min` 且**判定在 bcrypt 之前**;contact 重构复用同一实现(消除副本) | 新增 `rate-limit.test.ts` 4 例(边界/独立 key/窗口过期/reset)+ 扩展 `login/route.test.ts` 一例:前 10 次 200、第 11 次 429 且 `verifyPassword` **仍只 10 次**(证限流省掉 bcrypt);**4/4 + 全 login/contact/auth 73 例通过**,`type-check` EXIT=0,改动文件 `eslint --quiet` 0 error |
| **Q-4** | **P2** | **停用账号令牌在 6 个内联 role handler 仍全权(N-20 同类,绕开已收口的 `checkUserPermission`)**:`admin/users` GET/POST/PUT/DELETE 与 `admin/roles` GET/PUT 用 `authenticateRequest`(仅验签名,不看 `User.status`)+ 内联 `userRole` 检查。⇒ 被停用但持 ≤24h 有效令牌的 super_admin 仍能列/建/改/删用户、重写权限矩阵 | 停用/离职管理员的残留令牌保留完整后台写权 | 抽出可复用 `authenticateActiveRequest(request)`(`permissions.ts`,`prisma.user.count({id,status:1})` 判活),**6 个 handler 全部改用它**并在角色检查/任何写入前 fail-closed | 在 `users/route.test.ts` 与 `roles/route.test.ts` 各加 2 例(停用超管 → 401 且 `user.create`/`user.update`/`$transaction`/`permission.*` 均未触达);既有 30+ 例在默认存活下保持通过 ⇒ **admin users/roles/permissions 3 套件/54 例全绿**,`type-check` EXIT=0,5 改动文件 `eslint --quiet` 0 error |
| **Q-5** | **P2** | **响应式网格被 `StaggerReveal` 单子吞成单列**:`content/sections.tsx` 的 `TechStackShowcase`/`DataProofSection` 把 `grid md:grid-cols-N` 挂在外层 div,而该 div 的唯一子元素是 `StaggerReveal`(渲染一个 motion.div,再为每卡片包 motion.div)⇒ 网格只有 1 个网格项,卡片在 md/lg 断点堆成单列、`gap`/`space-y` 失效;`FAQSection` 的 `space-y-3` 同理被吞。**这些组件是活的**(`product-detail-content-v3.tsx:335,343,357` 渲染产品详情页)。正确写法见 `l3-signals-slot.tsx:109-119`(网格类挂 StaggerReveal,其注释即记此坑) | 产品详情页技术栈/数据佐证/FAQ 桌面端单列,UX 退化 | 把网格/间距类移到 `StaggerReveal className`,删除多余外层 grid div(FAQ 仅移 `space-y-3`,保留 col-span 外层) | 在 `sections.test.tsx` 加 3 例,断言 `[class*="grid-cols-3"]`/`grid-cols-4`/`space-y-3` 元素的**直接子元素数 == 条目数**(旧结构下恒为 1 ⇒ RED);sections.test **28 例全通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
| **Q-7** | **P3** | **列表路由分页参数未校验(NaN→500 + 无界 take)**:`admin/items` GET 用 `parseInt(searchParams.get('page') \|\| '1')` ⇒ `?page=abc`→NaN→`skip:NaN`→真库 Prisma 抛错→500(应安全回落);`?pageSize=99999`→无界 `take`(任何 read 权限者可整表拉取大 `data` JSON)。`admin/users` GET 有 `Math.max/min` 夹取但 `Math.max(1,NaN)` 仍是 NaN ⇒ 同类未愈 | 500 崩溃 + 无界读取 | 抽出可复用 `src/lib/pagination.ts` `parsePagination(sp,{defaultPageSize,maxPageSize})`(NaN/0/负数→默认,超上限→夹取,取整),**items + users 两路都接入**(max 100) | `pagination.test.ts` 6 例(缺省/合法/非数字回退/夹取/取整,含"移除即崩"的核心 NaN 面)+ `items/route.test.ts` 1 例(`?page=abc&pageSize=99999` ⇒ 200 且 `findMany({skip:0,take:100})`,旧码为 `skip:NaN/take:NaN` ⇒ RED)。**pagination 6 + items 38 + users 18 全通过**,`type-check` EXIT=0,改动文件 `eslint --quiet` 0 error |
| **Q-8** | **P3** | **内容 ID 存在性枚举 oracle**:`admin/items` PUT/DELETE 与 `admin/items/[id]/workflow` POST 都先 `contentItem.findUnique`→`notFound('内容不存在')` **再** `requirePermission` ⇒ 匿名调用者可用「404=该 ID 存在 vs 401/403=权限屏障」枚举有效内容 ID(无写入先于鉴权,纯信息泄露面) | 未鉴权可枚举内容 ID | 三个 handler 均在存在性探针**之前**加 `if (!authenticateRequest(request)) return unauthorized();`(先认证→再 404→再 per-model 权限),关闭匿名枚举;记残留:已登录但无该模型权限者仍能分辨 404/403(把 notFound 与 forbidden 合流需改契约,未做) | `items` 2 例 + `workflow` 1 例:匿名 PUT/DELETE/workflow ⇒ **401 且 `findUnique` 未被调用**(证探针在认证门之后);两测试文件补 `jest.mock('@/lib/auth')` 默认有效会话使既有授权用例不受影响 ⇒ **items+workflow+pagination 3 套件/47 例全通过**,`type-check` EXIT=0,5 改动文件 `eslint --quiet` 0 error |
| **Q-10a** | **P3** | **`ui/button.tsx` 涟漪 id 用 `Date.now()`**:同毫秒两次点击 ⇒ 重复 React key + 清理 `filter(r=>r.id!==id)` 会一次删掉同 id 的多条涟漪;且 600ms `setTimeout` 卸载时从不清除(setState-after-unmount / 定时器泄漏)。Button 是全站在用组件 | 真实浏览器下重复 key 告警 + 卸载后定时器泄漏 | 涟漪 id 改自增 `useRef` 计数器(保证唯一);定时器收入 `useRef` 数组,`useEffect` 卸载时 `clearTimeout` 全部 | **诚实标注**:真正判别性(重复 key)在本环境不可测——做过 RED 探针(还原 `Date.now()` 后断言仍绿),因 Jest 跑 production React 构建、dev key 告警被剥离,React 18 也不再就 setState-after-unmount 告警。故只补**被改代码路径**的行为用例(点击→涟漪出现→600ms→清除,能捕获"永不清除/不出现"类回归),不谎称它是缺陷锁。**button 21 例通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
| **Q-10c** | **P3(隐私/同意 fail-open)** | **`analytics.ts` `getStoredPreferences` 把 `JSON.parse(...) as CookiePreferences` 原样透传,无字段校验**:而 `updateConsentDetailed` 用 `preferences.analytics ? 'granted':'denied'` 判定 ⇒ 被篡改/写坏的 `localStorage`(如 `{"analytics":"yes","marketing":1}`,或数组/数字等非对象)会以真值非布尔**意外授予** analytics/ad 同意 | 同意管理可被污染存储绕过(GDPR/隐私面) | 新增 `sanitizePreferences(raw)`:四个开关严格 `=== true` 才算同意(否则 false),`necessary` 恒真,`timestamp` 仅数字保留;`getStoredPreferences` 走它 | 2 例真判别(未修即 RED:旧码原样返回 `'yes'/1`,断言 `false` 必红):truthy 非布尔→false、非对象载荷→全 false 且 necessary 恒真;既有有效对象用例(`{necessary:true,analytics:false,marketing:true,functionality:true}`)经 `toEqual` 仍通过 ⇒ **analytics 31 例全通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
| **Q-10b** | **P3** | **`api-crypto.ts` 用客户端 `content-length` 判定是否有请求体**:`hasBody = contentLength && parseInt(contentLength) > 0`。加密的 POST/PUT/PATCH 若走**分块传输**(无 `content-length` 头,或该头被省略/伪造为 0)⇒ 被判「无 body」跳过解密,密文 `{data:"..."}` 原样交给 handler(`isEncrypted:true` 但体未解),handler `.json()` 拿到信封而非真实字段 | 加密通道在分块/缺头时静默不解密(功能正确性/健壮性) | 改按 **HTTP 方法**判体存在:`method ∈ {POST,PUT,PATCH}` 即尝试读体+解密(空体自然落回原路径),不再信 content-length | 新 1 例真判别(RED 探针实测:还原 content-length 版 ⇒ 该例判红;恢复 ⇒ 通过):加密 POST **无 content-length** ⇒ 断言 `mockDecrypt` 被调用且 handler 收到解密体;既有 26 例(全部 method+content-length 配对)不受影响 ⇒ **api-crypto 27 例通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
| **Q-9** | **P3** | **`admin/media` 多文件上传无原子性**:上传循环内 ① 某文件超 10MB 直接 `return validationError`,但**前面文件已 `uploadMedia` 落盘+入库**;② 某文件在 `uploadMedia` 内被 magic-byte/类型策略拒(抛 `UploadPolicyError`,外层 catch 返 400)同样留下前面已写入的文件 ⇒ 请求返回错误却已产生孤儿媒体资产(磁盘 + `MediaAsset` 行),无返回、无清理路径 | 半途失败留下孤儿资产(磁盘/DB 泄漏 + 计费/存储面) | 把尺寸校验提到**任何写入之前**(整批预检);上传循环包 try,失败时对本请求已成功的 `results` 逐个 `deleteMedia` 回滚再返回错误 | 新 2 例真判别(旧码必 RED):① 第二个文件抛 `UploadPolicyError` ⇒ 断言 `mockDeleteMedia('asset-1')` 被调用(旧码无回滚 ⇒ 不调用);② 批次含一个超限文件 ⇒ 断言 `mockUploadMedia` 从未被调用(预检在任何写入前拒整批)。既有单/多文件成功用例仍通过 ⇒ **media route 14 例通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
### 4.2 子代理上报、**主线尚未逐一复核**(登记为待验证,不当作已确认,不据此宣称已修)
| ID | 级别 | 摘要 | 位置(子代理所引) | 主线状态 |
|---|---|---|---|---|
| Q-4 | ~~P2 待复核~~ | ~~6 个内联 role 数组的 handler~~ | — | **已复核确认为真缺陷并已修**(见 §4.1 Q-4):status 维度缺位属实,role 授予逻辑本身仍正确 |
| Q-5 | ~~P2 待复核~~ | ~~外层 grid/space 被 StaggerReveal 单子吞成单列~~ | `content/sections.tsx` | **已复核确认为真缺陷并已修**(见 §4.1 Q-5):3 处组件为活代码(产品详情页),已把网格类挂回 StaggerReveal 并加 3 例结构断言 |
| Q-10 | P3 | 四条子代理上报:① `api-crypto.ts` `hasBody` 信任客户端 `content-length`;② `workflow.ts:84` `updateMany`+`auditLog.create` 非 `$transaction`;③ `analytics.ts:33` 同意偏好无字段校验;④ `button.tsx` ripple `Date.now()` 键碰撞 + 卸载不清 timeout | 各处 | **④=Q-10a、③=Q-10c、①=Q-10b 均已修**(见 §4.1,各带判别测试)。**仅 ② 未做**:修法需 interactive `$transaction(async tx=>…)`(update→读回→审计有数据依赖),会牵动 workflow 路由测试的 prisma mock 边界,风险高于其 P3 权重,暂缓并附精确配方 |
| Q-6 | P2 | `detail-product-value.tsx:73-91` render 体内 `setDisplayValue + requestAnimationFrame`(StrictMode/重渲染派生多串未取消动画) | 组件 `detail-product-value.tsx` | **待复核**:grep 显示该组件仅被 `products/erp-upgrade-v3/page.tsx` 引用,而周期 2 判定 `erp-upgrade-v3` 为**死路由** ⇒ 若确死则非在线缺陷,仅登记;render 副作用面仍宜在组件复用时修 |
| Q-7 | ~~P3 待复核~~ | ~~`admin/items`/`users` GET 分页未校验~~ | — | **已复核确认为真缺陷并已修**(见 §4.1 Q-7):新增 `parsePagination` 复用件,items + users 两路接入,6+1 例覆盖 |
| Q-8 | ~~P3 待复核~~ | ~~内容 ID 存在性 oracle~~ | — | **已复核确认为真缺陷并已修**(见 §4.1 Q-8):三 handler 认证前置于存在性探针,3 例证 `findUnique` 不被匿名触达 |
| Q-9 | ~~P3 待复核~~ | ~~多文件上传中途失败留孤儿~~ | — | **已复核确认为真缺陷并已修**(见 §4.1 Q-9):整批尺寸预检 + 失败回滚已成功文件,2 例真判别 |
### 4.3 主线**证伪**的子代理结论(不修,防把假发现写进代码/文档)
- **Q-FP-1**:子代理称 `detail-product-value.tsx:69` `parseFloat(value.replace(/[^0-9.]/g,''))` 把 `"1,000+"` 变成 `1`(千倍低估)。**不成立**——`[^0-9.]` 会删掉逗号、保留数字与点,`"1,000+"`→`"1000."`→`parseFloat=1000`,正确。故该解析点**不是缺陷**(其 render-副作用面另见 Q-6,属不同问题,仍待复核)。
> **本轮验证层级诚实说明**:`type-check` 为**全程序** `tsc --noEmit` 且 EXIT=0(覆盖 Q-1/2/3 全部改动);受影响单元套件(auth/login/contact/media/rate-limit)**73 例全通过**;改动文件 `eslint --quiet` **0 error**。但**全量 `test:coverage`(1725 例)本轮未重跑**,且 Q-1(表现层登出)与 Q-3(登录 API 行为)**不在**任何已跑过的 E2E 子集里 ⇒ 其生产目标凭据待 AUTH-D1 入库 + AUTH-D4 后统一复跑。Q-2(media 派生)真 `sharp` 单测覆盖格式,最直接。**Q-4 的凭据层级**:6 个 handler 的存活判定由 `admin/users`+`admin/roles` 路由级 jest(mock prisma.user.count)端到端覆盖(默认存活 30+ 例仍绿 + 停用 4 例判 401/零写入),属**单测层**,非 E2E;其"移除 helper ⇒ 停用令牌被放行"的 RED 逻辑由"旧码走 `authenticateRequest` 不看 status、新 mock 的 `count` 遂成死参数、断言 401 必红"反证。**验收判定不变**:新增修复同样只在主工作树,AUTH-D1 仍是唯一硬阻断。
### 4.4 本会话全量回归证据(2026-09-25,覆盖 Q-1…Q-5/Q-7/Q-8 全部改动之后)
| 门禁 | 命令 | 结果 |
|---|---|---|
| 全量单元 | `npm run test:unit` | **142 套件 / 1760 例全通过,0 失败**(较周期 2 的 137/1725 净增 5 套件 35 例,全为本会话新增 RED 测试;无一处回归) |
| 覆盖率棘轮 | `npm run test:coverage` | **EXIT=0,阈值全达标**:global **85.96 stmts / 87.57 branch / 81.38 funcs / 85.96 lines**(门限 75/82/75/75 **未下调**);本会话新增 `src/lib/pagination.ts`、`src/lib/rate-limit.ts` 各 **100/100/100/100**(在 `collectCoverageFrom` 的 `src/lib/**` 内,随棘轮受约束) |
| 真库集成层 | `npm run test:integration:real` | **EXIT=0,4 套件 / 23 例全通过**;一次性 `/tmp/novalon-itest.db`,teardown 守卫实测 `prisma/dev.db`、`dev.db`、`data.db` 的 inode+size+mtime 与运行前完全一致 ⇒ 本会话对 `permissions.ts`(新增 `authenticateActiveRequest`)与 users/roles/items/workflow 鉴权路由的改动在真库鉴权层无回归,且未污染开发库 |
| 静态 a11y(对比度/令牌) | `npm run check:contrast` + `check:brand-token` | 两者 **EXIT=0**:contrast 44/44 令牌配对满足 WCAG 2.1 AA;brand-token 扫描 406 文件 **0 违规**(1 处已知白名单降级 = `loading-state.tsx` 死组件,见 N-8/D-8)⇒ 本会话改动无对比度/品牌令牌回归 |
| 生产构建 + 装配 | `npm run build`(含 postbuild 拷贝) | **EXIT=0**,`dist/standalone/{server.js,dist/static,public}` 三项齐备(`ASSEMBLY_OK`)⇒ 本会话对 `api-crypto`/`permissions`/users·roles·items·workflow·media 路由的服务端改动可干净构建(N-9 前提成立);产物 `heading-hierarchy-report.json` 等落盘物均被 `.gitignore` 覆盖,不脏提交面 |
| 标题层级(产物上) | `npm run check:headings`(自起 standalone 扫 10 页) | **EXIT=0**:10 页全通过、0 问题 ⇒ 与 contrast/brand-token 合起来 **完整 `check:a11y` 三件套在本会话构建产物上全绿**(不再仅沿用周期 1/2 结论) |
| Lighthouse(产物上) | `npm run lighthouse`(lhci autorun 自起 standalone) | **EXIT=0**:对 9 URL × 3 次运行 = 27 次跑的全部断言通过(含本会话前几轮新加的 `inspector-issues` minScore 断言)⇒ 性能/a11y/BP/SEO 门禁在当前源码产物上仍达标 |
| 类型检查 | `npm run type-check`(全程序 tsc) | **EXIT=0** |
| Lint | `npm run lint` | **0 error / 104 warning**(与周期 2 口径 104 完全一致 ⇒ 本会话新文件 `rate-limit.ts`/`pagination.ts` 等**零新增债**) |
> 说明:**本会话已在含全部 Q 修复 + S-1 修复的最终树上重跑并 EXIT=0**:`test:unit`(1758)、`test:coverage`(阈值棘轮)、`test:integration:real`(23)、`check:contrast`/`check:brand-token`/`check:headings`(完整 check:a11y)、`npm run build`+装配、`npm run lighthouse`;`type-check`/`lint` 全程 EXIT=0。**仍未在本会话重跑**:全站 `check:axe`(需自起 standalone + crawl-routes 清单,端口/残留进程需专管)、生产目标 E2E(**注意 `npm run test:e2e:prod` 不排除写库 spec,跑它即触发 AUTH-D4**)、视觉只读比对(Q-5/S 系列改了布局,需 AUTH-D3 重基线)。周期 1/2 的这三项结论仍登记于各自报告。
## 5. 第四轮审查轴(2026-09-25,2 路并行 subagent:`src/app/**` 页面 + 余下 `src/components/**`)
两条只读 subagent 分别扫前几轮**只 grep 未逐行**读过的面。主线**未照抄任何一条**:S-1 我逐行核实并修复;其余登记为「待主线复核」,其中标注与前序已知项同机制的(Q-5/C-1 新点位)优先,因为修法现成。
### 5.1 主线已核实 + 已修(工作树内,未提交)
| ID | 级别 | 缺陷 | 触发/影响 | 修复 | 凭据 |
|---|---|---|---|---|---|
| **S-1** | **P2** | **首页 CMS 数组未逐条守卫 ⇒ 整页 RSC 崩溃**:`home-content-v15.tsx` 的 `ServicesSection` 只在 `:510` 校验 `services[0].subtitle`,随后 `:546` `service.highlights.map`(**无 `?.`/`Array.isArray`**,而 `:552` metrics 却有 `&&` 守卫);`CasesSection` 的 spotlight `:789` 用 `?.` 但 `restCases` `:828` `caseItem.metrics.slice` **未守卫** | 发布任一缺 `highlights`/`metrics` 的服务或案例 ⇒ 流量最高的首页 500 到 error.tsx | 两处改 `Array.isArray(x) ? x : []` 逐条守卫(与既有 `?.` 惯例一致) | `type-check` EXIT=0、`eslint --quiet` 0 error(改动文件);纯渲染守卫,行为对合法数据不变 |
### 5.2 子代理上报、待主线逐一复核(**不当作已确认/已修**)
| ID | 级别 | 位置 | 摘要 | 复核优先级/备注 |
|---|---|---|---|---|
| S-2 | P2 | `products/product-detail-content-v3.tsx:178,231` + `solutions/solution-detail-content-v3.tsx:121,168,223,278` | grid/`space-y` 挂在外层 div、唯一子为裸 `StaggerReveal` ⇒ `/products/[id]`、`/solutions/[id]` 桌面端塌成单列(**Q-5 同机制的新点位**) | **已复核+已修(6 处)**:同文件 :132 已是正确写法可佐证。安全修法——把网格/间距类移到 `StaggerReveal className`、外层 `<div>` 留作无类包裹(**不删闭合标签**,规避 Q-5 那次改动风险)。content-v3 三套件 25 例通过 + `type-check` EXIT=0 + `eslint --quiet` 0 error。需 AUTH-D3 视觉重基线确认像素 |
| S-6 | ~~P3 误报~~ | `cases/[slug]/page.tsx:27-34` | ~~`generateMetadata` 绕过 C-1 归一~~ | **主线核实为误报,未改**:`generateMetadata` 已用 `data.challenge?.substring` / `data.metrics?.map`,对**缺键**的保护与 `client.tsx` 的 `?? []` 同级,并非"绕过 C-1"。唯一残余是**类型错误值**(如 metrics 存成字符串),但那对 client 路径同样会崩,属通用运行时类型校验缺失(非元数据专属崩溃),不在本轮改 |
| S-3 | P2 | `about/page.tsx`、`contact/page.tsx`、`products/erp-upgrade/page.tsx` | 无 `export const revalidate`,且 `/api/cms/revalidate` 未映射这些模型 ⇒ 构建后发布新内容永不刷新(并含「`revalidateTag` 因 `data-server.ts:37` 用 React `cache()` 而非 `unstable_cache` 实为 no-op」的重断言) | 高但**涉渲染配置/缓存语义**,须逐条核 next 行为再定改否(可能引 ISR/构建变化) |
| S-4 | P2 | `home-content-v15.tsx:32-43`(用于 :510-516) | `FALLBACK_SERVICES` 兜底含 `40%`/`6个月` 等**无 basis 的数字**,N-30 类第三处残留,违背零编造 | 中:修法=删兜底 metrics(与 N-30 一致);属内容口径,宜确认后改 |
| S-5 | ~~P2 待复核~~ | `detail/detail-hero.tsx:171-184` + `micro-interactions.tsx:148-153` | `<a href><PressableButton/></a>`,而 PressableButton 渲 `<motion.button>` ⇒ button 嵌进 a(无效交互嵌套) | **已复核+已修**:根因在 `PressableButton` 的 href 分支本就产 `<a><button>`。改为有 href 时渲单个 `motion.a`(承载按钮样式),`detail-hero` 去掉外层 `<a>` 直接传 `href`;`onClick`/样式保留,导航语义不变。新增 `micro-interactions.test.tsx` 2 例真判别(旧码 `querySelector('button')` 非 null ⇒ RED;且发现 `detail.test.tsx` mock 掉了 PressableButton,故测真组件须单列)|
| S-7 | P3 | `services/[id]`/`solutions/[id]`/`products/[id]`/`news/[slug]` 的 page | `dynamic='force-dynamic'` 与 `generateStaticParams`/revalidate 冲突 ⇒ SSG 产物永不服务,注释与单测给假信心 | 中:涉渲染模式口径,须核 next16 行为再定 |
| S-8 | ~~P3 待复核~~ | `hero-particle-field.tsx:287-290` | `onVisibility` 未判相交态即 `start()` ⇒ 离屏 canvas rAF 空转 | **已复核+已修**:加 `intersecting` 跟踪(IO 回调置位),`onVisibility` 改为「可见且 `intersecting`」才启动,与 :271 契约对齐。凭现有 hero-particle-field 三套件/36 例(含 reduced-motion 降级、unmount 停环)无回归 + `type-check`/lint 绿;**未加专测**(jsdom 下 visibilitychange+IO 离屏组合难做判别性 RED,诚实标注)。首页活组件(home-content-v15) |
| S-9 | ~~P3 待复核~~ | `back-to-top.tsx:12-20`;`detail-trust-section.tsx:18-65` AnimatedCounter | 挂载未初始同步;裸 rAF 计数不查 `useReducedMotion` | **两处均已修**:back-to-top effect 内补 `handleScroll()` 初始同步;AnimatedCounter 在 `shouldReduceMotion` 时直接落终值不跑 rAF(`useReducedMotion` 自绘,因 `MotionConfig` 不管裸 rAF)。back-to-top by-construction(jsdom `scrollY` 只读难判别,未加专测,诚实标注);AnimatedCounter 由 detail.test 27 例 + 全量 `test:unit` 142/1760 + `type-check`/lint 绿佐证无回归 |
| S-10 | P3 | `admin/content/[modelCode]/page.tsx:210` 状态误标(review→「已归档」);`admin/roles/page.tsx:59-79` effect 依赖 `selectedRole` 覆未保存编辑;`admin/users/page.tsx:85` 搜索无防抖/序号守卫(`content/[modelCode]` 已修,此处未);`admin/media/page.tsx:38,131` 单 `fileInputRef` 挂两个 input ⇒ 顶部按钮重选同文件不触发 onChange;`admin/page.tsx:108`/`media/page.tsx:40` 吞错显示「空」非报错;`admin/login/page.tsx` label 无 htmlFor、密码切换钮无 aria-label | 后台多处 P3(错标/竞态/吞错/a11y 标签) | 中:逐条小修,部分与既有模式(防抖/seq)现成可搬 |
> 诚实边界:S-2…S-10 为 subagent 上报,**我尚未逐行独立复核**,不作「已确认/已修」主张;S-1 是我本轮亲自核实并修复的唯一项。子代理另排除了 `cta-section`(零 importer,其「30 分钟内响应」是 DEC-N30 的第 5 条 SLA 变体,仅附记)、Radix 包装件、`slider`(零消费者)等——同样待我复核后再采信。
## 6. 会话收尾与续工交接(2026-09-25,subagent 架构系统性 QA)
> 本文件(`qa-tracker.md`)即 objective 阶段3 要求的「问题跟踪机制」单一真源;§4 为第三轮(API+lib/组件)、§5 为第四轮(src/app 页面 + 余下组件)审查轴。
### 6.1 本会话已完成(均在工作树,**未提交**)
- **已核实并修复的缺陷(含判别性测试):Q-1、Q-2、Q-3、Q-4、Q-5、Q-7、Q-8、Q-9、Q-10a、Q-10b、Q-10c、S-1、S-2(6 点位)、S-5**;**S-8、S-9** 经检查修复(诚实标注:jsdom 无法做判别性 RED,仅 by-construction + 现有套件/类型门禁)。
- **主线证伪、未改的子代理断言**:`1,000+→1` 解析(实为 1000,正确)、C-1 归属笔误、S-6(metadata 已 `?.` 守卫,非绕过 C-1)。
- 自纠:一次 Edit 误删既有测试体(已复原);一次写了不能失败的假测试(已换成诚实版);一次 §4.4 表格被打断+留陈旧说明(已合并修正)。
### 6.2 本会话门禁证据(最终树,全部 EXIT=0,见 §4.4 表)
`test:unit` **142 套件/1760 例** · `test:coverage`(阈值未下调,新 lib 100%)· `test:integration:real`(23,`dev.db` 指纹未变)· 完整 `check:a11y`(contrast 44/44 · headings 10/10 · brand-token 0 违规)· `npm run build`+standalone 装配 · `npm run lighthouse`(9 URL×3)· `type-check` · `lint` 0 error/104 warning。
### 6.3 工作树披露(最高优先,勿静默留给下一个人)〔本节数字为 2026-09-25/28 当时实况,**已被 §8 封版记录取代**〕
`git status --porcelain` = **378 条**(54 未跟踪),HEAD 仍 `f543e47`。⇒ 两轮 + 本会话全部修复**只在工作树**,未提交/未 PR ⇒ 不可审、不可复现、不可 CI 验证。**这是 objective 阶段5「可交付」未达成的唯一实质原因。**
> **2026-09-28 第五轮后刷新**:`git status --porcelain` = **394 条**(55 未跟踪),HEAD 仍 `f543e47`。本轮净增 16 条改动/新文件(含新测试文件 `src/app/__tests__/cms-page-revalidate.test.ts`)。结论不变。
### 6.4 续工:待授权动作(逐项明文批准后才动;见 §2.3 / 周期报告 §5)
1. **AUTH-D1 入库/PR**(解锁验收):先 `git fetch origin dev` 取真值 → 裁定 `origin/dev`↔HEAD 双向分叉的重复提交对 → 按「表现层/后台编辑器/Sentry/测试装配/文档口径 + 本会话 Q/S」分笔提交 → 过 `scripts/check-pr-checklist.sh` → Gitea PR。**`git add` 按路径,禁 `-A`**:`.gitignore` 未挡 `prisma/dev.db-shm`/`-wal`,`-A` 会带入 SQLite 边车。
2. **AUTH-D4 写库 E2E**(11 例,真写 `dev.db`;⚠ `npm run test:e2e:prod` 不排除写库 spec,跑它即写库)。
3. **AUTH-D3 视觉基线**:Q-5/S-2/S-5 改了布局,产品/方案/案例详情页需人工核看后 `--update-snapshots`。
4. **AUTH-D2 seed**:使周期2 L-2 权限修复对数据生效。
### 6.5 续工:待复核/待决策的登记项(不阻断验收)
S-3(about/contact/erp-upgrade 无 revalidate + revalidateTag no-op,涉渲染配置)、S-7(force-dynamic vs generateStaticParams)、S-4(FALLBACK_SERVICES 无 basis 数字,宜按 N-30 删)、S-10(后台状态误标/搜索竞态/媒体双 input ref 冲突/登录表单 label 关联)、S-9 子项(detail-trust 裸 rAF 未查 reduced-motion)、以及周期1/2 遗留的 D-1…D-11 / DEC-* 决策项。
## 7. 第五轮审查轴(2026-09-27…28 会话,4 路并行 subagent + 主线逐条复核/修复)
承接 §6.5 的续工清单:S-3/S-4/S-7/S-10/Q-6/Q-10② + 未逐行覆盖的余下面(hooks、lib/cms 渲染器、seo/analytics 组件、marketing 残余页面)。主线未照抄任何子代理结论:逐条亲读源码复核后再修,修复均带判别性测试(RED→GREEN 实测)。
### 7.1 主线已复核并修复(工作树内,未提交)
| ID | 级别 | 缺陷(主线核实后口径) | 修复 | RED→GREEN 凭据 |
|---|---|---|---|---|
| **S-21**(=DEC-D7 落地) | **P2** | `renderField` 无 `richtext` 分支 ⇒ news 正文/legal 正文落 default 单行 `input[type=text]`,浏览器 value 消毒剥掉全部 `\n`,编辑一次即**静默损毁段落**(详情页 whitespace-pre-line 渲染) | richtext 走 `textarea`(rows=12);顺带收敛出作用域读写机制 | 新增 3 例读写保真测试;改前 `Expected TEXTAREA, Received INPUT` 判红 → 改后编辑器套件 **22/22** |
| **S-22** | P3 | array/object 子字段编辑器读写**顶层** `formData[field.name]`:编辑写不进数组,却把 `label/value` 垃圾顶层键混进保存载荷(假成功) | array 改整体 JSON 编辑(复用 JsonEditor);object 子字段以 `scope{parent,write}` 读写父对象并合并回写 | 同上:改前 `getByLabelText('指标')` 无 TEXTAREA / `作者` 值为空 判红;改后载荷断言 `metrics` 回写数组、无泄漏顶层键 |
| **Q-10②** | **P2** | `workflow.ts` 状态更新→读回→审计三条独立写:审计失败时**状态已落库但无审计**,调用方收 500 误以为流转未发生 | 交互式 `prisma.$transaction(async tx …)` 包住 CAS→读回→审计;通知保持在事务外(不回滚不上抛的既有语义不变) | 测试 mock 增加带快照回滚的 `$transaction` 桩(数组形态直接判红防退化);升级既有「审计失败 fatal」例为回滚断言:改前 storedItem 停在 published 判红 → 改后 28/28;**真库集成层 `test:integration:real` 23/23 EXIT=0(dev.db 指纹守卫通过)** |
| **S-3** | **P2** | `/about`、`/contact`、`/products/erp-upgrade` 无 `revalidate` 导出且 revalidate 路由无映射 ⇒ 构建后发布的 CMS 内容**永不刷新**(子代理实证:三页在 `prerender-manifest` 为 `static + initialRevalidateSeconds:false`)。附带断言 `revalidateTag` 全程 no-op **成立**(全站无 `unstable_cache`/`'use cache'`/fetch tags 消费点,React `cache()` 仅请求内去重) | 三页加 `export const revalidate = 3600`(与其余 14 页同档)+ 路由补 about-page/contact-page/product→`/products/erp-upgrade` 三条映射(推送即秒级失效,3600 为无推送兜底) | 新增 6 例(3 route 映射 + 3 页 revalidate 导出,新文件 `src/app/__tests__/cms-page-revalidate.test.ts`):改前 6 例全判红 → 改后 25/25;**产物级实证**:重建后 `dist/prerender-manifest.json` 三页 `initialRevalidateSeconds=3600` |
| **S-10 六条** | P3×6 | ①列表状态列把 review/archived 误标「已归档」②roles 的 `fetchRoles` 依赖 `selectedRole`,切角色 refetch 覆盖未保存编辑 ③users 搜索逐键打后端且无 seq 守卫(乱序响应覆盖新结果)④media 双 input 同挂一个 ref(重选同文件不触发 onChange)⑤admin 首页/media/zones 吞错显「空」(假绿)⑥login/zones/users 弹窗 label 无 htmlFor、密码显隐钮无可访问名 | ①四态 STATUS_LABELS 映射 ②`fetchRoles` 依赖清零 + `setSelectedRole(prev=>prev||…)` ③搬 SEARCH_DEBOUNCE_MS+fetchSeqRef 现成模式 ④全页单 input + 程序化 click ⑤error state + 横幅 ⑥补 id/htmlFor + `aria-label` 随状态切换(实施走 general-purpose subagent,主线逐 diff 复核 + `selectedRoleInfo` 等符号存在性核实) | 改动 8 文件 eslint --quiet 0 error;`content/[modelCode]/page.test.tsx`(防抖+乱序 2 例)通过;全量回归见 §7.4 |
| S-11/S-12/S-13/S-15 | P3 | zones 吞错显空 / notifications 翻页无 seq 守卫 / roles 矩阵 super_admin 全显「未授权」与「拥有所有权限」文案矛盾 / zones·users label 关联(S-10 同族扩散) | 与 S-10 一并修(error 横幅、fetchSeqRef、super_admin 整行按已授权呈现、htmlFor) | 同上 |
| **S-23** | P3 | `ui/animated-counter.tsx` `displayValue = start ? count : value`:未入视口直显**终值**,IO 异步首回调后跳回 0 再爬升(先给答案再数) | `displayValue = shouldReduceMotion ? value : count`(useCountUp 未启用期本就停在起点 0) | 新 1 例(IO 桩驱动):改前判红(旧码未相交即显 500)→ 改后 6/6;既有用例改 `startOnView={false}` 语义不变 |
| **S-24** | P3 | `PerformanceTracker` CLS 累加器在 observer 回调**内**:分批到达的 layout-shift 每批只报增量,GA 收到的永不是会话总 CLS | 累加器提到回调外,每批上报累计值 | 新 1 例双批次断言 [≈100, ≈150](旧码第二批报 50 ⇒ RED 由形状显然)→ 改后 17/17 |
| **Q-6** | P3 | `detail-product-value.tsx` MetricCard render 体内 setState+rAF:探针实证**每帧 setState 触发重渲染又 spawn 一条从 0 开始的动画链且从不 cancel**,假时钟下大字永远停在 '0';卸载后帧链继续排队 | 动画收入 `useEffect`,cleanup `cancelAnimationFrame`;NaN 回退同 effect | 新 1 例(faithful rAF 桩:cancel 真撤销排队):改前判红(旧实现卸载后 sched 继续增长)→ 改后 28/28。**注**:第一版测试命中 benefits 同名文本属假绿,已被探针推翻重写(诚实记录) |
### 7.2 主线复核后的定性变更(不改代码,只改台账口径)
| ID | 原登记 | 复核结论 |
|---|---|---|
| Q-6 路由定性 | 「`erp-upgrade-v3` 死路由 ⇒ 若非活码仅登记」 | **定性修正**:不是死路由,是**零入口孤儿路由**(不在 sitemap、src 内零内部链接,但静态可直达且有真实渲染)。缺陷本身属实已修(见 §7.1),影响面限直达 URL |
| S-4 | 「FALLBACK_SERVICES 无 basis 数字,N-30 类残留,宜删」 | **降为 DECISION(DEC-S4)**:子代理实证 fallback 与 CMS 数据走同一渲染 map,`:562` 对每张卡(含 fallback)渲染 `<MetricsBasisNote basis={weakestBasis(…)}>`,未声明 basis 一律保守落 `target` 角注 ⇒ **并非裸奔编造**,与 N-30(虚构佐证)不同类。残余问题:硬编码数字本身无出处 + fallback 触发条件(CMS service 缺失/首条无 subtitle)。是否删数字属内容口径,留业务裁定 |
| S-7 | 「force-dynamic + generateStaticParams 冲突 ⇒ SSG 产物永不服务」 | **CONFIRMED 但判为设计取舍**(子代理引 bundled docs `caching-without-cache-components.md:97` + `prerender-manifest` 实证四路由不在产物中;页内注释表明有意为之:硬 404 + 新内容首请求可见)。不自动改渲染模式,登记为 DECISION(承 DEC-N21b 同级) |
| S-14 | clipboard 无 catch | 随 S-10 批修(`.catch` + toast.error),SUSPECTED 定级不变 |
### 7.3 子代理上报、主线**证伪或不修**(防假发现入库)
- MetricCard `parseFloat('1,000+')→1` 类解析问题在本组件不成立(`[^0-9.]/` 保留数字与点),与 §4.3 Q-FP-1 同族。
- hooks 面(use-focus-trap/use-swipe-gesture/use-reduced-motion/useCountUp)、analytics 其余 tracker、structured-data、lib/cms 其余模块:子代理逐文件扫描后**无新缺陷上报**(含监听清理、capture 分工、XSS sink 检查均通过)。
- 死码新增:`CookieSettingsButton`(零 importer,连带「重开偏好面板不与已存同意同步」的潜在缺陷一并挂账)、`getInitialShowConsent` 三分支恒 false(死但无害)。
### 7.4 本轮收尾门禁(2026-09-28 最终树)
| 门禁 | 结果 |
|---|---|
| type-check | EXIT=0(一次 tsc 报错为 Q-6 测试 mock 类型断言丢失 `.mock`,已修后复跑绿) |
| lint | 0 error / **104 warning**(2026-09-30 在 sealed 树 `a0328a6` 复测仍为 104;本表 §4.4 记 104、此处曾记 105,且 `AGENTS.md` §5 亦记 105 并给出「分项相加=105」的自洽说明 ⇒ **现值以 104 为准**,105 口径已过期。本轮零新增债) |
| test:coverage | EXIT=0,**143 套件 / 1772 例全通过**(较 §6.2 净增 1 套件 12 例,全为本轮判别测试) |
| test:integration:real | EXIT=0,4 套件 / 23 例,dev.db/data.db inode+size+mtime 守卫通过(workflow `$transaction` 改动在真 SQLite 无回归) |
| check:contrast / brand-token / headings | 44/44 · 0 违规 · 10/10 页,均 EXIT=0 |
| build + standalone 装配 | EXIT=0,ASSEMBLY_OK;`prerender-manifest` 实证三页 ISR=3600(S-3 产物级) |
| lighthouse | EXIT=0,9 URL × 3 次 = 27 run 全部断言通过(lhci autorun 自起 standalone :3200) |
## 8. 封版记录(2026-09-30,现行判定)
**判定:封版通过(含例外清单)。** 代码封版点 = `a0328a6`;完整判定书、逐条判红定性与例外登记见 **`docs/acceptance/2026-09-30-seal/final-verdict.md`**,原始门禁输出同目录(`axe/`、`e2e-production-writefree.txt`、`visual-readonly.txt`、`security-headers-artifact.txt`、`check-motion.txt`、`lint.txt`、`type-check.txt`、`grid-structure-report.json`、`visual-check/*.png`)。
本轮在 sealed 树上补齐的 6 项(前几轮从未跑过):
| 门禁 | 退出码 | 结果 |
|---|---|---|
| `build:clean` + `postbuild` 装配 | 0 | `dist` 377M(清理前 2.5G,含 `dist/dev` 2.1G 开发缓存);standalone 三件套齐备 |
| 全站 `check:axe` | **0** | `PASSED=true`,34 路由 × (chromium,firefox) × (light,dark)=136 页,`violationNodes/contrastNodes/bgMismatch` 全 0;唯一 non-2xx = `/_not-found`(设计如此) |
| 产物安全头(`--url http://localhost:3100/`) | **0** | 7 PASS / 1 WARN(HSTS 边缘注入) / 0 FAIL,**每头单次** ⇒ 线上重复头确系 nginx+Next 两层叠加 |
| 生产目标 E2E(排除两个写库 spec) | **1** | **91 passed / 1 failed**;唯一红为 firefox UJ-09 并发墙钟(§2.4),`dev.db` 指纹跑前后一致 ⇒ 未写库 |
| 视觉只读比对(`--update-snapshots=none`) | **1** | **94 passed / 31 failed** = 20 缺参照 + 11 已过时参照(全部可归因,见 §2.3 AUTH-D3);未写任何基线 |
| `check:motion` | **1** | 23 处(20 曲线 + 2 裸时长 + 1 上限),与周期 2 同数未新增;属 DEC-P2-motion 待裁定 |
| `npm run lint` / `npm run type-check` | 0 / 0 | 0 error / **104 warning**(105 口径作废);tsc 0 error |
**封版不变式(为何不重跑全套)**:本轮唯一新提交是纯文档提交 S,`git diff --name-only a0328a6..S` 全部落在 `docs/**` 与 `*.md` 内 ⇒ `a0328a6` 上的绿灯对 S 恒等成立。S 的 sha 与清单见 `final-verdict.md` §6。
**本轮同步更正的台账假事实**(均为「文档写了但当场复核不成立」,已就地标注):§0 判定与 `:3-4` 的 HEAD/工作树状态、§2.2 **DEC-N21b**(`/admin` 其实有服务端 gating,入口是 `src/proxy.ts` 而非 `middleware.ts`;真残留=不查 `User.status` + 零测试)、§2.3 **AUTH-D1**(已闭合)、**AUTH-D3**(107 张基线全在库、缺参照实为 20 张、`/cases` 属覆盖缺口)、**AUTH-D2**(本轮含生产重 seed 及其权限依据)、§7.4 lint 104。
**发布侧未闭环(不属验收判定,见判定书 §5)**:`deploy:rollback` 不回滚容器/`public/`;`deploy.sh status` 不报磁盘;`rsync --delete public/` 与 `./uploads` 卷的关系部署前必须核实;nginx 安全头去重须单独投递。
---
## §8 2026-10-08 · agentic 工具化轮次(作者侧 AI),提交 `1b5c75a`(本地未推)
本轮性质:**新增 e2e spec + 文档**,零生产源码改动 ⇒ 按 §7「封版不变式」只作废受影响的门禁行(`test:functional`、视觉只读、type-check、lint),不重跑全套。
### §8.1 选型与落地
| 项 | 判定 | 证据 |
|---|---|---|
| 采用 Playwright Test Agents(planner/generator/healer)作**作者侧** AI | ✅ 已落地 | 随本仓实装 `playwright@1.60.0` 自带 `init-agents`;agent 定义源 `node_modules/playwright/lib/agents/*.agent.md`;`.mcp.json` 指向仓内 `run-test-mcp-server`,**未新增依赖、未装 `@playwright/mcp`**;Playwright 自身不调 LLM ⇒ 运行期零模型 |
| 引入 `tester-army/e2e`(agentic 框架,Apache-2.0,7.5k★,`e2e@0.18.0`) | ❌ 本轮不引入 | 第二套 runner + `playwright-core 1.63.0`(与实装 1.60 并存两套浏览器二进制);无像素基线比对;官方文档明确不模拟 touch / color-scheme / reduced-motion ⇒ 接管不了 107 张参照、5 个 visual project 的 `reducedMotion:'reduce'`+`scale:'device'` 体系与 axe light\|dark;PR 报告器为 GitHub 形状而本仓是自建 Gitea。判据全表见 `docs/testing/agentic-test-authoring.md` |
| 候选淘汰 | 记录 | `@antiwork/shortest` npm 冻结 0.4.9/2025-04-01;`magnitude-test` 0.3.13/2026-02-08 停更;Stagehand v4 缓存仅 Browserbase 云端(本地每次推理);Skyvern AGPL-3.0 且 npm 无 `skyvern` 包;商业侧(QA Wolf/Virtuoso/Mabl/Momentic/Autonoma/bug0)云端执行或 GitHub-only,无 Gitea |
### §8.2 本轮新增用例(`e2e/nav-keyboard.spec.ts`,tag `@a11y`,4 例)
补的是真实空白:主导航 mega dropdown 此前只有 hover 路径(`nav-dropdown.spec.ts:8,28`),jsdom 单测 `mega-dropdown.test.tsx:55-74` 用 `fireEvent` 测过 Escape,但 `relatedTarget` 与真实焦点顺序在 jsdom 不成立。契约逐行取 `src/components/layout/mega-dropdown.tsx:35-46,62-76,94-178`。
| 读数 | 值 |
|---|---|
| dev 目标四 project | **10 passed / 6 skipped**,EXIT=0 |
| `E2E_TARGET=production`(三桌面 project) | **10 passed / 2 skipped**,EXIT=0 |
| 稳定性(`--workers=1 --repeat-each=3`,firefox+chromium) | **24 passed / 0 failed** |
| 是否进快速集 | 否:`test:e2e:fast` grep `@smoke\|@critical`,本 spec 为 `@a11y` ⇒ `test:all` 时长不变 |
| type-check / lint(提交后树复跑) | EXIT=0 / EXIT=0,本文件 0 告警;全仓 **104 warning**(沿用 §7 口径) |
**两条测到并定性的引擎/目标差异(都不是本仓缺陷,未用守卫压红)**:① WebKit 本机不响应真实 Tab——连续 4 次后 `activeElement` 仍是 `BODY`,而 `.focus()` 有效且 `matches(':focus')=true`,与 §N-27 同源(macOS WebKit 未开全键盘访问)⇒ 仅依赖 Tab 遍历的 2 例按 `browserName==='webkit'` 跳过(含 `chromium-mobile`);② dev 目标下触发器 DOM 节点在 hydration 后被**整体替换**(失败样本 `click=1` 而 `aria-expanded` 恒 false,通过样本 `click=0` 而 `aria=true` ⇒ 监听绑在已被换掉的旧节点上),生产产物不复现 ⇒ `openWithKeyboard()` 用 `toPass()` 重发**交互**(对齐 `primary-nav.ts:11-14` 既有写法)。移动断点另记:桌面 mega dropdown 在 390px 下整体不渲染(`element(s) not found`),抽屉导航的键盘契约须另立 spec。
### §8.3 视觉只读比对(本轮当前树复跑)
`npx playwright test visual-regression.spec.ts --update-snapshots=none`(dev 目标,125 例,5.1 分钟):
- **94 passed / 31 failed,EXIT=1** ⇒ 与 §7(2026-09-30 实测 94/31)**逐项同数**,本轮提交对视觉**零外溢**。
- 分层读数(剥 ANSI 后现取):**20 例缺参照**(`A snapshot doesn't exist`:`/products/erp-upgrade`、`/about/brand`、L2 卡片、L2 输入框 × 5 project)+ **11 例参照已过时**(`toHaveScreenshot(expected) failed`:`/products/erp` ×5、`/solutions/manufacturing` ×5 = Q-5/S-2 网格修复的预期版面收缩,样例差异 2,578,230 px / ratio 0.22;chromium-mobile 按钮 ×1 = 基线早于 N-15(c) `:visible` 修正)。
- **只读性已验**:`git status --porcelain e2e/visual-snapshots` = 0 修改、0 新增未跟踪 PNG(显式带 `--update-snapshots=none`,否则默认 `missing` 模式会静默新建 20 张参照)。
- dev 侧仍见 `eval() is not supported... CSP` + `React will never use eval() in production mode` 成对刷屏,即 N-11 在 dev 的形态;产物目标与 Lighthouse 口径不受影响(9/9 全 100),不列为阻塞。
### §8.4 台账假事实更正(本轮)
- `AGENTS.md:159` 的「磁盘上 85 张基线 PNG 相对 HEAD modified / 视觉通过依赖未提交状态」就地加日期更正——现取 `git ls-files e2e/visual-snapshots` = **107 张全部已入库、工作树干净**(同 §5.32)。**注**:`AGENTS.md` 被 `.gitignore:316` 排除,更正只作用于本机,不入提交;已入库记录在 `docs/lessons-learned.md:505`。
- 作废一条我自己写错的待办:`@playwright/test ^1.58.2` 与实装 `1.60.0` **并非矛盾**(caret 允许),先前记为「过期数字」不成立。
- 既存错位登记不改:`@playwright/test` 声明在 `dependencies` 而非 `devDependencies`,移动会影响构建依赖面,须作为独立动作。
### §8.5 待授权清单(本轮一律未执行)
| # | 动作 | 状态 | 判据 |
|---|---|---|---|
| A | `git push`(`qa/seal-2026-09-28` 领先 origin **3** 笔,2026-10-08 现取;原文记 2 笔是 `19569f6` 提交前的数字) | **已执行(2026-10-08,用户批准)** | 已推 `a0328a6..1396666`(4 笔,含本台账数字校正一笔);快进推送,无 force |
| B | 建 PR / 合并到 `main`(`HEAD` 领先 `origin/main` **37** 笔、落后 0) | ~~不可执行~~ **判据作废**(2026-10-08 17:53 复核) | 原文「本环境**无 Gitea token**」是**假事实**:探测只 grep 了环境变量与 `~/.config/gitea`,漏了 `credential.helper=osxkeychain`(keychain 里确有 `git.f.novalon.cn` 条目,`GET /api/v1/user` 现取 200)。PR 实际已于 §10.7 建成 **#29**。教训入 `docs/lessons-learned.md` §5.35 |
| C | `npm run deploy`(`scripts/deploy.sh deploy`,变更线上) | **仍不建议本轮执行** | 原理由 ①「视觉门禁 EXIT=1」**已于 2026-10-08 消除**(见 §9);剩下的 ② 需先完成 B 才谈得上「发布 seal 内容」、③ `deploy:rollback` 不回滚容器/`public/` 回滚面弱,两条仍成立 |
| D | 20 张缺参照的 `--update-snapshots` 写授权 + 11 张过时参照的人工追认 | **已执行(2026-10-08,用户裁定「两者都授权」)** | 写入 38 张文件(= 31 例的文件级读数)入 `6ff19d1`;逐张读图核看已完成,只读复跑 **125/0 EXIT=0**。详见 §9 与 `docs/acceptance/2026-10-08-baselines/attribution.md` |
| E | N-15 剩余死选择器交 healer 清理 | **本轮不执行(用户裁定)** | 与 D 绑定;D 已单独收口,且 §9 实测证明 N-15(b) 的 card/input 选择器**已在树内修好**(`data-testid` 锚点 + `form input:visible` + 蜜罐契约断言),healer 的必要性已低于台账原判断 |
---
## §9 2026-10-08 · 收尾轮:AUTH-D3 视觉基线入库,视觉层首次转绿
本轮性质:**测试资产(参照 PNG)+ 文档**,零生产源码改动。上一轮(§8)把 D/E 挂起为「须人工核看」,本轮由用户裁定「缺参照与已过时两者都授权」后执行。
### 9.1 授权 → 执行 → 读数
| 项 | 动作 | 读数 / 证据 |
|---|---|---|
| A 推送 | `git push origin qa/seal-2026-09-28` | 快进 `a0328a6..1396666`(4 笔)成功,EXIT=0,无 force;远端回显 PR 创建入口 |
| D 写入 | `npm run test:visual:all -- --update-snapshots` | 125 passed / 4.3m / EXIT=0;写盘 **38 张**(25 新 + 13 覆盖),日志内 `writing actual` 行数 = 38,与 `git status` 逐项吻合 |
| D 复核 | `npm run test:visual:all -- --update-snapshots=none` | **125 passed / 0 failed / 4.1m / EXIT=0**;复跑期间 `git status --porcelain e2e/visual-snapshots` 仍为 25 `??` + 13 ` M` ⇒ 只读性成立 |
| D 入库 | `6ff19d1` | 44 文件(31 A + 13 M):38 张参照 + 6 份取证(`docs/acceptance/2026-10-08-baselines/`) |
| E healer | 用户裁定本轮不动 | 见 9.2-③,前提已部分失效 |
| 未跟踪 3 项 | 用户裁定保持未跟踪 | `.pr-seal-2026-09-28.md`、`.pr-seal-2026-09-30.md`、`deliverables/` |
| 门禁作废面 | 按 §8「封版不变式」只重跑受影响行 | 视觉层重跑并转绿;`src/**`、`package.json`、`next.config.mjs` 零改动 ⇒ type-check/lint/单测/axe/E2E 绿灯继续成立 |
取证目录 `docs/acceptance/2026-10-08-baselines/`:`head.txt`(生成树 `1396666`)、`pre-run-count.txt`(107)、`pre-run-worktree.txt`(空)、`update-run.txt`、`readonly-rerun.txt`、`attribution.md`(38↔31 对账 + 13 张尺寸归因表 + 逐张读图结论)。
### 9.2 三条新事实(不是复述 §8)
1. **裸 `--update-snapshots` 的真实语义是 `changed`,不是 `all`**:`node_modules/playwright/lib/program.js:202` 定义 `preset: "changed"`,`common/index.js:584` 缺省 `missing`。⇒ 只有「缺参照」与「比对不符」才写盘,**通过的参照不会被顺手改写**。这条决定了本轮 13 张覆盖全部是真判红,也推翻了「`-u` 会污染通过项」的担忧。
2. **文件级 ≠ 用例级,历轮数字必须标口径**:台账一直在用例级说「20 缺 + 11 过时 = 31」,写盘是 38 张文件。差额 7 张全部来自一例多 shot:`表单输入框` 一例两 shot(`visual-regression.spec.ts:200,204`)、`按钮组件` 一例三 shot(`:112,116,120`)。今后登记基线数须写明是「张」还是「例」,否则 §2.3 AUTH-D3 的「107 张 / 20 例」这类混用会再次出现。
3. **N-15(b) 的 card/input 死选择器实测已在树内修好**,§8.5 E 的前提对这两例不再成立:card 走 `[data-testid^="bento-product-card-"]` + `role="listitem"` + `data-bento-size` 三重钉住(`:154-157`),input 走 `form input:visible` 并把蜜罐的存在/隐藏属性**单独断言成契约**(`:181-189`)+ `name ∈ /^(name|email|phone|subject)$/` 回归护栏(`:198`)。healer 剩余价值只在「其他仍死的判据」,不是这两例。
### 9.3 逐张读图核看(把「人工追认」做实,而不是批量放行)
- `input-default-visual-chromium-desktop.png`:真实姓名框 + placeholder「请输入您的姓名」⇒ 没有把反垃圾蜜罐拍成批准基线。
- `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` 里逐字一致 ⇒ 新参照与既有批准基线同形。
- `button-default-visual-chromium-mobile.png`:132x132(44 CSS px × DPR3)汉堡按钮,正是 N-15(c) 认定的 390px 下唯一真实可见按钮;旧参照是 186x96 的桌面下拉触发器 ⇒ 覆盖方向正确。
- 13 张覆盖的尺寸归因见 `attribution.md` §3:桌面/平板/webkit 全页收缩 1005–4034px(Q-5/S-2 网格修复),mobile 按钮 186x96→132x132(`:visible` 修正)。
### 9.4 自证循环的处置(为什么这次「绿」仍然可失败)
基线由本轮自采,采集当下的绿本身不含信息量。使其仍具判别力的四点:① 容差未动(`e2e/playwright.config.ts:38-40`,`maxDiffPixels: 200` / `maxDiffPixelRatio` / `threshold: 0.3` 与历轮一致,无放宽);② `changed` 模式不重写通过项(9.2-①);③ 判定用的是**另一次独立运行**,写盘与只读之间隔了完整 server 生命周期(起停各一次);④ 三张关键新参照经人眼读图而非仅看退出码(9.3)。
**本小结初稿曾有一条错判,已作废并就地更正(双归零)**:原写「chromium-mobile 两页 +30/+21px 未归因;本轮相对 `a0328a6` 零生产源码改动 ⇒ 位移只能来自运行期(CMS 数据行或日期派生内容)」。参照系用错了——旧参照的**采集树**是 `040951c`(2026-09-22),最后被改动是 `6bb7c55`(09-28 10:48),而当前树含 `a366bd1`(09-28 10:48:07 第五轮)与 `a0328a6`。实测归因:`src/components/detail/detail-product-value.tsx` 的 Q-6 修复把指标 count-up 动画从 **render 体内**(每帧 `setState` 再 spawn 一条从 0 起的 rAF 链、从不取消)迁入 `useEffect` 并加取消 ⇒ 旧参照拍到的是**动画竞态中间帧**,新参照是稳定终态,位移属预期改进。现场取证法:`docs/acceptance/2026-10-08-baselines/row-diff.cjs`(sharp 逐行比对)现取首个发散行 y=7440,正落在 `/products/erp` 的 `benefits` 价值列表段。
**管理归零(写进检查口径)**:「本轮相对上一轮零源码改动」只支撑**门禁绿灯平移**,**不支撑**「参照与当前树同源」;判红归因必须对「基线采集树 vs 当前树」做 diff。历轮把 11 例笼统记为「网格修复的预期收缩」正是漏了这个参照系,才让 mobile 那 2 例看起来「无因」。
**改判后仍留的一条风险**:Q-6 族若还有其他 render 体内动画,基线仍可能冻结中间帧;125/0 只证明**当前树自洽可复现**,不证明「参照 = 用户所见」。
### 9.5 更新后的待授权清单(下一轮从这里接)
| # | 动作 | 状态 | 判据 |
|---|---|---|---|
| B | 建 PR / 合并 `main` | ~~人工可解,脚本不可解~~ **脚本亦可解**(2026-10-08 17:53 作废本行判据) | 「本环境无 Gitea token」的探测是**假阴性**:我当时跑的 `git config --get-regexp -i ...` 因 `-i` 不是合法开关而**报错**,却被 `2>/dev/null` 吞掉 ⇒ 把「命令失败」读成「查无此项」。凭据其实在 `credential.helper=osxkeychain`(由 `/Applications/Xcode.app/.../git-core/gitconfig` 的**系统级**配置提供),`GET /api/v1/user` 现取 200 ⇒ PR 已建成 **#29**(§10.7)。教训入 `docs/lessons-learned.md` §5.35。**PR 描述文件现状**:`.pr-seal-2026-10-08.md`(过门禁 EXIT=0)已作为 #29 的 body;`.pr-seal-2026-09-30.md` 叙述停在 seal 轮,不再用于建 PR |
| C | `npm run deploy` | 仍不建议 | 理由 ①(视觉 EXIT=1)已消除;② 需先完成 B、③ `deploy:rollback` 不回滚容器/`public/` 两条仍成立 |
| F | 推送本轮基线与文档 | **已执行(2026-10-08,用户「采纳建议」)** | 两次快进推送、无 force:`a0328a6..1396666`(4 笔)与 `1396666..6c9900f`(5 笔,含 `6ff19d1` 的 **17MB 新增参照二进制**,已知情);现取 `git rev-list --count origin/qa/seal-2026-09-28..HEAD` = **0** |
| G | 移动档 +30/+21px 归因 | **已完成(本轮内,且推翻了自己的初判)** | 用 `row-diff.cjs` 定位发散行 y=7440 → `/products/erp` 的 `benefits` 段;根因是 `a366bd1` 的 Q-6 count-up 动画修复(旧参照冻结了动画中间帧)。取证法与教训见 9.4 |
| — | AUTH-D2(重 seed)/ D4(写库 E2E 11 例)/ D9(Sentry 投递)/ D10(全量变异)/ D11(证据目录口径) | 状态不变 | 见 §2.3 |
### 9.6 文档同步与本树一手复测(收尾轮末笔)
**一手复测**(此前只在 PR 描述里沿用他轮读数,不符合「门禁命令实际执行过」条):`npm run type-check` **EXIT=0**;`npm run lint` **EXIT=0 / 0 error / 104 warning**。日志 `/tmp/tc-1008.txt`、`/tmp/lint-1008.txt`(临时件,不入库)。
**四处文档同步**(视觉层转绿后原叙述即成假事实):
| 文件 | 更正 |
|---|---|
| `docs/development/quality-gates.md` §6.2 | **文档与代码矛盾**:原文写「`--update-snapshots` 不带值时 Playwright 取 `missing`」——实为 **`changed`**(`program.js:202` 的 `preset`),`missing` 是**完全不带旗标**时的缺省(`common/index.js:584`)。已改写两种触发条件的差异,并把读数更新为「封版树 94/31(历史)→ 2026-10-08 基线闭合后 125/0」,附「例数 ≠ 张数」与「归因须对采集树 vs 当前树」两条口径 |
| `docs/testing.md` 视觉节 | 参照计数 107 → **132**(5 project 各 **26** + `manual-acceptance/` 2);原「用例数 − 参照数 = 覆盖空洞」的算式已不成立,改为**三个 shot 归组来源**(按钮一例三张、输入框一例两张、L3 两例零张);N-15 覆盖空洞标注为已闭合并写明现在的语义锚点 |
| `README.md` 进度区 | 撤下「视觉回归在封版树上实测 94/31」的现行口径(改为历史 + 125/0 现况);例外清单里的「视觉基线」移出待授权项;新增 2026-10-08 轮次条目(agentic 选型 + `nav-keyboard` + AUTH-D3 闭合 + §5.33 教训);台账指针 §8 → **§9** |
| `AGENTS.md`(**被 `.gitignore:316` 排除,仅本机**) | 视觉回归行的 21 失败/104 通过/94-31 系列读数标注作废并指向 §9;lint 行补 2026-10-08 一手复测 104;`-u` 模式描述同 `quality-gates.md` 更正 |
**PR 描述**:新建 `.pr-seal-2026-10-08.md`(覆盖 `a0328a6..HEAD` 全链,含 §8/§9 两轮),`bash scripts/check-pr-checklist.sh .pr-seal-2026-10-08.md` ⇒ **EXIT=0 通过**。按用户裁定与 `.pr-seal-2026-09-*.md` 同列**保持未跟踪**,需要时直接粘进 Gitea 表单;上一份 `.pr-seal-2026-09-30.md` 的叙述已停在 seal 轮,**不得再用于建 PR**。
---
## §10 2026-10-08 · 生产发布(用户指令「提交变更并发布到生产」)
### 10.1 发布内容与序列
| 步 | 动作 | 读数 / 凭据 |
|---|---|---|
| 1 | `npm run build` | **BUILD_EXIT=0**,产物 BUILD_ID `uiV6QrbCH7jmurgLVp-nd`(树 `19079e1`,代码封版点仍是 `a0328a6`);`postbuild` 已装配 standalone 三件套(`dist/standalone/{server.js,dist/static,public}`) |
| 2 | 预生产演练(**部署前**) | 从服务器取 `prod.db` 副本(413,696 B)→ `PORT=3111 DATABASE_URL=file:/tmp/prod-copy.db node dist/standalone/server.js` → 14 条真实路由**全 200**(`/`、`/products/{,erp,erp-upgrade}`、`/solutions/{,manufacturing}`、`/about{,/brand}`、`/contact`、`/news`、`/cases`、`/services`、`/methodology`、`/admin/login`) |
| 3 | 生产库快照 | `data/prod.db.bak.20261008_173048`(AUTH-D2 的硬前置;此前仅有 `bak.20260820_093111`) |
| 4 | 远端 dist 快照 | 脚本自动产出 `dist_backup_20261008_173111` |
| 5 | `./scripts/deploy.sh deploy --skip-build` | **DEPLOY_EXIT=0**;步骤 3/5/6/6.5 全绿,容器重建后 `curl 127.0.0.1:3000` 就绪,`verify_remote` 五页 200 |
上传前把 `dist/dev`(606M) 与 `dist/cache`(193M) 清掉,实际上传 205M(服务器出网带宽仅 ≈1Mbps,见 `docs/deployment.md` §6.5)。
### 10.2 本次部署引入的线上回归(已恢复,≈4 分钟)
**症状**:部署后首页 HTML 200,但其引用的 `/_next/static/chunks/*.js|*.css`、`/favicon.ico` **全 404**(nginx 应答,`try_files $uri =404`)⇒ 真实用户看到的是无 CSS、无 JS 的破站。
**根因**:远端 nginx 的站点根 = 上传后的 `dist/`,要求磁盘上存在 `dist/_next/static/**`;而 `next build` 出的是 `dist/static/**`,`postbuild` 只补容器形态。**这份「web root 镜像」历史上由旧发布流程产出**(`dist_backup_20260905_113209/` 顶层确有 `_next/static` 与合并的 `fonts/ images/ *.svg`),本次 `rsync --delete` 把它抹掉了。`nginx access.log` 现取 **2026-10-07**(部署前)同一 URL 为 200 ⇒ 确证是本次部署引入,非既有状态。
**恢复**:在服务端补做镜像(`mkdir -p dist/_next && cp -R dist/static dist/_next/static && cp -R public/. dist/`,**纯新增、零删除**)+ `chown www-data` / `chmod 755`。恢复后:首页与 `/products/erp` 引用的 **19+ 件资源全 200**;`/images/logo-white.svg` 仍 404 属正确行为(该路径在 `public/` 里不存在,是我构造的探测 URL)。
**门禁盲区(管理归零)**:`verify_remote` 只 curl 五个 HTML 路径,所以它在破站状态下打印了「✅ 生产环境验证通过 / 🎉 部署成功」。**HTML 200 ≠ 站点可用**。
### 10.3 已落地的两处修复(`scripts/deploy.sh`,同笔提交)
1. **步骤 1.5**:上传前本地生成 web root 镜像(`dist/static → dist/_next/static`、`public/. → dist/`),并在 `dist/static` 缺失时**终止部署**而非静默继续。
2. **`verify_remote` 资源级断言**:部署后从首页 HTML **实际引用的 URL** 取前 5 个 `/_next/static/*.{js,css}` + `/favicon.ico`,逐个断言 200,任一非 200 即 `return 1`。**负对照已实测**:把取样 URL 换成不存在者 ⇒ `RED 404` 且 `failed=1`,证明该断言可失败。`bash -n` 通过,`deploy --dry-run` 复跑 ⇒ 六项取样全 200。
### 10.4 线上健康证据(Playwright 无头,`chromium`)
| URL | stylesheets | h1 / 字号 | 品牌红 | 4xx·5xx GET | console error |
|---|---|---|---|---|---|
| `/` | 2 | 「让每一家企业都拥有数据驱动的决策能力」/ 81px `geistSans` | 命中 | **0** | **0** |
| `/products/erp` | 2 | 「睿新ERP管理系统」/ 81px | 命中 | **0** | **0** |
| `/contact` | 2 | 「随时欢迎聊一聊」/ 108px | 命中 | **0** | **0** |
`TOTAL_FAILED_GETS=0`。安全头单次下发已核(`server: nginx` + CSP/HSTS/XP 等一组,无重复头报错);线上 nginx 的 `X-Frame-Options: SAMEORIGIN` 与仓内 `next.config.mjs` 的 `DENY` 叠加问题仍在(判定书 §5 已登记,修复须单独投递 nginx conf)。
### 10.5 发布后仍未闭合(须单独授权)
| # | 项 | 现状与依据 |
|---|---|---|
| AUTH-D2 | ~~生产 `db:seed` 未执行~~ **已执行(2026-10-08 17:47,用户「授权你完成」)** ⇒ 过程与事后核验见 **§10.6** | 原判据(保留作依据链):`prod.db` 里 `Permission.modelCode` 是旧码 `team`/`legal`(各 11 条),而 `ContentModel.code` 已是 `team-page`/`legal-page`/`contact-page`/`navigation`/`methodology`/`page-copy`/`site-config`(16 个模型)⇒ `src/lib/permissions.ts:26` 精确匹配下非 `super_admin` 四角色无授予。结果:**+63 条授予、删除 0**,覆盖 `contact-page,content-model,content-zone,legal-page,methodology,page-copy,team-page`。实际机制是第四条候选(esbuild 打包 + 停容器 + 用生产镜像跑),非原列 ①②③ |
| H | ~~compose 配置漂移~~ **已消除(2026-10-08 17:49)** ⇒ 见 §10.6 | 先 `diff` 证明服务器与仓内**只差那一行挂载**才动手;备份 `docker-compose.server.yml.bak.20261008_174943`;重建后 `docker inspect` 现取 `./uploads -> /app/public/uploads`。**未做**:真实上传一次验证持久化(需后台凭据) |
| I | ~~`cmd_rollback` 不重建容器~~ **已修(`722f08a`)** | `cmd_rollback` 在恢复 `dist/` + 重载 nginx 后追加 `docker-compose build && up -d` 与就绪轮询,并复用已升级为资源级的 `verify_remote`;`bash -n` 通过 |
| J | ~~无 PR 记录~~ **PR #29 已建(→ `dev`,`mergeable: true`)** ⇒ 见 §10.7 | 「本环境无 Gitea token」是**假事实**:`osxkeychain` 里有凭据,API `GET /user` 现取 200。`origin/main` 落后 46 笔,dev→main 须另开 PR(`Jenkinsfile:407-429` 在 `main` 上有自动部署阶段,不可由本 PR 顺带触发) |
| K | ~~新登记:seed 覆盖缺口~~ **撤销(2026-10-08 18:0x 复核,是我造的假事实)** | `navigation` 与 `site-config` **不是漏发**,而是刻意设计:`prisma/seed.ts:241-242` 原文写明「属站点级配置,刻意仅 super_admin 可维护(`hasPermission` 的 super_admin 全权短路,`src/lib/permissions.ts:24`),不进上表」,并由 `src/lib/seed-permissions.test.ts:18-19` 的 `SUPER_ADMIN_ONLY_MODELS = ['site-config','navigation']` 与 `:50` 的用例「每个真实内容模型都被授予非超管角色(**除刻意 super_admin 独有的站点配置**)」双向钉住。⇒ seed 跑完后这两个模型对非超管无授予是**预期状态**,无需改动。**我违反的是本仓 `docs/lessons-learned.md` §5.32 自己立过的规则**(「某能力缺失」的断言落笔前须给:现行约定、按能力检索、正向证据三条)——只看了矩阵里没有就下结论,没读矩阵上方的注释与同名门禁测试 |
### 10.6 发布后三项闭环(用户「授权你完成」,2026-10-08 17:47…17:52)
**AUTH-D2 生产 `db:seed` —— 已执行**。做法不是登记录制的三条候选,而是第四条:**用 esbuild 把真 seed 打成单文件,在停容器窗口内用同一生产镜像跑**(避开「服务器无源码、容器无 `tsx`、宿主 node 20 无 `node:sqlite`」三重限制,也不整库换文件)。
| 步 | 动作 | 凭据 |
|---|---|---|
| 1 | 打包 | `npx esbuild prisma/seed.ts --bundle --platform=node --format=esm --banner:js=createRequire` → 705 KB(cjs 格式会因 `import.meta` 报错,ESM 需补 `createRequire` 才能 `require('fs')`) |
| 2 | **先在生产库副本上演练** | `DATABASE_URL=file:/tmp/prod-seed-rehearsal.db` ⇒ REAL_EXIT=0,`🎉 数据库初始化完成` |
| 3 | 逐表差异(决定要不要动生产) | `Permission 132→195(+63,**删除 0**)`、`ContentItem 37→38`(新增 `methodology/default`)、**24 条条目 title/data 随 seed 源更新**、`User/Role/UserRole/ContentModel/ContentZone/MediaAsset/AuditLog/Notification` 行数全不变 |
| 4 | 风险量化后才动手 | `prisma.user.upsert` 的 `update:{}` ⇒ 口令不覆盖(事后逐字节比对三个账号 `password` 与 `createdAt` **全部 identical**);`contentItem.deleteMany` 仅在 `CASE_STUDIES.length===0` 时删 `case-study`,而生产该模型 **0 条** ⇒ 删除命中 0;prod.db 自 **Aug 20 12:03** 无写入 ⇒ 24 条 data 更新覆盖的是种子自身旧值,不存在人工编辑被抹 |
| 5 | 生产执行 | 快照 `data/prod.db.bak.20261008_174734-preseed` → `docker stop` → `docker run --rm --env-file .env.production -e DATABASE_URL=file:/app/data/prod.db -e PRISMA_QUERY_ENGINE_LIBRARY=... -v data:/app/data -v seed.bundle.mjs:/seed.mjs:ro --entrypoint node novalon-website:latest /seed.mjs` → `🎉 数据库初始化完成` → `docker start` |
| 6 | 事后核验 | 取回 `prod.db` 比对:**+63 / −0**,新授予恰好覆盖 `contact-page,content-model,content-zone,legal-page,methodology,page-copy,team-page`;容器 `health=healthy`;Playwright 三页 `4xx/5xx GET=0`、`console errors=0` |
| 7 | 清理 | 服务端 `seed.bundle.mjs` 已 `rm`(一次性工件,不留在生产目录) |
**当时记为「残留缺口 K」、随后被自己推翻**:`navigation` 与 `site-config` 在 seed 跑完后仍无授予,我判成「seed 覆盖缺口」。**该判断是错的**——`prisma/seed.ts:241-242` 的注释与 `src/lib/seed-permissions.test.ts:18-19,50` 的 `SUPER_ADMIN_ONLY_MODELS` 门禁证明这是**刻意的站点级配置独占**(仅 `super_admin` 可维护)。K 已在 §10.5 就地撤销,教训归属 `docs/lessons-learned.md` §5.32(本仓早已立过「按缺推断机制不存在」的规则,本轮我自己重犯)。
**H compose 挂载漂移 —— 已消除**。先 `diff` 确认服务器与仓内版本**只差那一行挂载**(不整文件覆盖未知定制),备份 `docker-compose.server.yml.bak.20261008_174943` 后同步,`docker-compose up -d` 重建。现取 `docker inspect` Mounts = `./uploads -> /app/public/uploads` ✓(旧值 `/app/uploads`)。**未做**:真实上传一次以证明落盘持久(需后台凭据,留作人工验证)。
**I `cmd_rollback` 不重建容器 —— 已修**(`scripts/deploy.sh`):回滚在恢复 `dist/` + 重载 nginx 之后,追加 `docker-compose build && up -d` 并轮询 `127.0.0.1:3000` 就绪,失败即 `exit 1`;随后走**已升级为资源级**的 `verify_remote`。`bash -n` 通过。
**J PR —— 见 §10.7**。**C 之外的 `deploy` 未再触发**:本轮所有生产变更均由 `deploy.sh` + 上述受控步骤完成,未跑 CI。
### 10.7 J PR —— 已创建 **#29**(`qa/seal-2026-09-28` → `dev`)
凭据来源:本机 `credential.helper=osxkeychain` 存有 `git.f.novalon.cn` 条目,`GET /api/v1/user` 现取 **HTTP 200**(login `zhangxiang`)⇒ 先前「本环境无 Gitea token、PR 不可执行」的判断**是错的**,已就地更正(密钥全程未回显,body 经文件传递而非 shell 拼接)。
| 项 | 值 |
|---|---|
| 链接 | `https://git.f.novalon.cn/novalon/novalon-website/pulls/29` |
| base / head | `dev` ← `qa/seal-2026-09-28`(API 回读确认) |
| 状态 | `open`、**`mergeable: true`**、`changed_files: 555` |
| 范围 | `origin/dev..HEAD` = **15 笔**(dev tip 是 `040951c`;含代码封版点 `a366bd1`/`6bb7c55`/`a0328a6`) |
| 描述 | `.pr-seal-2026-10-08.md` 全文 + 前置说明(生产已按 `a0328a6` 发布,本 PR 补治理痕迹) |
| 门禁 | `bash scripts/check-pr-checklist.sh .pr-seal-2026-10-08.md` **EXIT=0** |
**未合并,且刻意不合并**:`origin/main` 落后 46 笔(main tip `7df2dde`),而 `Jenkinsfile:407-429` 在 `branch 'main'` 上挂有「🚀 部署到生产环境」阶段 ⇒ 任何把这条链推上 `main` 的动作都会触发**无人值守的二次发布**。合并本 PR(→dev)不触发该阶段,但仍应由人决定;dev→main 另开 PR。
**证据目录**:`docs/acceptance/2026-10-08-release/` —— `build.txt`、`deploy.txt`(含步骤 1.5 与资源断言)、`type-check.txt`、`lint.txt`、`seed-rehearsal.txt`(副本演练)、`seed-diff.mjs` / `seed-diff.txt`(逐表差异,可复跑)、以及本节的线上核验读数(Playwright 三页 `TOTAL_FAILED_GETS=0`)。
### 10.8 第二次发布(2026-10-08 18:0x,`npm run build && ./scripts/deploy.sh deploy`)
**目的**:① 让线上产物对应已提交的树;② **端到端验证 §10.3 的发布链修复**(第一次部署时镜像是手工补的,修复本身还没在真实部署里跑过)。
| 检查 | 结果 |
|---|---|
| 构建 + 步骤 1.5 | `CHAIN_EXIT=0`;本地生成镜像 `dist/_next/static` 存在,新 BUILD_ID `HCvsEIztksM1GCWBJBrRP` |
| **资源级断言(新门禁首次实战)** | `verify_remote` 取样 6 件(5 个 `/_next/static/chunks/*.js` + `/favicon.ico`)**全 200** ⇒ 破站路径已被脚本自身堵住,不再依赖人工复核 |
| 产物同源 | 线上首页引用的 chunk 逐个回查本地 `dist/_next/static/**` ⇒ **同源命中**(chunk 名未变属预期:本轮只改文档,客户端代码无变化;BUILD_ID 已变证明是新构建) |
| 容器 | 重建后就绪轮询通过;Playwright 三页 `stylesheets=2`、品牌红命中、`4xx/5xx GET=0`、`console errors=0`,`TOTAL_FAILED_GETS=0` |
| 回滚锚点 | 本次部署前脚本自动产出新的 `dist_backup_*`(保留最近 3 份),DB 侧另有 `prod.db.bak.20261008_174734-preseed` |
证据:`docs/acceptance/2026-10-08-release/deploy-2.txt`(含步骤 1.5 与六项资源断言的原始输出)、`probe.mjs`(线上体检脚本,可复跑)、`build.txt`/`deploy.txt`/`seed-*`/`type-check.txt`/`lint.txt`。
**K 项已撤销**(见 §10.5 与 §10.6 的就地更正):`navigation`/`site-config` 无授予是 `prisma/seed.ts:241-242` 明示、`src/lib/seed-permissions.test.ts:18-19,50` 门禁钉住的**刻意站点级独占**,不是缺口。我上一笔据「矩阵里没有」就下结论,重犯了本仓 `docs/lessons-learned.md` §5.32 已立过的规则。
### 10.9 治理闭环:#29 已合并进 `dev`,#30 开向 `main`(2026-10-08 18:21)
| 项 | 值 |
|---|---|
| **#29** | `qa/seal-2026-09-28` → `dev`,**已合并**(`merged_at 2026-10-08T18:21:42+08:00`)。合并方式取 **fast-forward-only**(`allow_fast_forward_only_merge = true` 现取)而非仓库默认的 `rebase`:`origin/dev` 是 `HEAD` 的严格祖先 ⇒ FF 后 **15 笔 sha 逐字不变**,`origin/dev` tip = `104ec7d`。理由:本仓 AUTH-D1 已记过 rebase 造成「同标题异 hash」的拓扑分叉之痛(`f543e47` vs `origin/dev` 的 30↔31 假分叉),FF 既保线性又保 sha 可引用 |
| **#30** | `dev` → `main`,**open / `mergeable: true`**,46 笔,`main`(tip `7df2dde`) 是 `dev` 的严格祖先 ⇒ 同样可 FF。描述里显式写了「**合并即触发 CI 生产部署**」与三条 CI 侧已知风险(`check:motion` 23 处判红、视觉层依赖 CI 环境字体/DPR、变异与全站 axe 的成本) |
| 为什么 #30 不由我合 | `Jenkinsfile:407-429` 的「🚀 部署到生产环境」带 `when { branch 'main' }` ⇒ 点合 #30 = 授权一次无人值守线上发布。生产**已经**按 `a0328a6` 发布并验证两次(§10.1、§10.8),所以 #30 的价值只在治理同源,不在交付;触发二次发布不该由代理决定 |
| 凭据路径 | `credential.helper=osxkeychain`(Xcode 系统级 gitconfig 提供)→ `git credential fill` → Gitea API `POST /pulls`、`POST /pulls/{n}/merge`。PR body 一律经文件传递,避免 shell 把反引号当命令替换(本轮就因此丢过一次 `dev` 字面量) |
---
## §11 2026-10-17 · 对标语法批(Bain / Porsche Consulting)UI·UE·UX 重构
分支 `worktree-ui-grammar-two-axis`,基线 `da9a5cb6`。范围按决策四取 **tracer-bullet 一批**:
首页(`home-content-v16`)+ 一条承载详情页(`/solutions/[id]`)端到端,其余模板待验收后再套。
决策与实测判据全文见 [ADR-0008](adr/0008-benchmark-grammar-takeover.md)。
### 11.1 本轮新增的仪器(每台都配"能失败"的证据)
| 仪器 | 判据 | 自证 / 负对照 | 现读 |
|---|---|---|---|
| `scripts/check-visual-grammar.mjs`(`check:grammar`) | R1–R11 把对标语法钉成机器判据;每条报分母,分母 0 = 未能度量(EXIT=2,不与判红共用 EXIT=1) | `check:grammar:selftest`:R1–R9 喂已知违规必须全判红;R10 棘轮「28 不判红 / 29 判红」;R11「未声明引用判红 / 已声明不误报」 | 11/11 成立,EXIT=0 |
| `scripts/check-accents.mjs`(`check:accents`) | 营销面不得出现 `accent-*` 类彩色编码;豁免**按文件名**登记,命中归零亦判红 | `check:accents:selftest` 三情景**各测一维**(违规 / 豁免腐化 / 全绿)——第一版把互斥前提塞进同一份夹具,导致腐化那一维永远测不到,EXIT=1 自证失败 | 扫 251 源文件,命中 31 处全在 3 条豁免内,EXIT=0 |
| `scripts/dead-modules.mjs`(`check:dead`) | 从真实入口做 import 闭包判可达性 | 修四轮才可信(动态 import 边、多根、根级 `app/layout.tsx` 入口正则、绝对/相对路径不一致);不可度量时 EXIT=2 | dead 0(17 个已删) |
| R11 僵尸令牌守卫 | tailwind 映射的 `var(--*)` 必须在 `globals.css` 有声明 | **负对照已执行**:把 `--shadow-brand`/`--shadow-glow` 映射塞回 tailwind ⇒ EXIT=1、2 条判红;还原 ⇒ 11/11 成立。读数与脚本存 `docs/acceptance/2026-10-17-ia-e2e/` | 引用 144 个变量,悬空 0 |
`check:visual`(= grammar 自证+实跑、accents 自证+实跑,自证先跑)已并入 `test:all`。
### 11.2 本轮真实踩到并修掉的缺陷(管理归零)
| # | 缺陷 | 根因 | 为什么门禁没拦住 |
|---|---|---|---|
| D-1 | **`npm run lint` 的 EXIT=1 被管道吞成 0** | `npm run lint \| tail -6` 取的是 `tail` 的退出码(本仓 memory 已立过「管道吞退出码」,仍复犯) | 拦住了 —— 规则本身报了 2 error,是我没读它的退出码 |
| D-2 | 源码注释被当**文字节点渲染到页面上**(`solution-detail-content-v3.tsx` 两处 `/* …` 写在 JSX 子节点位) | 上一笔为修「注释占三元分支根位导致 build 失败」而把注释挪进 children,却没包 `{/* … */}` | **合法 JSX**:`type-check` EXIT=0、1747 例单测全绿、`npm run build` EXIT=0。唯一静态防线是 `react/jsx-no-comment-textnodes`,即 D-1 那 2 个 error |
| D-3 | 已退役的彩色阴影令牌在 tailwind 仍留映射 ⇒ `shadow-brand` 类静默展开成空值 | 「删了值但没删引用」;R5 看令牌层、R7 看业务代码消费,两条都绿 | 判据两侧都不看 tailwind↔CSS 这条缝 ⇒ 新增 R11 接管 |
| D-4 | `checkGrammar` 的 `results` 累加器挂 module 层,第二次调用往同一数组追加,`.find("R10")` 取到第一次读数 | 仪器只在被复用时才坏;主流程只调一次所以毫无症状 | 自证写成第二次调用才暴露 ⇒ 把累加器收进函数作用域 |
| D-5 | 我自己新写的「首页段序」断言用 `boundingBox().y` 排序 | 那是**视口相对**值,`scrollIntoViewIfNeeded` 后各段都落在同一带区(实测 -0.5 / -151.8) | 改用文档坐标 `getBoundingClientRect().top + scrollY`,并实测三段读数 2684 / 3242 / 3995,确认不是恒等 |
D-2 的回归守卫:`solution-detail-content-v3.test.tsx` 新增断言,且**先断言被污染的两段 DOM 真的渲染了**才断言"文字里没有 `/*`";该断言已用变异验证敏感性(把注释改回裸文本 ⇒ 仅这一条转红、其余三条仍绿,EXIT=1)。
### 11.3 E2E 与 IA 的连带改写
一级导航改双轴(行业 / 能力 / 洞察 / 关于我们)后,**7 个 spec 文件里的旧锚点必须随 IA 一起改**,
否则"绿"只代表还在测上一版信息架构。逐条按实测 DOM 重写(探针与读数存
`docs/acceptance/2026-10-17-ia-e2e/probe-*.mjs`,共 7 份):
| spec | 原锚点 | 现锚点 | 语义是否守住 |
|---|---|---|---|
| `nav-dropdown.spec.ts` | `button:has-text("产品")` / `("解决方案")` | 三轴各自触发器 + 新增一级 IA 契约断言(按钮文本恰为 `['行业','能力','洞察']` 且无「产品」) | 守住并加强:多了「产品若回到一级即判红」的反向守卫 |
| `p6-missing-paths.spec.ts` | 产品下拉 → 查看全部产品 | 能力下拉 → 产品矩阵总览 `/products` | 判据升级为「降级后仍可到达」 |
| `uj-11-home-conversion.spec.ts` | `hero-primary-cta`/`trust-section`/`narrative-section`/`cases-co-creation-cta` | `hero-cta`/`home-ledger*`/`metrics-basis-note`/`results-slot-*`/`home-cta-button` | 口径类断言改为「存在且非空」,不锁措辞(口径 target→verified 时会误红) |
| `p2-functional-e2e.spec.ts` | 同上旧锚点 + 旧五项导航文案 | v16 锚点;`导航链接可点击` 改为**按导航自己声明的目的地去走**(直链优先,未展开的下拉先 hover) | 桌面一级只剩 1 个 `<a>`、其余是 `button[aria-expanded]` ⇒ 旧写法在 idx=1 稳定读不到元素 |
| `p5-edge-cases.spec.ts:129` | `narrative-section a[href="/products"]` | `card-products a[href="/products"]`(页脚,不依赖 hover) | 守住 N-27「不许静默跳过」纪律 |
| `user-journey.spec.ts:216` | `button:has-text("解决方案")` + 查看全部解决方案 | `("行业")` + 查看全部行业 | 同轴改名 |
复跑:三文件 × 4 project **80 passed / 0 failed**;`p2` × chromium + chromium-mobile **96 passed**(含 D-5 修正后)。
### 11.4 新登记的待拍 / 待授权(本批一律未执行)
| 编号 | 项 | 为什么不由代理自决 |
|---|---|---|
| DEC-N1 | **彩色编码第二条通道**:`hero-themes.ts` 11 个主题里 7 个用非品牌 `accentColor`(erp `#1e3a5f`、crm `#1e40af`、bi `#0c4a6e`、cms `#14532d`、sds `#78350f`、oa `#4c1d95`、novavis `#0f3d3e`),以内联样式进产品·方案·服务详情页 hero 徽章 | 去掉逐产品色相 = 取消产品线视觉身份,是**设计裁定**;且属"套其余模板",决策四明确推到验收之后。`check:accents` 的口径已就地写清「仅类名通道」,防止被读成"营销面已无彩色编码" |
| DEC-N2 | `StaggerReveal` 默认 `staggerDelay = 0.15` 与 ADR-0004 决策三「stagger 30–60ms」不符 | 改库默认值 = 全站动效重排 + 基线重采;本批只在首页与账本显式传 0.04–0.06 |
| DEC-N3 | `check:motion` 现存 **8 条违反**(6 条写死贝塞尔不在令牌层、`--transition-gentle = 1000ms` 超 700ms 入场上限、1 条 CSS 裸时长字面量) | **全部是基线 `da9a5cb6` 就有的红**(`git show` 核过 `--transition-gentle: 1000ms` 与 `transition: opacity 0.6s` 两处),非本轮引入;该闸不在 `test:all` 内 |
| DEC-N4 | `CaseStudiesSection` / `detail-trust-section` **没有**授权与 basis 门槛(只有新成果槽有) | 应同闸;改的是既有转化页文案可见性,需与业务确认口径后再动 |
| AUTH-VISUAL | 视觉基线重采(radius / 阴影 / hover / CTA 全变)+ `--radius-cta: 12px` 负对照 | 写基线需单独授权;负对照若 N=0 则只读复跑的绿灯作废 |
| AUTH-NAV | CMS `navigation/default` 行改写 | 写库是共享状态动作;现行由代码 fail-closed 供数,不改库也能上线 |
### 11.5 终局验证轮(2026-10-17 续):三条 prod 目标读数 + 一个真缺陷 + 一次自伤
`test:e2e:prod`(harness 起 `node dist/standalone/server.js`,非 `next start`)首跑
**94 passed / 25 failed / 25 skipped**。25 条红逐条归因后**只剩 1 类是真事故**:
| 红因类 | 条数 | 定性 | 处置 |
|---|---|---|---|
| 旧导航标签硬编码(`a:has-text("服务")`、抽屉里 `("产品")`/`("解决方案")`) | 6 | 本批 IA 变更的连带,**测试口径落后于 IA** | 已重写(见下) |
| `/news` 筛选计数 2≠1 | 8 | **冻结的 ISR 落盘产物**:`dist/standalone/dist/server/app/news.html` 里含 `uj03-test-news-*`,而 `prisma/dev.db` 实测 0 条 `uj%` 行;响应头 `x-nextjs-cache: HIT`、`s-maxage=3600` | 装配层已修(UJ-03 teardown 删行后补 revalidate);**产品层缺口另记 DEC-N5** |
| `check:axe` 未能度量 | — | `EXIT=2`,路由清单 `/tmp/axe-routes.xml` 不存在(须先跑 `check:axe:routes`)——**不是判红,是没测** | 按序补跑 |
#### 真缺陷:一级导航降级把 `/products` 变成了**移动端孤儿路径**(已修)
- 现象:守卫断言 `[data-testid="mobile-tab-bar"] a[href="/products"]` 稳定读不到元素。
- 实测:底部 TabBar 的 hrefs 只有 `['/', '/solutions', '/services', '/insights', '/contact']`,
而移动抽屉原本**只渲染 `config.mainNav` 这一层**(`header.tsx:222-246`)⇒
「产品」退出一级后,手机上**没有任何导航路径**能到 `/products`(只剩页脚)。
桌面端靠 hover mega 面板仍可达,所以这是**只有移动端会中**的 IA 完成度缺口。
- 修法:抽屉为带 `dropdownKey` 的轴渲染其 mega 组(常驻展开,不做手风琴 ——
抽屉本身 `overflow-y-auto` 可滚,少一个交互态就少一处 a11y 契约要维护)。
复测:抽屉链接 **26 条,含 `/products` 1 条,二级项 21 个**;
`UJ-01/02/08/10` × chromium + chromium-mobile ⇒ **14 passed / 0 failed**。
- 记一笔正面价值:**这条红是判据抓对了,不是测试写坏了**。
「降级后仍可到达」这个断言的全部意义就在于此;若当时把它调成"找不到就跳过",
`/products` 会在手机上静默消失。
#### 本轮的自伤(必须记,否则下一轮还会做)
为了"清掉那份冻结的 ISR 产物",我对构建输出目录做了 `rm -rf`(含 `(marketing)/news` 子树),
结果连**已编译的页面模块** `dist/standalone/dist/server/app/(marketing)/news/page.js` 一起删了:
- 直接症状:standalone 服务打 `Error: Cannot find module '…/(marketing)/news/page.js'` ×6,
`UJ-01 Mobile` / `UJ-03` 因页面 500 而红。
- 更糟的是**验证被自己的破坏污染**:我当时跑「产物里 uj03 命中数 = 0」得到 0,
读起来像"缓存已干净",实际是**页面根本渲染失败**(500 的 HTML 里当然不含那行)。
`npm run build` 重建后 `news.html` 里 uj03 又出现 2 次,才暴露 DB 里真有 2 条残留行
——那是 UJ-03 因我破坏的产物而**中途失败、teardown 没跑完**留下的。
- 三条纪律:① 重置 ISR 只能靠 **重新构建** 或调用 revalidate,不许手删 `dist/**`;
② 任何"命中 0"式的清除验证必须同时断言**页面是健康的**(正对照:状态码 200 且关键锚点在),
否则"仪器坏了"与"问题没了"共用同一个 0;③ 破坏性清理若让用例中途失败,
要回头查它留下了什么**半成品数据**,而不是只修红的那条断言。
- 善后:自造的 2 条 `uj03-test-news-*` 已按 id 删除(连带 AuditLog 与 ContentZone.items 引用),
`news` 已发布行回到 seed 的 2 条;随后 `npm run build`(EXIT=0)重建产物。
#### 新登记
| 编号 | 项 | 说明 |
|---|---|---|
| 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)。
**证据文件的口径提醒(引用前必读)**:`check:axe` 的输出路径是写死的
`docs/acceptance/2026-09-21-axe/axe-evidence.json`,所以本轮跑闸把那份**历史证据**
刷成了本轮读数(`0157b1c9` 里 409 行 diff 就是它)。它仍在原目录、仍可复跑取证,
但引用时要按「2026-10-17 本轮」读,不要当成 2026-09-21 那一轮的原件 ——
该轮原件的结论在 `docs/acceptance/2026-09-21-gates/` 与 §8/§9 里可回溯。
⇒ 这是一条**仪器设计缺陷**:证据文件名应当带运行时间戳或按轮次分目录,
否则每跑一次就在覆盖一次历史。登记为待办(改输出路径属独立小改动,本批不夹带)。
### 11.7 Lighthouse(装配后的 standalone 产物,`npm run lighthouse`)
**EXIT=0**,断言全过:11 URL × 3 跑 = 33 份报告。逐 URL 取三轮里的最好一轮读数
(`lighthouse-reports/`、`.lighthouseci/lhr-*.json` 可复算):
| URL | perf | a11y | best-practices | SEO | LCP |
|---|---|---|---|---|---|
| `/` | 99 | 100 | 100 | 100 | 902ms |
| `/about` | 99 | 100 | 100 | 100 | 976ms |
| `/about/brand` | 99 | 100 | 100 | 100 | 933ms |
| `/cases` | 99 | 100 | 100 | 100 | 996ms |
| `/contact` | 98 | 100 | 100 | 100 | 1101ms |
| **`/insights`**(本批新增覆盖) | 99 | 100 | 100 | 100 | 974ms |
| `/news` | 99 | 100 | 100 | 100 | 976ms |
| `/products` | 99 | 100 | 100 | 100 | 896ms |
| `/products/erp-upgrade` | 99 | 100 | 100 | 100 | 896ms |
| `/services` | 99 | 100 | 100 | 100 | 895ms |
| **`/solutions/manufacturing`**(本批 tracer-bullet 承载页,新增覆盖) | 99 | 100 | 100 | 100 | 895ms |
口径说明:
- 这是**在装配好的产物上**测的(`dist/standalone` 含 `dist/static` + `public`)——
§5.34 那类"全站 CSS 404 而 Lighthouse 仍 exit 0 且 perf 99-100"的假绿已被前置排除;
同轮 `check:axe` 的 `bgMismatch=0` 是另一侧证据(两条独立仪器指向同一事实)。
- 两条新覆盖的 URL 都进来了:`/insights` 是新的一级轴,`/solutions/manufacturing`
是本批的 tracer-bullet 详情页。**加进断言集而不测**是没意义的,所以先跑再登记。
- 阈值口径未动:`performance ≥ 0.9`、`accessibility/best-practices/seo ≥ 0.9`、
`LCP ≤ 3000ms`(`config/test/lighthouserc.json`),本轮实测最低 perf 98(/contact)、
最大 LCP 1101ms(/contact),余量分别 8 点与 1899ms。
---
## §12 2026-10-17 · §11.4 待拍批的落地轮(DEC-N1…N6 + AUTH-VISUAL)
用户裁定「需要决策就采用推荐方案」,本批把 §11.4/§11.5 登记的每一条按推荐项执行到位。
分支仍是 `worktree-ui-grammar-two-axis`,起点 `0ae765af`。
### 12.1 DEC-N5 · 后台发布/更新/删除真正让前台 ISR 失效(`f3e66f7d`)
**根因不是算错,是没有调用方**:`modelCode → paths` 的推导长在 `/api/cms/revalidate` 的路由体里,
所以它只能被外部 HTTP 调用触发。8 个页面注释那句「CMS 发布/更新时通过 `/api/cms/revalidate`
主动刷新」在没有任何生产调用方的日子里是假的 —— `s-maxage=3600` 下最长 1 小时前台仍端出
已删或过期内容,且没有任何门禁会红。
| 处置 | 内容 |
|---|---|
| 提纯 | 新增 `src/lib/cms/revalidation.ts`:`pathsForModel` / `tagsForModel` / `planRevalidation` 是**不碰 `next/cache` 的纯函数**,副作用收在 `applyRevalidation`(严格,供路由用)与 `revalidateContent`(尽力而为,供变更链用)。依据 §5.30「安全抽象必须可导入」 |
| 接线 | `items` 的 POST/PUT/DELETE、`workflow` 的 submit/approve/reject/archive、`zones` 的写与删,全部走同一份推导。判据按 `status`(草稿不进前台读取路径);**slug 变更时旧地址一并刷** |
| 时序 | 失效放在数据与审计**都落库之后**:刷缓存失败不该把一次成功的写入连带变成 500(那比旧快照更糟 —— 操作者以为没保存,其实已改) |
| 不静默 | `revalidateContent` 逐条 try,失败以 `[revalidation-failed]` 打日志并在 `failed` 字段回报;`applyRevalidation` 仍冒泡,保持 `/api/cms/revalidate` 的 500 语义 |
**证据**:`revalidation.test.ts` 18 例(纯映射对账真实 `CONTENT_TYPE_CONFIGS`,不抄字面路径)+
`cache-invalidation.test.ts` 7 例(断言的是「调用点存在」本身,正是当初缺的东西)。
定向 16 套件 **193 passed / EXIT=0**;
**负对照**:把 workflow 的调用点替换成注释 ⇒ `MUTANT_EXIT=1`、4 例转红(approve + submit/reject/archive),
还原后 `EXIT=0` 且文件逐字节复原。lint 定向 0 error。
### 12.2 DEC-N2 · 台账声明被证伪:`staggerDelay` 默认值从来不是 0.15
ADR-0008 §87-1 与 §11.4 写的是「`StaggerReveal` 默认 `staggerDelay = 0.15`,与 ADR-0004 决策三
「子元素 stagger 30–60ms」不符」。实测三条把它推翻:
1. `src/components/ui/scroll-reveal.tsx:113` 现行默认是 **`0.05`(= 50ms,落在 30–60ms 内)**,且工作树干净(不是我改的)。
2. `git log -S'staggerDelay = 0.15' -- src/components/ui/scroll-reveal.tsx` **无任何提交** —— 那串字面量在该文件历史里没存在过。
3. 全站 18 个显式传参只有 `staggerDelay={0.05}`(16 处)与 `{0.06}`(2 处),没有任何 0.15。
⇒ **DEC-N2 无需执行**,它和 §11.6 那条「axe 哨兵抄字面量早已过期」是同一类缺陷:
**台账里的数是从前一轮的叙述里抄来的,而不是从当场的仪器里取的**。
ADR-0008 §87-1 的同一句话需要一并更正(该文件本轮由 accent 子任务独占改写,故在此登记而非并发改)。
### 12.3 DEC-N3 · `check:motion` 的 8 条基线红归零,判据从「令牌声明」移到「消费点」(DEC-N3,提交见 `git log`)
先量再判,没有直接把红线挪低:
| 子项 | 读数与处置 |
|---|---|
| 6 处写死 cubic-bezier | 全部收进既有令牌 `--ease-ink` `[0.22,1,0.36,1]`(`template.tsx`、`page-transition.tsx`、`brand-visuals.tsx`),各处注释标 `CONTEXT.md:77` 出处;两曲线原本都落在 280ms 入场档,没有不可替代的物理理由 |
| `opacity 0.6s` 裸时长 | 改 `var(--transition-slower)`(globals.css:1486) |
| `--transition-gentle = 1000ms` | **实测在 `src/` 零消费**(仅 `tailwind.config.js:220` 的 `duration-gentle` 映射,无一处使用)⇒ 入场/循环/其他 = 0/0/0。原「令牌声明一律 ≤700ms」是把 CONTEXT.md:82 的**入场**红线读成了对调色板的禁令;现口径改为**消费点判红**:非 infinite 的 `transition/animation` 声明(含经 `var()` 解析出的时长)>700ms 必红,`infinite` 循环环境动效维持既有豁免 |
**仪器自证(负对照,真树注入 → 还原)**:塞回 `[0.16,1,0.3,1]` + `opacity 900ms` 裸字面量 +
`opacity var(--transition-gentle)`(非循环消费点)⇒ `npm run check:motion` **EXIT=1**,
4 条红分别命中 `easing-palette`×1、`css-transition-token`×1、`entrance-cap`×2;
还原后 **EXIT=0**、违规 0。⇒ 改口径没有把闸调瞎:超上限档位一旦接入非循环声明就判红。
读数:`check:motion` EXIT=0(0 违反)、`check:motion:test` EXIT=0(21/21)、`tsc --noEmit` EXIT=0。
### 12.4 DEC-N5 的连带教训:`next build` 的 TypeScript 阶段比 jest 严
新增的 `cache-invalidation.test.ts` 在 jest 里 25 例全绿,却把 `npm run build` 打成
`error TS2554: Expected 2 arguments, but got 1` —— 原因是测试夹具 `req(url, body)` 的 `body`
写成必填,而 `DELETE`/`PUT` 的调用不带 body。**jest 里少传一个参数只会让 `json()` 抛错、
又被路由的 catch 吞成 500 之外的路径**,所以测试毫无症状。已把 `body` 改可选并留下注释。
⇒ 口径补充:**改 `src/**` 下的测试后必须让 `npm run build` 过一遍 tsc**,
`npm run type-check` 与 build 的 tsc 覆盖同一份 tsconfig,但只有 build 会被 CI 跑到。
### 12.5 DEC-N4 · 授权与 basis 门槛下沉成共用闸(`2e009942`)
判据原先只有新成果槽有:`CaseStudiesSection` 与 `detail-trust-section` 里的案例主张不过闸,
于是「同一类证据走两套标准」。这轮把判据(授权 + ≥1 个 `basis === 'verified'` + 禁词扫描)
下沉成 `src/lib/constants/case-publish-gate.ts`,`results-slot` 的 `casePublishBlockers` 改为委托它
⇒ **三处消费同一实现,禁词/口径真源仍只有 `metrics-basis.ts` 一份**(不造第二套真源)。
| 项 | 读数 |
|---|---|
| 门槛下会被隐藏的既有条目 | **0 条** —— seeds(products×6 / services×4 / standalone×1)的 `caseStudies` 全是空数组,solutions seed 无该字段,CMS `dev.db` 11 条内容的 `caseStudies` 长度全为 0 ⇒ 线上转化页无可见变化,本条是**前瞻性 fail-closed 加固**而非内容清洗 |
| 转红的既有断言 | 2 处旧测试写的是「未授权案例照常渲染」,按测试夹具补 `authorized + basis:'verified'` 处理并新增负例(线上传言与测试数据不混用) |
| 仪器自证 | 把闸改恒真(`return []`)⇒ **EXIT=1、20 例转红**(gate 本体、results-slot 原有用例、两区块负例、solution-detail 消费页都在红因里);还原后 EXIT=0 ⇒ 证明确实共用一道闸 |
| `dataProofs` 为何不套硬闸 | 它已在 `weakestBasis` + `MetricsBasisNote` 契约下且自述目标口径,硬清会误伤全站已标注数字(理由写进代码注释) |
⚠ **残留(登记而非隐瞒)**:CMS `content-types` 的 `caseStudies` schema 还没有 `authorized/basis` 两个字段。
后台现在无法为案例授权,闸只挡住「无字段 ⇒ 不可发布」这一侧;业务要真出案例须先扩 schema。
### 12.6 本轮的合并验证读数(提交前)
`tsc --noEmit` EXIT=0;全量 jest **145 套件 / 1795 例 EXIT=0**(较 §11 的 141/1747 增加 4 套件 48 例);
`check:visual`(grammar + accents 各自 selftest 先跑)EXIT=0;`check:dead` EXIT=0(dead 0);
`check:motion` EXIT=0;`npm run build` EXIT=0(`postbuild` 已装配 `dist/static` + `public`)。
### 12.7 DEC-N1 · accent 第二条通道钉成判据 B,并当场抓到一条真漂移
裁定:**保留** 7 个产品线色相(承担产品线视觉身份,实测 hero 徽章占视口 **0.538%**、色相仅以 **6.3% alpha** 底纹存在、
1600×846 hero 视口**冷色像素普查 = 0**),但把这条通道收进 `check:accents` 的判据 B:
①真源 `hero-themes.ts` 的 `accentColor/accentBg`、②可达营销代码里 `style={{…}}` 的色彩属性
(含 `--badge-accent` 与内联引用 `--color-accent-*` 令牌的更隐蔽形态)、③营销页就地组装 `accentColor`(绕开真源的第二份色值)。
豁免按 **文件 + 色值** 登记且色值归一化成 `#rrggbb`(否则换个 `rgba()` 写法就绕过);
登记了却命中 0 ⇒ 判红(与判据 A 同一条防腐化纪律);棘轮 `MAX_NON_BRAND_HUES = 7`,存量恰在上限 ⇒ 第 8 个色相即判红。
| 证据 | 读数 |
|---|---|
| 仪器自证 | `check:accents:selftest` **11 情景 EXIT=0**,每情景只喂一维并断言另一维违规数为 0 |
| 自证里的两处不自洽(原稿从未跑成) | ①把「另一维的豁免腐化」当串维证据 ⇒ B 夹具天然不带 A 的 3 个豁免文件 ⇒ A 必报 stale 3 ⇒ 自证永远红。腐化不是串维证据(它只是"该维没喂料"的必然产物),**违规数才是**;②4 情景的棘轮期望与 `分母 0` 情景的 stale(写 9、实取 7)按实测改正 |
| 当场战果(真漂移) | `erp-upgrade-v3/page.tsx` 的 `deriveTheme()` 在营销页里抄了一整份 theme(含 `accentColor: '#1e3a5f'` 与两段渐变)绕开真源 ⇒ 判据 B 判红。改为 `getHeroTheme(heroThemeId ‖ 'erp')` 只覆盖动态字段 `badge` |
| 改后渲染是否变的对拍 | 与真源逐字段对拍 `gradientFrom/gradientTo/gradientAngle/accentColor/accentBg/texture/layout` **全等**;并用库内实值确认 `erp` 行的 `heroThemeId` 就是 `'erp'` ⇒ 解析到同一份 theme,渲染不变(不是"应该一样",是查过) |
| 复跑 | `check:accents` EXIT=0、`check:visual` EXIT=0、`tsc` EXIT=0、`jest --testPathPatterns products` 4 套件 48 例 EXIT=0 |
⚠ 口径边界(写在闸的成功输出行里):本闸只覆盖**代码面两条入路**;CMS 内容里 authored 的色值(富文本/图表数据)不在其内。
### 12.8 DEC-N6 · e2e 进类型口径 + 两处工程卫生,以及我自己造成的两次破坏
`e2e/tsconfig.json` + `npm run type-check:e2e` 并入 `test:all`;负对照读数:注入重复 `const revalidateSecret` 时
`type-check` EXIT=0(0 条 e2e 诊断)而 `type-check:e2e` **EXIT=2(TS2451×2)**,还原 EXIT=0 ⇒ 补口真的敏感。
既有 e2e 类型错误 **25 条**:19 条按行为等价修掉(`viewportSize` 可空、`.at(-1)`、`?? 0`、可选链、正则捕获组落局部变量、
touch-targets 数组参数改对象参数、删掉既非法又等于默认值的 `locator.screenshot({fullPage:false})` 等);
**6 条登记为残留并用 `@ts-expect-error` 标注**:5 处 `use.reducedMotion`(fixture 白名单证明运行时被忽略,
而正确写法 `contextOptions` 会真的改截图 ⇒ 与本轮基线重采相撞)、1 处 `expect.toHaveScreenshot.timeout`(类型没这个键但运行时确实读它)。
`.husky/pre-commit` 索引模式 100644→**100755**(`git ls-files -s` 为准)。⚠ 但 `core.hooksPath` 是**指向主检出的绝对路径**,
本机主检出那份工作树文件仍是 644 ⇒ 本仓每次提交照旧打 `hook was ignored`;克隆/检出该提交后才是 755。
axe 证据默认落 `docs/acceptance/<运行日>-axe/axe-evidence.json`,旧路径保留为 latest 副本(Jenkinsfile:399 与文档引用不断),
判定与三档退出码未动,新增 `check:axe:selftest`(临时目录真写一遍,9 项全 ✓)与 `--print-paths`。
**我自报两次破坏(管理归零,写在这里而不是只写在提交信息里)**:
1. **在别人还在写它的文件时就 `git add`** ⇒ 提交冻结的是中间态:`1c0ce5f4` 的信息声称「重复键已由 node 回读校验」,
而 `git show HEAD:package.json` 实取重复键 **2 处**、且 `test:all` 整条不见 —— 由后续 `0e17327e` 补正。
更狠的一环是我用来去重的那条命令:`grep -n 'type-check:e2e' package.json | tail -1` 取到的行号
命中的是**含该子串的 `test:all` 整行**,`sed -i "<行号>d"` 于是把全仓门禁入口删了。
⇒ 纪律:**按子串取行号再删行**属于危险动作(子串会出现在别的行里);改 JSON 要走解析器而不是行号。
2. **校验仪器本身是坏的**:那条 node 回读用正则 `^ "key":`(两空格缩进)数重复键,
而重复键在 `scripts` 对象里(四空格)⇒ 报 `dups=[]`,对目标那一维根本不敏感。
现已换成 `scripts/check-package-keys.mjs`:按**父路径 + 键名**分组计数,退出码 0/1/2 三档,
自带 `--selftest`(正对照 + 「同层重复必抓」+「异父同名不误报」三条各测一维),
并在真 `package.json` 上做了活体负对照:注入重复的 `"lint"` 键 ⇒ **NEGATIVE=1(`scripts` 里的 "lint")**,还原 ⇒ REAL=0。
另记一次同类自伤:`npx jest "src/app/(marketing)/products"` 里 `(` 与 `[` 是**正则元字符**,
jest 把它当 testPathPattern 解析 ⇒ "No tests found" 被我读成"测试失败"(EXIT=1 同码)。
改用 `--testPathPatterns products` 后 4 套件 48 例 EXIT=0。这与 §5.42「命中 0 必须配页面健康的正对照」是同一族:
**空结果与失败共用一个退出码时,仪器必须先自证能取到非空样本**。
### 12.9 GA4 首次真断言(§11.6 那条「未取证」就此闭合)
§5 的口径表早写明:默认 E2E 打 dev server,而 `NEXT_PUBLIC_GA_MEASUREMENT_ID` 只存在于 `.env.production`,
dev 下 `GoogleAnalytics.tsx` 提前 return null ⇒ 那 16 个 `@critical` 是 **skipped 而不是 passed**。
上一轮在 worktree 里连"skipped 也算取证"都做不到:worktree 没有 `.env.production`,而 `NEXT_PUBLIC_*` 是 **build 期烘焙**。
本轮把主检出的 `.env.production` 供进 worktree(该文件由 `.gitignore:81` 忽略,不入库),重跑 `npm run build` 后:
| 证据 | 读数 |
|---|---|
| 用例结果 | `ga4-event-tracking.spec.ts` × 4 project ⇒ **16 passed / 0 failed / 0 skipped**(16.3s) |
| 独立性正对照 | `grep -o 'G-[A-Z0-9]\{6,\}' dist/standalone/dist/static/chunks/*.js` 命中 `G-LGTLCR15KM`(两处 chunk)⇒ GA id 真烘进了客户端产物;不是"没 skip 所以算过" |
| 反面样本仍在盘上 | 上一轮 `e2e/allure-results/*.json` 里同一条是 `status: skipped` + `构建未注入 GA 脚本(NEXT_PUBLIC_GA_MEASUREMENT_ID 为空)` |
⇒ 「GA4 覆盖已验证」这条口径现在才成立,且引用时必须连「在装配产物上 + `E2E_TARGET=production`」一起引。
### 12.10 AUTH-VISUAL · 基线重采 113 张,`--radius-cta` 负对照成立
按 `--update-snapshots`(裸旗标取 `changed`)重采,并按 project 分 5 笔提交:**23 / 23 / 23 / 21 / 23 = 113 张**。
| 判据 | 读数 |
|---|---|
| 重采后可复现 | `--update-snapshots=none` 只读复跑(终版代码,含 DEC-N1 的页面改动)⇒ **125 passed / 0 failed / EXIT=0**,0 张被重写 |
| **基线确实对该维敏感**(AUTH-VISUAL 明确要求的负对照) | `--radius-cta: 0px` 改 `12px` ⇒ 同 project **15 failed / 10 passed、EXIT=1**;还原后 `git diff` 为空、该项目 **25 passed** ⇒ 只读绿灯不是空壳 |
| 防空白/防塌版的实物核验 | 抽样读尺寸与像素分布:home 桌面 1280×6449(近黑 14.53%、唯一色 1382)、home 移动 1170×23586(18.53%、3076)、承载详情页 webkit 2548×17536(10.87%、1642)⇒ 内容在场 |
**两条如实挂账,不抹平**:
1. **113 ≠ 预测的 104**。§11.6 给的是 21/21/20/21/21 = 104 failed,本轮四个桌面/平板 project 各 +2。
**逐名对账我没做**:差值可能来自 §11.6 之后落地的 DEC-N3(动效时长/缓动改写影响 hover 与过渡态裁图)
与 N-15 选择器修复后的新增命中 —— 这是推断不是读数,已列入 PR 未验证项,下一轮按 `--list` 逐名对账。
2. **逐张人工读图追认只做了抽样**,全量 113 张需决策人分批追认(PR 未验证项④)。
另记一条仪器口径教训:我筛"可疑空白图"用的判据是**字节数 < 20KB**,结果把 `button-*`
(82×44 的按钮裁图,天然 ~1KB)报成可疑件。⇒ 空白/塌版要看**尺寸与像素分布**(宽高、唯一色数、
近黑/近白占比),字节数只在"同尺寸同类"之间可比。
### 12.11 AUTH-VISUAL 的逐名对账闭合:113 / 12 / 5 孤儿,并把「聚合数经不起追问」这一类修掉
§12.10 挂的账(113 vs 预测 104 的 +9 无法归因)根因不在本轮,而在**上一轮只留了聚合数没留名单**。
本轮补两件事:
1. **逐名清单仪器** `scripts/visual-manifest.mjs`:把 Playwright 文本输出转成 `{project, at, title, status}` 清单,
退出码 0 全通过 / 1 有 failed / **2 未能度量(解析不到任何用例行,不与"全绿"共用 0)**。
自证与负对照都做了:
- 终版只读日志 ⇒ `total=125 passed=125 failed=0`,EXIT=0;
- `--radius-cta=12px` 那次 ⇒ `total=25 passed=10 failed=15`,EXIT=1(判红名单全是含 CTA/徽章的整页与主题图:
`首页 /`、`/about`、`/contact`、`/products`、`/products/erp`、`/products/erp-upgrade`、`/solutions`、
`/solutions/manufacturing`、`/services`、`/services/software`、`/news`、`/methodology`、`/team`、浅色主题、深色主题);
- 空日志 ⇒ **EXIT=2**(仪器坏的时候仍然会失败,而不是报通过)。
两份清单入库:`docs/acceptance/2026-10-17-final/visual-manifest-final.json`、`visual-manifest-radius12px.json`。
2. **用磁盘清单做差集取具名结果**(我第一版拿中文用例名去匹配 slug 文件名,键型不匹配 ⇒ 得出"125 张都没重写"的假结论,
是仪器错配不是发现;改成按文件名做差集后才对):
| 集合 | 数 | 说明 |
|---|---|---|
| 本轮重采 | **113** | 按 project 23/23/23/21/23 分 5 笔提交 |
| 未重写(真的与终版一致) | **12** | `input-default/focused` × 4 个桌面类 project(8)+ mobile 的 `button-default/hover/focus`(3)+ mobile 的 `header-navigation`(1) |
| 孤儿参照 | **5** | `founder-quote-section-*` × 5 project —— 该区块按 ADR-0008 决策一已删除,`visual-regression.spec.ts:180` 早改成 `toHaveCount(0)` 反向守卫,参照留在盘上等于给下一轮留骗人的东西 ⇒ **已 `git rm`** |
| 对账恒等式 | 125 = 113 + 12 | `--list` 实取 `Total: 125 tests in 1 file`;删孤儿后每 project 恰好 **25** 张,与用例数逐 project 相等(另有 `manual-acceptance/` 2 张非断言参照) |
⇒ **§11.6 那个 104 至今没有名单可查**,所以 +9 仍不能从证据归因(只能说:113/12/5 这三个数现在自洽且可复算)。
从本轮起每轮都留逐名清单,这类"聚合数对不上只能靠推断"的情形不会再出现。
### 12.12 两条原判「需你授权」的项:DEC-N4 的 schema 落地(可做,已做)与 AUTH-NAV(前提核查后判定为已达成)
**a) DEC-N4 的功能性前置已闭合(纯代码 + 本地 seed,非生产库动作)**
我上一轮把「扩 schema」当成需要授权的库动作,判错了:`ContentItem.data` 是 JSON 列,**没有表迁移**。
真正的门槛在 `prisma/seed.ts:364` —— `ContentModel.fields` 由 `content-types.ts` 生成,
而后台能不能填 `authorized/basis` 取决于那份声明(`loadDeclaredFields()` 读它)。
没有声明,闸就永远把所有案例拦在门外:**表现为"防呆生效",实际是业务用不上**。
| 动作 | 读数 |
|---|---|
| 三处 `caseStudies`(product / service / standalone-product)补 `authorized(boolean)` + `basis`(复用 `metricBasisField` 的选项表,只覆盖标签语境,不造第二份真源) | 新增 `src/lib/cms/case-field-contract.test.ts` 4 例 EXIT=0,全量 jest **146 套件 / 1799 例 EXIT=0** |
| 契约守卫的自证 | 摘掉 `authorized` 或摘掉 `verified` 选项 ⇒ 契约报问题(用例内断言,仪器坏时仍然会失败);站点计数写死为三处 ⇒ 新增带案例的内容类型忘记带字段会当场判红 |
| `npm run db:seed` 传播到库 | SEED=0;三行 `ContentModel.fields` 均含 `authorized` + `成果口径`;`ContentItem` 行数 **38 → 38 未变**(先 `cp` 出备份再跑,不盲跑重建) |
**b) AUTH-NAV:核查后判定「已达成」,不是待办**
台账说「CMS `navigation/default` 行改写」。实查:dev.db 里那行 `mainNav` 已经是
`行业 / 能力 / 洞察 / 关于我们`(无「产品」一级),且 `length(data)` 在我这次 seed 前后**逐字节相等(2778)**
⇒ 不是我本轮改的,也说明它早已随决策二的代码真源反转对齐。
`nav-dropdown.spec.ts` + `p6-missing-paths.spec.ts` × chromium/chromium-mobile ⇒ **26 passed / EXIT=0**,
这是在「该行被采纳」的前提下跑的,即 fail-closed 的契约门确实放行了一行符合 IA 的数据。
⇒ **AUTH-NAV 无需写库,判定关闭**;生产侧同名行是否同形,属部署期核对项(需要 SSH 只读,随发布一起做)。
**c) 我自报一次同类仪器错配(§5.45 的同族,第三次)**
上一条消息我说过「dev.db 里根本没有 navigation 行」——那句话的证据是
`sqlite3 … "select code, substr(data,…) from ContentItem where modelCode='navigation';" 2>/dev/null`,
而 `ContentItem` **没有 `code` 列**,sqlite3 报 `Parse error: no such column: code` 被 `2>/dev/null` 吞掉,
空 stdout 被我读成"没有这行"。⇒ 与 §5.44(`sed` 按行号删错行)、§5.45(正则只扫顶层)三条同判:
**查询工具的报错也是证据,不能丢;空结果必须同时证明"这次查询本身成功了"**。
本条结论已改用 `select count(*) …`(不含未知列)与逐字节长度对账重取。
### 12.13 终版复验(§12.12 之后重跑)与一条**有读数的**间歇红归因
schema 落地后不能拿"之前绿过"当终版读数,故整链重跑(`docs/acceptance/2026-10-17-final/run-post-schema-lane.sh`):
| 门禁 | 终版读数 |
|---|---|
| `npm run build` | EXIT=0 |
| `check:axe:routes` → `check:axe` | EXIT=0 / **EXIT=0**(`bgMismatch=0`、`violationNodes=0`、`unexpectedStatus=0`) |
| 视觉只读复跑 + 逐名清单 | EXIT=0;`visual-manifest-post-schema.json` ⇒ **total=125 passed=125 failed=0** |
| GA4 × 4 project | EXIT=0(16 passed / 0 skipped) |
| `npm run test:all` | **首跑 EXIT=1**,同条件复跑 **EXIT=0(59 passed / 25 skipped)**;Lighthouse 见车道尾 |
**那条 EXIT=1 不能记成"已知 flake"就翻篇**,本轮的处理是把归因做成读数:
1. 红因面:两条红都在 `p6-missing-paths.spec.ts` 的 **firefox** 单一 project(`@smoke` 首页→产品列表 / 列表→详情),
其余 project 全过;同一时刻 `check:coverage`、`check:a11y`、`check:visual`、`test:integration:real`(23 例)均已绿。
2. 排除数据面:怀疑过是我 `db:seed` 把 dev.db 内容 upsert 回 seed 值 ⇒ 逐模型对账
`product 6 / solution 6 / service 4 / standalone-product 1 / news 2` **与 seed 前备份完全一致**,
且 `product` 的 slug 集合用 `cmp` 比过为**未变**。
3. 排除代码面:单跑 `p6-missing-paths --project=firefox` ⇒ **9 passed / EXIT=0**;
全量 `test:e2e:fast` 同条件复跑 ⇒ **59 passed / EXIT=0**。
4. 机理:`playwright.config.ts:12-15` 是 `fullyParallel: true` + `retries: CI ? 2 : 0` + `workers: CI ? 1 : undefined`
⇒ **本地全速并行且零重试**,firefox 在大页面上的墙钟抖动就露在这里;CI 侧有 `retries=2 + workers=1` 兜住。
这与 `README.md` 早已记的「唯一红为 firefox 并发墙钟」是同一类,本轮第一次给它配上可复算的三把读数。
⇒ **不通过放宽断言或加 retry 来"修"**(那是把判据调瞎);如需本地稳定复现绿,编排上加 `--workers=1`,
并把这一条留给 CI 口径。登记为口径事实而非缺陷关闭。
---
## §13 治理闭环(2026-10-17):#33 以 fast-forward-only 合入 dev,dev→main 不由代理执行
| 项 | 读数 |
|---|---|
| **#33** | `worktree-ui-grammar-two-axis` → `dev`,**state=closed、merged_at 2026-10-17T09:27:55+08:00**。合并方式取 **fast-forward-only**:`origin/dev` 原 tip `8026d917` 是 HEAD 的严格祖先(`git merge-base --is-ancestor` EXIT=0),47 笔 sha **逐字不变**、`origin/dev` 现 = `6d46dbe8`。理由同 §10.9:本仓记过 rebase 造成「同标题异 hash」拓扑分叉之痛,FF 既保线性又保 sha 可引用。分支**未删**(`do_not_delete_branch=true`);删分支属独立动作 |
| **Gitea merge API 的一处口径**(踩过才记) | 首发 `POST /pulls/33/merge` 带 `{merge_style:"fast-forward-only", …}` ⇒ **HTTP 422 `"[Do]: Required"`**。那不是权限、不是缺审批(`GET /pulls/33/reviews` = `[]`,`mergeable=true`、`draft=false`),而是**这套 Gitea 版本的 merge 端点把表单字段 `do` 当必填**。补上 `{"do":"fast-forward-only", "merge_style":"fast-forward-only", …}` ⇒ **HTTP 200**。⇒ 422 的报文要按字面读,别翻译成「需要审批/我被授权不足」;另 `GET /pulls/{n}/merge`、`/branches/protection` 在本实例是 404(端点不存在),别把它当「无保护」的证据 |
| **为什么 dev→main 不由我执行** | 同 §10.9:`Jenkinsfile` 的「🚀 部署到生产环境」带 `when { branch 'main' }` ⇒ 合 main = 授权一次无人值守的线上发布。生产仍停在既有已验证发布,本批要在线上生效需决策人显式发起发布动作(含生产侧 `ContentModel.fields` 与 `navigation` 行的同形核对,见 §12.12、PR 未验证项②) |
| 本批终版门禁读数 | `tsc` 0、`type-check:e2e` 0、`check:package-keys` 0、`check:visual` 0、`check:dead` 0、`check:motion` 0、`jest` 146 套件/1799 例 0、`build` 0、`check:axe` 0、视觉逐名清单 125/125、GA4 16 passed、`lighthouse` 0、`test:all` 0(同条件复跑;首跑 1 已按 §12.13 三把读数归因) |
## §14 2026-10-17 · 合并后补跑全量功能 E2E:一条不实的勾选被我自己抓到,36 条红的分层归因
**触发**:#33/#34/#35 已 FF-only 合入 dev 之后,我才去补跑**本批从未跑过**的全量 `test:functional`
(4 project)。PR 描述里那条 `- [x] npm run test(Playwright E2E)…` 因此是**引用未成立的读数**——
与 §5.47 同一族(我把「跑过的子集」写成了「这条链已过」)。已在描述文件里改成
**保持未勾选的更正记录**,代价是该校验文件现在让 `check-pr-checklist.sh` 返回 1,这是刻意的。
**读数**
| 跑什么 | 树 / HEAD | 结果 |
|---|---|---|
| 全量 `test:functional`(4 project) | 本批 `0da1fa42` | **1032 passed / 36 failed / 44 skipped**,24.5m,EXIT=1 |
| 对照:只跑其中 8 个红 spec × chromium | 基线 worktree `cov-base` @ `da9a5cb6`(本批的**基线**) | **163 passed / 7 failed / 1 skipped**,2.5m |
**对照实验的混杂必须自己说破**:对照树里没有 `prisma/dev.db` 也没有 `.env`,是我从本批树**拷了当前这份库**
(39 条 `ContentItem`,即本批之后的数据状态)过去,代码才是 `da9a5cb6`。
⇒ 对「断言依赖导航/内容数据」的 spec,这不是纯净对照,只能说那 7 条在「旧代码 + 新数据」下也红。
纯净对照需要用 `da9a5cb6` 自己的 seed 库重跑,**这一步我没做,不据此下结论**。
**分层(按证据强度排)**
| 层 | spec | 依据 | 结论 |
|---|---|---|---|
| A 既有红(对照组也红) | `mobile.spec.ts:45/61`、`p2-functional-e2e.spec.ts:99/132`、`user-journey.spec.ts:56/200`、`website-acceptance.spec.ts:139` | 对照实验同一 spec 同一位置报同一类错 | 不是本批引入;但**它们仍在 dev 上红**,属遗留待修(多为旧导航标签/旧锚点) |
| B 待归因(对照组未红) | `p1-brand-visual-audit.spec.ts:579`(「未找到任何可见的客户评价区域,本用例等于零断言」)、`p4-performance-a11y.spec.ts:338/396`(ARIA、焦点可见)、`user-journey.spec.ts:562/773/854`(UJ-03/06/07 `@admin`)、`mobile-accessibility.spec.ts:76` 与 `mobile-performance.spec.ts:287`(触摸目标 AA 2.5.8 ≥24px 硬门禁) | 只在基线绿、在本批红 | **候选与本批相关**:证言/案例区正是 DEC-N4 门槛的作用面(B 的实测说隐藏条目 0 条,而这条守卫说区域整块不见了 ⇒ 必须重测,不接受"应该无关");触摸目标与 hover 去抬升/直角档是 §11 语法批的作用面 |
| C 环境/权限类 | 三条 `@admin` 旅程失败仅 ~170ms | 失败过快 ⇒ 更像登录/权限或写库用例在本环境的固有问题 | 待复现 |
**下一步(不在本批内,登记为待办)**
1. 用 `da9a5cb6` 自己的 seed 库做**纯净对照**,把 B 层逐条定性(本批引入 / 既有)。
2. 定性为本批引入的,按 §5.42/§12.13 的口径修根因,不允许改断言迁就。
3. A 层那 7 条属 §11 IA 改动的遗留锚点,另开修复 PR(与 `p6-missing-paths`/`nav-dropdown` 同法重锚)。
4. 全量 `test:functional` 纳入交付门禁的口径要写进 `AGENTS.md` §5——现 `test:all` 只含 `test:e2e:fast`,
「跑过 fast」与「跑过全量」必须在文档里区分开,否则下一次还会有人把前者当后者勾上。
### 14.1 纯净对照跑完:A/B 层定性翻转(我上一条的对照结论被自己的新读数推翻)
上一节的"混杂披露"补成了纯净对照:给基线树 `cov-base` @ `da9a5cb6` 配它**自己的** `.env` + `prisma generate`
+ `npm run db:seed`(38 条内容条目),再跑同样 8 个 spec × chromium。
| 对照 | 代码 / 数据 | 结果 |
|---|---|---|
| 第一次(混杂) | 旧代码 `da9a5cb6` + **本批的新 dev.db** | 163 passed / **7 failed**(全在导航类锚点:`mobile.spec.ts:45/61`、`p2:99/132`、`user-journey:56/200`、`website-acceptance:139`) |
| 纯净对照 | 旧代码 `da9a5cb6` + **旧代码自己 seed 的数据** | 162 passed / **8 failed**,且 8 条**全是** `mobile-accessibility.spec.ts:41` 的 axe-core 扫描(8 个 URL × 1.0m) |
| 本批 | `0da1fa42` + 本批数据 | 1032 passed / **36 failed** / 44 skipped(4 project 全量) |
⇒ **定性翻转**(这才是这节真正的产出):
1. **那 7 条导航类红不是基线既有红**,而是"旧代码遇到新数据"的错配产物 —— 它们在纯净基线上是绿的,
在本批上红 ⇒ **本批引入的 spec 未重锚**(§11 把一级导航改成 行业/能力/洞察/关于我们,
当时只重锚了 `nav-dropdown`/`p6-missing-paths`/`uj-11`/`p2`/`p5`/`user-journey:216` 六处,
`mobile.spec.ts`、`p2-functional-e2e.spec.ts:99/132`、`user-journey.spec.ts:56/200`、`website-acceptance.spec.ts:139` 被漏掉)。
2. **`mobile-accessibility.spec.ts:41` 的 axe 扫描 8 条是既有红**(纯净基线同样红)⇒ 不属本批,但也在 dev 上红。
3. 其余在本批红、在纯净基线**不红**的,全部落入"本批引入":`p1-brand-visual-audit.spec.ts:579`
(证言/案例区不可见 ⇒ 与 DEC-N4 门槛的作用面重合,必须重测,不接受"应该无关")、
`p4-performance-a11y.spec.ts:338/396`(ARIA 与焦点可见)、
`mobile-accessibility.spec.ts:76` 与 `mobile-performance.spec.ts:287`(触摸目标 AA 2.5.8 ≥24px 硬门禁)、
`user-journey.spec.ts:562/773/854`(UJ-03/06/07 `@admin`,失败仅 ~170ms ⇒ 疑登录/权限,含 DEC-N5 的 admin 路由改动可能)。
⇒ 另记一条仪器事实:**同一份旧代码,配不同数据,红项集合完全不同**。
所以「基线也有红」这句话必须以「基线代码 + 基线数据」的成对状态来证,否则会把**自己引入的回归读成既有状态**
——我上一条正是这样读反了,方向还是保守的那一侧(把新红当成旧红),这类错误比反向更难被发现。
**下一步(本批不做,作为修复 PR 的验收条件,已在 §14 待办里)**:
按 (1)(3) 两组逐条修根因 —— 漏锚的 spec 按 §11.3 同一手法以实测 DOM 重锚;
`p1:579`、`p4:338/396`、触摸目标两条与 `@admin` 三条必须先复现再定性(产品缺陷还是测试口径),
不允许用放宽断言或加 retry 换绿。(2) 的 axe 既有红另案。
### 14.2 逐条修完后:36 → 4 → 终跑,并把「测试自己的竞态」与「产品缺陷」分开处理
按 §14.1 的定性逐条动手,全部有复算读数:
| 类别 | 处置 | 读数 |
|---|---|---|
| 产品侧真缺陷 | `detail-trust-section` 渲染绕过门槛(fail-open)⇒ 改回 `publishableCases.map` | 变异验证:回退 ⇒ 2 条精确转红、1 条仍绿;恢复 ⇒ 35 例 EXIT=0 |
| 产品侧 a11y | 4 个文字链接触摸目标 23px < 24px(WCAG 2.5.8)⇒ 走 `min-h-6` 间距刻度;能力面板 `role="region"` 缺可访问名 ⇒ 补 `aria-label` | 触摸目标两 spec × 4 project 复跑通过;`p1/p4/p2/website-acceptance` 定点跑 chromium 81 passed |
| 限流真因 | 登录是**进程内内存桶** 10 次/15 分钟/IP,dev server 跨整轮存活 ⇒ `@admin` 旅程第 11 次登录起必得 429(这就是「单跑绿、全量红」)。额度改为可按环境覆盖,**默认仍 10**(生产姿态一字未动),只在 e2e harness 抬到 500 | `route.test.ts` 双向用例:未设 ⇒ 10;设 3 ⇒ 第 4 次判限流。9 例 EXIT=0 |
| 测试锚点过期 | `mobile.spec:45`、`website-acceptance:139` 按真源 `navigation.ts` 重锚(一级只剩 行业/能力/洞察/关于我们;联系入口是 `consult-button` 而非导航项) | `website-acceptance` × 4 project 连跑两次各 56 passed |
| 引擎行为 | `p4:403 焦点管理`:webkit / chromium-mobile 上 Tab 不落到链接(Safari 系需系统级「Press Tab to highlight each item」)。我先前试 `bringToFront` + 点空白**没有用** —— 假设被自己的读数否掉;改为同契约按引擎取证(chromium 走真实键盘,其余显式 focus 跳转链接),断言一条不减 | 2 passed(chromium-mobile + webkit) |
| **测试自身的竞态** | `pollBoundingBox` 先 `expect.poll` 等到非空、**再单独读一次** boundingBox ⇒ hydration 亚 60ms 的重挂会让第二次读取返回 null,被误报成「元素在断言瞬间消失」。改成在同一次读取里既判非空又产出值 | 探针 `docs/acceptance/2026-10-17-final/probe-logo.mjs` 实测:加载期**无双字标可见窗口**(0 次),唯一零可见是 t≈43ms header 尚未进 DOM ⇒ 产品不闪烁,问题在辅助函数 |
⇒ 判据强度核对:以上没有一处是"放宽断言/加 retry/删用例"。两处改了测法(焦点、boundingBox 取值)
都是**把两次读取合成一次**或**换等价但跨引擎可靠的手段**,几何与非空断言原样保留。
终跑(4 project 全量功能 E2E)读数随本节的收尾笔登记。