Linear 重设计方案 —— 暗夜精密仪器

slug: linear 分支: codex/design-linear 基线: test@3d35969f 交付三件套:docs/design-proposals/linear/{proposal.md,tokens.css,preview.html}(未改动 web/ 任何文件)

方案名与主张

中文方案名:暗夜精密仪器

一句话主张: 用「近黑画布 + 1px 石墨描边 + 唯一色相仪器蓝」当作仪器面板的物理结构,只改语义令牌取值就让任务与消息在深色下可读、在浅色下精密——层级靠 4 级表面阶梯与描边,不靠渐变、阴影堆叠和彩色。

参考提炼

从 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)

  1. 侧栏与主区零层级:components/app/chrome.ts imListAside = "bg-background"、imSplitPanel 同值;实测 S1 会话侧栏 aside 256×715 背景 #fcfcfc,等于 --background。面板之间只靠 1px 缝隙 + md:ring-1 ring-foreground/[0.06];实测该 6% 描边合成 #ededed、对比 1.14:1(几乎不可见)。→ 令牌无法制造这段层级,只能压深外壳画布让缝隙更明显;显著改观需第④条。
  2. 控件描边用的是装饰色: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),本方案最大的一处无障碍收益。
  3. 深色在生产不可达(精确表述):全仓没有任何代码给 <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 面板会在新主题下掉回浅色。
  4. 深色 bug:--surface-rail 是浅色值(.dark 内 #e3e5e8),铺在 #0a0a0a 画布上形成一条 15.69:1 的浅色竖带。→ 令牌可修(#101114)。
  5. 圆角 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),硬编码残留属第④条。
  6. 消息排版分歧:message-list.tsx 自己气泡 14px / 他人 15px;作者 13px / 时间 12px 混用。→ 走②统一为正文 14px + 元信息 12px。
  7. 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)。→ 令牌管不到,属第④条。
  8. 两处令牌零消费点:--chart-1..5 与 --sidebar* 在 web/src 的 ts/tsx 中零引用(只在 @theme inline 暴露为 bg-sidebar/color-chart-*)。本方案仍按契约给两套取值,但如实标注"零视觉收益、零回归风险",不当作改观业绩。
  9. 非整数字号的来源已定位: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:229 kbd-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;

字号/行高阶梯(只由官方档位 + 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),二选一由产品定

中文排版三条纪律

  1. 不给中文正文加负字距:现有 tracking-tight(login-code-form.tsx:262)只出现在含拉丁的标题上,保留原样;不新增任何负字距,避免与 em 派生小字号叠加导致中文挤字。
  2. 行宽(密度改造,途径③):主区实测宽度 860px,15px 中文单字宽 ≈15px → ≈57 字/行,超出中文舒适区 35–45 字;消息列限宽 max-w-[44rem](704px ≈ 47 字/行),超出部分留给空白而不拉伸气泡。
  3. 数字/编号用 --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 语音频道(该栈不可见,依据是代码 + 库表,不是截图)

深浅色与对比度

方法(可复算): 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 ✔

豁免与残留(必须讲清的两件事)

  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。 这是取舍,不是遗漏。
  2. 深色交付的前置依赖(超出 ①/②/③)。 实测注入 .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 条):

  1. Badge 没有 info/success/warning 变体 → 6 个任务状态无法仅靠官方 variant 表达;本方案不新增 variant,改用「variant + 文字 + 图标」,颜色只留"进行中=品牌 / 需注意=destructive"两处语义。
  2. Card 的描边是 ring-1 ring-foreground/10 → 强度由 --foreground 决定,令牌无法独立调(合成 1.19–1.24:1);要更强需要改组件(第④条)。
  3. Bubble variant="tinted" 用相对色语法 oklch(from var(--primary) 0.93 calc(c*0.4) h) → 令牌联动实现了,但色的明度/彩度被组件锁死(浅色 #cfe8ff、深色 #1e2d4b),不能再调;这是选 --message-self 还是 tinted 的唯一技术分歧点(§10)。
  4. 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、不改字体栈、不动动效与阴影令牌。

三处"承认做不到"(都会在其他方案里被比较,必须写清):

  1. 徽标形态:官方 Badge 的 rounded-4xl 在 h-5 上仍是近胶囊(15.6px vs 20px 高),参考里 4px 的小徽标不可达。
  2. 卡片圆角:--radius 是单点派生根,卡片/弹窗的 rounded-xl = 8.4px,达不到参考的 12px;想同时要 6px 控制圆角和 12px 浮层圆角,必须改 @theme 的派生系数(等于动 shadcn 约定)。
  3. 侧栏与主区零层级: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 原样沿用);深浅两套令牌齐全且对比度均已自算。