碳黑荧光绿 — 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 网格而不是装饰。

参考提炼

参考风格名 Supabase,slug supabase,来源站点 supabase.com,theme = dark。原文四句核心(可直接追溯到 supabase.design.md):

  1. 「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 运行中状态。
  2. 「Obsidian Canvas #121212 — Page background」/「Ash Card #242424 — Nested or elevated card surfaces」/「Charcoal Border #2e2e2e」。 可迁移规则:三层表面 + 一枚描边,层级用明度差和 1px 边框表达。→ 深色令牌阶梯 #121212 → #171717(rail) → #1b1b1b(卡片/侧栏) → #242424(弹层/悬停),边框 #2e2e2e。
  3. 「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 的风险说明。
  4. 「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 —— 这些是营销页排版,本产品是长驻留的高密度工作台,没有滚动叙事。

适配判断

为什么这套语言适合「任务 + 频道消息」:

舍弃项(明确不做):

舍弃 原因
胶囊按钮(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

字重纪律:只用 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

中文与数字注意点:

  1. 中文最小 12px,禁止 em 派生小数字号。实测档位里 11.25 / 12.8 / 13.125 / 9.375px 全部来自以 15px 为基准的 em 计算(简报 §3.3);这些值在小数点上不可控,一律换成 text-xs(12px) / text-sm(14px)。
  2. 中文不加负字距。参考的 -0.007em 全域负字距舍弃:汉字在负字距下笔画相撞,且没有官方工具类可表达。
  3. 数字必须等宽:任务编号、未读数、已读人数、时间戳、共 14 个应用 用 tabular-nums(+ font-mono 用于代码/ID),否则列表里数字跳动。
  4. 中西混排基线:WanChat、WanWork、WanNote、@agent 走 Geist,紧邻中文走 Noto Sans SC;不要对中文块用 uppercase/tracking-*。
  5. 行高下限 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。

改后:

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 人未读)。

改后:

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 处。

改后:

S7 登录页(web/src/routes/login.tsx、sign-in.$.tsx)

现状:居中卡片,主标题 26px;「邮箱验证码 / 短信验证码」切换块 173×42(选中态背景 --background #fcfcfc + 品牌蓝文字);主按钮 356×52、白字 #2563eb;页脚 11px。文案:「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」。

改后:

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);含流式回答、来源引用、结果卡片。

改后:

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。

改后:

S8 应用中心(app-center.tsx、assistant-board.tsx)

现状:分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」+ 卡片(运行中 / 开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息)。

改后:

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。

风险清单:

  1. 深色不可达(R4)——令牌改完看不到效果;必须先接线再验收。
  2. 令牌泄漏史(R5)——253 处原色板不随令牌翻转,深色下 rgb(6,6,7) 55 处近乎不可读。
  3. 全局调 --radius 是牵一发动全身:--radius 同时驱动 sm/md/lg/xl/2xl/3xl/4xl,改 10→12px 会让所有 rounded-* 统一升一档;需按 S1/S3/S5 三面抽样确认没有溢出(圆角大于元素高度一半会被裁成胶囊,Badge 的 rounded-4xl 已预期为胶囊,属正确表现)。
  4. 按钮高度取舍(R7)——登录页主按钮变矮,需要产品确认。
  5. 深绿主色在浅色的观感风险:#006239 是参考最深的绿,用于浅底主按钮偏「森林绿」;若评审要更亮的绿,浅色备选 #0f7a4f(白字 5.36:1,仍达标),但会牺牲 2.1 个对比度点。

验证方式(能证明改动生效的检查):

  1. getComputedStyle(document.documentElement).getPropertyValue('--background') → 浅色 #f4f5f4,<html> 加 .dark 后 #121212。
  2. 深色下遍历 DOM,getComputedStyle 统计颜色频次:rgb(6,6,7) 与 rgb(252,252,252) 命中数应为 0(现状 55 处 / 33 处),出现任一即 R5 未清完。
  3. 深色下扫描全 DOM 前景色,彩色(色相非灰、非绿 150±40°)命中数应为 0 —— 这是「一种彩色」纪律的可执行断言。
  4. 用 §7 的 36 组值跑 WCAG 公式脚本,全部 ≥4.5(文字)/ ≥3(图形与 --input 边界)。
  5. 单视图字号档位普查应只剩 {12, 13, 14, 15, 16, 24} px;现状的 9 / 9.375 / 11 / 11.25 / 12.8 / 13.125 / 26 px 全部消失。
  6. 圆角普查应只剩 {9.6, 12, 16.8, 31.2, 9999} px 量级;现状 2/6/7/8/10/12/14/18/24/26/32px 混用消失。
  7. grep -rE '#(2563eb|006ce7|3370FF|1d4ed8)' web/src 应为 0 命中。

取舍

解决了什么:

  1. 修掉两个可复算的实缺陷:① 会话侧栏背景与页面底色完全相同(#fcfcfc = #fcfcfc,零层级)→ 侧栏变成白色/#1b1b1b 面板 + 1px 描边;② 深色 --surface-rail:#e3e5e8 会在深色下变成浅色竖带 → 改 #171717。
  2. 把「彩色」变成可检查的规则:整屏只允许一种绿(#3ecf8e/#006239),进行中任务、当前频道、@我、AI 运行中四种信号共用它,其余全部灰阶。深色下「非灰非绿命中 0」是可执行的验收断言,直接消灭三种蓝并存与 253 处原色板泄漏。
  3. 统一两个体系缺口:字号从 9→26px 的 10 档 em 派生收敛到 6 档;圆角从 12 档收敛到 4 档(其中 1 档是 Badge 胶囊)。
  4. 文字对比度全面上调:全部正文组合 ≥4.5:1(含次级文字在悬停面上的 4.54:1 / 4.80:1 边角情况),--input 边界达 3.2:1。

牺牲了什么:

  1. 参考的胶囊按钮(R1)——shadcn Button 硬编码 rounded-lg,只能放弃,改用 Badge 承担胶囊语义。观感上比参考「更方一点」。
  2. 参考的绝对无阴影(R2)——阴影令牌保留,深色下靠层级与描边抵消,浅色下卡片仍有 ring-1 ring-foreground/10。
  3. 参考的 hairline 分隔线在三档浅色画布上的锐利度——--border 1.3:1 是风险项(R3),换成达标的灰会让界面变成线框图。
  4. 登录页主按钮高度(R7):52px → 36px,是官方 size 档位的硬上限。
  5. 浅色主色偏暗:#006239 换来了 7.48:1 的白字对比,代价是比原 #2563eb 更「沉」;这是深色优先(荧光绿为主)方案的必然结果,浅色只是镜像。
  6. 深色优先意味着浅色不是「精致打磨过的一等公民」——浅色令牌是从参考的深色阶梯做亮度镜像推导出来的,视觉密度与深色不完全等价。

什么场景下不适用: