单色底盘 · figma

方案名与主张

方案名:单色底盘(Monochrome Chassis)

主张(一句话):让界面先「无色」——全部结构退成白纸 / 中性灰画布 / 墨色轨道三层灰阶,全站只留一个色相 #4d49fc 用在「可操作的点」和「本人消息」上;这样任务卡里的状态、消息流里的内容、头像与图表里的颜色,就是画面上唯一有彩度的东西。

适用基调:双主题对等、浅色优先(浅色是主推形态,深色是同结构等值映射,不是「黑化版」)。

与其他 19 个方案的可比口径:本方案的改动全部落在语义令牌取值上(web/src/styles.css 的 :root 与 .dark 两个变量块,行 108–210),不新增组件、不新增自定义 variant、不动任何 className;因此「令牌文件改了多少、组件层还要花多少人时」是可直接横向比较的两个数(见「实施成本」)。


参考提炼

从参考里提炼出 5 条可迁移规则(都是本方案实际执行的动作,不是风格形容词):

  1. 无色骨架承载彩色内容。 参考用手写体签名式的克制:结构面只有 #ffffff、#000000、#e2e2e2 三档灰,色相被明确限定为「内容自己的颜色」——原文把 #24cb71 / #00b6ff / #ff7237 这类色只留给 artwork 与头像渲染,不用在装饰面或边框上。→ 本方案把 /app 的 44 文件 / 253 处 Tailwind 原始调色板(rose/amber/slate/emerald/teal/blue…)视为内容而不是界面色,界面本身只保留一条灰阶骨架。
  2. 正文不吃稀释灰。 参考对正文用纯 #000000,#595959 只做元信息(它的原话是不要把正文用 #595959 稀释掉)。→ 本方案 --foreground: #000000(21:1),把「轻」交给 --muted-foreground: #595959(7.0:1);现状 #060607 + #5c5e66 两个近黑灰其实没有分开「正文 / 元信息」的职能。
  3. 边界靠一条发丝线,不靠灰底。 参考把 #e2e2e2 的 1px boundary frame 当作结构语言,阴影属于 Z 轴(浮层才用),不是基线装饰。→ 本方案把唯一边界令牌 --border 提到 #949494(白底 3.03:1,刚过 WCAG 1.4.11 的 3:1),再用 bg-border/45、border-border/55 这类 alpha 分级让分隔线自动变轻,形成「同一墨线的轻重阶梯」,而不是再造几档灰。
  4. 一个 interruptive accent,只出现在面板内的焦点操作上。 参考的 #4d49fc 只给「面板内需要打断视线的那一个操作」,不用于全局页头、不做大面积底色。→ 本方案 --brand: #4d49fc 的使用面被收成四类:主按钮、焦点环、选中行、链接/@提及;--workspace-header-background 从深色下带品牌色的渐变改回纯纸面,正是执行这一条。
  5. 圆角由一个基准缩放。 参考的圆角资产是 4 / 6.4 / 8 / 11.2 / 14.4 / 17.6 / 20.8px 的等比链(它自己的 50px pill 与 0px 内容卡是另一支),上下文按钮统一 8px。→ 本方案把 --radius 从 0.625rem 收到 0.5rem,让 rounded-lg(按钮/输入)正好落在参考的 8px 上;不做它的 50px pill / 0px 二分圆角(原因见「适配判断」舍弃项)。

适配判断

为什么这套语言适合「任务 + 频道消息」的企业工具:

明确舍弃的参考项:

参考项 舍弃原因
50px pill 圆角(按钮/标签一律胶囊) shadcn 的圆角全部由单一 --radius 缩放链派生,无法同时输出「胶囊」与「0px 内容卡」两套;坚持胶囊会让 Dialog/Card/Input 一起变胶囊,弹窗与输入框立刻失形
0px 直角内容卡 与上一条同源;且 /app 的容器嵌套(轨道 → 侧栏 → 消息流 → 气泡/卡片)需要圆角来分层层级,全直角会让卡片与画布灰度混成一块
72px display 字号 / −1.44px 负字距 /app 是工作台,最大真实标题只有频道标题 16px/600;引入 display 档在应用内没有任何落点
16–18px 正文 实测 body 已是 15px/1.375,中文 15px 在 256px 宽的会话列表里已接近换行临界;字号阶梯调整落在组件层(见「字体与排版」),本次不定
96–120px macro-whitespace 与任务大厅的 4 列网格、消息流的连续性直接冲突;间距只能来自容器 gap,不来自令牌
hero 式大图/艺术化分栏 属于 landing,blueprint 网格 @utility 只被 components/landing/* 使用,不进 /app

令牌映射

改动面只有一处:web/src/styles.css 的 :root(行 108–160)与 .dark(行 162–210)两个变量块,逐值替换为 docs/design-proposals/figma/tokens.css。不新增变量名(除深色补齐 --interactive / --channel-icon / --sidebar-ring 这三个 :root 已有、.dark 漏掉的),@theme inline 映射行沿用原文。

4.1 浅色 :root(当前 → 建议)

变量名 当前值 建议值 意图
--background #fcfcfc #ffffff 纸面回纯白:内容区(会话列表 / 消息流 / 任务卡)统一落在 #ffffff,层次交给发丝线,实测现状 #fcfcfc 与 --card #ffffff 只差 1.03:1,等于没有纸面
--foreground #060607 #000000 正文用绝对墨(21:1),不做「稀释灰正文」;#060607 这种近黑灰既没到纯墨也没省下对比度预算
--card #ffffff #ffffff 不变;任务卡/弹窗在灰画布上作为「白纸」出现
--card-foreground #060607 #000000 同上(21:1)
--popover #ffffff #ffffff 不变
--popover-foreground #060607 #000000 同上
--message-self #e8f3fe #eeecff 本人气泡改淡紫(与 --brand 同族)而不是淡蓝——理由见「shadcn 兼容性」第 6 条(--surface-chat-soft / 引用条仍是全局令牌,气泡若走墨黑块会把引用文字压成 1:1 不可读)
--message-self-foreground #0d274a #1e1a63 墨紫正文,对 #eeecff 实算 13.07:1(现状 13.29:1,等值)
--primary var(--brand) var(--brand) 不变,随 --brand 迁移到新的唯一强调色
--primary-foreground var(--brand-foreground) var(--brand-foreground) 同上
--secondary #ebedef #ededed 他人气泡 / 次级按钮 / 侧栏搜索框底(bg-secondary/75)三用,必须停在「白底上刚好看得见」的浅灰:1.17:1;去掉蓝味
--secondary-foreground #060607 #000000 17.94:1
--muted #f2f3f5 #e6e6e6 外壳画布 + hover 填充 + Tabs 底:对纸面 1.25:1(现状 1.08:1,实测零层级);这是本方案层级梯度的中间层
--muted-foreground #5c5e66 #595959 次级文字:白底 7.0:1、画布灰上 5.61:1、他人气泡上 5.98:1,且完全中性
--accent #ebedef #ededed 菜单/hover 选中底,与 --secondary 同值(shadcn 语义两用,不必造第三档灰)
--accent-foreground #060607 #000000 17.94:1
--destructive #da373c #c4212c 语义红收紧:它作正文对白底 5.83:1(现状 4.57:1,刚过线),白字对它同为 5.83:1(未读徽标 bg-destructive + 白字)
--border #dcdee1 #949494 唯一边界线:border-border 全仓 158 处、variant="outline" 按钮 62 处都只有这一条线,必须可辨识 → 取「刚过 3:1 的最浅值」3.03:1(现状 1.31:1);分隔线走 bg-border/45(合成 #cfcfcf,1.56:1)自行变轻
--input #dcdee1 #767676 控件边界(Input / Checkbox / Radio / Select)比结构线深一档:白底 4.54:1
--ring var(--brand) var(--brand) 不变;焦点环用官方默认,只换色相
--brand #2563eb #4d49fc 唯一强调色(参考的 Context Action Violet);白字对它 5.72:1;同时消灭全站第三个蓝(硬编码 #006ce7)与第四个蓝(--mention #3370ff),见下
--brand-foreground #ffffff #ffffff 不变(5.72:1)
--brand-soft rgb(37 99 235 / 0.12) rgb(77 73 252 / 0.10) 品牌浅底(弹窗选中项、登录页块):合成 #ededff,配 --brand-ink 7.12:1、配 --brand 自身 4.94:1
--brand-ink #1d4ed8 #3b34cc 选中行文字:对 --surface-chat-selected #eeecff 7.09:1(现状 5.66:1)
--surface-chat-soft #e8f2ff #f4f3ff 回复/引用类浅底:同色族淡紫,与 --mention 5.2:1、与 --foreground 19.1:1
--surface-chat-selected #e5ecfc #eeecff 会话/频道选中行:淡紫底 + --brand-ink 文字 + .sidebar-selection::before 的 2px --brand 左条(styles.css 425–445),三处同族同源
--mention #3370ff #4d49fc @提及直接用强调色:他人气泡 4.88:1、本人气泡 4.92:1(现状 #3370ff 在他人气泡上仅 3.65:1,不合规)
--ink #060607 #000000 与 --foreground 对齐
--surface-rail #e1e8f2 #000000 空间轨道改墨色:与纸面 21:1、与画布灰 16.52:1;现状轨道基本透明,71×48 图标块与底面几乎不可分(简报 §3.3 原话)
--workspace-background linear-gradient(180deg, var(--surface-rail), #e1e5f1) linear-gradient(180deg, #efefef, #e4e4e4) 外壳画布去蓝灰、去硬编码 #e1e5f1:中性灰对上沿 1.15:1、对下沿 1.27:1(对纸面)
--workspace-rail-background transparent var(--surface-rail) 原文透明 → 轨道没有自己的面;改为跟随墨色轨道面,.workspace-rail-surface(styles.css 1013)立刻有底
--workspace-header-background var(--background) var(--background) 意图显式化:顶栏与纸面同色(深色下才需要改,见 4.2)
--interactive #4e5058 #4f4f4f 轨道/侧栏图标色去蓝味:在墨轨的 #d9d9d9 图标块上 5.8:1(现状 #4e5058 对 #e1e8f2 6.52:1,但那是浅色轨道)
--channel-icon #80848e #6e6e6e 同一变量还兼作占位符色(placeholder:text-channel-icon):白底 5.1:1(现状 3.74:1,不够正文下限)
--sidebar #fcfcfc #ffffff 侧栏与纸面同色(--sidebar* 在 /app tsx 中零引用,此处只做语义对齐,不改观感)
--sidebar-foreground #060607 #000000 21:1
--sidebar-primary / --sidebar-primary-foreground / --sidebar-ring var(--brand) / var(--brand-foreground) / var(--ring) 同左 不变,随 --brand 迁移
--sidebar-accent / --sidebar-accent-foreground #ebedef / #060607 #ededed / #000000 与 --secondary 对齐
--sidebar-border #dcdee1 #949494 与 --border 对齐(3.03:1)
--chart-1 oklch(0.87 0 0) #4d49fc 图表改「单色阶梯 + 一个焦点色」:--chart-1 给焦点系列(强调色),其余四档是墨到浅灰的阶梯,5 档全部 ≥3:1
--chart-2 oklch(0.556 0 0) #000000 21:1
--chart-3 oklch(0.439 0 0) #595959 7.0:1
--chart-4 oklch(0.371 0 0) #767676 4.54:1
--chart-5 oklch(0.269 0 0) #949494 3.03:1(现状 --chart-5 反向最深,与新阶梯的明度顺序相反)
--radius 0.625rem 0.5rem 圆角基准 10px → 8px:--radius-lg(按钮/输入)= 8px,正好是参考的上下文按钮 8px;面板 xl=11.2、弹窗/卡 2xl=14.4、徽标 4xl=20.8

4.2 深色 .dark(当前 → 建议)

变量名 当前值 建议值 意图
--surface-rail #e3e5e8 #000000 现状是浅色值:深色主题下会留一条浅色竖带;改为与浅色同构的墨轨
--workspace-background radial-gradient(… color-mix(in oklab, var(--brand) 10%, var(--muted)) …) linear-gradient(180deg, #0b0b0b, #050505) 去掉带品牌色的径向渐变(强调色只留在可操作点):画布压到 #050505,与纸面 1.18:1 的可见台阶
--workspace-rail-background color-mix(in oklab, var(--background) 45%, transparent) var(--surface-rail) 与浅色同构,轨道有确定的面
--workspace-header-background linear-gradient(180deg, color-mix(in oklab, var(--background), var(--brand) 3%), var(--background)) var(--background) 顶栏回纯纸面,去掉 3% 品牌色
--message-self #203b59 #332e78 本人气泡=深紫块(与浅色淡紫同族、方向相反)
--message-self-foreground #e7f3ff #eae8ff 对 #332e78 实算 9.7:1
--background oklch(0.145 0 0) #1b1b1b 纸面略微提亮并把灰阶从 oklch 换成 sRGB:与墨轨(#000000)保持 1.22:1 的台阶,同时留出画布更暗的余量
--foreground oklch(0.985 0 0) #ffffff 17.22:1
--card / --card-foreground oklch(0.205 0 0) / oklch(0.985 0 0) #1b1b1b / #ffffff 卡=纸面(层级交给 ring-foreground/10),不再靠「卡比底亮一档」
--popover / --popover-foreground oklch(0.205 0 0) / oklch(0.985 0 0) #242424 / #ffffff 浮层比纸面亮 1.11:1 + 组件自带发丝环,Z 轴层级明确
--secondary / --secondary-foreground oklch(0.269 0 0) / oklch(0.985 0 0) #2e2e2e / #ffffff 他人气泡对纸面 1.27:1(现状 0.269 灰阶对 0.145 约 1.2:1),文字 13.58:1
--muted oklch(0.269 0 0) #252525 hover 填充/容器底,对纸面 1.12:1(与浅色 --muted 的墨感强度同量级)
--muted-foreground oklch(0.708 0 0) #ababab 次级文字:纸面 7.5:1、气泡 5.91:1、浮层 6.76:1、本人气泡 5.07:1
--accent / --accent-foreground oklch(0.269 0 0) / oklch(0.985 0 0) #2e2e2e / #ffffff 菜单选中底,与 --secondary 对齐
--destructive oklch(0.704 0.191 22.216) #ff8a80 深色下危险色偏亮:对纸面 7.55:1;代价:白字压在它上面只有 2.28:1(见「shadcn 兼容性」第 3 条)
--border oklch(1 0 0 / 10%) #707070 现状是 10% 白 alpha 线(合成 #222222,对原文纸面 oklch(0.145 0 0)≈#0a0a0a 仅 1.24:1),等于无形;改为「刚过 3:1 的最浅值」:对纸面 3.48:1、对浮层 3.13:1
--input oklch(1 0 0 / 15%) #868686 控件边界:对纸面 4.73:1;它同时是 dark:bg-input/30 的填充源(合成 #3b3b3b)
--brand oklch(0.68 0.15 256) #8f8cff 提亮到 6.04:1(作正文/图标),并锁定为参考 #4d49fc 的同族补色
--brand-foreground oklch(0.16 0.02 258) #14123a 深紫字压在 #8f8cff 上 6.25:1
--brand-soft oklch(0.28 0.05 256) rgb(143 140 255 / 0.14) 合成 #2b2b3b:配 --brand-ink 7.2:1、配 --brand 4.87:1
--brand-ink oklch(0.84 0.09 256) #b6b3ff 对 --surface-chat-selected #2b2766 6.87:1
--surface-chat-soft oklch(0.32 0.06 250) #2b2766 与 --surface-chat-selected 同值(现状两者已近似,此处显式统一)
--surface-chat-selected oklch(0.28 0.04 250) #2b2766 选中行底
--mention oklch(0.72 0.14 254) #a5a2ff 他人气泡 5.96:1、本人气泡 5.11:1
--ink oklch(0.16 0.02 258) #000000 与墨轨同值,深色下 --ink 只用于轨道类表面
--interactive 未声明(继承浅色 #4e5058) #adadad 补齐:在轨道块 #171717 上 7.99:1;现状浅色值漏进深色,图标近乎不可读
--channel-icon 未声明(继承浅色 #80848e) #949494 补齐:对纸面 5.68:1(占位符文本用)
--sidebar / --sidebar-foreground oklch(0.205 0 0) / oklch(0.985 0 0) #1b1b1b / #ffffff 与纸面对齐
--sidebar-accent / --sidebar-accent-foreground oklch(0.269 0 0) / oklch(0.985 0 0) #2e2e2e / #ffffff 与 --secondary 对齐
--sidebar-border oklch(1 0 0 / 10%) #707070 与 --border 对齐
--sidebar-ring 未声明 var(--ring) 补齐(:root 已有,.dark 漏)
--chart-1 oklch(0.87 0 0) #a5a2ff 焦点系列(强调色),7.56:1
--chart-2 oklch(0.556 0 0) #ffffff 17.22:1
--chart-3 oklch(0.439 0 0) #ababab 7.5:1
--chart-4 oklch(0.371 0 0) #949494 5.68:1
--chart-5 oklch(0.269 0 0) #707070 3.48:1
--radius 继承 :root 继承 :root(0.5rem) 不重声明(与原文结构一致)
--primary / --primary-foreground / --ring / --sidebar-primary / --sidebar-primary-foreground 继承 :root(指向 var(--brand)) 同左 深色下通过 --brand / --brand-foreground 自动等值映射

字体与排版

字体栈(不改,沿用 styles.css:33-40):

--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;
--font-mono:
  ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;

字号 / 行高 / 字重阶梯(目标值 + 当前落点):

角色 字号 行高 字重 实现位置(本次是否可达)
标题 · 空间名 / 频道名 16px 1.35(21.6px) 600 组件类;实测现状已是 16px/600(与目标一致),令牌不可达
正文 · 消息正文 / 任务标题 15px 1.5(22.5px) 400 @layer base 的 body 已给 15px/1.375(20.63px);提到 1.5 需组件层,令牌不可达
次级 · 成员数 / 时间戳 / 元信息 13px 1.45 400 组件类(实测现状 12px/500 #5c5e66);令牌不可达
标签 · 状态徽标 / 按钮文字 13px 1.3 500 官方 Badge/Button 默认 text-xs(12px)+ medium;改 13px 属绕过官方尺寸,本方案不动
代码 · 任务 ID / 数字 / 版本 12px 1.4 400 + --font-mono 令牌可达(字体栈已存在),用 font-mono 类落在组件层
最小字号 12px — — 中文下限;实测登录页脚 11px、多处 text-[11px] 需在组件层抬回 12px

中文长文本与数字的注意点:

  1. --font-sans 首位的 "Geist Variable" 没有 CJK 字形,中文实际由 "Noto Sans SC" / "PingFang SC" 渲染;两套字形的 x-height 与字面宽不同,中英混排时不要用西文负字距做收字(参考里的 -1.44px tracking 属舍弃项),中文正文也不要加 tracking-tight。
  2. 中文正文行高比等值西文需要更多空气:15px × 1.375 = 20.63px 对短消息够用,但 AI 助手频道那种长段落(实测一次渲染 2765 个 12.8px 单元)应走 1.5;该项在组件层,本次只给目标值,不声称已达成。
  3. 数字与文字要有分工:任务数(395)、成员数(12)、耗时这类统计走 --font-mono + tabular-nums,避免比例数字在列表中跳动;实测现状同一视图混用 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26px(以 15px 为基准的 em 计算),说明字号缺少刻度——刻度统一是组件层整改项。
  4. 单色底盘下不要用字重代替颜色做层级:--foreground(正文)/ --muted-foreground(元信息)的分工必须固定,字重只在标题(600)与标签(500)两处出现。

关键界面改造

覆盖样例面:S1 外壳/侧栏、S2 频道消息流、S3 任务大厅+任务卡、S4 AI 助手频道、S5 管理设置弹窗、S7 登录页、S8 应用中心(7 面 ≥ 6 面要求),并附 S6 语音频道的代码依据说明(本机 TRTC_ENABLED=false,界面零语音元素,不截图、不伪造)。

每条末尾标注:途径(① 语义令牌取值 / ② 官方 variant·size / ③ 容器布局间距)与落地(本次 = 只改令牌即可生效;后续 = 需组件层改造,已列入「实施成本」)。

S1 外壳 + 侧栏(会话列表 / 空间轨道)

S2 频道消息流

S3 任务大厅 + 任务卡


S4 AI 助手频道(员工智能助手 WanTeams)

S5 管理设置弹窗(频道/空间设置)

S6 语音频道(代码依据说明,无截图)

S7 登录页

S8 应用中心


深浅色与对比度

以下比值全部用同一脚本实算:sRGB 分量 → 线性化(c/12.92 或 ((c+0.055)/1.055)^2.4)→ 相对亮度 L → (L_亮+0.05)/(L_暗+0.05);带 alpha 的令牌先按所在表面复合成不透明 hex 再算(合成值已写在表内)。判定口径:正文文字 ≥4.5:1,大字号(≥18.66px/600 或 ≥24px)与图形/控件边界 ≥3:1。

7.1 浅色主题

组合 前景 hex 背景 hex 比值 达标
正文 × 纸面 #000000 #ffffff 21.0:1 ✓
正文 × 卡片/弹窗 #000000 #ffffff 21.0:1 ✓
正文 × 他人气泡 / 次级按钮 #000000 #ededed 17.94:1 ✓
次级文字 × 纸面 #595959 #ffffff 7.0:1 ✓
次级文字 × 外壳画布 #595959 #e6e6e6 5.61:1 ✓
次级文字 × 他人气泡 #595959 #ededed 5.98:1 ✓
次级文字 × 本人气泡 #595959 #eeecff 6.03:1 ✓
本人消息正文 × 本人气泡 #1e1a63 #eeecff 13.07:1 ✓
主按钮文字 × 主按钮底 #ffffff #4d49fc 5.72:1 ✓
强调色文字/链接 × 纸面 #4d49fc #ffffff 5.72:1 ✓
选中行文字 × 选中行底 #3b34cc #eeecff 7.09:1 ✓
选中行文字 × 品牌浅底(合成 #ededff) #3b34cc #ededff 7.12:1 ✓
强调色 × 品牌浅底(合成 #ededff) #4d49fc #ededff 4.94:1 ✓
@提及 × 他人气泡 #4d49fc #ededed 4.88:1 ✓(现状 3.65:1 ✗)
@提及 × 本人气泡 #4d49fc #eeecff 4.92:1 ✓
危险色文字 × 纸面 #c4212c #ffffff 5.83:1 ✓(现状 4.57:1)
未读徽标白字 × 危险色 #ffffff #c4212c 5.83:1 ✓
结构线/描边 × 纸面 #949494 #ffffff 3.03:1 ✓(≥3:1,图形边界)
结构线 × 外壳画布 #949494 #e6e6e6 2.43:1 ⚠ 见风险 R3(装饰性结构线)
控件边界 × 纸面 #767676 #ffffff 4.54:1 ✓(现状 1.31:1 ✗)
占位符文字 × 纸面 #6e6e6e #ffffff 5.1:1 ✓(现状 3.74:1 ✗)
轨道图标 × 轨道块(合成 #d9d9d9) #4f4f4f #d9d9d9 5.8:1 ✓
墨轨 × 纸面(结构对比) #000000 #ffffff 21.0:1 ✓
墨轨 × 外壳画布下沿 #000000 #e4e4e4 16.52:1 ✓
纸面 × 外壳画布下沿(层级阶梯) #ffffff #e4e4e4 1.27:1 层级用,非文字
纸面 × 外壳画布上沿 #ffffff #efefef 1.15:1 层级用,非文字(现状 1.08:1,零层级)
图表格 2–5 × 纸面 #000000/#595959/#767676/#949494 #ffffff 21.0 / 7.0 / 4.54 / 3.03:1 ✓ 全 ≥3:1

7.2 深色主题

组合 前景 hex 背景 hex 比值 达标
正文 × 纸面 #ffffff #1b1b1b 17.22:1 ✓
正文 × 卡片 #ffffff #1b1b1b 17.22:1 ✓
正文 × 他人气泡 #ffffff #2e2e2e 13.58:1 ✓
次级文字 × 纸面 #ababab #1b1b1b 7.5:1 ✓
次级文字 × 容器底 #ababab #252525 6.68:1 ✓
次级文字 × 他人气泡 #ababab #2e2e2e 5.91:1 ✓
次级文字 × 浮层 #ababab #242424 6.76:1 ✓
次级文字 × 本人气泡 #ababab #332e78 5.07:1 ✓
本人消息正文 × 本人气泡 #eae8ff #332e78 9.7:1 ✓
主按钮文字 × 主按钮底 #14123a #8f8cff 6.25:1 ✓
强调色文字/图标 × 纸面 #8f8cff #1b1b1b 6.04:1 ✓
选中行文字 × 选中行底 #b6b3ff #2b2766 6.87:1 ✓
选中行文字 × 品牌浅底(合成 #2b2b3b) #b6b3ff #2b2b3b 7.2:1 ✓
强调色 × 品牌浅底(合成 #2b2b3b) #8f8cff #2b2b3b 4.87:1 ✓
@提及 × 他人气泡 #a5a2ff #2e2e2e 5.96:1 ✓
@提及 × 本人气泡 #a5a2ff #332e78 5.11:1 ✓
危险色文字 × 纸面 #ff8a80 #1b1b1b 7.55:1 ✓
未读徽标白字 × 危险色 #ffffff #ff8a80 2.28:1 ⚠ 不合规,见风险 R1
结构线 × 纸面 #707070 #1b1b1b 3.48:1 ✓(原文 10% 白线合成 #222222,对原文纸面 #0a0a0a 仅 1.24:1 ✗)
结构线 × 浮层 #707070 #242424 3.13:1 ✓
控件边界 × 纸面 #868686 #1b1b1b 4.73:1 ✓
控件边界 × 浮层 #868686 #242424 4.26:1 ⚠ 浮层内略低于 4.5:1(作为「图形边界」仍 ≥3:1 ✓)
占位符文字 × 纸面 #949494 #1b1b1b 5.68:1 ✓
轨道图标 × 轨道块(合成 #171717) #adadad #171717 7.99:1 ✓
纸面 × 外壳画布 #1b1b1b #050505 1.18:1 层级用(墨轨为 #000000,对纸面 1.22:1)
浮层 × 纸面 #242424 #1b1b1b 1.11:1 层级用(浮层另带 ring-foreground/10)
他人气泡 × 纸面 #2e2e2e #1b1b1b 1.27:1 层级用
图表格 1/3/4/5 × 纸面 #a5a2ff/#ababab/#949494/#707070 #1b1b1b 7.56 / 7.5 / 5.68 / 3.48:1 ✓ 全 ≥3:1

shadcn 兼容性

结论:完全兼容,且本方案不需要任何组件层改动就能生效。 环境核对:web/components.json = base-nova + neutral + iconLibrary: lucide + 无 prefix;web/src/components/ui/ 现有 38 个官方组件。本方案只做一件事——替换 styles.css 的两个语义令牌块,因此 Button/Badge/Input/Tabs/Avatar/Separator/Dialog/Card/Bubble/ScrollArea/Tooltip 等组件的类名与 variant 全部原样,官方 variant 的语义契约(variant="outline" 只用 --border、variant="destructive" 只用 --destructive…) 反而被加强了:令牌一改,所有引用同一语义的组件一起更新。

是否需要引入尚未安装的官方组件:不需要。 上面所有改造(状态徽标、卡片、弹窗、标签页、控件)都能用现有 38 个组件 + 官方 variant/size 表达:

用途 官方组件 官方 variant / size
状态徽标 Badge outline / secondary / ghost / default / destructive
主/次/描边/危险按钮 Button default / secondary / outline / ghost / link / destructive;size = default(h-8) / sm(h-7) / lg(h-9) / icon / icon-sm / icon-lg
消息气泡 Bubble default(本人)/ secondary(他人)/ muted(AI 助手)
任务卡 / 分组容器 Card 官方(rounded-xl bg-card ring-1 ring-foreground/10)
设置弹窗 Dialog 官方(rounded-xl bg-popover ring-1 ring-foreground/10)+ Tabs variant="line" + Separator
控件 Input / Textarea / Checkbox / RadioGroup / Select 官方(颜色全部来自 --input / --ring)
头像 Avatar size = sm / default / lg
分区 Separator 官方(bg-border)

必须显式标注为不合规 / 风险的地方(本方案不通过自定义样式去掩盖它们):

  1. R1 · 深色未读徽标 2.28:1(不合规,且现状同样失败):components/app/chrome.ts 的 unreadBadge = bg-destructive text-white,深色下白字压在 --destructive #ff8a80 上只有 2.28:1(浅色 5.83:1 ✓)。修法(组件层,1 处):改用官方 Badge variant="default"(bg-primary text-primary-foreground → #14123a 于 #8f8cff = 6.25:1),语义上是「未读需要你处理」,用主色比用危险色更贴题。
  2. R2 · variant="custom" 215 处绕过官方 variant:group-members.tsx×16、task-hall.tsx×12、message-list.tsx×12、space-manage-dialog.tsx×11、create-task-dialog.tsx×11、channel-work-items.tsx×11、rtc-group-call-ui.tsx×9、rtc-call-ui.tsx×8…(ui/button.tsx 里 variant === "custom" 直接把 className 当作最终样式)。这些位置并非本方案引入,但它们是「令牌改了就全站变样」这句话的例外:只要它们写的仍是语义令牌(如 text-brand-ink)就会跟随,写死 Tailwind 原始调色板的地方就不会。
  3. R3 · 浅色结构线在画布上 2.43:1:--border #949494 对纸面 3.03:1 ✓,但对 --muted #e6e6e6 画布只有 2.43:1。定位:border-border/55 这类装饰性结构线(面板描边)不受 1.4.11 约束;真正承载「控件边界」语义的是 --input(4.54:1 ✓)。若评审要求画布上的结构线也 ≥3:1,只需把画布渐变下沿从 #e4e4e4 提亮到 #eaeaea(比值升到 2.52:1)或以 --muted 加深画布,代价是画布与纸面的层级阶梯变弱——本方案选择保层级。
  4. R4 · --input 提升的副作用(可接受,需视觉确认):ui/input.tsx 的 disabled:bg-input/50 在浅色下合成 #bababa(禁用输入框底色变「实」,其上的 --muted-foreground 文字 3.61:1,禁用态豁免对比度要求)、dark:bg-input/30 合成 #3b3b3b;Checkbox/RadioGroup/Select 的边界同步变深(这正是目的)。
  5. R5 · 官方 destructive variant 的 hover 态文字低于 4.5:1(官方自带,未改):hover:bg-destructive/20 + text-destructive → 浅色 4.19:1、深色 4.20:1。静态态(bg-destructive/10)分别是 4.96:1 / 5.22:1 ✓。若在意,可在组件层把该 variant 用于图标按钮(图形边界口径 3:1)而不是文字按钮。
  6. R6 · railSep = bg-foreground/22 在墨轨上不可见:轨道变墨色后,chrome.ts 里 3 条 bg-foreground/22 分隔线会消失(无功能损失)。修法:bg-background/15(组层)。
  7. R7 · 深色主题在 /app 生产上仍不可达:web/src 无任何代码添加 .dark、localStorage 无主题键;且深色实测 rgb(6,6,7)×55、rgb(92,94,102)×27、rgb(220,222,225)×6 是硬编码浅色,令牌改不到。本方案交付的是「深色令牌已就绪」,不等于「深色可用」——需要一个主题入口 + 上述硬编码替换(列入「实施成本」)。
  8. R8 · 字号与刻度不受令牌控制:S2 自己 14px / 他人 15px、单视图 9…26px 十档字号、text-[11px]、h-[52px] 都在组件类里,令牌无法触达(见「字体与排版」)。

一个被刻意回避的「极简」做法:本人气泡不做墨黑块。原因是 components/app/message-reply-content.tsx 的引用条/引用作者仍读全局 --muted-foreground / --foreground(chrome.ts 的 replyQuoteAccentBar / replyQuoteAuthor),而 message-bubble.tsx 只覆盖 --primary / --primary-foreground 两个变量——气泡一旦变全黑,引用块会退化成黑底近黑字(约 1:1)。因此本人气泡改走淡紫(同色族、13.07:1),把「墨黑」这一档留给轨道与正文,这是与令牌通路一致的选择,不是审美偏好。


实施成本

改动面(本次交付,0 个组件文件):

文件 改动 规模
web/src/styles.css 仅 :root(行 108–160)与 .dark(行 162–210)两个变量块 约 102 行,其中浅色 ~35 个令牌、深色 ~45 个令牌(含补齐 3 个深色缺失令牌)
docs/design-proposals/figma/tokens.css 同一改动的可替换版本 + 逐行中文注释 + 沿用原文的 @theme inline 映射 见交付文件
其他 web/ 文件 零改动 —

后续组件层清单(本方案已定位、但为保持「零组件改动」而未执行):

# 工作 文件 预估
1 状态色去硬编码:rose/amber/slate 三族 → 官方 Badge variant(S3/S4 全流程) task-hall.tsx、group-hall.tsx、create-task-dialog.tsx、channel-work-items.tsx 5–7 h
2 R1 未读徽标改 Badge variant="default" + variant="custom" 收敛(215 处,分批) chrome.ts、message-list.tsx、group-members.tsx 等 10–14 h
3 R6 轨道分隔线、panelDivider alpha 复核;引用条改用 --surface-chat-soft chrome.ts、message-reply-content.tsx 2–3 h
4 字号阶梯统一(12 / 13 / 15 / 16,行高 1.5)与 text-[11px]、h-[52px] 回落官方尺寸 S2/S5/S7 相关页面 4–6 h
5 R7 深色可用:主题入口(.dark 注入 + localStorage)+ 44 文件里 253 处调色板/硬编码浅色替换 routes/*、components/app/* 10–16 h
合计 ≈ 31–46 人时(本次令牌改动本身 ≈ 2 h)

验证方式(可复现,不需要跑构建):

  1. 令牌生效:在 /app 打开 DevTools,getComputedStyle(document.documentElement).getPropertyValue('--border') → #949494;给 <html> 手动加 .dark 后同名变量应为 #707070(同时验证补齐后的 --interactive / --channel-icon 不再回落到浅色值)。
  2. 对比度复算:本方案上表所有比值都由同一脚本产出(sRGB → 线性化 → 相对亮度 → (L₁+0.05)/(L₂+0.05),带 alpha 的令牌先按所在表面复合),可对任意新值直接复算;改 tokens.css 中任一值后重跑即可对比。
  3. 覆盖面核对(命令级):grep -rn "border-border" web/src | wc -l(158)确认唯一边界线的影响面;grep -rn "variant=\"custom\"" web/src --include=*.tsx | wc -l(215)确认绕过官方 variant 的面;grep -rl "text-rose\|bg-amber\|bg-slate\|emerald-" web/src/components/app | wc -l(38)确认「令牌管不到的彩度」还剩多少文件。
  4. 基线对照:用 localtmp/design-render/ 下已有的普查 JSON 作为现状基线(S1-shell-dms.json、S2-dm-thread.json、S3-task-hall.json、S5-dialog-geometry.json、leaks-*.json),改后再采一次同结构 JSON 对比「层级比值 / 圆角档位 / 字号档位 / 调色板泄漏数」四项即可量化;本方案不重跑浏览器、不截图。

取舍

解决了的(都可量化):

牺牲了的(明确写出来,避免被当成遗漏):

什么场景下不适用: