feat(tokens): 视觉语法收口到对标实测——圆角 0–4 记档、彩色阴影退役、卡片去 lift

依据是实测而非口味。Bain & Company(archive 快照 2026-08-31, 1600×846)与
Porsche Consulting(live 国际站)的 getComputedStyle 抽样收敛到同一条:
**两家全站 border-radius 均为 0**,且面/字色近乎单色
(Bain 字色仅 #000/#FFF/#CC0000/#767676;Porsche 面色 #FFF/#000/#D6001D/#F2F2F2,
红出现 4 次且全部是按钮底、无一次是阴影或背景)。本仓此前的「中度软化」
3→32px 八档 + 三枚品牌红阴影 + 卡片 hover 抬升,三件全是对标没有的语法。

本轮按「借语法、不借色相」执行:保留 #C41E3A 色相与朱砂条,只收口形状与层次。

圆角
- --radius-xs/sm 3/6→0、md/lg 8/12→2、xl/2xl/3xl 18/24/32→4,新增 --radius-cta: 0
- **--radius-full 保持 9999 不动**:它承载真圆(avatar/switch/slider/radio-group/
  progress/scroll-area/skeleton),一并归零会把所有旋钮与头像方角化。这条是
  check:grammar R2/R9 的正向守卫 —— 刻意做成「仪器坏了它仍要失败」的那一维
- --badge-radius 由 var(--radius-full) 改指 var(--radius-cta)(实测该令牌零消费者,
  留档不复用,删除动作留给死码族 DEC-P-2 统一处理)
- button.tsx 的 sm/default/lg/xl 走 rounded-cta,icon 档保持 rounded-full(功能形状)

彩色阴影
- --shadow-brand / --shadow-brand-hover / --shadow-glow 三枚退役(实测前两者仅 2 处、
  后者 0 处消费者),消费方回落中性档
- 同批发现并修掉一处暖化漏网:阴影基色仍是冷墨 rgba(10,14,20,α)=#0A0E14,
  而暖墨 #141210 早已落地 —— globals.css 16 处 + 业务 2 处。check:token-twins 抓不到它,
  因为阴影是字面量 rgba、没有 -rgb 孪生兄弟可对照

卡片
- .bain-card hover 去 translateY(-4px) 与阴影增长,改为 hairline→rule + 底色微移
- --card-shadow-hover / --card-transition 随之退役(前者仅 :hover 消费、后者零消费者)

新增信息线令牌 --color-border-rule #8A8377
hover 边框是「告诉用户这个可交互」的信息,按品牌 P4 三档拆分不能用界灰 #C3BDB1
(实测对卡底仅 1.78,不达非文本 3:1)。#8A8377 由我自己算:对白 3.75、对纸 #FBF9F5
3.57、对暗底 #141210 4.89 —— 两主题都过 3:1,且 -rgb 孪生已同步(44/44)。

动效
- 补 --transition-hover: 150ms 并接进 Tailwind duration 档。动效四原则 CONTEXT.md:76
  早就写了 hover 150ms,仓库从来没有这个档(BRAND-MANUAL §6 冲突 C-1)。
  抬升与光晕去掉后 hover 成了唯一的可交互提示,没档可用等于语法自相矛盾
- cta-button 的 transition-all duration-200(裸字面量)一并改为 transition-colors duration-hover

CTA 两轨(实测尺寸之间取值:Bain 20/32+14px、Porsche 13/24+16px → px-7 py-3.5 + text-sm/500)
- 实心/描边两轨都直角;不做 text-transform(中文无大小写)、不补字距(Bain 实测
  letterSpacing: normal,它的大写感来自全大写本身)
- 箭头只保留在 inline 文字链轨:两家按钮实测都是纯文字
- 描边轨静止边框用 border-border-rule,不用 ink/20(≈1.54 不达 3:1)
- 改动半径实测:63 处 <CTAButton> 调用,其中 36 处不写 variant ⇒ 落默认 primary,
  24 处 secondary、3 处 dark、0 处 inline

新闸 npm run check:grammar(9 条规则)+ check:grammar:selftest(9/9 双向自证)
- 闸只看代码:扫描前统一剥注释。不剥的话,解释「为什么退出 rounded-full」的文档注释
  本身会被判红,于是只剩两条出路 —— 改措辞去绕闸(应试,闸就此失去解释力)或把闸调瞎
- 每条规则报分母;分母为 0 ⇒ exit 2 判「未能度量」,不算通过
- 退出码分档 0/1/2,避免闸自身崩溃与判红共用 exit 1 而吞掉同批已算好的打印

顺带删死码 hero-section-v2.tsx(200 行、单一导出、全站零生产引用,仅被自己的 3 个测试
dynamic import)+ 那 3 个测试。留测试会让死码继续占覆盖率分母,并被误读成「有活在跑」。

KNOWN-RED: test:visual —— 全局令牌改动没有"爆炸半径"可言,页面级 130 张基线预期全部churn。
按计划 §10 只在 #3–#9 落地后一次性重捕(需 AUTH-VISUAL 单独授权),不按笔重写以免归因失效。

门禁实测:type-check EXIT=0 · check:grammar 9/9 · check:grammar:selftest 9/9 ·
check:token-twins 44/44 · check:contrast 44/44 · check:brand-token 0 违规 ·
check:motion 23→22(--transition-* 采集数 6→7,假红已消)· 全量 jest 143 套件 / 1769 例通过
This commit is contained in:
zhangxiang committed 2026-10-16 20:02:11 +08:00
1 parent d346301405
commit 81daedbea1
8 files changed
+387 -96

No files matched your search

+2
View File
@@ -50,6 +50,8 @@
"check:headings": "tsx scripts/utils/check-heading-hierarchy.ts",
"check:brand-token": "tsx scripts/utils/check-brand-text-token.ts",
"check:token-twins": "node scripts/check-token-twins.mjs",
"check:grammar": "node scripts/check-visual-grammar.mjs",
"check:grammar:selftest": "node scripts/check-visual-grammar.mjs --selftest",
"check:motion": "tsx scripts/utils/check-motion-constraints.ts",
"check:motion:test": "jest --roots '<rootDir>/scripts/utils/__tests__'",
"check:a11y": "npm run check:contrast && npm run check:headings && npm run check:brand-token",
+264
View File
@@ -0,0 +1,264 @@
#!/usr/bin/env node
// 视觉语法闸:把「对标实测出来的语法」钉成机器判据。
//
// 为什么要有它(实测,非口味):
// Bain & Company(archive 快照 2026-08-31,1600×846)与 Porsche Consulting(live 国际站)
// 两家 getComputedStyle 抽样结果是同一条:**全站 border-radius 为 0**,且面/字色近乎单色
// (Bain 字色仅 #000/#FFF/#CC0000/#767676;Porsche 仅 #000/#FFF/#B6B5BA,面色 #FFF/#000/#D6001D/#F2F2F2)。
// 本仓此前是 --radius-xs..3xl = 3..32px + 三枚彩色阴影(--shadow-brand/-brand-hover/-glow)
// + .bain-card 的 translateY(-4px) hover 抬升 —— 即「软边 + 彩晕 + 抬升」三件全是对标没有的。
// 2026-06-29 的 ADR-0004 把「关键数字超大字号 + 品牌色」当成 Bain 心法,实测 Bain 的成果数字是
// 40px / 字重 500 / 纯黑,故该判据已被证伪;语法层由本闸接管。
//
// 判据设计上的两条自律:
// 1) --radius-full 必须**保持** 9999px。rounded-full 在本仓承载真圆(avatar/switch/slider/
// radio-group/progress/scroll-area/skeleton),把它一并归零会方角化所有旋钮与头像 ——
// 这是「语法收口」最容易犯的自伤,所以单独一条正向守卫。
// 2) 每条规则都报分母。**分母为 0 = 判据没有目标 = 未能度量(exit 2),不算通过。**
//
// 退出码分档(避免「闸自身崩溃」与「判红」共用 exit 1,那会吞掉同批已算好的打印):
// 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 CSS = path.join(ROOT, "src/app/globals.css");
// R4 管的「编辑类 CTA 表面」。button.tsx **不在**这里 —— 它的 icon 档与涟漪点是功能性的圆,
// 由 R9 双向管(文字档必须直角、icon 档必须保持圆)。
const CTA_SURFACES = [
"src/components/ui/cta-button.tsx",
"src/components/ui/badge.tsx",
];
const BUTTON_FILE = "src/components/ui/button.tsx";
// ---- 源码遍历(只用 node 内置,避开第三方)----
function walk(dir, out = []) {
let ents;
try { ents = readdirSync(dir, { withFileTypes: true }); } catch { return out; }
for (const e of ents) {
if (e.name === "node_modules" || e.name === ".git" || e.name === "dist") continue;
const p = path.join(dir, e.name);
if (e.isDirectory()) walk(p, out);
else if (/\.(tsx?|css)$/.test(e.name)) out.push(p);
}
return out;
}
// ---- 剥注释 ----
// 必要性(本轮真实踩到):不剥的话,解释「为什么退出 rounded-full」的文档注释本身会被判红,
// 于是只剩两条出路 —— 要么改措辞去绕闸(应试,闸就此失去解释力),要么把闸调瞎。
// 正确做法是让闸只看代码。CSS 与 TS/TSX 各自的注释语法分别处理。
function stripComments(src, { line = false } = {}) {
// 块注释:整段替换成**等量换行**,否则后面的行号会集体上移,
// 闸报出来的 L### 就指不到真正的那一行(判据不可行动 = 半个假绿)。
let out = src.replace(/\/\*[\s\S]*?\*\//g, (m) => "\n".repeat((m.match(/\n/g) || []).length));
if (line) out = out.replace(/(^|[^:'"`\\])\/\/[^\n]*/g, "$1");
return out;
}
// ---- 解析 :root 里的 --radius-*(按 selector 块配对,同 check-token-twins 的教训:
// 跨块配对会把明暗两套主题误当成一对)----
function parseRadii(text) {
const lines = text.split("\n");
const blocks = [];
let cur = null;
for (let i = 0; i < lines.length; i++) {
const st = lines[i].trim();
if (st.endsWith("{") && !st.startsWith("@")) { cur = {}; blocks.push(cur); continue; }
if (st === "}") { cur = null; continue; }
if (!cur) continue;
const m = /^\s*(--radius-[a-z0-9]+)\s*:\s*([-\d.]+)(px|rem|em|%)?\s*;/.exec(lines[i]);
if (m) cur[m[1]] = { raw: `${m[2]}${m[3] || "px"}`, value: Number.parseFloat(m[2]), unit: m[3] || "px", line: i + 1 };
}
// :root 取第一个块(globals.css 的 :root 在最前)
const rootBlock = blocks.find((b) => Object.keys(b).some((k) => k.startsWith("--radius-"))) || {};
return { blocks: blocks.length, radii: rootBlock };
}
// ---- 规则实现 ----
const results = [];
function rule({ id, name, denominator, red, note }) {
results.push({ id, name, denominator, red, note });
}
function checkGrammar(rawText, rawFiles) {
// 闸只看代码:统一先剥注释,再交给各条规则
const text = stripComments(rawText);
const files = new Map([...rawFiles].map(([k, v]) => [k, stripComments(v, { line: true })]));
const { radii } = parseRadii(text);
const names = Object.keys(radii);
// R1 radius 记档:除 full / cta 外,一律 0–4px
const register = names.filter((n) => n !== "--radius-full" && n !== "--radius-cta");
const r1Red = [];
for (const n of register) {
const v = radii[n];
// rem/em/% 一律视为未收口(本仓 html{font-size} 随断点变 16/17/18,rem 圆角等于不可预测)
if (v.unit !== "px") r1Red.push(`${n} = ${v.raw} (L${v.line}) 非 px —— rem 圆角随断点漂移`);
else if (v.value > 4) r1Red.push(`${n} = ${v.raw} (L${v.line}) > 4px,超出 0–4 记档`);
}
rule({ id: "R1", name: "radius 记档 0–4px", denominator: register.length, red: r1Red });
// R2 --radius-full 必须活着且仍是真圆(正向守卫,防「一并归零」的自伤)
const full = radii["--radius-full"];
const r2Red = [];
if (!full) r2Red.push("--radius-full 不存在 —— 会方角化 avatar/switch/slider/radio/progress/scroll-area/skeleton");
else if (full.value < 9999) r2Red.push(`--radius-full = ${full.raw} < 9999px —— 真圆承载被破坏`);
rule({ id: "R2", name: "--radius-full 仍为真圆(负对照维度)", denominator: 1, red: r2Red });
// R3 --radius-cta 必须存在且为 0
const cta = radii["--radius-cta"];
const r3Red = [];
if (!cta) r3Red.push("--radius-cta 不存在 —— 两轨 CTA 无专用直角档");
else if (cta.value !== 0) r3Red.push(`--radius-cta = ${cta.raw} ≠ 0px —— CTA 未直角化`);
rule({ id: "R3", name: "--radius-cta 存在且为 0", denominator: 1, red: r3Red });
// R4 编辑类 CTA 表面不得再用 rounded-full(胶囊是本轮要退出的语法)
// 注意范围**只含** cta-button 与 badge:button.tsx 的 icon 档与涟漪点是「功能性的圆」,
// 由 R9 单独管,硬塞进 R4 会逼着把圆形控件也方角化(那正是 R2 要防的自伤)。
const r4Red = [];
let r4Den = 0;
for (const rel of CTA_SURFACES) {
const f = files.get(rel);
if (f === undefined) { r4Red.push(`${rel} 读不到 —— 判据失去目标`); continue; }
const hits = (f.match(/rounded-full/g) || []).length;
r4Den += 1;
if (hits > 0) r4Red.push(`${rel} 有 ${hits} 处 rounded-full(应走 rounded-cta)`);
}
rule({ id: "R4", name: "CTA/badge 表面零 rounded-full", denominator: r4Den, red: r4Red });
// R5 彩色阴影:令牌不得仍在 :root 里定义(对标两家的面全是无彩阴影或无阴影)
const colorShadowTokens = ["--shadow-brand", "--shadow-brand-hover", "--shadow-glow"]
.filter((t) => new RegExp(`^\\s*${t}\\s*:`, "m").test(text));
const r5Red = colorShadowTokens.map((t) => `${t} 仍定义于 globals.css —— 彩色阴影是对标没有的语法`);
rule({ id: "R5", name: "彩色阴影令牌已退役", denominator: 3, red: r5Red });
// R6 .bain-card:hover 不得有位移抬升(两家 hover 只改 hairline→rule,不 lift)
const cardHover = /\.bain-card:hover\s*\{([^}]*)\}/s.exec(text);
const r6Den = cardHover ? 1 : 0;
const r6Red = [];
if (!cardHover) r6Red.push("找不到 .bain-card:hover 块 —— 无法判定 lift 是否已去");
else if (/translate[3d]?Y|transform\s*:/.test(cardHover[1])) r6Red.push(".bain-card:hover 仍有 transform/translateY 抬升");
rule({ id: "R6", name: ".bain-card hover 无位移抬升", denominator: r6Den, red: r6Red });
// R7 弱口径防护:彩色阴影即使令牌删了,工具类引用也不能残留在业务代码
const r7Red = [];
let r7Den = 0;
for (const [rel, f] of files) {
if (rel === "src/app/globals.css") continue;
const hits = (f.match(/\bshadow-(brand-hover|brand|glow)\b/g) || []).length;
if (hits > 0) { r7Den += 1; r7Red.push(`${rel} 仍消费彩色阴影 ${hits} 处`); }
}
rule({ id: "R7", name: "业务代码零彩色阴影消费", denominator: r7Den, red: r7Red, note: "分母为「仍在消费的文件数」,0 = 已清零(成立),非「未度量」" });
// R8 组件级圆角令牌必须落进记档 —— R4 只扫工具类,会漏掉 --badge-radius: var(--radius-full)
// 这类「走令牌而不是走 class」的路径(本轮实测确实漏了 badge,故补此条)。
// 例外:--avatar-radius 承载真圆,必须指向 --radius-full。
const CIRCLE_TOKENS = new Set(["--avatar-radius"]);
const compTokens = [...text.matchAll(/^\s*(--[a-z0-9-]*(?:radius)[a-z0-9-]*)\s*:\s*([^;]+);/gm)]
.map((m) => ({ name: m[1], value: m[2].trim() }))
.filter((t) => t.name !== "--radius-xs" && !/^--radius-/.test(t.name));
const r8Red = [];
for (const t of compTokens) {
const ref = /var\(\s*(--radius-[a-z0-9]+)\s*\)/.exec(t.value);
const lit = /^[-\d.]+(px|rem|em|%)?$/.test(t.value) ? t.value : null;
if (ref) {
const target = ref[1];
if (CIRCLE_TOKENS.has(t.name)) {
if (target !== "--radius-full") r8Red.push(`${t.name} = var(${target}) —— 真圆承载被改走,应指回 --radius-full`);
} else if (target === "--radius-full") {
r8Red.push(`${t.name} = var(--radius-full) —— 胶囊语法未退出,应指 var(--radius-cta)`);
}
} else if (lit && /px$/.test(lit) && Number.parseFloat(lit) > 4 && !CIRCLE_TOKENS.has(t.name)) {
r8Red.push(`${t.name} = ${lit} > 4px,超出记档`);
} else if (!ref && !lit) {
r8Red.push(`${t.name} = "${t.value}" —— 既非记档字面量也非 var() 引用,无法判定`);
}
}
rule({ id: "R8", name: "组件级圆角令牌落进记档(补 R4 的令牌路径盲区)", denominator: compTokens.length, red: r8Red });
// R9 button.tsx 尺寸档:文字按钮走 rounded-cta,icon 档**必须**保持 rounded-full。
// 这一条同时是正例与反例:文字档出现胶囊 ⇒ 判红;icon 档被一起归零 ⇒ 也判红
// (圆形图标钮是功能形状,与 avatar/开关钮同类,不该被"语法收口"顺手带走)。
const btn = files.get(BUTTON_FILE);
const r9Red = [];
let r9Den = 0;
if (btn === undefined) {
r9Red.push(`${BUTTON_FILE} 读不到 —— 判据失去目标`);
} else {
const sizeBlock = /size:\s*\{([\s\S]*?)\n\s*\},/.exec(btn);
if (!sizeBlock) {
r9Red.push("找不到 button.tsx 的 size 变体块 —— 无法判定,不算通过");
} else {
const body = sizeBlock[1];
for (const key of ["sm", "default", "lg", "xl"]) {
const m = new RegExp(`^\\s*${key}:\\s*'([^']*)'`, "m").exec(body);
if (!m) { r9Red.push(`size.${key} 未找到 —— 判据失去目标`); continue; }
r9Den += 1;
if (/rounded-full/.test(m[1])) r9Red.push(`size.${key} 仍是 rounded-full(应走 rounded-cta):${m[1]}`);
else if (!/rounded-cta/.test(m[1])) r9Red.push(`size.${key} 未声明 rounded-cta:${m[1]}`);
}
const icon = /^\s*icon:\s*'([^']*)'/m.exec(body);
if (!icon) r9Red.push("size.icon 未找到 —— 无法确认圆形控件未被方角化");
else {
r9Den += 1;
if (!/rounded-full/.test(icon[1])) r9Red.push(`size.icon 丢了 rounded-full —— 圆形图标钮被方角化(功能形状,非装饰圆角):${icon[1]}`);
}
}
}
rule({ id: "R9", name: "按钮尺寸档直角、icon 档保持圆(双向)", denominator: r9Den, red: r9Red });
return results;
}
// ---- 自证(负例):喂一批明知违规的样本,不判红就宣布上面全部不作数 ----
function selftest() {
const bad = `:root {\n --radius-xs: 3px;\n --radius-sm: 6px;\n --radius-full: 0px;\n --shadow-brand: 0 6px 24px rgba(196,30,58,.22);\n --badge-radius: var(--radius-full);\n}\n.bain-card:hover { transform: translateY(-4px); }\n`;
const files = new Map([
["src/app/globals.css", bad],
["src/components/ui/cta-button.tsx", 'className="rounded-full"'],
// R9 双向都要被抓到:文字档仍是胶囊 **且** icon 档被方角化
["src/components/ui/button.tsx", "shadow-brand\n size: {\n sm: 'h-9 rounded-full px-3',\n default: 'h-11 rounded-full px-5',\n lg: 'h-12 rounded-cta px-6',\n xl: 'h-14 rounded-cta px-8',\n icon: 'h-11 w-11 rounded-cta',\n },"],
["src/components/ui/badge.tsx", 'className="rounded-full"'],
["src/app/(marketing)/x.tsx", 'className="shadow-brand-hover"'],
]);
const r = checkGrammar(bad, files);
const redIds = r.filter((x) => x.red.length > 0).map((x) => x.id);
const expect = ["R1", "R2", "R3", "R4", "R5", "R6", "R7", "R8", "R9"];
const missing = expect.filter((id) => !redIds.includes(id));
console.log("自证(负例必须全部被抓红):");
console.log(` 被抓红 ${redIds.join(",") || "(无)"}`);
if (missing.length) {
console.log(` ✗ 未被抓到:${missing.join(",")} ⇒ 这些规则没有约束力,上面所有绿灯都不作数`);
return 1;
}
console.log(` ✓ ${expect.length}/${expect.length} 条规则对已知违规均判红`);
return 0;
}
function main() {
if (process.argv.includes("--selftest")) process.exit(selftest());
if (!existsSync(CSS)) { console.log(`未能度量:${CSS} 不存在`); process.exit(2); }
const text = readFileSync(CSS, "utf8");
const files = new Map();
for (const p of walk(path.join(ROOT, "src"))) files.set(path.relative(ROOT, p), readFileSync(p, "utf8"));
const r = checkGrammar(text, files);
const unmeasurable = r.filter((x) => x.denominator === 0 && x.id !== "R7");
const red = r.filter((x) => x.red.length > 0);
console.log("视觉语法对账(Bain 2026-08-31 快照 + Porsche live 实测语法)");
for (const x of r) console.log(` ${x.red.length ? "✗" : "✓"} ${x.id} ${x.name}|分母 ${x.denominator}|违规 ${x.red.length}${x.note ? `|${x.note}` : ""}`);
if (unmeasurable.length) {
console.log(`\n未能度量:${unmeasurable.map((x) => x.id).join(",")} 分母为 0 —— 判据没有目标,不算通过`);
process.exit(2);
}
for (const x of red) for (const m of x.red) console.log(" ✗ " + x.id + " " + m);
if (red.length) { console.log(`\n不成立:${red.length} 条规则违规`); process.exit(1); }
console.log(`\n成立:${r.length}/${r.length} 条语法判据通过`);
}
main();
+60 -36
View File
@@ -114,6 +114,14 @@ body {
--color-border-primary-rgb: 247 244 239;
--color-border-secondary: #C3BDB1;
--color-border-secondary-rgb: 195 189 177;
/* 信息线档(P4 三档里的中间那一档)—— 2026-10-16 新增
品牌裁定把「线」按职责拆两档:装饰分隔线用界灰 #C3BDB1(对卡底实测 1.78,
WCAG 1.4.11 不管装饰线,故允许);**凡承担信息的线**(hover 边框、选中态、
图形边界)一律用本令牌 #8A8377 —— 对卡底白实测 3.75、对纸底 #FBF9F5 实测 3.57、
对暗底 #141210 实测 4.89,两主题均过非文本 3:1。
hover 边框属于「告诉用户这个可交互」的信息,因此**不能**用界灰那档。 */
--color-border-rule: #8A8377;
--color-border-rule-rgb: 138 131 119;
--color-border-accent: #141210;
--color-border-accent-rgb: 20 18 16;
--color-border-light: #FBF9F5;
@@ -172,22 +180,22 @@ body {
/* 阴影系统(按层级 + 用途分类) */
/* 基础层级:几乎看不见,用于微妙的边界定义 */
--shadow-xs: 0 1px 1px rgba(10, 14, 20, 0.03);
--shadow-xs: 0 1px 1px rgba(20, 18, 16, 0.03);
/* 轻量:卡片默认状态、输入框 */
--shadow-sm: 0 1px 3px rgba(10, 14, 20, 0.04), 0 1px 2px rgba(10, 14, 20, 0.02);
--shadow-sm: 0 1px 3px rgba(20, 18, 16, 0.04), 0 1px 2px rgba(20, 18, 16, 0.02);
/* 中等:悬浮状态、下拉菜单 */
--shadow-md: 0 4px 12px rgba(10, 14, 20, 0.06), 0 2px 4px rgba(10, 14, 20, 0.03);
--shadow-md: 0 4px 12px rgba(20, 18, 16, 0.06), 0 2px 4px rgba(20, 18, 16, 0.03);
/* 大型:模态框、悬浮卡片 */
--shadow-lg: 0 12px 28px rgba(10, 14, 20, 0.08), 0 4px 8px rgba(10, 14, 20, 0.04);
--shadow-lg: 0 12px 28px rgba(20, 18, 16, 0.08), 0 4px 8px rgba(20, 18, 16, 0.04);
/* 超大:全屏弹窗、重要浮层 */
--shadow-xl: 0 24px 56px rgba(10, 14, 20, 0.1), 0 8px 16px rgba(10, 14, 20, 0.06);
/* 品牌阴影:CTA 按钮、品牌强调元素 */
--shadow-brand: 0 6px 24px rgba(196, 30, 58, 0.22);
--shadow-brand-hover: 0 8px 32px rgba(196, 30, 58, 0.32);
--shadow-xl: 0 24px 56px rgba(20, 18, 16, 0.1), 0 8px 16px rgba(20, 18, 16, 0.06);
/* 内阴影:凹陷效果、输入框聚焦 */
--shadow-inset: inset 0 2px 4px rgba(10, 14, 20, 0.04);
/* 光晕阴影:发光效果(慎用) */
--shadow-glow: 0 0 40px rgba(196, 30, 58, 0.15);
--shadow-inset: inset 0 2px 4px rgba(20, 18, 16, 0.04);
/* 彩色阴影已退役(2026-10-16 对标实测):原 --shadow-brand / --shadow-brand-hover /
--shadow-glow 三枚都是 rgba(196,30,58,α) 的品牌红晕。两家近单色对标里,
Porsche 的红出现 4 次且**全部是按钮底色**、Bain 的 #CC0000 出现 65 次且**无一次是阴影或面**
——「饱和红只做点缀,绝不做光晕/背景」。故此处不留令牌,消费方改走中性阴影或直接无阴影。
机器判据:npm run check:grammar(R5 令牌退役 / R7 业务代码零消费)。 */
/* 字体系统
字族按「逐字符」回退:拉丁字母命中 Geist(无 CJK 字形),
@@ -247,20 +255,31 @@ body {
--spacing-5xl: 8rem;
--spacing-6xl: 12rem;
/* 圆角系统(按用途分类)—— 中度软化:4→6/6→8/10→12/14→18,
让"硬边"卡片语言变为"柔边",与增强的卡片阴影呼应。
注意:SM/MD/LG 同步联动大量 Tailwind 圆角类,全局生效。 */
--radius-xs: 3px; /* 极小:标签、徽章 */
--radius-sm: 6px; /* 小:按钮、输入框 */
--radius-md: 8px; /* 中:卡片、弹窗 */
--radius-lg: 12px; /* 大:大型卡片、容器 */
--radius-xl: 18px; /* 特大:英雄卡片、特色模块 */
--radius-2xl: 24px; /* 超大:全屏弹窗、大型容器 */
--radius-3xl: 32px; /* 巨大:展示卡片 */
--radius-full: 9999px; /* 圆形:头像、圆形按钮 */
/* 圆角系统 —— 0–4px 记档(2026-10-16 对标实测收口)
Bain & Company(archive 2026-08-31, 1600×846)与 Porsche Consulting(live)两家的
getComputedStyle 抽样是同一条:**全站 border-radius 为 0**。此前本仓是「中度软化」的
3→32px 八档,属对标没有的语法,故按用途折成三档:0(按钮/输入/标签)· 2(卡片)· 4(大容器)。
--radius-full **必须保持 9999**:它承载真圆(avatar/switch/slider/radio-group/
progress/scroll-area/skeleton),一并归零会把所有旋钮与头像方角化。
单位一律 px,不用 rem —— 本仓 html{font-size} 随断点取 16/17/18,rem 圆角等于不可预测。
机器判据:npm run check:grammar(R1 记档 / R2 真圆存活 / R3 cta 档 / R8 组件令牌路径)。 */
--radius-xs: 0px; /* 极小:标签、徽章 */
--radius-sm: 0px; /* 小:按钮、输入框 */
--radius-md: 2px; /* 中:卡片、弹窗 */
--radius-lg: 2px; /* 大:大型卡片、容器 */
--radius-xl: 4px; /* 特大:英雄卡片、特色模块 */
--radius-2xl: 4px; /* 超大:全屏弹窗、大型容器 */
--radius-3xl: 4px; /* 巨大:展示卡片 */
--radius-full: 9999px; /* 圆形:头像、开关钮、滑块、进度条 —— 勿归零 */
--radius-cta: 0px; /* 两轨 CTA 专用直角档(对标两家按钮均为 0) */
/* 过渡系统(按时长分级) */
--transition-instant: 100ms;
/* hover 档(2026-10-16 补):动效四原则 CONTEXT.md:76 早就写了「hover 150ms」,
但仓库从来没有这个档 —— 品牌手册 BRAND-MANUAL §6 把它登记为冲突 C-1(当时只能取 fast 180ms)。
本批把卡片的位移抬升与彩色光晕都去掉后,**hover 的边框/底色变化成了唯一的可交互提示**,
没有这一档就等于「语法要求的核心 affordance 无令牌可用」。补在此处闭合 C-1。 */
--transition-hover: 150ms;
--transition-fast: 180ms;
--transition-normal: 280ms;
--transition-slow: 450ms;
@@ -302,18 +321,19 @@ body {
--btn-padding-x: 1.5rem;
--btn-font-size: 0.875rem;
/* 卡片 —— 中度软化:阴影加深(透明度 0.06→0.08),新增 y 偏移的 hover 抬升过渡。
让卡片从"靠 1px 硬边分界"变为"靠柔和阴影分层",与增大圆角呼应。 */
/* 卡片 —— 扁平账本(2026-10-16 对标实测收口)
原「中度软化」靠柔和阴影 + hover 抬升分层;两家对标实测都是**无抬升、阴影近乎为零**,
分层由 hairline 承担(Bain 面色仅 #FFF/#ECECEC/#000,卡片无阴影;Porsche 面色 #FFF/#F2F2F2)。
hover 只改 边框(hairline → rule)+ 底色,不位移、不增阴影 —— 位移抬升是 Porsche 影片式
动效借来的,不是 Bain 账本语法,且它与「零圆角 + 近单色」叠在一起会互相拆台。
--card-shadow-hover / --card-transition 已退役(前者只被 :hover 消费,后者零消费者)。 */
--card-padding: 1.5rem;
--card-padding-lg: 2.5rem;
--card-gap: 1.5rem;
--card-border-radius: var(--radius-lg);
--card-shadow: 0 1px 2px rgba(10, 14, 20, 0.04), 0 2px 8px rgba(10, 14, 20, 0.08);
--card-shadow-hover: 0 4px 12px rgba(10, 14, 20, 0.06), 0 12px 32px rgba(10, 14, 20, 0.12);
--card-shadow: 0 1px 2px rgba(20, 18, 16, 0.04);
--card-border: 1px solid var(--color-border-light);
--card-transition: transform var(--transition-normal) var(--ease-out),
box-shadow var(--transition-normal) var(--ease-out),
border-color var(--transition-normal) var(--ease-out);
--card-border-hover: 1px solid var(--color-border-rule);
/* 输入框 */
--input-height: 2.75rem;
@@ -332,7 +352,7 @@ body {
--badge-height-md: 1.5rem;
--badge-padding-x: 0.625rem;
--badge-font-size: 0.6875rem;
--badge-radius: var(--radius-full);
--badge-radius: var(--radius-cta); /* 原 var(--radius-full) 胶囊;对标两家标签/徽章均为方角 */
/* Tabs 标签页 */
--tab-height: 2.5rem;
@@ -856,8 +876,8 @@ html[data-theme='dark'] body {
}
.hero-grid-overlay--light {
background-image:
linear-gradient(rgba(10, 14, 20, 0.05) 1px, transparent 1px),
linear-gradient(90deg, rgba(10, 14, 20, 0.05) 1px, transparent 1px);
linear-gradient(rgba(20, 18, 16, 0.05) 1px, transparent 1px),
linear-gradient(90deg, rgba(20, 18, 16, 0.05) 1px, transparent 1px);
background-size: 44px 44px;
-webkit-mask-image: radial-gradient(circle at 50% 50%, #000 35%, transparent 82%);
mask-image: radial-gradient(circle at 50% 50%, #000 35%, transparent 82%);
@@ -893,12 +913,16 @@ html[data-theme='dark'] body {
border: var(--card-border);
border-radius: var(--card-border-radius);
box-shadow: var(--card-shadow);
transition: transform var(--transition-fast) var(--ease-out),
box-shadow var(--transition-fast) var(--ease-out);
/* hover 只过渡「边框 + 底色」两维 —— 不位移、不增阴影。
对标实测:Bain 卡片无阴影无抬升、分层靠 hairline;Porsche 靠图与留白。
位移抬升来自 Porsche 的影片式动效,与「零圆角 + 近单色」叠用会互相拆台。
时长走 --transition-hover(150ms,动效四原则里 hover 那一档,此前仓库无对应令牌)。 */
transition: border-color var(--transition-hover) var(--ease-out),
background-color var(--transition-hover) var(--ease-out);
}
.bain-card:hover {
transform: translateY(-4px);
box-shadow: var(--card-shadow-hover);
border: var(--card-border-hover);
background: var(--color-bg-secondary);
}
/* === Bain 式不对称布局系统 === */
+2 -1
View File
@@ -122,7 +122,8 @@ export function PressableButton({
}: PressableButtonProps) {
const baseStyles = {
primary:
'bg-brand text-white shadow-sm hover:shadow-brand-hover',
// hover 阴影走中性档:彩色阴影(--shadow-brand-hover)已随对标语法收口退役
'bg-brand text-white shadow-sm hover:shadow-md',
secondary:
'bg-bg-elevated text-ink border border-border-primary hover:border-brand/30 hover:shadow-md',
ghost:
+3 -27
View File
@@ -306,30 +306,6 @@ describe('CTASection', () => {
});
});
describe('HeroSectionV2', () => {
it('should render hero heading and content', async () => {
const { HeroSectionV2 } = await import('./hero-section-v2');
render(<HeroSectionV2 />);
expect(screen.getByText('企业数字化转型服务商')).toBeInTheDocument();
expect(screen.getByText('预约咨询')).toBeInTheDocument();
expect(screen.getByText('探索产品')).toBeInTheDocument();
});
it('should render journey steps', async () => {
const { HeroSectionV2 } = await import('./hero-section-v2');
render(<HeroSectionV2 />);
// These labels appear in both CAPABILITIES and JOURNEY_STEPS, use getAllByText
expect(screen.getAllByText('需求沟通').length).toBeGreaterThanOrEqual(1);
expect(screen.getAllByText('方案诊断').length).toBeGreaterThanOrEqual(1);
expect(screen.getAllByText('敏捷交付').length).toBeGreaterThanOrEqual(1);
expect(screen.getAllByText('长期陪跑').length).toBeGreaterThanOrEqual(1);
});
it('should provide CTA link to contact', async () => {
const { HeroSectionV2 } = await import('./hero-section-v2');
render(<HeroSectionV2 />);
const links = screen.getAllByTestId('static-link');
const contactLink = links.find(l => l.getAttribute('href') === '/contact');
expect(contactLink).toBeInTheDocument();
});
});
// HeroSectionV2 的三个用例随组件本体一同删除(2026-10-16):
// 该组件全站零生产引用(仅被本测试文件 dynamic import),属 qa-tracker DEC-P-2 死码族。
// 保留测试会让死码继续占用覆盖率分母,并在视觉上被误读为「有活在跑」。
+8 -5
View File
@@ -11,7 +11,7 @@ const buttonVariants = cva(
variants: {
variant: {
primary:
'bg-brand text-white shadow-sm hover:bg-brand-hover hover:shadow-brand-hover hover:-translate-y-px active:translate-y-0 active:scale-[0.97] active:shadow-sm transition-all duration-fast ease-standard',
'bg-brand text-white shadow-sm hover:bg-brand-hover hover:shadow-md hover:-translate-y-px active:translate-y-0 active:scale-[0.97] active:shadow-sm transition-all duration-fast ease-standard',
secondary:
'bg-dark-bg text-white shadow-sm hover:bg-dark-bg-secondary hover:shadow-md hover:-translate-y-px active:translate-y-0 active:scale-[0.97] active:shadow-sm transition-all duration-fast ease-standard',
outline:
@@ -24,10 +24,13 @@ const buttonVariants = cva(
'bg-error text-white shadow-sm hover:bg-error-hover hover:-translate-y-px active:translate-y-0 active:scale-[0.97] transition-all duration-fast ease-standard',
},
size: {
sm: 'h-9 rounded-full px-3 text-xs font-medium',
default: 'h-11 rounded-full px-5 py-2 font-medium',
lg: 'h-12 rounded-full px-6 text-base font-semibold',
xl: 'h-14 rounded-full px-8 text-base font-semibold',
/** 文字按钮一律直角(rounded-cta = 0):Bain 与 Porsche 实测按钮 border-radius 均为 0。
* icon 保持圆(rounded-full)—— 它是「功能性的圆」不是装饰圆角,与 avatar/开关钮同类,
* check:grammar 的 R2/R9 就是为把这两类分开而写的(一并归零会方角化所有圆形控件)。 */
sm: 'h-9 rounded-cta px-3 text-xs font-medium',
default: 'h-11 rounded-cta px-5 py-2 font-medium',
lg: 'h-12 rounded-cta px-6 text-base font-semibold',
xl: 'h-14 rounded-cta px-8 text-base font-semibold',
icon: 'h-11 w-11 rounded-full',
},
},
+36 -27
View File
@@ -8,23 +8,32 @@ import { StaticLink } from '@/components/ui/static-link';
/**
* CTAButton — 全站统一的「行动召唤」组件
*
* 设计意图(见 .impeccable.md / Phase B P5):
* - Pill 化(rounded-full),与项目 Button 组件 size 体系一致
* - 品牌箭头签名化:内置 ArrowRight,hover 时 translate-x 形成微交互
* - 四变体覆盖全站 CTA 场景,避免"全是大红 pill"的 UI 噪音:
* - primary:品牌红填充 pill + 大箭头(hero 主行动 / 底部大 CTA)
* - secondary:描边墨色 pill + 大箭头(浅色 section 次行动 / 跳转按钮)
* - dark:描边浅色 pill + 大箭头(深色区块(bg-dark-bg)内的次行动,如 brand/team 底部 CTA)
* - inline:透明 + 小箭头 + 文字色(卡片内"了解更多"轻量次行动)
* 语法来源(2026-10-16 对标实测,非口味):
* - Bain & Company(archive 2026-08-31)主 CTA 实测 = `padding: 20px 32px`、`font-size: 14px`、
* `font-weight: 500`、`letter-spacing: normal`、**`border-radius: 0`**、1px solid #D8D8D8、
* `text-transform: uppercase`、白底 + #CC0000 文字。**纯文字,无箭头。**
* - Porsche Consulting(live)实心按钮实测 = `padding: 13px 24px 12px 21px`、`font-size: 16px`、
* **`border-radius: 0`**、#D6001D 底 + 白字。**也纯文字。**
* 它的「More Insights」是 24px 文字链轨,箭头只出现在这一轨上。
*
* dark 变体于 2026-08-31 P5 批次 4 新增:brand/team 底部深色 CTA 区块的次行动此前用
* text-dark-text-primary + border-dark-border 手写描边,现统一进组件,避免深色背景上误用
* secondary(text-ink)导致不可见。
* - 200-300ms transition(动效四原则区间内)
* - 主行动(primary)触达品牌红 #C41E3A 单电压,遵循"每页 ≥ 3 处品牌红触达点,面积 ≤ 10%"约束
* 由此得本组件的四条约束:
* 1. **两轨都直角**(`rounded-cta` = 0px)。原 `rounded-full` 胶囊是本仓自造语法,两家都没有。
* 2. **不做 `text-transform`**:中文无大小写,uppercase 那维借不过来;也不补字距 ——
* Bain 实测 `letterSpacing: normal`,它的大写感来自全大写本身,不是追踪。
* 3. **箭头只在 inline(文字链轨)**:实心/描边两轨是按钮,按钮在两家都是纯文字。
* 4. **描边轨的静止边框用 `border-border-rule`(#8A8377,对卡底实测 3.75)**,
* 不用 `ink/20`(≈1.54,不达非文本 3:1)。hover 才提到墨档。
*
* 抽离自 src/app/(marketing)/home-content-v15.tsx (2026-08-31),原 primary/secondary 行为完全保留;
* 新增 inline 变体支持次行动场景;data-testid 透传避免破坏既有测试快照。
* 变体(四档,覆盖全站 CTA 场景,避免"全是大红实心"的噪音):
* - primary:朱砂实心(hero 主行动 / 底部大 CTA)
* - secondary:描边(浅色 section 次行动 / 跳转)
* - dark:深色区块(bg-dark-bg)内的次行动 —— 2026-08-31 P5 批次 4 新增,
* 避免深色底上误用 secondary(text-ink)导致不可见
* - inline:透明文字链 + 小箭头(卡片内「了解更多」轻量次行动,对标 Porsche 的 More- Insights 轨)
*
* 用量(2026-10-16 实测,改动半径用):63 处调用 ⇒ 36 处不写 variant(落默认 primary)、
* 24 处 secondary、3 处 dark、0 处 inline(inline 由首页 v16 的文字链轨开始使用)。
* 机器判据:npm run check:grammar(R3 cta 档为 0 / R4 本文件零 rounded-full)。
*/
export type CTAButtonVariant = 'primary' | 'secondary' | 'dark' | 'inline';
@@ -38,22 +47,23 @@ export interface CTAButtonProps {
innerClassName?: string;
}
/** 两轨共用的尺寸档:Bain 20/32+14px 与 Porsche 13/24+16px 之间取 px-7 py-3.5 + text-sm/500 */
const CTA_SIZE = 'px-7 py-3.5 text-sm font-medium';
const VARIANT_STYLES: Record<CTAButtonVariant, string> = {
primary:
'bg-brand text-white hover:bg-brand-hover px-10 py-4 font-semibold text-base',
`bg-brand text-white hover:bg-brand-hover rounded-cta ${CTA_SIZE}`,
secondary:
'text-ink border border-ink/20 hover:border-ink/40 hover:bg-ink/5 px-10 py-4 font-semibold text-base',
`bg-bg-primary text-text-primary border border-border-rule rounded-cta hover:border-border-dark hover:bg-bg-secondary ${CTA_SIZE}`,
dark:
'text-dark-text-primary border border-dark-border hover:border-dark-text-muted hover:bg-white/5 px-10 py-4 font-semibold text-base',
`bg-transparent text-dark-text-primary border border-dark-border rounded-cta hover:border-dark-text-muted hover:bg-white/5 ${CTA_SIZE}`,
inline:
'text-text-primary hover:text-brand-ink px-0 py-0 font-medium text-sm bg-transparent border-0',
};
const ARROW_STYLES: Record<CTAButtonVariant, string> = {
primary: 'w-5 h-5 transition-transform duration-normal group-hover:translate-x-2',
secondary: 'w-5 h-5 transition-transform duration-normal group-hover:translate-x-2',
dark: 'w-5 h-5 transition-transform duration-normal group-hover:translate-x-2',
inline: 'w-4 h-4 transition-transform duration-normal group-hover:translate-x-1',
/** 箭头只在文字链轨出现;实心/描边两轨按实测为纯文字 */
const ARROW_STYLES: Partial<Record<CTAButtonVariant, string>> = {
inline: 'w-4 h-4 transition-transform duration-hover group-hover:translate-x-1',
};
export function CTAButton({
@@ -64,20 +74,19 @@ export function CTAButton({
dataTestId,
innerClassName,
}: CTAButtonProps) {
const isPill = variant !== 'inline';
const arrow = ARROW_STYLES[variant];
return (
<StaticLink
href={href}
data-testid={dataTestId}
className={cn(
'group inline-flex items-center gap-3 transition-all duration-200',
isPill ? 'rounded-full' : '',
'group inline-flex items-center gap-3 transition-colors duration-hover',
VARIANT_STYLES[variant],
className
)}
>
<span className={cn(innerClassName)}>{children}</span>
<ArrowRight className={ARROW_STYLES[variant]} />
{arrow ? <ArrowRight className={arrow} aria-hidden="true" /> : null}
</StaticLink>
);
}
+12
View File
@@ -72,6 +72,10 @@ module.exports = {
border: {
primary: 'rgb(var(--color-border-primary-rgb) / <alpha-value>)',
secondary: 'rgb(var(--color-border-secondary-rgb) / <alpha-value>)',
/** 信息线档:hover 边框、选中态、图形边界等「承担信息的线」用它(对卡底 3.75、对暗底 4.89,
* 过非文本 3:1)。装饰分隔线才可用 secondary(界灰 #C3BDB1,实测 1.78,不达 3:1)。
* 见 BRAND-MANUAL P4 三档拆分。 */
rule: 'rgb(var(--color-border-rule-rgb) / <alpha-value>)',
accent: 'rgb(var(--color-border-accent-rgb) / <alpha-value>)',
light: 'rgb(var(--color-border-light-rgb) / <alpha-value>)',
dark: 'rgb(var(--color-border-dark-rgb) / <alpha-value>)',
@@ -185,7 +189,12 @@ module.exports = {
xl: 'var(--radius-xl)',
'2xl': 'var(--radius-2xl)',
'3xl': 'var(--radius-3xl)',
/** 真圆专用:avatar / switch 钮 / slider 钮 / radio / progress / scroll-area 滚动条 / skeleton 点。
* 语法收口时**不得**把它一起归零 —— 那会方角化所有旋钮与头像。
* check:grammar 的 R2 就是这条的正向守卫(负对照维度:仪器坏了它仍要失败)。 */
full: 'var(--radius-full)',
/** 两轨 CTA 专用直角档(对标两家按钮实测均为 border-radius: 0)。 */
cta: 'var(--radius-cta)',
},
boxShadow: {
xs: 'var(--shadow-xs)',
@@ -200,6 +209,9 @@ module.exports = {
},
transitionDuration: {
instant: 'var(--transition-instant)',
/** hover 档:动效四原则 CONTEXT.md:76 定的 150ms,此前仓库无对应令牌
* (BRAND-MANUAL §6 冲突 C-1)。位移抬升与彩色光晕去掉后,hover 是唯一可交互提示,必须有档可用。 */
hover: 'var(--transition-hover)',
fast: 'var(--transition-fast)',
normal: 'var(--transition-normal)',
slow: 'var(--transition-slow)',