单色底盘 · figma
方案名与主张
方案名:单色底盘(Monochrome Chassis)
主张(一句话):让界面先「无色」——全部结构退成白纸 / 中性灰画布 / 墨色轨道三层灰阶,全站只留一个色相 #4d49fc 用在「可操作的点」和「本人消息」上;这样任务卡里的状态、消息流里的内容、头像与图表里的颜色,就是画面上唯一有彩度的东西。
适用基调:双主题对等、浅色优先(浅色是主推形态,深色是同结构等值映射,不是「黑化版」)。
与其他 19 个方案的可比口径:本方案的改动全部落在语义令牌取值上(web/src/styles.css 的 :root 与 .dark 两个变量块,行 108–210),不新增组件、不新增自定义 variant、不动任何 className;因此「令牌文件改了多少、组件层还要花多少人时」是可直接横向比较的两个数(见「实施成本」)。
参考提炼
- 风格名:Figma(设计工具官网);slug:
figma;来源站点:figma.com;theme:light。 - 参考原文件:
localtmp/gradientdeck/figma.design.md、figma.design-extended.md。参考自身给出的基线取值:#ffffff/#000000/#595959/#e2e2e2/ 强调色#4d49fc。
从参考里提炼出 5 条可迁移规则(都是本方案实际执行的动作,不是风格形容词):
- 无色骨架承载彩色内容。 参考用手写体签名式的克制:结构面只有
#ffffff、#000000、#e2e2e2三档灰,色相被明确限定为「内容自己的颜色」——原文把#24cb71 / #00b6ff / #ff7237这类色只留给 artwork 与头像渲染,不用在装饰面或边框上。→ 本方案把 /app 的 44 文件 / 253 处 Tailwind 原始调色板(rose/amber/slate/emerald/teal/blue…)视为内容而不是界面色,界面本身只保留一条灰阶骨架。 - 正文不吃稀释灰。 参考对正文用纯
#000000,#595959只做元信息(它的原话是不要把正文用#595959稀释掉)。→ 本方案--foreground: #000000(21:1),把「轻」交给--muted-foreground: #595959(7.0:1);现状#060607+#5c5e66两个近黑灰其实没有分开「正文 / 元信息」的职能。 - 边界靠一条发丝线,不靠灰底。 参考把
#e2e2e2的 1px boundary frame 当作结构语言,阴影属于 Z 轴(浮层才用),不是基线装饰。→ 本方案把唯一边界令牌--border提到#949494(白底 3.03:1,刚过 WCAG 1.4.11 的 3:1),再用bg-border/45、border-border/55这类 alpha 分级让分隔线自动变轻,形成「同一墨线的轻重阶梯」,而不是再造几档灰。 - 一个 interruptive accent,只出现在面板内的焦点操作上。 参考的
#4d49fc只给「面板内需要打断视线的那一个操作」,不用于全局页头、不做大面积底色。→ 本方案--brand: #4d49fc的使用面被收成四类:主按钮、焦点环、选中行、链接/@提及;--workspace-header-background从深色下带品牌色的渐变改回纯纸面,正是执行这一条。 - 圆角由一个基准缩放。 参考的圆角资产是 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 二分圆角(原因见「适配判断」舍弃项)。
适配判断
为什么这套语言适合「任务 + 频道消息」的企业工具:
- /app 是双信息源产品:左半是频道/会话与任务卡,右半是消息流。实测(简报 §3.3)现状的层级是「零层」——会话侧栏
#fcfcfc对纸面#ffffff只有 1.03:1,--muted #f2f3f5对#fcfcfc只有 1.08:1,轨道 71×48 的图标块背景transparent。单色底盘的第一步就是把这三层拉开成可测量的梯度(21:1 / 1.15~1.27:1 / 1.0:1),而不是靠阴影和圆角去暗示分区。 - 信息密度大的工具里,彩度是稀缺资源:
--mention #3370ff在他人气泡上只有 3.65:1(不合规),而任务大厅同时铺着text-rose-700×7、bg-rose-50×4、text-amber-800×5、bg-amber-50×4——颜色既不够亮也不够准。把彩度收成一个色相后,「红」只剩一个含义(风险/失败),其余状态靠文字 + 徽标形状表达,反而更快扫读。 - 结构用灰阶、内容用彩度,天然兼容消息流里必然存在的头像、emoji、图表、图片——这些正是参考允许保留彩度的地方,所以 /app 不会变成一张灰纸。
- 深色按同结构等值映射,不做「深色专用视觉」。现状深色实测仍有
rgb(6,6,7)55 处、rgb(92,94,102)27 处、rgb(220,222,225)6 处浅色硬编码,且web/src里没有任何代码添加.dark、localStorage也没有主题键——深色在 /app 生产上不可达。本方案把深色当作「等值第二主题」交付,并把它当前的两处结构性缺陷(.dark从未覆盖--interactive/--channel-icon,浅色值直接漏进深色;--surface-rail: #e3e5e8会在深色里留一条浅色竖带)一并修掉。
明确舍弃的参考项:
| 参考项 | 舍弃原因 |
|---|---|
| 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 |
中文长文本与数字的注意点:
--font-sans首位的"Geist Variable"没有 CJK 字形,中文实际由"Noto Sans SC"/"PingFang SC"渲染;两套字形的 x-height 与字面宽不同,中英混排时不要用西文负字距做收字(参考里的-1.44pxtracking 属舍弃项),中文正文也不要加tracking-tight。- 中文正文行高比等值西文需要更多空气:15px × 1.375 = 20.63px 对短消息够用,但 AI 助手频道那种长段落(实测一次渲染 2765 个 12.8px 单元)应走 1.5;该项在组件层,本次只给目标值,不声称已达成。
- 数字与文字要有分工:任务数(395)、成员数(12)、耗时这类统计走
--font-mono+tabular-nums,避免比例数字在列表中跳动;实测现状同一视图混用 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26px(以 15px 为基准的 em 计算),说明字号缺少刻度——刻度统一是组件层整改项。 - 单色底盘下不要用字重代替颜色做层级:
--foreground(正文)/--muted-foreground(元信息)的分工必须固定,字重只在标题(600)与标签(500)两处出现。
关键界面改造
覆盖样例面:S1 外壳/侧栏、S2 频道消息流、S3 任务大厅+任务卡、S4 AI 助手频道、S5 管理设置弹窗、S7 登录页、S8 应用中心(7 面 ≥ 6 面要求),并附 S6 语音频道的代码依据说明(本机 TRTC_ENABLED=false,界面零语音元素,不截图、不伪造)。
每条末尾标注:途径(① 语义令牌取值 / ② 官方 variant·size / ③ 容器布局间距)与落地(本次 = 只改令牌即可生效;后续 = 需组件层改造,已列入「实施成本」)。
S1 外壳 + 侧栏(会话列表 / 空间轨道)
- 现状:三层结构都是浅色近白——轨道
--surface-rail #e1e8f2且--workspace-rail-background: transparent,画布linear-gradient(180deg, #e1e8f2, #e1e5f1),会话侧栏aside 256×715 bg #fcfcfc(=--background)。实测对纸面只有 1.03:1 / 1.08:1 / 1.20:1;轨道上 71×48 的图标块背景transparent,与底面几乎不可分。 - 改后:三层硬梯度——墨轨
--surface-rail #000000(对纸面 21:1,对画布灰 16.52:1)→ 中性灰画布--workspace-background: linear-gradient(180deg,#efefef,#e4e4e4)(对纸面 1.15~1.27:1)→ 白纸面--background #ffffff。轨道图标块由chrome.ts的railItemBase = bg-background/85合成#d9d9d9,配新--interactive #4f4f4f得 5.8:1(现状图标色是蓝味#4e5058,但因为底面也是蓝灰才「看着还行」);选中空间磁贴railItemActive = bg-brand text-brand-foreground现在是 5.72:1。会话侧栏用panelDivider = bg-border/45合成#cfcfcf(1.56:1)与画布拉开,选中行走selectedRow = sidebar-selection … bg-surface-chat-selected #eeecff+text-brand-ink #3b34cc(7.09:1)+.sidebar-selection::before的 2px--brand竖条。 - 密度:不动任何容器尺寸(轨道仍 72px、侧栏仍 256px、行高仍由组件决定);层级改由灰阶承担,因此不需要加投影或描边。
- 途径 ①(
--surface-rail/--workspace-*/--background/--muted/--interactive/--border)。落地:本次。 - 后续(组件层):
chrome.ts的railSep = bg-foreground/22在墨轨上不可见(3 条分隔线消失,功能无损)→ 建议改bg-background/15;panelDivider/workspaceSplitPanelFrame的 alpha 值按新--border复核。途径 ③。
S2 频道消息流
- 现状:他人气泡
--secondary #ebedef、本人气泡--message-self #e8f3fe+#0d274a;@提及走--mention #3370ff(全站第四个蓝,硬编码#006ce7是第三个);引用条bg-foreground/25+text-muted-foreground #5c5e66;消息列表自己 14px、他人 15px 两套字号;输入容器 628×33 无边框、仅上边框rgb(220,222,225)(硬编码)。 - 改后:他人气泡=中性灰
--secondary #ededed(对纸面 1.17:1),本人气泡=淡紫--message-self #eeecff+--message-self-foreground #1e1a63(13.07:1)——两者靠色相而非灰阶区分,这是「色相只给内容」在消息流里的具体落点;@提及--mention #4d49fc在他人气泡上 4.88:1(现状#3370ff只有 3.65:1,不合规)、本人气泡上 4.92:1;引用条bg-foreground/25在新--foreground #000000下、于他人气泡#ededed上合成#b2b2b2(对气泡 1.81:1,装饰级分隔),引用作者文字--muted-foreground #595959对#ededed5.98:1;未读徽标(chrome.tsunreadBadge = bg-destructive text-white)浅色下 5.83:1 ✓。 - 密度:消息间距/气泡内边距不动(属容器 ③,本次不改);输入面板保持「上边框 + 纸面」的形态,建议把硬编码
rgb(220,222,225)换成border-border(3.03:1)——途径 ①,落地属组件层。 - 途径 ①(气泡、提及、引用文字、未读徽标)+ ②(消息气泡本身已是官方
Bubble的default/secondaryvariant,message-bubble.tsx只覆盖--primary/--primary-foreground两个变量,不改 className)。落地:本次。 - 后续(组件层):统一消息字号(自己 14px → 15px,或全部 14px);引用条改用
--surface-chat-soft做底而不是bg-foreground/25;#006ce7硬编码三处(message-list.tsx、composer-markdown.ts、voice-channel-history-dialog.tsx)改text-brand。
S3 任务大厅 + 任务卡
- 现状:状态色是 Tailwind 原始调色板硬编码——
text-rose-700×7、bg-rose-50×4、text-amber-800×5、bg-amber-50×4、bg-slate-400×2、bg-slate-200/70;variant="custom"12 处(绕过官方 variant);圆角混用 8px×37 / 10px×48;状态共 6 档(待补充 / 待处理 / 进行中 / 待验收 / 已完成 / 已关闭)。 - 改后:状态表达收敛为「中性 + 单语义红」:
状态 表达 shadcn 组件与 variant 对比度 待补充 / 待处理 中性墨字 + 发丝线框徽标 Badge variant="outline"文字 21:1,边界 3.03:1 进行中 中性墨字 + 实心浅灰徽标 Badge variant="secondary"17.94:1 待验收 墨字 + 强调色描边(唯一的「需要我关注」档) Badge variant="outline"+text-brand(4.94:1 于--brand-soft底)4.94:1 / 5.72:1 已完成 次级灰字 + 无色徽标(弱化) Badge variant="ghost"(文字text-muted-foreground)5.61:1 失败 / 逾期 / 风险 语义红 Badge variant="destructive"5.83:1 已关闭 / 过期 静音(secondary 灰,无强调) Badge variant="secondary"17.94:1 任务卡用官方 Card(ui/card.tsx:14:rounded-xl bg-card ring-1 ring-foreground/10):在灰画布上是「白纸 + 发丝环」,--radius 0.5rem后圆角统一到 11.2px(现状 8/10px 混用),卡片之间的间距与 4 列网格走容器 ③,任务计数/编号用--font-mono。 - 途径 ①(
--destructive/--border/--muted/--brand)+ ②(官方Badge的outline/secondary/ghost/destructive、Card)+ ③(网格与卡片间距)。落地:令牌部分本次;把 rose/amber/slate 三族硬编码替换成上表徽标需组件层(task-hall.tsx、group-hall.tsx、create-task-dialog.tsx、channel-work-items.tsx)。 - 注意:
variant="custom"这 12 处是本次令牌改动的「可视盲区」——它们能吃到语义令牌的地方会自动跟随,直接写死 Tailwind 调色板的地方必须逐个改(清单见「实施成本」)。
S4 AI 助手频道(员工智能助手 WanTeams)
- 现状:全站最密集视图(395 项任务)。一次渲染内字号档位
12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724;圆角8px×1591 / 10px×844;hover 行bg-foreground/[0.04];AI 回复容器混用--muted与--secondary。 - 改后:AI vs 人的区分不用色相,用灰阶与字体:AI 回复走官方
Bubble的mutedvariant(ui/bubble.tsx提供default/secondary/muted/tinted/outline/ghost/destructive),人在场的气泡保持default/secondary;元信息(模型名、时间、工具调用)用--muted-foreground #595959(对纸面 7.0:1、对--muted #e6e6e65.61:1)+--font-mono。hover 行bg-foreground/[0.04]在新画布上与--muted同强度(1.25:1 档),不必再调。密集列表的圆角统一到--radius链(rounded-lg8px /rounded-xl11.2px),消除 8/10px 混用。 - 途径 ①(
--muted/--muted-foreground/--border/--radius)+ ②(官方Bubblevariant、Badge、Separator)+ ③(列表容器 gap/分组)。落地:本次(令牌)+ 后续(把 AI 回复容器改为Bubble variant="muted"、字号归到 12/13/15 三档)。
S5 管理设置弹窗(频道/空间设置)
- 现状:
ui/dialog.tsx:37用rounded-xl bg-popover ring-1 ring-foreground/10;实测弹窗704×512 radius 18px bg #ffffff、左侧导航项135×36 rounded 8px、输入488×32 radius 10px;space-manage-dialog.tsx已用bg-brand-soft×7、text-brand-ink×9、bg-brand×5,另有variant="custom"11 处。 - 改后:弹窗=纸面白 +
ring-foreground/10发丝环(在灰画布上可辨),圆角随--radius收到--radius-xl= 11.2px(现状约 14~18px,收敛一档);左侧导航项保持 36px 高(密度不动),选中项bg-brand-soft(合成#ededff)+text-brand-ink #3b34cc(7.12:1,现状 5.66:1);输入框rounded-lg8px +--input #767676(4.54:1,现状 1.31:1 几乎看不见边界);弹窗内--popover浅色同纸面(白),跨层用--border3.03:1 划分。 - 途径 ①(
--input/--border/--brand-soft/--brand-ink/--radius/--popover)+ ②(官方Dialog/Tabs(TabsList variant="line")/Separator/Input/Label)。落地:本次。 - 后续(组件层):
variant="custom"11 处复核;弹窗内输入卡片若用bg-secondary/75之类调用需按新--secondary(1.17:1)确认边界仍由--input承担。
S6 语音频道(代码依据说明,无截图)
- 依据:本机
TRTC_ENABLED=false,/app界面零语音元素(aria-label匹配「语音|通话|加入」命中 0,/api/v1/rtc/*返回RTC_DISABLED);语音相关数据来自库表wanman3_rtc_voice_channels(30 行)、wanman3_rtc_calls(183 行)。本方案不伪造该面的截图或实测值。 - 现状(读代码):
components/app/rtc-group-call-ui.tsx硬编码bg-emerald-500×2、bg-emerald-600×2、text-amber-700×2、rounded-full×10、variant="custom"9 处;rtc-voice-stage.tsx只用bg-muted/text-muted-foreground/bg-destructive(已合规)。 - 改后(若开启语音):发言中=
--brand焦点环 +--muted底;静音=Badge variant="outline";连接态(已连接 / 连接中 / 重连中 / 已断开 / 连接失败)→ 前四档走中性灰文字,仅「连接失败」用--destructive #c4212c(5.83:1);圆形按钮的rounded-full属组件层,不再引入新色相。途径 ①②,落地:后续(该面当前不可达,无法验证)。
S7 登录页
- 现状:主按钮 356×52
#2563eb白字(5.17:1,但它只是「其中一个蓝」);主标题 26px;切换块 173×42;页脚 11px(低于中文 12px 下限);login-glass-shell.tsx:96的品牌辉光border-brand/20 bg-brand/5 shadow-[0_0_10px_color-mix(in_oklab,var(--brand)_22%,transparent)];login-code-form.tsx已全量令牌化(text-brand×4、bg-brand-soft、text-brand-ink、border-brand/25、h-[52px])。 - 改后:令牌一换,整页自动变成单色底盘——主按钮
#4d49fc白字 5.72:1(提高 0.55),标签/链接text-brand5.72:1,选中块bg-brand-soft(--brand-ink7.12:1);辉光仍是品牌色族(无第二色相),与「色相只在可操作点」一致。页脚 11px → 12px 属组件层(text-[11px]),本次只标注。 - 途径 ①(
--brand/--brand-foreground/--brand-soft/--brand-ink/--border/--input/--radius)+ ②(官方Button现有档位里最大的是size="lg"= h-9 / 36px,登录页用h-[52px]旁路了尺寸 → 后续回落到官方 size,视觉重量差由容器 padding 吸收;Input/Tabs/Separator沿用官方)+ ③(卡片留白)。落地:本次。 - 后续(组件层):
h-[52px]与text-[11px]这类硬编码尺寸回落到官方 size(lg= h-9 / h-10)与 12px 最小字号;辉光若含非品牌色相则删除。
S8 应用中心
- 现状:卡片网格(
grid-cols-*+gap-*),emoji 作应用图标,5 个Badge、variant="ghost"×8、variant="custom"×3。 - 改后:emoji 保留——参考把彩度限定在「作品/头像」类渲染上,应用图标正属于内容物;元信息(
Agent · 第三方 · chat)用--muted-foreground #595959(白底 7.0:1)+--font-mono;分类/状态用官方Badge的outline/secondary(17.94:1 / 边界 3.03:1);卡片之间的分隔用Separator(bg-border3.03:1)而不是第三档灰底。 - 途径 ①(
--border/--muted-foreground/--background)+ ②(Badge官方 variant、Card、Separator)+ ③(网格 gap)。落地:本次(令牌)+ 后续(variant="custom"×3 收敛)。
深浅色与对比度
以下比值全部用同一脚本实算: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) |
必须显式标注为不合规 / 风险的地方(本方案不通过自定义样式去掩盖它们):
- 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),语义上是「未读需要你处理」,用主色比用危险色更贴题。 - 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 原始调色板的地方就不会。 - 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加深画布,代价是画布与纸面的层级阶梯变弱——本方案选择保层级。 - R4 ·
--input提升的副作用(可接受,需视觉确认):ui/input.tsx的disabled:bg-input/50在浅色下合成#bababa(禁用输入框底色变「实」,其上的--muted-foreground文字 3.61:1,禁用态豁免对比度要求)、dark:bg-input/30合成#3b3b3b;Checkbox/RadioGroup/Select的边界同步变深(这正是目的)。 - R5 · 官方
destructivevariant 的 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)而不是文字按钮。 - R6 ·
railSep = bg-foreground/22在墨轨上不可见:轨道变墨色后,chrome.ts里 3 条bg-foreground/22分隔线会消失(无功能损失)。修法:bg-background/15(组层)。 - R7 · 深色主题在 /app 生产上仍不可达:
web/src无任何代码添加.dark、localStorage无主题键;且深色实测rgb(6,6,7)×55、rgb(92,94,102)×27、rgb(220,222,225)×6 是硬编码浅色,令牌改不到。本方案交付的是「深色令牌已就绪」,不等于「深色可用」——需要一个主题入口 + 上述硬编码替换(列入「实施成本」)。 - 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) |
验证方式(可复现,不需要跑构建):
- 令牌生效:在 /app 打开 DevTools,
getComputedStyle(document.documentElement).getPropertyValue('--border')→#949494;给<html>手动加.dark后同名变量应为#707070(同时验证补齐后的--interactive/--channel-icon不再回落到浅色值)。 - 对比度复算:本方案上表所有比值都由同一脚本产出(sRGB → 线性化 → 相对亮度 →
(L₁+0.05)/(L₂+0.05),带 alpha 的令牌先按所在表面复合),可对任意新值直接复算;改tokens.css中任一值后重跑即可对比。 - 覆盖面核对(命令级):
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)确认「令牌管不到的彩度」还剩多少文件。 - 基线对照:用
localtmp/design-render/下已有的普查 JSON 作为现状基线(S1-shell-dms.json、S2-dm-thread.json、S3-task-hall.json、S5-dialog-geometry.json、leaks-*.json),改后再采一次同结构 JSON 对比「层级比值 / 圆角档位 / 字号档位 / 调色板泄漏数」四项即可量化;本方案不重跑浏览器、不截图。
取舍
解决了的(都可量化):
- 层级:会话侧栏对纸面 1.03:1 → 21:1 的墨轨 / 1.15~1.27:1 的灰画布 / 纸面 三层硬梯度,修掉「侧栏与页面底色零层级对比」「图标块背景 transparent」两处实测缺陷。
- 边界:1.31:1 → 3.03:1(
--border,全仓 158 处border-border共用一条线)、1.31:1 → 4.54:1(--input控件边界)、3.74:1 → 5.1:1(占位符兼图标色--channel-icon)。 - 色彩统一:四个蓝(
--brand #2563eb、硬编码#006ce7、--mention #3370ff、--brand-ink #1d4ed8)收敛为一个色相的两个明度(#4d49fc/#3b34cc),--mention对比度 3.65:1 → 4.88:1(从不合规到合规)。 - 深色:补齐
.dark缺失的--interactive/--channel-icon/--sidebar-ring,修掉--surface-rail #e3e5e8的浅色竖带,--border从 10% 白 alpha 线(合成#222222,对原文纸面仅 1.24:1)提到 3.48:1。 - 危险色:
#da373c(4.57:1)→#c4212c(5.83:1),并让未读徽标、删除按钮、失败状态读同一个值。
牺牲了的(明确写出来,避免被当成遗漏):
- 参考的二分圆角(50px pill / 0px 内容卡)与 72px display 字号 / −1.44px 负字距 / 96–120px macro-whitespace:单
--radius缩放链与工作台密度都不支持,全部舍弃(理由见「适配判断」)。 - 发丝线的可辨识度上限:为保住「发丝 + 分级」的质感,
bg-border/45的分隔线只有 1.56:1、画布上的border/55结构线 2.43:1——它们是装饰性线条,不是控件边界;若评审要求全部线条 ≥3:1,就必须放弃 alpha 分级、把每条线都画成#949494实线,界面会明显变「图纸」。 - 墨轨上的分隔线消失(R6)、禁用输入框底色变深(R4)、深色未读徽标仍 2.28:1(R1,需组件层修)、官方的 destructive hover 文字 4.19:1(R5)——这三条都是「令牌能覆盖的范围」之外的已知代价,已在「shadcn 兼容性」逐条标注。
- 深色仍是「令牌就绪」而不是「产品就绪」(R7):没有主题入口,深色在生产上依旧不可达。
- 状态色只剩一档语义红:单色底盘下 6 档任务状态靠「文字 + 徽标形状」区分,扫读速度取决于文案是否规范;这是本方案最大的使用面代价。
什么场景下不适用:
- 需要靠颜色在 4 类以上状态间快速切换的看板(单色 + 文字标记的认知成本高于 5 色标签);此时应改用「状态色进令牌」的路线,而不是本方案的「状态色退成文字」。
- 需要高彩度品牌表达的市场/活动页(
components/landing/*的blueprint网格与 /app 是两套语言,本方案不动 landing,也不建议把 /app 的令牌当成全站设计系统)。 - 需要大面积彩色背景做分区的管理台(本方案的色相只允许出现在可操作点与内容物上)。