明暗混排工作台(clerk 方案)
方案名与主张
方案名:明暗混排工作台(slug clerk)
一句话主张: 把「浅色文档壳 + 深色产品卡」的混排语言搬进协作工具 —— 频道消息流是浅色的文档页,自己的消息、任务卡与 AI 结果面是浮在其中的深色工作面,全站只有一条紫罗兰脉冲代表「可执行的动作」。
适用基调:双主题对等。浅色是默认主壳(画布 #f1f1f4 / 浮岛 #fbfbfc / 卡片 #ffffff),深色是 obsidian 工作台(画布 #141419 / 卡片 #1c1c22 / 抬升面 #2f3037),两套都由同一组语义令牌驱动,两套都逐项算过对比度。
参考提炼
- 参考风格名:Clerk — Style Reference
- slug:
clerk - 来源站点:clerk.com(本机文件
/Users/waw/Documents/code/wanman/localtmp/gradientdeck/clerk.design.md、clerk.design-extended.md) - theme:
mixed(浅色文档壳与深色产品预览同页并存)
可迁移的 5 条规则(引用其原文要点)
- 双面共存,不许压平:「dark product cards floating inside a light documentation shell」;Don't 里明确写「Do not flatten the dual-surface system into a single light or dark theme — light marketing sections and dark product preview cards must coexist on the same page.」→ 在 wanman 里落成「浅色消息流 + 深色自身消息/工作面」,并且深浅两套令牌都是完整方案,不是一个主题的附属。
- 单一强调色的稀缺纪律:「Use #6c47ff exclusively for filled primary CTAs and heading accent text — never for decorative backgrounds larger than a tag-sized element.」→ 全套
--brand / --brand-soft / --brand-ink / --mention / --ring归到同一支紫罗兰,且不做大面积填充底色。 - 圆角只允许 6 / 8 / 12 / 16 / 9999:「Do not set border-radius to anything other than 6px, 8px, 12px, 16px, or 9999px」→ 把
--radius从 10px 收到 12px,使rounded-lg全站落在允许集内。 - 深色面只用内描边、不用投影:「On dark product sections (#212126 canvas), use the inset white shimmer shadow (rgba(255,255,255,0.024)) as the sole border treatment — no explicit border-color.」→ 深色
.dark里的--shadow-e1..pop改成 inset 微光,--border降到 9% 白。 - 层级靠灰阶与细线,不靠重投影:其 Light Card 阴影是
rgb(217,217,222) 0 0 0 0.5px + rgba(0,0,0,0.06) 0 1px 2px的「0.5px 描边 + 近距柔影」→ 换成--shadow-e1/e2的分层聚拢写法。
明确不迁移:#6c47ff 这个具体色值(换成本产品的 #5b3df5,理由见 §4)、1200px 页面容器、80px 段落间距、64px display 字号、hero 径向渐变(violet→yellow→cyan 的大面积色晕,与高密度企业工具冲突)、Söhne Mono 的 <ComponentName /> 代码标签写法、Announcement Banner、营销页 hero 排版、backdrop-filter 玻璃层。
适配判断
为什么这套语言适合「任务 + 频道消息」的企业工具
- 两种信息形态本来就有两种材质。频道消息是连续阅读的「文档」,自己的消息/任务卡/AI 结果面是「被操作的物件」。参考的 dual-surface 刚好给出这两种材质的对应关系:文档壳用近白 + 细线,工作面用深色卡。实测现状里这两者只靠色相差区分(自己
rgb(232,243,254)vs 他人rgb(235,237,239),亮度差 1.09:1),深色下无法翻转;换成明度区分后自己/他人气泡是 13.59:1,任何主题下都成立。 - 单一强调色对高频工具是减负。实测已达 253 处 Tailwind 原始调色板引用(amber 69 / rose 68 / slate 44 / emerald 42 …)和三种蓝并存(
#2563eb/#006ce7/#3370ff)。参考的「一个色只做一件事」纪律正好是这套工具需要的收敛方向:所有「可执行」的东西是紫色,其余全部落回中性灰阶。 - 灰阶密度适合长时段驻留。Clerk 的 Fog/Mist/Stone/Hairline 是一组低饱和冷灰,配 4px 基线间距,用于 12 小时驻留的排班/运维场景比高饱和蓝色画布更稳。
舍弃项(并说明原因)
| 舍弃 | 原因 |
|---|---|
| 1200px 内容容器 / 80px 段落间距 / 64px display | 企业工具是全屏三栏密度布局,不是滚动叙事页;本方案保留 body 15px/1.375 与 1440×900 全屏三栏(rail 72px + 侧栏 256px + 主区) |
| hero 径向渐变(大范围 violet→yellow→cyan 晕) | 大面积高饱和底色与「信息密度高、长时段驻留」冲突;只保留 7%–8% 的紫罗兰单色晕染做 --workspace-background |
| backdrop-filter / 玻璃层 | 消息流滚动时 blur 成本高,且本栈 styles.css 未定义相关令牌,属新增能力 |
| 负字距(-0.035em / -0.015em) | 字距由组件 className 控制,令牌层无法表达;只能通过 --font-sans 选字实现(见 §8 风险) |
| Söhne Mono 代码标签 | 本栈 mono 栈是系统 ui-monospace;中文正文不能进 mono |
深色 #212126 直接用在整个画布 |
深色下画布需要比卡片更深才能让卡片「浮起」;参考本身也同时用 #1a1a1f(段底色)与 #212126(卡面)两档 |
令牌映射
浅色 :root(当前值取自 web/src/styles.css:110-160,建议值见 tokens.css):
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
#fcfcfc |
#f1f1f4 |
画布退到 Fog 档,与 #ffffff 卡面拉开 1.13:1(原侧栏/页面同为 #fcfcfc,零层级) |
--foreground |
#060607 |
#131316 |
参考 Void Black:不用纯黑压大屏,画布 16.45:1 |
--card |
#ffffff |
#ffffff |
保持纯白,作为「浮在画布上的文档页」 |
--card-foreground |
#060607 |
#131316 |
与 --foreground 同步,白卡 18.54:1 |
--popover |
#ffffff |
#ffffff |
弹窗面纯白,改用 --shadow-pop 分层 |
--popover-foreground |
#060607 |
#131316 |
同上 |
--primary |
var(--brand) |
var(--brand) |
保持引用,随品牌色联动 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
同上 |
--secondary |
#ebedef |
#e9e9ee |
次级按钮底比 --accent 深一档,避免与 hover 洗色混同(两者原为同值 #ebedef) |
--secondary-foreground |
#060607 |
#131316 |
与前景同档 |
--muted |
#f2f3f5 |
#efeff2 |
内嵌面板/输入凹槽,比画布亮一档 |
--muted-foreground |
#5c5e66 |
#5e5f6e |
参考 Graphite:白卡 6.29:1、画布 5.58:1 |
--accent |
#ebedef |
#ececef |
实测他人气泡取的正是 --accent(rgb(235,237,239)),改 Mist 灰保持中性 |
--accent-foreground |
#060607 |
#131316 |
与前景同档 |
--destructive |
#da373c |
#d92d36 |
收敛到参考的中性红系,白卡 4.80:1、destructive/10 底 4.13:1 |
--border |
#dcdee1 |
#d9d9de |
参考 Hairline,只做装饰分隔线(1.41:1,见 §8 说明) |
--input |
#dcdee1 |
#85869a |
控件边界必须 ≥3:1(WCAG 1.4.11);实测原值 1.41:1 不达标,新值白卡 3.58:1 / 画布 3.17:1 |
--ring |
var(--brand) |
var(--brand) |
焦点环只换色,宽度沿用组件默认 |
--chart-1 |
oklch(0.87 0 0) |
#8a74ff |
图表由灰阶改紫罗兰顺序阶,五档在白卡上全部 ≥3:1(3.49 / 4.91 / 6.12 / 8.08 / 12.75) |
--chart-2 |
oklch(0.556 0 0) |
#7050ff |
同上 |
--chart-3 |
oklch(0.439 0 0) |
#5b3df5 |
与品牌同色,最高频档位 |
--chart-4 |
oklch(0.371 0 0) |
#4a29d8 |
同上 |
--chart-5 |
oklch(0.269 0 0) |
#2f1a8c |
最深档 |
--radius |
0.625rem(10px) |
0.75rem(12px) |
落在参考允许的 {6,8,12,16,9999} 集内;rounded-lg 全站统一 12px,rounded-xl = 16.8px |
--brand |
#2563eb |
#5b3df5 |
蓝 → 电紫罗兰:与参考同族但不照抄其 #6c47ff;白字 6.12:1 |
--brand-foreground |
#ffffff |
#ffffff |
品牌按钮/徽标文字 |
--brand-soft |
rgb(37 99 235 / 0.12) |
rgb(91 61 245 / 0.10) |
选中/浅色标签底,合成 #efecfe;降到 10% 让 --brand-ink 文字达 6.96:1 |
--brand-ink |
#1d4ed8 |
#4a29d8 |
品牌前景文字 + 品牌按钮 hover 底(实测 chrome.ts:140、date-time-picker.tsx:284 用它当 hover 背景):白卡 8.08:1、白字压其上 8.08:1 |
--message-self |
#e8f3fe |
#212126 |
自身消息改为 Obsidian 深色卡(本方案的核心句) |
--message-self-foreground |
#0d274a |
#f5f5f7 |
深色卡正文 14.72:1 |
--surface-chat-soft |
#e8f2ff |
#f1efff |
引用/回复面由浅蓝改紫调,与中性灰气泡拉开色相 |
--surface-chat-selected |
#e5ecfc |
#e9e5ff |
会话树选中底,紫色调同族 |
--mention |
#3370ff |
#4a29d8 |
@提及链接收敛进品牌紫:白卡 8.08:1、surface-chat-soft 上 7.13:1 |
--ink |
#060607 |
#131316 |
bg-ink 深底(视频帧、落地页)主题无关,保持深墨 |
--surface-rail |
#e1e8f2 |
#e6e6ee |
72px rail 带改中性冷灰(原蓝灰 #e1e8f2 与品牌蓝打架) |
--sidebar |
#fcfcfc |
#fbfbfc |
与画布 1.09:1 + 1px hairline,修掉实测「侧栏与页面同色」 |
--sidebar-foreground |
#060607 |
#131316 |
侧栏 17.93:1 |
--sidebar-accent |
#ebedef |
#e9e9ee |
侧栏 hover/选中底与 --secondary 同步 |
--sidebar-accent-foreground |
#060607 |
#131316 |
同上 |
--sidebar-border |
#dcdee1 |
#d9d9de |
与 --border 统一为 Hairline |
--sidebar-primary / --sidebar-primary-foreground |
var(--brand) / var(--brand-foreground) |
不变 | 联动品牌 |
--sidebar-ring |
var(--ring) |
var(--ring) |
同上 |
--workspace-background |
linear-gradient(180deg,var(--surface-rail),#e1e5f1) |
radial-gradient(120% 100% at 12% 0%, color-mix(in oklab, var(--brand) 7%, var(--surface-rail)) 0%, var(--surface-rail) 58%, var(--background) 100%) |
参考「大气晕」的单色低透明度版:只在左上角出现 7% 品牌紫,不出现大面积色块 |
--workspace-rail-background |
transparent |
transparent |
保持 rail 透出渐变 |
--workspace-header-background |
var(--background) |
var(--background) |
保持不变 |
--interactive |
#4e5058 |
#6f707e |
次级交互前景由近黑抬到 Ash 档:白卡 4.89:1 |
--channel-icon |
#80848e |
#82838f |
频道/助手图标 ≥3:1(侧栏底 3.63:1) |
深色 .dark(当前值取自 web/src/styles.css:163-210):
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
oklch(0.145 0 0)(≈#252525) |
#141419 |
画布下压且带一点紫,让卡片能「浮起」 |
--foreground |
oklch(0.985 0 0) |
#f2f2f5 |
画布 16.43:1,比纯白柔一档 |
--card |
oklch(0.205 0 0) |
#1c1c22 |
卡片=obsidian 工作面,比画布亮 1.08:1 |
--card-foreground |
oklch(0.985 0 0) |
#f2f2f5 |
卡片 15.17:1 |
--popover |
oklch(0.205 0 0) |
#232329 |
模态比卡片再抬一档(原与卡片同值,层次丢失) |
--popover-foreground |
oklch(0.985 0 0) |
#f2f2f5 |
模态面 13.99:1 |
--primary / --primary-foreground |
var(--brand) / var(--brand-foreground) |
不变 | 联动品牌 |
--secondary |
oklch(0.269 0 0) |
#26262d |
控制面同族 |
--secondary-foreground |
oklch(0.985 0 0) |
#f2f2f5 |
同上 |
--muted |
oklch(0.269 0 0) |
#1f1f25 |
凹槽比卡片更暗,与 --secondary 分开 |
--muted-foreground |
oklch(0.708 0 0) |
#a3a4b2 |
偏紫中性灰:卡片 6.87:1、画布 7.44:1 |
--accent |
oklch(0.269 0 0) |
#26262d |
他人气泡/hover 洗色 |
--accent-foreground |
oklch(0.985 0 0) |
#f2f2f5 |
同上 |
--destructive |
oklch(0.704 0.191 22.216) |
#ff6b70 |
深底风险色:卡片 6.13:1、destructive/20 底 4.49:1 |
--border |
oklch(1 0 0 / 10%) |
oklch(1 0 0 / 9%) |
参考的 inset 微光语言,装饰线 |
--input |
oklch(1 0 0 / 15%) |
oklch(1 0 0 / 34%) |
控件边界合成 #69696d,卡片 3.10:1(原 15% ≈1.3:1,不达 1.4.11) |
--ring |
var(--brand) |
var(--brand) |
焦点环=品牌紫,卡片上 5.85:1 |
--chart-1..5 |
oklch(0.87/0.556/0.439/0.371/0.269 0 0) |
#bdb0ff / #9b86ff / #8a70ff / #7a5cff / #6d4bf0 |
原灰阶最深档在深底上几乎不可见;新阶五档对画布 3.16–8.73:1 |
--brand |
oklch(0.68 0.15 256) |
#9b86ff |
深色端提亮紫罗兰,与浅色端同色相 |
--brand-foreground |
oklch(0.16 0.02 258) |
#191036 |
深墨字压亮紫:6.20:1 |
--brand-soft |
oklch(0.28 0.05 256) |
rgb(155 134 255 / 0.16) |
选中底合成 #302d45;改 alpha 写法与浅色端同构 |
--brand-ink |
oklch(0.84 0.09 256) |
#c9bcff |
深色品牌前景文字:卡片 9.79:1、brand-soft 上 7.64:1 |
--message-self |
#203b59 |
#2f3037 |
自身消息=抬升工作面(Dark Surface),与 --card 同族但更亮 |
--message-self-foreground |
#e7f3ff |
#f2f3f7 |
11.85:1 |
--surface-chat-soft |
oklch(0.32 0.06 250) |
#26224a |
引用面紫色调同族 |
--surface-chat-selected |
oklch(0.28 0.04 250) |
#2d2856 |
选中行,比引用面更实 |
--mention |
oklch(0.72 0.14 254) |
#b3a3ff |
@提及:卡片 7.75:1、引用面上 6.81:1 |
--ink |
oklch(0.16 0.02 258) |
#131316 |
bg-ink 主题无关 |
--surface-rail |
#e3e5e8(浅色值,实测缺陷) |
#0b0b0f |
修掉「深色下 rail 仍是一条浅色竖带」 |
--sidebar |
oklch(0.205 0 0) |
#1a1a20 |
浮岛比画布亮 1.06:1 |
--sidebar-foreground |
oklch(0.985 0 0) |
#f2f2f5 |
侧栏 15.50:1 |
--sidebar-accent |
oklch(0.269 0 0) |
#26262d |
与 --secondary 同步 |
--sidebar-accent-foreground |
oklch(0.985 0 0) |
#f2f2f5 |
同上 |
--sidebar-border |
oklch(1 0 0 / 10%) |
oklch(1 0 0 / 9%) |
与 --border 统一 |
--sidebar-primary / --sidebar-primary-foreground / --sidebar-ring |
var(--brand) 系 |
不变 | 联动 |
--workspace-background |
radial-gradient(ellipse at 8% 0%, color-mix(in oklab, var(--brand) 10%, var(--muted)), var(--muted) 64%) |
同结构,品牌比例 10% → 8% | 保留参考的左上角单色晕,降低饱和度 |
--workspace-rail-background |
color-mix(in oklab, var(--background) 45%, transparent) |
color-mix(in oklab, var(--background) 55%, transparent) |
rail 在深色下要更实,才能读成一条独立外框 |
--workspace-header-background |
品牌 3% 线性渐变 | 保持 | 不变 |
--interactive |
(未在 .dark 声明,继承浅色 #4e5058) |
#a6a7b4 |
补深色值:卡片 7.11:1(原来深色下沿用近黑前景) |
--channel-icon |
(未在 .dark 声明,继承 #80848e) |
#9a9bab |
补深色值:侧栏底 6.31:1 |
--shadow-e1..e3 / --shadow-pop |
浅色下投影 | 0 1px 0 rgb(255 255 255 / 0.024~0.05) inset, 0 0 0 1px rgb(255 255 255 / 0.024~0.05) inset |
参考规则 4:深色面只用 inset 微光做边界 |
字体与排版
字体栈(不改顺序,只说明):--font-sans 保持 "Geist Variable", "gg sans", "Noto Sans SC", "PingFang SC", ui-sans-serif, system-ui, "Segoe UI", "Microsoft YaHei", …。Geist 无中文字形,中文实际落在 Noto Sans SC/PingFang SC,拉丁-中文混排时以中文字体的基线为准,因此不允许把西文字体插到中文字体之前(否则中文回退被挤掉)。--font-mono 保持 ui-monospace, "SF Mono", Menlo, Consolas, …,只用于数字/编号/代码。
字号阶梯(目标档位,均落在现有组件默认刻度上:text-xs 12px / text-sm 14px / text-[15px] / text-base 16px):
| 角色 | 字号/字重/行高 | 用途(实测样例) | 载体 |
|---|---|---|---|
| 页面标题 | 16px / 600 / 1.25 | 频道头「通用讨论」(实测 16px/600) | 组件默认 |
| 卡片标题 | 14px / 500 / 1.35 | 任务卡「修复已读未读状态bug」 | 组件默认 |
| 正文 | 15px / 400 / 1.375(20.63px) | 消息正文、长段落(body 实测 15px/1.375) |
body 默认,不改 |
| 次级正文 | 13px / 400 / 1.5 | 作者名、表单标签(实测 13px/400) | 组件默认 |
| 标签/徽标 | 12px / 500 / 1 | 成员数、状态徽标、时间(实测 12px/500) | 组件默认 |
| 数字/代码 | mono 12px / 500 | 任务编号 #WAN-2041、时间、计数 |
--font-mono + tabular-nums |
中文与数字的注意点
- 中文最小 12px(现状已出现 9px / 9.375px / 11.25px 三档,属 §8 的风险项);
--muted-foreground5.58–6.29:1 保证 12px 中文在画布上也达标。 - 中文行高不得低于 1.375;消息正文保持
body的 1.375,引用块与 AI 回答用leading-relaxed(1.625)。 - 数字一律走
--font-mono并开tabular-nums(任务计数、时间、457 任务、580 用户这类统计列要对齐)。 - 中西混排不额外加空格,靠字体的 CJK 标点挤压即可;长任务名用
wrap-break-word,不截断成省略号(任务名是识别主键)。
关键界面改造
每条的「途径」标注:① 语义令牌取值;② 官方 variant/size 选择;③ 容器布局/尺寸/间距/滚动。
S1 应用外壳 + 空间/频道侧栏(app-shell.tsx、channel-sidebar.tsx、workspace-rail.tsx)
- 现状:
aside256×715 @x=76,border-radius 14px,background #fcfcfc与页面--background:#fcfcfc完全相同;nav72×900 背景transparent、右边框rgba(220,222,225,0.55);侧栏头部 52px、搜索框 30px/圆角 10px/底rgba(235,238,239,0.75);会话行 240×64,预览 11.25px。 - 改后:
- 「途径①」画布
#f1f1f4、浮岛--sidebar #fbfbfc、rail 带--surface-rail #e6e6ee+--workspace-background单色紫晕 → 从「画布 / 浮岛」1.09:1 + 「rail / 画布」1.10:1 + 1px--border #d9d9de组成四级面(原来所有面都是#fcfcfc)。 - 「途径①」搜索框底走
--muted #efeff2(原rgba(235,238,239,0.75)是硬编码值,落在channel-sidebar.tsx内,无法用令牌覆盖 → 见 §8 风险 R4)。 - 「途径③」三栏宽度(72 / 256 / 主区)与 52px 头部高度保持不变 —— 这是可用性基线,本方案不动。
- 「途径①」画布
- 状态色:未读点沿用
--destructive,选中行--surface-chat-selected+--brand-ink(实测chrome.ts:19的sidebar-selection就是这两枚令牌,无需改组件)。
S2 频道消息流(message-list.tsx、channel-header.tsx、channel-tabs.tsx)
- 现状:频道头 860×52;他人气泡
rgb(235,237,239)(=--accent)、自己rgb(232,243,254)(=--message-self)+ 文字rgb(13,39,74);气泡圆角 14px;正文他人 15px/400、自己 14px/400(同一列表两套字号);作者 13px、时间 12px/500#5c5e66;输入区 textarea 628×33 无边框,容器只有上边框rgb(220,222,225);工具按钮 28×28。 - 改后:
- 「途径①」自身消息 =
--message-self #212126+--message-self-foreground #f5f5f7(14.72:1),他人 =--accent #ececef;两者明度差 13.59:1,主题无关地成立(原来 1.09:1)。这就是参考「深色产品卡浮在浅色文档壳里」的直接落地。 - 「途径①」@提及
--mention #4a29d8(chat-soft 上 7.13:1)取代硬编码#3370FF;引用/回复面--surface-chat-soft #f1efff;频道 tab 选中线--brand(channel-tabs.tsx:19已用after:!bg-brand+data-active:text-brand-ink,令牌换值即生效)。 - 「途径①/③」输入区:容器上边框走
--border #d9d9de,textarea 保持无边框(现状已经如此),工具按钮 28×28 改用官方Button variant="outline" size="icon-xs"(24px)或icon-sm(28px)以对齐 exist 尺寸档(现状是自定义 28px)。 - 字号双轨(15px vs 14px)本方案无法用令牌解决,见 §8 风险 R1。
- 「途径①」自身消息 =
S3 任务大厅 + 任务卡(task-hall.tsx、group-hall.tsx、channel-work-items.tsx)
- 现状:卡片圆角 10px×48 / 8px×37 混用;任务卡=标题 14px/500 + 频道 chip +
AI 助手chip +查看任务+ 负责人;AI 助手空间单次渲染 12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724,圆角 8px×1591 / 10px×844;状态色来自 Tailwind 原始调色板。 - 改后:
- 「途径①」
--radius10px → 12px,使rounded-lg一族统一到 12px、rounded-xl到 16.8px,8px 那一档收敛到--radius-sm(7.2px)附近,圆角从 12 档收缩到 4 档(12 / 16.8 / 7.2 / 9999)。 - 「途径①」卡片边界:
ui/card.tsx用ring-1 ring-foreground/10,在浅色下由--foreground #131316决定 →#ffffff上约 1.24:1(细描边,与--shadow-e1的 0.5px 描边叠加成参考式「细线卡」);深色下#f2f2f510% 合成#303036,与深色端「inset 微光当边界」的写法一致。 - 「途径②」状态徽标只用官方
Badge:待处理/待验收→variant="outline"(--border+--foreground);进行中→variant="default"(--brand+--brand-foreground,6.12:1);已完成→variant="secondary";已关闭→variant="ghost"(--muted+--muted-foreground);已过期/风险→variant="destructive"(--destructive/10+--destructive,4.13:1)。amber/emerald/rose 那 179 处 Tailwind 调色板引用需要组件改动才能收敛,见 §8 风险 R2。 - 「途径②」频道 chip 用
Badge variant="secondary",AI 助手chip 用Badge variant="default"(与全站唯一动作色一致)。 - 「途径③」看板列改为
grid等宽列(现状是横向滚动的列),列头用--muted底 + 12px/500 计数,卡片间距 8px(4px 基线的两倍)。
- 「途径①」
S4 AI 助手频道(agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx)
- 现状:全站最密集视图(395 项任务),单次渲染 4 档字号、圆角 8px×1591 / 10px×844;流式回答与来源引用目前与普通消息同底色。
- 改后:
- 「途径①」AI 回答卡走
--card+--shadow-e1(浅色 0.5px 描边;深色 inset 微光),引用来源块走--surface-chat-soft,来源编号走--mention——把「AI 结果面」从消息流里视觉抬升一层,而不是靠新增颜色。 - 「途径②」
结果 / 来源切换用官方Tabs(variant="line"用--brand下划线,variant="default"用--muted底 +--card活动项),替代现状的自定义分段。 - 「途径③」结果卡片列表改
grid+ScrollRegion,把 1591 个 8px 圆角小块收敛到 12px 一档。 - 「途径②」等待态沿用既有 3 个点的
--animate-breathe,颜色改--brand(令牌换值即生效)。
- 「途径①」AI 回答卡走
S5 管理与设置弹窗(space-manage-dialog.tsx、channel-settings-dialog.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),危险项--destructive #da373c;输入框 488×32、圆角 10px;表单标签 14px。 - 改后:
- 「途径①」弹窗面
--popover(浅#ffffff/ 深#232329,深色下比卡片高一级),阴影--shadow-pop(参考的 Auth Modal 分层写法),边界由阴影承担。 - 「途径①」选中项
--brand-soft合成#efecfe+--brand-ink #4a29d8= 6.96:1(原 10%/12% 对照#1d4ed8为 7.03:1,改动后更稳);危险项--destructive #d92d364.80:1。 - 「途径①」输入框圆角改由
--radius驱动(10px → 12px),边界--input #85869a3.58:1(原来是 1.41:1,表单密集页最吃亏的一项)。 - 「途径②」成员列表用官方
Item+Avatar(size="sm"/default/lg三档已存在),左侧导航用Tabs variant="vertical"(官方已支持 vertical orientation),不再自造选中样式。
- 「途径①」弹窗面
S7 登录页(routes/login.tsx、sign-in.$.tsx)
- 现状:居中卡片,主标题 26px;「邮箱验证码 / 短信验证码」切换块 173×42,选中态底
--background #fcfcfc+ 品牌蓝字;主按钮 356×52 白字#2563eb;页脚 11px。 - 改后:
- 「途径①」主按钮 =
--brand #5b3df5+--brand-foreground #ffffff= 6.12:1(原#2563eb白字 5.17:1),是全站唯一的高饱和面。 - 「途径①」切换块选中态底由
--background改为--card(浅色下#ffffff对--muted底 1.15:1 的凹槽)—— 原来用--background,而--background现在与画布同色,选中态会「陷进去」;底色改走--muted #efeff2,选中项--card+--shadow-e1+--brand-ink文字。 - 「途径③」登录页背景直接用
--workspace-background(左上角 7% 紫晕 + rail 冷灰),与主应用同一张画布,登录→主界面不跳色。 - 「途径③」卡片内边距与页脚字号(11px → 12px)属容器/排版改动,需在路由组件里调;若不允许动组件,则保留 11px 并记入 §8 风险 R1。
- 「途径①」主按钮 =
S8 应用中心(app-center.tsx、assistant-board.tsx)
- 现状:分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」+ 卡片(
运行中/开发中徽标、emoji 图标、Agent · 第三方 · chat元信息)。 - 改后:
- 「途径①」卡片 =
--card+--shadow-e1/e2,筛选选中项 =--brand-soft+--brand-ink(6.96:1),运行中=Badge variant="default",开发中=Badge variant="outline"。 - 「途径②」分类筛选从自定义 chip 行改官方
Tabs(variant="line"或default);应用卡片容器用Card size="sm"(官方 size 已存在)。 - emoji 图标无法用令牌解决(emoji 是内容且有系统自带色彩,深色下不变、不可换色)→ §8 风险 R3:需把 emoji 换成
lucide图标(components.json已声明iconLibrary: lucide)。
- 「途径①」卡片 =
S6 语音频道(仅代码依据,非截图)
本机 TRTC_ENABLED=false,界面不渲染任何语音元素(DOM 内 aria-label 匹配「语音|通话|加入」命中 0,正文不含「语音」),/api/v1/rtc/* 返回 RTC_DISABLED;库内 wanman3_rtc_voice_channels 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行。因此本节只依据代码 rtc-group-call-ui.tsx / rtc-video-frame.tsx / rtc-mini-window.tsx(后两者用 bg-ink)设计:视频帧与迷你窗用 --ink #131316(两套主题都深),通话成员状态用 Badge variant="outline" + 连接态文案(已连接 / 连接中 / 重连中 / 已断开 / 连接失败),不新增颜色令牌。未做任何截图取证。
深浅色与对比度
对比度按 WCAG 相对亮度公式实算(#hex → sRGB 线性 → 0.2126R+0.7152G+0.0722B → (L1+0.05)/(L2+0.05))。合成色(alpha 叠底)按 α 混合后计算。
浅色
| 组合 | 前景 hex | 背景 hex | 比值 | 达标(正文 ≥4.5 / 图形 ≥3) |
|---|---|---|---|---|
| 正文 / 画布 | #131316 |
#f1f1f4 |
16.45 | ✅ |
| 正文 / 卡片 | #131316 |
#ffffff |
18.54 | ✅ |
| 次级文字 / 画布 | #5e5f6e |
#f1f1f4 |
5.58 | ✅ |
| 次级文字 / 卡片 | #5e5f6e |
#ffffff |
6.29 | ✅ |
| 次级文字 / 他人气泡 | #5e5f6e |
#ececef |
5.34 | ✅ |
| 品牌按钮文字 / 品牌底 | #ffffff |
#5b3df5 |
6.12 | ✅ |
| 品牌文字 / 品牌浅底 | #4a29d8 |
#efecfe |
6.96 | ✅ |
| 品牌文字 / 白卡 | #4a29d8 |
#ffffff |
8.08 | ✅ |
| 自身消息文字 / 自身气泡 | #f5f5f7 |
#212126 |
14.72 | ✅ |
| 风险色 / 白卡 | #d92d36 |
#ffffff |
4.80 | ✅ |
风险色 / destructive/10 底 |
#d92d36 |
#fbeaeb |
4.13 | ⚠️ 仅用于 12px/500 徽标与图标(图形 + 粗体小字),不建议当正文色 |
| @提及 / 卡片 | #4a29d8 |
#ffffff |
8.08 | ✅ |
| @提及 / 引用面 | #4a29d8 |
#f1efff |
7.13 | ✅ |
| @提及 / 选中行 | #4a29d8 |
#e9e5ff |
6.58 | ✅ |
| 侧栏文字 / 侧栏 | #131316 |
#fbfbfc |
17.93 | ✅ |
| 频道图标 / 侧栏 | #82838f |
#fbfbfc |
3.63 | ✅(图形) |
| 控件边界 / 卡片 | #85869a |
#ffffff |
3.58 | ✅(1.4.11) |
| 控件边界 / 画布 | #85869a |
#f1f1f4 |
3.17 | ✅ |
| 焦点环 / 卡片 | #5b3df5 |
#ffffff |
6.12 | ✅ |
| 装饰分隔线 / 卡片 | #d9d9de |
#ffffff |
1.41 | ⚠️ 装饰线,非控件边界(见 §8 R5) |
| 图表 1–5 / 卡片 | #8a74ff…#2f1a8c |
#ffffff |
3.49 / 4.91 / 6.12 / 8.08 / 12.75 | ✅ |
| 面层级:卡片 / 画布 | #ffffff |
#f1f1f4 |
1.13 | 层级不靠对比度,靠 1px hairline + 阴影 |
| 面层级:rail / 画布 | #e6e6ee |
#f1f1f4 |
1.10 | 同上 |
| 面层级:侧栏 / 画布 | #fbfbfc |
#f1f1f4 |
1.09 | 同上 |
深色
| 组合 | 前景 hex | 背景 hex | 比值 | 达标 |
|---|---|---|---|---|
| 正文 / 画布 | #f2f2f5 |
#141419 |
16.43 | ✅ |
| 正文 / 卡片 | #f2f2f5 |
#1c1c22 |
15.17 | ✅ |
| 正文 / 模态 | #f2f2f5 |
#232329 |
13.99 | ✅ |
| 次级文字 / 画布 | #a3a4b2 |
#141419 |
7.44 | ✅ |
| 次级文字 / 卡片 | #a3a4b2 |
#1c1c22 |
6.87 | ✅ |
| 次级文字 / 他人气泡 | #a3a4b2 |
#26262d |
6.09 | ✅ |
| 品牌按钮文字 / 品牌底 | #191036 |
#9b86ff |
6.20 | ✅ |
| 品牌文字 / 品牌浅底 | #c9bcff |
#302d45 |
7.64 | ✅ |
| 品牌文字 / 卡片 | #c9bcff |
#1c1c22 |
9.79 | ✅ |
| 自身消息文字 / 自身气泡 | #f2f3f7 |
#2f3037 |
11.85 | ✅ |
| 风险色 / 卡片 | #ff6b70 |
#1c1c22 |
6.13 | ✅ |
风险色 / destructive/20 底 |
#ff6b70 |
#492c32 |
4.49 | ⚠️ 临界(≈4.5),用于徽标/图标 |
| @提及 / 卡片 | #b3a3ff |
#1c1c22 |
7.75 | ✅ |
| @提及 / 引用面 | #b3a3ff |
#26224a |
6.81 | ✅ |
| 侧栏文字 / 侧栏 | #f2f2f5 |
#1a1a20 |
15.50 | ✅ |
| 频道图标 / 侧栏 | #9a9bab |
#1a1a20 |
6.31 | ✅(图形) |
控件边界 / 卡片(合成 #69696d) |
#69696d |
#1c1c22 |
3.10 | ✅(1.4.11) |
控件边界 / 画布(合成 #69696d) |
#69696d |
#141419 |
3.36 | ✅ |
| 焦点环 / 卡片 | #9b86ff |
#1c1c22 |
5.85 | ✅ |
装饰分隔线 / 卡片(合成 #303036) |
#303036 |
#1c1c22 |
1.29 | ⚠️ 装饰线(参考明确用 inset 微光做深色边界) |
| 图表 1–5 / 卡片 | #bdb0ff…#6d4bf0 |
#1c1c22 |
8.73 / 5.85 / 4.72 / 3.88 / 3.16 | ✅ |
| 面层级:卡片 / 画布 | #1c1c22 |
#141419 |
1.08 | 同浅色逻辑 |
| 面层级:rail / 画布 | #0b0b0f |
#141419 |
1.07 | 同上 |
| 面层级:侧栏 / 画布 | #1a1a20 |
#141419 |
1.06 | 同上 |
shadcn 兼容性
结论:只靠三条约定的途径可以达成 90% 的观感目标;剩下 10% 必须动组件,已在下方标为风险。
- 官方组件清单核对(
web/src/components/ui/现有 38 个):本方案用到的button、badge、input、textarea、tabs、avatar、separator、card、dialog、item、scroll-region、scroll-surface、tooltip、dropdown-menu、select、bubble、message、skeleton全部已安装,components.json已是style: base-nova/iconLibrary: lucide。不需要新增任何官方组件。 - 官方 variant/size 使用清单:
Button→default | outline | secondary | ghost | destructive | link×default(32) | sm(28) | xs(24) | icon | icon-xs(24) | icon-sm(28) | icon-lg(36);Badge→default | secondary | destructive | outline | ghost | link(高度 20px,pill);Card→size="default" | "sm";Avatar→size="sm" | "default" | "lg";Bubble→default | secondary | muted | tinted | outline | ghost | destructive;Tabs→variant="default" | "line"且支持 vertical orientation。这些都能靠令牌换值产生本方案的观感,无需新增变体。 - 令牌覆盖度自检:§5.1 第 4 条要求的全部变量(
background / foreground / card / card-foreground / popover / popover-foreground / primary / primary-foreground / secondary / secondary-foreground / muted / muted-foreground / accent / accent-foreground / destructive / border / input / ring / brand / brand-foreground / brand-soft / brand-ink / message-self / message-self-foreground / surface-chat-soft / surface-chat-selected / mention / ink / surface-rail / sidebar / sidebar-foreground / sidebar-accent / sidebar-accent-foreground / sidebar-border / chart-1..5 / radius)在tokens.css浅深两套中逐项给出,另有sidebar-primary(-foreground) / sidebar-ring / workspace-* / interactive / channel-icon / shadow-*作为一致性补充。
不合规风险(必须显式标注)
| 编号 | 风险 | 证据 | 影响 | 归属 |
|---|---|---|---|---|
| R1 | 字号体系无刻度,且消息正文双轨 15px/14px | 实测单视图字号 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26px;styles.css 硬编码 font-size 12px×12、13px×7、14px×2 |
令牌层无法修;需要组件把 text-[15px]/text-[14px]/text-[11.25px] 收敛到 text-sm/text-xs |
途径②之外,需改组件 className |
| R2 | 253 处 Tailwind 原始调色板(44 个非测试文件:amber 69 / rose 68 / slate 44 / emerald 42 / teal 12 / blue 7 / red 3 / violet 2 / purple 2 / neutral 2 / sky 1 / cyan 1)绕过语义令牌,深色下不翻转 | leaks-*.json 普查 |
任务状态色、AI 结果 tone、头像首字底色在深色下仍是浅色块;本方案只能覆盖走 --brand* / --destructive / --muted* 的那部分 |
需把 tone.ts、chrome.ts、app/avatar.tsx 的调色板类换成语义令牌 |
| R3 | 应用中心/助手图标是 emoji | 实测「emoji 图标 + Agent · 第三方 · chat」;emoji 有系统自带色彩、深色不变、不可换色 |
令牌层无法修;与单一色纪律直接冲突 | 需换 lucide(components.json 已声明) |
| R4 | 外壳里仍有硬编码色(搜索框底 rgba(235,238,239,0.75)、rail 右边框 rgba(220,222,225,0.55)、分隔线 rgba(5,5,9,0.22)、#006ce7 三处、chrome.ts #f06f66、tone.ts #23a55a/#f0b232、image-preview-dialog.tsx #f2f3f5、file-preview/* 一整套) |
实测抽样 | 这些点在深色下仍浅色 | 需组件改动;本方案不冒充已解决 |
| R5 | --border #d9d9de 对白卡仅 1.41:1,低于 1.4.11 的 3:1 |
参考 Hairline 本身即 #d9d9de |
仅用于装饰分隔线;控件边界已单独用 --input #85869a(3.58:1)承担,这是本方案对参考的颜色纪律做的合规偏离 |
已在实现层拆分为两枚令牌 |
| R6 | 深色主题在生产不可达:全仓 web/src 无任何代码给 <html> 加 .dark,localStorage 无主题键,color-scheme: normal;注入 .dark 后仍有 55 处前景 rgb(6,6,7)、27 处 rgb(92,94,102)、6 处边框 rgb(220,222,225) 保持浅色 |
实测(S1-shell-dark-injected / S2-thread-dark-injected) |
本方案给出了完整深色令牌,但没有改主题开关(属功能开发,超出「只改令牌」范围) | 需产品决策 + 组件清理后才算真正交付深色 |
实施成本
改动面
| 文件 | 改动 | 途径 | 预估 |
|---|---|---|---|
web/src/styles.css(:root 块,L110–160) |
36 个变量换值 | ① | 1.0 h |
web/src/styles.css(.dark 块,L163–210) |
33 个变量换值 + 补 --interactive / --channel-icon |
① | 1.0 h |
web/src/styles.css(@theme inline 阴影段,L43–49) |
4 个阴影令牌改分层聚拢写法 | ① | 0.5 h |
| 令牌回归核对 | 逐条 computed style 断言 | — | 2.0 h |
只改令牌的方案包(本目录三件)合计约 0.6 人日,可独立上线,效果即 §6 的 S1/S2/S3/S5/S7 主体。
做到「无残留」需要附带组件改动(另计约 3 人日):
| 任务 | 文件 | 人时 |
|---|---|---|
字号收敛到 text-xs/sm/base 刻度(去掉 9.375 / 11.25 / 12.8 / 13.125px) |
message-list.tsx、agent-channel*.tsx、channel-sidebar.tsx |
6 h |
| 调色板类收敛(amber/rose/slate/emerald → 语义令牌) | tone.ts、chrome.ts、app/avatar.tsx、task-hall.tsx |
8 h |
| emoji → lucide 图标 | app-center.tsx、assistant-board.tsx |
2 h |
| 硬编码色清理(三蓝并存、file-preview 一套) | message-list.tsx、composer-markdown.ts、chat-mention.ts、file-preview/* |
6 h |
深色主题开关(<html class> + 持久化 + color-scheme) |
主题 provider | 4 h |
风险清单:R1 字号(面最广,跨 4 个高频组件);R2 调色板泄漏(253 处,深色下最刺眼);R6 深色不可达(不做则深色令牌只是备用);R5 已在实现里规避。
验证方式(不依赖截图)
getComputedStyle(document.documentElement).getPropertyValue('--background')→ 期望#f1f1f4(浅)/#141419(加.dark后)。- 实测断言目标(与 §3.3 的现状实测一一对应,可直接复算):
aside计算背景由rgb(252,252,252)变rgb(251,251,252),且body/.workspace-shell背景不再是同色;- 自身消息气泡
background-color由rgb(232,243,254)变rgb(33,33,38),其color为rgb(245,245,247); - 他人气泡由
rgb(235,237,239)变rgb(236,236,239); <input>的border-color由rgb(220,222,225)变rgb(133,134,154);- 任一
rounded-lg元素border-radius由10px变12px(--radius12px × 1 = 12)。
- 对比度脚本:把 §7 的三列(组合 / hex / 期望比值)做成断言,浅深各跑一次;比值容差 ±0.01。
- 深色检查:临时给
<html>加.dark后重跑第 2 步全部断言(会暴露 R2/R4 的残留,作为组件整改清单)。
取舍
解决了什么
- 层级:画布 / rail / 浮岛 / 卡片四级面从「全是
#fcfcfc」变成可辨的灰阶阶梯 + 1px hairline(浅色#f1f1f4/#e6e6ee/#fbfbfc/#ffffff)。 - 两种信息的区分不再依赖色相:自身 vs 他人消息从 1.09:1 的浅蓝色差变成 13.59:1 的明度差(
#212126vs#ececef),深浅两套主题下都成立。 - 动作色收敛:
#2563eb/#006ce7/#3370ff三蓝并存 → 单一紫罗兰(#5b3df5浅 /#9b86ff深),所有「可执行」的东西同色。 - 合规性补齐:控件边界从 1.41:1 提到 3.17–3.58:1(浅)/ 3.10–3.36:1(深),并修掉
--surface-rail在深色下仍是浅色这个实测缺陷。 - 一套令牌驱动两套主题:浅深两套值同构(同一命名、同一角色),Flutter 端可直接复用。
牺牲了什么
- 高饱和品牌蓝的「企业感」被换成更冷的紫罗兰:对 40+ 岁一线操作者的品牌直觉是一次迁移成本(但动作色数量从 3 种降到 1 种)。
- 自己的消息变成深色块,在长对话里视觉重量大:适合「任务/决策类」消息,不适合纯寒暄刷屏场景。
- 面层级对比度刻意做得很低(1.06–1.13:1):达不到 3:1,深度完全靠 hairline 与阴影,在高亮度户外屏上分层会变弱。
- 图表从灰阶改紫罗兰顺序阶:顺序/热力场景更好读,但 5 类并列的分类图表区分度不如多色相方案(本产品图表以任务量与进度为主,可接受)。
什么场景下不适用
- 若产品坚持「浅色一统」(不做深色主题),本方案的双面叙事只剩一半,收益会掉到「层级 + 合规」两项,此时不如选单主题方案。
- 若业务要以营销/落地页为主(
components/landing/*已存在bg-ink深色段),参考的营销规则仍不适用,本方案只覆盖/app三栏工作区。 - 若短期内不能做 R1/R2 的组件整改,深色主题上线后会被 Tailwind 原始调色板与硬编码色拉回原样——先改令牌、再排组件整改,否则不要开深色开关。