#!/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', '
']; 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', '
']]), 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();