明暗混排工作台(clerk 方案)

方案名与主张

方案名:明暗混排工作台(slug clerk)

一句话主张: 把「浅色文档壳 + 深色产品卡」的混排语言搬进协作工具 —— 频道消息流是浅色的文档页,自己的消息、任务卡与 AI 结果面是浮在其中的深色工作面,全站只有一条紫罗兰脉冲代表「可执行的动作」。

适用基调:双主题对等。浅色是默认主壳(画布 #f1f1f4 / 浮岛 #fbfbfc / 卡片 #ffffff),深色是 obsidian 工作台(画布 #141419 / 卡片 #1c1c22 / 抬升面 #2f3037),两套都由同一组语义令牌驱动,两套都逐项算过对比度。


参考提炼

可迁移的 5 条规则(引用其原文要点)

  1. 双面共存,不许压平:「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 里落成「浅色消息流 + 深色自身消息/工作面」,并且深浅两套令牌都是完整方案,不是一个主题的附属。
  2. 单一强调色的稀缺纪律:「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 归到同一支紫罗兰,且不做大面积填充底色。
  3. 圆角只允许 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 全站落在允许集内。
  4. 深色面只用内描边、不用投影:「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% 白。
  5. 层级靠灰阶与细线,不靠重投影:其 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 玻璃层。


适配判断

为什么这套语言适合「任务 + 频道消息」的企业工具

  1. 两种信息形态本来就有两种材质。频道消息是连续阅读的「文档」,自己的消息/任务卡/AI 结果面是「被操作的物件」。参考的 dual-surface 刚好给出这两种材质的对应关系:文档壳用近白 + 细线,工作面用深色卡。实测现状里这两者只靠色相差区分(自己 rgb(232,243,254) vs 他人 rgb(235,237,239),亮度差 1.09:1),深色下无法翻转;换成明度区分后自己/他人气泡是 13.59:1,任何主题下都成立。
  2. 单一强调色对高频工具是减负。实测已达 253 处 Tailwind 原始调色板引用(amber 69 / rose 68 / slate 44 / emerald 42 …)和三种蓝并存(#2563eb / #006ce7 / #3370ff)。参考的「一个色只做一件事」纪律正好是这套工具需要的收敛方向:所有「可执行」的东西是紫色,其余全部落回中性灰阶。
  3. 灰阶密度适合长时段驻留。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

中文与数字的注意点

  1. 中文最小 12px(现状已出现 9px / 9.375px / 11.25px 三档,属 §8 的风险项);--muted-foreground 5.58–6.29:1 保证 12px 中文在画布上也达标。
  2. 中文行高不得低于 1.375;消息正文保持 body 的 1.375,引用块与 AI 回答用 leading-relaxed(1.625)。
  3. 数字一律走 --font-mono 并开 tabular-nums(任务计数、时间、457 任务、580 用户 这类统计列要对齐)。
  4. 中西混排不额外加空格,靠字体的 CJK 标点挤压即可;长任务名用 wrap-break-word,不截断成省略号(任务名是识别主键)。

关键界面改造

每条的「途径」标注:① 语义令牌取值;② 官方 variant/size 选择;③ 容器布局/尺寸/间距/滚动。

S1 应用外壳 + 空间/频道侧栏(app-shell.tsx、channel-sidebar.tsx、workspace-rail.tsx)

S2 频道消息流(message-list.tsx、channel-header.tsx、channel-tabs.tsx)

S3 任务大厅 + 任务卡(task-hall.tsx、group-hall.tsx、channel-work-items.tsx)

S4 AI 助手频道(agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx)

S5 管理与设置弹窗(space-manage-dialog.tsx、channel-settings-dialog.tsx、channel-permission-picker.tsx)

S7 登录页(routes/login.tsx、sign-in.$.tsx)

S8 应用中心(app-center.tsx、assistant-board.tsx)

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% 必须动组件,已在下方标为风险。

不合规风险(必须显式标注)

编号 风险 证据 影响 归属
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 已在实现里规避。

验证方式(不依赖截图)

  1. getComputedStyle(document.documentElement).getPropertyValue('--background') → 期望 #f1f1f4(浅)/ #141419(加 .dark 后)。
  2. 实测断言目标(与 §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(--radius 12px × 1 = 12)。
  3. 对比度脚本:把 §7 的三列(组合 / hex / 期望比值)做成断言,浅深各跑一次;比值容差 ±0.01。
  4. 深色检查:临时给 <html> 加 .dark 后重跑第 2 步全部断言(会暴露 R2/R4 的残留,作为组件整改清单)。

取舍

解决了什么

  1. 层级:画布 / rail / 浮岛 / 卡片四级面从「全是 #fcfcfc」变成可辨的灰阶阶梯 + 1px hairline(浅色 #f1f1f4 / #e6e6ee / #fbfbfc / #ffffff)。
  2. 两种信息的区分不再依赖色相:自身 vs 他人消息从 1.09:1 的浅蓝色差变成 13.59:1 的明度差(#212126 vs #ececef),深浅两套主题下都成立。
  3. 动作色收敛:#2563eb / #006ce7 / #3370ff 三蓝并存 → 单一紫罗兰(#5b3df5 浅 / #9b86ff 深),所有「可执行」的东西同色。
  4. 合规性补齐:控件边界从 1.41:1 提到 3.17–3.58:1(浅)/ 3.10–3.36:1(深),并修掉 --surface-rail 在深色下仍是浅色这个实测缺陷。
  5. 一套令牌驱动两套主题:浅深两套值同构(同一命名、同一角色),Flutter 端可直接复用。

牺牲了什么

  1. 高饱和品牌蓝的「企业感」被换成更冷的紫罗兰:对 40+ 岁一线操作者的品牌直觉是一次迁移成本(但动作色数量从 3 种降到 1 种)。
  2. 自己的消息变成深色块,在长对话里视觉重量大:适合「任务/决策类」消息,不适合纯寒暄刷屏场景。
  3. 面层级对比度刻意做得很低(1.06–1.13:1):达不到 3:1,深度完全靠 hairline 与阴影,在高亮度户外屏上分层会变弱。
  4. 图表从灰阶改紫罗兰顺序阶:顺序/热力场景更好读,但 5 类并列的分类图表区分度不如多色相方案(本产品图表以任务量与进度为主,可接受)。

什么场景下不适用

  1. 若产品坚持「浅色一统」(不做深色主题),本方案的双面叙事只剩一半,收益会掉到「层级 + 合规」两项,此时不如选单主题方案。
  2. 若业务要以营销/落地页为主(components/landing/* 已存在 bg-ink 深色段),参考的营销规则仍不适用,本方案只覆盖 /app 三栏工作区。
  3. 若短期内不能做 R1/R2 的组件整改,深色主题上线后会被 Tailwind 原始调色板与硬编码色拉回原样——先改令牌、再排组件整改,否则不要开深色开关。