wanman /app 重设计方案 ·「暖纸橙墨」(slug: hubspot)

交付物:本目录 proposal.md + tokens.css + preview.html。 基线:test@3d35969f,web/ 只读。所有现状数值来自共享简报 §3.3 的 DOM/getComputedStyle 实测与 localtmp/design-render/*.json;对比度为 WCAG 2.x 相对亮度公式实算。 实现途径图例:①语义令牌取值(web/src/styles.css)、②官方 variant/size、③容器 flex/grid 布局与间距。每条改造都标注归属。


方案名与主张

方案名:暖纸橙墨。

一句话主张: 把 wanman 从「蓝灰玻璃 + 三套并存的蓝(--brand #2563eb、硬编码 #006ce7、--mention #3370ff)」搬到「暖纸 + 单点朱橙」的编辑部式企业工具——橙色只标记「你的动作」:自己发的消息、进行中 的任务、主操作按钮、@提及;其余一切走暖中性纸阶。

适用基调:浅色优先。 浅色是主界面(现网唯一可达形态,<html> class 恒为空、color-scheme: normal);深色令牌按同等标准完整给出(--background #0b1a1c / --foreground #f4efe6,全部前景组合 ≥4.5:1),但要能被看见必须先接线主题开关,接线性问题见 §实施成本风险 R1。

主色: 浅色 #c84000(参考 #ff4800 同色相压暗,白字 5.01:1);深色 #ff7a45(画布 6.89:1,配深焦糖字 #2a1206 6.84:1)。


参考提炼

可迁移规则(5 条,均可落到令牌)

# 参考原文要点 迁移到 wanman 的落点
1 Do:“Use Sprout Orange (#ff4800) exclusively for CTAs, active states, brand icons, and functional accents — never for decorative backgrounds”;Don't:“Don't introduce a second chromatic color”(系统只有 2% 色彩度) 把 --brand/--brand-soft/--brand-ink/--message-self/--mention 全部收进橙—焦糖一个色相族;界面里现存的蓝/靛/玫瑰/琥珀 Tailwind 原色(普查 253 处)不再是「第二色」,而是需要被这五个令牌取代的泄漏。
2 Do:“Maintain the 8px radius on all buttons and the 16px radius on all cards and images — this two-radius system is the structural shorthand for the entire UI” --radius 从 0.625rem(10px) 调到 0.714rem(11.42px):rounded-xl 命中 16.0px 整(卡片 / 侧栏 / 任务卡),rounded-lg 落在 11.42px(按钮 / 输入 / 下拉)。shadcn 的 --radius 乘法链无法同时命中 8px 与 16px,取舍见 §取舍。
3 Don't:“Don't use stark white (#ffffff) as a page background — Canvas Cream and Warm Parchment are warmer”;Surfaces 层级:Page Canvas #fcfcfa → Parchment Band #f8f5ee → Peach Wash #fcded2 → Card #fcfcfa --card/--popover 从 #ffffff 撤到暖白 #fffdfb;--background 从 #fcfcfc 改奶油纸 #faf7f2;--sidebar 从 #fcfcfc(= 画布,实测零层级对比)改羊皮纸带 #f2ebdd;--message-self 用 Peach Wash 角色加饱和为 #ffcfae。
4 Elevation:“HubSpot's elevation system is border-based, not shadow-based… no drop shadows, no blur effects, no floating panels — the depth is created entirely by the warm-on-warm surface stack” 侧栏与画布的分离不靠 --shadow-e*,靠纸阶差(#f2ebdd vs #faf7f2 = 1.11:1)。--shadow-e1..e3/--shadow-pop 沿用原值不动。
5 Typography:Sans 只用 300/400/500 三档字重,层级由字号与 family 承担(“Weight 300 for light labels, 400 for body, 500 for emphasis”) 中文栈下收敛为 400 / 500 / 600 三档(中文在 300 会发虚,改用 400 承担「轻标签」);标题层级只许靠字号 + 字重 + 颜色,不许靠新增字体族(见下「舍弃项」)。

明确舍弃的参考规则

参考规则 舍弃原因
HubSpot Serif 单字重 500、≥24px 标题,“the serif/sans split is the system's signature contrast” 本仓字体依赖只有 @fontsource-variable/geist(web/package.json,且 Geist 无中文字形),无任何衬线中文字体。引入 Noto Serif SC / Source Han Serif 子集体量约 1.5–3 MB,且「≥24px 才允许用衬线」与本产品 14–15px 正文密度(简报 §3.2:正文 15px、次级 11.25–13px)正面冲突。层级改由字号 + 字重承担。注: web/src/styles.css:32 已有 --font-heading: var(--font-sans) 钩子,若日后决定引入中衬线,可在此一行切换(不在本方案内)。
Page max-width 1200px、Section gap 64–80px、卡片 padding 24–32px 那是营销落地页的宽度模型。本产品是 1440×900 下的三栏高密度工具:rail 72px + 会话侧栏 256px + 内容区 860px(简报 §3.3 实测)。
Hero 全幅照片、Partner Logo Strip、Sprocket Gradient(0.3 透明度色斑) 无营销 hero 场景;色斑叠在消息列表背后会直接压低文字对比度。
Quick Start 里 “primary action…9999px radius” 的药丸按钮 与参考自身 Do 的「8px 按钮圆角」矛盾,且本栈 Badge 官方已经是 rounded-4xl 药丸形,按钮再药丸化会让两者不可区分。
Deep Teal #042729 作为「深色特色区块」 本产品没有「特色区块」,但它的色相被采纳为深色主题画布(#0b1a1c),而不是作为中段色带插入浅色页面。

适配判断

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

  1. 单点强调色正好对上任务状态的「一强多弱」结构。 任务状态共 6 档(待补充 / 待处理 / 进行中 / 待验收 / 已完成 / 已关闭,简报 §3.3),其中只有 进行中 需要抢注意力。HubSpot 的色彩纪律(唯一彩色只给 CTA / active state)天然就是一个「1 个高强调 + 一组中性」的两级色系统,比现在蓝灰底上又要表达被选中的蓝、又要表达风险的玫瑰红、又要表达进度的琥珀黄要干净得多。
  2. 暖中性纸阶直接修掉实测到的「零层级对比」缺陷。 简报 §3.3:会话侧栏 background #fcfcfc 与页面底色 --background:#fcfcfc 完全相同,只能靠 border-radius 14px 提示自己是一块面板。改成画布 #faf7f2 → 侧栏羊皮纸 #f2ebdd(1.11:1)→ 卡片暖白 #fffdfb(对侧栏 1.17:1)后,三层层级不依赖阴影与描边就能读出来(替代掉的正是 --shadow-e1..e3 那套「Soft UI Evolution」)。
  3. 暖底比蓝灰底更适合长时段驻留。 现网左侧竖带是 --surface-rail #e1e8f2 → #e1e5f1 的蓝灰渐变(styles.css:127-129),且 --border rgba(220,222,225,0.55) 与 --border 令牌不同源。暖纸底(R>G>B)把整条竖带的短波占比降下来,同时让唯一的橙强调成为画面上唯一的高饱和信息。
  4. 橙色天然贴合「你的动作」语义。 自己发的消息(右侧气泡)、主操作(新建任务 / 登录)、@提及、进行中——都是「与我相关」。把这些统一成橙,用户在多频道切换时只需扫橙色就能定位自己的位置。这比现在「自己的消息是浅蓝 #e8f3fe、@提及是另一种蓝 #3370ff、品牌又是第三种蓝 #2563eb」的三蓝并存要好读。

舍弃项(明确不做)

舍弃 原因
衬线标题(参考的签名对比) 见 §参考提炼「明确舍弃」。无中文字形可用的衬线字体,且引入体积与本产品密度冲突。
营销页结构(hero / logo strip / 1200px max-width / 64–80px 段间距 / 大卡片 padding) 设计对象是 1440×900 常驻的多栏工具,不是滚动叙事的落地页。
0.3 透明度的品牌渐变色斑 叠在高密度列表底下会削弱文字对比度;本方案的「暖」由纸阶承担,不由色斑承担。
药丸形主按钮(9999px radius) 与参考自身 8px 按钮规则冲突,且会和官方 Badge(rounded-4xl)混淆。
阴影阶梯(--shadow-e1..e3 / --shadow-pop) 值沿用原文不动:纸阶已经完成层级表达,再叠阴影会得到「纸 + 玻璃」的杂交观感,违反参考的 elevation 规则。
深色主题当作可交付成果 简报 §3.3 实测:全仓 web/src 无任何代码添加 .dark,localStorage 无主题键,<html> class 恒为空,color-scheme: normal。深色令牌齐备且对比度达标,但当前生产不可达。web/package.json 已依赖 next-themes@^0.4.6,接线是后续工作(§实施成本 R1)。
修复 253 处 Tailwind 原色泄漏 / 55 处硬编码 rgb(6,6,7) / 三套圆角硬编码(10px×48、8px×37) 那是组件文件里的 className 硬编码,属于改 web/ 源码,超出本方案「只改令牌 + 官方 variant + 容器布局」的约束。见 §shadcn 兼容性与 §实施成本风险 R2/R3。

令牌映射

覆盖简报 §5.1 第 4 条列出的全部变量名。--primary: var(--brand)、--primary-foreground: var(--brand-foreground)、--ring: var(--brand)、--sidebar-primary: var(--brand) 是引用式赋值,沿用原文的引用形态,取值随 --brand 联动。所有建议值见本目录 tokens.css。

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

变量名 当前值 建议值 意图
--background #fcfcfc #faf7f2 画布从冷中性灰白换奶油纸(R>G>B),长时段驻留更暖;也为侧栏留出可辨的层级差
--foreground #060607 #1f1f1f 对齐参考 Ink #1f1f1f;纯黑在暖底上过尖,且与 --ink 的 8 处重复字面量收敛到同一个值
--card #ffffff #fffdfb 参考 Don't 明令不用 stark white;暖白与画布形成 1.05:1 的纸面抬升
--card-foreground #060607 #1f1f1f 与 --foreground 同步
--popover #ffffff #fffdfb 弹窗面与卡片同色,保持「纸面浮起」的一致观感
--popover-foreground #060607 #1f1f1f 与 --foreground 同步
--primary var(--brand) var(--brand) 沿用引用式赋值,随 --brand 变橙
--primary-foreground var(--brand-foreground) var(--brand-foreground) 沿用引用式赋值
--secondary #ebedef #f0e9df 冷灰 → 暖砂;承担他人气泡底、次级按钮底、Badge variant="secondary"
--secondary-foreground #060607 #241f1a 暖底上配暖黑,避免冷黑在砂色上显脏
--muted #f2f3f5 #f5f0e8 最浅的暖底,用于 hover / 禁用 / 区块背景
--muted-foreground #5c5e66 #5e5a54 参考 Graphite #60605f 暖化;画布 6.41:1、侧栏 5.77:1,均过 4.5:1
--accent #ebedef #f0e9df 与 --secondary 同值:实测他人气泡取色即 --accent(rgb(235,237,239)),此处就是气泡底色
--accent-foreground #060607 #241f1a 与 --secondary-foreground 同步
--destructive #da373c #c02a26 冷红 → 砖红,与橙强调同属暖色不打架;白字填充 5.83:1、当文字 5.46:1
--border #dcdee1 #e8e0d2 发丝线换暖调;定位为纯装饰分隔(1.23:1),不再承担控件边界
--input #dcdee1 #ded2bb 更深一档的暖褐灰:它同时是控件 border(input.tsx:11)与填充基色(chat/textarea.tsx:9 的 bg-input/50),因此只能到 1.47:1,未达 1.4.11 的 3:1(见 §shadcn 兼容性 R2)
--ring var(--brand) var(--brand) 沿用引用式赋值;全站焦点环因此从蓝变橙(按钮 focus-visible:ring-3 ring-ring/50,button.tsx:10)
--brand #2563eb #c84000 参考 Sprout Orange #ff4800 沿同色相(约 19°)压暗至 L*≈45:白字填充 5.01:1、当文字 4.69:1(原参考值白字仅 3.40:1,不达标)
--brand-foreground #ffffff #ffffff 深橙填充上白字 5.01:1
--brand-soft rgb(37 99 235 / 0.12) rgb(200 64 0 / 0.10) 品牌浅底(选中导航项 / outlined 按钮 / ::selection)同色相化;10% 叠在卡片上得 #faeae2
--brand-ink #1d4ed8 #9c3000 浅橙底上的品牌深调文字:画布 6.93:1、橙浅底 6.32:1(对齐实测的选中态前景角色)
--message-self #e8f3fe #ffcfae 参考 Peach Wash #fcded2 加饱和:自己气泡 = 「你的动作」的橙;与 --accent 他人气泡拉开 1.18:1(现值需要靠蓝/灰区分)
--message-self-foreground #0d274a #3d1607 焦糖深棕(11.24:1),与橙底同色系;原值 #0d274a 是蓝色系,与橙底冲突
--surface-chat-soft #e8f2ff #fdeee2 引用/AI 回执类浅消息底,橙 6% 极浅暖底
--surface-chat-selected #e5ecfc #f6dcc5 选中会话行:用品牌橙的 15% 低饱和暖底取代蓝色选中底,与侧栏 1.11:1
--mention #3370ff #a83707 @提及深朱橙,画布 6.11:1、他人气泡 5.42:1、自己气泡 4.60:1;取代 chat-mention.ts 里硬编码的 #3370FF(第三种蓝)
--ink #060607 #1f1f1f 深色媒体框(rtc-video-frame.tsx:48 的 bg-ink)与反白场景,与 --foreground 收敛到同一值
--surface-rail #e1e8f2 #ece3d3 72px 空间栏竖带由蓝灰转暖砂,同时修掉「实测右边框 rgba(220,222,225,0.55) ≠ --border #dcdee1」的来源不一致
--sidebar #fcfcfc #f2ebdd 本方案最关键的修复:原值等于画布,实测零层级对比;改羊皮纸带后与画布 1.11:1
--sidebar-foreground #060607 #1f1f1f 与 --foreground 同步
--sidebar-accent #ebedef #e8dfcd 侧栏 hover/选中底,暖砂加深,与侧栏 1.12:1
--sidebar-accent-foreground #060607 #1f1f1f 与 --foreground 同步
--sidebar-border #dcdee1 #e0d6c2 侧栏分割线并入暖纸阶
--chart-1 oklch(0.87 0 0) #c84000 数据序第 1 档 = 品牌橙(画布 4.69:1),唯一高强调数据色
--chart-2 oklch(0.556 0 0) #0f4f4d 第 2 档深青(8.75:1),取自参考 Deep Teal #042729 的提亮变体
--chart-3 oklch(0.439 0 0) #a97a3d 第 3 档砂棕(3.55:1),暖中性
--chart-4 oklch(0.371 0 0) #6f8480 第 4 档青灰(3.72:1)
--chart-5 oklch(0.269 0 0) #7d6f5c 第 5 档暖灰(4.57:1);原方案把 5 档灰色从明到暗排,在彩色底上不可分辨
--radius 0.625rem(10px) 0.714rem(11.42px) 使 rounded-xl(卡片 / 侧栏 / 任务卡,card.tsx 用 rounded-xl)= 16.0px 整,对齐参考的 16px 卡片圆角;控件 rounded-lg = 11.42px

连带修正(同一令牌块内的非清单变量,均为真实存在的变量名):

变量名 当前值 建议值 意图
--workspace-background linear-gradient(180deg, var(--surface-rail), #e1e5f1) linear-gradient(180deg, #f2eade, #ecdfcb) 第二个色停硬编码了蓝灰 #e1e5f1(styles.css:129),改令牌值仍是①途径,却把整条左侧竖带的蓝彻底去掉
--interactive #4e5058 #4e4a44 图标交互色由冷石板灰转暖褐灰(画布 8.23:1),sidebar-user-account-menu.tsx:97 等 7 处 text-interactive 自动跟随
--channel-icon #80848e #7a736a 频道图标由冷灰转暖灰,侧栏羊皮纸上 3.94:1(图形阈值 3:1 达标),15 处 text-channel-icon 自动跟随

深色 .dark(web/src/styles.css:161-203)

表面阶梯:画布 #0b1a1c(深青墨)→ 侧栏 #061113(更深的竖带)→ 卡片 #122529(抬升面)。色相取自参考的 Deep Teal #042729,但整体提亮到可在 1440×900 上长时间阅读的明度。

变量名 当前值 建议值 意图
--background oklch(0.145 0 0) #0b1a1c 中性黑换暖深青,与浅色纸主题互为镜像(同色相、反明度)
--foreground oklch(0.985 0 0) #f4efe6 纯白换暖米白,深青底上 15.56:1
--card oklch(0.205 0 0) #122529 抬升面同时去中性灰、去蓝,与画布 1.12:1
--card-foreground oklch(0.985 0 0) #f4efe6 与 --foreground 同步,卡片上 13.87:1
--popover oklch(0.205 0 0) #122529 与卡片同色
--popover-foreground oklch(0.985 0 0) #f4efe6 与 --foreground 同步
--primary var(--brand) var(--brand) 沿用引用式赋值
--primary-foreground var(--brand-foreground) var(--brand-foreground) 沿用引用式赋值
--secondary oklch(0.269 0 0) #1c3338 次级面去中性灰、去蓝
--secondary-foreground oklch(0.985 0 0) #f4efe6 与 --foreground 同步
--muted oklch(0.269 0 0) #16292d 比 --card 略深一档的暖深青,供 hover / 区块底
--muted-foreground oklch(0.708 0 0) #a9b6b4 次级文字换暖青灰:画布 8.52:1、侧栏 9.15:1
--accent oklch(0.269 0 0) #22383b 他人气泡 / hover 底;与 --message-self 拉开 1.17:1
--accent-foreground oklch(0.985 0 0) #f4efe6 与 --foreground 同步
--destructive oklch(0.704 0.191 22.216) #ff6b66 暖红在暖青深底上更协调,画布 6.40:1、卡片 5.71:1(原值偏品红)
--border oklch(1 0 0 / 10%) #2a4448 原为白色透明,叠暖青底会偏冷发灰;实色深青 1.71:1(装饰)
--input oklch(1 0 0 / 15%) #33514f 控件边界 + 填充基色(dark:bg-input/30,input.tsx:11),1.84:1,同浅色受同一限制(§shadcn 兼容性 R2)
--ring var(--brand) var(--brand) 沿用引用式赋值,焦点环变橙
--brand oklch(0.68 0.15 256) #ff7a45 深色需要反向提亮:浅橙画布上 6.89:1;配深焦糖前景 6.84:1
--brand-foreground oklch(0.16 0.02 258) #2a1206 由深蓝黑换深焦糖,与橙填充同色系(6.84:1)
--brand-soft oklch(0.28 0.05 256) rgb(255 122 69 / 0.16) 品牌浅底同色相化,叠卡片得 #38332d
--brand-ink oklch(0.84 0.09 256) #ffb08a 深色下品牌浅调文字:画布 10.04:1、橙浅底 7.04:1
--message-self #203b59 #3a2418 自己气泡由深蓝换深焦糖(灰阶 1.23:1 于画布),与自己气泡文字 12.41:1
--message-self-foreground #e7f3ff #ffe9dc 由冷蓝白换暖奶油,与深焦糖底同色系
--surface-chat-soft oklch(0.32 0.06 250) #2a2119 暖褐浅底,与画布 1.09:1
--surface-chat-selected oklch(0.28 0.04 250) #33261c 选中会话行 = 品牌橙的低饱和暖底,与侧栏 1.31:1(比现值 1.0x 更可辨)
--mention oklch(0.72 0.14 254) #ffa06b @提及浅橙:画布 8.90:1、他人气泡 6.18:1、自己气泡 7.26:1
--ink oklch(0.16 0.02 258) #061113 深蓝黑换深青墨,与 --sidebar 同值;bg-ink(视频 letterbox)与 text-ink(rtc-mini-window.tsx:174 的 aria-pressed:bg-white 反白场景)两个用途都成立
--surface-rail #e3e5e8 #071416 修掉实测缺陷:原值是浅色 #e3e5e8,注入 .dark 后 rail 会在深底上留一条浅色竖带
--sidebar oklch(0.205 0 0) #061113 侧栏作为比画布更深的竖带,与画布 1.07:1、与卡片 1.21:1
--sidebar-foreground oklch(0.985 0 0) #f4efe6 与 --foreground 同步
--sidebar-accent oklch(0.269 0 0) #17302f 侧栏 hover/选中底,与侧栏 1.37:1
--sidebar-accent-foreground oklch(0.985 0 0) #f4efe6 与 --foreground 同步
--sidebar-border oklch(1 0 0 / 10%) #1e3538 侧栏分割线实色化,避免白色透明在暖青底上发灰
--chart-1 oklch(0.87 0 0) #ff7a45 数据序第 1 档 = 品牌浅橙(6.89:1)
--chart-2 oklch(0.556 0 0) #4fb3ae 第 2 档青(7.12:1)
--chart-3 oklch(0.439 0 0) #e0b47c 第 3 档砂(9.32:1)
--chart-4 oklch(0.371 0 0) #8fa6a3 第 4 档青灰(6.92:1)
--chart-5 oklch(0.269 0 0) #bda98f 第 5 档暖灰(7.84:1)
--radius 继承 :root 0.714rem 与浅色同值,避免切换主题时圆角跳变(原文件 .dark 未声明 --radius,此处显式声明)

深色连带修正: --workspace-background / --workspace-rail-background / --workspace-header-background 三个渐变沿用原文表达式(它们已用 color-mix(in oklab, …, var(--brand) / var(--muted) / var(--background)) 引用令牌),因此会随新令牌自动变成「暖青 + 橙」的径向渐变,无需改写。深色的 --interactive: #c3cccb(画布 10.88:1)与 --channel-icon: #8d9c9c(侧栏 6.71:1)同样随浅色一并暖化。


字体与排版

字体栈(不改,且必须保住中文回退)

web/src/styles.css:33-36 的 --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

字号阶梯(目标值,含落地位置)

实测现状(简报 §3.3):单视图出现 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26 px 共 10 档,12.8 与 13.125 是 15px 基准的 em 计算残渣,说明「字号没有刻度」。本方案把刻度收敛为 7 档:

角色 字号 / 行高 / 字重 用在哪(实测对应) 途径
面板标题 16px / 1.30 / 600 频道头标题(实测 860×52 内 16px/600)、任务看板 标题、侧栏空间名 ②/③(--text-base 类由组件决定)
次要标题 14px / 1.43 / 600 弹窗左导航分组名、任务卡标题(实测 14px/500) ②
正文 15px / 1.5 / 400 消息正文、表单值(实测 body 15px/400、行高 1.375) ①(styles.css:243 的 leading-[1.375] → leading-[1.5])
正文-密 14px / 1.43 / 400 AI 助手空间、任务列表行(实测 14px/400 ×1724) ②
次级 13px / 1.46 / 400 消息作者名(实测 13px/400) ②
标签 12px / 1.5 / 500 时间戳、成员数、Badge 文案(实测 12px/500) ②
代码/数字 12px / 1.5 / 400 --font-mono 应用点 ①(已有 --font-mono)

关键点与落地细节:

  1. 正文行高 1.375 → 1.5 是本方案唯一必须改到 @layer base 的地方。 位置:web/src/styles.css:243 的 @apply bg-background text-[15px] leading-[1.375] text-foreground;。理由:中文无西文的 x-height 拉伸感,1.375(=20.63px @15px)在实测的整段中文消息里偏挤;参考的正文行高为 1.56,本产品取保守值 1.5(=22.5px @15px)。这条不是 :root 变量,所以 tokens.css 里没有它——它是令牌区块外的 1 行改动,必须单列进实施清单。
  2. 字号刻度本身没有令牌可依。 现状 styles.css 里没有任何 --text-* / --leading-* 自定义属性(字号全部是 Tailwind 字面量或组件里的 text-[13px])。因此新增字号令牌不在本方案的①途径范围内(会引入原文不存在的变量名,违反交付约束)。上表是「组件层要落到哪个值」的目标刻度,落地方式是对应组件把 text-[13px] 之类的字面量换成 Tailwind 标准档(text-sm/text-xs),属于②途径。
  3. 禁止出现的档位: 9px、9.375px、11px、11.25px、12.8px、13.125px。实测中 11.25px 出现在会话行预览、12.8px ×2765 出现在 AI 助手空间——它们都低于中文最小 12px 的底线或属于 em 残渣,须回到 12px / 13px / 14px / 15px 四档。
  4. 数字与代码一律 --font-mono:任务号、@吴十 之外的时间戳(11月18日 15:55)、+1 计数、连接态(已连接 / 连接中 / 重连中 / 已断开 / 连接失败)。
  5. 弹窗内表单标签 14px(实测),不再往上加粗;错误信息用 --destructive(#c02a26,画布 5.46:1)而非红底白字块。
  6. AI 助手空间是全站最密集视图(实测一次渲染内 12.8px×2765 / 12px×2381 / 12px×1994 / 14px×1724),本方案对该视图的要求是「≥12px + 行高 1.5 + 只保留 3 档」(详见 §关键界面改造 S4)。

关键界面改造

覆盖 S1 / S2 / S3 / S7 + S4 / S5 / S8(7 个样例面),另附 S6 的代码级说明。每条都标注途径与用到的官方组件。

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

# 现状(实测) 改后 途径
1 空间 rail nav 72×900,背景 transparent,右边框 rgba(220,222,225,0.55)(与 --border #dcdee1 不同源);--surface-rail #e1e8f2 → --workspace-background 的硬编码第二停 #e1e5f1 竖带成为暖砂带:--surface-rail #ece3d3,--workspace-background linear-gradient(180deg,#f2eade,#ecdfcb)。即使右边框仍是硬编码值,也因为不再是蓝灰而不再显色偏 ①
2 会话侧栏 aside 256×715 @x=76,background #fcfcfc = 页面底色 --background,零层级对比 --sidebar: #f2ebdd(羊皮纸带),与画布 #faf7f2 形成 1.11:1;rounded-xl 由 14px 变 16.0px。层级由纸阶承担,不加阴影 ①
3 侧栏头部高 52px;搜索框高 30px、圆角 10px、背景 rgba(235,238,239,0.75) 搜索框保持 30px 高(不加密),但换成官方 Input 组件语义:border-input(#ded2bb)+ bg-transparent,圆角随 --radius 变 11.42px;不再用半透明灰叠色 ① + ②(用 Input 官方形态)
4 会话行 240×64;未读点、时间、预览 11.25px(低于中文 12px 底线) 会话行保持 240×56(③:容器 py-2 → py-1.5,把 64px 压到 56px,为长列表增加约 12% 可视行数);预览字号回到 12px;未读点用 --brand(橙),时间戳 --muted-foreground ① + ③
5 选中会话行底色蓝 --surface-chat-selected #e5ecfc;hover 底 --sidebar-accent #ebedef 选中行 #f6dcc5(橙 15% 暖底,与侧栏 1.11:1),hover #e8dfcd(1.12:1)。「当前在哪」= 橙,与「你的消息 = 橙」同一语义 ①
6 侧栏图标 --channel-icon #80848e(冷灰,15 处 text-channel-icon) #7a736a 暖灰,侧栏上 3.94:1(图形 ≥3:1 达标) ①
7 空间图标按钮 71×48,分隔线 rgba(5,5,9,0.22) 尺寸不动(触屏友好,且 tap-target 已有 44px 命中区);分隔线改用官方 Separator,颜色走 --border ②
8 侧栏会话列表、空间列表的滚动容器 用官方 ScrollArea / ScrollRegion(仓库已有 scroll-area.tsx、scroll-region.tsx)承载,避免在 aside 上叠两层滚动导致的双滚动条 ②

密度: 会话行 56px、空间图标 48px、侧栏宽 256px 全部保持不变——它们是实测的触屏友好值与布局锚点,只压缩了侧栏头部(52px 不变)与行内 padding。 状态色: 未读 = --brand 橙点;已连接 = --muted-foreground(中性,不抢眼);连接中/重连中 = --brand-soft 底 + --brand-ink 字;已断开/连接失败 = --destructive。

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

# 现状(实测) 改后 途径
1 气泡圆角 14px;他人 rgb(235,237,239)(= --accent #ebedef)、自己 rgb(232,243,254)(= --message-self #e8f3fe) 他人气泡 #f0e9df(暖砂,正文 13.68:1)、自己气泡 #ffcfae(橙,11.24:1)。两者明度差从现值 1.04:1 提到 1.18:1,不再需要靠蓝灰区分 ①
2 消息正文两套字号:他人 15px/400 #060607、自己 14px/400 #0d274a 统一 15px/400、行高 1.5;他人文字 --foreground #1f1f1f、自己文字 --message-self-foreground #3d1607。同一列表只允许一个正文字号 ①(颜色)+ ②(自己气泡的 14px 字面量改回 15px)
3 作者 13px/400;时间 12px/500 #5c5e66 作者 13px/400 --foreground,时间 12px/500 --muted-foreground #5e5a54(画布 6.41:1、气泡上 5.42:1+)。时间戳改用 --font-mono 让 11月18日 15:55 纵向对齐 ①
4 @提及硬编码 #3370FF(chat-mention.ts),与 --mention 令牌不一致,是第三种蓝 --mention #a83707(深朱橙):画布 6.11:1、他人气泡 5.42:1、自己气泡 4.60:1。全部达标,且与「你的动作 = 橙」一致 ①
5 输入区 textarea 628×33 无边框,外层只有上边框 rgb(220,222,225);工具按钮 28×28 外层上边框随 --border #e8e0d2 暖化;输入容器用官方 InputGroup(ui/input-group.tsx)+ Textarea,高度维持 33px 单行。工具按钮保留 28×28(Button size="icon-sm" 已是 28px,button.tsx:32),不改尺寸 ① + ②(Button variant="ghost" size="icon-sm")
6 悬停动作:点赞 / 回复 / 更多 / 预览图片 / 已读未读(0 人已读,4 人未读) 全部走 Button variant="ghost" size="icon-xs"(24px);已读 用 --muted-foreground 的灰、未读 用 --brand 橙 —— 「还有谁没看到」是最需要抢注意力的信息,用唯一彩色标它 ②
7 频道头 860×52;标题 16px/600 #060607;成员数 12px/500 #5c5e66 高度不变;标题 16px/600 --foreground;成员数 12px/500 --muted-foreground。频道类型(# 频道 / @ 私信 / AI / 语音)用官方 Badge variant="ghost" 承载,不再用自定义图标色 ① + ②
8 引用 / 置顶消息块 引用块用 --surface-chat-soft #fdeee2(暖白底)+ Separator 左侧竖线;置顶用 Badge variant="outline"(发丝线 --border)。不再新增色,全部落在纸阶内 ① + ②

状态色: 发送中 = --muted-foreground + --animate-breathe(已有);发送失败 = --destructive,用 Button variant="link" 提供「重发」;自己消息已读 = --muted-foreground,未读 = --brand。

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

# 现状(实测) 改后 途径
1 卡片圆角两套混用:10px×48、8px×37 卡片的 rounded-xl 由令牌统一到 16.0px;硬编码的 rounded-[10px] / rounded-[8px](组件内字面量)需替换为 rounded-lg(11.42px)/rounded-md(9.14px)两档标准值 —— 这一步是组件源码改动,单列进 §实施成本 ① + ②
2 任务卡 = 标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人 结构改用官方 Card + CardHeader/CardTitle/CardContent/CardFooter(ui/card.tsx):CardTitle 走 14px/600 暖纸标题,chip 全部换官方 Badge;主操作 查看任务 用 Button variant="outline" size="sm",接单动作 Button variant="default" size="sm"(橙填充 = 主操作) ②
3 筛选「全部频道 / 5 项任务」、列头「待补充 0 / 待处理 5」 列头与筛选条改成官方 Tabs(ui/tabs.tsx):data-active:bg-background 在浅色下是白底 + --foreground,选中态因此是「纸上浮起的一块」,与橙主操作不冲突 ②
4 群聊大厅带营销式 hero 段落 + 品牌蓝出现 20 处 删掉 hero 段落(③:容器层去掉大段 py-* 的展示区,改为不高于 64px 的工具栏),筛选「全部群聊 / 全部 / 已加入 / 未加入」用 Tabs;群卡片用 Card + Badge variant="secondary"(#f0e9df)标「已加入」,Badge variant="outline" 标「未加入」 ② + ③
5 状态:待补充 / 待处理 / 进行中 / 待验收 / 已完成 / 已关闭 三级色彩 + 官方 Badge variant 的六档映射(见下表),不再引入 Tailwind 原色(普查里 amber 69 处、emerald 42 处、rose 68 处中的任务状态类全部收编) ① + ②

六档状态映射(只用官方 Badge variant + 现有令牌):

状态 Badge variant 落地颜色 语义
待补充 variant="ghost" 文字 --muted-foreground #5e5a54 最弱;配 lucide CircleDashed 图标区分
待处理 variant="secondary" 底 --secondary #f0e9df,字 --foreground 中性,等待派发;配 Clock 图标
进行中 variant="default" 底 --brand #c84000,字 #ffffff(5.01:1) 唯一的橙填充,全站最强信号;配 Loader 图标
待验收 variant="outline" 发丝线 --border + 字 --foreground 需要人判断,但不该抢「进行中」的橙;配 ClipboardCheck 图标
已完成 variant="secondary" 底 --secondary,字 --muted-foreground 归于平静;配 Check 图标
已关闭 variant="ghost" 文字 --muted-foreground 归档;配 Archive 图标
超期(跨状态叠加) variant="destructive" 底 --destructive/10,字 --destructive #c02a26(5.46:1) 风险层,与状态正交叠加

密度: 任务看板列宽、卡片内边距不动;只把「两套圆角」收敛成两档标准值。层级: 卡片靠 --card #fffdfb 在画布 #faf7f2 上浮起 1.05:1 + 发丝线 --border,不用 --shadow-e2/e3。

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

# 现状(实测) 改后 途径
1 居中卡片,主标题 26px 主标题保留 26px,字重 600,颜色 --foreground #1f1f1f;卡片用 Card,rounded-2xl 随令牌变 20.6px,底色 --card #fffdfb 浮在 --background #faf7f2 上 ① + ②
2 「邮箱验证码 / 短信验证码」切换块 173×42,选中态背景 --background #fcfcfc + 品牌蓝文字 换成官方 Tabs(TabsList / TabsTrigger):浅色下 data-active:bg-background data-active:text-foreground(tabs.tsx:64)→ 选中态是暖白块 + 暖黑字;主按钮才是橙,选中态不与主操作抢色 ②
3 主按钮 356×52、白字、#2563eb Button variant="default" 尺寸保持 52px 高(③:卡片内 w-[356px] h-[52px] 容器不变),填充随 --brand 变 #c84000、白字 5.01:1。这个按钮是全页唯一橙色元素 ①
4 页脚 11px(低于中文 12px 底线) 页脚提到 12px,颜色 --muted-foreground(画布 6.41:1) ②
5 文案:「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」 文案不动。获取验证码 为「获取」主操作时用 Button variant="default" size="sm";已发送后的 60s 倒计时用 Button variant="secondary" 禁用态(组件默认 disabled:opacity-50,沿用) ②
6 登录页整屏背景 用 --workspace-background 的暖纸渐变(linear-gradient(180deg,#f2eade,#ecdfcb))铺底,使登录页与应用外壳是同一张纸 ①

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

# 现状(实测) 改后 途径
1 AI 助手空间一次渲染内 4 档字号:12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724;圆角 8px ×1591、10px ×844 收敛为 3 档:正文 14px/400(行高 1.5)、标签 12px/500、标题 16px/600。12.8px 是 15px 基准的 em 残渣,必须回到 12 或 14 ② + ③(密排列表的容器 padding)
2 流式回答 + 来源引用 + 结果卡片 结果卡片用 Card;来源引用用 Badge variant="outline" + --font-mono 的页码/行号;AI 等待态沿用 --animate-breathe 三点,颜色 --brand 橙(唯一彩色留给「正在为你工作」) ① + ②
3 一次渲染 395 项任务、全站最密集视图 容器改为官方 MessageScroller / ScrollRegion(仓库已有 message-scroller.tsx)+ 虚拟列表 react-virtuoso(已在依赖里)承载;每行高度由内容决定,不靠缩小字号换行数 ② + ③
4 引用/AI 回执的浅蓝底 --surface-chat-soft #e8f2ff 换 #fdeee2(橙 6% 暖白)。AI 的回答提示位用橙而不是第四种蓝 ①
5 任务卡里的 AI 助手 chip 与 Agent · 第三方 · chat 元信息 chip 统一 Badge variant="secondary"(暖砂);「AI 生成」标记用 Badge variant="outline" + 橙色 lucide Sparkles 图标(图标着色走 --brand-ink,不是新色) ① + ②

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

# 现状(实测) 改后 途径
1 [role=dialog] 704×512,圆角 18px,背景 #ffffff 尺寸保持 704×512(信息密度已合适);圆角随 --radius 变 20.6px;背景 --popover #fffdfb;遮罩沿用组件默认(bg-black/50 之类不动,属官方实现) ①
2 左导航项 135×36 圆角 8px,选中态 --brand-soft rgb(37 99 235/0.12) + 前景 --brand-ink #1d4ed8 尺寸不变;选中态变 rgb(200 64 0 / 0.10)(叠卡片 = #faeae2)+ 前景 --brand-ink #9c3000(6.32:1)。「你正在哪个设置页」也用橙,与「当前频道」同一语义 ①
3 危险项前景 --destructive #da373c #c02a26(画布 5.46:1)。危险项必须同时带文字标签,不能只靠颜色(颜色非唯一提示) ①
4 输入框 488×32 圆角 10px;表单标签 14px 输入框保持 32px 高(信息密度不动),圆角随令牌变 11.42px,边界走 --input #ded2bb;表单标签 14px 不动。多选/单选/开关分别用官方 Checkbox / RadioGroup / Select,只用官方尺寸 ① + ②
5 成员列表(角色 群主 / 管理员 / 研发 / 产品 / pmo) 用官方 Item(ui/item.tsx)+ Avatar + Badge variant="secondary" 显示角色;角色色不引入新色,最高权限 群主 用 Badge variant="default"(橙)——「拍板的人」是唯一需要强调的角色 ②
6 权限选择器 Checkbox + Field(ui/field.tsx)组合,禁用态用组件默认 disabled:opacity-50,不自定义 ②

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

# 现状(实测) 改后 途径
1 分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」 筛选条用官方 Tabs;计数用 Badge variant="ghost" + --font-mono。分类条横向滚动容器改为 flex + overflow-x-auto(③),不做换行 ② + ③
2 卡片:运行中 / 开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息 运行中 = Badge variant="default"(橙填充,唯一的「正在跑」);开发中 = Badge variant="outline"(发丝线,未上线);元信息 12px/400 --muted-foreground + --font-mono 的 chat 通道名 ① + ②
3 应用/助手图标当前用 emoji(简报明确点名的视觉一致性缺口) emoji 保留为内容(它承载真实含义,不是样式),但统一装进官方 Avatar 的固定 40×40 方形容器,底色 --secondary #f0e9df、rounded-lg。综合效果:emoji 的天然多色被限制在一个暖砂方块里,与「单一橙强调」不再互相打架(图形轮廓与底色 1.0x,emoji 自身对比度不受影响) ② + ③
4 卡片网格 用 grid + gap-3(③);卡片 Card + rounded-xl(16px)。不加阴影,靠纸阶 + 发丝线分层 ② + ③

S6 语音频道 / 通话(rtc-group-call-ui.tsx)—— 代码级说明,非截图依据

重要前提: 本栈不可见。简报 §3.3 实测:本机 TRTC_ENABLED=false,界面一个语音元素都不渲染(DOM 内 aria-label 匹配「语音|通话|加入」命中 0 处),/api/v1/rtc/* 返回 RTC_DISABLED。以下结论只来自代码与库内数据,不含任何截图证据:库里 wanman3_rtc_voice_channels 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行。

代码事实(web/src/components/app/rtc-group-call-ui.tsx,934 行,已读其类名):该文件使用的全部颜色类只有 text-foreground(8) / text-muted(6) / bg-muted(5) / text-destructive(4) / border-destructive/40(2) / bg-ink(2) / text-ink(1) / bg-destructive(1) / bg-background(2),即完全走语义令牌,没有 Tailwind 原色泄漏;rtc-video-frame.tsx:48 的 bg-ink 与 rtc-mini-window.tsx:174 的 aria-pressed:bg-white aria-pressed:text-ink 是唯一的两个特殊点。

因此 S6 在令牌层面自动被本方案覆盖:视频 letterbox 的 bg-ink 由 #060607 → #1f1f1f(浅)/ #061113(深),参会者磁贴的 bg-muted 由 #f2f3f5 → #f5f0e8(浅)/ #16292d(深),挂断按钮的 --destructive 由 #da373c → #c02a26(浅)/ #ff6b66(深)。无需任何组件改动,且无法在本机验证——这条必须等 TRTC_ENABLED=true 的环境回归,属于本方案的验证盲区(§实施成本验证方式)。


深浅色与对比度

标准:正文文字 ≥4.5:1;大字号(≥18.66px 粗体 / ≥24px)与图形边界 ≥3:1。全部比值为 WCAG 2.x 相对亮度公式实算。

浅色

组合 前景 hex 背景 hex 比值 达标
正文 / 画布 #1f1f1f #faf7f2 15.42:1 ✅
正文 / 卡片 #1f1f1f #fffdfb 16.24:1 ✅
正文 / 他人气泡 #1f1f1f #f0e9df 13.68:1 ✅
自己气泡文字 / 自己气泡 #3d1607 #ffcfae 11.24:1 ✅
次级文字 / 画布 #5e5a54 #faf7f2 6.41:1 ✅
次级文字 / 侧栏羊皮纸 #5e5a54 #f2ebdd 5.77:1 ✅
次级文字 / --muted 底 #5e5a54 #f5f0e8 6.04:1 ✅
品牌文字 / 画布 #c84000 #faf7f2 4.69:1 ✅
白字 / 品牌填充 #ffffff #c84000 5.01:1 ✅
--brand-ink / 橙 10% 浅底 #9c3000 #faeae2 6.32:1 ✅
@提及 / 画布 #a83707 #faf7f2 6.11:1 ✅
@提及 / 他人气泡 #a83707 #f0e9df 5.42:1 ✅
@提及 / 自己气泡 #a83707 #ffcfae 4.60:1 ✅
危险文字 / 画布 #c02a26 #faf7f2 5.46:1 ✅
白字 / 危险填充 #ffffff #c02a26 5.83:1 ✅
频道图标(图形)/ 侧栏 #7a736a #f2ebdd 3.94:1 ✅(图形 3:1)
控件图标 / 画布 #4e4a44 #faf7f2 8.23:1 ✅
分割线 / 画布 #e8e0d2 #faf7f2 1.23:1 ⚠ 纯装饰,见下
控件边界 / 卡片 #ded2bb #fffdfb 1.47:1 ❌ 见 §shadcn 兼容性 R2
侧栏 / 画布(层级) #f2ebdd #faf7f2 1.11:1 ✅(层级可辨,非对比度要求)
卡片 / 侧栏(层级) #fffdfb #f2ebdd 1.17:1 ✅
自己气泡 / 他人气泡(层级) #ffcfae #f0e9df 1.18:1 ✅(现值 1.04:1)
选中会话 / 侧栏(层级) #f6dcc5 #f2ebdd 1.11:1 ✅

为什么「分割线 1.23:1」可以接受、而「控件边界 1.47:1」不行: WCAG 1.4.11 只要求「识别控件及其状态所必需」的视觉信息达到 3:1。--border 用在卡片描边、区块分割、列表分隔——这些位置移除边框后布局仍由间距与纸阶表达,属于装饰。--input 用在 input.tsx:11 / select.tsx:48 / checkbox.tsx:13 的 border 上,是这些控件唯一的边界提示。这一条本方案没能解决,原因是 --input 同时被当填充色用(chat/textarea.tsx:9、chat/input.tsx:11 的 bg-input/50,深色还有 dark:bg-input/30):把它加深到 3:1(例如 #948871,对卡片 3.44:1)会让所有输入区变成一大块深褐填充。详见 §shadcn 兼容性 R2。

深色

组合 前景 hex 背景 hex 比值 达标
正文 / 画布 #f4efe6 #0b1a1c 15.56:1 ✅
正文 / 卡片 #f4efe6 #122529 13.87:1 ✅
正文 / 他人气泡 #f4efe6 #22383b 10.81:1 ✅
自己气泡文字 / 自己气泡 #ffe9dc #3a2418 12.41:1 ✅
次级文字 / 画布 #a9b6b4 #0b1a1c 8.52:1 ✅
次级文字 / 侧栏 #a9b6b4 #061113 9.15:1 ✅
次级文字 / --muted 底 #a9b6b4 #16292d 7.23:1 ✅
品牌文字 / 画布 #ff7a45 #0b1a1c 6.89:1 ✅
深焦糖字 / 品牌填充 #2a1206 #ff7a45 6.84:1 ✅
--brand-ink / 橙 16% 浅底 #ffb08a #38332d 7.04:1 ✅
@提及 / 画布 #ffa06b #0b1a1c 8.90:1 ✅
@提及 / 他人气泡 #ffa06b #22383b 6.18:1 ✅
@提及 / 自己气泡 #ffa06b #3a2418 7.26:1 ✅
危险文字 / 画布 #ff6b66 #0b1a1c 6.40:1 ✅
危险文字 / 卡片 #ff6b66 #122529 5.71:1 ✅
频道图标(图形)/ 侧栏 #8d9c9c #061113 6.71:1 ✅
控件图标 / 画布 #c3cccb #0b1a1c 10.88:1 ✅
分割线 / 画布 #2a4448 #0b1a1c 1.71:1 ⚠ 纯装饰
控件边界 / 卡片 #33514f #122529 1.84:1 ❌ 同 R2
侧栏 / 画布(层级) #061113 #0b1a1c 1.07:1 ✅
卡片 / 画布(层级) #122529 #0b1a1c 1.12:1 ✅
自己气泡 / 他人气泡(层级) #3a2418 #22383b 1.17:1 ✅
选中会话 / 侧栏(层级) #33261c #061113 1.31:1 ✅

图表色阶(图形对象 ≥3:1)

已知不达标项(显式标注)

  1. 控件边界 1.47:1(浅)/ 1.84:1(深)< 3:1(WCAG 1.4.11)。 原因与约束冲突见上。不合规风险 R2。
  2. 深色主题生产不可达(<html> class 恒为空)。令牌层面达标,但用户看不到 → 风险 R1。
  3. 深色下仍有约 55 处硬编码 rgb(6,6,7) 前景 + 27 处 rgb(92,94,102) + 6 处 rgb(220,222,225) 边框 + 3 处浅色头像底(简报 §3.3 实测,点开 .dark 后仍为浅色)。这些在组件 className 里,令牌改不动 → 风险 R3。

shadcn 兼容性

只用官方组件与官方 variant 能否达成?—— 绝大部分能,8 处需标注

web/components.json:style: base-nova、iconLibrary: lucide、baseColor: neutral、cssVariables: true。web/src/components/ui/ 现有 38 个官方组件(含 chat/ 子目录:bubble.tsx、input-group.tsx、button.tsx、textarea.tsx、input.tsx、empty.tsx)。

本方案实际用到的官方组件(全部已安装,无需新增):Button、Badge、Card、Input、Textarea、Tabs、Avatar、Separator、Dialog、Checkbox、RadioGroup、Select、Field、Item、ScrollArea、ScrollRegion、MessageScroller、Tooltip、DropdownMenu、Popover、InputGroup。

本方案用到的官方 variant / size 全集(无一处自定义):

三点确认

  1. Timer/Separator/ScrollArea 等官方变体足够表达六档任务状态:六档映射只用到 Badge 的 5 个官方 variant 中的 4 个(ghost / secondary / default / outline / destructive 共 5 个全用上)+ lucide 图标区分同 variant 的两档。没有新增自定义 variant。
  2. 深色与浅色的控件样式差异由官方负责:Button variant="outline" 自带 dark:border-input dark:bg-input/30 dark:hover:bg-input/50(button.tsx:13),Tabs 自带 dark:data-active:bg-input/30(tabs.tsx:64)——这些映射会读到我给的 --input 新值,无需额外处理。
  3. 存在 1 处「不得不超出三条途径」的地方,显式标注为不合规风险:

风险清单(显式标注)

编号 风险 证据 影响 本方案的处理
R1 深色主题在生产不可达 简报 §3.3:全仓 web/src 无任何代码添加 .dark、localStorage 无主题键、<html> class 恒为空、color-scheme: normal 深色令牌齐备且 22 组前景组合全部 ≥4.5:1,但用户看不到 本方案只交令牌。接线需要改 web/ 源码(web/package.json 已装 next-themes@^0.4.6,但未见引用),属于本方案范围外,必须在实施时单独立项
R2 控件边界 1.47:1(浅)/1.84:1(深)未达 WCAG 1.4.11 的 3:1 input.tsx:11、select.tsx:48、checkbox.tsx:13 用 border-input 作唯一边界;同一令牌又被 chat/textarea.tsx:9、chat/input.tsx:11 当 bg-input/50 填充色用 低视力用户在暖底上难以定位输入框 无法在①途径内解决。要么改组件(把 border-input 换成更深的专用色 = 新增令牌,超出交付约束),要么接受。标注为不合规,建议后续单独引入一个 --control-border 令牌解决
R3 深色下约 91 处硬编码颜色不翻转 简报 §3.3:rgb(6,6,7) 55 处、rgb(92,94,102) 27 处、rgb(220,222,225) 边框 6 处、浅色头像底 3 处 深色主题即便接线,这些元素仍近黑/近白,不可读 全部位于组件 className 里 → 超出三条途径。必须作为独立工单处理(建议一并处理 253 处 Tailwind 原色泄漏、三套蓝 #2563eb/#006ce7/#3370FF)
R4 两处圆角字面量 简报 §3.3 实测任务卡区域 10px ×48、8px ×37 令牌统一到 11.42/16px 后,这两处硬编码圆角不会跟随,会留下视觉断层 需在 task-hall.tsx / channel-work-items.tsx 里把 rounded-[10px]/rounded-[8px] 换成 rounded-lg/rounded-md(②途径的延伸),属组件源码改动
R5 头像首字底色用 Tailwind 50/700 硬编码配对(amber/rose/blue/emerald/teal 五组) 简报 §3.3 实测:amber rgb(255,251,235)/rgb(187,77,0) 等 这五组彩色与「单一橙强调」直接冲突,是全站最显眼的第二个彩色来源 令牌改不动。建议:改用 Avatar 官方 AvatarFallback + --secondary/--foreground 单色方案,但这是组件改动 → 列为后续工单。本方案在 preview.html 中已按单色方案呈现目标效果
R6 S6 语音频道无法在本机验证 简报 §3.3:TRTC_ENABLED=false,DOM 内命中 0 个语音元素,/api/v1/rtc/* 返回 RTC_DISABLED 令牌影响无法用截图证明(本方案也确实没截) 依据为代码(rtc-group-call-ui.tsx 只用语义令牌)+ 库内数据(30 个语音频道 / 183 次通话)。列为验证盲区

结论: 除 R1–R6 这 6 条外,本方案的视觉改观 100% 落在①令牌取值 + ②官方 variant/size + ③容器布局间距 三条途径内,无一处新增自定义视觉变体、无一处 className 覆盖组件的颜色/字号/字重/行高/尺寸/圆角/边框/阴影/内边距/状态样式/动效。


实施成本

改动面

第一层:令牌(必须,①途径) —— 只碰 web/src/styles.css 一个文件:

位置 行数 内容
@theme inline styles.css:31-105 映射沿用原文;仅 --radius-* 乘法链会随新 --radius 变化(无需手改)
:root styles.css:108-159 36 个清单变量 + 3 个连带变量(--workspace-background、--interactive、--channel-icon)
.dark styles.css:161-203 深色一套;新增显式 --radius 声明 1 行
@layer base styles.css:243 leading-[1.375] → leading-[1.5](唯一一处 :root 区块外的改动)

本目录 tokens.css 已给出可直接替换的完整内容(含中文注释)。

第二层:官方 variant / 容器(②③途径,可选但强烈建议) —— 6 个文件:

文件 改动 途径
web/src/components/app/channel-sidebar.tsx 会话行容器 py-2 → py-1.5(64px → 56px);预览字号 11.25px → 12px ③ + ②
web/src/components/app/message-list.tsx 自己气泡正文 14px → 15px;#006ce7 硬编码交回令牌 ② + ①
web/src/lib/chat-mention.ts 硬编码 #3370FF 交回 --mention ①
web/src/components/app/task-hall.tsx、channel-work-items.tsx rounded-[10px] / rounded-[8px] → rounded-lg / rounded-md;状态 chip 换官方 Badge 六档映射 ②
web/src/components/app/agent-chat-panel.tsx 等 AI 助手视图 12.8px / 13.125px 等 em 残渣字号 → 12px / 14px ②
web/src/routes/login.tsx 页脚 11px → 12px;切换块换官方 Tabs ②

预估人时

阶段 人时 说明
A. 令牌替换 + 本机 1440×900 逐项复算 §7 的 22 组对比度 0.5 人日 纯 styles.css 改动,风险低
B. 第二层组件收敛(6 个文件) 1.5 人日 需回归 S1–S5、S7、S8
C. 清硬编码色(R3 的 91 处 + 253 处 Tailwind 原色 + 三套蓝) 2–3 人日 独立工单,本方案不含
D. 深色接线(next-themes,R1) 0.5 人日 + 1 次回归 独立工单,本方案不含
E. S6 语音频道回归(需 TRTC_ENABLED=true 环境) 0.5 人日 验证盲区

A + B 合计约 2 人日即可交付本方案的全部视觉改观;A 单独执行 0.5 人日就能拿到「暖纸 + 橙 + 侧栏分层」三个最大收益。

风险清单

见 §shadcn 兼容性的 R1–R6。按优先级:R3(91 处硬编码色,深色不可读)> R2(控件边界不达 1.4.11)> R1(深色不可达)> R5(头像彩色冲突)> R4(两处硬编码圆角)> R6(S6 无法验证)。

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

  1. 计算样式抽查(可复算,不依赖观感): 1440×900 下取 getComputedStyle(document.querySelector('aside')).backgroundColor 应为 rgb(242, 235, 221)(现值 rgb(252, 252, 252)); getComputedStyle(document.body).backgroundColor 应为 rgb(250, 247, 242)(现值 rgb(252, 252, 252)); getComputedStyle(document.documentElement).getPropertyValue('--brand') 应为 #c84000(现值 #2563eb)。
  2. 对比度断言: 把 §7 两张表逐行喂给 WCAG 相对亮度公式脚本,断言除已标注的 R2 两行外全部 ≥ 阈值。本方案的数值就是用它算出来的,可离线复现。
  3. 半径断言: getComputedStyle(卡片元素).borderRadius 应为 16px(现值 14px);getComputedStyle(按钮元素).borderRadius 应为 11.42px(现值 10px)。
  4. 深色翻转抽查: 给 <html> 手动加 .dark,断言 --sidebar 计算值为 rgb(6, 17, 19)、--surface-rail 为 rgb(7, 20, 22)——并同时断言不再出现浅色竖带(现值 .dark 下 --surface-rail 仍是 #e3e5e8,这是一条能直接判定的回归项)。
  5. 泄漏计数(作为后续工单的验收): grep -rEo "(bg|text|border)-(rose|amber|emerald|slate|teal|blue|red|violet|purple|neutral|sky|cyan)-[0-9]+" web/src --include=*.tsx | wc -l 应从 253 降到 0。
  6. 口径检查: 本方案不跑 pnpm build / pnpm test / pnpm lint,也不起浏览器、不截图——这是任务约束。上述检查是交给实施者(改完 web/ 之后)的验收脚本,不是本方案自己执行的。

取舍

解决了什么

  1. 修掉实测到的三个确定性缺陷(都是可复算的,不靠主观):
    • 侧栏 #fcfcfc = 画布 → 零层级对比 → 改羊皮纸带 #f2ebdd(1.11:1);
    • .dark 下 --surface-rail 仍是浅色 #e3e5e8 → 深底上一条浅竖带 → 改 #071416;
    • --workspace-background 第二个色停硬编码蓝灰 #e1e5f1 → 改同阶暖色。
  2. 把「三套蓝并存」收成一个色相族。 --brand #2563eb、硬编码 #006ce7(message-list.tsx / composer-markdown.ts / voice-channel-history-dialog.tsx)、--mention #3370ff(chat-mention.ts)三者在令牌层面统一为「橙 = 你的动作」。
  3. 给任务状态一个可解释的色系统。 六个状态只靠 5 个官方 Badge variant + 现有令牌就能表达,进行中 是画面里唯一橙色填充——扫一眼就知道「现在有多少活在跑」。
  4. 修掉一条明确的对比度缺陷: 品牌色作为填充时的白字对比度从 #2563eb 的 5.17:1 / 参考原值 #ff4800 的 3.40:1,定为 #c84000 的 5.01:1(当文字色 4.69:1)。两条路都过 4.5:1。
  5. 字号从 10 档收敛到 7 档,消灭 9 / 9.375 / 11 / 11.25 / 12.8 / 13.125px 这些 em 残渣与低于中文 12px 底线的档位。
  6. 层级不再依赖阴影。 现有 --shadow-e1..e3 / --shadow-pop 值不动,但关键界面(侧栏 / 卡片 / 弹窗)改用纸阶 + 发丝线分离,符合参考的 border-based elevation。

牺牲了什么

  1. 按钮圆角没到参考的 8px。 shadcn 的 --radius 乘法链里 rounded-lg(按钮/输入/下拉)= --radius、rounded-xl(卡片/侧栏)= 1.4 × --radius,两者共享同一个 --radius。要同时命中 8px 与 16px 需要 --radius 既等于 8 又等于 11.43,不可能。我选择了命中 卡片 16px(因为卡片/侧栏/任务卡是这块界面上面积最大、最能被感知的面),代价是控件停在 11.42px——比参考的 8px 圆、比现网的 10px 略方。这是一个明确的取舍,不是遗漏。
  2. 没有衬线标题。 参考最有辨识度的「sans/serif 对比」被完全放弃,改用「尺寸 + 字重(400/500/600)」承担层级。代价是「编辑部感」弱于参考原文气质,换来的是零字体体积增量与中文排版安全。
  3. 深色主题这次仍然只能停在令牌层。 交了完整、达标的一套深色值,但用户看不到(R1),而且即便接线,91 处硬编码色也仍不可读(R3)。所以深色的实际交付度低于浅色,本方案不假装两者等价。
  4. 控件边界仍不达 1.4.11(R2)。这是 --input 一令牌两用(边界 + 填充)导致的,属于组件层问题,本方案选择显式标注而不是用加深 --input 的方式「过关」(那会让所有输入区变成深褐块,是更差的视觉结果)。
  5. 不新增字号令牌。 字号阶梯只能以「组件应落到哪个值」的形式给出,无法做成 --text-* 令牌(原文件里不存在这些变量名)。这削弱了①途径在排版上的作用,但避免了引入交付约束之外的变量名。
  6. 不引入第二个彩色(除了 --chart-2 的深青)。 「待验收 / 已完成」这类状态只能靠 Badge variant 的明度差 + lucide 图标区分,色相上是相邻的。若后续产品要求「五色状态看板」,就必须打破单一色相族纪律——那会被记为对参考规则 1 的偏离。
  7. S6 语音频道只有代码级结论,没有视觉证据(R6)。

什么场景下不适用

  1. 需要五色以上的状态区分(如看板按优先级着色)时。 这套语言在「一个强 + 一组中性」下最干净;一旦要求 5–6 个高饱和状态色并存,单点橙的纪律就会失效,此时应转向以 --chart-1..5 为状态色的多色方案,并放弃参考的色彩纪律。
  2. 需要营销/品牌展示面时。 本方案删掉了 hero 段落(S3 群聊大厅)与色斑渐变,如果有对外宣传页,参考的 hero / logo strip / 衬线标题那套要另外取用。
  3. 深色是主场景时。 本方案浅色优先,深色令牌达标但落地成本更高(R1 + R3 两条独立工单);若产品决策是「以深色为主」,更合适的做法是把深色令牌作为主集、浅色作为派生,并先清掉硬编码色。
  4. 必须使用纯 /ffffff 白底(如第三方嵌入、打印预览)时。 本方案全站撤掉了纯白,卡片是 #fffdfb、画布是 #faf7f2;与外部白色内容并置时会看到轻微色差,这是参考「Don't use stark white」规则的直接后果。