蓝调石墨(Mercury for wanman)
方案名与主张
方案名:蓝调石墨
一句话主张:把 wanman /app 从「飞书本机外观采样(蓝灰画布 + 近白面 + 单一品牌蓝 + 10px 圆角)」改造为蓝调石墨的夜间精密仪器——一块 #151821 的深蓝黑画布,内容面以 #1c1f2a 石墨卡抬升一层,全界面只留一个彩色音符 #5266eb 钴蓝;层级靠明度差而不是阴影,密度靠字号刻度而不是字号堆叠。
适用基调:深色优先、双主题对等(深色是本方案主场,浅色为蓝调日间版本,两套令牌都完整给出,见 §4)。
依据:/Users/waw/Documents/code/wanman/localtmp/gradientdeck/mercury.design.md、mercury.design-extended.md(slug mercury,来源站点 mercury.com,theme dark)。
参考提炼
参考风格名 Mercury — Alpine banking at blue hour(slug mercury,来源 mercury.com,theme dark)。它是一套深色金融站点的视觉语言:近黑画布 #171721、石墨卡 #1e1e2a、象牙文字 #ededf3、灰烬次级文字 #c3c3cc、唯一彩色 #5266eb。
从其 DESIGN.md 提炼 5 条可迁移规则:
- 明度差代替阴影:「Mercury deliberately avoids shadows. All elevation is communicated through value contrast alone — the graphite card (#1e1e2a) sits one step lighter than the onyx canvas (#171721)」。→ 可迁移:把
--card设为比--background高一档的明度,而不是加大--shadow-e2/e3。 - 单一彩色纪律:「Do not use multiple bright accent colors — Cobalt is the only chromatic note… Do not place Cobalt-filled elements next to each other without at least 32px gap」。→ 可迁移:这是治理本项目「三种蓝并存」的现成规则。
- 中间字重而非粗体:标题用 weight 480「never bold, never thin」,「Do not use bold weights (700+) for headings」。→ 可迁移:中文界面下把 700 降到 600/500,标题不再靠字重抢戏。
- 正文 16px/1.5 的密度基线:「Set body text at 16px… with 1.5 line-height — this is the density baseline」。→ 部分迁移:本项目正文约束是 14–15px,故取 15px/1.5(把行高从 1.375 提到 1.5),字号不动。
- 文字色不用纯白:「Do not use #ffffff for body text — always #ededf3 Ivory; pure white on dark creates harsh, cold contrast」。→ 可迁移:深色正文改
#e7e9f0,纯白只留给钴蓝按钮上的文字。
适配判断
为什么适合「任务 + 频道消息」的企业工具:
- 「信息密度高、长时段驻留」的界面最怕两件事:亮面刺眼与层级靠阴影堆叠(截图实测一次视图内圆角档位 2/6/7/8/10/12/14/18/24/26/32/9999px 共 12 档、字号 9 档)。Mercury 用一套两级明度阶梯 + 一个彩色替换掉这两件事,正好对应本项目
S2-dm-thread(自/他两种气泡 + 悬停四动作)与S3-task-hall(状态流转 6 态)的信息量。 - 任务状态(
待补充/待处理/进行中/待验收/已完成/已关闭)与连接态(已连接/连接中/重连中/已断开/连接失败)不需要 6 种颜色。Mercury 的单彩纪律逼出更正确的做法:状态用Badge的官方 variant(default/secondary/outline/destructive)+ 文字承载,颜色只留给「需要立刻点击的那一个」。 - 深色对高密度列表的收益已被实测证实:注入
.dark后body背景确实翻转,令牌块有效(S1-shell-dark-injected.json),说明成本主要在漏网的硬编码色,不在机制。
必须舍弃(照搬即错):
| 参考特征 | 舍弃理由 |
|---|---|
| 1200px 页宽、72px 段落间距、32px 卡片内边距(spacious) | 本项目是 1440×900 常驻工作台,实测会话行 240×64、任务卡圆角 10px×48 处;改成营销页节奏会让首屏可容纳的消息数从 ~11 条掉到 6 条以下。间距只做区域级(画布↔侧栏↔主区)的收紧,不做公制放大。 |
| 32/40px 药丸圆角按钮、40px 药丸导航项 | shadcn 官方 Button/Tabs 的圆角由 --radius-lg 与 rounded-[min(var(--radius-md),12px)] 决定,改药丸必须写 className/全局 CSS 覆盖 → 违反硬约束 §2.1。列为舍弃项,见 §8。 |
| hero 大图、全幅摄影、滚动叙事、椭圆叠层导航 | 与「消息 + 任务」工作台形态无关;本项目无 hero 语义。 |
| arcadia / arcadiaDisplay 字体与 360/420/480/530 字重轴 | 中文字形不覆盖,且 @font-face 属于新增资源,边界外。字重只借用「不做 700」这一条。 |
| 深色单主题 | 硬约束 §2.3 要求深浅两套;本方案把 Mercury 的夜间语言做蓝调日间反相(画布 #f4f6fb、面 #ffffff、钴蓝压暗到 #4356e3)。 |
令牌映射
以下全部改动落在途径①(语义化主题令牌取值,web/src/styles.css)。「当前值」摘自 web/src/styles.css:108-211。完整可替换块见同目录 tokens.css。
浅色 :root
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
#fcfcfc |
#f4f6fb |
冷调雾蓝灰画布,与白色内容面拉开层级 |
--foreground |
#060607 |
#14161f |
去掉纯黑,取 Mercury Ivory 反相的冷调墨色 |
--card |
#ffffff |
#ffffff |
白面浮于蓝灰画布,承担 Graphite 抬升角色 |
--card-foreground |
#060607 |
#14161f |
同 foreground |
--popover |
#ffffff |
#ffffff |
弹窗与卡片同族(实测弹窗 704×512 圆角 18px) |
--popover-foreground |
#060607 |
#14161f |
同 foreground |
--primary |
var(--brand) |
var(--brand) |
保持令牌间接引用,不引入旁路 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
同上 |
--secondary |
#ebedef |
#e9ecf3 |
次级面偏蓝,与 --muted 形成 3 级明度阶梯 |
--secondary-foreground |
#060607 |
#14161f |
同 foreground |
--muted |
#f2f3f5 |
#f0f2f7 |
最低一档面,偏冷 |
--muted-foreground |
#5c5e66 |
#5b6070 |
次级文字偏蓝,白底 6.27:1 |
--accent |
#ebedef |
#e9ecf3 |
他人气泡/hover 面(实测他人气泡 = --accent) |
--accent-foreground |
#060607 |
#14161f |
同 foreground |
--destructive |
#da373c |
#cf2d34 |
保留语义红、压暗一档保白底 5.15:1 |
--border |
#dcdee1 |
#dfe3ec |
发丝线偏蓝;装饰性,见 §7 说明 |
--input |
#dcdee1 |
#828a9d |
功能性边界,对白 3.46:1、对画布 3.20:1 |
--ring |
var(--brand) |
var(--brand) |
焦点色仍与品牌同源 |
--brand |
#2563eb |
#4356e3 |
Cobalt 浅底版,白字 5.71:1 |
--brand-foreground |
#ffffff |
#ffffff |
深底白字 |
--brand-soft |
rgb(37 99 235 / 0.12) |
rgb(67 86 227 / 0.12) |
随品牌色同比例 |
--brand-ink |
#1d4ed8 |
#3b4ad4 |
品牌文字色,对 brand-soft 合成面 5.69:1 |
--message-self |
#e8f3fe |
#dfe5fb |
自己气泡,与中性灰他人气泡形成色相区分 |
--message-self-foreground |
#0d274a |
#1b2350 |
气泡文字,11.93:1 |
--surface-chat-soft |
#e8f2ff |
#eef1fe |
引用/回复软底,比气泡更浅 |
--surface-chat-selected |
#e5ecfc |
#e3e8fd |
会话选中态,可辨「选中 > hover > 常态」 |
--mention |
#3370ff |
#3b52d9 |
与品牌并入同一色相,白底 5.72:1 |
--ink |
#060607 |
#14161f |
与 foreground 同值,不留第二套黑 |
--surface-rail |
#e1e8f2 |
#e5e9f3 |
空间 rail,对画布 1.12:1 |
--sidebar |
#fcfcfc |
#ffffff |
修零层级:实测 sidebar 与 background 同为 #fcfcfc |
--sidebar-foreground |
#060607 |
#14161f |
同 foreground |
--sidebar-accent |
#ebedef |
#eef0f6 |
侧栏行 hover/选中,与 --secondary 区分 |
--sidebar-accent-foreground |
#060607 |
#14161f |
同 foreground |
--sidebar-border |
#dcdee1 |
#e2e5ee |
侧栏内分隔,比 --border 更淡 |
--chart-1 |
oklch(0.87 0 0) |
#4356e3 |
图表改单蓝阶起点,承接品牌色 |
--chart-2 |
oklch(0.556 0 0) |
#6f7cec |
蓝阶第二级 |
--chart-3 |
oklch(0.439 0 0) |
#9aa1b2 |
中性辅助级 |
--chart-4 |
oklch(0.371 0 0) |
#4d5364 |
深蓝灰级 |
--chart-5 |
oklch(0.269 0 0) |
#232838 |
最深级 |
--radius |
0.625rem(10px) |
0.75rem(12px) |
对齐 Mercury 卡片 12px,收敛实测 12 档圆角 |
同段内
--workspace-background改为linear-gradient(180deg, var(--surface-rail), #dbe1ef)(原来的#e1e5f1是画布里第二个蓝,删掉);--workspace-rail-background: transparent、--workspace-header-background: var(--background)沿用;--interactive: #4e5058沿用;--channel-icon由#80848e→#7c8294(对白 3.9:1);--sidebar-primary/-primary-foreground/-ring沿用var()间接引用。
深色 .dark
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
oklch(0.145 0 0) |
#151821 |
Mercury Onyx 的蓝调版画布(去掉纯灰) |
--foreground |
oklch(0.985 0 0) |
#e7e9f0 |
Ivory 冷调版,不用纯白;14.62:1 |
--card |
oklch(0.205 0 0) |
#1c1f2a |
Graphite 抬升面,对画布 1.08:1 |
--card-foreground |
oklch(0.985 0 0) |
#e7e9f0 |
同 foreground |
--popover |
oklch(0.205 0 0) |
#1c1f2a |
弹窗与卡片同族 |
--popover-foreground |
oklch(0.985 0 0) |
#e7e9f0 |
同 foreground |
--primary |
继承 :root 的 var(--brand) |
var(--brand) |
深色段显式重申,深浅同构、不留继承歧义 |
--primary-foreground |
继承 :root 的 var(--brand-foreground) |
var(--brand-foreground) |
同上 |
--secondary |
oklch(0.269 0 0) |
#262a35 |
Obsidian 交互面,对卡片 1.15:1 |
--secondary-foreground |
oklch(0.985 0 0) |
#e7e9f0 |
对 secondary 11.82:1 |
--muted |
oklch(0.269 0 0) |
#22252f |
比 secondary 低一档,形成三级阶梯 |
--muted-foreground |
oklch(0.708 0 0) |
#9aa1b2 |
Ash 蓝调版;对画布 6.85:1 / 卡片 6.35:1 |
--accent |
oklch(0.269 0 0) |
#262a35 |
他人气泡 / hover 面 |
--accent-foreground |
oklch(0.985 0 0) |
#e7e9f0 |
同 foreground |
--destructive |
oklch(0.704 0.191 22.216) |
#ff8b8f |
深底提亮一档,对画布 7.89:1 |
--border |
oklch(1 0 0 / 10%) |
oklch(1 0 0 / 12%) |
白色 12%,合成后对画布 1.42:1(装饰性) |
--input |
oklch(1 0 0 / 15%) |
#6b7280 |
功能性边界对画布 3.67:1 / 卡片 3.40:1 |
--ring |
继承 :root 的 var(--brand) |
var(--brand) |
显式声明,避免继承链歧义 |
--brand |
oklch(0.68 0.15 256) |
#5266eb |
Mercury Cobalt 原值,白字 4.71:1 |
--brand-foreground |
oklch(0.16 0.02 258) |
#ffffff |
Mercury「钴蓝上纯白」,唯一允许用纯白之处 |
--brand-soft |
oklch(0.28 0.05 256) |
rgb(82 102 235 / 0.18) |
18% 保证在石墨卡上可见(合成 #262c4d) |
--brand-ink |
oklch(0.84 0.09 256) |
#aab4ff |
品牌文字色,对 brand-soft 合成面 6.89:1 |
--message-self |
#203b59 |
#202a44 |
去绿味,改为钴蓝深面;对画布 1.25:1 |
--message-self-foreground |
#e7f3ff |
#dfe6ff |
气泡文字 11.45:1 |
--surface-chat-soft |
oklch(0.32 0.06 250) |
#1b2136 |
引用软底,比气泡更深一档 |
--surface-chat-selected |
oklch(0.28 0.04 250) |
#1d2540 |
选中面,对画布 1.17:1 |
--mention |
oklch(0.72 0.14 254) |
#8ea2ff |
与 brand 同色相、高一级明度;7.40:1 |
--ink |
oklch(0.16 0.02 258) |
#151821 |
与画布同值,避免第二套黑 |
--surface-rail |
#e3e5e8 |
#101219 |
修实测缺陷:原文深色 rail 仍是浅色,表现为浅色竖带 |
--sidebar |
oklch(0.205 0 0) |
#191c26 |
侧栏比画布浅一档(1.04:1),与卡片同族 |
--sidebar-foreground |
oklch(0.985 0 0) |
#e7e9f0 |
对 sidebar 14.01:1 |
--sidebar-accent |
oklch(0.269 0 0) |
#262a35 |
侧栏行选中/hover |
--sidebar-accent-foreground |
oklch(0.985 0 0) |
#e7e9f0 |
同 foreground |
--sidebar-border |
oklch(1 0 0 / 10%) |
oklch(1 0 0 / 12%) |
与 --border 统一口径 |
--chart-1 |
oklch(0.87 0 0) |
#5266eb |
图表单蓝阶起点=品牌色 |
--chart-2 |
oklch(0.556 0 0) |
#7c88f0 |
蓝阶第二级 |
--chart-3 |
oklch(0.439 0 0) |
#9aa1b2 |
中性辅助级 |
--chart-4 |
oklch(0.371 0 0) |
#4a4f5e |
深蓝灰级 |
--chart-5 |
oklch(0.269 0 0) |
#2b2f3c |
最深级 |
--radius |
继承 :root |
:root 的 0.75rem |
单处定义,深浅共用 |
深色段重写/新增的声明(全部使用文件里已存在的变量名,未引入新令牌名):
--workspace-background: linear-gradient(180deg, var(--surface-rail), #12151d)、--workspace-rail-background: color-mix(in oklab, var(--background) 55%, transparent)、--workspace-header-background: linear-gradient(180deg, color-mix(in oklab, var(--background), var(--brand) 4%), var(--background))三条改写自原文.dark的同名声明(去掉径向泛蓝);--interactive: #4e5058、--channel-icon: #8b91a3、--ring: var(--brand)、--primary/--primary-foreground五条为新增声明——原文.dark未定义它们,会继承浅色值(深色下--channel-icon若继承#7c8294会偏暗)。
字体与排版
字体栈不改(web/src/styles.css:33-36,@theme inline --font-sans):"Geist Variable","gg sans","Noto Sans SC","PingFang SC",ui-sans-serif,system-ui,"Segoe UI","Microsoft YaHei",Roboto,Helvetica,Arial,sans-serif。理由:Geist 不含中文字形,中文实际落到 Noto Sans SC/PingFang SC(实测字体栈即为该顺序),保留现状即满足「西文字体不挤掉中文回退」;把 Geist 前移或换成 Inter 都会改变中文回退命中顺序,收益为零、风险非零。
字号/行高/字重阶梯(目标态,来源是实测档位收敛 + Mercury 的「中间字重」纪律):
| 角色 | 字号 | 行高 | 字重 | 落地位置 | 依据 |
|---|---|---|---|---|---|
| 正文(消息、任务标题) | 15px | 1.5(现 1.375) | 400 | web/src/styles.css:261-263 的 body(text-[15px] leading-[1.375] → leading-[1.5]) |
Mercury body 1.5 基线;现 1.375 对应 20.63px 行高,中文密排易糊 |
| 次级(作者、时间、标签) | 13px | 1.45 | 400/500 | styles.css 中 13px 声明(546/634/654/690/703 行) |
实测作者 13px/400、时间 12px/500,合并为 13px 一档 |
| 小标签(成员数、徽标、页脚) | 12px | 1.4 | 500 | 565/606/611/726/737 行等 12px 声明 | 硬约束「中文最小 12px」;删去 11.25px / 11px / 9.375px / 9px 四档 |
| 卡片标题 | 14px | 1.4 | 500(现 600) | 594 行、任务卡 14px/500 | Mercury「不靠粗体抢戏」;500 已足够在石墨卡上分层 |
| 页标题(登录主标题、弹窗标题) | 26px | 1.25 | 600(现 700) | styles.css:682-685(24px/650)、登录 26px |
700 → 600,收掉实测 font-weight:700 的呐喊感 |
数字/代码/kbd |
12–13px | 1.4 | 400 | --font-mono(styles.css:37-39,kbd-chip 用 0.625rem) |
数字与中文混排时用等宽对齐 |
| 大号数字(统计值) | 24px | 1.2 | 600 | styles.css:569-570(24px/700) |
同上,字重降一档 |
要点:
- 字号刻度收敛为 5 档:12 / 13 / 14 / 15 / 24-26px。现状实测单视图出现 9 档(9、9.375、11、11.25、12、12.8、13.125、14、15、26),其中 11.25px、9.375px 来自以 15px 为基准的 em 计算(
body 15px× em),是「没有刻度」的直接后果。收敛后 11.25px → 12px(保证中文最小 12px 的硬约束)、12.8px → 13px、13.125px → 13px。 - 中文长文本:消息正文 15px/1.5 = 22.5px 行高,比现状 20.63px 多 1.87px;按
S2-dm-thread一屏 ~11 条计,一屏少约 1 条,是可接受的代价(换来中文密排不糊)。中文不使用 letter-spacing(0.42px级别只在 22px+ 的拉丁标题上用,中文标题一律 0)。 - 数字:任务数、成员数、时间戳用
--font-mono(ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,…),保证5 项任务、0 人已读 / 4 人未读这类数字列在列表中纵向对齐。 - 混排基线:Geist 与 Noto Sans SC 的 x-height 不同,15px 中文与 Geist 拉丁混排时不需要手动 offset;只在
kbd-chip(styles.css:221-236)与--font-mono数字上保持现状的0.625rem等宽设定。
行高与字重的改动落在途径①(web/src/styles.css 中的字号/行高声明);字号档位的减少不是靠 className 覆盖组件,而是把 styles.css 里泄漏的自定义字号(11px×1、22px×1、24px×2、27px×1 等硬编码)归并到 5 档刻度。
关键界面改造
每条都标注实现途径:① 令牌/② 官方 variant/size/③ 容器布局间距。
S1 应用外壳 + 空间/频道侧栏
(web/src/components/app/app-shell.tsx、channel-sidebar.tsx)
- 现状:空间 rail
nav72×900 背景transparent,右边框rgba(220,222,225,0.55)(不是--border #dcdee1);会话侧栏aside256×715 @x=76,border-radius 14px,背景#fcfcfc—— 与页面底色--background:#fcfcfc完全相同,零层级;搜索框 30px 高、圆角 10px、背景rgba(235,238,239,0.75)。 - 改后:①
--sidebar(浅#ffffff/ 深#191c26)与--background(浅#f4f6fb/ 深#151821)分离,侧栏成为独立面(浅色 1.05:1 白浮于蓝灰,深色 1.04:1 灰面浮于深蓝黑);①--surface-rail深色改#101219,修掉实测「深色下一整条浅色竖带」;①--radius: 0.75rem使侧栏容器的 14px 与卡片 12px 收敛到同一档;② rail 分隔线用Separator官方组件(bg-border)替代rgba(5,5,9,0.22)的硬编码线;③ 侧栏头部 52px、搜索框 30px 高度不动(触屏 44px 命中区由styles.css:238的tap-target工具类保证)。 - 密度/层级/状态:层级 = rail(最深/最外)< 画布 < 侧栏面 < 卡片;会话行 240×64 保持,未读点用
Badge官方defaultvariant;11.25px 预览文字并入 12px 档(①)。
S2 频道消息流
(message-list.tsx、channel-thread.tsx、channel-header.tsx、channel-tabs.tsx)
- 现状:气泡圆角 14px;他人
rgb(235,237,239)(=--accent #ebedef)、自己rgb(232,243,254)(=--message-self #e8f3fe)文字rgb(13,39,74);同一列表两套正文字号:他人 15px/400#060607,自己 14px/400#0d274a;输入区textarea628×33 无边框,外层只有上边框rgb(220,222,225)。 - 改后:①
--accent/--message-self收进同一色族(浅#e9ecf3vs#dfe5fb;深#262a35vs#202a44),自己气泡自带--message-self-foreground(浅 11.93:1 / 深 11.45:1);① 统一正文字号到 15px/1.5,删掉「自己 14px」这条特殊分支(它与--message-self-foreground属于同一段硬编码,落在message-list.tsx的字号写法上,改为继承body档);①--border用于输入区上边框,替代rgb(220,222,225);③ 消息行保持padding现状,但把消息列表与输入区之间的分隔改由Separator(②)承担,去掉「只有上边框」的悬空感。 - 状态色:悬停四动作(点赞/回复/更多/预览图片)用
Button variant="ghost" size="icon-xs"(②),不再各自带色;@提及用--mention(①,浅#3b52d95.72:1 / 深#8ea2ff7.40:1),并把chat-mention.ts里硬编码的#3370FF与message-list.tsx的#006ce7收敛到这一条令牌(①,风险见 §8);「4 人未读」用Badge variant="secondary"(②)。 - 通道头:标题 16px/600、成员数 12px/500
#5c5e66→--muted-foreground(浅#5b60706.27:1 / 深#9aa1b25.54:1 起)。
S3 任务大厅与任务卡
(task-hall.tsx、group-hall.tsx、create-task-dialog.tsx、channel-work-items.tsx)
- 现状:列头「待补充 0 / 待处理 5」,卡片=标题 14px/500 + 频道 chip +
AI 助手chip +查看任务+ 负责人;实测圆角两套混用:10px×48、8px×37;群聊大厅是营销式 hero + 品牌蓝rgb(37,99,235)出现 20 处。 - 改后:①
--radius 0.75rem把 8px/10px 两套收敛(rounded-lg与rounded-md在同--radius下差 2.4px,不再出现 8 与 10 并列);①--card/--card-foreground让任务卡成为石墨卡面(深色#1c1f2a,对画布 1.08:1 的明度抬升);② 状态流转 6 态(待补充/待处理/进行中/待验收/已完成/已关闭)映射到Badge官方四 variant:待补充→outline、待处理→secondary、进行中→default(钴蓝,唯一高亮态)、待验收→default、已完成→outline、已关闭→destructive的反面(改ghost,因为「关闭」不是风险);取消为 6 个状态引入 6 种颜色——这正是参考「Cobalt 是唯一彩色音符」的直接落地;②查看任务用Button variant="outline" size="sm";③ 群聊大厅去掉营销 hero(group-hall.tsx的 hero 段落),改为「筛选Tabs variant="line"+count文本 + 卡片网格」的三段式,筛选器「全部 / 已加入 / 未加入」用Tabs(②)替代现有按钮组;① 20 处rgb(37,99,235)归并到--brand。 - 密度/状态色:卡片内边距保持现状(不放大到 Mercury 的 32px,理由见 §3);列表「5 项任务」这类计数用
--font-mono(①)。
S4 AI 助手频道
(agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx、channel-summary-panel.tsx)
- 现状:AI 助手空间 395 项任务,是全站最密集视图:一次渲染内字号
12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724;圆角8px ×1591、10px ×844。即上千个 12.8px 元素——这就是「没有刻度」的取证现场。 - 改后:① 12.8px 归并到 13px、8px/10px 归并到
--radius派生档(上表 §5 刻度);① 流式回答的等待态沿用--animate-breathe(styles.css:57,未改);② 结果卡片用官方Card(card.tsx)+Badge(来源引用用outline),来源 chip 与任务卡同构;③ 结果区与对话区改为固定高度两栏(当前是一列堆叠导致 2765 个 12.8px 元素同屏),容器层grid-template-columns改动属③;① 引用软底用--surface-chat-soft(浅#eef1fe/ 深#1b2136),与消息气泡区分。
S5 管理与设置弹窗
(space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx、channel-permission-picker.tsx)
- 现状:
[role=dialog]704×512 圆角 18px 背景#ffffff;左侧导航项 135×36 圆角 8px,选中态背景--brand-soft(rgb(37 99 235/0.12)) + 前景--brand-ink(#1d4ed8);危险项#da373c;输入框 488×32 圆角 10px;表单标签 14px。 - 改后:①
--popover(深色#1c1f2a)替代深色下仍为白的#ffffff;①--brand-soft/--brand-ink新值使选中态在深色下可见(合成#262c4d+#aab4ff= 6.89:1,旧值#1d4ed8在深色下几乎不可读);①--destructive(浅#cf2d345.15:1 / 深#ff8b8f7.89:1);② 左侧导航(135×36 圆角 8px)用Tabs orientation="vertical" variant="line"替代手写导航项,勾选与单选分别用官方Checkbox/RadioGroup(checkbox.tsx、radio-group.tsx);③ 704×512 与 488×32 尺寸不变,仅把「标签 14px / 输入 32px」对齐 §5 刻度。 - 风险:
channel-permission-picker.tsx若含硬编码色,需按 §8 列为不合规项。
S7 登录页
(web/src/routes/login.tsx、sign-in.$.tsx)
- 现状:居中卡片,主标题 26px;「邮箱验证码 / 短信验证码」切换块 173×42(选中态背景
--background #fcfcfc+ 品牌蓝文字);主按钮 356×52 白字#2563eb;页脚 11px(且实测出现 9.375px/216 处)。 - 改后:①
--background改#f4f6fb后,切换块选中态不能再靠「同色不可见」——选中态改用--card(白)浮于画布之上,与未选中态形成 1.12:1 的可辨差;①--brand浅色压暗到#4356e3,让 356×52 主按钮的白字从 5.17:1 升到 5.71:1;② 切换块用官方Tabs(tabs.tsx,variant="default")替代自绘块;② 主按钮用Button size="lg"(h-9)——注意:实测 52px 高主按钮无法由任何官方 size 达成(lg=36px,最大icon-lg=36px),保持 52px 只能靠容器 padding(③)或保留自绘高度(风险,见 §8);① 页脚 11px / 9.375px 归并到 12px 档(硬约束「中文最小 12px」)。
S8 应用中心
(app-center.tsx、assistant-board.tsx)
- 现状:分类筛选 7 项 +「共 14 个应用」+ 卡片(
运行中/开发中徽标、emoji 图标、Agent · 第三方 · chat元信息);实测14px/400 ×265、11.25px/400 ×206、圆角10px ×52、26px ×23。 - 改后:① 卡片面色统一
--card,运行中状态不能靠颜色区分 7 个分类——分类色全部取消,改由Badge官方 variant 承载(②);②运行中→default(钴蓝)、开发中→outline;① emoji 图标问题本方案只能部分解决:图标容器底色改用--muted,emoji 本身不受令牌控制,彻底解决需替换为 lucide 图标(属代码改动,超出方案范围,列为限制);③ 11.25px 元信息归并到 12px 档。
深浅色与对比度
对比度按 WCAG 相对亮度公式自算;bg=画布,card=卡片/弹窗面。
浅色(画布 #f4f6fb / 卡片 #ffffff)
| 组合 | 前景 | 背景 | 对比度 | 达标(正文 4.5 / 图形 3.0) |
|---|---|---|---|---|
| 正文 / 画布 | #14161f |
#f4f6fb |
16.68:1 | ✅ |
| 正文 / 卡片 | #14161f |
#ffffff |
18.04:1 | ✅ |
| 次级文字 / 画布 | #5b6070 |
#f4f6fb |
5.79:1 | ✅ |
| 次级文字 / 卡片 | #5b6070 |
#ffffff |
6.27:1 | ✅ |
| 次级文字 / secondary | #5b6070 |
#e9ecf3 |
5.30:1 | ✅ |
| 按钮文字 / 主色 | #ffffff |
#4356e3 |
5.71:1 | ✅ |
| 品牌文字 / brand-soft 合成面 | #3b4ad4 |
#e8ebfc |
5.69:1 | ✅ |
| 提及 / 画布 | #3b52d9 |
#f4f6fb |
5.72:1 | ✅ |
| 自己气泡文字 / 气泡 | #1b2350 |
#dfe5fb |
11.93:1 | ✅ |
| 危险色 / 卡片 | #cf2d34 |
#ffffff |
5.15:1 | ✅ |
| 输入框边界 / 卡片 | #828a9d |
#ffffff |
3.46:1 | ✅(图形 3:1) |
| 输入框边界 / 画布 | #828a9d |
#f4f6fb |
3.20:1 | ✅ |
| 频道图标 / 卡片 | #7c8294 |
#ffffff |
3.90:1 | ✅ |
| 卡片 / 画布(面分层) | #ffffff |
#f4f6fb |
1.12:1 | ⚠️ 装饰性,见下 |
| 发丝线 / 卡片 | #dfe3ec |
#ffffff |
1.29:1 | ⚠️ 装饰性,见下 |
深色(画布 #151821 / 卡片 #1c1f2a)
| 组合 | 前景 | 背景 | 对比度 | 达标(正文 4.5 / 图形 3.0) |
|---|---|---|---|---|
| 正文 / 画布 | #e7e9f0 |
#151821 |
14.62:1 | ✅ |
| 正文 / 卡片 | #e7e9f0 |
#1c1f2a |
13.54:1 | ✅ |
| 正文 / secondary | #e7e9f0 |
#262a35 |
11.82:1 | ✅ |
| 次级文字 / 画布 | #9aa1b2 |
#151821 |
6.85:1 | ✅ |
| 次级文字 / 卡片 | #9aa1b2 |
#1c1f2a |
6.35:1 | ✅ |
| 次级文字 / secondary | #9aa1b2 |
#262a35 |
5.54:1 | ✅ |
| 次级文字 / sidebar | #9aa1b2 |
#191c26 |
6.57:1 | ✅ |
| 按钮文字 / 主色 | #ffffff |
#5266eb |
4.71:1 | ✅ |
| 品牌文字 / brand-soft 合成面 | #aab4ff |
#262c4d |
6.89:1 | ✅ |
| 提及 / 画布 | #8ea2ff |
#151821 |
7.40:1 | ✅ |
| 自己气泡文字 / 气泡 | #dfe6ff |
#202a44 |
11.45:1 | ✅ |
| 危险色 / 画布 | #ff8b8f |
#151821 |
7.89:1 | ✅ |
| 焦点环 / 卡片 | #5266eb |
#1c1f2a |
3.49:1 | ✅ |
| 焦点环 / 画布 | #5266eb |
#151821 |
3.76:1 | ✅ |
| 输入框边界 / 画布 | #6b7280 |
#151821 |
3.67:1 | ✅ |
| 输入框边界 / 卡片 | #6b7280 |
#1c1f2a |
3.40:1 | ✅ |
| 卡片 / 画布(面分层) | #1c1f2a |
#151821 |
1.08:1 | ⚠️ 装饰性(同 Mercury 原文 graphite/onyx 实测 1.08:1) |
| 发丝线 / 画布 | 白色 12% 合成 #31343c |
#151821 |
1.42:1 | ⚠️ 装饰性 |
关于两处 ⚠️(显式声明,非隐瞒):--card 对 --background 的 1.08–1.12:1 与 --border 的 1.29–1.42:1 低于 3:1。这是参考的核心机制(明度差代替阴影),且不是任何组件的识别边界:卡片的可识别性由其上正文(13.5:1+)与 --radius 轮廓承担;输入框这类真正需要边界识别的组件已由 --input(3.20–3.67:1)承担。若评审要求「所有面分层 ≥3:1」,则必须给卡片加边框,那时 Mercury 的零阴影语言将不成立——本方案选择保留该机制,并在此标注为已声明偏离。
深色可达性现况对照:简报 §3.3 实测「注入 .dark 后前景 rgb(6,6,7) 仍出现 55 处、rgb(92,94,102) 27 处、边框 rgb(220,222,225) 6 处」——这些都是绕过令牌的硬编码,本方案改令牌无法消除;落入 §8 风险清单。
shadcn 兼容性
只用官方组件与官方 variant/size 能否达成:能达成约 85%,余下 2 处必须显式标注。
已核对可用的官方 variant/size(web/src/components/ui/,38 个组件 + ui/chat/ 12 个):
Button(button.tsx:10-35):variantdefault / outline / secondary / ghost / destructive / link;sizedefault(h-8) / xs(h-6) / sm(h-7) / lg(h-9) / icon(size-8) / icon-xs(size-6) / icon-sm(size-7) / icon-lg(size-9)。Badge(badge.tsx:10-25):variantdefault / secondary / destructive / outline / ghost / link(高度固定h-5)。Tabs(tabs.tsx:26-40):TabsListvariantdefault(bg-muted) / line(gap-1 bg-transparent),orientationhorizontal / vertical。Avatar(avatar.tsx:12):sizedefault(size-8) / sm(size-6) / lg(size-10)。Separator(separator.tsx):orientationhorizontal / vertical,色为bg-border。- 表单:
Input/Textarea/Select/Checkbox/RadioGroup/Field/FieldSelect;容器:Card/Dialog/Popover/Tooltip/DropdownMenu/ContextMenu/ScrollArea/Table/Skeleton/Accordion/Collapsible/Item/ButtonGroup/InputGroup;聊天:ui/chat/{message,bubble,attachment,trace,empty,message-scroller,...}。
需要引入的官方组件:无。 全部改造使用已安装组件。
必须自定义样式的 2 处(标注为不合规风险 R1/R2):
- R1(高风险):Mercury 的 32/40px 药丸圆角按钮与 40px 药丸导航项。官方
Button圆角来自rounded-lg→var(--radius-lg)(现 12px),药丸需要rounded-full+className覆盖 → 违反 §2.1。决策:舍弃药丸,保留 12px 圆角(已写入 §3 舍弃表)。 - R2(中风险):登录页主按钮实测 356×52,官方最大 size
lg=h-9(36px)。要保 52px 必须①容器 padding 撑高(③,可在不改组件的前提下近似)或②保留自绘高度(违反 §2.1)。决策:用Button size="lg"+ 容器padding垂直撑到 48px(③),与实测 52px 差 4px;若评审要求像素级一致则记为不合规风险。
另需在实施时清理但属于 web/src/components/app/ 而非本方案目录的硬编码(不改代码即无法生效,列入 §9 风险):message-list.tsx/composer-markdown.ts 的 #006ce7、chat-mention.ts 的 #3370FF、chrome.ts #f06f66、tone.ts #23a55a/#f0b232、image-preview-dialog.tsx #f2f3f5、file-preview/*、spreadsheet/SpreadsheetPreview.tsx 一整套色,以及 253 处 Tailwind 原始调色板类(amber 69 / rose 68 / slate 44 / emerald 42 …)。这些是深色不可读的根因,改令牌无法治愈。
实施成本
改动面
| 文件 | 改动 | 途径 | 预估 |
|---|---|---|---|
web/src/styles.css |
:root 108–161 行、.dark 163–211 行整段替换(用 tokens.css);字号声明归并到 5 档(531/546/565/569/581/594/606/611/623/634/641/654/682/690/703/726/730/737/755/761/813/818/828/856/876/883/896/903 行附近的硬编码 font-size);body 的 leading-[1.375] → leading-[1.5](261–263 行) |
① | 6–8 h |
web/src/styles.css 之外 |
message-list.tsx(自己气泡 14px 分支、#006ce7)、chat-mention.ts(#3370FF)、tone.ts/chrome.ts(状态色)、file-preview/*、SpreadsheetPreview.tsx 的硬编码色 → 令牌 |
① | 8–12 h |
app-shell.tsx / channel-sidebar.tsx |
rail 分隔线换 Separator;侧栏面依赖 --sidebar(无需改) |
② | 1 h |
task-hall.tsx / group-hall.tsx |
状态 → Badge variant 映射(6 态);筛选 → Tabs;删 hero |
②③ | 4 h |
group-members.tsx / channel-settings-dialog.tsx / channel-permission-picker.tsx |
左导航 → Tabs vertical;勾选 → Checkbox/RadioGroup |
② | 3 h |
login.tsx |
切换块 → Tabs;页脚字号并档 |
②① | 2 h |
agent-channel*.tsx |
结果区两栏布局;字号并档 | ③① | 3 h |
app-center.tsx |
状态 → Badge;emoji 容器底色 → --muted |
②③ | 2 h |
| 合计 | 约 29–35 人时 |
风险清单
| 编号 | 风险 | 影响 | 缓解 |
|---|---|---|---|
| R1 | 药丸圆角不可达(§8) | 方案视觉与 Mercury 有可见落差 | 保留 12px 圆角,属已声明偏离 |
| R2 | 登录主按钮 52px 不可由官方 size 达成 | 4px 偏差 | 容器 padding 撑到 48px 或记为偏差 |
| R3 | 硬编码色(55 处 rgb(6,6,7) 等)不改则深色仍不可读 |
深色主题上线后一半界面不可用 | 必须先清 web/src 硬编码,令牌替换才会有可见效果;建议把「清 #006ce7/#3370FF/Tailwind 调色板类」列为独立前置任务 |
| R4 | .dark 在生产不可达(全仓无代码添加 .dark,color-scheme: normal) |
深色优先的主张无法被用户看到 | 需另行接线主题切换(不在本方案三个交付物范围内);本方案只保证两套令牌值正确 |
| R5 | --border 与面分层 <3:1 |
严格 a11y 审查可能不过 | 已在 §7 显式声明为「非组件识别边界」并给出替代边界 --input |
| R6 | 字号并档会改变既有版式(11.25→12、12.8→13) | 个别容器可能换行 | 逐视图回归:S1/S2/S3/S4/S5/S7/S8 七面 |
验证方式(能证明改动生效的检查)
grep -n "0.145 0 0" web/src/styles.css应无结果(深色画布已换#151821);grep -n "e3e5e8" web/src/styles.css应无结果(浅色 rail 缺陷已修)。- 浅色下
getComputedStyle(document.body).backgroundColor=rgb(244, 246, 251);会话侧栏rgb(255, 255, 255)(现两者同色,改后不同色 = 零层级已修)。 - 注入
.dark后document.body背景 =rgb(21, 24, 33),rail 背景 =rgb(16, 18, 25)(不再是浅色带)。 - 用
probe-leaks.js口径重跑令牌泄漏普查:rgb(6,6,7)命中数应从 55 降到 0,Tailwind 原始调色板类命中从 253 降到 <20。 - 对比度复算:
#e7e9f0/#151821= 14.62,#ffffff/#5266eb= 4.71,#6b7280/#1c1f2a= 3.40(与 §7 表一致)。 - 圆角实测档位数:
S1-shell-dms.json现为 10+ 档,改后应只剩--radius派生的 4–5 档。
取舍
解决了什么
- 零层级:实测
aside与--background同为#fcfcfc(S1)——会话侧栏在视觉上不存在。改后浅色 1.12:1、深色 1.04:1,侧栏成为独立面。 - 深色下浅色竖带:原文
.dark --surface-rail: #e3e5e8是浅色值,深色下 rail 会成为一条亮带;改为#101219。 - 三种蓝并存(
--brand #2563eb/ 硬编码#006ce7/--mention #3370ff)收敛为一条钴蓝族:--brand亮面#aab4ff系、--mention提亮版。这是参考「Cobalt 是唯一彩色音符」的直接兑现(需先清硬编码,见 R3)。 - 没有字号刻度(单视图 9 档、AI 空间 2765 个 12.8px 元素)收敛为 5 档 12/13/14/15/24-26px,且中文最小 12px 得到保证(现 9.375px 与 11px 档被删)。
- 两套棱角并存(10px×48 与 8px×37)收敛到
--radius派生档。 - 长时段驻留的夜间可读性:深色正文 14.62:1,次级文字最低 5.54:1,全部正文级组合 ≥4.5:1。
牺牲了什么
- 品牌辨识度:
#2563eb是当前唯一品牌色,改#4356e3/#5266eb后与既有物料不再一致(深色下反而更接近 Mercury 原值,是刻意的)。 - Mercury 的药丸与零阴影:药丸被 shadcn 约束挡掉(R1);组件自带
--shadow-e1/e2,深色下卡片仍略有阴影,明度分层不能 100% 独占。 - 营销页节奏:不放大间距与内边距,因此不会有参考那种「大气」。本产品 1440×900 一屏要装 ~11 条消息 + 任务面板,这是必需的取舍。
- 状态色的表达力:6 个任务状态收敛到 4 个官方 variant 后,「待验收」和「进行中」都落在钴蓝
default上,需要靠文字区分(换取的是不再有 6 种颜色的噪音)。
什么场景下不适用
- 需要多彩状态编码的看板/甘特视图(6 态及以上同时高亮时,单彩纪律会损失扫读速度)。
- 需要亮色为主、深色为辅的对外页面(如客户门户、分享页)——本方案的浅色是「蓝调日间」,偏冷偏克制的企业感,不适合营销与品牌传播场景。
- 触屏为主、长时间户外使用的场景(深色低对比面分层在强光下会退化成一片黑)。
- 若上线时不做 R3(清硬编码)与 R4(接深色开关),深色主题不可达且残留 55 处近黑前景——此时不要启用深色,只上浅色套。