碳黑荧光绿 — wanman /app 重设计方案
参考:Supabase(
supabase.design.md/supabase.design-extended.md,来源站点 supabase.com,theme = dark) 对象:web/(Vite + React + TanStack Router + Tailwind + shadcn/ui,base-nova,lucide) 基线:test@3d35969f,实测数据来自localtmp/design-render/*.json(1440×900,DOM /getComputedStyle)
方案名与主张
方案名:碳黑荧光绿(6 字)
主张一句话:把 Supabase 的「午夜编辑器 + 荧光绿光标」搬进企业协作工具 —— 画布退成碳黑 #121212,其余界面只由灰阶与 1px 炭灰描边构成,唯一的彩色(一枚荧光绿)只发给「当前所在」与「主行动」;层级靠表面明度差而不是阴影,密度靠 8px 网格而不是装饰。
- 适用基调:深色优先(深色是主设计面:
--background:#121212、--brand:#3ecf8e);浅色为完整镜像(把参考的深色明度阶梯做亮度翻转),不是事后补丁。 - 主色:深色
#3ecf8e(Phosphor Green,参考原值)/ 浅色#006239(Midnight Emerald,参考原值)。 - 一句话验收:改完令牌后,深色下整屏只会出现一种彩色(绿);出现第二种色即视为方案未落地。
参考提炼
参考风格名 Supabase,slug supabase,来源站点 supabase.com,theme = dark。原文四句核心(可直接追溯到 supabase.design.md):
- 「Midnight code editor with phosphor green caret — a single chromatic pulse on a sea of charcoal.」
可迁移规则:色彩配给制 —— 画布 99% 灰阶,「every green pixel earns its place by being a CTA, a highlighted keyword, or a logo」。→ wanman 里绿色只保留给:主按钮(
Button default)、当前选中的频道/会话、进行中任务徽标、@提及、AI 运行中状态。 - 「Obsidian Canvas
#121212— Page background」/「Ash Card#242424— Nested or elevated card surfaces」/「Charcoal Border#2e2e2e」。 可迁移规则:三层表面 + 一枚描边,层级用明度差和 1px 边框表达。→ 深色令牌阶梯#121212 → #171717(rail) → #1b1b1b(卡片/侧栏) → #242424(弹层/悬停),边框#2e2e2e。 - 「Supabase deliberately avoids shadows…relies on hairline #2e2e2e borders」+「Don't add box-shadows to cards, popovers, or modals」。
可迁移规则:阴影不是层级语言。→ 不改
--shadow-e1..e3/--shadow-pop的定义(改它们会波及未覆盖的 252 个组件文件),但在深色下把「立起来」的职责交给边框与表面色,见 §6 的风险说明。 - 「Use Circular weight 400 for headlines and weight 500 for emphasis…never bold」+ 参考的 radius 词汇表(
tags 9999px / cards 16px / inputs 8px)。 可迁移规则:字重封顶 500,圆角词汇表收窄。→ 全站字重只用 400/500(font-medium封顶,禁止font-semibold/bold);--radius由0.625rem调到0.75rem,使卡片落在 16.8px(≈参考 16px)、控件 12px、徽标恒胶囊。
必须舍弃:参考的 display 72px/36px 营销字号、--page-max-width:1200px 居中式 hero、logo cloud、testimonial masonry —— 这些是营销页排版,本产品是长驻留的高密度工作台,没有滚动叙事。
适配判断
为什么这套语言适合「任务 + 频道消息」:
- 产品是长时段驻留:实测单视图 AI 助手空间一次渲染内
12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994(S4-agent-space.json)。深色碳黑画布降低 8 小时连续盯屏的亮度负荷,而近黑画布对中文细字(Noto Sans SC 400)最宽容:#fafafaon#121212= 17.95:1,远超 4.5:1。 - 界面是信息密集但色彩语义单一:任务只有一条状态轴(待补充→待处理→进行中→待验收→已完成/已关闭),消息只有「谁发的/是否提到我」。参考的配给制色彩纪律正好把「进行中、@我、当前频道」三种需要一眼抓到的信号,用同一种绿固定下来;其余(频道 chip、元信息、时间戳)全部灰阶,长列表不再花色噪音。
- 实测现状恰恰缺这套纪律:单视图里同时存在
rgb(37,99,235)品牌蓝 20 处、amber/rose/emerald 等 Tailwind 原色 253 处、#006ce7、--mention #3370ff三种蓝(简报 §3.3)。Supabase 的「一种彩色」把这个问题变成可检查的规则:深色下不应出现除绿以外的彩色。 - 层级现状有明确缺陷可用同一套语言修好:会话侧栏
aside背景#fcfcfc与--background:#fcfcfc完全相同(零层级对比)→ 参考的「canvas 与 card 差一档 + 1px 描边」直接对症。深色--surface-rail仍是浅色#e3e5e8,会成一条浅色竖带 → 一并修掉。
舍弃项(明确不做):
| 舍弃 | 原因 |
|---|---|
| 胶囊按钮(radius 9999px) | button.tsx 固定 rounded-lg(= var(--radius)),改胶囊必须写 className,违反硬约束 1。改用 --radius 阶梯 + size variant 表达层级(见风险 R1) |
全站负字距 -0.007em |
没有官方工具类;且中文(Noto Sans SC / PingFang SC)在负字距下笔画会挤,简报 §2.4 明令中文字号 ≥12px、行高 ≥1.375,收紧字距与中文可读性冲突 |
| 「不做阴影」的字面执行 | --shadow-e1..e3/--shadow-pop 与 card.tsx 的 ring-1 ring-foreground/10、dialog.tsx 的 ring-1 ring-foreground/10 是既有组件行为;本方案不改这些定义,只在令牌层面把深色改成靠表面差分层级(见风险 R2) |
| 深色营销页那种大留白 | 参考 section gap 64–96px、card padding 24px 用于落地页;本产品任务卡内边距保持 12–16px,站内垂直节奏用 8px 网格 |
| 参考的 4 种绿同时上色 | 参考原文「Don't introduce any chromatic color beyond the four greens」,但同时用 4 种绿会让状态色失去唯一性;wanman 只保留 2 绿:--brand(强调)+ --mention(可点文字),其余绿都通过 brand-soft 洗色派生 |
令牌映射
tokens.css 给出可整段替换的代码。下表「当前值」取自 web/src/styles.css:108(:root)与 :163(.dark)原文;「建议值」全部是参考令牌原值或由参考阶梯的明确推导(推导写在该行意图里)。所有改动都落在途径① 语义令牌取值。
浅色 :root(把参考的深色明度阶梯做亮度镜像)
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
#fcfcfc |
#f4f5f4 |
画布下沉一档;原来是纯近白,与白色卡片、侧栏无层级差(侧栏实测 #fcfcfc 与 --background 完全相同) |
--foreground |
#060607 |
#121212 |
复用参考 Obsidian #121212 作浅色墨色,on 画布 17.14:1 |
--card |
#ffffff |
#ffffff |
保持纯白;配合下沉后的画布形成第一层级(1.09:1 明度差 + ring-1 ring-foreground/10) |
--card-foreground |
#060607 |
#121212 |
与 --foreground 统一,18.73:1 |
--popover |
#ffffff |
#ffffff |
同上,弹层为最高层级 |
--popover-foreground |
#060607 |
#121212 |
同上 |
--primary |
var(--brand) |
var(--brand) |
保持间接引用,浅深各取其 --brand |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
同上 |
--secondary |
#ebedef |
#ecedec |
镜像参考 Ash #242424 的浅色档,去蓝去暖,纯中性 |
--secondary-foreground |
#060607 |
#121212 |
统一墨色,15.96:1 |
--muted |
#f2f3f5 |
#f0f1f0 |
轻微面,与画布 #f4f5f4 同族但更亮一档 |
--muted-foreground |
#5c5e66 |
#6b6b6b |
镜像参考 Smoke 的可读档;on 白 5.33:1、on muted 4.71:1、on secondary 4.54:1 全部 ≥4.5 |
--accent |
#ebedef |
#ecedec |
他人消息气泡用 bg-accent,实测原值为 rgb(235,237,239);改成中性灰,去掉蓝灰味 |
--accent-foreground |
#060607 |
#121212 |
气泡内文字 15.96:1 |
--destructive |
#da373c |
#c92a2f |
红单独一档、不参与绿色主色相;on 白 5.45:1、on rgb(accent) 4.52:1(原 #da373c on 白约 4.3:1,临界) |
--border |
#dcdee1 |
#e0e2e1 |
装饰分隔线,去蓝;1.19:1 属纯装饰,见风险 R3 |
--input |
#dcdee1 |
#8f8f8f |
控件边界单独分级:3.23:1,满足非文本对比 3:1(参考的 #393939 在浅色下不可用,取等对比度的中性灰) |
--ring |
var(--brand) |
var(--brand) |
焦点环=品牌绿,落实参考「the chromatic border replaces the conventional focus shadow」 |
--chart-1 |
oklch(0.87 0 0) |
#006239 |
图表 5 档改为「2 绿 + 3 灰」:主序列取参考 Midnight Emerald,on 白 7.48:1 |
--chart-2 |
oklch(0.556 0 0) |
#16a06a |
次序列绿,on 白 3.35:1 |
--chart-3 |
oklch(0.439 0 0) |
#4d4d4d |
参考 Graphite,on 白 8.45:1 |
--chart-4 |
oklch(0.371 0 0) |
#8a8a8a |
参考 Smoke 的浅色档,on 白 3.45:1 |
--chart-5 |
oklch(0.269 0 0) |
#557064 |
绿灰第 5 档(避免 #3ecf8e on 白仅 2.0:1 不达标),on 白 5.40:1 |
--radius |
0.625rem(10px) |
0.75rem(12px) |
收窄圆角词汇表:卡片 rounded-xl 14→16.8px(对齐参考 16px),控件 rounded-lg 10→12px,徽标 rounded-4xl 恒胶囊。原实测 8/10/14/26px 四档混用(S3-task-hall.json 10px×48 与 8px×37 并存),改后为 9.6/12/16.8/31.2px 连续阶梯 |
--brand |
#2563eb |
#006239 |
品牌蓝整体替换为绿色主色;浅底上用参考最深的绿保证白字 7.48:1 |
--brand-foreground |
#ffffff |
#ffffff |
深绿底配白字,7.48:1 |
--brand-soft |
rgb(37 99 235 / 0.12) |
rgb(0 98 57 / 0.12) |
选中/提及洗色改为绿;洗色后 --brand-ink on 洗色 = 6.17:1 |
--brand-ink |
#1d4ed8 |
#006239 |
浅底绿色文字,on 白 7.48:1、on 画布 6.85:1 |
--message-self |
#e8f3fe |
#e6f6ee |
自己的消息气泡改淡绿(原来是与品牌蓝同族的 #e8f3fe) |
--message-self-foreground |
#0d274a |
#0b3a26 |
深绿墨色,on 淡绿 11.40:1 |
--surface-chat-soft |
#e8f2ff |
#edf7f1 |
引用/回复底:比气泡更淡的一档绿灰 |
--surface-chat-selected |
#e5ecfc |
#ddf0e5 |
会话选中底绿洗实心化,文字 15.76:1 |
--mention |
#3370ff |
#067647 |
@链接去第三种蓝,on 白 5.69:1、on 自己气泡 5.09:1 |
--ink |
#060607 |
#121212 |
与墨色统一到参考 Charcoal 系 |
--surface-rail |
#e1e8f2 |
#e7e9e8 |
空间 rail 去蓝,比画布再沉一档 |
--sidebar |
#fcfcfc |
#ffffff |
修层级缺陷:侧栏从「与画布同色」改为白色面板 + --sidebar-border |
--sidebar-foreground |
#060607 |
#121212 |
18.73:1 |
--sidebar-accent |
#ebedef |
#ecedec |
悬停面同 --accent |
--sidebar-accent-foreground |
#060607 |
#121212 |
15.96:1 |
--sidebar-border |
#dcdee1 |
#e0e2e1 |
与 --border 统一,1px 描边承担分层职责 |
深色 .dark(参考本体)
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
oklch(0.145 0 0) |
#121212 |
直接取参考 Obsidian 画布原值 |
--foreground |
oklch(0.985 0 0) |
#fafafa |
参考 Snow 原值,17.95:1 |
--card |
oklch(0.205 0 0) |
#1b1b1b |
Ash 下一档,做卡片/面板面;与画布 1.09:1 差 + 描边 |
--card-foreground |
oklch(0.985 0 0) |
#fafafa |
16.50:1 |
--popover |
oklch(0.205 0 0) |
#242424 |
参考 Ash 原值,弹层/悬停面比卡片再高一档 |
--popover-foreground |
oklch(0.985 0 0) |
#fafafa |
14.87:1 |
--primary |
var(--brand) |
var(--brand) |
间接引用不变 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
同上 |
--secondary |
oklch(0.269 0 0) |
#242424 |
参考 Ash |
--secondary-foreground |
oklch(0.985 0 0) |
#fafafa |
14.87:1 |
--muted |
oklch(0.269 0 0) |
#1b1b1b |
muted 是「轻微面」不是「悬停面」,降到卡片档,避免与 accent 同值(现在二者都是 0.269) |
--muted-foreground |
oklch(0.708 0 0) |
#8f8f8f |
参考 Smoke #898989 提到 #8f8f8f:on 画布 5.79、on 卡片 5.33、on Ash 悬停底 4.80,全部 ≥4.5 |
--accent |
oklch(0.269 0 0) |
#242424 |
参考 Ash;他人消息气泡用 bg-accent,深色下成 #242424,文字 14.87:1 |
--accent-foreground |
oklch(0.985 0 0) |
#fafafa |
同上 |
--destructive |
oklch(0.704 0.191 22.216) |
#ff6369 |
on 画布 6.46:1;作为 bg-destructive/20 徽标底上的文字 4.90:1 |
--border |
oklch(1 0 0 / 10%) |
#2e2e2e |
参考 Charcoal 原值(去掉 alpha,透明度叠加会让描边在卡片上变浑);1.38:1 属装饰线,见风险 R3 |
--input |
oklch(1 0 0 / 15%) |
#666666 |
控件边界单独分级:3.26:1 达非文本 3:1(参考 Slate #393939 仅 1.62:1,不可直接用);同时它是 dark:bg-input/30 的填充来源 |
--ring |
var(--brand) |
var(--brand)(继承 :root) |
焦点环=荧光绿,on 画布 9.39:1 |
--chart-1 |
oklch(0.87 0 0) |
#3ecf8e |
参考 Phosphor Green,on 画布 9.39:1 |
--chart-2 |
oklch(0.556 0 0) |
#00c573 |
参考 Mint Pulse,8.24:1 |
--chart-3 |
oklch(0.439 0 0) |
#a3a3a3 |
7.43:1 |
--chart-4 |
oklch(0.371 0 0) |
#898989 |
参考 Smoke,5.36:1 |
--chart-5 |
oklch(0.269 0 0) |
#6b6b6b |
3.52:1(原暗档 #4d4d4d on 画布仅 2.22:1,不达 3:1) |
--radius |
0.625rem(继承) |
0.75rem(继承 :root) |
深浅同一圆角阶梯 |
--brand |
oklch(0.68 0.15 256) |
#3ecf8e |
参考 Phosphor Green 原值;这是全屏唯一彩色 |
--brand-foreground |
oklch(0.16 0.02 258) |
#0d1a14 |
偏离参考:参考「green fill + #fafafa text」实测仅 1.9:1;改用近黑绿字,8.95:1(见风险 R1 补充) |
--brand-soft |
oklch(0.28 0.05 256) |
rgb(62 207 142 / 0.14) |
选中/当前频道洗色(复合后 ≈ #182c23),--brand-ink on 洗色 7.48:1 |
--brand-ink |
oklch(0.84 0.09 256) |
#3ecf8e |
深底绿字,9.39:1 |
--message-self |
#203b59 |
#0f3a27 |
自己的气泡:Obsidian #121212 与 Midnight Emerald #006239 的中间调,避免大面积高饱和绿 |
--message-self-foreground |
#e7f3ff |
#dff6e9 |
on 气泡 12.16:1 |
--surface-chat-soft |
oklch(0.32 0.06 250) |
#182b21 |
引用/回复底,绿灰低调(原值是蓝调 250 色相) |
--surface-chat-selected |
oklch(0.28 0.04 250) |
#1f3a2c |
会话选中底,文字 11.84:1 |
--mention |
oklch(0.72 0.14 254) |
#00c573 |
参考 Mint Pulse:可点文字专用绿,8.24:1 |
--ink |
oklch(0.16 0.02 258) |
#0b0b0b |
深底上的「墨」保持中性近黑 |
--surface-rail |
#e3e5e8 |
#171717 |
修缺陷:原深色 rail 仍是浅色 #e3e5e8,会在深色下变成一条浅色竖带 |
--sidebar |
oklch(0.205 0 0) |
#1b1b1b |
与卡片同档;深色下侧栏本就是浮层面板 |
--sidebar-foreground |
oklch(0.985 0 0) |
#fafafa |
16.50:1 |
--sidebar-accent |
oklch(0.269 0 0) |
#242424 |
参考 Ash |
--sidebar-accent-foreground |
oklch(0.985 0 0) |
#fafafa |
14.87:1 |
--sidebar-border |
oklch(1 0 0 / 10%) |
#2e2e2e |
参考 Charcoal |
同样在 .dark 内一并覆盖的「继承型」令牌
这些名字都已在 :root 定义(不是新令牌),深色下必须重新声明,否则保留浅色取值:
| 变量名 | :root 值 |
.dark 建议值 |
意图 |
|---|---|---|---|
--interactive |
#4d4d4d |
#a3a3a3 |
原 #4e5058 在深色画布上仅约 2.2:1;改后 7.43:1 |
--channel-icon |
#8a8a8a |
#6b6b6b |
深色下 3.52:1,满足图形 3:1 |
--workspace-background |
var(--surface-rail) |
var(--background) |
去渐变(参考明令 no gradients),大画布纯色 |
--workspace-rail-background |
transparent |
transparent |
保持 |
--workspace-header-background |
var(--background) |
var(--background) |
去掉原深色块的渐变,头部与画布同色,靠 --border 分隔 |
--ring、--sidebar-primary、--sidebar-primary-foreground、--sidebar-ring是var(--brand)/var(--ring)间接引用,声明与--brand同在html上,.dark覆盖--brand后自动解析到深色绿,无需重复声明。
字体与排版
字体栈(不改,web/src/styles.css @theme inline --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
- Geist Variable 无中文字形(简报 §3.3)→ 中文实际落到
Noto Sans SC/PingFang SC,拉丁走 Geist。这个顺序不能动:把任何西文字体插到Noto Sans SC之前都会让中文失去字体。 - 不引入新字体。参考给 Circular 的替代品(Inter / Manrope)本仓库未安装,新增
@fontsource依赖等于引入外链资源,超出「只改令牌」的范围。 - 代码/ID/数字用
--font-mono(ui-monospace, "SF Mono", …)。
字重纪律:只用 400(font-normal,默认)与 500(font-medium)。禁止 font-semibold/font-bold/任意 font-[…] —— 参考原文「never bold…the 500 is the loudest voice available」。现状违规处:频道头标题 16px/600、14px/600 ×39(S4-agent-space)、15px/600 ×7(S8-app-center)、17px/600 ×9(多处),一律降到 500。
字号阶梯(只有 6 档,全部使用官方 Tailwind 档位或整数值):
| 角色 | 字号 | 行高 | 字重 | 落地类 | 现状对照 |
|---|---|---|---|---|---|
| 正文(消息、表单) | 15px | 1.375(20.63px) | 400 | body 默认(styles.css base 已是 15px/1.375,不改) |
保持 |
| 消息正文(他人/自己统一) | 15px | 1.5 | 400 | text-[15px] leading-normal |
现状他人 15px、自己 14px,同列表两套字号 → 统一 |
| 频道头/弹窗标题 | 16px | 1.375 | 500 | text-base font-medium |
现状 16px/600 → 降 500 |
| 卡片/任务标题 | 14px | 1.375 | 500 | text-sm font-medium |
保持 |
| 次级(会话预览、作者) | 13px | 1.375 | 400 | text-[13px] |
保持 |
| 元信息(时间、成员数、标签、徽标) | 12px | 1.375 | 400–500 | text-xs(+font-medium) |
现状 12px/500 ✓,但 11.25px / 9.375px 违规 |
| 代码 / ID / 计数 / 时间戳 | 12px | 1.33 | 400 | font-mono text-xs tabular-nums |
现状混用 |
| 登录主标题 | 24px | 1.2 | 500 | text-2xl leading-tight font-medium |
现状 26px → 24px(对齐参考 heading-sm 24px);参考用 400,中文大字 400 显轻,取 500(CJK 修正) |
| 页脚/法务 | 12px | 1.375 | 400 | text-xs |
现状 11px → 12px |
中文与数字注意点:
- 中文最小 12px,禁止 em 派生小数字号。实测档位里 11.25 / 12.8 / 13.125 / 9.375px 全部来自以 15px 为基准的 em 计算(简报 §3.3);这些值在小数点上不可控,一律换成
text-xs(12px) /text-sm(14px)。 - 中文不加负字距。参考的
-0.007em全域负字距舍弃:汉字在负字距下笔画相撞,且没有官方工具类可表达。 - 数字必须等宽:任务编号、未读数、已读人数、时间戳、
共 14 个应用用tabular-nums(+font-mono用于代码/ID),否则列表里数字跳动。 - 中西混排基线:
WanChat、WanWork、WanNote、@agent走 Geist,紧邻中文走 Noto Sans SC;不要对中文块用uppercase/tracking-*。 - 行高下限 1.375(简报 §2.4),且只在 24px 登录标题上用 1.2。
关键界面改造
每个面都按「现状(实测)→ 改后」写,并标注落在哪条途径:①令牌取值 / ②官方 variant·size / ③容器布局与间距滚动。
S1 应用外壳 + 空间/频道侧栏(app-shell.tsx、channel-sidebar.tsx)
现状:空间 rail nav 72×900,背景 transparent,右边框 rgba(220,222,225,0.55)(不等于 --border #dcdee1);会话侧栏 aside 256×715 @x=76,border-radius 14px,background #fcfcfc —— 与页面底色 --background:#fcfcfc 完全相同,零层级对比;侧栏头部 52px;搜索框 30px / 圆角 10px / rgba(235,238,239,0.75);会话行 240×64,未读点、时间、预览 11.25px。
改后:
- ① 令牌:
--sidebar#ffffff(浅) /#1b1b1b(深)、--sidebar-border#e0e2e1/#2e2e2e、--surface-rail#e7e9e8/#171717、--background#f4f5f4/#121212。侧栏从此有真实层级:浅色 1.09:1 明度差 + 1px 描边,深色 1.06:1 +#2e2e2e描边(原来深色 rail 是浅色#e3e5e8,会成一条浅色竖带,本方案修掉)。 - ③ 布局:rail 宽 72px 保持(9×8),
aside宽 256px 保持(32×8),头部 52→56px(7×8),会话行 64px 保持(8×8,三行信息:名称/预览/时间);搜索框 30→32px(与Button默认h-8等高),圆角交给--radius=12px,去掉opacity 0.75的透明底(改--muted实色,避免叠色不可控)。 - ② 官方组件:rail 空间图标
Button variant="ghost" size="icon-lg"(36px,替代 71×48 的大块);选中空间 =Button variant="secondary"(用官方 variant 表达选中,不用 className 改色);未读计数Badge variant="default"(绿,h-5 +text-xs);当前频道 = 行底--sidebar-accent+ 左侧 2pxbg-brand竖条(竖条是容器装饰,不属于组件样式覆盖);频道树折叠Collapsible;长列表ScrollArea。 - 状态色:连接态统一走徽标 ——
已连接→Badge default(绿)、连接中/重连中→Badge secondary、已断开→Badge outline、连接失败→Badge destructive。绿色在这个区域只出现于「当前/连接正常」两处。 - 密度:侧栏内边距 8px、行内 gap 8px;预览行 11.25px → 12px(
text-xs),并加tabular-nums给时间列。
S2 频道消息流(message-list.tsx、channel-thread.tsx、channel-header.tsx)
现状:频道头 860×52,标题 16px/600 #060607,成员数 12px/500 #5c5e66;气泡圆角 14px,他人 rgb(235,237,239)(=--accent)、自己 rgb(232,243,254)(=--message-self)+ 文字 rgb(13,39,74);消息正文他人 15px/400、自己 14px/400;作者 13px/400;时间 12px/500;输入区 textarea 628×33 无边框,外层只有上边框 rgb(220,222,225);工具按钮 28×28;悬停动作:点赞/回复/更多/预览图片/已读(0 人已读,4 人未读)。
改后:
- ② 字号统一:他人与自己的消息正文统一 15px/1.5/400(
text-[15px] leading-normal),去掉 14px 分支 —— 这是本面最实际的观感修复。 - ① 令牌:他人气泡
bg-accent→#ecedec(浅) /#242424(深);自己气泡bg-message-self→#e6f6ee/#0f3a27,文字 11.40:1 / 12.16:1;@提及--mention#067647/#00c573(消掉第三种蓝#3370FF);引用/回复底--surface-chat-soft#edf7f1/#182b21。 - ② 官方组件:悬停动作
ButtonGroup+Button variant="ghost" size="icon-sm"(size-7= 28px,与实测 28×28 完全一致);置顶/附件/引用 chipBadge variant="outline";「4 人未读」Badge variant="secondary"+tabular-nums;输入区Textarea(自身 1px--input边框,深浅 3.23:1 / 3.26:1,满足非文本 3:1);发送/上传Button variant="ghost" size="icon-sm";Separator做消息组之间的分割。 - ③ 布局:消息内容列宽上限保持 860px(实测频道头 860),频道头高保持 52px;气泡内边距走 8px 网格;输入区外层保留 1px
--border上边框,输入卡片整体用--card面 +--radius12px;工具行与输入行之间 8px。 - 状态色:发送中 =
Skeleton+ 12px--muted-foreground;发送失败 =Button variant="destructive"「重试」;@我 =--brand-soft行底 + 左侧 2pxbg-brand(与 S1 同一套「当前/针对我」语言);已读回执数字 = 12pxtabular-nums+--muted-foreground(原#5c5e66→#6b6b6b/#8f8f8f)。
S3 任务大厅与任务卡(task-hall.tsx、group-hall.tsx、channel-work-items.tsx)
现状:看板标题 16px;筛选「全部频道 / 5 项任务」;列头「待补充 0 / 待处理 5」;卡片 = 标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人;圆角 10px×48 与 8px×37 两套混用;群聊大厅是营销式 hero 段落 + 「全部群聊 / 全部 / 已加入 / 未加入」筛选 + 群卡片,品牌蓝 rgb(37,99,235) 出现 20 处。
改后:
① 令牌:
--primary变绿后,「新建任务」成为整个页面的唯一 filled 按钮(参考「every green pixel earns its place by being a CTA」);--radius10→12px 把10px×48 / 8px×37两套圆角合并成12px(控件) /16.8px(卡片) /9.6px(小控件) 连续阶梯。② 状态色只用官方 variant(不写任何 className 改色):
状态 组件与 variant 依据 待补充 Badge variant="outline"灰描边=「还没被认领」 待处理 Badge variant="secondary"中性面=「已入队」 进行中 Badge variant="default"全站唯一绿底徽标,等于参考的 phosphor caret 待验收 Badge variant="outline"描边=「等人」 已完成 Badge variant="ghost"最低存在感 已关闭 Badge variant="outline"描边=归档 逾期 / 风险 Badge variant="destructive"唯一的红 Badge的每个 variant 底色都来自--primary/--secondary/--border/--destructive,因此深色自动翻转。② 其他组件:任务卡
Card(默认--card-spacing:16px),子任务卡Card data-[size=sm](12px);负责人Avatar+AvatarFallback(用--muted面 +--muted-foreground字,替换硬编码的 amber/rose/blue/emerald/teal 50/700 配对);「查看任务」Button variant="ghost" size="xs"(h-6,次级动作);「全部频道」下拉Select;「新建任务」Button(default,绿)+Dialog。③ 布局:看板列宽 288px(36×8),列间 gap 8px,卡片间 gap 8px,列头 sticky;群聊大厅删掉 hero 段落(营销排版,参考舍弃项),标题
text-base font-medium,筛选改Tabs variant="line"(全部/已加入/未加入)+Input搜索 +Badge显示群人数。密度:卡片内
--card-spacing12px(子卡)/16px(主卡),标题 14px/500,元信息 12px,全部 8px 网格。
S7 登录页(web/src/routes/login.tsx、sign-in.$.tsx)
现状:居中卡片,主标题 26px;「邮箱验证码 / 短信验证码」切换块 173×42(选中态背景 --background #fcfcfc + 品牌蓝文字);主按钮 356×52、白字 #2563eb;页脚 11px。文案:「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」。
改后:
- ① 令牌:主按钮从品牌蓝变深绿
#006239(浅) / 荧光绿#3ecf8e(深);卡片--card#ffffff/#1b1b1b浮在--background#f4f5f4/#121212上;页脚与提示走--muted-foreground;输入框边界--input(3.23:1 / 3.26:1)。 - ② 官方组件:验证码方式切换块改
Tabs + TabsList + TabsTrigger(variant="default",选中态由官方data-active驱动,替掉手写的 173×42 块);「获取验证码」Button variant="secondary" size="sm";主按钮Button size="lg";邮箱输入Input+Field/FieldLabel。 - ③ 布局:卡片固定宽 400px(50×8)、内边距 24px(3×8)、控件间距 16px;主按钮占满内容宽(356px 由容器控制)。
⚠️ 高度取舍:官方
Button最大档是size="lg"= 36px,实测的 52px 无对应官方 size,自定义高度需写 className(违反硬约束 1)→ 采取 36px + 满宽 + 卡片留白补偿。 - 字体:主标题 26→24px/1.2/500(
text-2xl,对齐参考heading-sm);页脚 11→12px。 - 状态色:验证码倒计时禁用 =
Button disabled(官方opacity-50);验证码错误 =Input aria-invalid(官方 destructive 边框 + 环),不再新增红色字面量。
S4 AI 助手频道(agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx)
现状:AI 助手空间一次渲染内字号 12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724,另有 11.25/13.125/9.375px;圆角 8px ×1591、10px ×844(S4-agent-space.json);含流式回答、来源引用、结果卡片。
改后:
- ② 字号收口:五档 em 派生字号 → 三档 12px(
text-xs) / 14px(text-sm) / 15px(默认),删掉 12.8 / 13.125 / 11.25 / 9.375px。 - ① 令牌:
--brand绿只用于「AI 正在工作」徽标与主行动按钮;来源引用 chip 用--muted面;等待态沿用--animate-breathe(保留现有动效令牌,不改)。 - ② 组件:结果卡
Card+CardHeader/CardContent;工具/轨迹行Item+ItemGroup+Separator;引用来源Badge variant="outline"+tabular-nums编号;追问建议Button variant="secondary" size="sm";运行中Badge variant="default"。 - ③ 布局:结果列表 gap 8px,卡片
data-[size=sm](--card-spacing12px),单卡内容列宽上限 720px;原本 1591 处的 8px 圆角统一到「卡片 16.8px / 控件 12px」两级。 - 状态色:运行中=绿(唯一彩色);失败=
Badge variant="destructive";无结果空态=15px--muted-foreground文案 + 一个Button主行动。
S5 管理与设置弹窗(space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx)
现状:[role=dialog] 704×512,圆角 18px,背景 #ffffff;左侧导航项 135×36、圆角 8px,选中态 --brand-soft(rgb(37 99 235/0.12)) + 前景 --brand-ink(#1d4ed8),危险项前景 --destructive #da373c;输入框 488×32、圆角 10px;表单标签 14px。
改后:
- ① 令牌:弹层用
--popover#ffffff/#242424(深色下比卡片#1b1b1b再高一档,符合参考 Ash 定位);导航选中态--brand-soft+--brand-ink变成绿洗色 + 绿字(洗色后 6.17:1 / 7.48:1);危险项--destructive换成#c92a2f/#ff6369。 - ② 官方组件:左侧导航改
Tabs orientation="vertical"(tabs.tsx原生支持data-[orientation=vertical],替掉手写的 135×36 导航项);危险操作Button variant="destructive";删除确认AlertDialog(Action = destructive);表单Input/FieldSelect/Checkbox/Field+FieldLabel(标签 14px =text-sm);成员列表Table或Item+Avatar。 - ③ 布局:弹窗尺寸 704×512 保持(88×8 / 64×8,均为 8 的倍数);左导航列 160px(20×8),内容列内边距 24px,字段间距 16px;弹窗圆角随
--radius→ 16.8px(dialog.tsx用rounded-xl),与参考「卡片 16px」对齐(现状 18px)。 - 状态色:未保存变更
Badge variant="secondary";只读权限项文字--muted-foreground;成员角色 chipBadge variant="outline";危险区标题--destructive。
S8 应用中心(app-center.tsx、assistant-board.tsx)
现状:分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」+ 卡片(运行中 / 开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息)。
改后:
- ② 组件:分类筛选
Tabs variant="line"(替掉自绘 chips);排序/视图切换ButtonGroup+Button variant="outline" size="sm";运行中→Badge variant="default"(绿)、开发中→Badge variant="secondary";emoji 图标换成Avatar+AvatarFallback取应用名首字(这是当前最明显的视觉一致性缺口;Avatar底色走--muted/--muted-foreground,深色自动翻转,替掉 5 组硬编码 50/700 头像底色)。 - ① 令牌:整面不再出现
rgb(37,99,235)(实测 15 处)与emerald/amber原色;彩色只剩运行中的绿徽标。 - ③ 布局:卡片网格 4 列 × 288px,gap 12px,
Card data-[size=sm];「共 14 个应用」12px +tabular-nums对齐搜索框右侧。 - 密度:卡片标题 14px/500,元信息 12px,图标 32px(
Avatar size官方档)。
S6 语音频道(本栈不可见,仅代码与库内数据依据)
依据是代码,不是截图:TRTC_ENABLED=false,本机界面一个语音元素都不渲染(DOM 内 aria-label 匹配「语音|通话|加入」命中 0,正文不含「语音」),/api/v1/rtc/* 返回 RTC_DISABLED;库内 wanman3_rtc_voice_channels 有 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行。因此本方案只对 web/src/components/app/rtc-group-call-ui.tsx 做令牌级预留:通话面板面 = --card/--popover,当前发言人 = --brand(绿=正在发声),成员静音/网络状态 = S1 的连接态徽标映射,通话时长 = font-mono + tabular-nums。不做任何截图断言。
深浅色与对比度
比值按 WCAG 相对亮度公式自算(0.2126R+0.7152G+0.0722B,sRGB 线性化)。达标线:正文 4.5:1、大字/图形与边界 3:1。
浅色
| 组合 | 前景 hex | 背景 hex | 比值 | 达标 |
|---|---|---|---|---|
| 正文 / 画布 | #121212 |
#f4f5f4 |
17.14:1 | ✅ |
| 正文 / 卡片、侧栏 | #121212 |
#ffffff |
18.73:1 | ✅ |
| 次级文字 / 卡片 | #6b6b6b |
#ffffff |
5.33:1 | ✅ |
| 次级文字 / 画布 | #6b6b6b |
#f4f5f4 |
4.88:1 | ✅ |
次级文字 / 悬停面 --accent |
#6b6b6b |
#ecedec |
4.54:1 | ✅ |
| 他人消息正文 / 气泡 | #121212 |
#ecedec |
15.96:1 | ✅ |
| 自己消息正文 / 气泡 | #0b3a26 |
#e6f6ee |
11.40:1 | ✅ |
| @提及 / 自己气泡 | #067647 |
#e6f6ee |
5.09:1 | ✅ |
| @提及 / 卡片 | #067647 |
#ffffff |
5.69:1 | ✅ |
| 主按钮文字 / 品牌绿 | #ffffff |
#006239 |
7.48:1 | ✅ |
| 品牌墨字 / 品牌洗色 | #006239 |
#e0ece7 |
6.17:1 | ✅ |
| 品牌墨字 / 画布 | #006239 |
#f4f5f4 |
6.85:1 | ✅ |
| 危险文字 / 卡片 | #c92a2f |
#ffffff |
5.45:1 | ✅ |
危险文字 / 危险徽标底(/10) |
#c92a2f |
#faeaea |
4.67:1 | ✅ |
| 频道图标(图形) | #8a8a8a |
#ffffff |
3.45:1 | ✅ |
| 交互性图标(图形) | #4d4d4d |
#ffffff |
8.45:1 | ✅ |
控件边界 --input(非文本) |
#8f8f8f |
#ffffff |
3.23:1 | ✅ |
装饰分隔线 --border |
#e0e2e1 |
#ffffff |
1.30:1 | ❌ 见风险 R3 |
深色
| 组合 | 前景 hex | 背景 hex | 比值 | 达标 |
|---|---|---|---|---|
| 正文 / 画布 | #fafafa |
#121212 |
17.95:1 | ✅ |
| 正文 / 卡片、侧栏 | #fafafa |
#1b1b1b |
16.50:1 | ✅ |
| 正文 / 弹层、悬停面 | #fafafa |
#242424 |
14.87:1 | ✅ |
| 次级文字 / 画布 | #8f8f8f |
#121212 |
5.79:1 | ✅ |
| 次级文字 / 卡片 | #8f8f8f |
#1b1b1b |
5.33:1 | ✅ |
| 次级文字 / 悬停面 | #8f8f8f |
#242424 |
4.80:1 | ✅ |
| 他人消息正文 / 气泡 | #fafafa |
#242424 |
14.87:1 | ✅ |
| 自己消息正文 / 气泡 | #dff6e9 |
#0f3a27 |
12.16:1 | ✅ |
| 主按钮文字 / 荧光绿 | #0d1a14 |
#3ecf8e |
8.95:1 | ✅ |
| 品牌墨字 / 画布 | #3ecf8e |
#121212 |
9.39:1 | ✅ |
| 品牌墨字 / 选中洗色复合底 | #3ecf8e |
#182c23 |
7.48:1 | ✅ |
| @提及 / 画布 | #00c573 |
#121212 |
8.24:1 | ✅ |
| 危险文字 / 画布 | #ff6369 |
#121212 |
6.46:1 | ✅ |
危险文字 / 危险徽标底(/20) |
#ff6369 |
#412223 |
4.90:1 | ✅ |
| 频道图标(图形) | #6b6b6b |
#121212 |
3.52:1 | ✅ |
| 交互性图标(图形) | #a3a3a3 |
#121212 |
7.43:1 | ✅ |
控件边界 --input(非文本) |
#666666 |
#121212 |
3.26:1 | ✅ |
装饰分隔线 --border |
#2e2e2e |
#121212 |
1.38:1 | ❌ 见风险 R3 |
深色可达性提醒:实测「往 <html> 加 .dark」能让 --background 从 #fcfcfc 变 oklch(0.145 0 0),但全仓 web/src 无任何代码添加 .dark、localStorage 无主题键、<html> class 恒空、color-scheme: normal → 深色主题在生产不可达(简报 §3.3)。本方案的深色令牌齐备且全部达标,但上线前必须接线(见风险 R4)。
shadcn 兼容性
结论:可以只用官方组件与官方 variant/size 达成。 本方案不新增任何自定义变体、不写 className 覆盖组件颜色/字号/字重/行高/尺寸/圆角/边框/阴影/内边距/状态样式/动效,也不用内联 style。改动 100% 落在 ①语义令牌取值、②官方 variant/size 选择、③容器 flex/grid 布局与间距滚动。
用到的组件(38 个已装组件内,无需新增):Button(+ButtonGroup)、Badge、Card、Input、Textarea、Tabs、Avatar、Separator、Dialog、AlertDialog、Checkbox、Field、FieldSelect、Select、Item、ItemGroup、ScrollArea、ScrollRegion、ScrollSurface、Skeleton、Collapsible、DropdownMenu、Tooltip、Table、Bubble/BubbleContent、Message/MessageScroller、Calendar、ContextMenu、Popover、RadioGroup、Accordion、FloatingLayer、InputGroup。
必须显式标注的不合规 / 未达标项:
| 编号 | 问题 | 说明 | 缓解 |
|---|---|---|---|
| R1 | 参考的胶囊按钮(radius 9999px)不可达成 | button.tsx 基类固定 rounded-lg(= var(--radius)),改胶囊必须写 className → 违反硬约束 1 |
按钮保持 12px 圆角;胶囊语义只由 Badge(rounded-4xl,天然胶囊)承担;按钮层级改由 size(xs/sm/default/lg)表达 |
| R2 | 参考的「绝不用阴影」只能部分执行 | --shadow-e1..e3/--shadow-pop、card.tsx/dialog.tsx 的 ring-1 ring-foreground/10 是既有组件层行为,改它们会波及其它 250 个文件 |
阴影令牌不动;深色下改为「表面明度差 + --border/--sidebar-border 描边」表达层级,阴影在近黑画布上本就几乎不可见 |
| R3 | 装饰分隔线未达 3:1 | --border 浅 1.30:1 / 深 1.38:1(参考 Charcoal 原值) |
本方案把「控件可识别边界」单独拆到 --input(浅 3.23:1 / 深 3.26:1,达标);分隔线属 WCAG 1.4.11 豁免的纯装饰,且不承担唯一识别职责(面板层级差 + 描边 + 绿色 focus ring 9.39:1 共同承担)。如果评审要求分隔线也必须 3:1,需要把 --border 提到 #949494(浅) / #5f5f5f(深) —— 这会显著改变观感,且与参考的 hairline 语言冲突,故本方案不采用,列为风险 |
| R4 | 深色主题在生产不可达 | 实测全仓无 .dark 写入点、无主题持久化、<html> class 恒空 |
令牌层已就绪;接线(ThemeProvider + localStorage + 读写 document.documentElement.classList)属于实施步骤,不在本方案令牌范围内,需单独立项 |
| R5 | 令牌只保证「经由令牌的颜色」翻转 | 实测硬编码:Tailwind 原色板 253 处 / 44 个非测试文件(amber 69、rose 68、slate 44、emerald 42…)、头像 50/700 配对、#006ce7(message-list.tsx、composer-markdown.ts、voice-channel-history-dialog.tsx)、chat-mention.ts 硬编码 #3370FF、chrome.ts #f06f66、tone.ts #23a55a/#f0b232、styles.css 内 158 处 --* 声明/116 个唯一令牌名与重复字面量 |
注入 .dark 后实测仍有 rgb(6,6,7) 55 处、rgb(92,94,102) 27 处、边框 rgb(220,222,225) 6 处在深色下不翻转。必须逐文件替换成语义令牌,否则深色仍是半可读状态;这是本方案的前置依赖,列为 P0 |
| R6 | 参考的全域负字距 -0.007em 舍弃 |
无官方工具类,且与中文(Noto Sans SC / PingFang SC)可读性冲突 | 不做;中文收益为负 |
| R7 | 登录页主按钮 52px → 36px | 官方 Button 最大档 size="lg" = h-9(36px),52px 无官方档位 |
按钮满内容宽(356px)+ 卡片 400px/24px 留白补偿;若评审坚持 52px,则属「不得不自定义样式」→ 显式不合规 |
实施成本
改动面(按文件):
| 层次 | 文件 | 内容 | 人时 |
|---|---|---|---|
| P0 令牌 | web/src/styles.css(:root 45 行 + .dark 36 行 + @theme inline 仅 --radius 相关注释) |
用 tokens.css 整体替换 |
2h |
| P0 深色接线 | web/src/main.tsx / 根布局 + 1 个 useTheme hook |
读写 <html>.dark + localStorage + color-scheme |
4h |
| P0 令牌泄漏清扫 | 44 个非测试文件、253 处 Tailwind 原色 + 头像 50/700 配对 + 3 种蓝 + chrome.ts/tone.ts/file-preview/* |
替换为语义令牌 | 16h(可分批) |
| P1 必含面 | message-list.tsx(字号统一/气泡/提及)、channel-sidebar.tsx(选中态/未读徽标)、task-hall.tsx(状态 Badge 映射/圆角)、login.tsx(Tabs/按钮/字号) |
②③ 类改动 | 6h |
| P2 其余面 | agent-chat-panel.tsx(字号收口)、app-center.tsx(emoji→Avatar、筛选 Tabs)、space-manage-dialog.tsx + channel-settings-dialog.tsx(Tabs vertical/AlertDialog)、group-hall.tsx(删 hero) |
②③ 类改动 | 8h |
| P2 回归 | 深浅两套逐面走查 + 对比度脚本 | 见下 | 4h |
合计约 40 人时;P0(令牌 + 深色接线 + 泄漏清扫)24h,P1 6h,P2+P3 12h。
风险清单:
- 深色不可达(R4)——令牌改完看不到效果;必须先接线再验收。
- 令牌泄漏史(R5)——253 处原色板不随令牌翻转,深色下
rgb(6,6,7)55 处近乎不可读。 - 全局调
--radius是牵一发动全身:--radius同时驱动sm/md/lg/xl/2xl/3xl/4xl,改 10→12px 会让所有rounded-*统一升一档;需按 S1/S3/S5 三面抽样确认没有溢出(圆角大于元素高度一半会被裁成胶囊,Badge的rounded-4xl已预期为胶囊,属正确表现)。 - 按钮高度取舍(R7)——登录页主按钮变矮,需要产品确认。
- 深绿主色在浅色的观感风险:
#006239是参考最深的绿,用于浅底主按钮偏「森林绿」;若评审要更亮的绿,浅色备选#0f7a4f(白字 5.36:1,仍达标),但会牺牲 2.1 个对比度点。
验证方式(能证明改动生效的检查):
getComputedStyle(document.documentElement).getPropertyValue('--background')→ 浅色#f4f5f4,<html>加.dark后#121212。- 深色下遍历 DOM,
getComputedStyle统计颜色频次:rgb(6,6,7)与rgb(252,252,252)命中数应为 0(现状 55 处 / 33 处),出现任一即 R5 未清完。 - 深色下扫描全 DOM 前景色,彩色(色相非灰、非绿 150±40°)命中数应为 0 —— 这是「一种彩色」纪律的可执行断言。
- 用 §7 的 36 组值跑 WCAG 公式脚本,全部 ≥4.5(文字)/ ≥3(图形与
--input边界)。 - 单视图字号档位普查应只剩
{12, 13, 14, 15, 16, 24}px;现状的 9 / 9.375 / 11 / 11.25 / 12.8 / 13.125 / 26 px 全部消失。 - 圆角普查应只剩
{9.6, 12, 16.8, 31.2, 9999}px 量级;现状 2/6/7/8/10/12/14/18/24/26/32px 混用消失。 grep -rE '#(2563eb|006ce7|3370FF|1d4ed8)' web/src应为 0 命中。
取舍
解决了什么:
- 修掉两个可复算的实缺陷:① 会话侧栏背景与页面底色完全相同(
#fcfcfc=#fcfcfc,零层级)→ 侧栏变成白色/#1b1b1b面板 + 1px 描边;② 深色--surface-rail:#e3e5e8会在深色下变成浅色竖带 → 改#171717。 - 把「彩色」变成可检查的规则:整屏只允许一种绿(
#3ecf8e/#006239),进行中任务、当前频道、@我、AI 运行中四种信号共用它,其余全部灰阶。深色下「非灰非绿命中 0」是可执行的验收断言,直接消灭三种蓝并存与 253 处原色板泄漏。 - 统一两个体系缺口:字号从 9→26px 的 10 档 em 派生收敛到 6 档;圆角从 12 档收敛到 4 档(其中 1 档是
Badge胶囊)。 - 文字对比度全面上调:全部正文组合 ≥4.5:1(含次级文字在悬停面上的 4.54:1 / 4.80:1 边角情况),
--input边界达 3.2:1。
牺牲了什么:
- 参考的胶囊按钮(R1)——shadcn
Button硬编码rounded-lg,只能放弃,改用Badge承担胶囊语义。观感上比参考「更方一点」。 - 参考的绝对无阴影(R2)——阴影令牌保留,深色下靠层级与描边抵消,浅色下卡片仍有
ring-1 ring-foreground/10。 - 参考的 hairline 分隔线在三档浅色画布上的锐利度——
--border1.3:1 是风险项(R3),换成达标的灰会让界面变成线框图。 - 登录页主按钮高度(R7):52px → 36px,是官方 size 档位的硬上限。
- 浅色主色偏暗:
#006239换来了 7.48:1 的白字对比,代价是比原#2563eb更「沉」;这是深色优先(荧光绿为主)方案的必然结果,浅色只是镜像。 - 深色优先意味着浅色不是「精致打磨过的一等公民」——浅色令牌是从参考的深色阶梯做亮度镜像推导出来的,视觉密度与深色不完全等价。
什么场景下不适用:
- 如果产品把深色主题当作可选皮肤而不是主设计面(比如要求浅色为默认、深色只是夜间模式),这套方案会把资源错配在深色上,应改选浅色优先方案。
- 如果评审硬性要求分隔线也达 3:1 非文本对比,本方案的 hairline 语言会失守(要么变线框图,要么方案不成立)。
- 如果不允许为深色接线(不能改
main.tsx/根布局),深色令牌再好也用不上,只剩浅色那一半价值。 - 如果目标用户群以户外强光/高亮屏为主(生产一线场景需要高亮浅底),深色画布会增加反光下的可读成本——这种情况下浅色优先 + 深绿强调更合适。