Files
novalon-website/docs/acceptance/qa-tracker.md
T
zhangxiang d0090cea56 fix(motion): reduce 偏好下 hydration 不匹配(React #418)且元素停在 opacity:0
线上 /about 白屏排查(§16):30 条路由 + 6 种环境里唯一可复现的缺陷是
webkit/chromium + prefers-reduced-motion:reduce ⇒ pageerror #418,main 内 14 个元素
opacity 恒 0(正常环境只有 3 个首屏以下的滚动入场项)。

根因:useReducedMotion 用 window.matchMedia 作 useState 初值 ⇒ SSR false、客户端首帧 true;
scroll-reveal / template / page-transition 又用它决定 initial/variants/甚至早返回不同树结构,
与 SSR HTML 不一致;且 reduce 时 whileInView 被清空 ⇒ 元素停在 initial 的 opacity:0。

修法(结构恒定,减少动效改用「时长 0」表达):
- hook 首帧恒 false,挂载后 effect 同步真实偏好;
- ScrollReveal/StaggerReveal 的 initial/whileInView/variants 不再按 reduce 清空;
- template.tsx 与 StaggerChildren 去掉早返回裸结构,改空 variants。

回归守卫 e2e/reduced-motion-hydration.spec.ts(/about 与 /):断言 reduce 自证生效、
无 hydration 错误、h1 与末段标题 opacity=1。变异验证:hook 改回 matchMedia 初值 ⇒ 2 红,恢复 ⇒ 2 绿。

另:runbook 明确禁止对 dist/_next/static 用 --delete(回访者旧 HTML 会引用上一代 chunk);
本轮已从备份 --ignore-existing 合并回旧代 101 个文件。复算:tsc/type-check:e2e 0、
jest 35 套件 462 例 0、check:visual 0、check:motion 0、视觉 chromium-desktop 25/25。
2026-10-20 08:00:20 +08:00

159 KiB
Raw Blame History

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
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。

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)读数随本节的收尾笔登记。

14.3 修完之后:干净全量跑的红项集合每轮不同 ⇒ 登记为残差超时抖动,不洗成通过

三次干净全量功能 E2E(4 project、--workers=4、跑时不并发任何重命令):

轮 结果 红项集合
final5 1067 passed / 1 failed / 44 skipped (15.1m) nav-keyboard.spec.ts:56(键盘)
final6 1065 passed / 3 failed / 44 skipped (13.6m) p2-functional-e2e:136(chromium-mobile + firefox)、uj-08:54(firefox)、user-journey:419 UJ-10(firefox)——与上一轮不重合
另加一次被我自己污染的跑 1062 / 6 failed 我在跑的同时并发了两次 tsc,负载是我的错,读数不作数

逐条核对:这些红项全部是 18–25s 的超时类,且隔离复跑各自绿 —— p2:136 Logo点击返回首页(firefox + chromium-mobile)隔离 2 passed、 nav-keyboard 修复后隔离 12 passed / 加载下 68 passed / 变异回界 1 时判红、 website-acceptance × 4 project 连跑两次各 56 passed。⇒ 定性为并行墙钟抖动 (firefox 与 chromium-mobile 是慢引擎,4 workers 下首个冷导航最吃 CPU),不是逻辑缺陷。

为什么"能过"不等于"已过":本地默认 retries: CI ? 2 : 0 且 workers: CI ? 1 : undefined (playwright.config.ts:12-15)⇒ CI 侧有两次重试 + 单 worker 兜这类抖动;本地全并行没有。 口径定为:不以"隔离能绿"为由关掉断言,也不把这类残差写成"全量通过"。 PR-DESCRIPTION.md 里 npm run test 一项因此继续保持未勾选, 写清「已把 36 → 1~3,残差为并行墙钟、CI 口径覆盖,本地要稳定绿请 --workers=1」。

真正修掉的(不是掩盖):detail-trust-section 的 fail-open、4 个触摸目标 23px、 role="region" 缺名、登录限流在测试下的结构性 429、两条过期导航锚点、 webkit/mobile 的 Tab 引擎差异取证法、pollBoundingBox 的二次读取竞态、 nav-keyboard 押死 Tab 次数(改为有界键盘行走,界内到不了即失败,变异回界 1 次立刻判红)。

14.4 数据层自伤(跨 worktree 的绝对 DATABASE_URL)与两处「真根因」的修复

a) 事故与它污染了多少读数 为做基线对照,我把本 worktree 的 .env 拷进另一棵 worktree(cov-base)。而 DATABASE_URL="file:/…/ui-grammar-two-axis/prisma/dev.db" 是绝对路径 ⇒ 那棵旧代码的树跑 npm run db:seed 时,顺着绝对路径把我这棵树的 dev.db 整库覆盖成旧 IA(7 项导航)数据。 后果链:①服务端每请求打「CMS 导航配置不合格,已退回代码真源」;②**§14.3 的残差读数全部作废** (它们跑在被污染的数据上);③我据此一度判「AUTH-NAV 需重开」——判断的起点是自造脏数据。 主检出的库与它自己的旧代码是自洽的(旧 IA ↔ 旧代码),没有伤到另一条在途会话。

b) 修法:把事故变成机器防线 src/lib/seed-target.ts 的纯函数 checkSeedTarget(url, repoRoot, allowExternal): 目标库不在本树内 ⇒ 写之前中止;非 file: 协议同样要求显式放行; 生产容器 seed(file:/app/data/prod.db 在仓库根之外)按显式 SEED_ALLOW_EXTERNAL_DB=1 走。 prisma/seed.ts 在 main() 最先处调用并打印实际目标库。 8 例判据 + 活体负对照:DATABASE_URL=file:/tmp/outside-sandbox.db 跑 seed ⇒ EXIT=1, 且 /tmp/outside-sandbox.db 未被创建。数据已重新 seed 修复,回退日志从「每次」变 0 次。 ⚠ 自伤一笔:该守卫的测试最初放在 prisma/ 下,jest roots=['src'] 根本不收集(读数 Pattern: prisma/seed-target - 0 matches)——一个不被跑的守卫比没有守卫更危险,已搬进 src/lib。

c) 两处「真根因」(不记成墙钟抖动)

  1. 联系表单限流与登录同族:/api/contact 也是 5 次/小时/IP 的进程内桶 ⇒ 全量跑里多次提交必然 429。 抽出 src/lib/rate-limit-config.ts 的 readRateLimitMax(未设⇒默认;非法⇒默认且 warn;合法⇒取整), login/contact 都改用它;默认值 10/5 均未动,只在 e2e harness 抬到 500/200。
  2. website-acceptance「导航菜单功能正常」点击错位:日志实取 navigated to "/" ⇒ 点击落在了 logo 上。缺 expectHydrated(nav)(相邻用例早有、这条漏了)+ 选择器 a[href^="/"] 把 logo 也算进来。两处都修,连跑 5/5 绿(4.7s,此前 15s 超时)。 同时 uj-08 的 helper 命中的是工具行那条 /services(不是面板入口),且面板正播 280ms 动画 ⇒ not stable 重试到 15s;改语义锚点「查看全部能力」+ 等 320ms 并断言其 href。

14.5 收口:全量功能 E2E 1068 passed / 0 failed / 44 skipped(EXIT=0)

§14.3 曾把 1~3 条超时记为「并行墙钟残差」,并说 CI 的 retries 兜住。那个解释是错的—— 继续按「能复现就查根因」推进后发现,它们各自有真因,修完即 0:

曾记为"残差"的项 真因 修法
website-acceptance 导航菜单功能正常(firefox/webkit 15s) 日志实取 navigated to "/" ⇒ 点击命中了 logo;缺 expectHydrated + 选择器把 logo 算进菜单 补 hydration 前置 + 选择器排除 href="/";连跑 5/5 绿(4.7s)
p2:136 Logo点击返回首页(webkit 17.7s) 同一根因:可见 ≠ 可交互,hydration 窗口内的 click 被丢弃 补 expectHydrated;4 project × 3 轮 12/12 绿
p2:431 表单必填验证 / 多次提交类 /api/contact 5 次/小时/IP 的进程内桶,全量跑里必然 429 额度可按环境覆盖(默认 5 不动),e2e harness 抬到 200;readRateLimitMax 3 例判据
@admin 三条(UJ-03/06/07) 登录 10 次/15 分钟/IP,同族 同上(默认 10 不动,harness 500)
uj-08(firefox 隔离也红) helper hover 命中工具行的 /services 链接,且面板正播 280ms 动画 ⇒ not stable 到 15s 语义锚点「查看全部能力」+ 等 320ms + 断言其 href

⇒ 口径修正(这条比数字重要):「隔离能绿 + 集合每轮不同」不足以判为墙钟抖动。 这次每一个都被"把报错读到具体那一行"推翻了。以后遇到同类,先做两件事: ①读完整报错(是 goto 超时还是 expect 失败、naviaged to 哪里);②找同文件里已经修过同类的用例, 把它的前置(如 expectHydrated)当成约定补上。

最终读数:npm run test:functional(4 project,默认 workers)⇒ 1068 passed / 0 failed / 44 skipped,EXIT=0,13.1m。 §14.3 的残差表就此作废,仅作为"我一度把真 bug 当抖动"的留痕。

14.6 内容漂移会让视觉基线失效——这次不是样式,是 seed 恢复了 /contact 的两段文案

终版产物门禁(BUILD 0 / axe 0 / Lighthouse 0)之后,视觉只读复跑 6 failed: /contact 全页 ×5 project + input 1 张。逐项核对不是样式回归:

证据 读数
重新 seed 前后的 contact-page 行 从 785 → 792 字节,差异 2 个键:heroDescription("快速响应…" → "回复您的咨询…")与 commitmentItems[0]("快速响应您的咨询" → "回复您的咨询")
基线是哪份内容上采的 02:18 那次重采跑在被污染的旧内容上(旧库),而 21:28 的重新 seed 恢复了 seed 版本 ⇒ 图文高度/换行变化,全页截图必红

处置:重采这 6 张(AUTH-VISUAL 的授权范围),再只读复验;并把这条口径写死: 视觉基线与"seed 内容"耦合 —— 重跑 db:seed 或改 CMS 文案后,内容型基线会失效, 必须按"内容变更 ⇒ 重采 + 只读复验"处理,不能把它读成样式回归。反过来, 将来若看到只有 /contact、/news 这类内容页整页红而组件裁图全绿,先查数据而不是查 CSS。

14.7 生产侧只读核对 + 迁移预演(发布前的最后一块证据)

只读核对(scp 生产 data/prod.db 到 /tmp,本地 node:sqlite 查询;未写生产任何东西)

项 生产实测
navigation 行 旧 7 项 IA:产品/解决方案/服务/案例/新闻动态/关于我们/联系我们,面板 products,solutions,services ⇒ 新代码每请求退回代码真源
ContentModel.fields(product / service / standalone-product) 均缺 authorized 与 basis ⇒ 后台填不出案例门槛字段
生产内容里的案例条目 0 条(case-study 0 行;四个含 caseStudies 字段的模型逐行解析,数组全空)
⇒ 只发代码的影响 站点可用(fail-closed 回退),不隐藏任何内容(0 案例;dataProofs 按裁定不套硬闸);代价是每请求一条回退日志 + 后台填不出门槛字段

迁移预演:scripts/ops/sync-cms-schema.ts(默认 dry-run,--apply 才写,写后强制用真实 resolveNavigation 复查)。在生产库副本上跑通: source=cms issues=0;逐行 diff 证明变更范围 3 个 ContentModel 行 + 1 个 ContentItem 行, 其余 37 行内容、其余 13 个模型逐字节未变。 关键约束写进 runbook:服务器 Node v20 没有 node:sqlite ⇒ 迁移必须本机对库副本执行再回传; 若改用 npm run db:seed,服务器上必须显式 SEED_ALLOW_EXTERNAL_DB=1(守卫会拦 file:/app/data/prod.db), 且 seed 会重写所有被覆盖的内容行 —— 因此不推荐。

发布步骤、发布后核对(页面状态码 / 回退日志计数 / 后台字段 / 视觉抽查)与三条回滚路径: docs/development/deploy-runbook.md。代码发布本身(合 main)仍由决策人显式发起。


§15 生产发布记录(2026-10-20,决策人「确认放行」)

结论:已上线且核对通过。 origin/main = 7a410cee(与 dev 同 sha,FF-only)。

15.1 一个必须先记的治理发现:这条自动部署链从未接通

dev → main 合并后本应触发 Jenkins 部署,实测:

读数 含义
服务器 dist mtime 仍是 Oct 8、容器 Up 11 days 合 main 后没有任何部署发生
jobs/novalon-website-ci-cd/config.xml 里是 <triggers/>(空) 该任务没有任何触发器;Gitea 的 webhook(/generic-webhook-trigger/invoke?token=…)打过去不会触发构建
该任务 builds/ 只有 permalinks 从未构建过
POST /job/…/build 匿名 ⇒ 403 Authentication required 无凭据无法触发;GET /pulls/{n}/statuses 也是 [](无回写)

⇒ 「合 main = 自动部署」在这套环境里不成立。本轮按 deploy-runbook.md 走了手动发布(见 15.2)。 后续要么由 Jenkins 管理员给任务加 GenericTrigger(含 token 与 ref=refs/heads/main 过滤), 要么把 deploy-runbook.md 定为正式发布路径 —— 这是治理决策,不是我这侧能改的。

15.2 本轮实际发布步骤与读数

顺序:先发代码、后迁数据(新代码对旧导航行 fail-closed,站点全程可用)。

步骤 读数
本地重建(HEAD 7a410cee) npm run build EXIT=0;dist 380M(standalone 162M、static 2.6M、server 40M)
服务器备份 dist_backup_20261020_074545、public_backup_20261020_074545、data/prod.db.bak.20261020_074752
增量上传 rsync:3011 文件、传输 2432 个、原始 150.4MB ⇒ 线上实际 3.4MB(speedup 44);dist/_next/static 用 --delete 镜像(双侧 58 文件)
镜像重建 docker-compose -f docker-compose.server.yml build ⇒ novalon-website:latest(c2c955d34372),BUILD_EXIT=0、UP_EXIT=0
容器 healthy;docker inspect 确认挂载 data→/app/data、uploads→/app/public/uploads
页面 / /products /products/erp /solutions /solutions/manufacturing /services /insights /news /contact /about 全 200
新代码标记(线上 HTML) 「还没有可以公开的成果」×1、data-testid="results-slot…"、预约咨询 ×3、导航 行业/能力/洞察/关于我们
服务端日志 迁移前后 退回代码真源 0、`error
数据迁移 停容器 → 备份 → 本机 sync-cms-schema.ts --apply(source=cms / issues=0)→ 回传 + chown 1001:1001 + 644 → 启容器
迁移后库读数(拉回本机 node:sqlite 只读) 导航 = 行业/能力/洞察/关于我们 + 面板 industries,capabilities,insights;三模型 authorized/basis/成果口径 全 ✓;内容行数 38 未变;案例条目 0
线上实物 Playwright 对 https://www.novalon.cn/ 全页截图:结构、四轴导航、成果槽空态、行业段、能力 accordion、CTA、页脚全部正确(首访顶部只有 Cookie 条)

15.3 回滚锚点(本轮生成)

  • 静态:dist_backup_20261020_074545、public_backup_20261020_074545
  • 数据库:data/prod.db.bak.20261020_074752
  • 镜像:旧镜像仍在本地(docker images 中 novalon-website 的上一条),必要时 docker-compose up -d 前先 docker tag 回退

15.4 仍未闭合

  1. Jenkins 触发器缺失(15.1)——需管理员配置,或确认手动发布为正式路径。
  2. 生产侧案例门槛字段已进库,但尚未有真实案例数据(0 条),所以"业务可发布案例"这条端到端路径仍未在真实内容上验证过。
  3. 视觉基线的逐张读图追认(§14.8 / baseline-audit.md)仍是决策人动作。

§16 2026-10-20 · 线上 /about 白屏排查:系统性测试结论与一个真缺陷

16.1 复现矩阵(先证伪"整站/该页坏了")

维度 读数
sitemap 全量路由(30 条)逐条真实渲染 0 条异常(正文长度 / main 高度 / h1 / pageerror 全部正常)
/about 直连 200;42KB 正文、main 26KB、h1「新起点…」、无 pageerror、无 console error
引擎 × 环境 chromium / webkit / iPhone14(chromium+webkit) / dark / 3G 限速 ⇒ 全部正常、h1 可见
HTML 引用的 18 个 _next 资源 全部 200(逐个探测);nginx 访问日志 /_next/static 0 个 404
变体 URL /about/ → 308、http → 301、裸域 → 200,均落到同一页
SSR 隐藏初值 16 处 opacity:0,但首屏 h1 不在其中;禁用 JS 时 19 个元素不可见(均为下半页)

16.2 找到的真缺陷:prefers-reduced-motion 下 hydration 不匹配(React #418),大片元素停在 opacity:0

  • 复现:webkit + reducedMotion:'reduce' ⇒ pageerror Minified React error #418, 且 main 内 14 个元素 opacity 恒为 0(正常环境只有 3 个,且都是首屏以下的滚动入场项)。
  • 根因:src/hooks/use-reduced-motion.ts 用 window.matchMedia 作 useState 初值 ⇒ SSR 恒 false、客户端首帧 true;而 scroll-reveal.tsx / template.tsx / page-transition.tsx 用它决定 initial / variants / 甚至早返回不同树结构 ⇒ 与 SSR HTML 不一致。 更糟的是 reduce 时 whileInView 被清空 ⇒ 元素停在 initial 的 opacity:0。
  • 修法(三处同改,结构恒定):
    1. hook 首帧恒 false,挂载后 effect 同步真实偏好(过 hydration 后改值安全);
    2. ScrollReveal/StaggerReveal 的 initial/whileInView/variants 不再按 reduce 清空, 减少动效改为 duration: 0 / stagger: 0(一步到位);
    3. template.tsx 与 StaggerChildren 去掉早返回裸结构,改为空 variants(树结构恒定)。
  • 回归守卫:e2e/reduced-motion-hydration.spec.ts(/about 与 /)断言 ①matchMedia 自证 reduce 生效 ②无 hydration 类错误 ③h1 与末段标题 opacity=1。 变异验证:把 hook 改回 matchMedia 初值 ⇒ 2 条全红;恢复 ⇒ 2 条绿。

16.3 用户侧白屏最可能的原因与已做的缓解

  • 生产窗口:07:45 上传 → 07:48 容器重启。在该窗口内访问会拿到半套资源 ⇒ 白屏,刷新即好。
  • 另一条我引入的风险:我最初对 dist/_next/static 用了 --delete,删掉了上一代 chunk; 回访者若持有旧 HTML(浏览器缓存/bfcache),会请求已删除的 chunk ⇒ hydration 失败。 已缓解:从 dist_backup_20261020_074545 用 --ignore-existing 合并回上一代(101 个文件), 并把 runbook 改成禁止对 _next/static 用 --delete(保留 N-1 代)。
  • 仍建议用户端做一次强制刷新(⌘⇧R / Ctrl+F5);若仍白屏,需要其浏览器与版本或一张截图才能继续定位。

16.4 未复现的部分(如实记录)

「整页纯白」在我这边未复现(6 种环境 + 30 条路由全正常)。已修的 reduce 缺陷会让下半页不可见, 但不至于整页白;真正整页白只可能来自"资源半套/旧 chunk 404 后客户端崩溃"这条路径, 与本轮的上传窗口与 --delete 吻合。若用户仍复现,下一步是取 navigator.userAgent、 performance.getEntriesByType('resource') 里的 4xx/5xx 与 console 首条错误。