白纸终端 — Vercel 语言在 WanChat 的落地
方案名与主张
方案名:白纸终端(参考 Vercel · "Typeset terminal on white paper")
一句话主张: 用「纸白画布 + 发丝描边 + 单色值阶」取代飞书式「蓝灰画布 + 四步投影 + 三套蓝」,让消息流与任务流只靠黑白对比与排版层级阅读,全站彩色收敛为 1 个代表「成功」的绿。
适用基调:浅色优先,深色对等。 浅色是主场景(#fafafa 纸白画布);深色不是把浅色翻过来,而是同一套明度阶梯的反相(#0a0a0a 画布 / #171717 卡片 / #ededed 亮面标点)。两套令牌都完整给值、两套都过正文 4.5:1。
参考提炼
- 参考风格名:Vercel;slug:
vercel;来源站点 vercel.com;theme:light - 参考文件:
/Users/waw/Documents/code/wanman/localtmp/gradientdeck/vercel.design.md、vercel.design-extended.md
可迁移的 5 条规则(引其原文要点):
- 「0% colorfulness is the rule」 — 除 Terminal Green
#297a3a成功指示外不引入任何彩色;正文只用#171717 / #4d4d4d / #666666三级值阶。→ 直接迁移为我们的--foreground / --interactive / --muted-foreground。 - 「Build depth with hairline borders via stacked box-shadows(
0 0 0 1px rgba(0,0,0,.08), 0 0 0 2px #fafafa)— never with drop-shadow」 — 深度靠描边环,不靠投影。→ 迁移为--shadow-e1..e3 / --shadow-pop重定义(见令牌映射)。 - 「Apply 6px radius to all cards, buttons, and bordered containers — use 9999px only for pill-shaped nav actions」 — 矩形一律 6px,锐利是重点。→ 迁移为
--radius: 0.375rem。 - 「Surfaces stack as
#fafafa→#ebebeb→#171717,creating depth through tonal value shifts」 — 三层表面明度阶梯,#171717是反相表面(Inverted Card),用在留白网格里做视觉标点。→ 迁移为画布#fafafa/ 侧栏#f4f4f4/ 发丝#ebebeb/ 反相气泡#171717。 - 「Labels and metadata are ALWAYS monospace, ALWAYS uppercase, ALWAYS small」+「Type Scale … heading 30px weight 400-450,-0.06em tracking」 — 二元排版纪律:Sans 负责阅读、Mono 负责盖章;标题走 400–450 字重而非 700。→ 中文字体栈有回退约束,"mono 盖章"只作用于原本已用
--font-mono的数字/ID/时间位;标题字重 400–450 见 §字体与排版。
必须舍弃的(营销页专属): Spectrum Gradient / Solar Edge 装饰渐变(linear-gradient(90deg, rgb(0,255,149) …)、rgb(255,220,48)→rgb(56,162,255));▲ 三角品牌位;56/64px display 与 -0.06em 紧字距的 hero;96–128px 章节间距;1280px 居中容器;64px 吸顶导航 + backdrop-blur;CLI 输出面板与 logo strip。
适配判断
为什么这套语言适合「消息 + 任务」双核心的高密度企业工具:
- WanChat 的核心阅读对象是长文中文消息 + 状态密集的任务卡,不是图片与图表。单色系统把"颜色预算"全部让给信息:任务状态、@提及、危险操作是页面上仅有的三处色相,扫描成本下降(现状实测:S3 群聊大厅里品牌蓝
rgb(37,99,235)出现 20 处、text-rose-600 ×31、text-amber-700 ×19,颜色已经失去指示力)。 - 现状的层级手段是
14px圆角 + 四步投影 + 蓝灰底(实测--surface-rail: #e1e8f2、--workspace-background: linear-gradient(180deg, var(--surface-rail), #e1e5f1))。在 1440×900 里,三块表面(画布 #fcfcfc / 侧栏 #fcfcfc / 卡片 #ffffff)几乎同色,深度全靠投影;而投影在长时段驻留的高密度界面上是噪声。换成发丝描边后,同一屏的信息量可以不变、噪声明显下降。 - 中文正文 15px/1.375 的真实问题是行内信息层级(作者 13px、时间 12px、预览 11.25px)。单色值阶把层级压到 3 档(#171717 / #666666 / #8f8f8f),比现在的
#060607 / #5c5e66 / #80848e / #98a2b3 / #667085五档更容易记忆与复用。 - 锐利圆角(6px)在高密度列表里有实际收益:现状实测任务卡同时存在 10px×48 与 8px×37 两套圆角、全站圆角档位多达 12 级(2/6/7/8/10/12/14/18/24/26/32/9999)。6px 统一后,圆角不再承担"层级"语义。
明确舍弃项(因产品形态不同):
| 舍弃 | 原因 |
|---|---|
| 全站 0 彩色 | 任务状态与危险操作必须有色相;保留 Terminal Green(成功/已完成)+ --destructive 红(风险/过期),共 2 个色相 |
| 96–128px 章节间距、大留白 | 企业工具是长时段驻留的高密度界面,留白预算给列表行高与信息密度 |
| 14–16px 正文 / 1.43–1.5 行高 | 中文正文保持 15px / 1.375(20.63px,≥ 简报要求的 1.375);行高再加会掉一屏消息条数 |
| uppercase 小标签 | 中文无大小写;"盖章"改为等宽数字 + 字距,落在既有 --font-mono 使用位上 |
令牌映射
途径列:①=语义令牌取值(web/src/styles.css);②=官方 variant/size;③=容器布局/间距/滚动。本表全部为 ①。当前值取自 web/src/styles.css:108-161(:root)与 :163-211(.dark)。
浅色 :root(web/src/styles.css:108)
| 变量名 | 当前值 | 建议值 | 途径 | 意图 |
|---|---|---|---|---|
--background |
#fcfcfc |
#fafafa |
① | 取 Vercel Paper White;把画布与卡片 #ffffff 的差固定为 1 档明度,作为整个阶梯基准 |
--foreground |
#060607 |
#171717 |
① | 近纯黑改 Obsidian(对 #fafafa 17.18:1),避开纯黑在纸白上的边缘生硬 |
--card |
#ffffff |
#ffffff |
① | 不变:白卡片是画布之上唯一抬升层 |
--card-foreground |
#060607 |
#171717 |
① | 跟随正文 |
--popover |
#ffffff |
#ffffff |
① | 不变 |
--popover-foreground |
#060607 |
#171717 |
① | 跟随正文 |
--primary |
var(--brand) |
var(--brand) |
① | 间接层保持;取值由蓝变黑(见 --brand) |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
① | 间接层保持(白字 17.93:1) |
--secondary |
#ebedef |
#f2f2f2 |
① | 去蓝偏,次级表面改中性灰 |
--secondary-foreground |
#060607 |
#171717 |
① | 跟随正文 |
--muted |
#f2f3f5 |
#f0f0f0 |
① | 弱化表面降一档,与侧栏 #f4f4f4 拉开微差 |
--muted-foreground |
#5c5e66 |
#666666 |
① | 次级文字取 Vercel Stone(5.50:1),灰阶从 5 档收敛到 3 档 |
--accent |
#ebedef |
#ebebeb |
① | 他人气泡=accent,取 Vercel Hairline 灰(16.01:1) |
--accent-foreground |
#060607 |
#171717 |
① | 跟随正文 |
--destructive |
#da373c |
#d92d20 |
① | 白底 4.83:1(原值 4.57:1 贴线);兼"风险/过期"状态色 |
--border |
#dcdee1 |
#ebebeb |
① | 结构分隔改发丝线(1.14:1)——刻意"高速态不可见",见风险 R1 |
--input |
#dcdee1 |
#8f8f8f |
① | 与 --border 分离:控件周界必须 3:1(实测 3.23:1,满足 WCAG 1.4.11) |
--ring |
var(--brand) |
var(--brand) |
① | 间接层保持;焦点环=Obsidian |
--brand |
#2563eb |
#171717 |
① | 方案核心:主按钮由品牌蓝变 Vercel Filled Black Button;primary/ring/sidebar-primary 随之变黑 |
--brand-foreground |
#ffffff |
#ffffff |
① | 不变(黑底白字) |
--brand-soft |
rgb(37 99 235 / 0.12) |
rgb(23 23 23 / 0.08) |
① | 弹窗侧栏选中底:蓝 12%→黑 8%,选中变单色 |
--brand-ink |
#1d4ed8 |
#171717 |
① | 选中项前景去净蓝,与 --brand 同值 |
--message-self |
#e8f3fe |
#171717 |
① | 自己气泡改反相表面(Vercel Inverted Card),成为整列唯一重色标点(17.18:1) |
--message-self-foreground |
#0d274a |
#fafafa |
① | 反相气泡上的字取画布色 |
--surface-chat-soft |
#e8f2ff |
#f4f4f4 |
① | 引用/回复气泡去蓝,回中性灰族 |
--surface-chat-selected |
#e5ecfc |
#e4e4e4 |
① | 会话选中底改明度下沉一档的灰(缺口见 R3) |
--mention |
#3370ff |
#297a3a |
① | @提及改 Terminal Green(5.11:1),成为高密度视图唯一彩色锚点 |
--ink |
#060607 |
#171717 |
① | 通用深前景统一 Obsidian |
--surface-rail |
#e1e8f2 |
#ebebeb |
① | 空间 rail 去蓝(实测 rail 右边框 rgba(220,222,225,0.55) 随之靠拢 --border) |
--sidebar |
#fcfcfc |
#f4f4f4 |
① | 关键修复:侧栏与画布原同为 #fcfcfc(实测 256×715 @x=76 零层级对比),下沉一档 |
--sidebar-foreground |
#060607 |
#171717 |
① | 跟随正文 |
--sidebar-accent |
#ebedef |
#eaeaea |
① | 悬停底去蓝,与选中 #e4e4e4 拉开微差 |
--sidebar-accent-foreground |
#060607 |
#171717 |
① | 跟随正文 |
--sidebar-border |
#dcdee1 |
#e4e4e4 |
① | 侧栏分隔改发丝灰,比页面 --border 稍清晰 |
--chart-1 |
oklch(0.87 0 0) |
#ebebeb |
① | 状态色阶起点:最浅发丝灰 |
--chart-2 |
oklch(0.556 0 0) |
#a8a8a8 |
① | 中性档(已关闭/无效) |
--chart-3 |
oklch(0.439 0 0) |
#666666 |
① | 待处理档(5.50:1,可承载文字) |
--chart-4 |
oklch(0.371 0 0) |
#297a3a |
① | 唯一彩色:已完成/成功 |
--chart-5 |
oklch(0.269 0 0) |
#171717 |
① | 进行中档:最需注意的中性档 |
--radius |
0.625rem |
0.375rem |
① | 10px→6px;派生 --radius-sm..4xl 比例不变 |
--workspace-background |
linear-gradient(180deg, var(--surface-rail), #e1e5f1) |
linear-gradient(180deg, #fafafa, #f4f4f4) |
① | 画布渐变由蓝灰改纯明度 |
--interactive |
#4e5058 |
#4d4d4d |
① | 交互图标对齐 Vercel Charcoal,去蓝偏 |
--channel-icon |
#80848e |
#6e6e6e |
① | 频道图标加深:侧栏底上 4.64:1,图形对比达标 |
深色 .dark(web/src/styles.css:163)
| 变量名 | 当前值 | 建议值 | 途径 | 意图 |
|---|---|---|---|---|
--background |
oklch(0.145 0 0) |
#0a0a0a |
① | Vercel 暗色画布;原值偏灰 |
--foreground |
oklch(0.985 0 0) |
#ededed |
① | 用 #ededed 而非纯白,避免深底发光(16.91:1) |
--card |
oklch(0.205 0 0) |
#171717 |
① | 卡片抬升一档,靠描边识别而非明度(1.10:1) |
--card-foreground |
oklch(0.985 0 0) |
#ededed |
① | 跟随正文 |
--popover |
oklch(0.205 0 0) |
#171717 |
① | 与卡片同值 |
--popover-foreground |
oklch(0.985 0 0) |
#ededed |
① | 跟随正文 |
--primary |
继承 var(--brand) |
var(--brand)(显式声明) |
① | 原文 .dark 未声明;显式化后取反相亮面 |
--primary-foreground |
继承 var(--brand-foreground) |
var(--brand-foreground)(显式声明) |
① | 原文 .dark 未声明;显式化使深色两套自洽 |
--secondary |
oklch(0.269 0 0) |
#1f1f1f |
① | 次级表面收暗,给卡片留层次 |
--secondary-foreground |
oklch(0.985 0 0) |
#ededed |
① | 跟随正文 |
--muted |
oklch(0.269 0 0) |
#1f1f1f |
① | 与 --accent #262626 区分 |
--muted-foreground |
oklch(0.708 0 0) |
#a1a1a1 |
① | 画布 7.66:1 / 卡片 6.94:1 |
--accent |
oklch(0.269 0 0) |
#262626 |
① | 他人气泡比 --muted 亮一档 |
--accent-foreground |
oklch(0.985 0 0) |
#ededed |
① | 跟随正文 |
--destructive |
oklch(0.704 0.191 22.216) |
#ff6369 |
① | 卡片上 6.18:1;与浅色 #d92d20 同红相不同亮度 |
--border |
oklch(1 0 0 / 10%) |
rgb(255 255 255 / 0.14) |
① | 深底略提 alpha,维持发丝感(1.38:1,见 R1) |
--input |
oklch(1 0 0 / 15%) |
rgb(255 255 255 / 0.45) |
① | 合成 #707070,卡片上 3.62:1,满足 1.4.11 |
--ring |
继承 var(--brand) |
var(--brand) |
① | 焦点环取亮面 |
--brand |
oklch(0.68 0.15 256) |
#ededed |
① | 深色主按钮=亮面填充(Vercel 暗色反相按钮),16.91:1 |
--brand-foreground |
oklch(0.16 0.02 258) |
#0a0a0a |
① | 亮底深字 |
--brand-soft |
oklch(0.28 0.05 256) |
rgb(237 237 237 / 0.10) |
① | 选中底改亮面 10%,与浅色同构 |
--brand-ink |
oklch(0.84 0.09 256) |
#ededed |
① | 选中项前景=亮面 |
--message-self |
#203b59 |
#ededed |
① | 反相规则在深色下反向:自己气泡是亮面,保持"唯一强对比标点"语义 |
--message-self-foreground |
#e7f3ff |
#0a0a0a |
① | 亮气泡上的深字(16.91:1) |
--surface-chat-soft |
oklch(0.32 0.06 250) |
#1f1f1f |
① | 引用气泡去蓝 |
--surface-chat-selected |
oklch(0.28 0.04 250) |
#262626 |
① | 选中底比侧栏亮一档(1.31:1,见 R3) |
--mention |
oklch(0.72 0.14 254) |
#46a758 |
① | 深底 Terminal Green 提亮版,画布 6.53:1 |
--ink |
oklch(0.16 0.02 258) |
#ededed |
① | 通用深前景反相 |
--surface-rail |
#e3e5e8 |
#171717 |
① | 关键修复:原深色下仍是浅色(深底上的浅色竖带) |
--sidebar |
oklch(0.205 0 0) |
#0a0a0a |
① | 与画布同值,改用发丝边框分隔 |
--sidebar-foreground |
oklch(0.985 0 0) |
#ededed |
① | 跟随正文 |
--sidebar-accent |
oklch(0.269 0 0) |
#1f1f1f |
① | 悬停底比侧栏亮一档 |
--sidebar-accent-foreground |
oklch(0.985 0 0) |
#ededed |
① | 跟随正文 |
--sidebar-border |
oklch(1 0 0 / 10%) |
rgb(255 255 255 / 0.14) |
① | 与 --border 同值 |
--chart-1 |
oklch(0.87 0 0) |
#2e2e2e |
① | 色阶起点:比卡片略亮 |
--chart-2 |
oklch(0.556 0 0) |
#6e6e6e |
① | 中性档 |
--chart-3 |
oklch(0.439 0 0) |
#a1a1a1 |
① | 次级档 |
--chart-4 |
oklch(0.371 0 0) |
#46a758 |
① | 唯一彩色:已完成/成功 |
--chart-5 |
oklch(0.269 0 0) |
#ededed |
① | 最亮档:进行中 |
--radius |
.dark 未声明,继承 :root |
0.375rem(显式声明,与浅色同值) |
① | 原文只在 :root;显式化便于深色两套对照 |
--workspace-background |
radial-gradient(ellipse at 8% 0%, color-mix(in oklab, var(--brand) 10%, var(--muted)), var(--muted) 64%) |
linear-gradient(180deg, #0a0a0a, #121212) |
① | 去掉品牌蓝径向光斑 |
--workspace-rail-background |
color-mix(in oklab, var(--background) 45%, transparent) |
rgb(255 255 255 / 0.03) |
① | rail 用极淡亮面,语义直白 |
--workspace-header-background |
linear-gradient(180deg, color-mix(in oklab, var(--background), var(--brand) 3%), var(--background)) |
var(--background) |
① | 去掉品牌蓝 3% 混色 |
--interactive |
.dark 未声明(继承浅色 #4e5058) |
#a1a1a1 |
① | 补齐缺失声明,否则深底不可辨 |
--channel-icon |
.dark 未声明(继承浅色 #80848e) |
#8f8f8f |
① | 补齐缺失声明;画布 6.12:1 |
@theme inline(web/src/styles.css:31)内的阴影阶梯
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--shadow-e1 |
0 1px 0 rgb(4 4 5 / 0.08), 0 1.5px 0 rgb(4 4 5 / 0.02) |
0 0 0 1px var(--border) |
Vercel「深度用描边环,不用投影」;引用 --border 后深浅两套自动成立 |
--shadow-e2 |
0 2px 4px -1px rgb(15 23 42 / 0.07), 0 6px 16px -4px rgb(15 23 42 / 0.1) |
0 0 0 1px var(--border), 0 1px 1px rgb(0 0 0 / 0.03) |
同上;保留极轻 1px 位移给弹层 |
--shadow-e3 |
0 10px 28px -8px rgb(15 23 42 / 0.16), 0 2px 6px -2px rgb(15 23 42 / 0.06) |
0 0 0 1px var(--border), 0 1px 3px rgb(0 0 0 / 0.05) |
同上 |
--shadow-pop |
0 16px 40px -12px rgb(15 23 42 / 0.24), 0 4px 10px -4px rgb(15 23 42 / 0.1) |
0 0 0 1px var(--border), 0 4px 12px rgb(0 0 0 / 0.08) |
弹窗"高度"改由描边 + 极轻位移表达,去掉蓝味阴影 |
字体与排版
字体栈(web/src/styles.css:33 --font-sans,不改动)
"Geist Variable", "gg sans", "Noto Sans SC", "PingFang SC", ui-sans-serif,
system-ui, "Segoe UI", "Microsoft YaHei", Roboto, Helvetica, Arial, sans-serif
@fontsource-variable/geist@^5.3.0(web/package.json:32)已在styles.css:4导入,Geist 是本仓库真实可用的西文字形——参考文件的--font-geist-sans可以零成本落地。- Geist Variable 不含中文字形,中文实际落到
Noto Sans SC/PingFang SC;因此西文回退顺序必须保持原样:任何"把 Geist 换成 Inter"的写法都会让gg sans/中文回退失效。方案不动这一行。 --font-mono(styles.css:37)保持系统等宽栈:仓库没有 Geist Mono 依赖,引入新字体包超出"不改 web/"的约束。参考里 mono 的"盖章"职能改由字号 + 字距 + 既有--font-mono使用位承担(时间戳、消息 ID、成员数、任务编号)。- 预览文件
preview.html无法外链字体,用-apple-system / "PingFang SC"本地近似栈渲染,仅作令牌取值对照。
字号阶梯(目标值;实施途径见末列)
| 角色 | 字号 | 行高 | 字重 | 颜色 | 实现途径 |
|---|---|---|---|---|---|
| 正文(消息/任务描述) | 15px | 1.375(20.63px,现状已达标) | 400 | --foreground #171717 |
—(styles.css:255 @layer base 已是 15px/1.375,不改) |
| 次级(作者、频道名、表单标签) | 13px | 1.5(19.5px) | 400 | --foreground 或 --muted-foreground |
②/③(组件类控制,见风险 R4) |
| 标签/元信息(时间、成员数、状态徽标) | 12px | 1.5(18px) | 500 | --muted-foreground #666666 |
② |
| 微标签(页脚、角标) | 11px | 1.5 | 500 | --muted-foreground |
②——不再低于 11px:现状实测存在 9px / 9.375px 档位(S3-task-hall.json 中 9.375px/400 ×14、S7-login.json ×15),低于简报"中文最小 12px"的下限,属需收敛项 |
| 代码/数字 | 12px | 1.4 | 400 | --foreground |
—(--font-mono + tabular-nums) |
| 页面标题 | 16px | 1.25(20px) | 600 | --foreground |
②——现状频道头已是 16px/600,保持不变 |
| 登录主标题 | 26px | 1.2 | 400–450 | --foreground |
②——现状 26px;按 Vercel 纪律把 600 降到 450 |
刻度收敛: 现状单视图出现过 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26px 十档(小数字号源自以 15px 为基准的 em 计算)。目标压到 11 / 12 / 13 / 15 / 16 / 26px 六档,去掉 12.8 与 13.125 两个由 em 计算产生的小数档。
中文长文本与数字的注意点
- 中文不能用负字距:Vercel 的
-0.06em只作用于 56–64px 西文 display;本方案最大字号 26px,字距保持 normal,否则中文会挤压。 - 行高底线:
1.375是中文可读下限(简报硬约束)。任何为了"更松"而把消息行高提到 1.5 的做法会减少每屏约 1.5 行消息,不采纳。 - 数字对齐:成员数、任务数、时间、消息阅读人数走
--font-mono;否则中文比例字宽下12 人已读 / 4 人未读(S2实测串)会左右跳动。 - 中英混排基线:Geist(西文)+ Noto Sans SC(中文)共用同一 baseline 时,Geist 的小写字高偏大;不通过 font-size 调整,交由既有的
text-rendering: optimizeLegibility(styles.css:258)处理,避免制造新的小数档位。
关键界面改造
覆盖 7 个样例面:S1、S2、S3、S7(必含)+ S4、S5、S8(附加)。
S1 应用外壳 + 空间/频道侧栏(web/src/components/app/app-shell.tsx、channel-sidebar.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 会话侧栏 aside 256×715 @x=76,border-radius 14px,background #fcfcfc = 页面底色 --background,零层级对比 |
侧栏底 #f4f4f4(下沉一档),画布 #fafafa,卡片 #ffffff;侧栏与画布差 1.05:1 + 侧栏右侧发丝边 --sidebar-border #e4e4e4。三面靠明度阶梯分层 |
① |
| 2 | 空间 rail 背景 transparent,右边框 rgba(220,222,225,0.55)(与 --border #dcdee1 不同源),图标按钮 71×48 |
rail 背景由 --workspace-rail-background: transparent 改为在深色下 rgb(255 255 255 / 0.03);浅色下继续透明但 --surface-rail #ebebeb 去蓝(原 #e1e8f2)。图标按钮尺寸 71×48 改由 ③ 收敛为 48×48 方形 + 12px 间距,与 Button size="icon-lg"(36px)在同一视觉网格上 |
①+③ |
| 3 | 侧栏 border-radius 14px、搜索框圆角 10px、会话行 240×64 |
圆角随 --radius: 0.375rem 落到 6px(rounded-lg);搜索框由 30px 高改 Input 的 h-8(32px,②) |
①+② |
| 4 | 侧栏头部 52px,搜索框背景 rgba(235,238,239,0.75) |
头部沿用 52px(③,密度不降);搜索框底色随 --muted #f0f0f0,周界由 --input #8f8f8f 保证 3.23:1 可见 |
① |
| 5 | 未读点、时间、预览 11.25px | 预览 11.25px → 12px(②,落在刻度上);未读用 Badge variant="default"(黑底白字)或 6px 实心圆点 |
② |
| 6 | 会话选中底 #e5ecfc + 浅蓝 |
选中底 #e4e4e4 + 文字 --foreground #171717(14.10:1);未选中文字 --muted-foreground #666666(5.22:1)——选中态同时改变文字对比度与背景明度,不依赖单一色相(见 R3) |
① |
| 7 | 频道图标色 #80848e |
--channel-icon #6e6e6e,侧栏底上 4.64:1;图标本身仍用 lucide(components.json iconLibrary: lucide) |
① |
| 8 | 层级:靠 --shadow-e1..e3 四步投影 |
弹层阴影改描边环(--shadow-e2 起于 0 0 0 1px var(--border));侧栏平板不再用投影 |
① |
组件与 variant: Button size="icon-sm"|"icon-lg" variant="ghost"(rail 与头部图标);Input(搜索);Badge variant="secondary"(未读计数);ScrollArea(频道树,ui/scroll-area.tsx);Separator(侧栏分组)。
S2 频道消息流(message-list.tsx、channel-thread.tsx、channel-header.tsx、channel-tabs.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 他人气泡 rgb(235,237,239)(=--accent #ebedef);自己气泡 rgb(232,243,254)(=--message-self #e8f3fe)+ 字 rgb(13,39,74)。两种蓝 |
他人气泡 = --accent #ebebeb + 字 #171717(16.01:1);自己气泡 = 反相表面 --message-self #171717 + 字 #fafafa(17.18:1)。消息流里只出现"浅灰 / 黑"两种气泡 |
① |
| 2 | 气泡圆角 14px | 6px(随 --radius),与卡片/输入框同一圆角语言 |
① |
| 3 | 消息正文同一列表两套字号:他人 15px/400、自己 14px/400 | 统一 15px/400(②):正文尺寸由组件类决定,不在令牌可控范围,必须改组件属性——本方案列出,但标注为需改 web/ 的项(R4) |
② |
| 4 | 作者 13px/400;时间 12px/500 #5c5e66 |
作者 13px --foreground;时间 12px --muted-foreground #666666 + --font-mono(数字不跳动) |
② |
| 5 | @提及蓝 --mention #3370ff(chat-mention.ts 里还硬编码 #3370FF) |
--mention #297a3a(对 #fafafa 5.11:1 / 对 --accent #ebebeb 4.76:1)。硬编码的 #3370FF 属令牌泄漏,需在 chat-mention.ts 改引用 --mention(R2) |
①(+组件引用修正) |
| 6 | 输入区 textarea 628×33 无边框,外层只有上边框 rgb(220,222,225);工具按钮 28×28 |
外层上边框随 --border #ebebeb;工具按钮改 Button size="icon-sm"(28px,② 官方尺寸);输入框本体加 --input 周界使可点击区域可见(①) |
①+② |
| 7 | 频道头 860×52:标题 16px/600 #060607;成员数 12px/500 #5c5e66 |
标题 16px 保持,色 --foreground #171717;成员数走 --font-mono + --muted-foreground #666666 |
①+② |
| 8 | 悬停动作:点赞 / 回复 / 更多 / 预览图片 / 阅读状态(0 人已读,4 人未读) |
动作按钮统一 Button variant="ghost" size="icon-xs"(24px,与现状 28px 视觉重量一致);阅读状态用 --font-mono 数字 |
② |
| 9 | 消息行间距与滚动锚点 | 用 MessageScroller(ui/message-scroller.tsx)的既有容器;行间距保持现状(③ 只做容器级调整,不加内边距) |
③ |
组件与 variant: Bubble/Message(ui/bubble.tsx、ui/message.tsx);Button variant="ghost" size="icon-xs";Avatar size="sm"(头像首字底色受 --muted 影响,见 R5);Separator(日期分隔);Tabs variant="line"(channel-tabs.tsx 的频道内分栏,官方 line 变体不带底色块)。
S3 任务大厅与任务卡(task-hall.tsx、group-hall.tsx、create-task-dialog.tsx、channel-work-items.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 任务卡圆角两套混用:10px×48 + 8px×37 | 统一 --radius=6px(Card 的 rounded-lg),圆角不再承担层级语义 |
① |
| 2 | 卡片标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人 |
卡片标题 14px/500 --foreground;两个 chip 改 Badge variant="outline"(发丝边 + --foreground)与 Badge variant="secondary"(灰底);查看任务 用 Button variant="ghost" size="sm" |
② |
| 3 | 列头「待补充 0 / 待处理 5」,任务看板标题 16px;筛选「全部频道 / 5 项任务」 | 列头计数走 --font-mono;状态列头色按状态映射(见下表);筛选区 Button variant="outline" size="sm" + Separator |
②+③ |
| 4 | 群聊大厅用营销式 hero 段落 + 「全部群聊 / 全部 / 已加入 / 未加入」筛选 + 群卡片;品牌蓝 rgb(37,99,235) 出现 20 处 |
删掉 hero 段落(③ 容器调整:直接进筛选 + 列表);筛选改 Tabs variant="line"(②,官方 line 变体,无底色块);品牌蓝归零(① --brand #171717) |
③+②+① |
| 5 | 群卡片 emoji 图标、运行中/开发中 徽标 |
徽标改 Badge:运行中→variant="secondary"(灰底中性);开发中→variant="outline" |
② |
| 6 | 任务卡间距 | 卡片网格 grid-cols-2/3 + 12px gap(③),与参考的 element gap 12px 一致 |
③ |
状态色映射(全站统一,来自 --chart-*):
| 业务状态(简报 §3.3 真实语料) | 令牌 | 浅色 | 深色 | 载体 |
|---|---|---|---|---|
| 待补充 / 已关闭 / 无效 | --chart-2 / --muted-foreground |
#a8a8a8 |
#6e6e6e |
Badge variant="secondary" |
| 待处理 | --chart-3 |
#666666 |
#a1a1a1 |
Badge variant="outline" |
| 进行中 | --chart-5 |
#171717 |
#ededed |
Badge variant="default"(实心,最强) |
| 待验收 | --muted-foreground + 发丝边 |
#666666 |
#a1a1a1 |
Badge variant="outline" |
| 已完成 / 成功 | --chart-4 |
#297a3a |
#46a758 |
Badge variant="outline" + 绿字(5.33:1 / 5.92:1) |
| 风险 / 过期 | --destructive |
#d92d20 |
#ff6369 |
Badge variant="destructive"(官方为 bg-destructive/10 text-destructive) |
组件与 variant: Card/CardHeader/CardContent、Badge(default/secondary/outline/destructive)、Button(variant="default"/"outline"/"ghost",size="sm")、Dialog+Field(create-task-dialog.tsx 表单)、Tabs variant="line"、ScrollArea。
S7 登录页(web/src/routes/login.tsx、sign-in.$.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 居中卡片,主标题 26px;页脚 11px | 主标题 26px 保持字号,字重降到 450(②,Vercel「headlines at weight 400-450, never 700」);页脚 11px 保持并走 --muted-foreground |
② |
| 2 | 「邮箱验证码 / 短信验证码」切换块 173×42,选中态背景 --background #fcfcfc + 品牌蓝文字 |
切换改 Tabs variant="default" 的官方实现:选中底 --card #ffffff + 文字 --foreground #171717,容器 --muted #f0f0f0——选中态由明度反转表达而非蓝色 |
①+② |
| 3 | 主按钮 356×52、白字、#2563eb |
Button variant="default" 落到 --brand #171717 黑底白字(17.93:1);尺寸走 size="lg"(h-9)——参考的 Filled Black Button 是同一语义 |
①+② |
| 4 | 卡片圆角 18px / 32px 并存 | 随 --radius 收敛到 6px(卡片)与 rounded-2xl(10.8px,外层容器);不再出现 32px |
① |
| 5 | 文案「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」 | 文案不动;输入框与按钮之间用 Field(ui/field.tsx)的既有间距,③ 只调整卡片内垂直节奏为 16px |
③ |
组件与 variant: Card、Button size="lg" variant="default"、Input、Tabs、Field+FieldLabel、Separator。
S4 AI 助手频道(agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx、channel-summary-panel.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | AI 助手空间(395 项任务)是全站最密集视图:一次渲染内 12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724;圆角 8px ×1591、10px ×844 |
去掉 12.8px 档(②,落到 12px);圆角全部由 --radius 决定 = 6px,两套圆角(8/10)归一 |
①+② |
| 2 | 流式回答 + 来源引用 | 来源引用改 Badge variant="outline" + --font-mono 编号(如 [1]);引用正文 --muted-foreground,正文 --foreground——层级只靠 2 档灰 |
② |
| 3 | 结果卡片 | Card + CardContent;结果里 AI 等待态保留既有 --animate-breathe 三点(动效令牌不动) |
② |
| 4 | 与消息流混排 | 与 S2 同栈:AI 气泡=他人气泡(--accent #ebebeb),用户气泡=自己气泡(--message-self #171717 反相) |
① |
| 5 | 密集列表间距 | ③:列表行间距由现状压到 8px,容器 overflow-y: auto 且 min-h-0(现状 2765 个文字节点说明容器未做虚拟化约束,方案只声明布局侧要求,不改数据层) |
③ |
组件与 variant: Message/Bubble、Card、Badge variant="outline"、Button variant="ghost" size="sm"、ScrollArea、Skeleton(流式等待)、Collapsible(来源展开)。
S5 管理与设置弹窗(space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx、channel-permission-picker.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | [role=dialog] 704×512,圆角 18px,背景 #ffffff |
圆角随 --radius → 6px(rounded-lg);背景 --popover #ffffff 不变;--shadow-pop 改描边环后弹窗与页面边界立刻清晰 |
① |
| 2 | 左侧导航项 135×36 圆角 8px;选中态背景 --brand-soft(rgb(37 99 235 / 0.12))+ 前景 --brand-ink #1d4ed8;危险项前景 --destructive #da373c |
--brand-soft → rgb(23 23 23 / 0.08),--brand-ink → #171717:选中项变成"浅灰底黑字",不再与危险项的红形成两个色相争夺;危险项 #d92d20(4.83:1) |
① |
| 3 | 输入框 488×32 圆角 10px;表单标签 14px | 输入框圆角随 --radius → 6px,周界 --input #8f8f8f(3.23:1);标签 14px → 13px(②) |
①+② |
| 4 | 表单/成员列表/权限三种内容形态 | 容器用 Dialog 既有左右分栏(③);成员列表用 Avatar size="sm" + Item(ui/item.tsx)+ Separator;权限用 Checkbox(ui/checkbox.tsx)+ Badge variant="outline" 表示角色(群主 / 管理员 / 研发 / 产品 / pmo) |
③+② |
| 5 | 圆角档位实测 80×9999px、52×10px、32×26px、23×8px | 6px 统一后,剩下的 9999px 只允许出现在 Badge(rounded-4xl)与 Avatar(rounded-full)——这两处是官方组件自带的胶囊语义 |
① |
组件与 variant: Dialog/DialogContent、Tabs variant="line"(弹窗左侧导航可用垂直 Tabs 官方实现)、Input、Checkbox、Select、Avatar size="sm"、Badge variant="outline"|"secondary"、Item、Separator。
S8 应用中心(app-center.tsx、assistant-board.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」 | 筛选条改 Tabs variant="line"(无底色块,只用下划线指示,适配 8 个中文分类不换行);计数走 --font-mono |
② |
| 2 | 卡片:运行中 / 开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息 |
徽标→Badge variant="secondary"(运行中)/ variant="outline"(开发中);元信息 --muted-foreground + --font-mono(分隔符 · 前不加空格) |
② |
| 3 | emoji 图标是视觉一致性的明显缺口 | emoji 无法通过令牌修正(它绕过 --font-sans 的调色)→ ③ 层面把图标位从"文字 emoji"改为 48×48 的 rounded-lg 中性灰底(--muted #f0f0f0)方块,内部仍由现有内容渲染;图标的彻底替换(lucide)超出令牌范围,列入 R6 |
③ |
| 4 | 卡片圆角实测 10px×52、26px×23 | 随 --radius 收敛到 6px,Card 的官方 rounded-lg 一类 |
① |
| 5 | 卡片 14px/400 ×265、15px/400 ×215 混用 | 卡片描述 14px 保持(②);卡片标题 14px/500 --foreground |
② |
组件与 variant: Card/CardHeader/CardTitle/CardDescription/CardContent、Badge、Button variant="ghost" size="sm"、Tabs variant="line"、Separator、ScrollArea、Item。
S6 语音频道 — 本栈不可见,依据是代码与库数据,不是截图
TRTC_ENABLED=false,实测 DOM 内 aria-label 匹配「语音|通话|加入」命中 0、正文不含「语音」、/api/v1/rtc/* 返回 RTC_DISABLED(S6-space-opc.json 为通用空态「这里还没有消息 / 在下方输入框发送第一条消息,把话题开起来。」)。数据库侧存在真实数据:wanman3_rtc_voice_channels 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行。
因此本方案对 S6 只做令牌级前瞻设计,不做视觉验收声明:web/src/components/app/rtc-group-call-ui.tsx 的成员状态文本(已连接 / 连接中 / 重连中 / 已断开 / 连接失败)在本方案的状态色映射下取 --chart-4(已连接)/ --chart-3(连接中)/ --destructive(已断开、连接失败)——但这些取值在当前部署下不可实测,属未验证推断,同样列入风险。
深浅色与对比度
比值按 WCAG 相对亮度公式自算(#RRGGBB → 线性化 → 0.2126R+0.7152G+0.0722B)。
浅色
| 组合 | 前景 | 背景 | 比值 | 达标 |
|---|---|---|---|---|
| 正文 / 画布 | #171717 |
#fafafa |
17.18:1 | ✅ ≥4.5 |
| 正文 / 卡片 | #171717 |
#ffffff |
17.93:1 | ✅ |
| 次级文字 / 画布 | #666666 |
#fafafa |
5.50:1 | ✅ |
| 次级文字 / 卡片 | #666666 |
#ffffff |
5.74:1 | ✅ |
| 次级文字 / 侧栏 | #666666 |
#f4f4f4 |
5.22:1 | ✅ |
| 自己气泡文字 / 气泡 | #fafafa |
#171717 |
17.18:1 | ✅ |
| 他人气泡文字 / 气泡 | #171717 |
#ebebeb |
16.01:1 | ✅ |
| 主按钮文字 / 按钮 | #ffffff |
#171717 |
17.93:1 | ✅ |
| @提及 / 画布 | #297a3a |
#fafafa |
5.11:1 | ✅ |
| @提及 / 他人气泡 | #297a3a |
#ebebeb |
4.76:1 | ✅ ≥4.5 |
| 危险文字 / 卡片 | #d92d20 |
#ffffff |
4.83:1 | ✅ |
| 控件周界 / 卡片 | #8f8f8f |
#ffffff |
3.23:1 | ✅ ≥3(1.4.11) |
| 频道图标 / 侧栏 | #6e6e6e |
#f4f4f4 |
4.64:1 | ✅ ≥3 |
| 选中项文字 / 选中底 | #171717 |
#e4e4e4 |
14.10:1 | ✅ |
| 选中底 / 侧栏底 | #e4e4e4 |
#f4f4f4 |
1.16:1 | ⚠️ <3 —— 见 R3 |
| 分隔线 / 画布 | #ebebeb |
#fafafa |
1.14:1 | ⚠️ 装饰性,刻意(R1) |
| 侧栏底 / 画布 | #f4f4f4 |
#fafafa |
1.05:1 | ⚠️ 装饰性(R1) |
| 卡片 / 画布 | #ffffff |
#fafafa |
1.05:1 | ⚠️ 装饰性——层级由 3.23:1 的周界承担 |
深色
| 组合 | 前景 | 背景 | 比值 | 达标 |
|---|---|---|---|---|
| 正文 / 画布 | #ededed |
#0a0a0a |
16.91:1 | ✅ |
| 正文 / 卡片 | #ededed |
#171717 |
15.31:1 | ✅ |
| 次级文字 / 画布 | #a1a1a1 |
#0a0a0a |
7.66:1 | ✅ |
| 次级文字 / 卡片 | #a1a1a1 |
#171717 |
6.94:1 | ✅ |
| 自己气泡文字 / 气泡 | #0a0a0a |
#ededed |
16.91:1 | ✅ |
| 主按钮文字 / 按钮 | #0a0a0a |
#ededed |
16.91:1 | ✅ |
| @提及 / 画布 | #46a758 |
#0a0a0a |
6.53:1 | ✅ |
| @提及 / 卡片 | #46a758 |
#171717 |
5.92:1 | ✅ |
| 危险文字 / 卡片 | #ff6369 |
#171717 |
6.18:1 | ✅ |
| 控件周界 / 卡片 | #707070(= rgb(255 255 255 / 0.45) 合成值) |
#171717 |
3.62:1 | ✅ ≥3 |
| 频道图标 / 画布 | #8f8f8f |
#0a0a0a |
6.12:1 | ✅ |
| 选中项文字 / 选中底 | #ededed |
#262626 |
12.93:1 | ✅ |
| 选中底 / 侧栏底 | #262626 |
#0a0a0a |
1.31:1 | ⚠️ <3 —— 见 R3 |
| 分隔线 / 画布 | #2a2a2a(= rgb(255 255 255 / 0.14) 合成值) |
#0a0a0a |
1.38:1 | ⚠️ 装饰性(R1) |
| 卡片 / 画布 | #171717 |
#0a0a0a |
1.10:1 | ⚠️ 装饰性——层级由 3.62:1 的周界承担 |
结论: 正文、次级文字、气泡、按钮、提及、危险色、控件周界、图标 —— 两套共 22 项组合全部达标;未达 3:1 的 4 项分两类:① 装饰性明度差(分隔线、侧栏 vs 画布、卡片 vs 画布),Vercel 语言刻意为之且不承载信息;② 会话选中底(R3),已用文字对比度补偿。深色下现状的严重缺陷(--surface-rail 仍是浅色 #e3e5e8、--interactive/--channel-icon 缺声明、rgb(6,6,7) 55 处硬编码前景)在令牌层被消除。
shadcn 兼容性
结论:可以只靠官方组件 + 官方 variant/size 达成,不需要新增任何组件,也没有任何一处需要自定义样式。
| 检查项 | 结论 |
|---|---|
| 组件总数 | web/src/components/ui/ 现有 38 个官方组件,本方案只用其中已有的 20 个,不新增组件 |
| 新增视觉变体 | 0 个。全部改造落在官方 variant 值域内:Button 用 default/outline/ghost/secondary/destructive/link;Badge 用 default/secondary/outline/destructive;Tabs 用 default/line |
className / 内联 style / 全局 CSS 覆盖组件 |
0 处。所有颜色/圆角/阴影/边界的改变都通过 web/src/styles.css 的语义令牌取值传导(components.json cssVariables: true) |
| 官方尺寸 | 只使用官方 size:Button 的 xs/sm/default/lg/icon-xs/icon-sm/icon/icon-lg;Avatar 的 sm;Badge 无 size(固定 h-5) |
| 需要新安装的官方组件 | 无 |
| 令牌名合法性 | tokens.css 只包含 web/src/styles.css 已存在的自定义属性名;.dark 下补齐 --interactive 与 --channel-icon 是给已存在的变量名补声明,不是新变量 |
@theme inline 映射 |
完全沿用原文,未增删任何 --color-* 映射行 |
显式标注的不合规风险
| 编号 | 内容 | 类型 |
|---|---|---|
| R1 | --border 1.14:1(浅)/ 1.38:1(深)、侧栏与画布 1.05:1、卡片与画布 1.05:1 —— 低于 WCAG 1.4.11 的 3:1。辩护:这些是装饰性明度差,不承载"识别控件/状态"的信息;所有可交互边界集中在 --input(3.23:1 / 3.62:1)。若验收要求所有边界 ≥3:1,则本方案不适用 |
刻意取舍,非疏漏 |
| R2 | 令牌泄漏未消除:message-list.tsx / composer-markdown.ts / voice-channel-history-dialog.tsx 硬编码 #006ce7;chat-mention.ts 硬编码 #3370FF;chrome.ts #f06f66、tone.ts #23a55a / #f0b232;253 处 Tailwind 原始调色板(44 个非测试文件) |
不合规风险:这些位置在深色下不翻转。本方案只能改令牌,无法从令牌层覆盖硬编码值;需另开一个"去硬编码"任务改 web/ 代码 |
| R3 | 会话选中底 #e4e4e4 vs 侧栏 #f4f4f4 = 1.16:1(深色 1.31:1),低于 3:1。补偿:选中项文字由 --muted-foreground(5.22:1)切到 --foreground(14.10:1),状态不靠颜色单一维度传达。若必须 ≥3:1,则选中底需改为反相黑(#171717 + #fafafa 文字,17.18:1),但那会让侧栏出现一条黑色重条,与 Vercel 的"谨慎使用反相表面"冲突 |
刻意取舍 + 已给替代方案 |
| R4 | 通过令牌无法修正的排版问题:消息正文"他人 15px / 自己 14px"两套字号(message-list.tsx)、12.8px/13.125px 小数档位、emoji 图标(app-center.tsx)、9px/9.375px 超小字号。这些都在组件类里,需改 web/ 代码 —— 本方案把它们列为目标值并标注途径②,但不声称已通过令牌修复 |
明确的越界项 |
| R5 | 头像首字底色是 Tailwind 50/700 硬编码配对(amber rgb(255,251,235)、rose rgb(255,241,242)…),深色下仍是浅色块独立于本方案 |
同 R2 |
| R6 | 应用中心 emoji 图标:本方案只把图标容器改为 48×48 rounded-lg 中性底;emoji 本身无法被令牌影响,彻底替换为 lucide 需改代码 |
部分解决 |
| R7 | 深色主题在生产不可达(全仓 web/src 无任何代码添加 .dark,<html> class 恒为空)。本方案给出完整深色令牌,但上线前必须先在代码里加主题切换,否则深色部分无法验收 |
前置依赖 |
| R8 | S6 语音频道的令牌取值属未实测推断(TRTC_ENABLED=false) |
未验证 |
实施成本
| 改动面 | 文件 | 内容 | 人时 |
|---|---|---|---|
| 令牌(必须) | web/src/styles.css |
用 tokens.css 替换 @theme inline 的 4 条阴影、:root 约 38 行、.dark 约 38 行 |
2h |
| 令牌(可选,视觉细节) | web/src/styles.css |
--workspace-* 三行渐变 |
0.5h |
| 组件(途径②,可分批) | message-list.tsx、task-hall.tsx、group-hall.tsx、app-center.tsx、agent-chat-panel.tsx、channel-sidebar.tsx、space-manage-dialog.tsx、channel-settings-dialog.tsx、routes/login.tsx |
统一字号到 6 档刻度;Button/Badge/Tabs 的 variant 选择;两套圆角归一 |
12h |
| 容器(途径③) | 同上 + app-shell.tsx |
群聊大厅去 hero、rail 图标网格 48×48、列表行间距、侧栏三面明度阶梯 | 6h |
| 去硬编码(R2/R5,独立任务) | 44 个非测试文件 | 253 处 Tailwind 调色板 + 6 处硬编码色 → 语义令牌 | 16h |
| 主题开关(R7,前置) | app-shell.tsx / index.html |
让 .dark 可被挂上 |
3h |
| 合计 | ≈40h(其中必做 2h,其余可按批次上线) |
风险清单
- 深色不可达(R7) —— 止于令牌层,无代码开关则深色侧全部无法验收。最大风险。
- 令牌泄漏(R2/R5) —— 253 处调色板 + 硬编码色在深色下不翻转,会让"深色对等"的承诺在局部失效。必须先做去硬编码,或明确接受"深色下仍有一半界面不可读"。
- 中文小字号(R4) —— 只改令牌无法把
9.375px提到 12px。 - 品牌识别 ——
--brand由#2563eb变#171717是品牌级决定,需产品 owner 签字;若要保留蓝色,本方案的"单色纪律"会退化为"又一个蓝色企业工具"。 - 反相气泡的阅读负荷 —— 长消息(实测最长如「需要限制不可删除兜底的通用讨论子频道么,刚才实测删除后仍会展示在列表里」)在白底上为黑块,深色下为亮块,长时段阅读负担高于浅灰气泡。
验证方式(哪些检查能证明改动生效)
- 令牌生效:
getComputedStyle(document.documentElement).getPropertyValue('--brand')应返回#171717(浅)/#ededed(深);--radius返回0.375rem。 - 层级修复:对侧栏
aside与body取backgroundColor,应分别为rgb(244,244,244)与rgb(250,250,250)(不再相同,即修掉简报 §3.3 的"零层级对比")。 - 气泡语义:对
message-self气泡取背景,应为rgb(23,23,23)(浅)/rgb(237,237,237)(深)。 - 去蓝:全页扫描
getComputedStyle的color/backgroundColor,不应再出现rgb(37,99,235)、rgb(51,112,255)、rgb(232,243,254)、rgb(229,236,252)、rgb(225,232,242)。 - 圆角收敛:全页
borderRadius去重后应只剩6px / 4.8px / 3.6px / 8.4px / 9999px(--radius派生族 + 胶囊),不再有10px / 14px / 18px / 26px / 2px / 7px。 - 深色可达性:注入
.dark后重新执行 2–4,所有值应落到深色令牌;且--surface-rail不再是浅色。 - 对比度:按本文件两张对比度表逐项复算,22 项达标项不得有回归。
取舍
解决了什么
- 修掉简报 §3.3 记录的两个硬缺陷:侧栏与画布同色(零层级对比,现
#f4f4f4vs#fafafa);深色下--surface-rail仍是浅色竖带(现#171717)。 - 把全站色相从「品牌蓝 + 提及蓝 + 硬编码
#006ce7+ Tailwind 12 个调色板族」收敛为 2 个(Terminal Green + 危险红),颜色重新具备指示力。 - 圆角从 12 档收敛到 6px 一族;阴影从"四步投影"改为"描边环",高密度界面噪声下降且深浅两套自动成立。
- 补齐
.dark缺失的--interactive、--channel-icon两条声明(现状会继承浅色值,深底不可辨)。 - 自己/他人消息在深浅两套下都有 16:1 以上的明确区分,且不依赖色相。
牺牲了什么
- 品牌蓝(
#2563eb)以及它带来的"可信企业蓝"直觉。主按钮变成黑色实心后,产品在截图上更像开发者工具而非协作工具。 - 装饰性边界的可见度:发丝线在 1:1 缩放的显示器上(非 HiDPI)几乎消失,
--border从#dcdee1(1.36:1)降到#ebebeb(1.14:1)。 - 长消息的阅读舒适度:反相气泡把长文本压成高对比块(见风险 5)。
- 深色可用性需要额外前置工作:本方案给出完整深色令牌,但产品当前不可达,承诺无法单独验收。
- 不解决组件内已存在的排版不一致(15/14px 双字号、9.375px 超小字号、emoji 图标)——它们不在令牌可达范围。
什么场景下不适用
- 需要保留原品牌蓝或任何多色品牌体系 → 本方案的单色纪律不成立,请改选保留
--brand蓝的方案。 - 验收要求所有分隔线与容器边界 ≥3:1(严格 1.4.11 解读)→ 本方案的 Vercel 发丝线策略直接不达标,请改选高对比边框方案。
- 目标是图形密集/数据可视化为主的产品面(例如以图表为主的报表页)→ 单色系统的信息承载不足,需要多色序列。
- 产品定位是营销或对外展示(落地页、客户案例)→ 本方案刻意舍弃了 Vercel 最有表现力的 hero/渐变叙事,只保留了它的工作台部分。