黑白高亮台
方案名与主张
中文方案名:黑白高亮台(slug: ramp)
一句话主张: 把整站压成「暖白纸面 + 墨黑文字 + 发丝边界」的近单色编辑部版面,只留下一支柠檬黄高亮笔 #e4f222——只在动作(主按钮、接单)与正在发生(未读、进行中、当前频道、@提及)出现;纸面上其余一切由字号、字重、明暗层级和 1px 边界承担。
适用基调:浅色优先(企业工具白天长时段驻留为主),深色为等价完整的第二主题——本方案两套令牌一一对应、逐项给值,深色不是附属品。
主色: --brand: #e4f222(柠檬黄),配墨黑字 #0c0a08。
参考提炼
- 参考风格名: Ramp — Style Reference(编辑部财务台 / Editorial finance desk)
- slug:
ramp - 来源站点: Ramp(金融 SaaS 官网)
- Theme: light
- 可迁移规则(引自其 DESIGN.md 原文要点):
- 单一强调色纪律 —— "Use
#e4f222only for primary action fills, live counters, and active states — never as a background wash or decorative accent."(唯一色相只作动作信号) - 发丝边界取代阴影 —— "Express card elevation with 1px
#e5e7ebborders on#fffffffills — avoid box-shadow."(升维靠 1px 边界,不靠投影) - 近单色画布分层 —— Surfaces:Canvas
#f4f2f0→ Card#ffffff→ Wash#f4f2f0→ Inverted#1a1919(用明度而非色相分层) - 排版承担层级 —— 字号/字距/大写微标签(10px,
letter-spacing 0.018em)造层级;但这套系统用单一字重 400 造层级,这一点在本产品不可迁移(见「适配判断」)。 - 圆角系统收敛 —— "buttons/tags 6px, inputs 10px, cards 12/16px",明确拒绝 pill 与 4px。
- 表格页留白纪律 —— Page max-width 1200px、Element gap 8px、Card padding 20–24px。
适配判断
为什么这套语言适合「任务 + 频道消息」的企业工具:
- 本产品信息密度极高(实测单视图一次渲染:
12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724;AI 助手空间 395 项任务)。高密度视图最怕多色相的噪声;近单色把注意力预算全部让给内容,只留一个色相信号 = "这里有事在发生"。这与「任务状态流转 + 未读提醒」的核心需求天然同构:黄 = 待你处理。 - 现有基调是「飞书本机外观采样」,实测问题很具体:
aside侧栏#fcfcfc与页面--background: #fcfcfc完全相同(对比度 1.00:1),整个外壳没有层级;同时全仓 253 处 Tailwind 原始调色板(amber 69 / rose 68 / slate 44 / emerald 42…),三种蓝并存(--brand #2563eb、硬编码#006ce7、--mention #3370ff)。Ramp 的「一个强调色 + 发丝边界」正好是这两处病灶的解药。 - 中文界面:Ramp 的拉丁式排版(大写微标签、正字距)可迁移;几何靠字号不靠字重的做法不可照搬,理由见下。
明确舍弃项:
| 舍弃 | 原因 |
|---|---|
| 单一字重 400 造层级 | 中文没有 x-height 差异带来的观感落差,用 400 单字重会让 14/15px 的高密度中文块「糊成一片」(现有 message-list 里 13px 作者 + 15px 正文的微弱区分已经偏弱)。故保留 400/500/600 三档,靠字号 + 字重 + 颜色三重区分,这是对参考规则的有意偏离。 |
| 64/48/40px 大标题、1200px 居中内容栏、64–128px 段落间距 | 营销落地页排版;本产品是满屏工作台(导航 72×900、侧栏 256×715,1440×900 下每像素都要用),无 hero 叙事。 |
| 圆角 16px 卡片 / 10px 输入框 | shadcn 用单一 --radius + 乘数(sm 0.6r / md 0.8r / lg r / xl 1.4r),按钮与输入框共用 rounded-lg = var(--radius),无法同时给按钮 6px 与输入框 10px。本方案取 --radius: 6px 优先对齐 Ramp 的「buttons/tags 6px」,卡片随之为 8.4px。 |
大面积 #1a1919 反相区块 |
参考自己写明 "Don't use #0c0a08 as a background fill for large sections",且企业工具不需要营销式反相 band。本方案把反相压缩到自己发的消息气泡这一小块。 |
#e4f222 作 --ring 焦点环 |
黄在纸面上对比度仅 1.30:1,作焦点环会「看不见」。本方案把浅色 --ring 改为墨黑 #0c0a08(对比度 17.7:1),是刻意的合规性偏离(见「shadcn 兼容性」)。 |
令牌映射
全部落在途径①:语义令牌取值。文件目标:
web/src/styles.css(@theme inline映射段不动,仅替换:root与.dark取值)。完整可粘贴版本见同目录tokens.css。
浅色 :root
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
#fcfcfc |
#f4f2f0 |
换 Ramp「Bone」暖白画布;近白改暖白,与白色卡片拉开层级(原画布=侧栏=1.00:1) |
--foreground |
#060607 |
#0c0a08 |
Ramp「Ink」近黑、微暖调,替换偏冷黑 |
--card |
#ffffff |
#ffffff |
Paper 纯白卡片,靠发丝边界而非阴影浮起 |
--card-foreground |
#060607 |
#0c0a08 |
随 Ink |
--popover |
#ffffff |
#ffffff |
弹层同为 Paper |
--popover-foreground |
#060607 |
#0c0a08 |
随 Ink |
--primary |
var(--brand) |
var(--brand) |
保持间接引用,主按钮=黄 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
黄底上必须是墨黑 |
--secondary |
#ebedef |
#ebe9e5 |
暖灰阶次级底,去蓝调 |
--secondary-foreground |
#060607 |
#0c0a08 |
随 Ink |
--muted |
#f2f3f5 |
#f0eeeb |
暖 wash;他人消息气泡、hover 底 |
--muted-foreground |
#5c5e66 |
#6d6c6b |
Ramp「Ash」;次级文本,实测 4.69:1 on --background |
--accent |
#ebedef |
#f0eeeb |
与 muted 同族的外部强调底 |
--accent-foreground |
#060607 |
#0c0a08 |
随 Ink |
--destructive |
#da373c |
#b42318 |
深一档的红,白底 6.57:1;只用于删除/风险 |
--border |
#dcdee1 |
#e5e7eb |
Ramp「Hairline」;结构边界统一色 |
--input |
#dcdee1 |
#8a8987 |
输入框边界需可辨(图形边界 ≥3:1),比 border 深一档,白底 3.49:1 |
--ring |
var(--brand) |
#0c0a08 |
焦点环改墨黑(黄在纸面 1.30:1 不可见),实测 17.7:1 |
--brand |
#2563eb |
#e4f222 |
唯一强调色:柠檬黄高亮笔 |
--brand-foreground |
#ffffff |
#0c0a08 |
黄底上的字,16.02:1(全系统最高对比对之一) |
--brand-soft |
rgb(37 99 235 / 0.12) |
rgb(228 242 34 / 0.18) |
高亮笔「划过」的痕迹,选中态底;白底合成 #fafdd7 |
--brand-ink |
#1d4ed8 |
#0c0a08 |
黄底/浅黄底上的文字色;黄色永不作文字色 |
--message-self |
#e8f3fe |
#1a1919 |
自己的消息=反相 Obsidian 实底(不靠彩色的「自己/他人」区分) |
--message-self-foreground |
#0d274a |
#f5f4f2 |
反相底上的纸白字,15.96:1 |
--surface-chat-soft |
#e8f2ff |
#f0eeeb |
引用/回复块底,去飞书浅蓝 |
--surface-chat-selected |
#e5ecfc |
rgb(228 242 34 / 0.20) |
会话列表选中=高亮笔画过;白底合成 #fafcd3,配墨黑 18.76:1 |
--mention |
#3370ff |
#63600a |
@提及=高亮黄的「墨色版」(同色相压暗),不引入新色相;白底 6.55:1 |
--ink |
#060607 |
#0c0a08 |
极值前景统一 |
--surface-rail |
#e1e8f2 |
#e6e2dc |
空间导轨改暖灰、比画布深半档(原 #e1e8f2 偏蓝且与画布通路不同) |
--sidebar |
#fcfcfc |
#ffffff |
侧栏改纯白卡片,修正「侧栏与画布零层级」 |
--sidebar-foreground |
#060607 |
#0c0a08 |
随 Ink |
--sidebar-accent |
#ebedef |
#f0eeeb |
侧栏 hover 底 |
--sidebar-accent-foreground |
#060607 |
#0c0a08 |
随 Ink |
--sidebar-border |
#dcdee1 |
#e5e7eb |
统一发丝色 |
--chart-1 |
oklch(0.87 0 0) |
#0c0a08 |
图表改 Ramp 式单色阶 |
--chart-2 |
oklch(0.556 0 0) |
#6d6c6b |
同上 |
--chart-3 |
oklch(0.439 0 0) |
#a3a29f |
同上 |
--chart-4 |
oklch(0.371 0 0) |
#cfcecb |
同上 |
--chart-5 |
oklch(0.269 0 0) |
#e5e7eb |
同上 |
--radius |
0.625rem |
0.375rem |
基准 10px→6px:按钮/输入框/标签收到 6px(Ramp buttons/tags 6px),整体更利落 |
连带但未列在必覆盖清单、仍真实存在的变量(同样给值):
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--sidebar-primary |
var(--brand) |
var(--brand) |
不变(自动跟黄) |
--sidebar-primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
不变 |
--sidebar-ring |
var(--ring) |
var(--ring) |
不变(自动跟墨黑) |
--interactive |
#4e5058 |
#4a4947 |
交互灰向暖灰收敛 |
--channel-icon |
#80848e |
#8a8987 |
频道 # 图标灰去蓝调 |
--workspace-rail-background |
transparent |
transparent |
不变 |
--workspace-header-background |
var(--background) |
var(--background) |
不变 |
--workspace-background |
linear-gradient(180deg, var(--surface-rail), #e1e5f1) |
linear-gradient(180deg, var(--surface-rail), #e3ded7) |
渐变第二停靠点随暖灰改值 |
深色 .dark
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--surface-rail |
#e3e5e8 |
#1a1919 |
修真 bug:原深色导轨仍是浅色,会成一条白竖带;改真深色 |
--background |
oklch(0.145 0 0) |
#121110 |
暖黑纸背,与浅色暖调同源 |
--foreground |
oklch(0.985 0 0) |
#f5f4f2 |
暖白挂面 |
--card |
oklch(0.205 0 0) |
#1c1b1a |
Obsidian 卡片面 |
--card-foreground |
oklch(0.985 0 0) |
#f5f4f2 |
随前景 |
--popover |
oklch(0.205 0 0) |
#1c1b1a |
弹层同卡面 |
--popover-foreground |
oklch(0.985 0 0) |
#f5f4f2 |
随前景 |
--secondary |
oklch(0.269 0 0) |
#262524 |
暖深次级底 |
--secondary-foreground |
oklch(0.985 0 0) |
#f5f4f2 |
随前景 |
--muted |
oklch(0.269 0 0) |
#232120 |
他人气泡/hover 底 |
--muted-foreground |
oklch(0.708 0 0) |
#a3a29f |
深底次级字,7.39:1 |
--accent |
oklch(0.269 0 0) |
#262524 |
强调底 |
--accent-foreground |
oklch(0.985 0 0) |
#f5f4f2 |
随前景 |
--destructive |
oklch(0.704 0.191 22.216) |
#ff6b5e |
深底红提亮,卡片上 6.16:1 |
--border |
oklch(1 0 0 / 10%) |
rgb(245 244 242 / 0.12) |
暖白发丝 12% |
--input |
oklch(1 0 0 / 15%) |
rgb(245 244 242 / 0.42) |
输入框边界需 ≥3:1,实测 3.82:1 on #121110 |
--brand |
oklch(0.68 0.15 256) |
#e4f222 |
深色下仍是同一支高亮黄 |
--brand-foreground |
oklch(0.16 0.02 258) |
#0c0a08 |
黄底墨黑字,16.02:1 |
--brand-soft |
oklch(0.28 0.05 256) |
rgb(228 242 34 / 0.16) |
选中态黄底,合成 #3c3d1b |
--brand-ink |
oklch(0.84 0.09 256) |
#e4f222 |
深底上黄底文字用黄本身,9.08:1 |
--message-self |
#203b59 |
#f2f1ee |
「自己=反相」规则在深色下反转为纸白实底 |
--message-self-foreground |
#e7f3ff |
#121110 |
纸白底上暖黑字,16.7:1 |
--surface-chat-soft |
oklch(0.32 0.06 250) |
#232120 |
引用块底去蓝 |
--surface-chat-selected |
oklch(0.28 0.04 250) |
rgb(228 242 34 / 0.14) |
选中=高亮笔,合成 #38391b,配前景 10.8:1 |
--mention |
oklch(0.72 0.14 254) |
#d9e34a |
深底 @提及=亮化高亮黄,13.51:1 |
--ink |
oklch(0.16 0.02 258) |
#f5f4f2 |
深底极值前景反相 |
--sidebar |
oklch(0.205 0 0) |
#1c1b1a |
侧栏=Obsidian 卡片 |
--sidebar-foreground |
oklch(0.985 0 0) |
#f5f4f2 |
随前景 |
--sidebar-accent |
oklch(0.269 0 0) |
#262524 |
侧栏 hover |
--sidebar-accent-foreground |
oklch(0.985 0 0) |
#f5f4f2 |
随前景 |
--sidebar-border |
oklch(1 0 0 / 10%) |
rgb(245 244 242 / 0.12) |
暖白发丝 |
--chart-1..5 |
0.87/0.556/0.439/0.371/0.269 灰阶 |
#f5f4f2 / #c9c8c5 / #8a8987 / #4a4947 / #2a2927 |
深色单色阶 |
--workspace-background |
radial-gradient(… brand 10%, muted …) |
radial-gradient(… brand 4%, muted …) |
黄只占 4%,避免深底泛绿的大面积光晕 |
--workspace-rail-background |
color-mix(in oklab, var(--background) 45%, transparent) |
不变 | 跟随新背景即可 |
--workspace-header-background |
linear-gradient(180deg, color-mix(… brand 3%), …) |
不变 | 跟随新背景即可 |
--radius |
(浅色继承) | 0.375rem |
深浅一致 |
.dark本身不重声明--radius;浅色:root的0.375rem直接继承——与原文同构。
字体与排版
字体栈(沿用原文,不动): "Geist Variable", "gg sans", "Noto Sans SC", "PingFang SC", ui-sans-serif, system-ui, "Segoe UI", "Microsoft YaHei", Roboto, Helvetica, Arial, sans-serif;等宽 --font-mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace。
中文注意点(实测支撑): Geist 无中文字形,body 实测栈 "Geist Variable","gg sans","Noto Sans SC","PingFang SC"… → 中文实际落到 Noto Sans SC / PingFang SC。拉丁与中文混排基线差异是已存在的客观事实(同一行 #通用讨论 里 # 走 Geist、汉字走 Noto)。因此:
- 正文用 15px/1.45(现为 15px/1.375=20.63px)——行高抬到 1.45 是为了让 15px 中文有 21.75px 行盒,中文方块字的视觉重量比拉丁大,1.375 的密排在高密度消息流里会「粘行」。
- 中文最小 12px(不降到 11px);11px 只允许给大写拉丁微标签。
- 数字/ID/计数一律
--font-mono,避免中文字体里的等宽数字与旁边汉字对不齐。
字号/行高/字重阶梯表(建议,覆盖当前实测 9–15px 的碎档位):
| 角色 | 字号 | 行高 | 字重 | 字距 | 用途 | 落地方式 |
|---|---|---|---|---|---|---|
| 标题 title | 16px | 1.3 | 600 | 0 | 频道头、卡片标题、看板标题 | 令牌(--foreground)+ 容器(text-base font-semibold 类由组件默认) |
| 正文 message | 15px | 1.45 | 400 | 0 | 消息正文统一档(修掉现有「他人 15px / 自己 14px」两套字号) | 布局:移除自己气泡的 text-sm 覆盖,回到 body 默认 15px |
| 次级 meta | 13px | 1.45 | 400 | 0 | 作者名、说明 | 组件默认 |
| 标签 label | 12px | 1.375 | 500–600 | 0 | 时间、计数、状态徽标 | 令牌 + 官方 Badge(text-xs) |
| 微标签 micro | 11px | 1.3 | 600 | 0.09em(仅大写拉丁) | IN PROGRESS、分组头 |
容器 uppercase tracking-wider |
| 数字/代码 | 13px | 1.4 | 400 | 0 | ID、计数、--font-mono |
容器 font-mono |
关键界面改造
每条标注实现途径:① 令牌取值 / ② 官方 variant·size / ③ 容器布局·尺寸·间距·滚动。
S1 应用外壳 + 空间/频道侧栏(components/app/app-shell.tsx、channel-sidebar.tsx)
| 现状(实测) | 改后 | 途径 |
|---|---|---|
aside 侧栏 256×715 background #fcfcfc = 画布 #fcfcfc,对比度 1.00:1,零层级 |
侧栏 --sidebar:#ffffff 浮在 --background:#f4f2f0 上(1.12:1 明度差 + 1px --sidebar-border:#e5e7eb) |
① |
空间 rail nav 背景 transparent,右边框 rgba(220,222,225,0.55) → 深浅两套下都"隐形";深色下 --surface-rail:#e3e5e8 成白竖带 |
rail 用 --surface-rail:#e6e2dc(浅)/ #1a1919(深),与画布 1.16:1 明度差,深浅都成一条实竖条;图标按钮 71×48 保持 |
①(+③ 保持原 72px 宽度与分隔线尺寸) |
搜索框 30px 圆角 10px 底 rgba(235,238,239,0.75) |
保持 30px 尺寸,圆角随 --radius 全局收敛到 6px;底色走 --muted |
①③ |
| 会话行 240×64,未读点、时间、预览 11.25px | 行高保持 64px(不降密度);预览字号由 11.25px 归到 12px 档(text-xs);选中行底走 --surface-chat-selected(高亮笔黄,非蓝) |
①③ |
| 顶部搜索 / 频道区 | 官方 Button variant="ghost" size="icon-sm"(28px)+ DropdownMenu(空间切换)+ ScrollArea(频道树滚动);未读计数用 Badge variant="default"(黄底墨黑) |
②③ |
S2 频道消息流(components/app/message-list.tsx、channel-thread.tsx、channel-header.tsx、channel-tabs.tsx)
| 现状(实测) | 改后 | 途径 |
|---|---|---|
他人气泡 rgb(235,237,239)(=--accent)、自己气泡 rgb(232,243,254);同列表两套字号:他人 15px、自己 14px |
他人气泡 --muted:#f0eeeb + 1px --border;自己气泡 --message-self:#1a1919(反相实底,15.96:1);两方正文统一 15px/1.45 |
①(自己气泡的 text-sm 覆盖移除属③布局类修正) |
头像/时间 12px #5c5e66 |
12px --muted-foreground:#6d6c6b(4.69:1) |
① |
输入区 textarea 628×33 无边框,外层仅上边框 |
输入卡改为 1px --border 全包 + --card 底(视觉"输入卡片"),尺寸不变 |
①③ |
工具按钮 28×28(Aa 等) |
官方 Button variant="ghost" size="icon-sm"(28px,与现状像素同值);@ 提及走 --mention 色 |
②① |
| 悬停动作:点赞/回复/更多/已读态 | ButtonGroup + Button variant="ghost" size="icon-xs";已读态 Badge variant="ghost"("0 人已读 · 4 人未读") |
② |
| 频道头 860×52、标题 16px/600、成员数 12px | 尺寸不变;标题 --foreground、成员数 --muted-foreground;Tabs(消息/任务/文件)variant 默认,选中 tab 底走 --card 浮于 --muted 轨道上 |
①③ |
S3 任务大厅 + 任务卡(components/app/task-hall.tsx、group-hall.tsx、channel-work-items.tsx)
| 现状(实测) | 改后 | 途径 |
|---|---|---|
卡片圆角两套混用:10px×48 / 8px×37(来源:--radius 与 min(--radius-md,10px) 并存) |
统一随 --radius:6px → 卡片 8.4px、徽标 6px 档;不再出现 10/8 混排 |
① |
营销式 hero 段落(group-hall)+ 品牌蓝 rgb(37,99,235) 出现 20 处 |
hero 段落删除,改为 16px 标题 + 12px --muted-foreground 说明(编辑部分组头);蓝→黄取代,蓝不再出现 |
③① |
| 筛选「全部频道 / 5 项任务」 | Badge variant="secondary" + Badge variant="ghost",保持 6px 档圆角 |
② |
卡片:标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人 |
保持内容;标题 14px/500→15px/500(与正文同档,README 级别更稳);频道 chip Badge variant="outline"、AI 助手 chip Badge variant="ghost";主操作 Button variant="default" size="sm"(黄),仅每卡一个黄按钮 |
②③ |
状态流转 6 态(待补充/待处理/进行中/待验收/已完成/已关闭) |
状态色纪律:进行中=Badge variant="default"(黄);待处理=outline;待验收=outline + --mention 描边/字;已完成=secondary;已关闭=ghost;逾期=destructive(唯一红)。黄只表示"正在发生",不用于已完成 |
②① |
| 看板列头「待补充 0 / 待处理 5」 | 列头 11px 大写微标签 + 15px/600 计数(--font-mono 数字) |
③ |
S7 登录页(routes/login.tsx、sign-in.$.tsx)
| 现状(实测) | 改后 | 途径 |
|---|---|---|
| 居中卡片,主标题 26px;页脚 11px | 标题收到 24px/600(编辑部分组头尺度,与全站阶梯对齐);页脚保持 11px;卡片圆角随 --radius 收敛 |
①③ |
「邮箱验证码/短信验证码」切换块 173×42,选中态底 --background #fcfcfc + 品牌蓝文字 |
官方 Tabs;选中 tab 底=--card + --foreground 字,轨道底=--muted;黄只在主按钮出现,不用于 tab 选中(避免两个黄块打架) |
②① |
主按钮 356×52 白字 #2563eb |
Button variant="default" size="lg"(36px 高);黄底 + 墨黑字(16.02:1)。宽度由容器 w-full max-w-[356px] 保持 |
②①③ |
| 文案「登录 WanChat / 使用企业邮箱验证码继续 / 企业邮箱 @example.com / 获取验证码」 | 文案不变(真实语料) | — |
S5 管理与设置弹窗(components/app/space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx)
| 现状(实测) | 改后 | 途径 |
|---|---|---|
[role=dialog] 704×512、圆角 18px、底 #ffffff |
尺寸保持 704×512;圆角随 --radius 收敛到 8.4px(rounded-xl) |
①③ |
左侧导航项 135×36 圆角 8px,选中态底 --brand-soft+前景 --brand-ink(蓝) |
同为 --brand-soft(黄 18%)+ --brand-ink(浅色墨黑 / 深色黄);选中态即"高亮笔划过的目录项" |
① |
危险项前景 --destructive #da373c |
#b42318(浅)/#ff6b5e(深) |
① |
| 输入框 488×32 圆角 10px;表单标签 14px | 尺寸保留(宽由容器 w-full、高 32px);圆角 6px;标签 14px/500 走 --foreground;校验错误走 --destructive |
①③ |
| 组件 | 官方 Dialog(DialogSurface 已用 ring-1 ring-foreground/10 发丝边——与 Ramp「边界代替阴影」天然同构)/ Input / Checkbox / FieldSelect / ScrollArea |
② |
S4 AI 助手频道(components/app/agent-chat-panel.tsx、agent-channel.tsx、channel-summary-panel.tsx)
| 现状(实测) | 改后 | 途径 |
|---|---|---|
AI 助手空间 395 项任务:单视图字号 12.8/500 ×2765、12/500 ×2381、12/400 ×1994、14/400 ×1724;圆角 8px ×1591、10px ×844 |
字号收敛到 12px(标签)/13px(次级)/15px(正文) 三档;圆角统一 6/8.4px 两档 | ①③ |
| 流式回答、来源引用、结果卡片 | 来源引用走 --surface-chat-soft + 2px --brand 左边框(引用条);"正在生成"的呼吸点 --animate-breathe 用 --brand(这是"正在发生",黄合法);结果卡片走 Card + Badge |
①③ |
| 组件 | 已用 InputGroup / ScrollRegion / DropdownMenu / Button;无需新组件 |
② |
S8 应用中心(components/app/app-center.tsx、assistant-board.tsx)
| 现状(实测) | 改后 | 途径 |
|---|---|---|
分类筛选(全部/Agent/人事行政/数据与报表/…)+「共 14 个应用」+ 卡片(运行中/开发中 徽标) |
分类筛选走 Tabs 或 Badge 组;运行中=Badge variant="default"(黄=在跑)、开发中=Badge variant="outline" |
②① |
| 应用/助手图标当前用 emoji,视觉一致性缺口 | 图标是内容不是样式,令牌层改不了;能在不碰 web/ 的前提下做的只有:Avatar/Card 容器统一为 --muted 底 + 1px --border,让 emoji 落在规整方格里(弱化五彩 emoji 与单色系统的冲突)。换 icon 需改代码,本方案不覆盖,列为已知缺口。 |
③(部分)⚠️ 缺口 |
深浅色与对比度
比值由 WCAG 相对亮度公式自算(
L = 0.2126R + 0.7152G + 0.0722B,sRGB 线性化,CR = (L₁+0.05)/(L₂+0.05))。图形边界阈值 3:1,正文阈值 4.5:1。
浅色(Paper)
| 组合 | 前景 hex | 背景 hex | 对比度 | 是否达标 |
|---|---|---|---|---|
| 正文 / 画布 | #0c0a08 |
#f4f2f0 |
17.70:1 | ✅ 正文 |
| 正文 / 卡片 | #0c0a08 |
#ffffff |
19.76:1 | ✅ 正文 |
| 次级文本 / 画布 | #6d6c6b |
#f4f2f0 |
4.69:1 | ✅ 正文 |
| 次级文本 / 卡片 | #6d6c6b |
#ffffff |
5.24:1 | ✅ 正文 |
| 主按钮字 / 主按钮底 | #0c0a08 |
#e4f222 |
16.02:1 | ✅ 正文 |
| 次级按钮字 / 次级底 | #0c0a08 |
#ebe9e5 |
16.30:1 | ✅ 正文 |
| brand-soft 上的字 / 浅黄底 | #0c0a08 |
#fafdd7(18% 黄 on 白) |
18.91:1 | ✅ 正文 |
| 选中会话字 / 选中底 | #0c0a08 |
#fafcd3(20% 黄 on 白) |
18.76:1 | ✅ 正文 |
| @提及 / 卡片 | #63600a |
#ffffff |
6.55:1 | ✅ 正文 |
| @提及 / 画布 | #63600a |
#f4f2f0 |
5.86:1 | ✅ 正文 |
| 破坏性文字 / 卡片 | #b42318 |
#ffffff |
6.57:1 | ✅ 正文 |
| 自己气泡字 / 自己气泡底 | #f5f4f2 |
#1a1919 |
15.96:1 | ✅ 正文 |
| 输入框边界 / 卡片 | #8a8987 |
#ffffff |
3.49:1 | ✅ 图形边界 |
| 输入框边界 / 画布 | #8a8987 |
#f4f2f0 |
3.13:1 | ✅ 图形边界 |
| 焦点环 / 卡片 | #0c0a08 |
#ffffff |
19.76:1 | ✅ 焦点可见 |
| 结构发丝 / 卡片 | #e5e7eb |
#ffffff |
1.24:1 | ⚠️ 非交互装饰线(WCAG 1.4.11 不适用);输入框等可交互边界已另用 --input 提到 3:1 以上 |
| 导轨 / 画布 | #e6e2dc |
#f4f2f0 |
1.16:1 | ⚠️ 表面层级(非文字/边界要求),比现状 1.00:1 已有可见分层 |
深色(Obsidian)
| 组合 | 前景 hex | 背景 hex | 对比度 | 是否达标 |
|---|---|---|---|---|
| 正文 / 画布 | #f5f4f2 |
#121110 |
17.16:1 | ✅ 正文 |
| 正文 / 卡片 | #f5f4f2 |
#1c1b1a |
15.65:1 | ✅ 正文 |
| 次级文本 / 画布 | #a3a29f |
#121110 |
7.39:1 | ✅ 正文 |
| 次级文本 / 卡片 | #a3a29f |
#1c1b1a |
6.74:1 | ✅ 正文 |
| 主按钮字 / 主按钮底 | #0c0a08 |
#e4f222 |
16.02:1 | ✅ 正文 |
| brand-soft 上的字 / 深黄底 | #e4f222 |
#3c3d1b(16% 黄 on #1c1b1a) |
9.08:1 | ✅ 正文 |
| 选中会话字 / 选中底 | #f5f4f2 |
#38391b(14% 黄 on #1c1b1a) |
10.80:1 | ✅ 正文 |
| @提及 / 画布 | #d9e34a |
#121110 |
13.51:1 | ✅ 正文 |
| 破坏性文字 / 卡片 | #ff6b5e |
#1c1b1a |
6.16:1 | ✅ 正文 |
| 自己气泡字 / 自己气泡底 | #121110 |
#f2f1ee |
16.70:1 | ✅ 正文 |
| 输入框边界(0.42)/ 画布 | 合成 #71706f |
#121110 |
3.82:1 | ✅ 图形边界 |
| 输入框边界 / 卡片 | 合成 #71706f |
#1c1b1a |
3.48:1 | ✅ 图形边界 |
| 焦点环 / 卡片 | #e4f222 |
#1c1b1a |
12.79:1 | ✅ 焦点可见 |
| 结构发丝(12%)/ 卡片 | 合成 #2d2c2b |
#1c1b1a |
1.23:1 | ⚠️ 装饰线(同浅色说明) |
结论:正文组合全部 ≥4.69:1,图形边界(输入框、焦点环)全部 ≥3.13:1,两套主题均达标。 未达 3:1 的两类(结构发丝、导轨表面色)都不是"用于辨识控件的唯一视觉手段",属 WCAG 1.4.11 豁免范围,且已显式标注。
shadcn 兼容性
结论:仅用官方组件与官方 variant/size 即可达成,无需新增自定义变体。 全部视觉差由途径①令牌产生,个别密度/尺寸由途径③容器产生。
- 已安装、本方案直接使用(
web/src/components/ui/,共 38 个官方组件):button(default/outline/secondary/ghost/destructive/link×xs/sm/default/lg/icon-xs/icon-sm/icon)、badge(default/secondary/outline/ghost/destructive)、input、tabs、avatar、separator、card、dialog、alert-dialog、dropdown-menu、checkbox、tooltip、scroll-area、scroll-region、collapsible、item、field-select、input-group、textarea、bubble、message、skeleton。 - 无需新装任何官方组件。 若后续要更贴合 Ramp 的"发丝边界块",可评估官方
scroll-surface(已存在),仍非必需。 - 组件默认值本身已与 Ramp 相关规则同构,不需强行覆盖:
card与dialog的根已用ring-1 ring-foreground/10(发丝边界);button的圆角是rounded-lg = var(--radius)(所以把--radius设成 6px 即得 6px 按钮,属于令牌途径,不是覆盖)。 - 两处刻意偏离,显式标注:
- ⚠️ 风险 · 焦点环不用品牌色:Ramp 与现状都把
--ring指向--brand;本方案浅色把--ring改为#0c0a08(深色保持黄)。理由:黄在纸面上 1.30:1,做焦点环不可见,违反可达性。这是对"品牌色即焦点色"惯例的刻意偏离,需在评审时确认接受。若评审要求焦点环必须为品牌色,则退化为:浅色--ring: #63600a(高亮黄的墨色版,与--mention同值,白底仍 6.55:1,且保持色相一致)。 - ⚠️ 风险 · 输入框边界比
--border深:Ramp 的发丝#e5e7eb直接用满(其 email input 边界为rgba(33,33,33,0.1))。本方案把--input独立提到 3:1 以上(浅#8a8987),使输入框比普通分隔线更显眼。这是为满足 §2 硬约束 6「图形边界 ≥3:1」而做的取舍,视觉上会比参考的输入框重。
- ⚠️ 风险 · 焦点环不用品牌色:Ramp 与现状都把
- 不可为的地方:组件内硬编码色(
message-list.tsx的#006ce7、chat-mention.ts的#3370FF、chrome.ts的#f06f66、头像 Tailwind 50/700 配对的 253 处原始调色板)在「不改web/」约束下无法通过令牌消除,只能等后续代码清理;本方案已把它们排除在设计语言之外,但当前渲染仍会出现这些蓝/彩色——列为已声明的残余风险。 - 圆角的单值限制(已声明的不合规项):
--radius单值使按钮与输入框共用rounded-lg,无法同时满足 Ramp「button 6px / input 10px」。本方案取 6px。这不是"自定义样式",但与参考不完全一致,标注为取舍而非违规。
实施成本
改动面:
| 文件 | 改动 | 类型 |
|---|---|---|
web/src/styles.css |
:root(≈44 条声明)+ .dark(≈34 条声明)取值替换;--radius 一行 |
令牌(唯一必改文件) |
web/src/components/app/message-list.tsx |
移除自己气泡上的 text-sm 覆盖,使两方正文统一 15px |
容器/排版类 |
web/src/components/app/group-hall.tsx |
删除营销 hero 段落,改 16px 标题 + 12px 说明 | 容器布局 |
web/src/components/app/task-hall.tsx |
卡片标题 14px→15px;状态徽标 variant 映射 | 容器 + 官方 variant |
web/src/components/app/channel-sidebar.tsx |
预览字号 11.25px→12px(text-xs);未读徽标 Badge variant="default" |
容器 + 官方 variant |
web/src/components/app/app-center.tsx |
状态徽标 variant 映射;卡片容器统一 --muted 底 |
官方 variant + 容器 |
web/src/routes/login.tsx |
标题 26px→24px;切换块改官方 Tabs |
容器 + 官方组件 |
预估人时(不含评审):
- 令牌替换 + 自查:2 h
- 上述 6 个组件的途径②③微调:4 h
- 深浅两套走查 + 对比度复算:2 h
- 合计 ≈ 1 人日(8 h)
风险清单:
| 风险 | 级别 | 说明 |
|---|---|---|
| 组件内硬编码色残留 | 高 | 253 处 Tailwind 调色板 + 三种蓝,改 web/ 前不会被令牌收编(本方案不覆盖) |
| 深色主题在生产不可达 | 高 | 全仓无代码添加 .dark,<html> class 恒空;深色令牌再完美,用户也看不到(本方案不覆盖,需产品决策) |
| emoji 应用图标 | 中 | S8 图标为 emoji,与单色系统冲突,换 icon 需改代码 |
| 圆角单值限制 | 低 | 按钮/输入框无法按参考分别取值 |
| 浅色输入框边界偏重 | 低 | #8a8987 比参考的发丝重,属可达性取舍 |
| 导航路径 | 低 | 导航需 --radius 生效链路完整;.dark 需要在 <html> 上(当前不可达,见上) |
验证方式(能证明改动生效的检查):
- 在浏览器 DevTools 里对
.dark令牌块取值,确认--background返回#121110(浅色#f4f2f0)。 getComputedStyle(document.querySelector('aside'))的backgroundColor应为rgb(255,255,255),与body的rgb(244,242,240)不再相同。- 主按钮
getComputedStyle的backgroundColor应为rgb(228,242,34)(=#e4f222)。 - 输入框
borderColor为rgb(138,137,151)(浅)/ 合成后约rgb(113,112,111)(深)。 - 复算上表任一行:
#0c0a08on#e4f222= 16.02:1(常数,可离线核对)。 - 不再出现
rgb(37,99,235)作为按钮底色(品牌蓝被替换;硬编码蓝需另行清理才能彻底消失)。
取舍
解决了什么:
- 外壳层级:侧栏 vs 画布从 1.00:1 零对比 变成「纯白卡片浮在暖白画布上 + 1px 发丝边界」;导轨从透明/浅色变为实色条,深色下不再是"白竖带"。
- 色彩噪声:单一强调色
#e4f222把"有事发生"的信号统一(未读、进行中、当前频道、主操作);图表改单色阶;破坏色收窄到唯一红。 - 对比度合规:正文 4.69–19.76:1,图形边界 3.13–19.76:1,深浅两套全达标(原
--muted-foreground#5c5e66在画布上仅约 5.6:1 尚可,但新值在暖白上更稳)。 - 字号/圆角收敛:把实测 9/9.375/11/11.25/12/12.8/13.125/14/15/26px 的碎档位归到 11/12/13/15/16 五档;圆角从 2/6/7/8/10/12/14/18/24/26/32/9999px 归到 6/8.4/14/9999 四档。
牺牲了什么:
- 视觉冲击力:单色 + 一支黄在浅色下比原来的品牌蓝更"安静",第一屏的"色彩识别度"下降——这是刻意的(企业工具要耐看,不要抢眼)。
- 目录选中态的可读性带宽:黄底墨黑字对比极高,但黄在色相上"跳",长时段驻留时比灰蓝选中态更抢眼;若用户反馈"太吵",可把
--brand-soft的 alpha 从 0.18 降到 0.12(唯一调参点)。 - 输入框比参考重:为 3:1 图形边界,输入框边界比 Ramp 的
<10%透明边界明显更实。 - 圆角无法分档:丢掉 Ramp「button 6 / input 10」的区分度。
什么场景下不适用:
- 需要强品牌识别的对外页面(登录页已涉及):
#e4f222与 wanman 现有品牌蓝无继承关系,若品牌规范锁定蓝色,本方案需把--brand回退为品牌蓝,整套"高亮笔"隐喻随之失效。 - 需要多色相数据可视化的报表/BI 视图:单色阶梯在 >5 个分类的图表里可辨性差,该场景应保留独立图表色板(本方案的
--chart-*只是默认态)。 - 追求"活泼/年轻化"的产品调性:近单色编辑部气质偏冷静理性,与游戏化、消费级社区氛围相悖。
- 必须纯深色优先的情境(如长时间夜间值守大屏):本方案是浅色优先,深色虽完整但未做深色专属的对比微调(如更低的黄饱和度)。