Linear 重设计方案 —— 暗夜精密仪器
slug:
linear分支:codex/design-linear基线:test@3d35969f交付三件套:docs/design-proposals/linear/{proposal.md,tokens.css,preview.html}(未改动web/任何文件)
方案名与主张
中文方案名:暗夜精密仪器
一句话主张: 用「近黑画布 + 1px 石墨描边 + 唯一色相仪器蓝」当作仪器面板的物理结构,只改语义令牌取值就让任务与消息在深色下可读、在浅色下精密——层级靠 4 级表面阶梯与描边,不靠渐变、阴影堆叠和彩色。
- 基调:双主题对等(深色优先设计,浅色为生产默认镜像)。 参考
linear.design.md是 dark-first,但实测web/src全仓无任何代码给<html>/<body>加.dark,localStorage无主题键,故深色在生产不可达;本方案两套令牌都交付并各自实测对比度,同时把"新增主题开关"标注为超出三条途径的前置依赖(第④条),见 §3、§7、§9。 - 主色(报告值):浅色
#2F56D2,深色#6E9BF7。 不照抄参考的 acid lime#e4f222:本项目任务是任务/消息密度工具,蓝色承载「选中、聚焦、品牌 CTA」的语义链,绿色系已被"已完成"状态占用。品牌色保持 hue 256/262 同族。 - 核心度量(都来自令牌,可独立验证):
--radius0.625rem(10px) → 0.375rem(6px);表面 4 级阶梯;控件描边--input从 1.35:1 → 3.18:1(浅)、1.58:1 → 3.86:1(深);--brand-ink选中行 7.16:1(浅,底--surface-chat-selected #e3e8f0)/ 8.67:1(深)。 - 途径纪律(本方案每一条改造都标注落在哪条途径):
- ① 语义令牌取值(
web/src/styles.css的:root/.dark) - ② shadcn 官方
variant/size(只用官方已定义的枚举值,不新增自定义 variant) - ③ 容器 flex/grid 布局、区域尺寸、间距、滚动
- 第④条(超出允许范围,凡涉及处均显式标注为前置依赖,不实施):改动组件 className / 组件源码,例如
chrome.ts的imListAside = "bg-background"、message-list.tsx的固定字号、tone.ts的 Tailwind 调色板泄漏。
- ① 语义令牌取值(
参考提炼
从 linear.design.md / linear.design-extended.md 提出的可移植规则(每条附本项目落点):
| # | 参考中的规则(原文要点) | 本项目落点 |
|---|---|---|
| 1 | 单一色相纪律:全站强调色只有 acid lime #e4f222 一个色相,只出现在品牌标识、CTA、选中/聚焦 |
换成蓝族单色相:--brand 浅 #2f56d2 / 深 #6e9bf7;--brand-soft/--brand-ink/--surface-chat-selected/--mention 全部由同一 hue 派生(浅色三蓝收敛为一个家族:#2f56d2 → #1b3fb0) |
| 2 | 4 级表面阶梯:深色 Void #08090a → Carbon #0f1011 → Obsidian #161718 → Slate #23252a |
深色逐字采用;浅色做单调向上镜像:外壳 #e5e7eb/#dfe1e5 < 面板 #fbfbfc < 卡片/弹窗 #ffffff,凹陷填充 #eef0f3、悬停 #e6e9ee(实测阶梯跃迁 1.20 / 1.06 / 1.10) |
| 3 | 描边代替阴影:面板边界用 1px 低对比描边 + 极短阴影,浮层才用大阴影 | --border 去蓝中性化并保持强度(浅 #dcdfe4 = 1.34:1 / 深 #23252a = 1.30:1);控件轮廓 --input 单独提到 3:1 以上;卡片/弹窗仍用 app 既有 shadow-e2,不新增阴影令牌 |
| 4 | 6px 控制圆角:按钮/输入框/徽标都贴近 6px,浮层 12px | --radius: 0.375rem → rounded-lg = 6px(按钮/输入);rounded-xl = 8.4px(卡片/弹窗)、rounded-2xl = 10.8px(面板)。偏离已标注:Linear 卡片 12px、徽标 4px 在本栈不可达(组件硬编码 rounded-xl/rounded-4xl),见 §8 |
| 5 | 克制字号阶梯 + 高密度:正文 14/16,元信息 12,密度靠间距压缩而不是缩小字号 | 正文 14px(官方 BubbleContent 的 text-sm)、元信息 12px(官方 MessageHeader/Footer 的 text-xs)、标题 16px;密度改造放在 §6 的容器间距/列宽/滚动区(途径③) |
| 6 | 强调色只给"选中/聚焦/品牌 CTA":状态、标签一律去饱和 | --muted/--accent/--secondary 全部中性化(不再带蓝);选中态走 --surface-chat-selected + --brand-ink;--destructive 只留"需注意/已终止"两类语义 |
| 7 | 反例(明确不照抄):不做荧光 lime、不做纯黑 #000、不做多色标签、不做玻璃拟态 |
深色底取 Void #08090a(非 #000,#08090a 与 #0a0a0a 亮度比 1.007,保留"近黑但可分层");状态色降为官方 4 个 badge variant + 文字/图标 |
适配判断
覆盖面(≥6,本方案给 8 个): S1 外壳/空间侧栏、S2 频道消息流、S3 任务大厅+任务卡、S7 登录页(必选 4);S5 管理设置弹窗、S8 应用中心、S4 AI 助手频道(3 个可选);S6 语音频道(本栈不可见,仅以代码+库表为据,见 §6 末尾)。
三条途径下的"能改 / 改不动"总账
| 结论 | 内容 | 依据(文件:行) |
|---|---|---|
| 能改(①令牌) | 语义令牌 + 4 个历史遗留令牌(--surface-rail/--workspace-*/--interactive/--channel-icon)+ --radius;所有官方组件(Button/Input/Badge/Card/Dialog/Tabs/Bubble/Message/Select/Field)的底色、文字色、描边、圆角都由此翻转 |
web/src/styles.css:108(:root)、:163(.dark)、:31(@theme inline) |
| 能改(②官方 API) | Bubble 7 个 variant × align;Message/BubbleGroup 的 12px 元信息;Card data-[size=sm] 的卡内间距;Badge 6 variant;Button 6 variant × 9 size;Tabs default/line |
components/ui/bubble.tsx:24-60、ui/message.tsx:24,63、ui/card.tsx、ui/badge.tsx、ui/button.tsx、ui/tabs.tsx |
| 能改(③容器布局) | 消息列限宽、任务栅格列数/gap、侧栏与附属栏宽度、滚动区归属、登录卡片在 1440×900 的居中与节奏 | 见 §6 各面 |
| 改不动(需第④条,本方案不实施) | 侧栏与主区同为 bg-background 造成的零层级;消息正文 15/14px 分歧;tone.ts 等 253 处 Tailwind 调色板泄漏;深色主题开关;main 的 bg-muted/40 权重;硬编码圆角 |
逐条见下 |
实测现状问题清单(全部来自简报 §3.3 与 localtmp/design-render/*.json)
- 侧栏与主区零层级:
components/app/chrome.tsimListAside = "bg-background"、imSplitPanel同值;实测 S1 会话侧栏aside256×715 背景#fcfcfc,等于--background。面板之间只靠 1px 缝隙 +md:ring-1 ring-foreground/[0.06];实测该 6% 描边合成#ededed、对比 1.14:1(几乎不可见)。→ 令牌无法制造这段层级,只能压深外壳画布让缝隙更明显;显著改观需第④条。 - 控件描边用的是装饰色:
components/ui/input.tsx用border-input;实测浅色--input = #dcdee1对比 1.35:1、深色oklch(1 0 0 / 15%)合成#3a3a3a对比 1.58:1,均低于 WCAG 1.4.11 的 3:1。→ 令牌可修(3.18:1 / 3.86:1),本方案最大的一处无障碍收益。 - 深色在生产不可达(精确表述):全仓没有任何代码给
<html>/<body>加.dark,localStorage无主题键、<html>class 恒空;但styles.css:971存在一条现成的深色选择器.dark .emoji-mart-shell em-emoji-picker(只服务 emoji-mart),说明.dark曾是既定命名。仓库另有html[data-desktop-titlebar="overlay"](styles.css:985)这种 html 级属性开关先例。→ 深色交付属前置依赖;实现时应与既有习惯一致([data-theme="dark"]作用域),并把:971的.dark选择器一起改过去,否则 emoji 面板会在新主题下掉回浅色。 - 深色 bug:
--surface-rail是浅色值(.dark内#e3e5e8),铺在#0a0a0a画布上形成一条 15.69:1 的浅色竖带。→ 令牌可修(#101114)。 - 圆角 12 档混用:实测出现
2/6/7/8/10/12/14/18/24/26/32px与9999px;--radius: 0.625rem的派生面还有 6/8/10/14/18/22/26px,另有 13 处硬编码圆角。→ 令牌把官方组件面收敛为 6 档(3.6/4.8/6/8.4/10.8/15.6px),硬编码残留属第④条。 - 消息排版分歧:
message-list.tsx自己气泡 14px / 他人 15px;作者 13px / 时间 12px 混用。→ 走②统一为正文 14px + 元信息 12px。 - 253 处调色板泄漏(amber 69 / rose 68 / slate 44 / emerald 42 / teal 12 / blue 7 / red 3 / violet 2 / purple 2 / neutral 2 / sky 1 / cyan 1,44 个非测试文件),集中在
components/app/tone.ts、task-hall.tsx、app-center.tsx(如bg-[#f5f6f7]、bg-white、border-amber-200)。→ 令牌管不到,属第④条。 - 两处令牌零消费点:
--chart-1..5与--sidebar*在web/src的 ts/tsx 中零引用(只在@theme inline暴露为bg-sidebar/color-chart-*)。本方案仍按契约给两套取值,但如实标注"零视觉收益、零回归风险",不当作改观业绩。 - 非整数字号的来源已定位:
9.375 / 11.25 / 13.125px= 15px 上的0.625em / 0.75em / 0.875em派生(实测 S1 会话预览 11.25px);12.8px= 官方Button size="sm"的text-[0.8rem](实测 S3 AI 空间统计 12.8px);10px=styles.css:229kbd-chip的font-size: 0.625rem。→ 前三个属组件 className,只能用官方档位替换(第④条),§5 标注为风险项。
令牌映射
结构: tokens.css 逐行可替换 web/src/styles.css 的 :root(108 行起)与 .dark(163 行起);@theme inline(31–106 行)原样沿用(--color-* 映射、--radius-* 派生公式、字体栈一字未动),因此全部取值经官方 Tailwind 颜色类生效。
取值纪律: 浅色表面单调向上(外壳 < 面板 < 卡片);深色逐级抬升;同一语义在两套主题用同一"角色名",只有亮度反转。
浅色 :root(当前 → 建议,当前值取自 styles.css:108-161)
| 变量 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
#fcfcfc |
#fbfbfc |
面板色退半步,给卡片/弹窗留出最亮层:与卡片 1.06:1、与外壳 1.18:1 |
--foreground |
#060607 |
#0d0f12 |
石墨黑(18.56:1);刻意保持近黑,因为全仓大量 rgba(foreground,x) 派生描边靠它保持力度(实测 6% 合成 1.13:1,若换 #16181c 掉到 1.11:1) |
--card / --popover |
#ffffff |
#ffffff |
阶梯顶(不改) |
--card-foreground / --popover-foreground |
#060607 |
#0d0f12 |
随 --foreground 收敛 |
--primary |
var(--brand) |
var(--brand) |
品牌链唯一入口(经 @theme 映射为 bg-primary);实际值随 --brand 变 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
同上,白字 6.21:1 |
--secondary |
#ebedef |
#e9ebef |
搜索框底/次级按钮;中性化并略压深(1.15:1 vs 面板) |
--secondary-foreground |
#060607 |
#0d0f12 |
随 --foreground |
--muted |
#f2f3f5 |
#eef0f3 |
卡内凹陷 + 登录页 bg-muted/40 画布;压深让凹陷/画布可辨(1.10:1) |
--muted-foreground |
#5c5e66 |
#5f646c |
去蓝中性化;5.96:1 on 卡片 / 5.76:1 on 面板 / 5.22:1 on --muted |
--accent |
#ebedef |
#e6e9ee |
hover 填充 + 他人消息气泡(实测气泡底就是 --accent);1.18:1 vs 面板 |
--accent-foreground |
#060607 |
#0d0f12 |
随 --foreground |
--destructive |
#da373c(白底 4.57:1,不达标) |
#c0272d |
白底 5.88:1 |
--border |
#dcdee1(1.35:1 on 白) |
#dcdfe4 |
分隔线/卡片描边:强度持平(1.34:1 on 白 / 1.29:1 on 面板)只做去蓝中性化;有意 <3:1,引用 WCAG 1.4.11 装饰豁免,§7 有专段 |
--input |
#dcdee1(1.35:1) |
#8b9199 |
控件轮廓独立提档:3.18:1 on 白 / 3.07:1 on 面板,满足 1.4.11 |
--ring |
var(--brand) |
var(--brand) |
不改:聚焦环本来就是品牌色,随 --brand 自动更新 |
--brand |
#2563eb(白字 5.17:1) |
#2f56d2 |
主色,白字 6.21:1;更沉、更"仪器" |
--brand-foreground |
#ffffff |
#ffffff |
品牌底上的文字(不改) |
--brand-soft |
rgb(37 99 235 / 0.12) |
rgb(47 86 210 / 0.12) |
选中/徽标底,合成 #e3e7f7,配 --brand-ink 7.15:1 |
--brand-ink |
#1d4ed8 |
#1b3fb0 |
品牌文字(8.81:1 on 白);同时是选中行文字与登录分段选中文字 |
--message-self |
#e8f3fe |
#e8edfc |
自己气泡:由"天蓝"收进品牌蓝家族(三蓝收敛为一个 hue) |
--message-self-foreground |
#0d274a |
#1b2f6b |
自己气泡文字:12.9:1 → 10.78:1(更接近同列表他人气泡的视觉重量) |
--surface-chat-soft |
#e8f2ff |
#eef1f8 |
频道/消息软底;零消费点,给可辨取值备用 |
--surface-chat-selected |
#e5ecfc |
#e3e8f0 |
会话/频道选中底(唯一消费点 chrome.ts selectedRow),配 --brand-ink 7.16:1 |
--mention |
#3370ff |
#1b3fb0 |
@提及色与 --brand-ink 同值:全站只剩一个蓝 hue |
--ink |
#060607 |
#0d0f12 |
rtc 视频框/landing 深底,与 --foreground 同族 |
--surface-rail |
#e1e8f2 |
#e5e7eb |
去蓝:现状导轨底带明显蓝紫,与"中性仪器"冲突,改冷石墨灰;与面板 1.20:1(现状 1.202,强度持平但色相归中性) |
--workspace-background |
linear-gradient(180deg, var(--surface-rail), #e1e5f1) |
linear-gradient(180deg, var(--surface-rail), #dfe1e5) |
画布终点同步去蓝并压深:vs 面板 1.27:1(现状 1.23:1),面板边缘更清楚 |
--workspace-rail-background |
transparent |
transparent |
不改(@theme 注释约定"两主题都透明") |
--workspace-header-background |
var(--background) |
var(--background) |
不改:已是面板色,随 --background 自动更新 |
--interactive |
#4e5058 |
#4f545c |
次要图标/文字:7.37:1 on 面板 / 6.39:1 on --secondary(微调色相统一到中性) |
--channel-icon |
#80848e(3.65–3.74:1,不达标) |
#6b7079 |
频道图标 #/锁/铃:4.81–4.98:1 |
--sidebar |
#fcfcfc |
#ffffff |
侧栏色;零消费点(无 ui/sidebar.tsx),按契约给两套值备用 |
--sidebar-foreground |
#060607 |
#0d0f12 |
同上 |
--sidebar-primary / -foreground |
var(--brand) / var(--brand-foreground) |
同 | 同上,绑定品牌链(不改写法定值) |
--sidebar-accent |
#ebedef |
#e9ebef |
同上,与 --secondary 同层 |
--sidebar-accent-foreground |
#060607 |
#0d0f12 |
同上 |
--sidebar-border |
#dcdee1 |
#dcdfe4 |
同上,与 --border 同值 |
--sidebar-ring |
var(--ring) |
var(--ring) |
不改 |
--chart-1 |
oklch(0.87 0 0) = #d4d4d4 |
oklch(0.5 0.16 262) = #2c5dbd |
主色 = 品牌 hue(5.96:1 on 白);现状是灰阶图谱,两套主题同值、零消费点 |
--chart-2 |
oklch(0.556 0 0) = #737373 |
oklch(0.52 0.1 215) = #00778d |
低饱和冷辅色(5.05:1) |
--chart-3 |
oklch(0.439 0 0) = #525252 |
oklch(0.5 0.17 292) = #6949ba |
紫,与品牌同族可区分(6.22:1) |
--chart-4 |
oklch(0.371 0 0) = #404040 |
oklch(0.52 0.13 155) = #007e46 |
绿(4.99:1) |
--chart-5 |
oklch(0.269 0 0) = #262626 |
oklch(0.55 0.14 45) = #b2511e |
陶土橙(4.97:1);5 档全部 ≥3:1 且互相可辨 |
--radius |
0.625rem(10px) |
0.375rem(6px) |
控制圆角对齐 Linear 的 6px;派生 sm/md/lg/xl/2xl/3xl/4xl = 3.6/4.8/6/8.4/10.8/13.2/15.6px |
深色 .dark(当前 → 建议,当前值取自 styles.css:163-215)
| 变量 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
oklch(0.145 0 0) = #0a0a0a |
#08090a |
参考的 Void;与现状亮度比仅 1.007,是"贴齐参考"而非换色 |
--foreground |
oklch(0.985 0 0) = #fafafa(18.97:1) |
#e5e5e6 |
Bone:15.83:1,去掉纯白的"发光感",让强调色有对比余量 |
--card |
oklch(0.205 0 0) = #171717 |
#0f1011 |
Carbon:卡片沉到面板与浮层之间,与 Void 1.10:1(现状 #171717 与 #0a0a0a 1.20:1,阶梯过陡) |
--card-foreground |
#fafafa |
#e5e5e6 |
15.13:1 on card |
--popover |
#171717 |
#161718 |
Obsidian:浮层最高层(dialog.tsx 用 bg-popover),14.26:1 |
--popover-foreground |
#fafafa |
#e5e5e6 |
随 --foreground |
--secondary |
oklch(0.269 0 0) = #262626 |
#1c1e21 |
搜索框底/次级按钮;13.27:1 |
--secondary-foreground |
#fafafa |
#e5e5e6 |
随 --foreground |
--muted |
#262626 |
#161718 |
凹陷填充:与 --card 齐平、比 --background 高一档(1.14:1) |
--muted-foreground |
oklch(0.708 0 0) = #a1a1a1(7.66:1,偏亮、拉不开层级) |
#8a8f98 |
Fog:6.13:1 on 底 / 5.86:1 on 卡片 / 4.72:1 on --accent,仍全达标 |
--accent |
#262626 |
#23252a |
Slate:hover 填充 + 他人气泡底;文字 13.23:1,气泡与底 1.30:1(现状 1.15:1,气泡更成形) |
--accent-foreground |
#fafafa |
#eeeef0 |
随 --foreground(略降避免气泡内过亮) |
--destructive |
oklch(0.704 0.191 22.216) = #ff6467(6.85:1,荧光) |
#eb5757 |
Coral:5.73:1 on 底 / 5.47:1 on 卡片,去掉荧光感 |
--border |
oklch(1 0 0 / 10%) → 合成 #222222(1.24:1) |
#23252a |
改成不透明实体值:现状在 --card #171717 上叠 10% 白会随底色漂移;实体色保证跨层一致 |
--input |
oklch(1 0 0 / 15%) → 合成 #3a3a3a(1.58:1) |
#6b7178 |
控件轮廓 3.86:1 on 卡片 / 3.64:1 on 浮层,满足 1.4.11 |
--ring |
未声明 → 继承 var(--brand) |
未声明(继承) | 保持原结构:链式解析到深色 --brand |
--brand |
oklch(0.68 0.15 256) = #5599f3 |
#6e9bf7 |
主色;配 --brand-foreground #0a0c11 得 7.17:1(Linear 式"亮底 + 近黑字") |
--brand-foreground |
oklch(0.16 0.02 258) = #080d16 |
#0a0c11 |
近黑字:7.17:1(现状 #080d16 在 --brand 上 6.82:1,同时与 --ink 收敛到同族) |
--brand-soft |
oklch(0.28 0.05 256) = #182941 |
#1b2440 |
选中/徽标底,配 --brand-ink 8.67:1 |
--brand-ink |
oklch(0.84 0.09 256) = #a4cdff |
#a8c3fe |
选中导航文字(8.67:1);与浅色 --brand-ink 同角色 |
--message-self |
#203b59 |
#17203a |
自己气泡:与品牌 hue 对齐(现状偏青蓝),文字 12.74:1 |
--message-self-foreground |
#e7f3ff |
#dbe5fb |
随气泡色重算(12.74:1) |
--surface-chat-soft |
oklch(0.32 0.06 250) = #193550 |
#14171d |
零消费点;给中性软底备用(现状偏蓝且过亮) |
--surface-chat-selected |
oklch(0.28 0.04 250) = #192a3c |
#23262c |
会话/频道选中底(chrome.ts selectedRow),中性化后靠 --brand-ink 表达选中 |
--mention |
oklch(0.72 0.14 254) = #62a7fa(7.94:1 on 底,在气泡上不适配) |
#8cb2ff |
@提及:7.25:1 on --accent 气泡(气泡是它真正的宿主) |
--ink |
oklch(0.16 0.02 258) = #080d16 |
#0a0c10 |
rtc 视频框/落地深底,与 --brand-foreground 同族 |
--surface-rail |
#e3e5e8(bug:浅色值,15.69:1 浅竖带) |
#101114 |
修 bug:与画布 1.06:1 |
--workspace-background |
radial-gradient(ellipse at 8% 0%, color-mix(in oklab, var(--brand) 10%, var(--muted)), var(--muted) 64%) |
linear-gradient(180deg, #0b0c0e, #08090a) |
去掉品牌色晕染的径向渐变(参考纪律:全局不做装饰渐变),只留一层极浅纵向阶梯 |
--workspace-rail-background |
color-mix(in oklab, var(--background) 45%, transparent) |
color-mix(in oklab, var(--background) 60%, transparent) |
保留半透明结构,仅提高遮盖度,让导轨在画布上稳定成形 |
--workspace-header-background |
linear-gradient(180deg, color-mix(background, brand 3%), background) |
var(--background) |
拉平渐变:头部只做面板色(层级交给内容区,不靠"顶部微微发蓝") |
--interactive |
未声明 → 继承浅色 #4e5058(深色下 2.46:1,不可读) |
#b4bac3 |
补声明:10.20:1 on 底 / 8.55:1 on --secondary |
--channel-icon |
未声明 → 继承浅色 #80848e(深色下 5.29:1,勉强但偏暗) |
#8f949e |
补声明:6.26:1 on 卡片 / 6.55:1 on 底 |
--sidebar |
oklch(0.205 0 0) = #171717 |
#0f1011 |
零消费点;与 --card 同层备用 |
--sidebar-foreground |
#fafafa |
#e5e5e6 |
同上 |
--sidebar-primary / -foreground |
未声明(继承 var(--brand) / var(--brand-foreground)) |
未声明(继承) | 保持链式解析(深色下自动得 #6e9bf7 / #0a0c11) |
--sidebar-accent |
#262626 |
#1c1e21 |
零消费点;与 --secondary 同层 |
--sidebar-accent-foreground |
#fafafa |
#e5e5e6 |
同上 |
--sidebar-border |
oklch(1 0 0 / 10%) |
#23252a |
与 --border 同值(实体色) |
--sidebar-ring |
未声明(继承 var(--ring)) |
未声明(继承) | 保持原结构 |
--chart-1 |
oklch(0.87 0 0) = #d4d4d4 |
oklch(0.76 0.12 262) = #87b1fd |
品牌 hue 亮档(8.83:1) |
--chart-2 |
oklch(0.556 0 0) = #737373 |
oklch(0.78 0.09 205) = #6bc8d3 |
青(9.82:1) |
--chart-3 |
oklch(0.439 0 0) = #525252 |
oklch(0.76 0.13 292) = #b3a1fd |
紫(8.56:1) |
--chart-4 |
oklch(0.371 0 0) = #404040 |
oklch(0.78 0.11 155) = #7bcc98 |
绿(9.92:1) |
--chart-5 |
oklch(0.269 0 0) = #262626 |
oklch(0.8 0.12 60) = #f6ab6b |
橙(9.94:1);5 档全部 ≥3:1 |
--radius(未声明,继承 0.375rem) |
继承浅色 0.625rem |
继承 0.375rem |
保持单点定义,两主题一致圆角 |
字体与排版
字体栈整串不动(约束 §2.4:西文字体不得挤掉中文回退)。实测 web/src/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;
- 拉丁走 Geist(几何无衬线,符合参考的"仪器感"),中文第一回退是
Noto Sans SC,macOS 命中系统PingFang SC、Windows 命中Microsoft YaHei。路径①不涉及字体栈,本方案不新增 web font、不新增外链(preview.html也用系统栈预览,见文件头注释)。 - 阴影阶梯
--shadow-e1/e2/e3/pop(styles.css:42-49)与动效令牌--animate-*一字不改:参考的纪律是"描边优先、阴影只给浮层",本项目已有 4 档阴影,够用。
字号/行高阶梯(只由官方档位 + app 既有类名构成)
| 档位 | 用途 | 现状实测 | 本方案 |
|---|---|---|---|
12px / text-xs |
消息元信息(作者、时间)、徽标、成员数 | 作者 13px/400、时间 12px/500 混用;成员数 12px/500 | 统一 12px/500 + --muted-foreground(途径②:ui/message.tsx:63,76 的 text-xs font-medium text-muted-foreground) |
14px / text-sm |
消息正文、任务卡标题、列表项 | 他人 15px/400、自己 14px/400 → 同一列表两种字号;任务卡标题 14px/500 | 统一 14px(途径②:ui/bubble.tsx 的 BubbleContent 自带 text-sm leading-relaxed);行高 1.625 |
| 15px / body | 面板 UI 文案、按钮 | body 15px/400、行高 1.375(20.63px) |
不改(app 类名,非令牌) |
| 16px | 频道名/看板标题 | 16px/600 | 已达标,不改(只改圆角与色) |
| 18–26px | 登录主标题 | 实测 h1 18px/600,类名 text-2xl sm:text-[26px] |
不改字号;只改主色与圆角 |
9.375 / 11.25 / 13.125px |
会话预览、次级说明 | 15px 上的 0.625em/0.75em/0.875em 派生(实测 S1 预览 11.25px) |
风险项:非官方档位、非令牌可改,需第④条替换为 12px |
12.8px(text-[0.8rem]) |
官方 Button size="sm",被大量统计文字借用 |
实测 S3 AI 空间 12.8px/500 | 风险项:这是官方档位但偏小,官方没有 13px;建议统一收到 12px(text-xs)或升到 14px(text-sm),二选一由产品定 |
中文排版三条纪律
- 不给中文正文加负字距:现有
tracking-tight(login-code-form.tsx:262)只出现在含拉丁的标题上,保留原样;不新增任何负字距,避免与 em 派生小字号叠加导致中文挤字。 - 行宽(密度改造,途径③):主区实测宽度
860px,15px 中文单字宽 ≈15px → ≈57 字/行,超出中文舒适区 35–45 字;消息列限宽max-w-[44rem](704px ≈ 47 字/行),超出部分留给空白而不拉伸气泡。 - 数字/编号用
--font-mono:任务编号、时间戳、kbd-chip(styles.css:229已用--font-mono+ 10px)保持等宽;建议补tabular-nums(属 className,第④条,本方案不实施)。
关键界面改造
读法: 每条改造标注路径 ①令牌 / ②官方 variant·size / ③容器布局;"现状"全部是简报 §3.3 与 localtmp/design-render/*.json 的实测值;"改后"是由令牌取值推导的合成值(sRGB 混合与 WCAG 公式自算,见 §7 方法),不是截图。凡令牌管不到的,一律写成"风险(需第④条)",不进业绩。
S1 外壳 + 空间/频道侧栏(1440×900,实测 rail nav 72×900、会话侧栏 aside 256×715 @x=76、头部 52px)
| # | 改造 | 途径 | 现状实测 | 改后预期值 |
|---|---|---|---|---|
| 1 | 外壳画布去蓝:导轨与画布底的蓝紫收成中性石墨灰 | ① | --surface-rail #e1e8f2;--workspace-background 终点 #e1e5f1;画布↔面板 1.202 / 1.227 |
#e5e7eb / #dfe1e5;画布↔面板 1.197 / 1.266(色相归中性,强度不掉) |
| 2 | 面板↔卡片阶梯:面板退半步、卡片留白 | ① | 面板 #fcfcfc、卡片 #ffffff → 1.02:1 |
面板 #fbfbfc、卡片 #ffffff → 1.06:1 |
| 3 | 选中行从"蓝底"改"中性底 + 蓝字" | ① | --surface-chat-selected #e5ecfc + --brand-ink #1d4ed8(对比 8.5:1) |
#e3e8f0 + #1b3fb0 → 7.16:1(仍远超 4.5:1,且整行不再偏蓝) |
| 4 | 侧栏搜索框:底、圆角 | ① | 高 30px、圆角 10px(rounded-xl)、底 rgba(235,238,239,0.75) 合成 #eff1f2(vs 面板 1.10:1) |
圆角 8.4px(--radius 派生);底经 --secondary/75 合成 #eeeff2(vs 面板 1.11:1) |
| 5 | 导航/侧栏圆角收敛 | ① | 侧栏面板实测圆角 14px;选中项 10px | 8.4px(rounded-xl = --radius×1.4);全局圆角从 12 档收敛到 6 档 |
| 6 | 头像底与描边 | ① | 头像底 rgba(251,251,251,0.85)(off-token 硬编码) |
不变(风险:硬编码,第④条) |
| 7 | 会话行 240×64、头部 52px | ③ | 64px 行承载标题+预览+时间三行 | 保持:压缩行高会牺牲预览可读性,密度改进放到消息区行宽(S2#6),不靠缩字号 |
| 8 | 侧栏与主区层级 | — | imListAside = "bg-background",两栏同色,仅靠 1px 缝隙 + ring-foreground/[0.06](合成 1.141:1) |
风险(需第④条):令牌改不掉。且 --foreground #060607→#0d0f12 使 6% 描边合成对比 1.141→1.131(略降),如实披露;补偿来自 #1(画布压深)与 S2#6(限宽后两侧留白) |
S2 频道消息流(实测频道头 860×52、气泡圆角 14px、他人气泡 rgb(235,237,239)、自己气泡 rgb(232,243,254)+文字 rgb(13,39,74)、正文 15/14px、作者 13px、时间 12px、输入框 628×33)
| # | 改造 | 途径 | 现状实测 | 改后预期值 |
|---|---|---|---|---|
| 1 | 气泡改用官方 Bubble 变体与对齐:他人 <Bubble variant="secondary" align="start">、自己 <Bubble align="end"> |
② | 自绘气泡,圆角 14px、--accent/--message-self 分别承担两侧 |
圆角 8.4px、正文 text-sm(14px)、内距 px-3 py-2、行高 1.625(全部来自官方 BubbleContent,随 --radius 变化) |
| 2 | 自己气泡配色方案二选一(令牌联动) | ①×② | --message-self #e8f3fe / --message-self-foreground #0d274a(13.29:1) |
推荐保留 --message-self(克制):改值 #e8edfc / #1b2f6b → 10.78:1;若改走官方 variant="tinted",则由 oklch(from var(--primary) 0.93 calc(c*0.4) h) 自动派生 #cfe8ff(文字 15.21:1,深色 #1e2d4b/10.89:1)——改 --brand 即自动跟随,但色调更饱和,取舍见 §10 |
| 3 | 他人气泡底 | ① | --accent #ebedef(vs 面板 1.14:1) |
#e6e9ee(vs 面板 1.18:1,深色 #23252a vs 卡片 1.24:1 / vs 底 1.30:1) |
| 4 | 元信息统一 12px | ② | 作者 13px/400 rgba(93,94,103,0.70)、时间 12px/500 |
官方 MessageHeader/Footer:12px/500 + --muted-foreground #5f646c → 面板上 5.76:1(现状 off-token 70% 灰≈4.5:1 边缘) |
| 5 | 输入区描边与圆角 | ① | textarea 628×33 无边框;外层仅上边框 rgb(220,222,225);工具按钮 28×28 |
上边框 → --border #dcdfe4(1.29:1 on 面板,去蓝);圆角随 --radius;28×28 触控目标保留(tap-target 工具类给粗指针 44px 命中区,不动) |
| 6 | 消息列限宽 + 分组间距 | ③ | 消息列随主区 860px → ≈57 字/行 | max-w-[44rem](704px ≈47 字/行),同作者连续消息由官方 BubbleGroup 提供 8px 组内间距 |
| 7 | 正文 15/14px 分歧 | — | 自绘气泡 14px / 他人 15px | 风险(需第④条):分歧在 message-list.tsx 的 className;走官方 Bubble 后自动消失,但当前组件仍是自绘 |
| 8 | 频道头 | ① | 标题 16px/600 #060607;成员数 12px/500 #5c5e66 |
标题 --foreground #0d0f12(18.56:1);成员数 --muted-foreground(5.76:1);分隔线 --border 去蓝 |
S3 任务大厅 + 任务卡(实测看板标题 16px、「全部频道 / 5 项任务」、列头「待补充 0 / 待处理 5」、卡片标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人、圆角 10px×48 与 8px×37 混用;AI 助手空间 395 项任务里 12.8px/500、12px/500、12px/400、14px/400 四种字号并存)
| # | 改造 | 途径 | 现状实测 | 改后预期值 |
|---|---|---|---|---|
| 1 | 任务卡统一走官方 Card,用 data-[size=sm] 收紧卡内间距 |
② | 自绘卡(rounded-xl + app 自带 padding) |
官方 Card:rounded-xl = 8.4px、ring-1 ring-foreground/10 描边、data-[size=sm] 卡内间距;卡面 --card #ffffff(面板 1.06:1) |
| 2 | 卡片描边来自 ring-foreground/10(10% 前景) |
— | 实测卡片描边 rgba(219,222,225,0.70) |
合成 #e9eaeb(vs 白 1.19:1)→ 风险:卡片是容器不是控件,按 1.4.11 豁免;要更强须改组件(第④条) |
| 3 | 6 个任务状态改用官方 Badge variant + 文字/图标 |
② | 自绘 chip rounded-full border px-1.5 py-0.5 + amber/slate 硬编码 |
映射:待补充=outline、待处理=secondary、进行中=default(品牌蓝底白字 6.21:1)、待验收=outline、已完成=secondary、已关闭=ghost;颜色只承接"进行中(品牌)/需注意(destructive #c0272d 白底 5.88:1)"两处语义,其余靠文字与图标区分 |
| 4 | 状态 chip 的 amber/slate 硬编码 | — | tone.ts + task-hall.tsx 共 253 处调色板泄漏集中在任务面(amber 69 / rose 68 / slate 44…) |
风险(需第④条):令牌完全管不到,深色下这些浅底色块会与 #08090a 底对冲;见 §3 第 7 条与 §9 |
| 5 | 看板栅格与卡片间距 | ③ | 列内/列间间距由容器决定(现状未令牌化) | 列内卡片 gap-2(8px)、列间 gap-4(16px)、列最小宽 280px;卡片标题 14px/500 保留(已达标) |
| 6 | 频道 chip / AI 助手 chip / 查看任务 |
② | 自绘 chip | 官方 Badge variant="outline" + Badge variant="secondary";查看任务 走 Button variant="ghost" size="sm"(6px 圆角) |
| 7 | 负责人(头像 + 姓名) | ② | 头像 + 姓名并列 | 官方 Avatar + 姓名 text-xs + --muted-foreground(5.76:1) |
| 8 | 计数文案「全部频道 / 5 项任务」 | ① | #5c5e66 级灰 |
--muted-foreground #5f646c(5.76:1);标题 16px/600 保留 |
| 9 | 圆角混用 10/8px | — | 实测 10px×48、8px×37(硬编码 rounded-[10px] 等) |
部分风险:官方 Card/Badge/Button 随令牌收敛(8.4/15.6/6px),硬编码的 10px 与 8px 不受影响 → 第④条 |
| 10 | 12.8px 统计字号 | ② | 12.8px/500×2765、12px/500×2381、12px/400×1994、14px/400×1724 | 部分可修:12.8px 来自官方 Button size="sm" 的 text-[0.8rem],改用 Badge(12px) 或 Button size="xs"(12px, text-xs) 即回到官方小档;其余 em 派生字号(9.375/11.25/13.125px)需第④条 |
S7 登录页(实测:居中卡片、主标题 26px、切换块 173×42、主按钮 356×52 白字 #2563eb、页脚 11px、radii 32px×1 + 18px×4;auth-shell.tsx:18 bg-muted/40、:25 rounded-2xl border bg-card p-6 shadow-e2)
| # | 改造 | 途径 | 现状实测 | 改后预期值 |
|---|---|---|---|---|
| 1 | 品牌主色与主按钮 | ① | --brand #2563eb,白字 5.17:1 |
#2f56d2,白字 6.21:1(login-code-form.tsx:41 的 h-[52px] 主按钮尺寸不动) |
| 2 | 画布↔卡片阶梯(bg-muted/40 合成) |
① | 合成 #f8f8f9,卡片白 → 1.061:1 |
合成 #f6f7f8 → 1.073:1;如实披露:画布权重只有 40%(bg-muted/40),令牌只能改一半,风险(第④条):改成 bg-muted 全量可到 1.22:1 |
| 3 | 圆角收敛 | ① | 卡片/按钮实测 18px(rounded-2xl)、页内另有 32px×4? 实测 radii = 32px×1 + 18px×4 |
18px → 10.8px;32px 属于硬编码 → 保持不变(风险) |
| 4 | 分段控件(邮箱/短信) | ① | 选中底 rgb(37,99,235) 系、文字 #1d4ed8 |
选中底 --brand-soft(合成 #e3e7f7)+ 文字 --brand-ink → 7.15:1;173×42 尺寸不动 |
| 5 | 表单控件轮廓 | ① | --input #dcdee1 → 1.35:1(表单是登录页主体,几乎不可见) |
#8b9199 → 3.18:1 on 白 / 3.07:1 on 面板,满足 1.4.11 |
| 6 | 品牌标记方块(size-9 rounded-xl border-brand/25 bg-brand-soft) |
① | rounded-xl 10px、bg-brand-soft 12% 蓝 |
8.4px + --brand-soft 合成 #e3e7f7(与选中态同一块色,视觉语言统一) |
| 7 | 页脚「WanChat Enterprise」11px | — | 11px(em 派生) | 风险:非官方档位,需第④条 |
| 8 | 布局节奏 | ③ | 卡片在 1440×900 居中;p-6(24px)、主按钮 356×52 |
全部保留:登录页是品牌门面,不压密度,只把层级与对比度做对(#1–#6);表单字段间距在卡片内保持 16px 节距 |
S5 管理设置弹窗(实测 [role=dialog] 704×512、圆角 18px、bg #ffffff、标题 18px/600;左导航项 135×36 圆角 8px,选中 rgba(37,99,235,0.12) + 文字 #1d4ed8;危险项 #da373c;输入框 488×32 圆角 10px;标签 14px)
| # | 改造 | 途径 | 现状实测 | 改后预期值 |
|---|---|---|---|---|
| 1 | 弹窗面与圆角 | ① | #ffffff(=--popover)、圆角 18px |
浅色 #ffffff / 深色 #161718(Obsidian,文字 14.26:1);圆角 10.8px(rounded-2xl = --radius×1.8);浮层阴影 --shadow-pop 不动 |
| 2 | 左导航选中态 | ① | 底 rgba(37,99,235,0.12)、文字 #1d4ed8 |
底 --brand-soft 合成 #e3e7f7、文字 --brand-ink #1b3fb0 → 7.15:1;深色 #1b2440/#a8c3fe → 8.67:1 |
| 3 | 左导航项圆角 8px | ① | 实测 8px(与 rounded-md 6.4px、rounded-lg 10px 都不符,疑为硬编码 rounded-[8px]) |
风险:令牌改后官方档位是 4.8/6/8.4px,硬编码 8px 不变;建议用官方 rounded-lg(6px) |
| 4 | 危险操作色 | ① | #da373c 白底 4.57:1 |
#c0272d 白底 5.88:1;深色 #eb5757(卡片上 5.47:1) |
| 5 | 输入框 488×32、圆角 10px | ① | --input #dcdee1 1.35:1、圆角 10px |
轮廓 #8b9199 3.18:1(深色 #6b7178 3.86:1);圆角 6px(rounded-lg) |
| 6 | 标签 14px、标题 18px/600 | ② | 已达标 | 不改;标签色 --foreground(18.56:1)、次要说明 --muted-foreground(5.76:1) |
| 7 | 704×512 两栏结构 | ③ | 左导航 135px + 内容区 | 保留;只把内容区设为独立滚动、页脚常驻(避免长表单把"保存"挤出视口) |
S8 应用中心(实测分类筛选 8 项 + 「共 14 个应用」+ 卡片:运行中/开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息;app-center.tsx:1189 AppCard rounded-xl border-0 bg-card p-5 shadow-[0_0_18px_-2px] shadow-foreground/10 + <Badge variant="secondary">)
| # | 改造 | 途径 | 现状实测 | 改后预期值 |
|---|---|---|---|---|
| 1 | 应用卡面与圆角 | ① | bg-card、rounded-xl 14px |
深色卡面 #0f1011(与 Void 面板 1.10:1);圆角 8.4px |
| 2 | 卡片光晕 | ① | shadow-[0_0_18px_-2px] shadow-foreground/10(由 --foreground 派生,合成 #e3e3e5) |
随 --foreground → #0d0f12 重算(10% 合成强度基本不变);风险:该阴影是硬编码类,不随 --shadow-e2 走 |
| 3 | 状态徽标 | ② | Badge variant="secondary" 同时用于「运行中」和「开发中」 |
拆成语义:运行中 = default(品牌蓝,白字 6.21:1 / 深色 #6e9bf7 上近黑字 7.17:1)、开发中 = secondary(中性);官方 variant 即可区分,不需要新色 |
| 4 | 分类筛选 8 项的选中态 | ①×② | 现有 aria-pressed:bg-brand-soft aria-pressed:text-brand-ink(:1141,已是令牌链) |
值改后自动生效:底 #e3e7f7 + 文字 7.15:1;尺寸用 Button size="xs"/"sm" + --tap-target 保 44px 命中区 |
| 5 | emoji 图标(应用图标位) | — | 内容是 emoji 文本 | 不改(属内容层,非样式途径);若要统一可换官方 Avatar + 首字回退,但那会改内容,超出本方案范围 |
| 6 | 硬编码底色 | — | bg-[#f5f6f7](:572)、bg-white(:576)、border-amber-200 bg-amber-50/95(:582)、amber 提示条(:961) |
风险(需第④条):令牌管不到;深色下 bg-white 会把整块 iframe 容器点亮成白,是深色交付的首要阻塞点 |
| 7 | 栅格与间距 | ③ | 卡片列表(14 个应用) | gap-4(16px)、列数按容器宽度自适应(1/2/3/4 列)、卡片 p-5 保留(应用名 + 元信息两行) |
S4 AI 助手频道(agent-chat-panel.tsx:bg-background、附属栏 w-[17.5rem] + border-r border-border/45、会话项 rounded-xl、代码块 bg-muted text-[13px];agent-channel-results.tsx/message-markdown.tsx 消费 --mention)
| # | 改造 | 途径 | 现状实测 | 改后预期值 |
|---|---|---|---|---|
| 1 | 附属栏分隔线 | ① | border-border/45,合成 1.122:1(几乎不可见) |
去蓝后仍 1.122:1(同强度)→ 风险(需第④条):要可见须改 border-border 全量(可达 1.29:1) |
| 2 | 代码块 | ① | bg-muted text-[13px] |
底 #eef0f3(vs 面板 1.10:1,深色 #161718 vs 底 1.11:1);13px 属非官方档位 → 风险(建议 text-sm,第④条) |
| 3 | 会话列表项圆角 | ① | rounded-xl 14px |
8.4px |
| 4 | @提及 / 引用块 | ① | --mention #3370ff 在 --accent 气泡上仅 3.65:1(不达标) |
#1b3fb0 → 7.24:1(气泡上)/ 7.53:1(自己气泡上);深色 #8cb2ff → 7.25 / 7.61:1 — 本方案最实在的对比度修复之一 |
| 5 | AI 等待态呼吸点 | ① | --animate-breathe(不动)、点色走前景 |
点色 --brand;不新增动效令牌 |
| 6 | 主区列宽 | ③ | 与消息面共用 860px 主区 | 差异化限宽:消息面 max-w-[44rem](700px 级)、AI 回答面 max-w-[52rem](832px)——AI 内容含表格与代码块,过窄会横向滚动;这是有依据的取舍,不是遗漏 |
S6 语音频道(该栈不可见,依据是代码 + 库表,不是截图)
- 事实链:
web/src/components/app/rtc-group-call-ui.tsx存在;TRTC_ENABLED=false时 DOM 内按aria-label匹配「语音|通话|加入」命中 0,/api/v1/rtc/*返回RTC_DISABLED;库表wanman3_rtc_voice_channels30 行、wanman3_rtc_calls183 行、会议纪要 20 行 → 数据模型已建,前端开关关闭。 - 令牌层面可行的准备(不臆造视觉):成员格分层用
--accent(说话中)/--card(静音),说话中标签用--brand-soft+--brand-ink(深色 8.67:1),视频框底用--ink;voice-channel-section.tsx已经消费--brand-ink与--channel-icon,有真实消费点,所以这两处取值改动在该面同样生效。 - 明确的边界:无法实测,本方案不为 S6 给出任何"改后实测值",只声明令牌就绪。
深浅色与对比度
方法(可复算): WCAG 2.1 相对亮度 L = 0.2126R + 0.7152G + 0.0722B(sRGB 通道先按 c/12.92 或 ((c+0.055)/1.055)^2.4 线性化),比值 (L1+0.05)/(L2+0.05)。半透明值先按 sRGB 通道在目标底上做 alpha 合成再计算(例:--input 深色 oklch(1 0 0 / 15%) 在 #171717 上合成 #3a3a3a);oklch → sRGB 转换已自校验:oklch(0.145 0 0)=#0a0a0a、oklch(0.68 0.15 256)=#5599f3、oklch(0.985 0 0)=#fafafa。
浅色(建议值)
| 前景 | 底 | 比值 | 门槛 |
|---|---|---|---|
--foreground #0d0f12 |
--background #fbfbfc |
18.56:1 | ≥4.5 ✔ |
--foreground #0d0f12 |
--card #ffffff |
19.19:1 | ✔ |
--muted-foreground #5f646c |
#ffffff / #fbfbfc / --muted #eef0f3 / --accent #e6e9ee |
5.96 / 5.76 / 5.22 / 4.89:1 | ✔ 全部 ≥4.5 |
--brand-ink #1b3fb0 |
#ffffff |
8.81:1 | ✔ |
--brand-ink #1b3fb0 |
--surface-chat-selected #e3e8f0 |
7.16:1 | ✔(选中行文字) |
--brand-ink #1b3fb0 |
--brand-soft 合成 #e3e7f7 |
7.15:1 | ✔(徽标/分段选中) |
--mention #1b3fb0 |
--accent #e6e9ee(他人气泡)/ --message-self #e8edfc |
7.24 / 7.53:1 | ✔(现状 #3370ff 仅 3.65:1,不达标) |
--message-self-foreground #1b2f6b |
--message-self #e8edfc |
10.78:1 | ✔ |
--brand-foreground #ffffff |
--brand #2f56d2 |
6.21:1 | ✔(现状 5.17:1) |
--destructive #c0272d |
#ffffff |
5.88:1 | ✔(现状 4.57:1,不达标) |
--interactive #4f545c |
#fbfbfc / --secondary #e9ebef |
7.37 / 6.39:1 | ✔ |
--channel-icon #6b7079 |
#ffffff / #fbfbfc |
4.98 / 4.81:1 | ✔(现状 #80848e 3.74/3.65,不达标) |
--input #8b9199 |
#ffffff / #fbfbfc |
3.18 / 3.07:1 | ≥3 ✔(WCAG 1.4.11 控件边界;现状 1.35:1,不达标) |
--border #dcdfe4 |
#ffffff / #fbfbfc |
1.34 / 1.29:1 | 有意 <3:1,见下方豁免说明 |
--chart-1..5 |
#ffffff |
5.96 / 5.05 / 6.22 / 4.99 / 4.97:1 | ✔ 全部 ≥3(现状是灰阶 #d4d4d4…,且零消费点) |
深色(建议值)
| 前景 | 底 | 比值 | 门槛 |
|---|---|---|---|
--foreground #e5e5e6 |
--background #08090a / --card #0f1011 / --popover #161718 / --secondary #1c1e21 |
15.83 / 15.13 / 14.26 / 13.27:1 | ✔ |
--accent-foreground #eeeef0 |
--accent #23252a |
13.23:1 | ✔ |
--muted-foreground #8a8f98 |
#08090a / #0f1011 / --accent #23252a |
6.13 / 5.86 / 4.72:1 | ✔ 全部 ≥4.5 |
--brand-foreground #0a0c11 |
--brand #6e9bf7 |
7.17:1 | ✔ |
--brand-ink #a8c3fe |
--brand-soft #1b2440 |
8.67:1 | ✔(选中导航) |
--message-self-foreground #dbe5fb |
--message-self #17203a |
12.74:1 | ✔ |
--mention #8cb2ff |
--accent #23252a / --message-self #17203a |
7.25 / 7.61:1 | ✔ |
--destructive #eb5757 |
#08090a / #0f1011 |
5.73 / 5.47:1 | ✔ |
--interactive #b4bac3 |
#08090a / #1c1e21 |
10.20 / 8.55:1 | ✔(现状未声明 → 继承浅色 #4e5058,深色下仅 2.46:1) |
--channel-icon #8f949e |
#0f1011 / #08090a |
6.26 / 6.55:1 | ✔(现状未声明,继承浅色 #80848e) |
--input #6b7178 |
#0f1011 / #161718 |
3.86 / 3.64:1 | ≥3 ✔(现状合成 #3a3a3a = 1.58:1,不达标) |
--border #23252a |
#08090a / #0f1011 |
1.30 / 1.24:1 | 有意 <3:1,见下 |
--chart-1..5 |
#08090a |
8.83 / 9.82 / 8.56 / 9.92 / 9.94:1 | ✔ |
豁免与残留(必须讲清的两件事)
--border有意低于 3:1(浅 1.29–1.34:1 / 深 1.24–1.30:1)。 依据 WCAG 1.4.11 只要求"识别控件所必需的视觉边界"达到 3:1;卡片/面板的装饰分隔线、ring-foreground/[0.06](合成 1.13:1)、border-border/45(1.12:1)都不承担控件识别,属装饰。控件边界另由--input承担 3.18:1 / 3.86:1。 这是取舍,不是遗漏。- 深色交付的前置依赖(超出 ①/②/③)。 实测注入
.dark后令牌生效,但界面里仍有不改的硬编码前景:rgb(6,6,7)55 处、rgb(92,94,102)27 处、边框rgb(220,222,225)6 处、浅色头像底 3 处;--surface-rail原先还留着浅色值(本方案已修)。因此结论是:令牌改完只解决"官方组件面"的深色;任务状态 chip、应用中心bg-white等硬编码面必须走第④条清扫,否则深色主题只能算半成品。 同时.dark在生产不可达(全仓无注入点),需要一并补主题开关——同属第④条。
shadcn 兼容性
基线: web/components.json → style: "base-nova"、baseColor: "neutral"、iconLibrary: "lucide"、css: "src/styles.css";ui/ 下现成 38 个组件。本方案不新增依赖、不新增自定义 variant、不改任何组件源码,只用官方枚举值 + 令牌取值 + 容器布局。
| 组件 | 用到的官方 API | 本方案用法 | 是否越界 |
|---|---|---|---|
Button |
variant: default/outline/secondary/ghost/destructive/link;size: default/xs/sm/lg/icon/icon-xs/icon-sm/icon-lg;基类 rounded-lg |
主 CTA default;「查看任务」ghost size="sm";工具栏 icon-sm;删除 destructive |
否(圆角随 --radius → 6px) |
Badge |
variant: default/secondary/destructive/outline/ghost/link |
6 个任务状态 = variant + 文字 + 图标(映射见 S3#3);应用中心状态 default/secondary |
否 |
Card |
data-[size=sm] |
任务卡、应用卡用 Card;紧凑间距用官方 size 变体 |
否 |
Input / Field / FieldSelect |
h-8 rounded-lg border-input bg-transparent md:text-sm |
登录页/设置弹窗表单 | 否(轮廓色由 --input 3:1 达标) |
Tabs |
variant: default/line |
设置弹窗左导航(line 或保留 aria-pressed 列表);消息区/任务区切换 |
否 |
Dialog / AlertDialog |
rounded-xl bg-popover |
S5 弹窗、删除确认 | 否(深色面 #161718) |
Bubble / BubbleContent |
variant: default/secondary/muted/tinted/outline/ghost/destructive;align="start/end";rounded-xl px-3 py-2 text-sm leading-relaxed |
他人 secondary+start、自己 end(或 tinted,由 --primary 派生 #cfe8ff/#1e2d4b) |
否 |
Message / MessageHeader / MessageFooter / BubbleGroup |
text-xs font-medium text-muted-foreground、gap-2 |
元信息统一 12px、组内间距 8px | 否 |
Avatar / Separator / ScrollArea / ScrollRegion / ScrollSurface |
官方尺寸与滚动原语 | 负责人头像、分隔线、独立滚动区(③) | 否 |
Skeleton / Table / Tooltip / Popover / Select |
官方默认 | 未改(沿用令牌) | 否 |
官方能力边界(不掩饰的 4 条):
Badge没有info/success/warning变体 → 6 个任务状态无法仅靠官方 variant 表达;本方案不新增 variant,改用「variant + 文字 + 图标」,颜色只留"进行中=品牌 / 需注意=destructive"两处语义。Card的描边是ring-1 ring-foreground/10→ 强度由--foreground决定,令牌无法独立调(合成 1.19–1.24:1);要更强需要改组件(第④条)。Bubble variant="tinted"用相对色语法oklch(from var(--primary) 0.93 calc(c*0.4) h)→ 令牌联动实现了,但色的明度/彩度被组件锁死(浅色#cfe8ff、深色#1e2d4b),不能再调;这是选--message-self还是tinted的唯一技术分歧点(§10)。Badge的rounded-4xl在h-5上仍是近胶囊形(--radius改后 15.6px vs 高度 20px)→ 参考里 4px 的小徽标在本栈不可达,属组件硬编码。
实施成本
途径①②③ 之内(本方案主张的全部改造):
| 面 | 途径 | 涉及文件 | 改动量 | 风险 |
|---|---|---|---|---|
| S1 外壳/侧栏 | ① + ③ | web/src/styles.css 的 :root/.dark |
约 12 个变量 | 低 |
| S2 消息流 | ① + ② | 令牌 + message-bubble.tsx/message-list.tsx 传参(Bubble variant/align、MessageHeader/Footer,不改样式类、不加自定义 variant) |
约 10 个变量 + 2 处用法 | 中(灰区:仍需碰组件文件,但视觉来自官方 variant) |
| S3 任务卡 | ① + ② | 令牌 + task-hall.tsx 状态 chip 换官方 Badge |
约 6 个变量 + 1 处用法 | 中(同灰区) |
| S5/S7/S8 | ① + ③ | 纯令牌 + 容器间距 | 0 组件 | 低 |
| S4 AI 频道 | ① | 纯令牌 | 0 组件 | 低 |
| 合计 | — | web/src/styles.css 一处 + 3 个组件文件的用法(非样式) |
约 60–80 行 CSS、0 新依赖、0 组件分叉 | — |
途径之外(第④条,需显式批准;不批准则深色交付降级为"设计对等但产品不可见"):
| # | 事项 | 规模(实测) |
|---|---|---|
| 1 | .dark 主题开关(<html data-theme="dark"> + localStorage 键 + 系统偏好初始化),并把 styles.css:971 的 .dark .emoji-mart-shell em-emoji-picker 一并改为 [data-theme="dark"] … |
全仓当前无注入点(现有先例是 html[data-desktop-titlebar]),需新增约 30 行 |
| 2 | 硬编码前景清扫:rgb(6,6,7)、rgb(92,94,102)、rgb(220,222,225) 边框、浅色头像底 |
91 处(55 + 27 + 6 + 3) |
| 3 | Tailwind 调色板泄漏(任务状态、应用中心、AI 面) | 253 处 / 44 个非测试文件,首恶 tone.ts、task-hall.tsx、app-center.tsx |
| 4 | 非官方字号 9.375 / 11.25 / 13.125px(em 派生) | 收敛为官方 12/14px 两档 |
| 5 | 硬编码圆角(与令牌档位冲突的 10/8/32px 等) | 13 处 |
| 6 | 侧栏/主区零层级(chrome.ts imListAside/imSplitPanel) |
2 处类名 |
| 7 | 应用中心 bg-[#f5f6f7] / bg-white / amber 提示条;登录页 bg-muted/40 |
5 处 |
验证说明(我的边界): 按任务约束,我没有运行任何构建、测试、lint,也没有起浏览器或截图;上述"改后值"全部是从令牌取值推导的合成/对比度值。主 agent 收口后建议先跑一次 web 构建与现有测试,并优先目视 6 个面:S1 侧栏选中、S2 自己/他人气泡、S3 状态 chip、S5 弹窗左导航、S7 主按钮与输入框、以及深色下的应用中心(该处最可能出问题)。
6 个月维护性: 令牌集中一处、组件零分叉、零新依赖,改色/改圆角是单点操作;真正的长期熵不在令牌,而在第④条清单里的硬编码调色板——只要它不清完,"换主题"永远是半成品,这一点应写进后续排期而不是靠令牌硬撑。
取舍
明确放弃(来自参考但不采用): acid lime 荧光色、纯黑 #000、装饰性渐变(深色原本的品牌色径向晕染被拉平成 linear-gradient(180deg,#0b0c0e,#08090a))、玻璃拟态;不新增自定义 variant、不引入 web font、不改字体栈、不动动效与阴影令牌。
三处"承认做不到"(都会在其他方案里被比较,必须写清):
- 徽标形态:官方
Badge的rounded-4xl在h-5上仍是近胶囊(15.6px vs 20px 高),参考里 4px 的小徽标不可达。 - 卡片圆角:
--radius是单点派生根,卡片/弹窗的rounded-xl= 8.4px,达不到参考的 12px;想同时要 6px 控制圆角和 12px 浮层圆角,必须改@theme的派生系数(等于动 shadcn 约定)。 - 侧栏与主区零层级:
bg-background是代码结构,令牌只能改变"画布更暗"这一半;且--foreground从#060607提到#0d0f12会让ring-foreground/[0.06]从 1.141:1 降到 1.131:1——我选择保留近黑而不是更"柔"的灰,就是为了不让这条唯一的层级线索进一步变弱。
唯一的二选一决策点:自己气泡走"自有令牌 --message-self"(#e8edfc / 文字 10.78:1,克制、可控)还是"官方 Bubble variant="tinted""(自动跟随 --brand 派生 #cfe8ff / 深色 #1e2d4b,色的明度被组件锁死)。本方案推荐前者:整套方案的纪律就是"克制 + 单一色相 + 可控",把气泡色的控制权交给组件的相对色公式与这条纪律相冲突;若项目更看重"改 --brand 即全局联动",则换 tinted,代价是气泡会明显更蓝。
一句话结论: 只改一个 CSS 文件的令牌块,就能让全部官方组件面(外壳、侧栏、消息、任务卡、弹窗、登录、应用中心)在深浅两套主题下同时完成层级、圆角与对比度的改观——其中 5 处从"不达标"变"达标"(--input 1.35→3.18:1、--channel-icon 3.74→4.98:1、--destructive 4.57→5.88:1、--mention 3.65→7.24:1、深色 --input 1.58→3.86:1,以及深色 --interactive 从继承浅色值 2.46:1 补到 10.20:1);代价是必须承认三处结构性缺口(零层级、调色板泄漏、深色开关)走第④条,不假装它们被令牌解决了。
交付自检: 三文件仅含 proposal.md / tokens.css / preview.html;web/ 未改动;未运行构建/测试/lint/浏览器/截图;tokens.css 只含 web/src/styles.css 中真实存在的变量名(@theme inline 原样沿用);深浅两套令牌齐全且对比度均已自算。