黑白高亮台

方案名与主张

中文方案名:黑白高亮台(slug: ramp)

一句话主张: 把整站压成「暖白纸面 + 墨黑文字 + 发丝边界」的近单色编辑部版面,只留下一支柠檬黄高亮笔 #e4f222——只在动作(主按钮、接单)与正在发生(未读、进行中、当前频道、@提及)出现;纸面上其余一切由字号、字重、明暗层级和 1px 边界承担。

适用基调:浅色优先(企业工具白天长时段驻留为主),深色为等价完整的第二主题——本方案两套令牌一一对应、逐项给值,深色不是附属品。

主色: --brand: #e4f222(柠檬黄),配墨黑字 #0c0a08。


参考提炼

  1. 单一强调色纪律 —— "Use #e4f222 only for primary action fills, live counters, and active states — never as a background wash or decorative accent."(唯一色相只作动作信号)
  2. 发丝边界取代阴影 —— "Express card elevation with 1px #e5e7eb borders on #ffffff fills — avoid box-shadow."(升维靠 1px 边界,不靠投影)
  3. 近单色画布分层 —— Surfaces:Canvas #f4f2f0 → Card #ffffff → Wash #f4f2f0 → Inverted #1a1919(用明度而非色相分层)
  4. 排版承担层级 —— 字号/字距/大写微标签(10px,letter-spacing 0.018em)造层级;但这套系统用单一字重 400 造层级,这一点在本产品不可迁移(见「适配判断」)。
  5. 圆角系统收敛 —— "buttons/tags 6px, inputs 10px, cards 12/16px",明确拒绝 pill 与 4px。
  6. 表格页留白纪律 —— Page max-width 1200px、Element gap 8px、Card padding 20–24px。

适配判断

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

明确舍弃项:

舍弃 原因
单一字重 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)。因此:

字号/行高/字重阶梯表(建议,覆盖当前实测 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/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 容器 + 官方组件

预估人时(不含评审):

风险清单:

风险 级别 说明
组件内硬编码色残留 高 253 处 Tailwind 调色板 + 三种蓝,改 web/ 前不会被令牌收编(本方案不覆盖)
深色主题在生产不可达 高 全仓无代码添加 .dark,<html> class 恒空;深色令牌再完美,用户也看不到(本方案不覆盖,需产品决策)
emoji 应用图标 中 S8 图标为 emoji,与单色系统冲突,换 icon 需改代码
圆角单值限制 低 按钮/输入框无法按参考分别取值
浅色输入框边界偏重 低 #8a8987 比参考的发丝重,属可达性取舍
导航路径 低 导航需 --radius 生效链路完整;.dark 需要在 <html> 上(当前不可达,见上)

验证方式(能证明改动生效的检查):

  1. 在浏览器 DevTools 里对 .dark 令牌块取值,确认 --background 返回 #121110(浅色 #f4f2f0)。
  2. getComputedStyle(document.querySelector('aside')) 的 backgroundColor 应为 rgb(255,255,255),与 body 的 rgb(244,242,240) 不再相同。
  3. 主按钮 getComputedStyle 的 backgroundColor 应为 rgb(228,242,34)(= #e4f222)。
  4. 输入框 borderColor 为 rgb(138,137,151)(浅)/ 合成后约 rgb(113,112,111)(深)。
  5. 复算上表任一行:#0c0a08 on #e4f222 = 16.02:1(常数,可离线核对)。
  6. 不再出现 rgb(37,99,235) 作为按钮底色(品牌蓝被替换;硬编码蓝需另行清理才能彻底消失)。

取舍

解决了什么:

牺牲了什么:

什么场景下不适用: