From 81daedbea11761bc8a53116e11ed8ec17db8bc80 Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Fri, 16 Oct 2026 20:02:11 +0800 Subject: [PATCH] =?UTF-8?q?feat(tokens):=20=E8=A7=86=E8=A7=89=E8=AF=AD?= =?UTF-8?q?=E6=B3=95=E6=94=B6=E5=8F=A3=E5=88=B0=E5=AF=B9=E6=A0=87=E5=AE=9E?= =?UTF-8?q?=E6=B5=8B=E2=80=94=E2=80=94=E5=9C=86=E8=A7=92=200=E2=80=934=20?= =?UTF-8?q?=E8=AE=B0=E6=A1=A3=E3=80=81=E5=BD=A9=E8=89=B2=E9=98=B4=E5=BD=B1?= =?UTF-8?q?=E9=80=80=E5=BD=B9=E3=80=81=E5=8D=A1=E7=89=87=E5=8E=BB=20lift?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 依据是实测而非口味。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 处 调用,其中 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 例通过 --- package.json | 2 + scripts/check-visual-grammar.mjs | 264 +++++++++++++++++++ src/app/globals.css | 96 ++++--- src/components/detail/micro-interactions.tsx | 3 +- src/components/sections/sections.test.tsx | 30 +-- src/components/ui/button.tsx | 13 +- src/components/ui/cta-button.tsx | 63 +++-- tailwind.config.js | 12 + 8 files changed, 387 insertions(+), 96 deletions(-) create mode 100644 scripts/check-visual-grammar.mjs diff --git a/package.json b/package.json index fa4d635..3296dc0 100644 --- a/package.json +++ b/package.json @@ -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 '/scripts/utils/__tests__'", "check:a11y": "npm run check:contrast && npm run check:headings && npm run check:brand-token", diff --git a/scripts/check-visual-grammar.mjs b/scripts/check-visual-grammar.mjs new file mode 100644 index 0000000..7451db9 --- /dev/null +++ b/scripts/check-visual-grammar.mjs @@ -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(); diff --git a/src/app/globals.css b/src/app/globals.css index 079ce06..ad8e7fd 100644 --- a/src/app/globals.css +++ b/src/app/globals.css @@ -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 式不对称布局系统 === */ diff --git a/src/components/detail/micro-interactions.tsx b/src/components/detail/micro-interactions.tsx index bf6ddc1..ba90e58 100644 --- a/src/components/detail/micro-interactions.tsx +++ b/src/components/detail/micro-interactions.tsx @@ -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: diff --git a/src/components/sections/sections.test.tsx b/src/components/sections/sections.test.tsx index 4c8757e..f8a1793 100644 --- a/src/components/sections/sections.test.tsx +++ b/src/components/sections/sections.test.tsx @@ -306,30 +306,6 @@ describe('CTASection', () => { }); }); -describe('HeroSectionV2', () => { - it('should render hero heading and content', async () => { - const { HeroSectionV2 } = await import('./hero-section-v2'); - render(); - 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(); - // 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(); - const links = screen.getAllByTestId('static-link'); - const contactLink = links.find(l => l.getAttribute('href') === '/contact'); - expect(contactLink).toBeInTheDocument(); - }); -}); \ No newline at end of file +// HeroSectionV2 的三个用例随组件本体一同删除(2026-10-16): +// 该组件全站零生产引用(仅被本测试文件 dynamic import),属 qa-tracker DEC-P-2 死码族。 +// 保留测试会让死码继续占用覆盖率分母,并在视觉上被误读为「有活在跑」。 \ No newline at end of file diff --git a/src/components/ui/button.tsx b/src/components/ui/button.tsx index 9f29587..91b9f12 100644 --- a/src/components/ui/button.tsx +++ b/src/components/ui/button.tsx @@ -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', }, }, diff --git a/src/components/ui/cta-button.tsx b/src/components/ui/cta-button.tsx index 255c286..e86244d 100644 --- a/src/components/ui/cta-button.tsx +++ b/src/components/ui/cta-button.tsx @@ -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 = { 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 = { - 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> = { + 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 ( {children} - + {arrow ? ); } diff --git a/tailwind.config.js b/tailwind.config.js index 9c16de1..299bca3 100644 --- a/tailwind.config.js +++ b/tailwind.config.js @@ -72,6 +72,10 @@ module.exports = { border: { primary: 'rgb(var(--color-border-primary-rgb) / )', secondary: 'rgb(var(--color-border-secondary-rgb) / )', + /** 信息线档:hover 边框、选中态、图形边界等「承担信息的线」用它(对卡底 3.75、对暗底 4.89, + * 过非文本 3:1)。装饰分隔线才可用 secondary(界灰 #C3BDB1,实测 1.78,不达 3:1)。 + * 见 BRAND-MANUAL P4 三档拆分。 */ + rule: 'rgb(var(--color-border-rule-rgb) / )', accent: 'rgb(var(--color-border-accent-rgb) / )', light: 'rgb(var(--color-border-light-rgb) / )', dark: 'rgb(var(--color-border-dark-rgb) / )', @@ -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)',