`check:axe` 首跑 EXIT=1,其中 `bgMismatch=36` 的红因写着
「底色不等于令牌值 ⇒ 样式未加载」—— 两句**都是错的**:
样式加载得好好的(light 侧逐页相等、对比度节点 0),
错的是哨兵自己抄了一份令牌值。
副本漂移的证据链:
- `axe-node-count.mjs:52` 硬编码 `EXPECTED_BG = { light:'rgb(255, 255, 255)',
dark:'rgb(10, 14, 20)' }`;
- 暗色底在 P1 暖色迁移(**本分支基线 `da9a5cb6` 之前**)就是 `--color-bg-primary: #141210`
/ `-rgb: 20 18 16`;
- `git diff da9a5cb6..HEAD -- src/app/globals.css` 里**没有任何** `color-bg-primary` 改动
⇒ 不是本轮引入;`git log -S "rgb(10, 14, 20)"` 定位到字面量入库那一笔。
归因先于修闸:少了这一步,很容易把它读成「本批改坏了」。
修法是把**副本换成真源**,而不是把副本改成新值(那只是再抄一遍,下次换色板还会红):
现读 `--color-bg-primary-rgb` 三元组当场拼期望色。
实测读到了错诊断的代价:一个失效的哨兵会**顺带伪造一句错的诊断**。
改完重做负对照,证明没把闸调瞎(§5.34 那类"全站 CSS 404 仍 exit 0"的反面):
- 临时移走 `dist/standalone/dist/static` 起服务 ⇒ `expected=""`、
`actual="rgba(0, 0, 0, 0)"` ⇒ 判红(`probe-bg-negative.mjs` 以 EXIT=0 表达
「负对照成立」);
- 装配完好 ⇒ `expected="rgb(20, 18, 16)"` 与 `actual` 相等 ⇒ 判绿。
另记一条同轮事实:本次改造漏改一处 `pageBg` 引用,闸以
`FATAL: 扫描中断(uncaughtException):pageBg is not defined` 崩掉而不是静默通过 ——
这正是退出码分档(0 通过 / 1 判红 / 2 未能度量 + FATAL 独立路径)兑现价值的地方;
而 `scripts/**/*.mjs` 不在 `tsconfig` 覆盖内,只有真跑才暴露(§5.43 同族)。
终局验证补跑读数(装配后的 standalone 产物,详见台账 §11.6):
- `check:axe:routes` 清单 **35 条** → `check:axe` **EXIT=0**:
`bgMismatch=0`、`contrastNodes=0`、`violationNodes=0`、`extraRuleNodes=0`、
`extraRuleCoveragePairs=105`、`non2xxResponses=1`(期望内的 `/_not-found`)、
`unexpectedStatus=0`。
- `test:visual:all -- --update-snapshots=none` 复跑 **104 failed / 21 passed**
(五 project 均匀 21/21/20/21/21),**0 例 element-not-found、0 例超时**。
与首跑 109/16 的差值全部归因到那 5 条 `founder-quote-section` 死选择器
(区块按裁定已删除 ⇒ 区域截图永不可能命中),已在上笔改写为反向守卫并变异验证。
⇒ 剩下的 104 条**都是像素不符**,即本批语法改动的预期外溢:
**AUTH-VISUAL 的重采量是这 104 张**,不是"基线全坏"。
- `test:e2e:prod`:`UJ-01/02/03/08/10` × chromium + chromium-mobile ⇒ **14 passed**。
⚠ GA4 那 16 例在本 worktree **仍 skipped**:worktree 没有 `.env.production`,
而 `NEXT_PUBLIC_GA_MEASUREMENT_ID` 是 **build 期烘焙**进客户端产物的 ⇒
「prod 目标下 GA4 才真断言」这条口径在缺该文件的树上不成立,
须记为**未取证**而不是通过。
ISR 冻结产物的最终闭环:删自造 `uj03-test-news-*` 行(连带 `AuditLog.targetId`
与 `ContentZone.items` 的 JSON 引用)→ `npm run build`(`news.html` 里 uj03 命中 0)
→ 重跑 routes + axe。纪律不变:**重置 ISR 只能靠重建或 revalidate,不许手删 `dist/**`**。
文档:台账 §11.6、`docs/lessons-learned.md` §5.44 + 更新记录一行、
探针 `probe-bg.mjs` / `probe-bg-sentinel.mjs` / `probe-bg-negative.mjs` / `probe-drawer.mjs`。
复跑:`type-check` EXIT=0、`lint` EXIT=0(0 error / 81 warning)、
`check:visual` EXIT=0(grammar 11/11 + accents 成立,两条自证先跑)、
`jest` 1747 例、`build` EXIT=0。
Novalon Website 文档
欢迎来到Novalon Website项目文档中心。这里包含了项目的所有技术文档、开发指南和部署说明。
文档导航
📚 架构文档
💻 开发文档
🚀 部署文档
🧪 测试文档
🔌 API文档
📖 使用指南
项目概述
Novalon Website是四川睿新致远科技有限公司的企业官网,采用现代化的技术栈构建。
技术栈
- 框架: Next.js 16 + React 19
- 语言: TypeScript
- 样式: Tailwind CSS
- 数据库: SQLite + Drizzle ORM
- 认证: NextAuth.js
- 测试: Playwright + Jest
核心功能
- 企业展示和产品服务介绍
- 成功案例和新闻动态
- 在线咨询和联系表单
- CMS内容管理后台
- 响应式设计和SEO优化
快速链接
贡献指南
文档更新
- 确保文档内容准确、清晰
- 使用Markdown格式编写
- 添加必要的代码示例
- 更新相关链接和引用
文档审查
- 技术准确性
- 内容完整性
- 格式规范性
- 链接有效性
获取帮助
如果在使用过程中遇到问题,可以:
- 查看相关文档
- 搜索故障排查指南
- 联系开发团队
文档版本
- 版本: 1.0.0
- 更新日期: 2026-03-24
- 维护者: 开发团队
© 2026 四川睿新致远科技有限公司