Files
novalon-website/scripts/check-accents.mjs
T
zhangxiang d622dc2120 refactor(visual): 7 个 coding accent 降为 dataviz-only,营销面消费面收窄并做成能失败的闸
裁定(ADR-0008 决策一 + 决策一修订段):**令牌保留、消费面收窄**,不删。
依据是实测而非口味 —— Bain 全站字色只有 4 个值(#000 #FFF #CC0000 #767676)、面色 3 个;
Porsche 字色 3 个、面色 4 个,红只出现在按钮上;两家**都不用颜色给内容分类**。
而 ADR-0004 决策一当年按「编号为主 + 4px 色条为辅」把 7 枚 accent 放进令牌层,
实测真正跑起来的营销代码只消费了**一个蓝**(`accent-blue`)做装饰性图标砖与状态徽章:
成本是全站语法被稀释,收益是一处蓝。

改动:
- 10 处 `accent-blue*` 换成近单色语法(`bg-bg-tertiary` + `border-border-primary` + `text-text-primary`;
  状态签去彩色底改中性描边),涉及 products-content-v3 / solution-value / solution-service-card。
  可达营销面 accent 残留实测 **0 处**。
- `globals.css` 在 accent 声明处写明「dataviz / 工具 UI 专用」与退役理由。
- **tailwind 僵尸令牌**:`--shadow-brand/-brand-hover/-glow` 早已从 CSS 退役,
  但 `boxShadow` 里三行映射原样留着 ⇒ `shadow-brand` 类照生成、
  展开成 `box-shadow: var(--shadow-brand)` 而该属性无人声明 ⇒ **静默什么都不画**,
  不报错、不算无效。R5(令牌已退役)与 R7(业务代码零消费)当时**都是绿的**,
  因为它们各看一侧,谁都不看 tailwind↔CSS 这条缝(§5.41,与 §5.37 同族)。删映射 + 新增 R11。

新增 `scripts/check-accents.mjs`(`check:accents`):营销面不得出现 `accent-*` 类。
两条防赖设计:① 豁免**按文件名**登记,不写目录通配(通配会让新文件自动继承豁免);
② 名单里的文件命中数变 0 **同样判红**(豁免名单否则必然腐化成"没人记得为什么在这"的永久豁免)。
现读:扫 251 源文件、命中 31 处 / 3 文件,全在豁免内(admin 分类色标 16、
ui/product-card 12、ui/brand-visuals 3 —— 后两枚是不可达库存)。

**自证修好了才算这条成立**(第一版是坏的,绿灯不作数):
`--selftest` 原来把「营销面有违规」和「三条豁免全命中」两个**互斥前提**塞进同一份夹具,
于是 `stale.length === 3` 永不可能成立 ⇒ 豁免腐化那一维**从未被测到**,自证 EXIT=1。
现拆成三个各测一维的情景,并**补一个全绿情景** —— 只喂负例的话,
判据写错成恒红也会"抓到所有负例",同样通过自证。三情景现全 ✓。

R10 hover 抬升棘轮按实测**从 31 下调到 28**(19 文件),只降不升;
下调提示从 print 挪进 note —— `checkGrammar` 现在被自证反复调用,
喂合成样本时打「请把上限下调到 0」是噪声,会把人引去改坏登记值。

R11 负对照**在真树上执行**:把 `boxShadow.brand/'glow'` 两行塞回 tailwind ⇒
EXIT=1、报出 2 条悬空;还原 ⇒ 11/11 成立、引用 144 个变量、悬空 0。
写 R11 时踩了两个仪器坑(都记进 §5.40/§5.41):
豁免名单写在规则里、夹具再手抄一遍 ⇒ 改一处另一处静默失效 ⇒ 提到 module 层共用;
夹具不带那条外部所有者引用 ⇒ 「豁免腐化」先判红,把「已声明不误报」这一维污染成假红,
差点被我读成判据坏 —— **先怀疑夹具,再怀疑判据**。

`check:visual`(自证先跑,自证失败即宣布绿灯作废)并入 `test:all`,另补 `check:dead` 入口。

口径边界(必须读,否则会把它当成"视觉已达标"):本闸**只覆盖 Tailwind 类名通道**。
第二条彩色编码通道是 `hero-themes.ts` 的 `accentColor`,以内联样式进
`detail-hero.tsx:81-86`,11 个主题里 **7 个用非品牌色相**(erp #1e3a5f / crm #1e40af /
bi #0c4a6e / cms #14532d / sds #78350f / oa #4c1d95 / novavis #0f3d3e),
落在产品·方案·服务详情页 hero 徽章上。**本批不收它**:① 属"套其余模板",决策四明确推到验收之后;
② 去掉逐产品色相等于取消产品线视觉身份,是**设计裁定**不是语法收口,不该由闸顺手替决策人拍板。
这句边界已印进闸的成功输出行(措辞与被验那一维一致),并登记为 DEC-N1。

复测(全部重定向到文件后读 `$?`,不用管道):
`check:accents` EXIT=0 · `check:accents:selftest` EXIT=0 · `check:grammar` EXIT=0(11/11)·
`check:grammar:selftest` EXIT=0(R1–R9 全判红 + R10「28 不红 / 29 红」+ R11 双向)·
`check:contrast` 44/44 · `check:headings` 0 · `check:brand-token` 0 · `check:token-twins` 44/44 ·
`type-check` EXIT=0 · `lint` EXIT=0(0 error / 81 warning)· `test:unit` 141 套件 / 1747 例 ·
`npm run build` EXIT=0 · **`npm run test:all` EXIT=0**(八段,含新并入的 check:visual;
e2e:fast 59 passed / 25 skipped,那 16 个 GA4 @critical 仍在 skipped 侧,须 `test:e2e:prod` 才真断言)。

已知未闭:`check:motion` 仍 EXIT=1(**8 处**),经 `git show da9a5cb6:` 自证 1000ms 与 0.6s 两处
都是基线既有红、非本轮引入,登记 DEC-N3。
2026-10-17 01:06:42 +08:00

162 lines
8.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env node
/**
* accent 消费面闸:彩色编码只能出现在「工具 UI」与「图表/序列」里,不得出现在营销面。
*
* 依据是实测:Bain 全站字色只有 4 个值(#000 #FFF #CC0000 #767676)、面色 3 个;
* Porsche 字色 3 个、面色 4 个,红只出现在按钮上。两家都**没有**用颜色给内容分类。
* 本仓 2026-06 的 ADR-0004 决策一选了「编号为主 + 4px 色条为辅」,7 个 coding accent
* 因此进了令牌层;实测下来真正在跑的营销代码只用了**一个蓝**(accent-blue)做装饰性
* 图标砖与状态徽章 —— 也就是这些令牌的存在成本一直是「全站语法」,收益是「一处蓝」。
*
* 本轮的处置不是删令牌(后台工具 UI 的分类色标确实用得上,图表也要),而是
* **把消费面收窄**:营销面(app/(marketing)/、components/{sections,detail,content}/ 中
* 可达的部分)一律不得出现 accent-*。
*
* 两条防赖设计:
* 1) 豁免**按文件名登记**,不写目录通配 —— 通配会让新文件自动继承豁免。
* 2) 名单里的文件若命中数变 0,同样判红。豁免名单只会随时间腐化成"没人记得为什么在这"
* 的永久豁免;让它主动报红,才有人去删。
*
* ⚠ 本闸**只覆盖 Tailwind 类名通道**(`accent-*`),不要把它读成"营销面没有任何彩色编码"。
* 实测还有**第二条通道**:`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 上。
* 为什么本批不一起收:它属于「把首页那一条详情页的做法套到其余模板」,而决策四明确把模板批
* 推到交付决策人验收之后;且去掉逐产品色相等于取消产品线视觉身份,是设计裁定不是语法收口。
* 登记于 docs/acceptance/qa-tracker.md,判据口径也要在那里写清"类名通道为零"。
*
* 退出码:0 成立 / 1 判红(含违规与豁免腐化)/ 2 未能度量(扫描文件数为 0)。
*/
import { readFileSync, existsSync, readdirSync } from 'node:fs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
const SRC = path.join(ROOT, 'src');
const ACCENT_RE = /\baccent-(blue|teal|amber|purple|cyan|rose|indigo)\b/g;
/** 按名登记的豁免:每条都必须仍有命中,否则判红 */
const ALLOWLIST = [
// 后台工具 UI:内容模型的类型色标是**分类编码**(16 个模型要靠颜色快速区分),
// 属"数据可视化"族而非编辑面。
{ file: 'src/app/admin/page.tsx', reason: 'CMS 模型类型的分类色标(工具 UI)' },
// 组件库库存:当前不可达,但作为 ui 原语保留;若哪天被营销面引用,须先改语法。
{ file: 'src/components/ui/product-card.tsx', reason: '组件库库存(不可达,未被营销面引用)' },
{ file: 'src/components/ui/brand-visuals.tsx', reason: '组件库库存(品牌图形调色板本身)' },
];
function walk(dir, acc = []) {
if (!existsSync(dir)) return acc;
for (const e of readdirSync(dir, { withFileTypes: true })) {
if (['node_modules', '.git', 'dist', '_archive'].includes(e.name)) continue;
const p = path.join(dir, e.name);
if (e.isDirectory()) walk(p, acc);
else if (/\.(tsx|ts)$/.test(e.name) && !/\.test\.(ts|tsx)$/.test(e.name) && !e.name.endsWith('.d.ts')) acc.push(p);
}
return acc;
}
/**
* —— 自证:三个互相独立的情景,每个只测一维 ——
*
* 第一版只喂了一个情景:营销面违规 + 三条豁免**全部有命中**,于是断言
* `stale.length === 3` 永远不可能成立(豁免有命中正是"不腐化"的定义)。
* 那不是豁免维度漏测,是**夹具把两个维度的前提写在了同一份数据里、
* 而这两个前提互斥** —— 属于"仪器坏时仍要失败"的反面:仪器压根没被喂到那一维。
* 现拆成三份,并补一份全绿情景,防的是另一头:判据写错成恒红,
* 那它也会"抓到"所有负例,自证照样过。
*/
const ALLOWED_LINES = [
['src/app/admin/page.tsx', 'const tone = bg-accent-blue'],
['src/components/ui/product-card.tsx', 'const x = bg-accent-purple'],
['src/components/ui/brand-visuals.tsx', 'const y = text-accent-cyan'],
];
const MARKETING_HIT = ['src/app/(marketing)/x.tsx', '<div className="bg-accent-blue-soft text-accent-blue" />'];
const SCENARIOS = [
{
name: '营销面违规(豁免仍各有命中)',
files: new Map([MARKETING_HIT, ...ALLOWED_LINES]),
expect: { violations: 1, stale: 0 },
},
{
name: '豁免腐化(登记在案但命中 0)',
files: new Map([['src/app/(marketing)/y.tsx', '<div className="text-ink" />']]),
expect: { violations: 0, stale: 3 },
},
{
name: '全绿(既无违规也无腐化)',
files: new Map(ALLOWED_LINES),
expect: { violations: 0, stale: 0 },
},
];
function selftest() {
console.log('accent 闸自证(负例必须被抓红,正例必须不判红)');
let ok = true;
for (const s of SCENARIOS) {
const { violations, stale } = evaluate(s.files);
const pass = violations.length === s.expect.violations && stale.length === s.expect.stale;
if (!pass) ok = false;
console.log(
` ${pass ? '✓' : '✗'} ${s.name}:违规 ${violations.length}(应 ${s.expect.violations})` +
` · 腐化 ${stale.length}(应 ${s.expect.stale})`,
);
}
if (!ok) {
console.log(' ⇒ 上面所有绿灯不作数');
return 1;
}
return 0;
}
function evaluate(fileTexts) {
const violations = [];
const hitsByFile = new Map();
for (const [rel, text] of fileTexts) {
const hits = [...text.matchAll(ACCENT_RE)];
if (hits.length === 0) continue;
hitsByFile.set(rel, hits.length);
const allowed = ALLOWLIST.some((a) => a.file === rel);
if (!allowed) {
const line = text.slice(0, hits[0].index).split('\n').length;
violations.push({ file: rel, count: hits.length, at: line, sample: hits[0][0] });
}
}
// 豁免腐化:登记了却没命中的文件
const stale = ALLOWLIST.filter((a) => !hitsByFile.has(a.file)).map((a) => a.file);
return { violations, stale, hitsByFile };
}
function main() {
if (process.argv.includes('--selftest')) process.exit(selftest());
const files = walk(SRC);
if (files.length === 0) { console.log('未能度量:src 下没扫到任何文件'); process.exit(2); }
const fileTexts = new Map(files.map((f) => [path.relative(ROOT, f).split(path.sep).join('/'), readFileSync(f, 'utf8')]));
const { violations, stale, hitsByFile } = evaluate(fileTexts);
const totalHits = [...hitsByFile.values()].reduce((a, b) => a + b, 0);
const allowedHits = [...hitsByFile].filter(([f]) => ALLOWLIST.some((a) => a.file === f));
console.log(`accent 消费面对账:扫描 ${files.length} 个源文件 · 命中 ${totalHits} 处 / ${hitsByFile.size} 文件`);
for (const [f, n] of allowedHits) {
const a = ALLOWLIST.find((x) => x.file === f);
console.log(` · 豁免 ${f} (${n} 处) — ${a.reason}`);
}
let bad = false;
for (const v of violations) { bad = true; console.log(` ✗ 营销面使用彩色编码 ${v.file}:${v.at} (${v.count} 处,如 ${v.sample})`); }
for (const f of stale) { bad = true; console.log(` ✗ 豁免已腐化:${f} 登记在案但命中 0 处 —— 请把这条豁免删掉`); }
if (bad) { console.log('\n不成立'); process.exit(1); }
// 口径写死在这一行:本闸只证明**类名通道**为零。
// 第二通道(hero-themes 的 accentColor 内联样式)不在它的敏感范围内,
// 说"营销面零彩色编码"会是假陈述 —— 措辞必须与被验的那一维一致。
console.log('\n成立:营销面零 accent-* 类彩色编码(仅类名通道),且每条豁免都仍有命中');
console.log(' 口径提示:hero-themes 的 accentColor 走内联样式,本闸不覆盖;实测 7 个非品牌色相仍在,见本文件头部注释与 qa-tracker');
}
main();