终端手记 · 基于 PlanetScale「daylight terminal」的 wanman /app 重设计方案
slug:planetscale | 参考:localtmp/gradientdeck/planetscale.design.md、planetscale.design-extended.md | 基线:test@3d35969f | 覆盖样例面:S1 S2 S3 S4 S5 S7 S8(+ S6 仅有代码依据)
交付物:proposal.md(本文)| tokens.css(可直接替换 web/src/styles.css 的 :root / .dark 两块 + @theme inline 两行字体栈)| preview.html(双击打开,左浅右深双栏,含色板 / 字号阶梯 / 官方控件 / rail+侧栏+消息流+任务卡骨架)
方案名与主张
方案名:终端手记(Terminal Field Notes)
一句话主张: 把 wanman 的蓝灰「类飞书」外壳换成一套无彩画布 + 1px 发丝线分界 + 数字等宽的终端式工作台——彩色预算收到「一档品牌蓝 + 一档风险红」,层级全部由「平面 + 发丝线 + 墨阶」承担,圆角从实测 12 档收敛到 4px / 5.6px / 胶囊 三档,视觉可信度来自排版纪律而不是阴影与色块。
适用基调:浅色优先。浅色是本栈唯一生产可达的形态(实测:<html> class 恒为空、localStorage 无主题键、color-scheme: normal);深色按同一套纪律对等推导并给出完整数值,但深色要落地必须先补一个主题开关,这点在 §8 明确标注为风险与前置条件。
参考提炼
参考风格名 PlanetScale — Terminal man-page in daylight,来源站点 planetscale.com,theme = light(参考本身只有浅色)。
从参考 DESIGN.md / extended 提炼出 5 条可迁移规则(引其原文要点):
- 单色信息层 + 一个彩色。Color 表里 Charcoal
#414141(正文)/ Ink Black#000000(标题)/ Graphite#737373(次级)/ Fog#c1c1c1(发丝线、表分隔、nav 分隔、禁用描边)/ Off-White#fafafa(画布、卡片、输入底色)构成全部信息色;唯一彩色 Ember#f35815的规则是 “Use #f35815 exclusively as a filled button background — never as text color, border, or decorative fill”。→ 迁移为:彩色预算 = 1 档填充蓝 + 1 档风险红,品牌蓝永不作为大面积装饰底。 - 平面无高程。Elevation 章原文:“no drop shadows, no glows, no z-axis layering. Depth is communicated through hairline borders, background color inversions, and typographic weight changes.” → 迁移为:全站 onClick 阴影阶梯(
--shadow-e1..e3)在页面容器层不出现,卡片/气泡/弹窗靠Card/Dialog自带的ring-1 ring-foreground/10与--border分界。 - 圆角纪律是两档而不是一档。Do 原文:“Set border-radius to 9999px on all buttons and tags; 0px on cards, inputs, tabs, and panels.” → 迁移为:用一个
--radius同时产出「面板方正 + 标签胶囊」(见 §8 的 calc 链论证)。 - 排版承担重量,字距收紧。Typography 原文:“Weight 500–600 for headings, 400 for body… Negative letter-spacing (-0.006em) tightens glyphs just enough to avoid the loose feel of raw terminal output.” → 迁移为:中文不套等宽、但数字/时间/ID/快捷键一律
--font-mono且靠字重分档。 - 颜色不表达交互状态。Don't 原文:“Do not use color to indicate state (hover, active, disabled) — rely on weight changes, underlines, and background inversions.” → 迁移为:hover/选中/禁用一律「背景反转」(
--muted/--accent/--sidebar-accent三档灰),业务状态另立规则(见下)。
不迁移的参考局部(照抄会直接违反产品形态):
- 营销页组件:Customer Logo Grid、Testimonial Quote、Announcement Banner(
#111111带 +#f2b600内联高亮)、Headline Block、Accent Bar、Code/Data Block —— 全部是落地页构件,本产品是「消息 + 任务」双核心工具,一律不要。 #f35815(Ember)与#f2b600(Amber):前者是参考自己的品牌色(简报明确要求不照抄品牌色),后者是营销内联标记专用色。#0b6ec5(Signal Blue):参考明令 “Do not use #0b6ec5 as a filled button or CTA background — it is link color only”。本方案的--brand是另一支更深的终端蓝#1f5fd0,--mention与--brand-ink统一到同一支蓝的文字档#1a4db8,不引入第三种蓝。page max-width: 960px、section gap 56px、card padding 24px:阅读型页面的度量,与本产品的三栏全屏密度无关。
适配判断
为什么这套语言适合「任务 + 频道消息」的企业工具
- 它本来就诞生在高密度工具场景语境里:等宽 + 发丝线 + 灰度阶,是「数据表、日志、SQL 面板」的语言;wanman 的核心视图恰恰是列表(148 个会话频道 / 1554 条消息 / 457 个任务)与表格化信息(状态、负责人、截止时间、难度、招聘状态),与终端/README 的信息形态同构。
- 它把「层级」从美术判断变成规则判断。实测现状的三个具体缺陷——① 会话侧栏
#fcfcfc与页面底色#fcfcfc完全相同(零层级对比);② 圆角实测 12 档(2/6/7/8/10/12/14/18/24/26/32/9999px);③ 字号实测 10 档(9/9.375/11/11.25/12/12.8/13.125/14/15/26px)——都不是「不好看」,而是没有规则。参考的纪律(两档圆角、一条 type scale、一套发丝线)正好是这三条缺陷的对症解,而且只靠语义令牌就能改掉大半,不需要动组件代码。 - 它的彩色克制直接治理实测的「令牌泄漏」。全仓 253 处 Tailwind 原始调色板(amber 69 / rose 68 / slate 44 / emerald 42 …)、头像首字 50/700 配对硬编码、三种蓝并存(
--brand #2563eb/ 硬编码#006ce7/--mention #3370ff)——当设计语言只允许「一档蓝 + 一档红」时,这些散色就都有了明确的收拢目标。 - 长时段驻留友好。深色可用、无阴影、无动效噪声(参考 “surfaces must remain flat”),适合一线人员整天挂着的 IM 工作台;同时
#f7f7f7画布 + 白色侧栏 + 白色卡片的组合在 1440×900 长时间阅读下比现状的近纯白#fcfcfc更省眼。
明确舍弃项(参考规则 → 本产品的不可用原因)
| 参考规则 | 舍弃理由 | 本方案替代 |
|---|---|---|
全站 ui-monospace,“the monospace-only identity is load-bearing” |
CJK 无等宽(Noto Sans SC / PingFang SC 均非等宽)。等宽化后 16 个汉字 = 16 全宽字符,240px 会话行只能放 ~12 字,实测文案「需要限制不可删除兜底的通用讨论子频道么」直接爆行;且 --font-mono 里没有中文字形,实际会回退成比例字体,等于「规则只在拉丁文上成立」 |
等宽下沉到语义层:数字 / 时间 / 计数 / ID / 任务号 / 快捷键 / 状态码 用 --font-mono,中文散文用 --font-sans(§5 有完整分工表) |
border-radius: 0px on cards/inputs/panels |
--radius: 0 会让 Card 的 ring-1 ring-foreground/10 与内容零间隙贴合,Badge(rounded-4xl = 2.6×)也变成直角小方块,实测 1591 处 8px 卡片会集体变成裸边框矩形,密度下边界发糊 |
--radius: 0.25rem:面板 4–5.6px(方正感保留),Badge 的 2.6× 在 20px 高 chip 上被浏览器钳制为 10px = 胶囊 → 参考的「方 + 圆」对比完整保留 |
| 960px 居中阅读列 | 本产品是三栏全屏工具(rail 72px + 侧栏 256px + 内容区),实测内容区宽 860px | 消息/任务阅读列 max-width 720px 居中(途径③),保留三栏骨架 |
| 「颜色不表达状态」 | 任务有 6 个业务状态(待补充 / 待处理 / 进行中 / 待验收 / 已完成 / 已关闭)+ 逾期风险,纯灰 + 字重不足以在 5 列看板上定位 |
拆成两套:交互态(hover/active/disabled)严守参考规则,只做背景反转;业务状态用官方 Badge variant + lucide 图标形状双编码,且彩色只用 --brand 与 --destructive 两支 |
#111111 Inverse Band 用作导航带 |
实测 rail 图标颜色由共享令牌 --channel-icon(#80848e) / --interactive 消费;把 rail 涂黑会把这两个令牌同时拉去服务两套背景,导致侧栏图标在同一主题内不可读(一个令牌无法同时满足两种底色) |
rail 保持浅色,改为中性灰平色带 --surface-rail: #e9e9e9(与白侧栏 1.21:1),并用 --sidebar-border: #c1c1c1(1.80:1)承担与内容区的分界 |
参考 --font-sans 不适用(它全站等宽,无 sans 栈可借) |
参考没有可迁移的 sans 字体栈 | 只做「删死回退 + 中文优先级修正」(§5) |
令牌映射
文件:web/src/styles.css(:root 在 108–161 行,.dark 在 163–211 行)。下表覆盖简报 §5.1 第 4 条列出的全部变量名,另附同文件内真实存在、且被本次改造牵动的变量。每一行的「意图」都带途径标记:① 令牌取值 / ② 官方 variant/size / ③ 容器布局。
浅色(:root)
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
#fcfcfc |
#f7f7f7 |
【①】画布下沉一档。实测「会话侧栏 #fcfcfc 与页面底色 #fcfcfc 完全相同、零层级对比」,画布必须让位,白色侧栏(1.07:1)+ 发丝线(1.80:1)才能成立 |
--foreground |
#060607 |
#262626 |
【①】参考正文 Charcoal #414141、标题 Ink #000000;本产品只有一支 --foreground,取两者之间。画布 14.13:1、卡片 15.13:1,比现状的 19.4:1 更接近终端墨色 |
--card |
#ffffff |
#ffffff |
【①】不变。参考「Card Cell 与画布同色、由发丝线定义」,但本产品卡片必须比下沉后的画布亮,故保留纯白 |
--card-foreground |
#060607 |
#262626 |
【①】跟随 --foreground,卡片上 15.13:1 |
--popover |
#ffffff |
#ffffff |
【①】不变;弹窗沿用参考的「同色表面 + 描边」而非阴影 |
--popover-foreground |
#060607 |
#262626 |
【①】弹窗正文 15.13:1 |
--primary |
var(--brand) |
var(--brand) |
【①】不改:保持「品牌即主色」的单点映射,避免出现旁路品牌色 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
【①】不改 |
--secondary |
#ebedef |
#ececec |
【①】去掉蓝味,回到参考的纯中性阶;卡片上 1.18:1,作 chip / 进度槽底色可辨 |
--secondary-foreground |
#060607 |
#262626 |
【①】12.81:1 |
--muted |
#f2f3f5 |
#efefef |
【①】hover / 凹槽底色。白侧栏上 1.15:1、卡片上 1.15:1 —— 同时解决实测「侧栏 hover 无反馈」;且足够浅以承载 --muted-foreground 的 4.99:1 |
--muted-foreground |
#5c5e66 |
#666666 |
【①】参考 Graphite #737373 在 #fafafa 上 4.54:1,但叠到 #efefef 上只有 4.34:1 不达标;整体下沉到纯中性 #666666:画布 5.36、卡片 5.74、muted 4.99,三处全过 |
--accent |
#ebedef |
#ececec |
【①】他人气泡与 hover 面转纯中性(实测他人气泡 rgb(235,237,239) = 旧 --accent),坐标让给 --message-self |
--accent-foreground |
#060607 |
#262626 |
【①】12.81:1 |
--destructive |
#da373c |
#c0392b |
【①】参考无红。取砖红:画布 5.08、卡片 5.44、自消息气泡上 4.68 —— 作文字色全部达标(旧值 #da373c 在 #fcfcfc 上 4.86 也过,但饱和度过高,不符合参考「只有一个响亮色」) |
--border |
#dcdee1 |
#e3e3e3 |
【①】装饰性发丝线(WCAG 1.4.11 豁免,卡片上 1.28:1)。比现状更浅更中性,避免高密度列表产生网格压迫感 |
--input |
#dcdee1 |
#8c8c8c |
【①】输入框边框承担「控件边界」职责,必须 ≥3:1:白卡 3.36、画布 3.14。这是本方案对参考发丝线规则唯一的功能性加严 |
--ring |
var(--brand) |
var(--brand) |
【①】不改 |
--brand |
#2563eb |
#1f5fd0 |
【①】不照抄参考的 Ember #f35815(参考明令其只作填充按钮;且简报要求不照抄品牌色)。沿用蓝语义但下沉到终端蓝档位:白字 5.82、画布上作图形 5.44 |
--brand-foreground |
#ffffff |
#ffffff |
【①】按钮文字:#ffffff on #1f5fd0 = 5.82:1 |
--brand-soft |
rgb(37 99 235 / 0.12) |
rgb(31 95 208 / 0.1) |
【①】选中行底色覆盖率高(侧栏 240×64),0.12 过亮压过文字;降到 0.10 后 --brand-ink 在其上仍有 6.50:1 |
--brand-ink |
#1d4ed8 |
#1a4db8 |
【①】品牌蓝的文字档。画布 7.01、卡片 7.51、--surface-chat-soft 上 6.74 |
--message-self |
#e8f3fe |
#e8eefb |
【①】自消息气泡是「单色纪律」下唯一的形状性彩色,保留但压低蓝量(对比现状更少饱和),与 --surface-chat-soft 区分开 |
--message-self-foreground |
#0d274a |
#123156 |
【①】气泡上 11.29:1 |
--surface-chat-soft |
#e8f2ff |
#eef3fc |
【①】回复引用底更淡一档,--brand-ink 在其上 6.74:1 |
--surface-chat-selected |
#e5ecfc |
#e4ebfa |
【①】会话选中底,与 --message-self 同族但更灰,避免与气泡混淆 |
--mention |
#3370ff |
#1a4db8 |
【①】终结实测「三种蓝并存」:--mention 与 --brand-ink 取同一个 hex,全站只剩「填充档 + 文字档」两支蓝 |
--ink |
#060607 |
#111111 |
【①】参考 Obsidian #111111,用于少量最高对比元素(画布 17.63:1) |
--surface-rail |
#e1e8f2 |
#e9e9e9 |
【①】参考 “flat, no shadows, no gradients”;rail 带改纯中性灰,与白侧栏 1.21:1,成为可辨的 chrome 带 |
--sidebar |
#fcfcfc |
#ffffff |
【①】侧栏做成白色面板:这样它又能承载可见的 --muted hover(1.15:1),又能与下沉后的 #f7f7f7 画布拉开一档 |
--sidebar-foreground |
#060607 |
#262626 |
【①】15.13:1 |
--sidebar-accent |
#ebedef |
#efefef |
【①】会话行 240×64 的 hover/选中底,白侧栏上 1.15:1 |
--sidebar-accent-foreground |
#060607 |
#262626 |
【①】13.16:1 |
--sidebar-border |
#dcdee1 |
#c1c1c1 |
【①】参考 Fog 的原生职责(nav separators)。这是对「侧栏与画布零层级对比」的正面回答:白底 + 1.80:1 灰线 |
--chart-1..5 |
oklch(0.87/0.556/0.439/0.371/0.269 0 0) |
#111111 / #414141 / #737373 / #a3a3a3 / #d4d4d4 |
【①】参考全域无彩,按其「单色画布 + 灰度阶」把 chart 定义成 5 步墨阶:#111111(Obsidian) / #414141(Charcoal) / #737373(Graphite) / 加深的 #a3a3a3 / 加深的 #d4d4d4,全部可直接追溯到参考色 |
--radius |
0.625rem(10px) |
0.25rem(4px) |
【①】一条令牌同时得到「面板方正 + 标签胶囊」:Button/Input/Textarea/TabsList = --radius-lg = 4px;Card/Dialog = --radius-xl = 5.6px;Badge = --radius-4xl = 10.4px 在 20px 高 chip 上被钳制为 10px = 全圆 |
--interactive |
#4e5058 |
#4d4d4d |
【①】纯中性化;白侧栏上 8.45:1 |
--channel-icon |
#80848e |
#6b6b6b |
【①】实测 #80848e 在 #fcfcfc 上仅 3.6:1(次级图标勉强);提深到 5.33:1 并去蓝味 |
--workspace-background |
linear-gradient(180deg, var(--surface-rail), #e1e5f1) |
var(--surface-rail) |
【①】删掉蓝灰渐变(与参考 “Do not add drop shadows, glows, or elevation effects… surfaces must remain flat” 直接冲突),rail 成为平色带 |
--workspace-rail-background |
transparent |
transparent |
【①】不改,让 rail 透出 --surface-rail |
--workspace-header-background |
var(--background) |
var(--background) |
【①】不改 |
--sidebar-primary / --sidebar-primary-foreground / --sidebar-ring |
var(--brand) / var(--brand-foreground) / var(--ring) |
同 | 【①】不改,靠 var() 延迟解析随主题翻转 |
深色(.dark)
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--surface-rail |
#e3e5e8 |
#0b0b0b |
【①】修实测缺陷:深色下 rail 仍取浅色 #e3e5e8,会显示成一条浅色竖带。改为比画布更深一档,成为真正的 chrome 带(与 #1a1a1a 侧栏 1.13:1) |
--workspace-background |
radial-gradient(ellipse at 8% 0%, color-mix(...)) |
var(--surface-rail) |
【①】删掉蓝色径向雾,改为平色(同浅色理由) |
--workspace-rail-background |
color-mix(in oklab, var(--background) 45%, transparent) |
transparent |
【①】与浅色对齐,rail 直接透出 #0b0b0b |
--workspace-header-background |
蓝色两段渐变 | var(--background) |
【①】平色化 |
--background |
oklch(0.145 0 0) |
#121212 |
【①】参考 Obsidian #111111 的近邻(保留一点抬升空间给卡片) |
--foreground |
oklch(0.985 0 0) |
#e8e8e8 |
【①】画布 15.29、卡片 14.20,避免纯白在 OLED 上的眩光 |
--card |
oklch(0.205 0 0) |
#1a1a1a |
【①】卡片抬一档(1.08:1),靠平面 + 发丝线分层,不引入阴影 |
--card-foreground |
oklch(0.985 0 0) |
#f0f0f0 |
【①】15.27:1 |
--popover |
oklch(0.205 0 0) |
#1a1a1a |
【①】同卡片 |
--popover-foreground |
oklch(0.985 0 0) |
#f0f0f0 |
【①】15.27:1 |
--secondary |
oklch(0.269 0 0) |
#262626 |
【①】纯中性替换 oklch 灰,与浅色阶对仗 |
--secondary-foreground |
oklch(0.985 0 0) |
#ededed |
【①】12.93:1 |
--muted |
oklch(0.269 0 0) |
#232323 |
【①】hover/凹槽底色:卡片上 1.11、画布上 1.19 |
--muted-foreground |
oklch(0.708 0 0) |
#a0a0a0 |
【①】画布 7.16、卡片 6.66、muted 上 6.01 |
--accent |
oklch(0.269 0 0) |
#262626 |
【①】他人气泡:卡片上 1.15 |
--accent-foreground |
oklch(0.985 0 0) |
#f0f0f0 |
【①】13.28:1 |
--destructive |
oklch(0.704 0.191 22.216) |
#ff6b5e |
【①】画布 6.71、卡片 6.23、自消息气泡上 4.80;比现状更暖更不刺眼 |
--border |
oklch(1 0 0 / 10%) |
rgb(255 255 255 / 0.16) |
【①】合成后 #3f3f3f,卡片上 1.65:1(装饰性发丝线) |
--input |
oklch(1 0 0 / 15%) |
rgb(255 255 255 / 0.36) |
【①】合成后 #6c6c6c,卡片上 3.31、画布上 3.31 —— 控件边界 ≥3:1 达标 |
--ring |
var(--brand)(继承) |
同 | 【①】不改 |
--brand |
oklch(0.68 0.15 256) |
#5aa2f0 |
【①】深色下提亮,与 --brand-foreground 构成「浅填充 + 深字」的镜像语法 |
--brand-foreground |
oklch(0.16 0.02 258) |
#0d0d0d |
【①】#0d0d0d on #5aa2f0 = 7.28:1 |
--brand-soft |
oklch(0.28 0.05 256) |
rgb(90 162 240 / 0.16) |
【①】选中底改用与 --brand 同源的 alpha,保证换色时自动跟随 |
--brand-ink |
oklch(0.84 0.09 256) |
#93c0f7 |
【①】画布 9.92、卡片 9.22、--surface-chat-soft 上 8.04 |
--message-self |
#203b59 |
#1b3049 |
【①】自消息气泡:比现状更沉,避免与卡片 #1a1a1a 反差过大而显噪 |
--message-self-foreground |
#e7f3ff |
#d7e7fb |
【①】气泡上 10.68:1 |
--surface-chat-soft |
oklch(0.32 0.06 250) |
#1a2734 |
【①】回复引用底,--brand-ink 在其上 8.04:1 |
--surface-chat-selected |
oklch(0.28 0.04 250) |
#22303f |
【①】会话选中底 |
--mention |
oklch(0.72 0.14 254) |
#93c0f7 |
【①】与 --brand-ink 统一(同一 hex),延续浅色的「两支蓝」纪律 |
--ink |
oklch(0.16 0.02 258) |
#f0f0f0 |
【①】深色下 --ink 必须翻转(画布 16.44:1);现状把它设成近黑,在深底上等于不可读 |
--sidebar |
oklch(0.205 0 0) |
#1a1a1a |
【①】与画布 1.08:1,配 --sidebar-border 分界 |
--sidebar-foreground |
oklch(0.985 0 0) |
#e8e8e8 |
【①】14.20:1 |
--sidebar-accent |
oklch(0.269 0 0) |
#262626 |
【①】行 hover:侧栏上 1.15:1 |
--sidebar-accent-foreground |
oklch(0.985 0 0) |
#f5f5f5 |
【①】13.88:1 |
--sidebar-border |
oklch(1 0 0 / 10%) |
rgb(255 255 255 / 0.16) |
【①】合成 #3f3f3f,1.65:1,与 --border 同档 |
--chart-1..5 |
oklch(0.87/0.556/0.439/0.371/0.269 0 0) |
#f5f5f5 / #d4d4d4 / #a3a3a3 / #737373 / #525252 |
【①】浅色墨阶的反向五步,保证深底上对比单调递减 |
--radius |
0.625rem |
0.25rem |
【①】--radius 定义在 :root,.dark 不重复声明即可继承(原文也没在 .dark 里声明) |
--interactive |
#4e5058(继承浅色,深色下 1.6:1 不可读) |
#c0c0c0 |
【①】深色下必须翻转:侧栏上 9.57:1。现状 .dark 未覆盖此令牌,是实测「深色注入后前景 rgb(92,94,102) 27 处不可读」的成因之一 |
--channel-icon |
#80848e(继承浅色) |
#a0a0a0 |
【①】同上,侧栏上 6.66:1 |
字体与排版
字体栈(web/src/styles.css:32-39,@theme inline)
--font-sans: "Geist Variable", -apple-system, BlinkMacSystemFont, "PingFang SC",
"Hiragino Sans GB", "Microsoft YaHei", "Noto Sans SC", ui-sans-serif,
system-ui, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
--font-mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Monaco, Consolas,
"Liberation Mono", "PingFang SC", monospace;
改动三点:
- 删掉
"gg sans":它不在@fontsource依赖里、也不是 macOS/Windows 系统字体,是永远命不中的死回退,只是把解析表拉长一档。 - 把
"PingFang SC"提到"Noto Sans SC"之前:本仓只@import "@fontsource-variable/geist"(styles.css:5),没有引入任何中文 Web 字体,"Noto Sans SC"只有本机装过才有字形;macOS 上把原生苹方放前面,中文才稳定命中(现状实测body字号 15px、字体栈里 Geist 无中文字形 → 中文实际走 fallback,但顺序不确定)。 --font-mono补Monaco与显式中文回退:与参考Substitute: SF Mono, Menlo, Consolas, "Liberation Mono", monospace对齐;在monospace泛型前显式写"PingFang SC",保证等宽区里的汉字有确定字形,数字列不会因汉字混排而错位。
西文不挤掉中文的保证:Geist Variable 无 CJK 字形,浏览器对汉字自动落到下一项,因此拉丁取 Geist、汉字取苹方/雅黑,中英混排基线由 Geist 的 x-height 决定;不要再往栈里塞 Helvetica/Arial 之类会与 Geist 争夺拉丁字形的项。
字号分工(--font-mono 只用于可对齐/可复制的短串)
| 用途 | 字体 | 实测/建议字号 | 行高 | 字重 | 依据 |
|---|---|---|---|---|---|
| 正文(消息、描述) | sans | 15px(body 现测值,styles.css:262 text-[15px] leading-[1.375]) |
1.375(20.63px) | 400 | 简报要求正文 14–15px、行高 ≥1.375,现状已达标,不动 |
| 气泡正文 | sans | 14px(bubble.tsx:74 官方 text-sm + leading-relaxed) |
1.625 | 400 | 这是实测「他人 15px / 自己 14px 两套字号」的成因:结构化气泡走 Bubble 的 text-sm,纯文本消息继承 body 的 15px |
| 次级信息(作者、时间、成员数) | sans | 13px / 12px | 1.375 | 400 / 500 | 实测现状即 13px/12px,保留 |
| 小标签 / 元信息 | sans | 12px 下限 | 1.375 | 500 | 简报规定中文最小 12px;实测存在 text-[9px] ×2、text-[10px] ×20(共 22 处,73 个文件里),低于 12px 的中文一律不合格(见 §8 风险) |
| 计数 / 未读数 / 时间戳 / 任务号 / ID / 快捷键 / 状态码 | mono | 12–13px | 1.25 | 500 | 参考等宽纪律的功能性下沉;kbd-chip(styles.css:220-235)已经用 var(--font-mono) + 10px —— 10px 触犯中文下限,但 kbd-chip 只渲染 ⌘/K 等拉丁符号,属例外,可保留 |
| 页面标题(频道名) | sans | 16px | 1.25 | 600 | 实测频道头标题 16px/600,保留 |
| 登录页主标题 | sans | 26px → 24px 或 32px(对齐参考 heading-sm 24 / heading 32) |
1.25 | 600 | 实测 26px 落在 8px 网格外(26 = 8×3.25);参考的 type scale 只有 14/16/18/24/32 五档 |
字号阶梯:现状 10 档 → 建议 5 档
实测单视图出现 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26 px。其中:
- 9.375 / 11.25 / 13.125 = 以 15px 为基准的 em 计算的产物(0.625/0.75/0.875 × 15)。
- 12.8px = 官方
Button size="sm"的text-[0.8rem](button.tsx:26);实测 S4 一次渲染里12.8px/500 ×2765就是它,这是全站单档最大量。 - 其余
text-[11px] ×82、text-[13px] ×67、text-[10px] ×20、text-[12.5px] ×6、text-[13.5px] ×5、text-[9px] ×2是手写任意值(共 232 处 / 73 文件)。
收敛规则(分两条途径)
- 【②】:把
Button size="sm"(12.8px)统一改为size="xs"(官方text-xs= 12px)或size="default"(text-sm= 14px)—— 2765 处 12.8px 自然消失,不写一行 className。 - 【②】:
Button size="sm"同时把--radius-md的min(...,12px)圆角也一并消掉,避免 7px/10px 这类中间圆角(实测圆角档位里就有 7px)。
任意值字号
text-[11px]/text-[13px]/text-[10px]的清理不在①②③任何一条途径内(改的是组件 className 的字号),列为 §8 越界项,需要单独授权。
中文与数字的注意点
- 中英混排基线:中文(苹方/雅黑)与拉丁(Geist)的 x-height 不同,实测
body15px 下同一行中文视觉高度比拉丁大 1–2px;参考用letter-spacing: -0.006em收紧拉丁。本方案不新增letter-spacing令牌(styles.css里不存在该令牌名),中文侧不需要负字距(汉字本身已满宽),故只在数字串(计数器、时间戳)上保持默认字距 +tabular-nums。 - 数字必须等宽:未读计数、任务计数(
待补充 0 / 待处理 5)、时间戳(12:01)、任务号都换--font-mono,避免比例字体下数字跳动(.tabular-nums已在多处使用,如notification-drawer.tsx:120,是既有正确实践,保持)。 - 中文不做全站等宽:见 §3 舍弃表(240px 会话行 + 16 字文案会爆行)。
--font-heading继续映射到--font-sans(styles.css:32),不引入第二支标题字体 —— 参考的层级来自字重不是字体。标题用 600、正文 400,禁用 700(参考 “700 sparingly for emphasis”)。
关键界面改造
每条都标了途径:① 令牌取值 / ② 官方 variant/size 选择 / ③ 容器布局、区域尺寸、间距与滚动。凡越出①②③的,集中在 §8「越界项」并标为风险。
S1 应用外壳 + 空间/频道侧栏
关键文件:web/src/components/app/app-shell.tsx、channel-sidebar.tsx、workspace-rail.tsx(已读片段)。
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 会话侧栏 aside 256×715 @x=76,border-radius 14px,background #fcfcfc —— 与页面底色 --background #fcfcfc 完全相同,零层级对比 |
侧栏 --sidebar: #ffffff(15.13:1 前景),画布 --background: #f7f7f7,侧栏与内容区之间用 --sidebar-border: #c1c1c1(1.80:1)画一条 Fog 发丝线 → 层级 = 白底 + 灰线,正是参考「Card Cell 与画布同色、由发丝线定义」的做法 |
① |
| 2 | 空间 rail nav 72×900,背景 transparent,实际透出 --workspace-background = linear-gradient(180deg,#e1e8f2,#e1e5f1) 蓝灰渐变 |
--workspace-background: var(--surface-rail) = 平色 #e9e9e9,rail 成为一条与白侧栏 1.21:1 的中性灰带;渐变全删(参考:surfaces must remain flat) |
① |
| 3 | aside 圆角 14px(--radius-xl = 1.4×10) |
--radius: 0.25rem → --radius-xl = 5.6px。侧栏从「浮起的大圆角卡片」变回「方正分区」,与参考 cards: 0px / inputs: 0px 的方向一致 |
① |
| 4 | 侧栏头部高 52px;搜索框高 30px、圆角 10px、背景 rgba(235,238,239,0.75) |
头部 48px(8px 网格);搜索框改为官方 <Input>(input.tsx:11 已是 h-8 = 32px + rounded-lg),圆角随 --radius 收到 4px;填充色交给 --muted/--card,不再有第 4 种灰 rgba(235,238,239,.75) |
② + ① |
| 5 | 会话行 240×64;时间/预览 11.25px;未读点 | 行高 64px 保留(触屏兼容,简报要求桌面为主、触屏兼容);hover/选中底改 --sidebar-accent: #efefef(白侧栏上 1.15:1);预览字号统一到 12px 档(需动 className,见 §8 越界项);未读计数换 --font-mono + tabular-nums |
① ② ③ / 越界项 |
| 6 | rail 图标按钮 71×48,分隔线 rgba(5,5,9,0.22);图标色 --channel-icon #80848e |
图标按钮保持 48px(8px × 6);图标色档位提深:--interactive: #4d4d4d(8.45:1)、--channel-icon: #6b6b6b(5.33:1);分隔线改由官方 <Separator>(separator.tsx 用 bg-border)承担,去掉硬编码 rgba(5,5,9,0.22) |
① ② |
| 7 | 语音频道区状态文字(voice-channel-section.tsx:333 的 text-brand-ink / text-channel-icon 二选一) |
五态 已连接 / 连接中 / 重连中 / 已断开 / 连接失败 改用官方 <Badge>:已连接 = variant="default"(品牌填充)、连接中/重连中 = variant="outline"、已断开 = variant="ghost"、连接失败 = variant="destructive";Badge 的 rounded-4xl 在 4px 基下恰好成胶囊 |
② |
| 8 | 内容区极宽(实测频道头 860px,aside 之外几乎顶到 1440 右边) |
消息/任务阅读列 max-width: 720px 居中于内容区;三栏骨架(rail 72 + 侧栏 256 + 内容)不变。720px ≈ 15px 中文 48 字/行,在参考的 body 16px 阅读度量附近 |
③ |
密度与状态色:侧栏保持 64px 行高(高密度 + 触屏),rail 保持 48px;交互态只用背景反转(--muted / --sidebar-accent 两档灰),不使用彩色 hover;业务状态色只在 rail 下的语音区与任务区出现(见 S3/S6)。
S2 频道消息流
关键文件:message-list.tsx、channel-thread.tsx、channel-header.tsx、channel-tabs.tsx、components/ui/bubble.tsx(已读 bubbleVariants)。
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 他人气泡圆角 14px(bubble.tsx:74 的 rounded-xl),背景 rgb(235,237,239)(= 旧 --accent #ebedef);自己气泡 rgb(232,243,254)(= --message-self #e8f3fe)+ 文字 rgb(13,39,74) |
他人气泡改走官方 Bubble variant="secondary"(bubble.tsx:25 官方变体);自己气泡改走官方 Bubble variant="tinted"(bubble.tsx:29:oklch(from var(--primary) 0.93 calc(c*0.4) h),自动由 --primary 派生并在深色下翻转)。圆角随 --radius 收到 5.6px |
② + ① |
| 2 | 同一条消息列表里两套正文字号:他人 15px/400 #060607,自己 14px/400 #0d274a |
统一到 Bubble 的官方 text-sm(14px,bubble.tsx:74):结构化气泡与纯文本消息都走 Bubble(纯文本用 variant="ghost",官方 p-0、无背景),字号由官方组件决定,不再一处 15 一处 14 |
② |
| 3 | 自消息文字 #0d274a |
--message-self-foreground: #123156,气泡上 11.29:1;深色 #d7e7fb on #1b3049 = 10.68:1 |
① |
| 4 | 频道头 860×52;标题 16px/600 #060607;成员数 12px/500 #5c5e66 |
头高 52 → 48px(与侧栏头、任务列头对齐到同一档,8px 网格);标题 --foreground #262626(15.13:1);成员数 --muted-foreground #666666(5.36:1),数字部分换 --font-mono |
③ + ① |
| 5 | 输入区 textarea 628×33 无边框,外层容器只有上边框 rgb(220,222,225);工具按钮 28×28 |
输入区上边框改 --border #e3e3e3;textarea 用官方 <Textarea>(textarea.tsx:14,rounded-lg border-input,边框 3.14:1);工具按钮 28px 正好是官方 Button size="icon-sm"(size-7 = 28px,`button.tsx:32) —— 无需自定义尺寸 |
① + ② |
| 6 | 消息悬停动作(点赞 / 回复 / 更多 / 图片预览 / 阅读状态「0 人已读,4 人未读」) | 一律 <Button variant="ghost" size="icon-sm">(ghost 的 hover 走 hover:bg-muted,白画布上 1.15:1 可辨);十条并排的 emoji 反应改用官方 Bubble/Badge 承载计数,video/图片预览沿用官方 <Dialog> |
② |
| 7 | 悬停时 --shadow-e1 类浮起效果散布在气泡与卡片上 |
页面容器层不出现阴影:气泡/卡片/弹窗靠 Card/Dialog 自带的 ring-1 ring-foreground/10(card.tsx:16、dialog.tsx:37)分界。注:--shadow-e1..e3 令牌本身保留不动,只是不再被页面容器层消费 |
① ③ |
| 8 | 频道内 Tab(channel-tabs.tsx),实测圆角 10px/8px 混用 |
用官方 <Tabs>:主切换用 variant="line"(tabs.tsx:33:bg-transparent、rounded-none)——直角 tab 正是参考的 do 规则;次级分段用 variant="default"(bg-muted)。圆角随 --radius 收到 4px / 3.2px |
② + ① |
| 9 | @提及硬编码 #3370FF(chat-mention.ts)、#006ce7(message-list.tsx 等) |
--mention = --brand-ink = #1a4db8,画布 7.01、卡片 7.51;--surface-chat-soft #eef3fc 上的引用块 6.74:1。三种蓝收敛成一支蓝的两档明度 |
① |
S3 任务大厅与任务卡
关键文件:task-hall.tsx(已读 1219–1275 段)、group-hall.tsx、create-task-dialog.tsx、channel-work-items.tsx。
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 任务状态 chip 是手写 <span className="rounded-full border px-1.5 py-0.5 font-medium" + statusChipClass(task)>(task-hall.tsx:1246-1254),配色走 toneChipClasses 的 Tailwind 原始调色板(border-rose-200 bg-rose-50 text-rose-700 / border-amber-200 bg-amber-50 text-amber-800) |
全部换成官方 <Badge>(badge.tsx,h-5 / rounded-4xl / text-xs):· 待补充 = variant="ghost"· 待处理 = variant="outline"· 进行中 = variant="default"(品牌填充蓝)· 待验收 = variant="secondary"· 已完成 = variant="outline" + lucide CheckCheck· 已关闭 = variant="ghost" + lucide CircleSlash· 逾期/风险 = variant="destructive"同 variant 的两对(待处理/已完成、待补充/已关闭)用 lucide 图标形状双编码——图标是内容不是样式覆盖,合规 |
② |
| 2 | 难度 chip、招聘状态 chip、BOT 代发 标记同样手写(task-hall.tsx:1243、1260、1266-1274) |
难度 = <Badge variant="outline">;招聘状态 = <Badge variant="secondary">;标记 = <Badge variant="outline"> + lucide Sparkles(该图标已在 task-hall.tsx 使用) |
② |
| 3 | 卡片圆角实测两套:10px ×48、8px ×37 |
全部由 --radius: 0.25rem 驱动:Card size="sm" = --radius-xl = 5.6px;内部 chip = 4px / 胶囊。12 档圆角收敛到 3 档(4 / 5.6 / 10) |
① |
| 4 | 任务卡标题 14px/500;卡片内边距不统一;频道 chip + AI 助手 chip + 查看任务 + 负责人 挤在一行 |
卡片改用官方 <Card size="sm">(card.tsx:--card-spacing: --spacing(3) = 12px 内边距,gap-(--card-spacing)),与 8px 网格对齐;查看任务 用 <Button variant="link" size="xs">(h-6、text-xs)——参考的 “Default link color… do not style links as buttons” 对应到 shadcn 就是 link variant |
② + ③ |
| 5 | 看板列头「待补充 0 / 待处理 5」;筛选「全部频道 / 5 项任务」 | 列头计数换 --font-mono + tabular-nums;筛选条用 <Tabs variant="line"> + <Badge variant="secondary"> 承载计数 |
② |
| 6 | 群聊大厅是营销式 hero 段落 + 「全部群聊 / 全部 / 已加入 / 未加入」筛选 + 群卡片(S3-group-hall 实测,品牌蓝 rgb(37,99,235) 出现 20 处) |
删掉 hero 段落(参考的营销构件一律不迁移),改为两段式:筛选条(sticky,48px)+ 卡片网格。品牌蓝出现次数从 20 处降到「主按钮 + 选中态」≤ 4 处 | ③ + ① |
| 7 | 卡片网格列宽不定 | grid gap-3,列数按容器断点 3 / 2 / 1;任务卡最小宽 320px(0.25rem 圆角下 320px 宽 + 12px padding 读起来方正) |
③ |
| 8 | 状态色语义缺失:6 个业务状态 + 逾期,无统一规则 | 状态色预算 = 2 支:--brand(进行中/默认填充)与 --destructive(逾期/风险/危险操作);其余状态一律「背景反转 + 字重 + 图标」。这正是参考 “Do not stack more than one chromatic color in a single component” 的落地 |
① ② |
S4 AI 助手频道
关键文件:agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx、channel-summary-panel.tsx。实测该空间有 395 项任务,是全站最密集视图。
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 单次渲染内 4 个字号档位:12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724 |
12.8px 全部来自官方 Button size="sm" 的 text-[0.8rem](button.tsx:26)——改用 size="xs"(12px) 或 size="default"(14px),2 个档位消失,只剩 12 / 14 两档 |
② |
| 2 | 圆角 8px ×1591、10px ×844 两套混用 |
--radius: 0.25rem → 卡片 5.6px、chip/按钮 4px,两档有固定角色(面板 vs 控件) |
① |
| 3 | 流式回答的等待态、来源引用、结果卡片 | 等待态用官方 <Skeleton>(已装 skeleton.tsx);来源引用用 <Badge variant="outline">;结果列表行用官方 <Item> / <ItemContent>(已装 item.tsx)替代手写 div 行,行间距交给 --card-spacing |
② |
| 4 | 密集小字 12px 用 --muted-foreground #5c5e66 |
#666666:画布 5.36:1(旧值在 #fcfcfc 上 5.6:1,改动后仍达标) |
① |
| 5 | 结果卡片与消息气泡在同一个滚动流里,宽度铺满 | 统一 max-width: 720px 阅读列;结果卡片用 <Card size="sm"> + 网格 2 列(≥1024px) |
③ |
| 6 | 品牌蓝在流式回答、来源、按钮、链接里各出现一次 | 流式/来源/链接统一为 --brand-ink #1a4db8(文字档),只有「发送/重试」是 --brand #1f5fd0 填充档 |
① |
S5 管理与设置弹窗
关键文件:space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx、channel-permission-picker.tsx。实测 [role=dialog] 704×512、圆角 18px、背景 #ffffff。
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 弹窗 704×512、圆角 18px(= --radius-2xl = 1.8×10) |
圆角随 --radius 收到 7.2px;宽高改为 max-w-[40rem] + max-h-[min(88vh,44rem)],与 task-hall.tsx:687 已有的弹窗规格统一 → 全站弹窗只剩一种尺寸语法 |
① + ③ |
| 2 | 左侧导航项 135×36 圆角 8px,选中态 background --brand-soft(0.12) + 前景 --brand-ink #1d4ed8;危险项前景 --destructive #da373c |
导航项改用官方 <Button variant="ghost">(button.tsx:17 已内置 aria-expanded:bg-muted aria-expanded:text-foreground)—— 选中态由官方状态语法表达,不再是「品牌软底」;危险项用 variant="destructive"(bg-destructive/10 text-destructive)。--brand-soft 降到 0.10 仅保留给侧栏/列表选中 |
② + ① |
| 3 | 输入框 488×32 圆角 10px | 已经等于官方 <Input> 的 h-8(32px);只需把圆角交给 --radius(10 → 4px),并把边框换成 --input #8c8c8c(白卡上 3.36:1) |
① |
| 4 | 表单标签 14px;成员列表行高不定 | 标签用官方 <Field> / <FieldLabel>(已装 field.tsx),间距交给 gap;成员列表用官方 <Item> + <Avatar size="sm">(avatar.tsx 的 sm = 24px),角色徽标用 <Badge variant="outline">(群主 / 管理员 / 研发 / 产品 / pmo) |
② |
| 5 | 危险项前面是红色文字 | 颜色 + 图标双编码:variant="destructive" + lucide TriangleAlert |
② |
| 6 | 弹窗内点选权限(channel-permission-picker) |
官方 <Checkbox>(已装)+ <Field>;勾选态用默认品牌蓝,不用自绘 |
② |
| 7 | 弹窗背景纯白 #ffffff,与卡片同色 |
保留(--popover: #ffffff);分界靠 dialog.tsx:37 自带的 ring-1 ring-foreground/10,不加阴影 |
① |
S7 登录页
关键文件:web/src/routes/login.tsx、sign-in.$.tsx。实测:居中卡片、主标题 26px、切换块 173×42(选中态背景 --background #fcfcfc + 品牌蓝文字)、主按钮 356×52 白字 #2563eb、页脚 11px。
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 主按钮 #2563eb + 白字 = 4.86:1 |
--brand: #1f5fd0 + #ffffff = 5.82:1,按钮文字对比度提一档 |
① |
| 2 | 页面无画布色(main 背景 rgba(0,0,0,0)),卡片边界靠不确定的父级 |
画布 --background #f7f7f7,卡片 --card #ffffff(1.07:1)+ Card 自带 ring-1 ring-foreground/10;「白卡浮在浅灰画布上 + 描边」是参考 Surface 表的同构做法 |
① |
| 3 | 「邮箱验证码 / 短信验证码」切换块 173×42,选中态是 --background 白底 + 品牌蓝文字 |
改用官方 <Tabs variant="default">(tabs.tsx:28 rounded-lg p-[3px],选中项由 --muted/--card 承托)。关键纪律:品牌蓝不再作为「切换控件选中文」的文字色——参考明令 #0b6ec5 “Do not use… as a filled button or CTA background — it is link color only”,同理蓝色只在大面积填充按钮上出现 |
② + ① |
| 4 | 主按钮 356×52(52 落在 8px 网格外) | 用官方 <Button size="lg">(h-9 = 36px)+ tap-target 工具类(styles.css:236-254,粗指针下扩到 44px 命中区);宽度保留 352px(max-w-[22rem]) |
② + ③ |
| 5 | 主标题 26px、页脚 11px | 标题 24px(参考 heading-sm 24px)或 32px(参考 heading);页脚 ≥12px(简报中文最小 12px),颜色 --muted-foreground #666666(白卡 5.74:1) |
③ (字号需动 className,见 §8 越界项) |
| 6 | 文案「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」 | 文案不动;@example.com 域名后缀本就符合本方案「域名/邮箱/ID 用 --font-mono」的分工 |
① |
| 7 | 登录表单输入框 | 官方 <Input>(h-8,边框 --input #8c8c8c = 白卡 3.36:1);「获取验证码」用 <Button variant="outline" size="sm"> |
② |
S8 应用中心
关键文件:app-center.tsx、assistant-board.tsx。实测:分类筛选 8 类 + 「共 14 个应用」+ 卡片(运行中 / 开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息)。
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 应用/助手图标用 emoji(app-center.tsx:532、1195 的 iconEmoji;workspace-rail.tsx:204 也把 emoji 渲染成 text-2xl) |
改用 lucide 图标(components.json 的 iconLibrary: lucide)+ 官方 <Avatar size="sm">(24px)/ <AvatarFallback>,Avatar 自带 ring-2 ring-background 与状态角标(avatar.tsx:61)。这是本方案最大的视觉一致性收益:emoji 在中文界面里字重/色相完全不可控,与「一档蓝一档红」的纪律直接冲突 |
② |
| 2 | 运行中 / 开发中 徽标 |
官方 <Badge variant="secondary">(运行中)/ <Badge variant="outline">(开发中),各配 lucide 状态图标 |
② |
| 3 | 元信息 Agent · 第三方 · chat 用「·」文本连接 |
分隔符改用官方 <Separator orientation="vertical">(separator.tsx,bg-border)—— 参考的 “hairline borders, nav separators” 的原生用法;文字用 --muted-foreground #666666 |
② + ① |
| 4 | 分类筛选「全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公」横向排布 | 官方 <Tabs variant="line"> 横向可滚动(overflow-x-auto),直角 tab 回到参考 do 规则 |
② + ③ |
| 5 | 卡片网格列数不定 | grid gap-4,3 / 2 / 1 列断点;卡片用 <Card size="sm">;「共 14 个应用」计数换 --font-mono |
③ |
S6 语音频道 / 通话(依据是代码与库内数据,不是截图)
- 事实:本栈
TRTC_ENABLED=false,界面一个语音元素都不渲染(DOM 内aria-label匹配「语音|通话|加入」命中 0,正文不含「语音」),/api/v1/rtc/*返回RTC_DISABLED;但库里wanman3_rtc_voice_channels有 30 行(空间 395/396/398/399 各有 active 语音频道)、wanman3_rtc_calls183 行、会议纪要 20 行。以下建议全部基于web/src/components/app/rtc-group-call-ui.tsx(含 9 处variant="custom")的代码结构推演,未做任何渲染取证。 - 【②】成员状态:官方
<Avatar>+AvatarBadge(avatar.tsx:61,bg-primary,sm/default/lg自动缩放角标),状态色用--brand(发言中,5.44:1 图形对比)与--muted-foreground(静音)。 - 【②】连接态五档(
已连接 / 连接中 / 重连中 / 已断开 / 连接失败)用官方<Badge>:default / outline / outline / ghost / destructive。 - 【①】通话面板底色用
--card #ffffff(深色#1a1a1a),成员网格用--border #e3e3e3发丝线分隔,不引入阴影。 - 【③】面板固定右侧 320px 栏(与 8px 网格对齐),成员网格 2 列。
深浅色与对比度
对比度用 WCAG 相对亮度公式自算((L1+0.05)/(L2+0.05)),全部为本方案取值。
浅色
| 组合 | hex | 比值 | 是否达标 |
|---|---|---|---|
| 正文 on 画布 | #262626 on #f7f7f7 |
14.13 | ✅ ≥4.5 |
| 正文 on 卡片 | #262626 on #ffffff |
15.13 | ✅ |
| 次级文字 on 画布 | #666666 on #f7f7f7 |
5.36 | ✅ |
| 次级文字 on 卡片 | #666666 on #ffffff |
5.74 | ✅ |
次级文字 on --muted |
#666666 on #efefef |
4.99 | ✅(参考 Graphite #737373 在此只有 4.34,故下沉取值) |
| 卡片正文 on 卡片 | #262626 on #ffffff |
15.13 | ✅ |
| 弹窗正文 on 弹窗 | #262626 on #ffffff |
15.13 | ✅ |
次级按钮文字 on --secondary |
#262626 on #ececec |
12.81 | ✅ |
| 品牌填充按钮文字 | #ffffff on #1f5fd0 |
5.82 | ✅ |
| 品牌文字档 on 画布 | #1a4db8 on #f7f7f7 |
7.01 | ✅ |
| @提及 on 卡片 | #1a4db8 on #ffffff |
7.51 | ✅ |
| @提及 on 引用底 | #1a4db8 on #eef3fc |
6.74 | ✅ |
--ink on 画布 |
#111111 on #f7f7f7 |
17.63 | ✅ |
| 危险/逾期文字 on 画布 | #c0392b on #f7f7f7 |
5.08 | ✅ |
| 危险/逾期文字 on 卡片 | #c0392b on #ffffff |
5.44 | ✅ |
| 危险文字 on 自消息气泡 | #c0392b on #e8eefb |
4.68 | ✅ |
| 自消息文字 on 自消息气泡 | #123156 on #e8eefb |
11.29 | ✅ |
| 侧栏正文 on 侧栏 | #262626 on #ffffff |
15.13 | ✅ |
侧栏选中行文字 on --sidebar-accent |
#262626 on #efefef |
13.16 | ✅ |
| 边界 输入框边框 vs 卡片 | #8c8c8c vs #ffffff |
3.36 | ✅ ≥3:1(WCAG 1.4.11) |
| 边界 输入框边框 vs 画布 | #8c8c8c vs #f7f7f7 |
3.14 | ✅ |
| 边界 品牌图形 on 画布 | #1f5fd0 on #f7f7f7 |
5.44 | ✅ |
| 边界 侧栏图标 on 侧栏 | #6b6b6b on #ffffff |
5.33 | ✅ |
| 边界 rail 图标 on 侧栏 | #4d4d4d on #ffffff |
8.45 | ✅ |
| 装饰 侧栏分界线 vs 侧栏 | #c1c1c1 vs #ffffff |
1.80 | ⚪ 装饰性发丝线(1.4.11 豁免),但已明显高于现状 1.11 |
| 装饰 列表发丝线 vs 卡片 | #e3e3e3 vs #ffffff |
1.28 | ⚪ 同上 |
| 层级步进 侧栏 vs 画布 | #ffffff vs #f7f7f7 |
1.07(+ 1.80 的线) | ⚪ 参考以发丝线而非明度差承担层级 |
| 层级步进 卡片 vs 画布 | #ffffff vs #f7f7f7 |
1.07 | ⚪ |
| 层级步进 rail vs 侧栏 | #e9e9e9 vs #ffffff |
1.21 | ⚪ |
hover 底 --muted vs 侧栏 |
#efefef vs #ffffff |
1.15 | ⚪ 交互反馈 |
hover 底 --sidebar-accent vs 侧栏 |
#efefef vs #ffffff |
1.15 | ⚪ |
深色
| 组合 | hex | 比值 | 是否达标 |
|---|---|---|---|
| 正文 on 画布 | #e8e8e8 on #121212 |
15.29 | ✅ |
| 正文 on 卡片 | #e8e8e8 on #1a1a1a |
14.20 | ✅ |
| 次级文字 on 画布 | #a0a0a0 on #121212 |
7.16 | ✅ |
| 次级文字 on 卡片 | #a0a0a0 on #1a1a1a |
6.66 | ✅ |
次级文字 on --muted |
#a0a0a0 on #232323 |
6.01 | ✅ |
| 卡片正文 on 卡片 | #f0f0f0 on #1a1a1a |
15.27 | ✅ |
次级按钮文字 on --secondary |
#ededed on #262626 |
12.93 | ✅ |
| 品牌填充按钮文字 | #0d0d0d on #5aa2f0 |
7.28 | ✅ |
| 品牌文字档 on 画布 | #93c0f7 on #121212 |
9.92 | ✅ |
| @提及 on 卡片 | #93c0f7 on #1a1a1a |
9.22 | ✅ |
| @提及 on 引用底 | #93c0f7 on #1a2734 |
8.04 | ✅ |
--ink on 画布 |
#f0f0f0 on #121212 |
16.44 | ✅ |
| 危险/逾期文字 on 画布 | #ff6b5e on #121212 |
6.71 | ✅ |
| 危险/逾期文字 on 卡片 | #ff6b5e on #1a1a1a |
6.23 | ✅ |
| 危险文字 on 自消息气泡 | #ff6b5e on #1b3049 |
4.80 | ✅ |
| 自消息文字 on 自消息气泡 | #d7e7fb on #1b3049 |
10.68 | ✅ |
| 侧栏正文 on 侧栏 | #e8e8e8 on #1a1a1a |
14.20 | ✅ |
侧栏选中行文字 on --sidebar-accent |
#f5f5f5 on #262626 |
13.88 | ✅ |
| 边界 输入框边框 vs 卡片 | rgb(255 255 255/0.36) → #6c6c6c vs #1a1a1a |
3.31 | ✅ |
| 边界 输入框边框 vs 画布 | → #676767 vs #121212 |
3.31 | ✅ |
| 边界 品牌图形 on 画布 | #5aa2f0 on #121212 |
7.01 | ✅ |
| 边界 侧栏图标 on 侧栏 | #a0a0a0 on #1a1a1a |
6.66 | ✅ |
| 边界 rail 图标 on 侧栏 | #c0c0c0 on #1a1a1a |
9.57 | ✅(现状该令牌在 .dark 未覆盖,深色下仅 1.6:1,是实测「27 处 rgb(92,94,102) 不可读」的成因之一) |
| 装饰 发丝线 vs 卡片 | rgb(255 255 255/0.16) → #3f3f3f vs #1a1a1a |
1.65 | ⚪ 装饰性 |
| 层级步进 卡片 vs 画布 | #1a1a1a vs #121212 |
1.08 | ⚪ |
| 层级步进 侧栏 vs 画布 | #1a1a1a vs #121212 |
1.08 | ⚪ |
| 层级步进 rail vs 侧栏 | #0b0b0b vs #1a1a1a |
1.13 | ⚪(修掉现状「深色下 rail 是一条浅色竖带」) |
hover 底 --muted vs 卡片 |
#232323 vs #1a1a1a |
1.11 | ⚪ |
hover 底 --sidebar-accent vs 侧栏 |
#262626 vs #1a1a1a |
1.15 | ⚪ |
结论:浅色 18 组文字组合全部 ≥4.5:1,深色 18 组全部 ≥4.5:1;两套各有 5 组边界组合 ≥3:1。装饰性发丝线与层级步进不适用 1.4.11,但也逐条给出实测比值以免「看起来偏灰」这类空话。
shadcn 兼容性
结论:不需要引入任何新组件。 web/src/components/ui/ 现有 38 个官方组件已覆盖本方案全部构件,且版本是 base-nova 风格(web/components.json:"style": "base-nova"、baseColor: neutral、iconLibrary: lucide,与本方案的中性基调一致)。
本方案用到的官方组件与 variant/size(全部为代码里已存在的枚举值):
| 组件 | 文件 | 用到的官方 variant/size | 用在哪 |
|---|---|---|---|
Button |
button.tsx:10-34 |
default / outline / secondary / ghost / destructive / link;xs / sm / default / lg / icon-sm |
主按钮、查看任务、工具条、弹窗导航、危险操作 |
Badge |
badge.tsx:10-21 |
default / secondary / destructive / outline / ghost |
任务状态、角色、难度、招聘状态、应用徽标、连接态 |
Bubble |
bubble.tsx:19-41 |
secondary / tinted / ghost / outline / destructive |
他人气泡、自己气泡、纯文本消息 |
Card |
card.tsx |
size="default" | "sm" |
任务卡、应用卡、结果卡 |
Dialog / AlertDialog |
dialog.tsx:37 |
官方默认 | 设置弹窗、确认框 |
Input / Textarea |
input.tsx:11、textarea.tsx:14 |
官方默认(h-8、rounded-lg) |
搜索、表单、输入区 |
Tabs |
tabs.tsx:28,32 |
variant="default" | "line" |
频道 tab、登录切换块、应用中心分类 |
Avatar |
avatar.tsx |
size="sm" | "default" | "lg"、AvatarBadge |
应用图标、成员、语音成员 |
Separator |
separator.tsx |
orientation="horizontal" | "vertical" |
元信息分隔、rail 分隔、列表分隔 |
Item / Field / Checkbox / Skeleton / ScrollRegion / Tooltip / DropdownMenu |
均已装 | 官方默认 | 列表行、表单、权限勾选、加载态、滚动、菜单 |
已装但本方案刻意不用的组件:calendar.tsx、table.tsx、accordion.tsx、collapsible.tsx(S1 侧栏频道树仍用 collapsible,保留)、popover.tsx(保留给日期/成员选择)。
越界项清单(不合规风险,必须显式标注)
以下改动不属于①②③任何一条途径,本方案不把它们算作「已达成」,实施前需要单独授权:
| # | 越界内容 | 硬证据 | 风险等级 | 不做的后果 |
|---|---|---|---|---|
| R1 | variant="custom" 逃生口共 215 处 / 65 文件(group-members.tsx 16、task-hall.tsx 12、message-list.tsx 12、space-manage-dialog.tsx 11、create-task-dialog.tsx 11、channel-work-items.tsx 11、rtc-group-call-ui.tsx 9…) |
button.tsx:50-57:variant === "custom" ? className : cn(buttonVariants(...)) —— 走 custom 时整条官方样式链(颜色、尺寸、圆角、hover、focus、disabled)全部被 app 自己的 className 接管 |
高(阻断级) | 令牌改得再准,这 215 个按钮也不会变;方案在这些位置等于只生效一半。这是本方案最大的实施依赖:必须把这些按钮逐一映射回官方 variant/size,且这属于「改组件 className」,越出①②③ |
| R2 | 任意值字号 232 处 / 73 文件(text-[11px]×82、text-[13px]×67、text-[15px]×22、text-[10px]×20、text-[12px]×12、text-[12.5px]×6、text-[13.5px]×5、text-[9px]×2) |
grep -rEo 'text-\[[0-9.]+(px|rem)\]' 统计 |
高 | §5 的「5 档字号阶梯」无法通过令牌达成;其中 10px ×20、9px ×2 直接违反简报「中文最小 12px」 |
| R3 | Tailwind 原始调色板 253 处 / 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) | 简报 §3.3 泄漏普查 | 高 | 深色下完全不翻转;「一档蓝一档红」的彩色纪律在深色下破功 |
| R4 | 硬编码 bg-white 57 处 |
grep -rn '\bbg-white\b' |
中 | 深色下出现 57 处白色块 |
| R5 | 头像首字 50/700 硬编码(amber rgb(255,251,235)/rgb(187,77,0)、rose、blue、emerald、teal 五组) |
简报 §3.3 | 中 | 深色下仍是浅色块;应改为 --muted/--muted-foreground 或 --brand-soft/--brand-ink 组合 |
| R6 | .dark 不可达:全仓 web/src 无任何代码给 <html> 加 .dark,localStorage 无主题键,color-scheme: normal |
简报 §3.3 实测 | 高(前置条件) | 深色令牌虽已给全,但用户看不到。本方案的深色部分需先补一个主题开关(改 web/src 代码)才可验证 |
| R7 | 硬编码色残留:#006ce7(message-list.tsx、composer-markdown.ts、voice-channel-history-dialog.tsx)、#3370FF(chat-mention.ts)、chrome.ts#f06f66、tone.ts#23a55a/#f0b232、image-preview-dialog.tsx#f2f3f5、file-preview/* 与 spreadsheet/SpreadsheetPreview.tsx 整套 |
简报 §3.3 | 中 | 与 --mention/--brand/--destructive 的收敛目标冲突 |
| R8 | 3 个蓝 收敛依赖把 --mention 与 --brand-ink 置为同一 hex,但 chat-mention.ts 里 #3370FF 是硬编码 |
同上 | 中 | 需改 chat-mention.ts 一行 |
| R9 | 不引入新令牌:本方案想做但受「只含真实存在变量名」约束而放弃的项:字号令牌(--text-*)、letter-spacing 令牌、任务状态色令牌(如 --status-progress) |
styles.css 的 @theme inline 里只有 --font-* / --radius-* / --shadow-* / --animate-* / --color-*,没有任何 --text-* / --tracking-* |
中 | 字号阶梯只能靠 ② 官方 size 变体收敛;状态色只能复用 --brand/--destructive |
| R10 | --shadow-e1..e3 / --shadow-pop 四步阴影阶梯保留不动(不删令牌),但要求页面容器层不消费 |
styles.css:42-52 |
低 | 若实施者继续在卡片/气泡上用 shadow-e1,参考的「平面无高程」规则失效;这属于「官方 className 里的 shadow 类」,不是令牌能管的 |
合规性自评:本方案所有视觉改观都能由 ①(令牌取值)+ ②(官方 variant/size)+ ③(容器布局)解释;但要让改动在 1440×900 上「肉眼可见地全站生效」,必须先清掉 R1(215 处 custom variant)——它不属于三条途径,因此在 R1 未处理前,本方案按「部分达成」记。
实施成本
改动面
| 层 | 文件 | 规模 |
|---|---|---|
| 令牌层(本方案主体) | web/src/styles.css::root(108–161 行,约 45 行改写)、.dark(163–211 行,约 40 行改写)、@theme inline(32–39 行,2 行字体栈) |
≈ 90 行,1 人 1 天(含对比度复算) |
| 官方组件替换 | task-hall.tsx(状态/难度/招聘 chip → Badge,约 5 处 + statusChipClass 函数 176–183 行可删)、app-center.tsx(emoji → lucide + Avatar)、channel-sidebar.tsx / app-shell.tsx(rail/侧栏状态 → Badge) |
≈ 3 文件 / 15 处,0.5 人天 |
| 容器布局(③) | 阅读列 max-width: 720px、头部 52→48px、卡片网格断点、弹窗尺寸统一(task-hall.tsx:687 已有范式)、Tabs line 化 |
≈ 8 文件,1 人天 |
| 前置阻塞项 | R1 的 215 处 variant="custom" 回归官方 variant |
65 文件 / 215 处,3–5 人天,且需要设计 + 前端逐处对齐 |
| R2/R3/R4/R5/R7 | 字号任意值 232 处、调色板 253 处、bg-white 57 处、头像色 5 组、硬编码色 8 处 |
5–8 人天 |
| R6 | 主题开关(<html>.dark + localStorage + 系统偏好) |
0.5 人天 |
总估:只做令牌 + 首选组件替换 ≈ 3 人天(可见度约 60%);做到「全站真的一致」需 ≈ 12–16 人天。
风险清单
- R1 是唯一阻断级风险:215 处 custom variant 让令牌改动在这些位置完全不生效。
--radius是全局杠杆:从 10px 改到 4px 会同时影响 38 个官方组件 + 全站手写圆角类;需回归检查Badge(2.6× → 10.4px 会被钳到 10px,视觉变成胶囊,符合预期)、Card(1.4× → 5.6px)、TabsList(4px)三处是否符合预期。--input从#dcdee1提到#8c8c8c是视觉上最「重」的一处改动(对比度要求所致);如果不接受,替代方案是保留浅边框并依赖组件自带的focus-visible:ring-3,但那会使非焦点输入框不满足 1.4.11,需产品侧决策。- 深色下
--sidebar: #1a1a1a与--card: #1a1a1a同值(参考的做法):侧栏与卡片同时出现在屏幕上时会「同色相连」,需要--sidebar-border足够可见(已给 1.65:1)来维持分界。 - 中文回退顺序改动(PingFang SC 提前)会让 Windows 上的中文从「Noto Sans SC」变成「Microsoft YaHei」——两者字形宽度不同,需要回归一次长文本换行。
验证方式(每条都能自证)
| 检查 | 命令/方法 | 期望 |
|---|---|---|
| 令牌生效 | getComputedStyle(document.documentElement).getPropertyValue('--background') |
浅色 #f7f7f7;注入 .dark 后 #121212 |
| 侧栏层级不再为零 | 取 aside 与内容区背景,算对比度 |
侧栏 #ffffff vs 内容 #f7f7f7 = 1.07,且 getComputedStyle(aside).borderRightColor = rgb(193,193,193)(1.80:1) |
| 圆角收敛 | 统计页面内所有元素的 border-radius 去重集合 |
从 12 档 → ≤5 档(0 / 4px / 5.6px / 7.2px / 10px / 9999px) |
| 字号收敛 | 统计文本节点的 font-size 去重集合 |
从 10 档 → ≤7 档(12 / 12.8→消失 / 13 / 14 / 15 / 16 / 24px) |
| 彩色收敛 | 采集所有非 --chart-* 的彩色声明 |
只剩 --brand / --brand-ink / --mention(同 brand-ink) / --destructive / --message-self 四个 hex |
| 深色可读 | 注入 .dark 后统计「前景 rgb(6,6,7) 的元素数」 |
从 55 处 → 0(--foreground 已翻转);rgb(92,94,102) 从 27 → 0(--muted-foreground / --interactive / --channel-icon 已翻转) |
| 对比度回归 | 对 §7 两张表逐条重算 | 全部 ≥4.5 / ≥3,无回归 |
取舍
解决了什么
- 「会话侧栏与页面底色
#fcfcfc完全相同、零层级对比」 → 白侧栏#ffffff+ 画布#f7f7f7+ 1.80:1 的 Fog 发丝线(参考的原生用法)。 - 「同一列表两套字号(15px / 14px)」 → 统一走官方
Bubble的text-sm。 - 「字号 10 档、圆角 12 档、三种蓝并存」 → 字号靠官方 size 变体收敛到 12/14 为主;圆角收敛到 4 / 5.6 / 7.2 / 胶囊;蓝收敛为「填充档
#1f5fd0+ 文字档#1a4db8」。 - 「深色下
--surface-rail是浅色竖带」 →#0b0b0b;并补齐.dark未覆盖的--interactive/--channel-icon。 - 视觉可信度从「阴影 + 色块」换成「排版 + 发丝线」:页面容器层不再有 elevation,彩色预算 = 一档蓝 + 一档红。
牺牲了什么
- 亲和力/温度。无彩画布 + 方正分区在「一线人员、长时段驻留」的场景下偏冷、偏工具化;相比现状的蓝灰渐变 + 飞书式圆角,第一眼不那么「友好」。这是参考风格的固有代价。
- 直接引用参考视觉证据的能力:参考本身没有深色主题,深色是本方案按同一套纪律推导的,不是「采样」的——这是本方案与「有深色参考」的方案相比的先天不足。
- 按钮圆角只有 4px,拿不到参考的
9999px胶囊按钮:Button、Input、TabsList共用--radius-lg(= --radius),改--radius会把三者一起推平。想让按钮变胶囊只能改button.tsx的 className —— 越界,不做。这是本方案对参考规则最大的让位。 - 状态色只剩两支:6 个业务状态压到 5 个官方 Badge variant + 图标双编码,色觉障碍用户与色觉正常用户都能读,但**「一眼扫过去按颜色找任务状态」的效率低于现状的多色 chip**。
- 中文完全没有等宽化:参考「全站等宽」这个 signature 在本产品只保留在数字层,中文界面上不成立。
什么场景下不适用
- 若产品要求「营销化 / 招揽式」的表达(落地页、应用中心推广位、新手引导)——终端风与营销语汇直接冲突,本方案在这些位置等于「没有设计」。
- 若产品要主推深色:本方案深色是推导值且生产不可达,深色优先的方案应在深色参考上另做选型。
- 若实施方无法处理 R1(215 处
variant="custom"):令牌层改动在这些位置不生效,最终会得到「一半是终端手记、一半是原飞书外观」的混合体 —— 此时不应选本方案。 - 若团队不接受把输入框边框从
#dcdee1提到#8c8c8c(对比度 3:1 的代价):本方案的「控件边界 ≥3:1」主张会整体失效,建议改选更宽容边框的方案。