白纸终端 — Vercel 语言在 WanChat 的落地

方案名与主张

方案名:白纸终端(参考 Vercel · "Typeset terminal on white paper")

一句话主张: 用「纸白画布 + 发丝描边 + 单色值阶」取代飞书式「蓝灰画布 + 四步投影 + 三套蓝」,让消息流与任务流只靠黑白对比与排版层级阅读,全站彩色收敛为 1 个代表「成功」的绿。

适用基调:浅色优先,深色对等。 浅色是主场景(#fafafa 纸白画布);深色不是把浅色翻过来,而是同一套明度阶梯的反相(#0a0a0a 画布 / #171717 卡片 / #ededed 亮面标点)。两套令牌都完整给值、两套都过正文 4.5:1。


参考提炼

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

  1. 「0% colorfulness is the rule」 — 除 Terminal Green #297a3a 成功指示外不引入任何彩色;正文只用 #171717 / #4d4d4d / #666666 三级值阶。→ 直接迁移为我们的 --foreground / --interactive / --muted-foreground。
  2. 「Build depth with hairline borders via stacked box-shadows(0 0 0 1px rgba(0,0,0,.08), 0 0 0 2px #fafafa)— never with drop-shadow」 — 深度靠描边环,不靠投影。→ 迁移为 --shadow-e1..e3 / --shadow-pop 重定义(见令牌映射)。
  3. 「Apply 6px radius to all cards, buttons, and bordered containers — use 9999px only for pill-shaped nav actions」 — 矩形一律 6px,锐利是重点。→ 迁移为 --radius: 0.375rem。
  4. 「Surfaces stack as #fafafa → #ebebeb → #171717,creating depth through tonal value shifts」 — 三层表面明度阶梯,#171717 是反相表面(Inverted Card),用在留白网格里做视觉标点。→ 迁移为画布 #fafafa / 侧栏 #f4f4f4 / 发丝 #ebebeb / 反相气泡 #171717。
  5. 「Labels and metadata are ALWAYS monospace, ALWAYS uppercase, ALWAYS small」+「Type Scale … heading 30px weight 400-450,-0.06em tracking」 — 二元排版纪律:Sans 负责阅读、Mono 负责盖章;标题走 400–450 字重而非 700。→ 中文字体栈有回退约束,"mono 盖章"只作用于原本已用 --font-mono 的数字/ID/时间位;标题字重 400–450 见 §字体与排版。

必须舍弃的(营销页专属): Spectrum Gradient / Solar Edge 装饰渐变(linear-gradient(90deg, rgb(0,255,149) …)、rgb(255,220,48)→rgb(56,162,255));▲ 三角品牌位;56/64px display 与 -0.06em 紧字距的 hero;96–128px 章节间距;1280px 居中容器;64px 吸顶导航 + backdrop-blur;CLI 输出面板与 logo strip。


适配判断

为什么这套语言适合「消息 + 任务」双核心的高密度企业工具:

明确舍弃项(因产品形态不同):

舍弃 原因
全站 0 彩色 任务状态与危险操作必须有色相;保留 Terminal Green(成功/已完成)+ --destructive 红(风险/过期),共 2 个色相
96–128px 章节间距、大留白 企业工具是长时段驻留的高密度界面,留白预算给列表行高与信息密度
14–16px 正文 / 1.43–1.5 行高 中文正文保持 15px / 1.375(20.63px,≥ 简报要求的 1.375);行高再加会掉一屏消息条数
uppercase 小标签 中文无大小写;"盖章"改为等宽数字 + 字距,落在既有 --font-mono 使用位上

令牌映射

途径列:①=语义令牌取值(web/src/styles.css);②=官方 variant/size;③=容器布局/间距/滚动。本表全部为 ①。当前值取自 web/src/styles.css:108-161(:root)与 :163-211(.dark)。

浅色 :root(web/src/styles.css:108)

变量名 当前值 建议值 途径 意图
--background #fcfcfc #fafafa ① 取 Vercel Paper White;把画布与卡片 #ffffff 的差固定为 1 档明度,作为整个阶梯基准
--foreground #060607 #171717 ① 近纯黑改 Obsidian(对 #fafafa 17.18:1),避开纯黑在纸白上的边缘生硬
--card #ffffff #ffffff ① 不变:白卡片是画布之上唯一抬升层
--card-foreground #060607 #171717 ① 跟随正文
--popover #ffffff #ffffff ① 不变
--popover-foreground #060607 #171717 ① 跟随正文
--primary var(--brand) var(--brand) ① 间接层保持;取值由蓝变黑(见 --brand)
--primary-foreground var(--brand-foreground) var(--brand-foreground) ① 间接层保持(白字 17.93:1)
--secondary #ebedef #f2f2f2 ① 去蓝偏,次级表面改中性灰
--secondary-foreground #060607 #171717 ① 跟随正文
--muted #f2f3f5 #f0f0f0 ① 弱化表面降一档,与侧栏 #f4f4f4 拉开微差
--muted-foreground #5c5e66 #666666 ① 次级文字取 Vercel Stone(5.50:1),灰阶从 5 档收敛到 3 档
--accent #ebedef #ebebeb ① 他人气泡=accent,取 Vercel Hairline 灰(16.01:1)
--accent-foreground #060607 #171717 ① 跟随正文
--destructive #da373c #d92d20 ① 白底 4.83:1(原值 4.57:1 贴线);兼"风险/过期"状态色
--border #dcdee1 #ebebeb ① 结构分隔改发丝线(1.14:1)——刻意"高速态不可见",见风险 R1
--input #dcdee1 #8f8f8f ① 与 --border 分离:控件周界必须 3:1(实测 3.23:1,满足 WCAG 1.4.11)
--ring var(--brand) var(--brand) ① 间接层保持;焦点环=Obsidian
--brand #2563eb #171717 ① 方案核心:主按钮由品牌蓝变 Vercel Filled Black Button;primary/ring/sidebar-primary 随之变黑
--brand-foreground #ffffff #ffffff ① 不变(黑底白字)
--brand-soft rgb(37 99 235 / 0.12) rgb(23 23 23 / 0.08) ① 弹窗侧栏选中底:蓝 12%→黑 8%,选中变单色
--brand-ink #1d4ed8 #171717 ① 选中项前景去净蓝,与 --brand 同值
--message-self #e8f3fe #171717 ① 自己气泡改反相表面(Vercel Inverted Card),成为整列唯一重色标点(17.18:1)
--message-self-foreground #0d274a #fafafa ① 反相气泡上的字取画布色
--surface-chat-soft #e8f2ff #f4f4f4 ① 引用/回复气泡去蓝,回中性灰族
--surface-chat-selected #e5ecfc #e4e4e4 ① 会话选中底改明度下沉一档的灰(缺口见 R3)
--mention #3370ff #297a3a ① @提及改 Terminal Green(5.11:1),成为高密度视图唯一彩色锚点
--ink #060607 #171717 ① 通用深前景统一 Obsidian
--surface-rail #e1e8f2 #ebebeb ① 空间 rail 去蓝(实测 rail 右边框 rgba(220,222,225,0.55) 随之靠拢 --border)
--sidebar #fcfcfc #f4f4f4 ① 关键修复:侧栏与画布原同为 #fcfcfc(实测 256×715 @x=76 零层级对比),下沉一档
--sidebar-foreground #060607 #171717 ① 跟随正文
--sidebar-accent #ebedef #eaeaea ① 悬停底去蓝,与选中 #e4e4e4 拉开微差
--sidebar-accent-foreground #060607 #171717 ① 跟随正文
--sidebar-border #dcdee1 #e4e4e4 ① 侧栏分隔改发丝灰,比页面 --border 稍清晰
--chart-1 oklch(0.87 0 0) #ebebeb ① 状态色阶起点:最浅发丝灰
--chart-2 oklch(0.556 0 0) #a8a8a8 ① 中性档(已关闭/无效)
--chart-3 oklch(0.439 0 0) #666666 ① 待处理档(5.50:1,可承载文字)
--chart-4 oklch(0.371 0 0) #297a3a ① 唯一彩色:已完成/成功
--chart-5 oklch(0.269 0 0) #171717 ① 进行中档:最需注意的中性档
--radius 0.625rem 0.375rem ① 10px→6px;派生 --radius-sm..4xl 比例不变
--workspace-background linear-gradient(180deg, var(--surface-rail), #e1e5f1) linear-gradient(180deg, #fafafa, #f4f4f4) ① 画布渐变由蓝灰改纯明度
--interactive #4e5058 #4d4d4d ① 交互图标对齐 Vercel Charcoal,去蓝偏
--channel-icon #80848e #6e6e6e ① 频道图标加深:侧栏底上 4.64:1,图形对比达标

深色 .dark(web/src/styles.css:163)

变量名 当前值 建议值 途径 意图
--background oklch(0.145 0 0) #0a0a0a ① Vercel 暗色画布;原值偏灰
--foreground oklch(0.985 0 0) #ededed ① 用 #ededed 而非纯白,避免深底发光(16.91:1)
--card oklch(0.205 0 0) #171717 ① 卡片抬升一档,靠描边识别而非明度(1.10:1)
--card-foreground oklch(0.985 0 0) #ededed ① 跟随正文
--popover oklch(0.205 0 0) #171717 ① 与卡片同值
--popover-foreground oklch(0.985 0 0) #ededed ① 跟随正文
--primary 继承 var(--brand) var(--brand)(显式声明) ① 原文 .dark 未声明;显式化后取反相亮面
--primary-foreground 继承 var(--brand-foreground) var(--brand-foreground)(显式声明) ① 原文 .dark 未声明;显式化使深色两套自洽
--secondary oklch(0.269 0 0) #1f1f1f ① 次级表面收暗,给卡片留层次
--secondary-foreground oklch(0.985 0 0) #ededed ① 跟随正文
--muted oklch(0.269 0 0) #1f1f1f ① 与 --accent #262626 区分
--muted-foreground oklch(0.708 0 0) #a1a1a1 ① 画布 7.66:1 / 卡片 6.94:1
--accent oklch(0.269 0 0) #262626 ① 他人气泡比 --muted 亮一档
--accent-foreground oklch(0.985 0 0) #ededed ① 跟随正文
--destructive oklch(0.704 0.191 22.216) #ff6369 ① 卡片上 6.18:1;与浅色 #d92d20 同红相不同亮度
--border oklch(1 0 0 / 10%) rgb(255 255 255 / 0.14) ① 深底略提 alpha,维持发丝感(1.38:1,见 R1)
--input oklch(1 0 0 / 15%) rgb(255 255 255 / 0.45) ① 合成 #707070,卡片上 3.62:1,满足 1.4.11
--ring 继承 var(--brand) var(--brand) ① 焦点环取亮面
--brand oklch(0.68 0.15 256) #ededed ① 深色主按钮=亮面填充(Vercel 暗色反相按钮),16.91:1
--brand-foreground oklch(0.16 0.02 258) #0a0a0a ① 亮底深字
--brand-soft oklch(0.28 0.05 256) rgb(237 237 237 / 0.10) ① 选中底改亮面 10%,与浅色同构
--brand-ink oklch(0.84 0.09 256) #ededed ① 选中项前景=亮面
--message-self #203b59 #ededed ① 反相规则在深色下反向:自己气泡是亮面,保持"唯一强对比标点"语义
--message-self-foreground #e7f3ff #0a0a0a ① 亮气泡上的深字(16.91:1)
--surface-chat-soft oklch(0.32 0.06 250) #1f1f1f ① 引用气泡去蓝
--surface-chat-selected oklch(0.28 0.04 250) #262626 ① 选中底比侧栏亮一档(1.31:1,见 R3)
--mention oklch(0.72 0.14 254) #46a758 ① 深底 Terminal Green 提亮版,画布 6.53:1
--ink oklch(0.16 0.02 258) #ededed ① 通用深前景反相
--surface-rail #e3e5e8 #171717 ① 关键修复:原深色下仍是浅色(深底上的浅色竖带)
--sidebar oklch(0.205 0 0) #0a0a0a ① 与画布同值,改用发丝边框分隔
--sidebar-foreground oklch(0.985 0 0) #ededed ① 跟随正文
--sidebar-accent oklch(0.269 0 0) #1f1f1f ① 悬停底比侧栏亮一档
--sidebar-accent-foreground oklch(0.985 0 0) #ededed ① 跟随正文
--sidebar-border oklch(1 0 0 / 10%) rgb(255 255 255 / 0.14) ① 与 --border 同值
--chart-1 oklch(0.87 0 0) #2e2e2e ① 色阶起点:比卡片略亮
--chart-2 oklch(0.556 0 0) #6e6e6e ① 中性档
--chart-3 oklch(0.439 0 0) #a1a1a1 ① 次级档
--chart-4 oklch(0.371 0 0) #46a758 ① 唯一彩色:已完成/成功
--chart-5 oklch(0.269 0 0) #ededed ① 最亮档:进行中
--radius .dark 未声明,继承 :root 0.375rem(显式声明,与浅色同值) ① 原文只在 :root;显式化便于深色两套对照
--workspace-background radial-gradient(ellipse at 8% 0%, color-mix(in oklab, var(--brand) 10%, var(--muted)), var(--muted) 64%) linear-gradient(180deg, #0a0a0a, #121212) ① 去掉品牌蓝径向光斑
--workspace-rail-background color-mix(in oklab, var(--background) 45%, transparent) rgb(255 255 255 / 0.03) ① rail 用极淡亮面,语义直白
--workspace-header-background linear-gradient(180deg, color-mix(in oklab, var(--background), var(--brand) 3%), var(--background)) var(--background) ① 去掉品牌蓝 3% 混色
--interactive .dark 未声明(继承浅色 #4e5058) #a1a1a1 ① 补齐缺失声明,否则深底不可辨
--channel-icon .dark 未声明(继承浅色 #80848e) #8f8f8f ① 补齐缺失声明;画布 6.12:1

@theme inline(web/src/styles.css:31)内的阴影阶梯

变量名 当前值 建议值 意图
--shadow-e1 0 1px 0 rgb(4 4 5 / 0.08), 0 1.5px 0 rgb(4 4 5 / 0.02) 0 0 0 1px var(--border) Vercel「深度用描边环,不用投影」;引用 --border 后深浅两套自动成立
--shadow-e2 0 2px 4px -1px rgb(15 23 42 / 0.07), 0 6px 16px -4px rgb(15 23 42 / 0.1) 0 0 0 1px var(--border), 0 1px 1px rgb(0 0 0 / 0.03) 同上;保留极轻 1px 位移给弹层
--shadow-e3 0 10px 28px -8px rgb(15 23 42 / 0.16), 0 2px 6px -2px rgb(15 23 42 / 0.06) 0 0 0 1px var(--border), 0 1px 3px rgb(0 0 0 / 0.05) 同上
--shadow-pop 0 16px 40px -12px rgb(15 23 42 / 0.24), 0 4px 10px -4px rgb(15 23 42 / 0.1) 0 0 0 1px var(--border), 0 4px 12px rgb(0 0 0 / 0.08) 弹窗"高度"改由描边 + 极轻位移表达,去掉蓝味阴影

字体与排版

字体栈(web/src/styles.css:33 --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

字号阶梯(目标值;实施途径见末列)

角色 字号 行高 字重 颜色 实现途径
正文(消息/任务描述) 15px 1.375(20.63px,现状已达标) 400 --foreground #171717 —(styles.css:255 @layer base 已是 15px/1.375,不改)
次级(作者、频道名、表单标签) 13px 1.5(19.5px) 400 --foreground 或 --muted-foreground ②/③(组件类控制,见风险 R4)
标签/元信息(时间、成员数、状态徽标) 12px 1.5(18px) 500 --muted-foreground #666666 ②
微标签(页脚、角标) 11px 1.5 500 --muted-foreground ②——不再低于 11px:现状实测存在 9px / 9.375px 档位(S3-task-hall.json 中 9.375px/400 ×14、S7-login.json ×15),低于简报"中文最小 12px"的下限,属需收敛项
代码/数字 12px 1.4 400 --foreground —(--font-mono + tabular-nums)
页面标题 16px 1.25(20px) 600 --foreground ②——现状频道头已是 16px/600,保持不变
登录主标题 26px 1.2 400–450 --foreground ②——现状 26px;按 Vercel 纪律把 600 降到 450

刻度收敛: 现状单视图出现过 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26px 十档(小数字号源自以 15px 为基准的 em 计算)。目标压到 11 / 12 / 13 / 15 / 16 / 26px 六档,去掉 12.8 与 13.125 两个由 em 计算产生的小数档。

中文长文本与数字的注意点


关键界面改造

覆盖 7 个样例面:S1、S2、S3、S7(必含)+ S4、S5、S8(附加)。

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

# 现状(实测) 改后 途径
1 会话侧栏 aside 256×715 @x=76,border-radius 14px,background #fcfcfc = 页面底色 --background,零层级对比 侧栏底 #f4f4f4(下沉一档),画布 #fafafa,卡片 #ffffff;侧栏与画布差 1.05:1 + 侧栏右侧发丝边 --sidebar-border #e4e4e4。三面靠明度阶梯分层 ①
2 空间 rail 背景 transparent,右边框 rgba(220,222,225,0.55)(与 --border #dcdee1 不同源),图标按钮 71×48 rail 背景由 --workspace-rail-background: transparent 改为在深色下 rgb(255 255 255 / 0.03);浅色下继续透明但 --surface-rail #ebebeb 去蓝(原 #e1e8f2)。图标按钮尺寸 71×48 改由 ③ 收敛为 48×48 方形 + 12px 间距,与 Button size="icon-lg"(36px)在同一视觉网格上 ①+③
3 侧栏 border-radius 14px、搜索框圆角 10px、会话行 240×64 圆角随 --radius: 0.375rem 落到 6px(rounded-lg);搜索框由 30px 高改 Input 的 h-8(32px,②) ①+②
4 侧栏头部 52px,搜索框背景 rgba(235,238,239,0.75) 头部沿用 52px(③,密度不降);搜索框底色随 --muted #f0f0f0,周界由 --input #8f8f8f 保证 3.23:1 可见 ①
5 未读点、时间、预览 11.25px 预览 11.25px → 12px(②,落在刻度上);未读用 Badge variant="default"(黑底白字)或 6px 实心圆点 ②
6 会话选中底 #e5ecfc + 浅蓝 选中底 #e4e4e4 + 文字 --foreground #171717(14.10:1);未选中文字 --muted-foreground #666666(5.22:1)——选中态同时改变文字对比度与背景明度,不依赖单一色相(见 R3) ①
7 频道图标色 #80848e --channel-icon #6e6e6e,侧栏底上 4.64:1;图标本身仍用 lucide(components.json iconLibrary: lucide) ①
8 层级:靠 --shadow-e1..e3 四步投影 弹层阴影改描边环(--shadow-e2 起于 0 0 0 1px var(--border));侧栏平板不再用投影 ①

组件与 variant: Button size="icon-sm"|"icon-lg" variant="ghost"(rail 与头部图标);Input(搜索);Badge variant="secondary"(未读计数);ScrollArea(频道树,ui/scroll-area.tsx);Separator(侧栏分组)。

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

# 现状(实测) 改后 途径
1 他人气泡 rgb(235,237,239)(=--accent #ebedef);自己气泡 rgb(232,243,254)(=--message-self #e8f3fe)+ 字 rgb(13,39,74)。两种蓝 他人气泡 = --accent #ebebeb + 字 #171717(16.01:1);自己气泡 = 反相表面 --message-self #171717 + 字 #fafafa(17.18:1)。消息流里只出现"浅灰 / 黑"两种气泡 ①
2 气泡圆角 14px 6px(随 --radius),与卡片/输入框同一圆角语言 ①
3 消息正文同一列表两套字号:他人 15px/400、自己 14px/400 统一 15px/400(②):正文尺寸由组件类决定,不在令牌可控范围,必须改组件属性——本方案列出,但标注为需改 web/ 的项(R4) ②
4 作者 13px/400;时间 12px/500 #5c5e66 作者 13px --foreground;时间 12px --muted-foreground #666666 + --font-mono(数字不跳动) ②
5 @提及蓝 --mention #3370ff(chat-mention.ts 里还硬编码 #3370FF) --mention #297a3a(对 #fafafa 5.11:1 / 对 --accent #ebebeb 4.76:1)。硬编码的 #3370FF 属令牌泄漏,需在 chat-mention.ts 改引用 --mention(R2) ①(+组件引用修正)
6 输入区 textarea 628×33 无边框,外层只有上边框 rgb(220,222,225);工具按钮 28×28 外层上边框随 --border #ebebeb;工具按钮改 Button size="icon-sm"(28px,② 官方尺寸);输入框本体加 --input 周界使可点击区域可见(①) ①+②
7 频道头 860×52:标题 16px/600 #060607;成员数 12px/500 #5c5e66 标题 16px 保持,色 --foreground #171717;成员数走 --font-mono + --muted-foreground #666666 ①+②
8 悬停动作:点赞 / 回复 / 更多 / 预览图片 / 阅读状态(0 人已读,4 人未读) 动作按钮统一 Button variant="ghost" size="icon-xs"(24px,与现状 28px 视觉重量一致);阅读状态用 --font-mono 数字 ②
9 消息行间距与滚动锚点 用 MessageScroller(ui/message-scroller.tsx)的既有容器;行间距保持现状(③ 只做容器级调整,不加内边距) ③

组件与 variant: Bubble/Message(ui/bubble.tsx、ui/message.tsx);Button variant="ghost" size="icon-xs";Avatar size="sm"(头像首字底色受 --muted 影响,见 R5);Separator(日期分隔);Tabs variant="line"(channel-tabs.tsx 的频道内分栏,官方 line 变体不带底色块)。

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

# 现状(实测) 改后 途径
1 任务卡圆角两套混用:10px×48 + 8px×37 统一 --radius=6px(Card 的 rounded-lg),圆角不再承担层级语义 ①
2 卡片标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人 卡片标题 14px/500 --foreground;两个 chip 改 Badge variant="outline"(发丝边 + --foreground)与 Badge variant="secondary"(灰底);查看任务 用 Button variant="ghost" size="sm" ②
3 列头「待补充 0 / 待处理 5」,任务看板标题 16px;筛选「全部频道 / 5 项任务」 列头计数走 --font-mono;状态列头色按状态映射(见下表);筛选区 Button variant="outline" size="sm" + Separator ②+③
4 群聊大厅用营销式 hero 段落 + 「全部群聊 / 全部 / 已加入 / 未加入」筛选 + 群卡片;品牌蓝 rgb(37,99,235) 出现 20 处 删掉 hero 段落(③ 容器调整:直接进筛选 + 列表);筛选改 Tabs variant="line"(②,官方 line 变体,无底色块);品牌蓝归零(① --brand #171717) ③+②+①
5 群卡片 emoji 图标、运行中/开发中 徽标 徽标改 Badge:运行中→variant="secondary"(灰底中性);开发中→variant="outline" ②
6 任务卡间距 卡片网格 grid-cols-2/3 + 12px gap(③),与参考的 element gap 12px 一致 ③

状态色映射(全站统一,来自 --chart-*):

业务状态(简报 §3.3 真实语料) 令牌 浅色 深色 载体
待补充 / 已关闭 / 无效 --chart-2 / --muted-foreground #a8a8a8 #6e6e6e Badge variant="secondary"
待处理 --chart-3 #666666 #a1a1a1 Badge variant="outline"
进行中 --chart-5 #171717 #ededed Badge variant="default"(实心,最强)
待验收 --muted-foreground + 发丝边 #666666 #a1a1a1 Badge variant="outline"
已完成 / 成功 --chart-4 #297a3a #46a758 Badge variant="outline" + 绿字(5.33:1 / 5.92:1)
风险 / 过期 --destructive #d92d20 #ff6369 Badge variant="destructive"(官方为 bg-destructive/10 text-destructive)

组件与 variant: Card/CardHeader/CardContent、Badge(default/secondary/outline/destructive)、Button(variant="default"/"outline"/"ghost",size="sm")、Dialog+Field(create-task-dialog.tsx 表单)、Tabs variant="line"、ScrollArea。

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

# 现状(实测) 改后 途径
1 居中卡片,主标题 26px;页脚 11px 主标题 26px 保持字号,字重降到 450(②,Vercel「headlines at weight 400-450, never 700」);页脚 11px 保持并走 --muted-foreground ②
2 「邮箱验证码 / 短信验证码」切换块 173×42,选中态背景 --background #fcfcfc + 品牌蓝文字 切换改 Tabs variant="default" 的官方实现:选中底 --card #ffffff + 文字 --foreground #171717,容器 --muted #f0f0f0——选中态由明度反转表达而非蓝色 ①+②
3 主按钮 356×52、白字、#2563eb Button variant="default" 落到 --brand #171717 黑底白字(17.93:1);尺寸走 size="lg"(h-9)——参考的 Filled Black Button 是同一语义 ①+②
4 卡片圆角 18px / 32px 并存 随 --radius 收敛到 6px(卡片)与 rounded-2xl(10.8px,外层容器);不再出现 32px ①
5 文案「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」 文案不动;输入框与按钮之间用 Field(ui/field.tsx)的既有间距,③ 只调整卡片内垂直节奏为 16px ③

组件与 variant: Card、Button size="lg" variant="default"、Input、Tabs、Field+FieldLabel、Separator。

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

# 现状(实测) 改后 途径
1 AI 助手空间(395 项任务)是全站最密集视图:一次渲染内 12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724;圆角 8px ×1591、10px ×844 去掉 12.8px 档(②,落到 12px);圆角全部由 --radius 决定 = 6px,两套圆角(8/10)归一 ①+②
2 流式回答 + 来源引用 来源引用改 Badge variant="outline" + --font-mono 编号(如 [1]);引用正文 --muted-foreground,正文 --foreground——层级只靠 2 档灰 ②
3 结果卡片 Card + CardContent;结果里 AI 等待态保留既有 --animate-breathe 三点(动效令牌不动) ②
4 与消息流混排 与 S2 同栈:AI 气泡=他人气泡(--accent #ebebeb),用户气泡=自己气泡(--message-self #171717 反相) ①
5 密集列表间距 ③:列表行间距由现状压到 8px,容器 overflow-y: auto 且 min-h-0(现状 2765 个文字节点说明容器未做虚拟化约束,方案只声明布局侧要求,不改数据层) ③

组件与 variant: Message/Bubble、Card、Badge variant="outline"、Button variant="ghost" size="sm"、ScrollArea、Skeleton(流式等待)、Collapsible(来源展开)。

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

# 现状(实测) 改后 途径
1 [role=dialog] 704×512,圆角 18px,背景 #ffffff 圆角随 --radius → 6px(rounded-lg);背景 --popover #ffffff 不变;--shadow-pop 改描边环后弹窗与页面边界立刻清晰 ①
2 左侧导航项 135×36 圆角 8px;选中态背景 --brand-soft(rgb(37 99 235 / 0.12))+ 前景 --brand-ink #1d4ed8;危险项前景 --destructive #da373c --brand-soft → rgb(23 23 23 / 0.08),--brand-ink → #171717:选中项变成"浅灰底黑字",不再与危险项的红形成两个色相争夺;危险项 #d92d20(4.83:1) ①
3 输入框 488×32 圆角 10px;表单标签 14px 输入框圆角随 --radius → 6px,周界 --input #8f8f8f(3.23:1);标签 14px → 13px(②) ①+②
4 表单/成员列表/权限三种内容形态 容器用 Dialog 既有左右分栏(③);成员列表用 Avatar size="sm" + Item(ui/item.tsx)+ Separator;权限用 Checkbox(ui/checkbox.tsx)+ Badge variant="outline" 表示角色(群主 / 管理员 / 研发 / 产品 / pmo) ③+②
5 圆角档位实测 80×9999px、52×10px、32×26px、23×8px 6px 统一后,剩下的 9999px 只允许出现在 Badge(rounded-4xl)与 Avatar(rounded-full)——这两处是官方组件自带的胶囊语义 ①

组件与 variant: Dialog/DialogContent、Tabs variant="line"(弹窗左侧导航可用垂直 Tabs 官方实现)、Input、Checkbox、Select、Avatar size="sm"、Badge variant="outline"|"secondary"、Item、Separator。

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

# 现状(实测) 改后 途径
1 分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」 筛选条改 Tabs variant="line"(无底色块,只用下划线指示,适配 8 个中文分类不换行);计数走 --font-mono ②
2 卡片:运行中 / 开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息 徽标→Badge variant="secondary"(运行中)/ variant="outline"(开发中);元信息 --muted-foreground + --font-mono(分隔符 · 前不加空格) ②
3 emoji 图标是视觉一致性的明显缺口 emoji 无法通过令牌修正(它绕过 --font-sans 的调色)→ ③ 层面把图标位从"文字 emoji"改为 48×48 的 rounded-lg 中性灰底(--muted #f0f0f0)方块,内部仍由现有内容渲染;图标的彻底替换(lucide)超出令牌范围,列入 R6 ③
4 卡片圆角实测 10px×52、26px×23 随 --radius 收敛到 6px,Card 的官方 rounded-lg 一类 ①
5 卡片 14px/400 ×265、15px/400 ×215 混用 卡片描述 14px 保持(②);卡片标题 14px/500 --foreground ②

组件与 variant: Card/CardHeader/CardTitle/CardDescription/CardContent、Badge、Button variant="ghost" size="sm"、Tabs variant="line"、Separator、ScrollArea、Item。

S6 语音频道 — 本栈不可见,依据是代码与库数据,不是截图

TRTC_ENABLED=false,实测 DOM 内 aria-label 匹配「语音|通话|加入」命中 0、正文不含「语音」、/api/v1/rtc/* 返回 RTC_DISABLED(S6-space-opc.json 为通用空态「这里还没有消息 / 在下方输入框发送第一条消息,把话题开起来。」)。数据库侧存在真实数据:wanman3_rtc_voice_channels 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行。

因此本方案对 S6 只做令牌级前瞻设计,不做视觉验收声明:web/src/components/app/rtc-group-call-ui.tsx 的成员状态文本(已连接 / 连接中 / 重连中 / 已断开 / 连接失败)在本方案的状态色映射下取 --chart-4(已连接)/ --chart-3(连接中)/ --destructive(已断开、连接失败)——但这些取值在当前部署下不可实测,属未验证推断,同样列入风险。


深浅色与对比度

比值按 WCAG 相对亮度公式自算(#RRGGBB → 线性化 → 0.2126R+0.7152G+0.0722B)。

浅色

组合 前景 背景 比值 达标
正文 / 画布 #171717 #fafafa 17.18:1 ✅ ≥4.5
正文 / 卡片 #171717 #ffffff 17.93:1 ✅
次级文字 / 画布 #666666 #fafafa 5.50:1 ✅
次级文字 / 卡片 #666666 #ffffff 5.74:1 ✅
次级文字 / 侧栏 #666666 #f4f4f4 5.22:1 ✅
自己气泡文字 / 气泡 #fafafa #171717 17.18:1 ✅
他人气泡文字 / 气泡 #171717 #ebebeb 16.01:1 ✅
主按钮文字 / 按钮 #ffffff #171717 17.93:1 ✅
@提及 / 画布 #297a3a #fafafa 5.11:1 ✅
@提及 / 他人气泡 #297a3a #ebebeb 4.76:1 ✅ ≥4.5
危险文字 / 卡片 #d92d20 #ffffff 4.83:1 ✅
控件周界 / 卡片 #8f8f8f #ffffff 3.23:1 ✅ ≥3(1.4.11)
频道图标 / 侧栏 #6e6e6e #f4f4f4 4.64:1 ✅ ≥3
选中项文字 / 选中底 #171717 #e4e4e4 14.10:1 ✅
选中底 / 侧栏底 #e4e4e4 #f4f4f4 1.16:1 ⚠️ <3 —— 见 R3
分隔线 / 画布 #ebebeb #fafafa 1.14:1 ⚠️ 装饰性,刻意(R1)
侧栏底 / 画布 #f4f4f4 #fafafa 1.05:1 ⚠️ 装饰性(R1)
卡片 / 画布 #ffffff #fafafa 1.05:1 ⚠️ 装饰性——层级由 3.23:1 的周界承担

深色

组合 前景 背景 比值 达标
正文 / 画布 #ededed #0a0a0a 16.91:1 ✅
正文 / 卡片 #ededed #171717 15.31:1 ✅
次级文字 / 画布 #a1a1a1 #0a0a0a 7.66:1 ✅
次级文字 / 卡片 #a1a1a1 #171717 6.94:1 ✅
自己气泡文字 / 气泡 #0a0a0a #ededed 16.91:1 ✅
主按钮文字 / 按钮 #0a0a0a #ededed 16.91:1 ✅
@提及 / 画布 #46a758 #0a0a0a 6.53:1 ✅
@提及 / 卡片 #46a758 #171717 5.92:1 ✅
危险文字 / 卡片 #ff6369 #171717 6.18:1 ✅
控件周界 / 卡片 #707070(= rgb(255 255 255 / 0.45) 合成值) #171717 3.62:1 ✅ ≥3
频道图标 / 画布 #8f8f8f #0a0a0a 6.12:1 ✅
选中项文字 / 选中底 #ededed #262626 12.93:1 ✅
选中底 / 侧栏底 #262626 #0a0a0a 1.31:1 ⚠️ <3 —— 见 R3
分隔线 / 画布 #2a2a2a(= rgb(255 255 255 / 0.14) 合成值) #0a0a0a 1.38:1 ⚠️ 装饰性(R1)
卡片 / 画布 #171717 #0a0a0a 1.10:1 ⚠️ 装饰性——层级由 3.62:1 的周界承担

结论: 正文、次级文字、气泡、按钮、提及、危险色、控件周界、图标 —— 两套共 22 项组合全部达标;未达 3:1 的 4 项分两类:① 装饰性明度差(分隔线、侧栏 vs 画布、卡片 vs 画布),Vercel 语言刻意为之且不承载信息;② 会话选中底(R3),已用文字对比度补偿。深色下现状的严重缺陷(--surface-rail 仍是浅色 #e3e5e8、--interactive/--channel-icon 缺声明、rgb(6,6,7) 55 处硬编码前景)在令牌层被消除。


shadcn 兼容性

结论:可以只靠官方组件 + 官方 variant/size 达成,不需要新增任何组件,也没有任何一处需要自定义样式。

检查项 结论
组件总数 web/src/components/ui/ 现有 38 个官方组件,本方案只用其中已有的 20 个,不新增组件
新增视觉变体 0 个。全部改造落在官方 variant 值域内:Button 用 default/outline/ghost/secondary/destructive/link;Badge 用 default/secondary/outline/destructive;Tabs 用 default/line
className / 内联 style / 全局 CSS 覆盖组件 0 处。所有颜色/圆角/阴影/边界的改变都通过 web/src/styles.css 的语义令牌取值传导(components.json cssVariables: true)
官方尺寸 只使用官方 size:Button 的 xs/sm/default/lg/icon-xs/icon-sm/icon/icon-lg;Avatar 的 sm;Badge 无 size(固定 h-5)
需要新安装的官方组件 无
令牌名合法性 tokens.css 只包含 web/src/styles.css 已存在的自定义属性名;.dark 下补齐 --interactive 与 --channel-icon 是给已存在的变量名补声明,不是新变量
@theme inline 映射 完全沿用原文,未增删任何 --color-* 映射行

显式标注的不合规风险

编号 内容 类型
R1 --border 1.14:1(浅)/ 1.38:1(深)、侧栏与画布 1.05:1、卡片与画布 1.05:1 —— 低于 WCAG 1.4.11 的 3:1。辩护:这些是装饰性明度差,不承载"识别控件/状态"的信息;所有可交互边界集中在 --input(3.23:1 / 3.62:1)。若验收要求所有边界 ≥3:1,则本方案不适用 刻意取舍,非疏漏
R2 令牌泄漏未消除:message-list.tsx / composer-markdown.ts / voice-channel-history-dialog.tsx 硬编码 #006ce7;chat-mention.ts 硬编码 #3370FF;chrome.ts #f06f66、tone.ts #23a55a / #f0b232;253 处 Tailwind 原始调色板(44 个非测试文件) 不合规风险:这些位置在深色下不翻转。本方案只能改令牌,无法从令牌层覆盖硬编码值;需另开一个"去硬编码"任务改 web/ 代码
R3 会话选中底 #e4e4e4 vs 侧栏 #f4f4f4 = 1.16:1(深色 1.31:1),低于 3:1。补偿:选中项文字由 --muted-foreground(5.22:1)切到 --foreground(14.10:1),状态不靠颜色单一维度传达。若必须 ≥3:1,则选中底需改为反相黑(#171717 + #fafafa 文字,17.18:1),但那会让侧栏出现一条黑色重条,与 Vercel 的"谨慎使用反相表面"冲突 刻意取舍 + 已给替代方案
R4 通过令牌无法修正的排版问题:消息正文"他人 15px / 自己 14px"两套字号(message-list.tsx)、12.8px/13.125px 小数档位、emoji 图标(app-center.tsx)、9px/9.375px 超小字号。这些都在组件类里,需改 web/ 代码 —— 本方案把它们列为目标值并标注途径②,但不声称已通过令牌修复 明确的越界项
R5 头像首字底色是 Tailwind 50/700 硬编码配对(amber rgb(255,251,235)、rose rgb(255,241,242)…),深色下仍是浅色块独立于本方案 同 R2
R6 应用中心 emoji 图标:本方案只把图标容器改为 48×48 rounded-lg 中性底;emoji 本身无法被令牌影响,彻底替换为 lucide 需改代码 部分解决
R7 深色主题在生产不可达(全仓 web/src 无任何代码添加 .dark,<html> class 恒为空)。本方案给出完整深色令牌,但上线前必须先在代码里加主题切换,否则深色部分无法验收 前置依赖
R8 S6 语音频道的令牌取值属未实测推断(TRTC_ENABLED=false) 未验证

实施成本

改动面 文件 内容 人时
令牌(必须) web/src/styles.css 用 tokens.css 替换 @theme inline 的 4 条阴影、:root 约 38 行、.dark 约 38 行 2h
令牌(可选,视觉细节) web/src/styles.css --workspace-* 三行渐变 0.5h
组件(途径②,可分批) message-list.tsx、task-hall.tsx、group-hall.tsx、app-center.tsx、agent-chat-panel.tsx、channel-sidebar.tsx、space-manage-dialog.tsx、channel-settings-dialog.tsx、routes/login.tsx 统一字号到 6 档刻度;Button/Badge/Tabs 的 variant 选择;两套圆角归一 12h
容器(途径③) 同上 + app-shell.tsx 群聊大厅去 hero、rail 图标网格 48×48、列表行间距、侧栏三面明度阶梯 6h
去硬编码(R2/R5,独立任务) 44 个非测试文件 253 处 Tailwind 调色板 + 6 处硬编码色 → 语义令牌 16h
主题开关(R7,前置) app-shell.tsx / index.html 让 .dark 可被挂上 3h
合计 ≈40h(其中必做 2h,其余可按批次上线)

风险清单

  1. 深色不可达(R7) —— 止于令牌层,无代码开关则深色侧全部无法验收。最大风险。
  2. 令牌泄漏(R2/R5) —— 253 处调色板 + 硬编码色在深色下不翻转,会让"深色对等"的承诺在局部失效。必须先做去硬编码,或明确接受"深色下仍有一半界面不可读"。
  3. 中文小字号(R4) —— 只改令牌无法把 9.375px 提到 12px。
  4. 品牌识别 —— --brand 由 #2563eb 变 #171717 是品牌级决定,需产品 owner 签字;若要保留蓝色,本方案的"单色纪律"会退化为"又一个蓝色企业工具"。
  5. 反相气泡的阅读负荷 —— 长消息(实测最长如「需要限制不可删除兜底的通用讨论子频道么,刚才实测删除后仍会展示在列表里」)在白底上为黑块,深色下为亮块,长时段阅读负担高于浅灰气泡。

验证方式(哪些检查能证明改动生效)

  1. 令牌生效:getComputedStyle(document.documentElement).getPropertyValue('--brand') 应返回 #171717(浅)/ #ededed(深);--radius 返回 0.375rem。
  2. 层级修复:对侧栏 aside 与 body 取 backgroundColor,应分别为 rgb(244,244,244) 与 rgb(250,250,250)(不再相同,即修掉简报 §3.3 的"零层级对比")。
  3. 气泡语义:对 message-self 气泡取背景,应为 rgb(23,23,23)(浅)/ rgb(237,237,237)(深)。
  4. 去蓝:全页扫描 getComputedStyle 的 color/backgroundColor,不应再出现 rgb(37,99,235)、rgb(51,112,255)、rgb(232,243,254)、rgb(229,236,252)、rgb(225,232,242)。
  5. 圆角收敛:全页 borderRadius 去重后应只剩 6px / 4.8px / 3.6px / 8.4px / 9999px(--radius 派生族 + 胶囊),不再有 10px / 14px / 18px / 26px / 2px / 7px。
  6. 深色可达性:注入 .dark 后重新执行 2–4,所有值应落到深色令牌;且 --surface-rail 不再是浅色。
  7. 对比度:按本文件两张对比度表逐项复算,22 项达标项不得有回归。

取舍

解决了什么

牺牲了什么

什么场景下不适用