裁定(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。
162 lines
8.3 KiB
JavaScript
162 lines
8.3 KiB
JavaScript
#!/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();
|