终端手记 · 基于 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 条可迁移规则(引其原文要点):

  1. 单色信息层 + 一个彩色。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 档风险红,品牌蓝永不作为大面积装饰底。
  2. 平面无高程。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 分界。
  3. 圆角纪律是两档而不是一档。Do 原文:“Set border-radius to 9999px on all buttons and tags; 0px on cards, inputs, tabs, and panels.” → 迁移为:用一个 --radius 同时产出「面板方正 + 标签胶囊」(见 §8 的 calc 链论证)。
  4. 排版承担重量,字距收紧。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 且靠字重分档。
  5. 颜色不表达交互状态。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 三档灰),业务状态另立规则(见下)。

不迁移的参考局部(照抄会直接违反产品形态):


适配判断

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

  1. 它本来就诞生在高密度工具场景语境里:等宽 + 发丝线 + 灰度阶,是「数据表、日志、SQL 面板」的语言;wanman 的核心视图恰恰是列表(148 个会话频道 / 1554 条消息 / 457 个任务)与表格化信息(状态、负责人、截止时间、难度、招聘状态),与终端/README 的信息形态同构。
  2. 它把「层级」从美术判断变成规则判断。实测现状的三个具体缺陷——① 会话侧栏 #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、一套发丝线)正好是这三条缺陷的对症解,而且只靠语义令牌就能改掉大半,不需要动组件代码。
  3. 它的彩色克制直接治理实测的「令牌泄漏」。全仓 253 处 Tailwind 原始调色板(amber 69 / rose 68 / slate 44 / emerald 42 …)、头像首字 50/700 配对硬编码、三种蓝并存(--brand #2563eb / 硬编码 #006ce7 / --mention #3370ff)——当设计语言只允许「一档蓝 + 一档红」时,这些散色就都有了明确的收拢目标。
  4. 长时段驻留友好。深色可用、无阴影、无动效噪声(参考 “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;

改动三点:

  1. 删掉 "gg sans":它不在 @fontsource 依赖里、也不是 macOS/Windows 系统字体,是永远命不中的死回退,只是把解析表拉长一档。
  2. 把 "PingFang SC" 提到 "Noto Sans SC" 之前:本仓只 @import "@fontsource-variable/geist"(styles.css:5),没有引入任何中文 Web 字体,"Noto Sans SC" 只有本机装过才有字形;macOS 上把原生苹方放前面,中文才稳定命中(现状实测 body 字号 15px、字体栈里 Geist 无中文字形 → 中文实际走 fallback,但顺序不确定)。
  3. --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。其中:

收敛规则(分两条途径)

任意值字号 text-[11px]/text-[13px]/text-[10px] 的清理不在①②③任何一条途径内(改的是组件 className 的字号),列为 §8 越界项,需要单独授权。

中文与数字的注意点

  1. 中英混排基线:中文(苹方/雅黑)与拉丁(Geist)的 x-height 不同,实测 body 15px 下同一行中文视觉高度比拉丁大 1–2px;参考用 letter-spacing: -0.006em 收紧拉丁。本方案不新增 letter-spacing 令牌(styles.css 里不存在该令牌名),中文侧不需要负字距(汉字本身已满宽),故只在数字串(计数器、时间戳)上保持默认字距 + tabular-nums。
  2. 数字必须等宽:未读计数、任务计数(待补充 0 / 待处理 5)、时间戳(12:01)、任务号都换 --font-mono,避免比例字体下数字跳动(.tabular-nums 已在多处使用,如 notification-drawer.tsx:120,是既有正确实践,保持)。
  3. 中文不做全站等宽:见 §3 舍弃表(240px 会话行 + 16 字文案会爆行)。
  4. --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 语音频道 / 通话(依据是代码与库内数据,不是截图)


深浅色与对比度

对比度用 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 人天。

风险清单

  1. R1 是唯一阻断级风险:215 处 custom variant 让令牌改动在这些位置完全不生效。
  2. --radius 是全局杠杆:从 10px 改到 4px 会同时影响 38 个官方组件 + 全站手写圆角类;需回归检查 Badge(2.6× → 10.4px 会被钳到 10px,视觉变成胶囊,符合预期)、Card(1.4× → 5.6px)、TabsList(4px)三处是否符合预期。
  3. --input 从 #dcdee1 提到 #8c8c8c 是视觉上最「重」的一处改动(对比度要求所致);如果不接受,替代方案是保留浅边框并依赖组件自带的 focus-visible:ring-3,但那会使非焦点输入框不满足 1.4.11,需产品侧决策。
  4. 深色下 --sidebar: #1a1a1a 与 --card: #1a1a1a 同值(参考的做法):侧栏与卡片同时出现在屏幕上时会「同色相连」,需要 --sidebar-border 足够可见(已给 1.65:1)来维持分界。
  5. 中文回退顺序改动(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,无回归

取舍

解决了什么

  1. 「会话侧栏与页面底色 #fcfcfc 完全相同、零层级对比」 → 白侧栏 #ffffff + 画布 #f7f7f7 + 1.80:1 的 Fog 发丝线(参考的原生用法)。
  2. 「同一列表两套字号(15px / 14px)」 → 统一走官方 Bubble 的 text-sm。
  3. 「字号 10 档、圆角 12 档、三种蓝并存」 → 字号靠官方 size 变体收敛到 12/14 为主;圆角收敛到 4 / 5.6 / 7.2 / 胶囊;蓝收敛为「填充档 #1f5fd0 + 文字档 #1a4db8」。
  4. 「深色下 --surface-rail 是浅色竖带」 → #0b0b0b;并补齐 .dark 未覆盖的 --interactive / --channel-icon。
  5. 视觉可信度从「阴影 + 色块」换成「排版 + 发丝线」:页面容器层不再有 elevation,彩色预算 = 一档蓝 + 一档红。

牺牲了什么

  1. 亲和力/温度。无彩画布 + 方正分区在「一线人员、长时段驻留」的场景下偏冷、偏工具化;相比现状的蓝灰渐变 + 飞书式圆角,第一眼不那么「友好」。这是参考风格的固有代价。
  2. 直接引用参考视觉证据的能力:参考本身没有深色主题,深色是本方案按同一套纪律推导的,不是「采样」的——这是本方案与「有深色参考」的方案相比的先天不足。
  3. 按钮圆角只有 4px,拿不到参考的 9999px 胶囊按钮:Button、Input、TabsList 共用 --radius-lg(= --radius),改 --radius 会把三者一起推平。想让按钮变胶囊只能改 button.tsx 的 className —— 越界,不做。这是本方案对参考规则最大的让位。
  4. 状态色只剩两支:6 个业务状态压到 5 个官方 Badge variant + 图标双编码,色觉障碍用户与色觉正常用户都能读,但**「一眼扫过去按颜色找任务状态」的效率低于现状的多色 chip**。
  5. 中文完全没有等宽化:参考「全站等宽」这个 signature 在本产品只保留在数字层,中文界面上不成立。

什么场景下不适用

  1. 若产品要求「营销化 / 招揽式」的表达(落地页、应用中心推广位、新手引导)——终端风与营销语汇直接冲突,本方案在这些位置等于「没有设计」。
  2. 若产品要主推深色:本方案深色是推导值且生产不可达,深色优先的方案应在深色参考上另做选型。
  3. 若实施方无法处理 R1(215 处 variant="custom"):令牌层改动在这些位置不生效,最终会得到「一半是终端手记、一半是原飞书外观」的混合体 —— 此时不应选本方案。
  4. 若团队不接受把输入框边框从 #dcdee1 提到 #8c8c8c(对比度 3:1 的代价):本方案的「控件边界 ≥3:1」主张会整体失效,建议改选更宽容边框的方案。