Files
novalon-website/docs/adr/0008-benchmark-grammar-takeover.md
zhangxiang ffd709ae06 feat(gates): DEC-N1 把 accent 第二条通道钉成判据 B,并抓到一条绕开色值真源的真漂移
裁定:7 个产品线色相**保留**为受控例外(实测 hero 徽章占视口 0.538%、色相仅以 6.3% alpha
底纹存在、1600×846 hero 视口冷色像素普查 = 0),但**不再**让 check:accents 的口径停在「仅类名通道」——
那等于第二条通道无人看守。判据 B 扫三处:真源 hero-themes 的 accentColor/accentBg、
可达营销代码里 style={{…}} 的色彩属性(含 --badge-accent 与内联引用 accent 令牌的更隐蔽形态)、
营销页就地组装 accentColor。豁免按 文件+色值 登记且归一化成 #rrggbb(否则换个 rgba() 写法就绕过);
登记了却命中 0 ⇒ 判红;棘轮 MAX_NON_BRAND_HUES=7,存量恰在上限 ⇒ 第 8 个色相即判红。

战果:落盘即抓到 erp-upgrade-v3/page.tsx 的 deriveTheme() 在营销页里抄了一整份 theme
(含 accentColor '#1e3a5f' 与两段渐变)绕开真源。改走 getHeroTheme(heroThemeId || 'erp') 只覆盖动态字段 badge;
与真源逐字段对拍全等,并用库内实值确认 erp 行 heroThemeId='erp' ⇒ 渲染不变(查过,不是推定)。

自证与改正(原稿从未跑成过):selftest 11 情景 EXIT=0,每情景只喂一维。
修掉两处不自洽 —— 把「另一维的豁免腐化」当串维证据会让自证永远红(腐化只是该维没喂料的必然产物,
违规数才是证据),以及 4 情景棘轮期望与 分母0 情景 stale(写 9、实取 7)按实测改正。

连带新增 scripts/check-package-keys.mjs:按父路径+键名分组查 JSON 重复键,退出码 0/1/2 三档,
--selftest 三条各测一维;活体负对照注入重复 "lint" 键 ⇒ EXIT=1 点名 scripts.lint,还原 ⇒ EXIT=0。
背景见 qa-tracker §12.8:我先前用来去重的那条 node 回读只扫顶层缩进,对目标那一维根本不敏感。

读数:check:accents 0、check:visual 0、tsc 0、jest --testPathPatterns products 48 例 0、selftest 0。
ADR-0008 补决策五并 supersede 决策一的「本批不收」,同时把被证伪的 DEC-N2 默认值 0.15 就地标注更正。
2026-10-17 08:07:10 +08:00

15 KiB
Raw Permalink Blame History

ADR 0008: 对标语法接管视觉层与导航层(Bain / Porsche Consulting 实测)

状态

已接受。部分接管 ADR-0004(其决策一、决策四的视觉判据被实测证伪,见「被证伪的既有判据」)。

日期

2026-10-17

上下文

用户要求「调研、参考 Bain 咨询和保时捷咨询官网,优化、重构当前官网的 UI、UE、UX」。

本仓在 2026-06~07 已经走过一轮对标(ADR-0004、docs/superpowers/specs/2026-06-29-phase2-bain-brand-clarity-design.md、2026-07-08-bain-differentiation-design.md),首页文案已到 v15,结论式标题与 HeroStatsBand 都已落地。所以本轮的价值不在"再对一次标",而在把对标从文案层下沉到语法层与结构层——因为这次实测出来的数字证伪了 ADR-0004 的视觉判据。

取证方法(自己取,非二手描述):Bain 走 archive.org 快照 2026-08-31、1600×846 视口,绕开 Cloudflare;Porsche Consulting 取 live 国际站首页 + 中国站导航;对每个抽样元素跑 getComputedStyle。

维度 Bain(快照 2026-08-31) Porsche Consulting(live) Novalon 修订前
border-radius 抽样全部 0px 抽样无一非零 令牌 3/6/8/12/18/24/32/9999
字色集合 仅 #000 #FFF #CC0000 #767676 仅 #000 #FFF #B6B5BA 含 7 个 coding accent
面色集合 #FFF #000 #ECECEC #FFF #000 #D6001D #F2F2F2 冷 slate 系
饱和红用作面 0 次(#CC0000 出现 65 次,全为字/线) 红出现 4 次,全是按钮 bg-brand-section #8B1530 满幅一段(FounderQuote)
成果数字 40px / 字重 500 / 纯黑 同类克制 文档写「超大字号 + 品牌色」
CTA 白底 · 红字 · 1px #D8D8D8 · radius 0 · pad 20/32 · 14px uppercase 实心 #D6001D · 白字 · radius 0 · pad 13/24 · 16px 实心朱砂 + rounded-full + --shadow-brand 光晕 + 涟漪
hover 只改 hairline→rule,不抬升 靠图与留白 .bain-card translateY(-4px) + 阴影增长

被证伪的既有判据

这两条不是口味分歧,是对标读错了,所以必须在同一笔里改文档,否则文档成了说谎的那一方:

  1. ADR-0004 决策四「关键数字:超大字号 + 品牌色 + tabular-nums」——Bain 实测 40px / 字重 500 / 纯黑。本仓 --font-size-5xl: 2.25rem 在桌面根字号 18px 下 = 40.5px,即现有档位正好命中对标值,零新增令牌;要改的是"品牌色"这半句。
  2. ADR-0004 决策一「编号为主 + 4px 色条为辅」——实测两家都没有用颜色给内容分类。本仓 7 个 accent 进令牌层后,真正跑起来的营销代码只消费了一个蓝(accent-blue)做装饰性图标砖与状态徽章:成本是全站语法被稀释,收益是一处蓝。

决策

四项,均由交付决策人在本轮 AskUserQuestion 中选定(推荐项全部采纳)。

决策一:借语法,不借色相

采纳对标的形状语法(radius 0–4px 记档、近乎单色、克制的数字排版、实心/描边两轨 CTA、hover 不抬升),保留 Novalon 自己的 #C41E3A 朱砂与朱砂条辅助图形。

落地为机器判据 scripts/check-visual-grammar.mjs(R1–R10,见下):

  • radius 记档:--radius-xs/sm = 0、md/lg = 2px、xl/2xl/3xl = 4px,新增 --radius-cta: 0px
  • --radius-full 必须保持 9999px(正向守卫):rounded-full 在本仓承载真圆——avatar switch slider radio-group progress scroll-area 骨架屏。把它一并归零会把后台与所有 Radix 表面的旋钮、滑块、头像全部方角化,这是"语法收口"最容易犯的自伤,所以单列一条并配负对照。
  • 彩色阴影令牌 --shadow-brand/-brand-hover/-glow 退役;.bain-card:hover 改为 hairline→rule,去掉位移与阴影增长
  • 7 个 --color-accent-* 降级不删除(后台内容模型 type 色标是分类编码、图表也要用),营销面一律禁用,由 scripts/check-accents.mjs 强制:豁免按文件名登记,且名单里的文件命中数变 0 同样判红(防豁免名单腐化成"没人记得为什么在这"的永久豁免)
    • ⚠ 该闸只覆盖 Tailwind 类名通道,这句口径就写在它的成功输出行里,防止后来人把它读成"营销面已无任何彩色编码"。实测还有第二条通道:src/lib/constants/hero-themes.ts 的 accentColor 以内联样式进 DetailHero 徽章(detail-hero.tsx:81-86 的 backgroundColor / color / borderColor 与 --badge-accent),11 个主题里 7 个用非品牌色相(erp #1e3a5f、crm #1e40af、bi #0c4a6e、cms #14532d、sds #78350f、oa #4c1d95、novavis #0f3d3e),落在产品·方案·服务详情页的 hero 上。本批不收它的两个理由:(i) 那属于「把 tracer-bullet 的做法套到其余模板」,而决策四明确把模板批推到验收之后;(ii) 去掉逐产品色相等于取消产品线视觉身份,那是设计裁定而不是语法收口,不该由闸顺手替决策人拍板。已登记为独立待拍项(见「后果」§已知偏差 6)。
  • hover:-translate-y 存量 28 处 / 19 文件登记为递减棘轮上限(R10):变多判红,变少不判红但把下调提示写进 note

决策二:一级导航改对标双轴

一级导航从「产品/解决方案/服务/案例/新闻/关于/联系」改为行业 × 能力 + 洞察,"产品"退出一级。

关键工程决定:把导航真源从 DB 行反转为代码。src/lib/navigation-resolution.ts 的 resolveNavigation() 只在 CMS 行满足 IA 契约(三个必需 mega key 齐备)时才采纳它,否则 fail closed 到代码常量。理由:本轮实测复现出「一条自洽的旧行」会让页脚各列静默变空——旧行本身没有格式错误,只是不符合新 IA,而原先的优先级是 DB 行覆盖代码。

同时把降级动作补齐:删掉一级"产品"会让 /products 成为孤儿,因此在二级 mega 里加入口 all-products → /products 并配守卫测试。

决策三:信任层走零编造透明路线

没有客户授权就没有案例可发。所以不做"占位假案例",而做可判别空态 + 反伪造不变量:

  • src/components/sections/results-slot.tsx 用可判别 state(而非"有没有数据")承载;casePublishBlockers() 要求 verified === true、证言有作者、≥1 个 basis === 'verified' 的指标、且不命中禁词,四者齐备才判可发布
  • L3 空数据时由替代信号槽兜底(方法论 / 团队 / 历程 / 承诺),四条都指向站内真实路由;服务承诺卡在业务确认前显示「待业务确认」占位且不可点击
  • 承诺条款收进单一真源 src/lib/constants/commitments.ts,一个 about 只留一条承诺;实测互斥的四条 SLA(<4小时 / 7×24 / 48小时 / 工作日 2 小时)中只保留有授权口径的一条

决策四:范围 = tracer-bullet 一批

首页 8 段 + 一条承载详情页(/solutions/[id])端到端做完,交付决策人看过再套其余模板。目的是避免在语法未验收前把全站 20+ 页面重写一遍。

决策五:产品线色相保留为受控例外,但第二条通道钉成机器判据(2026-10-17 轮,决策人「均采用推荐方案」)

本节 supersede 决策一里那句「本批不收它」与其两个理由,以及「若裁定保留,check:accents 的口径就永久是类名通道」—— 永久类名通道 = 第二条通道无人看守,不是裁定而是放弃。现行裁定如下:

  • 保留 7 个产品线色相(erp #1e3a5f、crm #1e40af、bi #0c4a6e、cms #14532d、sds #78350f、oa #4c1d95、novavis #0f3d3e)。 依据是它们承担产品线视觉身份,且实测可见占比极低:hero 徽章占视口 0.538%,色相只以 6.3% alpha 底纹存在, 1600×846 的 hero 视口冷色像素普查 = 0(离品牌红族 #C41E3A 色相 349.9° 最近的一条也远于 20° 判定带)。
  • 但把它收进 check:accents 的判据 B:扫①色值真源 src/lib/constants/hero-themes.ts 的 accentColor/accentBg, ②可达营销代码里的 style={{…}} 色彩属性(含 --badge-accent 这类自定义属性、以及内联引用 --color-accent-* 令牌的更隐蔽形态), ③营销页里就地组装 accentColor(绕过真源的第二份色值)。豁免按 文件 + 色值登记, 色值一律归一化成 #rrggbb(否则换个 rgba() 写法就绕过);纪律沿用判据 A:登记了却命中 0 ⇒ 判红(防腐化成永久豁免)。
  • 棘轮:MAX_NON_BRAND_HUES = 7,存量恰在上限 ⇒ 第 8 个产品线色相出现即判红(加色相是设计决定,须显式改上限)。
  • 口径边界写死在输出行里:本闸覆盖「代码面的两条入路」;未覆盖 CMS 内容里 authored 的色值(富文本/图表数据),属数据面。

自证与当场战果(这台仪器不是装饰):

  • npm run check:accents:selftest 11 情景、EXIT=0,每个情景只喂一维并额外断言未被测的那一维在该夹具上违规数为 0。 这里修掉一处自伤:原稿把「另一维的豁免腐化数」也当成串维证据,而 B 的夹具天然不带 A 的三个豁免文件 ⇒ A 必报 stale 3 ⇒ 自证永远红。腐化不是串维证据(它是"该维自己没喂料"的必然产物),违规数才是。 另两处期望不自洽(4 情景的棘轮、分母 0 情景的 stale 9 vs 实取 7)已按实测改正——原稿从未跑成过。
  • 落盘实跑当场抓到一条真漂移:src/app/(marketing)/products/erp-upgrade-v3/page.tsx 的 deriveTheme() 在营销页里就地抄了一整份 theme(含 accentColor: '#1e3a5f' 与两段渐变),绕过色值真源。 已改为 getHeroTheme(productData.heroThemeId || 'erp') + 只覆盖动态字段 badge; 与真源逐字段对拍 gradientFrom/gradientTo/gradientAngle/accentColor/accentBg/texture/layout 全等 ⇒ 渲染不变, 读数 check:accents EXIT=0、check:visual EXIT=0、tsc --noEmit EXIT=0、jest --testPathPatterns products 4 套件 48 例 EXIT=0。

理由

  • 对标的价值在于它已被验证的形状,而形状可以脱离色相继承;色相是品牌资产,不该在对标时被换掉
  • 语法层判据若只写在文档里,就有 CONTEXT.md 与 globals.css 各说一套、以及「文档比代码更新」那类问题(本轮真实踩过:--transition-hover: 150ms 只在 CSS、tailwind.config.js 只有 DEFAULT/normal/slow 三档)——所以要做成能失败的闸
  • 反伪造成果槽必须是可判别状态而不是"数据为空时的分支",否则空态、加载态、被拦态三者共用一个渲染路径,验收时无法区分"没有案例"与"案例被门槛拦下"

后果

得到的:视觉语法、accent 消费面、导航真源、承诺真源各有了一条机器判据或单一真源;npm run check:visual 已并入 test:all。

付出的:全站视觉基线需要重新采集(radius/阴影/hover 都变了);一级导航变更后 /products 的转化路径变长,需要观察。

已知偏差,本轮不修(各自登记为独立动作):

  1. StaggerReveal 默认 staggerDelay = 0.15 与 ADR-0004 决策三「子元素 stagger 30–60ms」不符;改库默认值是全站动效重排 + 基线重采,需单独授权。本批只在首页与账本处显式传 0.04–0.06。 本条于 2026-10-17 轮被证伪,无需执行(见 docs/acceptance/qa-tracker.md §12.2): src/components/ui/scroll-reveal.tsx:113 的默认值一直是 0.05(50ms,本就在 30–60ms 内), git log -S'staggerDelay = 0.15' -- src/components/ui/scroll-reveal.tsx 无任何提交, 且全站 18 个显式传参只有 0.05(16 处)与 0.06(2 处)。 ⇒ 教训与前一轮「axe 哨兵抄字面量」同族:台账里的数必须是当场仪器读数,不能是上一轮叙述的抄本。
  2. check:motion 现存 8 条违反(6 条写死贝塞尔不在令牌层、--transition-gentle = 1000ms 超 700ms 入场上限、1 条 CSS 裸时长字面量),全部为本分支基线 da9a5cb6 就有的红,非本轮引入。
  3. CaseStudiesSection 与 detail-trust-section 仍没有授权/basis 门槛(只有新的成果槽有);应在彼处与 CMS 发布时同样设闸。
  4. ui/ 组件库里 53 个不可达原语是产品决定,本批不删。
  5. .husky/pre-commit 在 git 里是 mode 100644,因此任何克隆里 lint-staged 都不会随提交执行——这是治理缺口,本批只报告不擅改。
  6. 彩色编码的第二条通道未被本批的闸覆盖:hero-themes.ts 的 7 个非品牌 accentColor
  7. 决策二的移动端连带缺陷已在终局验证轮修掉:「产品」退出一级后,移动抽屉只渲染 mainNav 这一层、底部 TabBar 也没有 /products,于是 /products 在手机上没有任何导航路径(只剩页脚)。 这是由 e2e 的可达性守卫判红发现的(不是人肉走查),修法是抽屉为带 dropdownKey 的轴 渲染其 mega 组。复测:抽屉 26 条链接含 /products、二级项 21 个。
  8. 后台发布/删除不触发缓存失效(DEC-N5,未修):DELETE /api/admin/items 与 workflow 发布路由 都不调 revalidatePath,全仓除一条 e2e 外没有任何生产代码调用 /api/cms/revalidate, 而 8 个页面的注释都写着「CMS 发布/更新时通过 /api/cms/revalidate 主动刷新」 ⇒ 实测后果是最长 1 小时(s-maxage=3600)前台仍显示已删/旧内容。 修法是把 modelCode → paths 映射从路由里提成可导入函数,再在发布/更新/删除三处调用; 属生产内容行为变更,需单独授权。 仍以内联样式渲染在产品·方案·服务详情页 hero 徽章上。需要决策人裁定"逐产品色相身份要不要保留"; 若裁定保留,check:accents 的口径就永久是「类名通道」;若裁定去掉,属模板批的视觉改动 + 基线重采。

取证与验证

  • 语法闸自证:npm run check:grammar:selftest 喂已知违规样本,R1–R9 必须全部判红,R10 棘轮必须「上限处不判红 / 上限+1 判红」;任一不成立即宣布"上面所有绿灯不作数"并 EXIT=1
  • accent 闸自证:npm run check:accents:selftest 11 情景、按 dimension 各只喂一维(A 类名:违规 / 豁免腐化 / 全绿; B 内联色彩通道与色值真源:新增未登记色相、内联写死色相、新增透传点、绕开真源、豁免腐化、分母 0 = 未能度量、全绿、 色值写法归一化、棘轮超限)。纪律来自踩过的坑:把互斥前提写进同一份夹具会让其中一维永远测不到。 2026-10-17 轮起判据 B 已上线(见决策五),故不再是「三情景只测类名通道」。
  • 注释渲染回归:solution-detail-content-v3.test.tsx 断言渲染文字里不含 /*,且先断言被污染的两段 DOM 确实渲染了(否则"找不到注释"可能只是"那段没出现");该断言已用变异验证过敏感性——把注释改回裸文本节点后仅这一条转红、其余三条仍绿
  • 负对照(待授权执行):把 --radius-cta 设成 12px,确认 ≥1 张视觉基线转红;若 N=0,说明基线什么都没拍,只读复跑的绿灯作废