暖纸工作台 — wanman /app 重设计方案(slug: intercom)

依据:共享简报 §3.3 实测值(test@3d35969f、1440×900,真实数据 580 用户 / 148 频道 / 1554 消息 / 457 任务)+ 本机证据 localtmp/design-render/*.json。 组件约束:只用 web/src/components/ui/ 现有 38 个官方组件与官方 variant/size。所有对比度用 WCAG 2.1 相对亮度公式实算。

方案名与主张

中文方案名:暖纸工作台(5 字)

一句话主张: 把「冷灰 SaaS 画布 + 飞书浅蓝气泡」换成一张暖奶油纸面,动作只用一个墨块、强调只留一支电光紫,让 457 条任务与 1554 条消息在同一张纸上靠色阶与留白分层,而不是靠阴影与九档圆角。

适用基调:浅色优先,深色完整对等。 参考 Intercom 是纯浅色体系(Theme: light),本方案把浅色做成主张与默认;深色按同一套暖中性逻辑做镜像(动作色反转为纸白块),并顺手修掉现状里 --surface-rail: #e3e5e8 在深色下是一条浅色竖带的缺陷。

参考提炼

从参考 DESIGN.md / design-extended 提炼的 5 条可迁移规则(括号内为原文要点):

  1. 暖奶油画布不可替换 — “Use warm cream (#faf9f6) as the default page background, not pure white or cool gray — the warmth is non-negotiable” → 画布取 #faf8f4,全部中性色换成暖灰(hue 40–60),消灭 #fcfcfc / #f2f3f5 / #dcdee1 / #5c5e66 这套冷灰。
  2. 填充主按钮是墨块,不是品牌色 — “Use black (#000000) for filled primary buttons — never the brand violet, never a tinted neutral” → --brand 取 #111111(浅)/ #f2efe8(深,反转),--primary 继续 var(--brand),Button 的 default variant 自动变成墨块,零 className 改动。
  3. 强调色少到“一屏最多一两次” — “Use the vivid violet (#0007cb) sparingly — maximum once or twice per screen, in small functional doses (icons, emphasis links, tag accents)” → 电光紫 #0007cb 只出现在三处:--brand-ink(选中项前景,chrome.ts:19 的 sidebar-selection)、--mention(@提及)、--brand-soft(8% 选中底)。深色对应 #8b93ff。
  4. 靠色阶而不是阴影分层 — “Never use shadows or drop-shadows on cards, buttons, or panels — depth comes from background tone shifts, not elevation” → 四级暖色阶:--surface-rail #eae6dc → --muted #f1eee7(工作区画布)→ --background #faf8f4(面板)→ --card #ffffff(卡片/浮层),并把 --shadow-e1/e2 压到近平面(只留 1px 暖色描边感)。
  5. 全局 4px 圆角 — “Apply 4px border-radius universally — buttons, nav, cards, inputs, tags all share the same sharp radius” → --radius: 0.625rem → 0.25rem,派生档位收敛为 --radius-sm 2.4px / md 3.2px / lg 4px / xl 5.6px / 2xl 7.2px / 3xl 8.8px / 4xl 10.4px。

适配判断

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

  1. 长时段驻留:#faf8f4 这类暖白在 1440×900 全屏驻留下比 #fcfcfc 冷白降低屏幕蓝光占比;同时画布/面板/卡片三级暖阶(1.09:1 / 1.06:1)让「消息列表 / 评论区 / 卡片」三栏在三米外可分,不需要给每个卡片加 ring 与阴影。
  2. 单色纪律对上「状态爆炸」:现状 Tailwind 原始调色板泄漏 253 处 / 44 个文件(amber 69、rose 68、slate 44、emerald 42、teal 12……),任务 6 态、连接 5 态、应用 3 态各用一套色相。改为「墨色动作 + 紫强调 + 暖中性」后,颜色不再承担状态语义,状态交给官方 Badge variant + 文案(见 §6-S3),跨深浅两套都能自动翻转。
  3. 暖中性对中文正文友好:#111111 墨色(相对纯黑 #000000 更软)在 #faf8f4 上 17.80:1,长时间阅读不刺眼;--muted-foreground #585858 在画布/亚麻/纯白上 6.71 / 6.14 / 7.11:1,满足正文 ≥4.5:1 且不靠纯黑堆对比。
  4. 4px 方角提高密度观感:现状圆角实测 12 档(2/6/7/8/10/12/14/18/24/26/32/9999px),同一屏内 10px 与 8px 混用(任务卡实测 10px×48、8px×37)。令牌统一到 4px 体系后,等间距的方角形成「印刷网格」的秩序感,正是高密度看板需要的。

必须舍弃的参考项(因产品形态/栈约束):

舍弃项 参考原文 原因 替代做法
300 字重 + 80/54px display “Set all display headlines at weight 300” 中文回退 PingFang SC / Noto Sans SC 无 300 字重可用字形,且 14–15px 中文小字在 300 下会发虚;styles.css 的 font-weight 位于 @layer base 与组件 className,令牌不可达 沿用现状正文 15px/400 与组件自带 font-medium/font-semibold(§5)
Serif 体(Serrif 16px/300) “Serrif — Editorial counterpoint” 无中文衬线回退,混排会碎 舍弃,中文用系统无衬线
SaansMono 12px + 1.2px 宽字距标签 “Apply SaansMono at 12px with 1.2px letter-spacing for any tag…” letter-spacing 只能靠 className 设置,令牌无此项 舍弃宽字距;--font-mono 仍用于任务号/时间/连接态
1200px 居中栏 + 64–96px 段落节奏 + hero/logo 墙/图集 “Page max-width: 1200px / Section gap: 64-96px” 这是营销落地页排版,/app 是满屏三栏工具 满屏 flex 布局,间距收敛到 8/12/16px 密度(§6)
Announcement bar、灰阶客户 logo 墙、图片条 Components 章节 产品内无此场景 舍弃

令牌映射

「途径」列取值:① = 语义令牌取值(本方案主战场,全部落在 web/src/styles.css);② = 官方 variant/size 选择;③ = 容器 flex/grid/尺寸/间距/滚动。下表全部是 ①,可直接照抄进 styles.css(另见 tokens.css)。

浅色 :root(现状值取自 web/src/styles.css:108-165)

变量名 当前值 建议值 意图
--background #fcfcfc #faf8f4 冷白 → 暖奶油画布(参考 “warm cream, not pure white or cool gray”);作为 main(app-shell.tsx:12275 的 bg-background)与面板底
--foreground #060607 #111111 纯黑 → 墨色(参考 Ink #111111),画布上 17.80:1
--card #ffffff #ffffff 不变:四级暖阶里最亮的一级,卡片/任务卡专用
--card-foreground #060607 #111111 与 --foreground 同步
--popover #ffffff #ffffff 浮层与卡片同面(参考 Card White)
--popover-foreground #060607 #111111 同上
--primary var(--brand) var(--brand) 不改变量,只让 --brand 变墨色 → 官方 Button variant="default" 自动成墨块(途径①,无需 variant 改动)
--primary-foreground var(--brand-foreground) var(--brand-foreground) 白字,墨底上 18.88:1
--secondary #ebedef #f1eee7 冷蓝灰 → 亚麻(搜索框 chrome.ts:65 的 bg-secondary/75、分段控件底)
--secondary-foreground #060607 #111111 亚麻上 16.30:1
--muted #f2f3f5 #f1eee7 工作区外层画布(chrome.ts:47 的 bg-muted),是画布下面一级
--muted-foreground #5c5e66 #585858 冷灰 → 暖石墨(参考 Graphite),画布 6.71:1 / 亚麻 6.14:1 / 纯白 7.11:1
--accent #ebedef #eeeae1 他人气泡 + 悬停面:对画布 1.13:1(现状他人气泡 #ebedef 对 #fcfcfc 是 1.14:1,密度手感守恒)
--accent-foreground #060607 #111111 气泡正文 15.73:1
--destructive #da373c #b42318 飞书红 → 暖砖红;纯白上 6.57:1,自身 10% 底上 5.58:1;chrome.ts:159 未读角标白字 6.57:1
--border #dcdee1 #dedbd6 冷发丝 → 暖发丝(参考 Hairline #dedbd6);保持低对比(1.38:1)作纯装饰分隔
--input #dcdee1 #948e80 表单边界必须 ≥3:1:白底 3.26:1、画布 3.07:1(满足 WCAG 1.4.11),Input 的 border-input(input.tsx:15)直接受益
--ring var(--brand) var(--brand) 焦点环 = 墨色,白底 18.88:1,不用彩色焦点(参考不用品牌色做动作)
--brand #2563eb #111111 动作色改为墨块(参考 “never use the brand violet as a button fill”)
--brand-foreground #ffffff #ffffff 墨底白字 18.88:1
--brand-soft rgb(37 99 235 / 0.12) rgb(0 7 203 / 0.08) 选中/::selection 底:唯一带电层,紫 8%;其上紫字 8.90:1、墨字 15.14:1
--brand-ink #1d4ed8 #0007cb 电光紫(参考 Electric Violet);chrome.ts:19 选中会话行前景 → 画布 10.46:1、选中底 8.90:1、自己气泡(#ece5d5) 8.84:1
--message-self #e8f3fe #ece5d5 飞书浅蓝 → 暖砂;经 message-bubble.tsx:5 把 --primary 映射到此值,无需改组件代码
--message-self-foreground #0d274a #111111 暖砂上墨字 15.05:1(现状 14px 深蓝改为与正文同色,顺带修掉两套字号里的颜色分叉)
--surface-chat-soft #e8f2ff #f6f2ea 会话悬停面暖化,对画布 1.05:1,不抢选中态
--surface-chat-selected #e5ecfc #eee9dd 会话选中面;对画布 1.14:1,配紫字(chrome.ts:19)9.16:1
--mention #3370ff #0007cb 消灭“三种蓝”中的第三种;@提及与强调同源,画布 10.46:1
--ink #060607 #111111 bg-ink(视频信箱 rtc-video-frame.tsx:48、落地页深色条带)用的最深面,冷黑 → 暖墨
--surface-rail #e1e8f2 #eae6dc 空间 rail 从蓝灰 → 暖石;对画布 1.17:1,是画面最深表面
--sidebar #fcfcfc #efece3 修简报 §3.3 的“零层级对比”:对画布 1.00:1 → 1.11:1(还需 §6-S1 的一处接线)
--sidebar-foreground #060607 #111111 侧栏底上 16.30:1
--sidebar-accent #ebedef #e4dfd2 侧栏行悬停/选中底:与侧栏底 1.13:1(两级侧栏层级首次可见),墨字 14.19:1
--sidebar-accent-foreground #060607 #111111 同上
--sidebar-border #dcdee1 #dedbd6 与 --border 同源暖发丝
--chart-1 oklch(0.87 0 0) #dedbd6 图表阶梯去冷灰,改暖中性(1 浅 → 5 深),不引入第二色相
--chart-2 oklch(0.556 0 0) #b8b2a4 同上
--chart-3 oklch(0.439 0 0) #8a8477 同上
--chart-4 oklch(0.371 0 0) #585349 同上
--chart-5 oklch(0.269 0 0) #2b2921 同上
--radius 0.625rem(10px) 0.25rem(4px) 参考全局 4px;派生档位 2.4–10.4px,统一现状 12 档圆角(10px×48 / 8px×37 混用)
--sidebar-primary var(--brand) var(--brand) 不变,随墨色动作色
--sidebar-primary-foreground var(--brand-foreground) var(--brand-foreground) 不变
--sidebar-ring var(--ring) var(--ring) 不变
--interactive #4e5058 #52504a 非链接图标/文字通用色暖化,画布 7.60:1
--channel-icon #80848e #8a8579 频道图标:暖石灰,画布 3.47:1(≥3:1 图形下限)
--workspace-background linear-gradient(180deg,var(--surface-rail),#e1e5f1) linear-gradient(180deg,var(--surface-rail),#e2ddd0) 渐变末端去蓝,保持 rail → 画布的暖阶过渡
--workspace-rail-background transparent transparent 不变
--workspace-header-background var(--background) var(--background) 不变(随笔面暖化)

深色 .dark(现状值取自 web/src/styles.css:167-208)

说明:简报 §3.3 实测「全仓无代码添加 .dark,深色在生产不可达」。本方案的深色是对等设计,不是「现状可用」——按同一套暖中性逻辑做镜像,并修掉现状缺陷。

变量名 当前值 建议值 意图
--background oklch(0.145 0 0) #14130d 冷黑 → 暖炭(去色度但保留暖 hue);卡片/浮层在它之上 1.12:1
--foreground oklch(0.985 0 0) #f4f1e8 纸白,炭底上 16.47:1(不用纯白,避免大面积生硬)
--card oklch(0.205 0 0) #201e16 暖炭卡面,对画布 1.12:1
--card-foreground oklch(0.985 0 0) #f4f1e8 卡面上 14.77:1
--popover oklch(0.205 0 0) #201e16 与卡片同面
--popover-foreground oklch(0.985 0 0) #f4f1e8 同上
--primary var(--brand) var(--brand) 深色下 --brand = 纸白 → 主按钮成为纸白块 + 暖炭字,与浅色墨块互为镜像
--primary-foreground var(--brand-foreground) var(--brand-foreground) 炭字,纸白底上 16.20:1
--secondary oklch(0.269 0 0) #262319 暖次级面,对画布 1.18:1
--secondary-foreground oklch(0.985 0 0) #f4f1e8 次级面上 13.91:1
--muted oklch(0.269 0 0) #262319 工作区外层画布(深色)
--muted-foreground oklch(0.708 0 0) #a9a397 中性灰 → 暖灰:画布 7.42:1 / 卡面 6.65:1 / 次级面 6.26:1
--accent oklch(0.269 0 0) #2a271c 他人气泡/悬停面:对画布 1.25:1、对卡面 1.12:1
--accent-foreground oklch(0.985 0 0) #f4f1e8 气泡正文 13.23:1
--destructive oklch(0.704 0.191 22.216) #ff9d8a 深底用亮暖珊瑚:画布 9.25:1、20% 底上 5.50:1。风险见 §8(chrome.ts:159 的 text-white 未读角标在此值下仅 2.01:1)
--border oklch(1 0 0 / 10%) #3a3629 半透明白改实色暖发丝,卡面 1.38:1,不再随底下色层浮动
--input oklch(1 0 0 / 15%) #736b56 表单边界 ≥3:1:画布 3.51:1、卡面 3.15:1
--ring —(未定义,回落到 :root 的 var(--brand) 链) var(--brand) 显式写出,焦点环 = 纸白,卡面上 14.53:1
--brand oklch(0.68 0.15 256) #f2efe8 蓝 → 纸白动作块(深色镜像)
--brand-foreground oklch(0.16 0.02 258) #14130d 与画布同色,块上 16.20:1
--brand-soft oklch(0.28 0.05 256) rgb(139 147 255 / 0.16) 深色下强调底改为带电紫 16%;其上纸白字 11.39:1、紫字 4.72:1
--brand-ink oklch(0.84 0.09 256) #8b93ff 电光紫的深色版;卡面 6.13:1、次级面 5.77:1、自己气泡上 5.37:1
--message-self #203b59 #2d2820 冷蓝 → 暖炭棕(自己气泡),对画布 1.27:1、对卡面 1.14:1
--message-self-foreground #e7f3ff #f4f1e8 暖炭棕上纸白 12.95:1
--surface-chat-soft oklch(0.32 0.06 250) #1b1912 会话悬停面,对画布 1.06:1
--surface-chat-selected oklch(0.28 0.04 250) #232017 会话选中面,对画布 1.14:1,配紫字 5.98:1
--mention oklch(0.72 0.14 254) #8b93ff 与 --brand-ink 同值,深色下卡面 6.13:1
--ink oklch(0.16 0.02 258) #0b0a06 不翻转:--ink 语义是「最深表面」(rtc-video-frame.tsx:48 视频信箱),深色下只需去蓝调
--surface-rail #e3e5e8 #0d0c08 修缺陷:现状深色下是浅色 #e3e5e8,会在深色画面左侧留一条浅竖带;改为画面最深暖黑,对画布 1.05:1、对侧栏 1.20:1
--sidebar oklch(0.205 0 0) #232018 暖侧栏面,对画布 1.14:1(浅色同项 1.11:1,两套观感一致)
--sidebar-foreground oklch(0.985 0 0) #f4f1e8 侧栏底上 14.40:1
--sidebar-accent oklch(0.269 0 0) #2e2b20 行悬停底,与侧栏底 1.15:1,纸白字 12.54:1
--sidebar-accent-foreground oklch(0.985 0 0) #f4f1e8 同上
--sidebar-border oklch(1 0 0 / 10%) #3a3629 与 --border 同源
--sidebar-primary / --sidebar-primary-foreground / --sidebar-ring 仅 :root 定义(经 var() 链解析) 在 .dark 显式补 var(--brand) / var(--brand-foreground) / var(--ring) 修「深色块缺这三项」的隐性依赖,避免将来有人把 .dark 拆到独立文件时断链
--chart-1…--chart-5 oklch(0.87/0.556/0.439/0.371/0.269 0 0) #3a3629 / #6b6555 / #9c9584 / #c9c2b1 / #f2efe8 深色暖中性阶梯(1 深 → 5 浅)
--interactive 未定义于 .dark #a9a397 深色下交互色必须向亮侧走,否则贴炭底不可读(画布 7.42:1)
--channel-icon 未定义于 .dark #948f80 频道图标 5.76:1
--workspace-background radial-gradient(ellipse at 8% 0%, color-mix(in oklab, var(--brand) 10%, var(--muted)), var(--muted) 64%) linear-gradient(180deg, #0d0c08, #1a1811) 去掉「品牌色光晕」(参考体系不用光晕),改为 rail → 画布的暖阶
--radius (var(--brand) 无关;半径由 :root 的 --radius 继承) .dark 内不重定义,继承 0.25rem 深浅同圆角

字体与排版

字体栈

现状(styles.css:33-38):"Geist Variable", "gg sans", "Noto Sans SC", "PingFang SC", ui-sans-serif, system-ui, "Segoe UI", "Microsoft YaHei", Roboto, Helvetica, Arial, sans-serif

唯一 ① 改动:PingFang SC 提到 Noto Sans SC 之前,其余顺序与字族不动(--font-sans 是真实存在的 @theme inline 变量):

--font-sans:
  "Geist Variable", "gg sans", "PingFang SC", "Noto Sans SC", ui-sans-serif,
  system-ui, "Segoe UI", "Microsoft YaHei", Roboto, Helvetica, Arial, sans-serif;

字号/行高/字重阶梯

先说清楚约束:styles.css 的 body { @apply … text-[15px] leading-[1.375] }(:270 附近 @layer base)与各组件的 text-sm/text-xs 都不在变量块内,令牌途径 ① 无法改变字号、字重、行高与字距。因此本方案的排版主张是「不新增刻度、只收敛来源」,可执行的动作只有两条:

角色 现状实测 本方案处置 途径
正文 body 15px/400、行高 1.375(20.63px);他人消息 15px、自己消息 14px(同一列表两套字号) 字号保持 15px/1.375(满足简报「14–15px、行高 ≥1.375」);自己消息的 14px 由组件侧 text-sm 决定,属 ②(官方 size/variant 选择),本方案不承诺改动,仅把颜色统一到 --foreground #111111(原先 14px 配 #0d274a,靠色差补偿字号差,观感更碎) ①(颜色)+ ②(可选)
频道头标题 16px/600 #060607 保持 16px/600,颜色随 --foreground → #111111 ①
次级/元信息 12px/500 #5c5e66、11.25px(会话预览)、12.8px/500 ×2765(AI 空间最密视图) 不新增档位;--muted-foreground #585858 提升可读性(6.14–7.11:1);11.25px 这类 em 派生小数字号属组件 className,不改(见 §8 风险) ①
标签/徽标 Badge 官方 text-xs(12px)+ h-5;Button size="xs" 为 text-xs 用官方 size 选择制造层级:主行动 size="default"(h-8)、次行动 size="sm"(h-7)、表格内 xs(h-6)、图标按钮 icon-sm(28px) / icon(32px) ②
代码/数字 --font-mono 保持;任务号、时间、连接态、计数(5 项任务)用 mono + tabular-nums(官方 chrome.ts:159 已用) ①
标题层级 弹窗标题 18px/600、登录主标题 26px/700 不改字号/字重(令牌不可达);靠容器留白与 Card/Dialog 官方结构建立层级 ③

关键界面改造

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

现状(实测):空间 rail nav 72×900、背景 transparent、右边框 rgba(220,222,225,0.55)(≠ --border #dcdee1);会话侧栏 aside 256×715 @x=76、border-radius 14px、background #fcfcfc,与页面底 #fcfcfc 完全相同(1.00:1);侧栏头部 52px;搜索框底 rgba(235,238,239,0.75);会话行 240×64。

改后

# 改动 途径 证据/文件
1 侧栏底 #fcfcfc → #efece3,对画布 1.00:1 → 1.11:1;行悬停/选中底 #ebedef → #e4dfd2,与侧栏底 1.13:1 ① --sidebar / --sidebar-accent;styles.css:158/162
2 接线:chrome.ts:55 的 imListAside 由 bg-background 改为 bg-sidebar(sidebarAside(:40)本就是 bg-muted,可选择同步改为 bg-sidebar)——这是让 #1 生效的唯一代码改动,是类指向语义令牌,不新增任何视觉覆盖、不改尺寸/字号/圆角 ①(接线) chrome.ts:55、channel-sidebar.tsx:466、im-sidebar.tsx:226
3 侧栏圆角 14px → 5.6px(rounded-xl = --radius × 1.4) ① im-sidebar.tsx:226 的 md:rounded-xl
4 空间 rail 底 #e1e8f2 → #eae6dc,对画布 1.17:1,rail 首次成为「最深表面」;图标按钮 71×48 的 hover 面用 --brand(墨)+--brand-foreground(白) ① --surface-rail;chrome.ts:35/38 的 hover:bg-brand
5 搜索框底 rgba(235,238,239,0.75) → var(--secondary)/75 = #f1eee7,聚焦态 focus-within:bg-background 也随画布暖化,圆角 rounded-xl 14px → 5.6px ① chrome.ts:65
6 侧栏行高密度保持 h-[34px](chrome.ts:156)/ 会话行 240×64,行间距 gap 与内边距不动(现状密度是好的,参考的 comfortable 密度不适用于此) ③(不改) chrome.ts:156
7 未读角标 bg-destructive(chrome.ts:159):浅色白字 6.57:1 达标;深色 --destructive #ff9d8a 下白字只有 2.01:1 → 见 §8 风险与修法 ①/风险 chrome.ts:159

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

现状(实测):频道头 860×52,标题 16px/600 #060607,成员数 12px/500 #5c5e66;气泡圆角 14px;他人气泡 rgb(235,237,239)(= --accent #ebedef),自己气泡 rgb(232,243,254)(= --message-self)+ 文字 #0d274a;消息正文他人 15px/400 + 自己 14px/400;作者 13px/400、时间 12px/500 #5c5e66;输入框只有上边框 rgb(220,222,225)。

改后

# 改动 途径 证据/文件
1 他人气泡 #ebedef → #eeeae1(暖),对画布 1.13:1(与现状 1.14:1 手感守恒);他人正文 #060607 → #111111 15.73:1 ① styles.css:127/131;message-list.tsx 用 bg-accent
2 自己气泡 #e8f3fe → #ece5d5、文字 #0d274a → #111111(15.05:1)——顺带消除「自己气泡蓝字配 14px」这套独立配色 ① message-bubble.tsx:5-6 已把 --primary 映射到 --message-self,无需改组件
3 气泡圆角 14px → 5.6px(rounded-xl 派生) ① --radius
4 频道头标题/成员数颜色随手(#060607→#111111、#5c5e66→#585858,后者 6.71:1);成员数保持 12px/500(中文最小 12px 下限) ① --foreground / --muted-foreground
5 输入区外层上边框 rgb(220,222,225) → --border #dedbd6;textarea 628×33 无边框保持不变(现状克制,是对的) ① styles.css:273
6 悬停动作条(点赞/回复/更多/已读状态「4 人未读」):4 人未读 用官方 Badge variant="outline" + text-muted-foreground,不再用裸 span 上色 ② 组件里现为自绘 chip(message-list.tsx:3708 的 rounded-md border px-1.5 text-[15px])
7 消息列宽度:message-list.tsx:3950 已有 max-w-[72ch](15px 下约 640px)、气泡 max-w-[min(100%,66.667cqw)](860px 列 → 573px)保持不变;仅把消息组之间的垂直间距在容器层从 12px 提到 16px(gap-4),使「暖纸」排版有段落呼吸 ③ message-list.tsx:3414/3950

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

现状(实测):看板标题 16px 级;筛选「全部频道 / 5 项任务」;列头「待补充 0 / 待处理 5」;卡片 = 标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人;圆角混用 10px×48、8px×37;群聊大厅是营销式 hero + 群卡片,品牌蓝 rgb(37,99,235) 出现 20 处。

改后

# 改动 途径 证据/文件
1 圆角统一:所有由 --radius-* 派生的卡角 → 4 / 7.2 / 5.6px;硬编码 rounded-[10px](48 处)属组件 className,不在令牌可达范围 → §8 风险 ①/风险 --radius: 0.25rem
2 品牌蓝 20 处 → 墨色(--brand #111111):Button variant="default"(发布任务)成为墨块;链接型动作 variant="link";所有 bg-brand/text-brand 自动换色 ① chrome.ts:38/130;Button default/link variant
3 6 个任务状态收敛为纯单色 variant 组合(消灭 amber/rose/slate 硬编码):待补充 = Badge variant="outline";待处理 = secondary;进行中 = default(墨块,唯一实心);待验收 = outline;已完成 = ghost;已关闭 = ghost + text-muted-foreground;逾期/风险 = destructive ② 官方 Badge 6 个 variant 全覆盖(badge.tsx:14-27)
4 卡内层级:标题 14px/500 保持(font-medium 是组件默认);频道 chip 与 AI 助手 chip 用 Badge variant="secondary"(暖亚麻底)+ variant="outline",颜色全部来自 --secondary/--border,深浅自动翻转 ② Badge
5 列宽与滚动:看板列容器(task-hall.tsx)保持 flex 横排 + overflow-x-auto;列头「待处理 5」的计数用 --font-mono + tabular-nums;列内卡片间距 gap-2(8px)、卡片内边距不动 ③ --font-mono
6 群聊大厅去营销化:hero 段落的容器内边距与标题字号不改(令牌不可达),改由色阶降调——hero 底 --muted #f1eee7、群卡片 --card #ffffff(1.16:1),品牌蓝消失后页面不再是「落地页蓝」 ① --muted / --card
7 create-task-dialog:Dialog 底 --popover #ffffff、圆角 18px → 7.2px、遮罩 --border 系暖色;必填错误用 aria-invalid:border-destructive(官方内建)+ --destructive #b42318 ① dialog.tsx 官方结构

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

现状(实测):AI 助手空间是全站最密视图(395 项任务),单次渲染字号档位 12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724;圆角 8px ×1591、10px ×844;agent-chat-panel.tsx:262 的面板为 border-border/45 bg-background。

改后

# 改动 途径 证据/文件
1 面板底 bg-background #faf8f4 vs 工作区画布 --muted #f1eee7(1.06:1),面板分界从 45% 半透明边框改为实色 --border #dedbd6(1.38:1)——层级不再依赖透明度叠加,深浅两套一致 ① agent-chat-panel.tsx:262
2 圆角 8px / 10px 混用 → 全部走 --radius 派生(4 / 5.6 / 7.2px);硬编码 rounded-[8px](1591 处量级)属 className → §8 风险 ①/风险 --radius
3 流式回答的「等待态」:AI 回答空格/思考中的三个呼吸点保持官方 --animate-breathe,但点色由 --brand(墨)承担——参考体系里「无彩色动作」;来源引用(citation chip)改用官方 Badge variant="outline",链接色用 --brand-ink 紫(10.46:1),与 @提及同源 ①② styles.css:52;Badge
4 结果卡片(agent-channel-results.tsx)改用官方 Card size="sm" + Item(item.tsx)列表结构:卡片底 --card #ffffff、卡内分隔用官方 Separator(--border),弃用自绘描边 + 阴影 ② card.tsx、item.tsx、separator.tsx
5 摘要面板(channel-summary-panel.tsx)的 summary-view 滚动容器保持 min-h-0 flex-1 overflow-auto;仅在容器层把节间距从 12px 提到 16px,长摘要按「暖纸段落」阅读 ③ app-shell.tsx:12632
6 密度纪律:现状 12.8px 这类 em 派生字号不改(令牌不可达),但禁止本方案新引入任何字号/字距;密度收益只来自色阶与边界清晰度(1.09–1.38:1 的可见分界替代模糊半透明边框) ① —

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

现状(实测,S5-dialog-geometry.json):[role=dialog] 704×512、圆角 18px、底 #ffffff;左侧导航项 135×36、圆角 8px,选中态底 rgb(37 99 235/0.12) + 前景 #1d4ed8,危险项前景 #da373c;输入框 488×32、圆角 10px;表单标签 14px;「保存」按钮 96×32、底 rgb(37,99,235)、白字。

改后

# 改动 途径 证据/文件
1 弹窗圆角 18px → 7.2px(rounded-2xl = --radius × 1.8),底 --popover #ffffff,与暖画布形成 1.06:1 的「纸上有纸」 ① --radius;app-shell.tsx:13298 同族类
2 电光紫的主要落点:左侧导航选中态底 rgb(37 99 235/0.12) → var(--brand-soft) = rgb(0 7 203/0.08)、前景 #1d4ed8 → var(--brand-ink) #0007cb。这是全方案紫出现最集中的一屏(选中项 + ::selection),符合参考「一屏最多一两次、小而功能化」 ① --brand-soft / --brand-ink
3 危险项前景 #da373c → --destructive #b42318(白底 6.57:1);删除确认用官方 AlertDialog + Button variant="destructive"(bg-destructive/10 text-destructive),不用红底白字 ①② alert-dialog.tsx、button.tsx:22
4 表单:输入框 488×32 的圆角 10px → 4px(rounded-lg = --radius),边界 #948e80(白底 3.26:1,满足 1.4.11);标签 14px 保持;必填/错误态用官方 aria-invalid 样式(input.tsx:15) ① input.tsx
5 表单结构改用官方 Field / FieldGroup(field.tsx 已装)+ InputGroup(input-group.tsx)替代自绘「标签 + 输入」两行块,间距由官方 gap 决定 ② field.tsx
6 「保存」按钮 96×32 → 官方 Button variant="default" size="default"(h-8),底从 #2563eb 变墨块;同排「取消」用 variant="outline",主次对比从「蓝 vs 白」变成「墨 vs 描边」,更接近参考的 filled/ghost 配对 ② button.tsx:19-24
7 权限选择器(channel-permission-picker.tsx):权限项用官方 Checkbox + Item(item.tsx 的 rounded-lg border 行)而非自绘行;选中行底 --accent #eeeae1(对卡面 1.20:1) ② checkbox.tsx、item.tsx

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

现状(实测):居中卡片;主标题 26px;「邮箱验证码 / 短信验证码」切换块 173×42(选中底 #fcfcfc + 品牌蓝文字);主按钮 356×52、白字、底 #2563eb;页脚 11px;文案「登录 WanChat / 使用企业邮箱验证码继续 / 企业邮箱 @example.com / 获取验证码」。

改后

# 改动 途径 证据/文件
1 主按钮 356×52 从 #2563eb → #111111 墨块(白字 18.88:1)。这是全产品最大的一块实色,参考原文「“just a solid black block that anchors visually against the warm cream canvas” 的签名效果」在此处最成立 ① --brand / --brand-foreground
2 页面底 #fcfcfc → #faf8f4,卡面保持 #ffffff(1.06:1)——未登录用户的第一印象就是「暖纸」 ① --background / --card
3 切换块选中态:底 #fcfcfc → --background #faf8f4、文字由品牌蓝 → --brand-ink #0007cb(紫 10.46:1);未选中文字 --muted-foreground #585858。两个 tab 的区分靠「底 + 紫字」而不是两种蓝 ① --brand-ink / --muted-foreground
4 邮箱输入框边界 → --input #948e80(白底 3.26:1);「获取验证码」用 Button variant="outline" size="sm"(h-7)与主按钮 52px 形成明确主次 ①② button.tsx
5 卡片圆角随 --radius 收敛(18px → 7.2px),居中容器宽度与 26px 主标题、11px 页脚不动 ① --radius
6 11px 页脚:低于简报「中文最小 12px」下限,但它来自组件 className(令牌不可达)→ §8 风险 风险 login.tsx

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

现状(实测):分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」+ 卡片(运行中 / 开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息)。

改后

# 改动 途径 证据/文件
1 卡片底 --card #ffffff、页面工作区底 --muted #f1eee7(1.16:1),去掉卡片阴影与彩色描边 ① --card / --muted
2 徽标:运行中 = Badge variant="default"(墨块,唯一实心);开发中 = Badge variant="secondary"(暖亚麻);不再用 amber/emerald 硬编码 ② badge.tsx
3 元信息行 Agent · 第三方 · chat 用 --muted-foreground #585858、分隔符用官方 Separator orientation="vertical" ① separator.tsx
4 emoji 图标 → lucide 图标:components.json 已声明 iconLibrary: lucide,图标外框用官方 Avatar(size="lg" 40px)+ AvatarFallback(默认 bg-muted text-muted-foreground),彻底消除「emoji 与整套图标语言不一致」的缺口 ② avatar.tsx、components.json:12
5 网格:容器用 grid gap-4 + grid-cols-[repeat(auto-fill,minmax(240px,1fr))](现状卡片宽度不一致),卡片内边距走官方 Card 的 --card-spacing(card.tsx 默认 16px / size="sm" 12px) ③ card.tsx
6 分类筛选保留官方 Tabs variant="line"(tabs.tsx 的 line 变体,激活项靠下划线而非填色)——比现状的填色 chip 更贴近参考的“Tab Navigation… the underline is the only state indicator”;8 个分类在 1440px 下换行布局 ②③ tabs.tsx:29-38

S6 语音频道(本栈不可见,仅代码依据)

简报 §3.3 实测:本机 TRTC_ENABLED=false,DOM 内 aria-label 匹配「语音|通话|加入」命中 0,/api/v1/rtc/* 返回 RTC_DISABLED,界面不渲染任何语音元素(库里 wanman3_rtc_voice_channels 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行仍在)。因此本节没有任何截图依据,唯一可说的是令牌侧的连带影响:rtc-video-frame.tsx:48 与 rtc-mini-window.tsx:36/174 用 bg-ink / text-ink 做视频信箱与按钮态,本方案把 --ink 从冷黑 #060607 改为暖墨 #111111(浅)/ #0b0a06(深),视频区域的边框色会随之去蓝。视频画面本身与 rtc-group-call-ui.tsx 的成员状态未做实测,不在本方案承诺范围。

深浅色与对比度

实算公式:WCAG 2.1 相对亮度 L = 0.2126R + 0.7152G + 0.0722B(sRGB 线性化后),比值 (L1+0.05)/(L2+0.05)。阈值:正文 ≥4.5:1,大字号/图形边界 ≥3:1。

浅色

组合 前景 hex 背景 hex 比值 达标
正文 / 画布 #111111 #faf8f4 17.80:1 ✅ AAA
正文 / 卡面 #111111 #ffffff 18.88:1 ✅ AAA
正文 / 自己气泡 #111111 #ece5d5 15.05:1 ✅ AAA
正文 / 他人气泡 #111111 #eeeae1 15.73:1 ✅ AAA
次级文字 / 画布 #585858 #faf8f4 6.71:1 ✅ AA
次级文字 / 卡面 #585858 #ffffff 7.11:1 ✅ AA
次级文字 / 亚麻 #585858 #f1eee7 6.14:1 ✅ AA
次级文字 / 侧栏 #585858 #efece3 6.02:1 ✅ AA
次级文字 / 侧栏悬停底 #585858 #e4dfd2 5.35:1 ✅ AA
次级文字 / 自己气泡 #585858 #ece5d5 5.67:1 ✅ AA
强调(电光紫)/ 画布 #0007cb #faf8f4 10.46:1 ✅ AAA
强调 / 选中底 #0007cb #eee9dd 9.16:1 ✅ AAA
强调 / 自己气泡(@提及) #0007cb #ece5d5 8.84:1 ✅ AAA
强调 / 紫 8% 选中底 #0007cb #e6e5f1 8.90:1 ✅ AAA
墨底动作按钮文字 #ffffff #111111 18.88:1 ✅ AAA
危险 / 卡面 #b42318 #ffffff 6.57:1 ✅ AA
危险 / 自身 10% 底(Badge destructive) #b42318 #f3e3de 5.58:1 ✅ AA
表单边界 / 卡面(图形 3:1) #948e80 #ffffff 3.26:1 ✅ 1.4.11
表单边界 / 画布 #948e80 #faf8f4 3.07:1 ✅ 1.4.11
频道图标 / 画布(图形 3:1) #8a8579 #faf8f4 3.47:1 ✅ 1.4.11
侧栏底 / 画布(表面分层,非规范项) #efece3 #faf8f4 1.11:1 ⚪ 说明:现状是 1.00:1;表面分层不属 WCAG 文本/图形要求,此处追求「可辨色阶」而非 3:1
发丝边框 / 画布(装饰分隔) #dedbd6 #faf8f4 1.30:1 ⚪ 纯装饰,不承担边界识别;需要被识别的边界一律用 --input(≥3:1)

深色

组合 前景 hex 背景 hex 比值 达标
正文 / 画布 #f4f1e8 #14130d 16.47:1 ✅ AAA
正文 / 卡面 #f4f1e8 #201e16 14.77:1 ✅ AAA
正文 / 自己气泡 #f4f1e8 #2d2820 12.95:1 ✅ AAA
正文 / 他人气泡 #f4f1e8 #2a271c 13.23:1 ✅ AAA
次级文字 / 画布 #a9a397 #14130d 7.42:1 ✅ AA
次级文字 / 卡面 #a9a397 #201e16 6.65:1 ✅ AA
次级文字 / 次级面 #a9a397 #262319 6.26:1 ✅ AA
次级文字 / 侧栏 #a9a397 #232018 6.48:1 ✅ AA
强调 / 画布 #8b93ff #14130d 6.84:1 ✅ AA
强调 / 卡面 #8b93ff #201e16 6.13:1 ✅ AA
强调 / 自己气泡 #8b93ff #2d2820 5.37:1 ✅ AA
强调 / 紫 16% 选中底 #8b93ff #31313b 4.72:1 ✅ AA
纸白动作按钮文字 #14130d #f2efe8 16.20:1 ✅ AAA
危险 / 卡面 #ff9d8a #201e16 8.30:1 ✅ AAA
危险 / 自身 20% 底 #ff9d8a #4d372d 5.50:1 ✅ AA
表单边界 / 画布(3:1) #736b56 #14130d 3.51:1 ✅ 1.4.11
表单边界 / 卡面(3:1) #736b56 #201e16 3.15:1 ✅ 1.4.11
频道图标 / 画布(3:1) #948f80 #14130d 5.76:1 ✅ 1.4.11
侧栏底 / 画布(表面分层) #232018 #14130d 1.14:1 ⚪ 同浅色说明

两套都达标:所有正文组合 ≥5.35:1(浅)/ ≥5.37:1(深),所有需要被识别的边界 ≥3.07:1(浅)/ ≥3.15:1(深)。

shadcn 兼容性

结论:主路径完全可行,无需新增组件,无需自定义 variant

官方 variant/size 已覆盖本方案全部所需状态:Button 6 variant(default / outline / secondary / ghost / destructive / link)× 8 size(xs / sm / default / lg / icon-xs / icon-sm / icon / icon-lg);Badge 6 variant;Tabs 2 variant(default / line);Avatar 3 size。用到的组件全部已在 web/src/components/ui/(38 个)中:

button · badge · input · textarea · tabs · avatar · separator · card · item · dialog · alert-dialog · dropdown-menu · select · checkbox · radio-group · tooltip · scroll-area · field · input-group · skeleton · table · popover → 无需引入尚未安装的官方组件。

逐条改造的合规性判定

改造 是否合规 说明
§4 全部令牌取值(含 --radius 4px、--shadow-e1/e2 压平) ✅ 途径① 只改 styles.css 变量块的值,不新增选择器、不用 !important
使用官方 variant 表达状态(Badge 6 态、Button 主次) ✅ 途径② 不新增 variant、不传 className 覆盖颜色
容器 grid/gap/max-width/overflow 调整(§6 各表 ③ 行) ✅ 途径③ 只动 flex/grid、尺寸、间距、滚动
chrome.ts:55 imListAside 的 bg-background → bg-sidebar;chrome.ts:40 同族 ⚠️ 边界 这是把已有类指向语义令牌(一句话、无新覆盖、无尺寸/字号/颜色字面量),归入途径①的“接线”。若评审认为「途径①仅限 styles.css」,则 S1 的侧栏分层只能回退成「侧栏与画布同色 + 依赖 1px --sidebar-border」,层级改善从 1.11:1 降为仅靠发丝线——需评审裁决,本方案默认按接线处理
保留 253 处 Tailwind 原始调色板中的状态色 ❌ 不合规 官方 Badge 没有 6 个语义状态色。本方案的做法是删掉这些 className(text-amber-700、bg-rose-50、border-slate-100…)改用官方 variant——这是「删除自定义覆盖」,方向合规但工作量落在 44 个非测试文件(见 §9)
头像首字底色硬编码(amber/rose/blue/emerald/teal 的 50/700 配对) ❌ 不合规 Avatar 无 variant,只能收敛到 AvatarFallback 默认(bg-muted text-muted-foreground);代价是首字头像的 5 种色相消失
硬编码圆角(rounded-[10px] ×48、rounded-[8px] ×37、AI 空间 8px×1591/10px×844) ❌ 不合规(残留) 令牌只能收敛 --radius-* 派生值;字面量 px 需逐处删除。本方案不承诺清零,按优先级处理:任务卡 > 弹窗 > AI 空间
chrome.ts:163 硬编码 text-[#f06f66];chrome.ts:144 text-[13px];login.tsx 页脚 11px ❌ 不合规(残留) 分别是硬编码色与硬编码字号;建议改用 text-destructive(官方类)与不新增字号档;11px 页脚低于中文 12px 下限,需产品决定是否恢复 12px
深色下 chrome.ts:159 未读角标 bg-destructive text-white ⚠️ 明确风险 --destructive(深)= #ff9d8a 时白字仅 2.01:1(浅色 6.57:1 达标)。修法:把该处 text-white 换成 text-background(深色下 #14130d,对 #ff9d8a = 9.25:1);或深色 --destructive 取 #c2410c 系(但会让「危险文字」在深底降到 ~3.4:1,不推荐)。本方案推荐前者,并把该处标注为「必须一并修的风险点」

实施成本

改动面

文件 改动性质 规模
web/src/styles.css 替换 :root(约 58 行)、.dark(约 42 行)、@theme inline 中的 --font-sans 与 --shadow-e1..pop 约 110 行,1 人 × 0.5 天(照抄 tokens.css)
web/src/components/app/chrome.ts 1 行接线(:55 bg-background → bg-sidebar)+ 2 处硬编码清理(:144 text-[13px]、:163 text-[#f06f66])+ :159 text-white → text-background 4 行,0.2 天
状态色收敛(44 个文件、253 处 Tailwind 原始调色板) 删除 className 覆盖 → 官方 Badge/Button variant 8–12 人天(按文件分批:任务相关 12 文件优先,其余按可见性排序)
硬编码圆角清理(rounded-[10px] 48 处 + rounded-[8px] 37 处 + AI 空间量级更大的 8/10px) 删除 px 字面量 → rounded-lg/md 3–5 人天
头像 5 色相收敛到 AvatarFallback 默认 删除 50/700 配对 1 人天
emoji → lucide 图标(S8) 替换图标实现 0.5 人天
③ 容器调整(S2 消息组 gap-4、S8 grid、S4 面板分界) flex/grid/间距 1 人天
合计 约 15–20 人天(其中令牌与接线 0.7 天即出可见效果)

风险清单

  1. --radius 10px → 4px 是全局观感突变:影响 Button(h-8)、Input(h-8)、Dialog(704×512)、Card、Badge(圆角 26px → 10.4px)。缓解:先在 test 部署观察一天;如过锐,回退到 --radius: 0.375rem(6px),派生范围 3.6–15.6px,其余令牌不变。
  2. 深色主题在生产不可达(简报 §3.3:全仓无代码添加 .dark):本方案深色是「设计对等」,真正上线需要单独引入主题切换(不在本方案范围)。此外深色下现状有 55 处前景 rgb(6,6,7) 硬编码、27 处 rgb(92,94,102)、6 处边框 rgb(220,222,225)、头像 3 处浅色底 —— 这些不改,深色永远半不可读,令牌只能解决其中走语义变量的部分。
  3. 表面分层仍偏弱:浅色侧栏/画布 1.11:1、深色 1.14:1。这是暖中性色的固有代价(暖色系在低对比区的可辨性弱于冷灰 + 半透明描边)。若评审要求 ≥1.3:1,需回到「侧栏加一层 ring」——那是组件样式改动,超出三途径,本方案不做。
  4. 单色状态:6 个任务状态靠 variant 与文案区分,扫视识别速度低于现状 6 色。若产品坚持保留色相语义,本方案在这一项上不达标(需要自定义 variant → 违规)。
  5. --input 3.07–3.26:1 是刻意提高的边界对比:比现状 #dcdee1(1.35:1)明显更重,会让表单看起来「更工业」。这是为满足 WCAG 1.4.11 的取舍,不是视觉偏好。
  6. tokens.css 里的 @theme inline 只改了 3 类值(--font-sans 顺序、--shadow-* 颜色与强度);若团队要求 @theme inline 逐字节不动,则把这几行还原,其余方案不受影响。

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

  1. getComputedStyle(document.documentElement).getPropertyValue('--brand') → 浅色应为 #111111,深色注入 .dark 后应为 #f2efe8。
  2. 复算简报 §3.3 的三个探针:会话侧栏 aside 的 background 应为 rgb(239,236,227)(#efece3),与 body 的 rgb(250,248,244) 不再相同;他人气泡 background 应为 rgb(238,234,225);自己气泡应为 rgb(236,229,213)。
  3. 弹窗几何:[role=dialog] 的 border-radius 应从 18px 变为 7.2px;左侧导航选中项前景应从 rgb(29,78,216) 变为 rgb(0,7,203)、底色变为 rgba(0,7,203,0.08) 合成值 ≈ rgb(230,229,241)。
  4. 用 leaks-*.json 的普查脚本重跑:Tailwind 原始调色板命中数应随状态色收敛从 253 处单调下降;rgb(6,6,7) 硬编码应从 55 处下降。
  5. 对比度:对本方案 §7 表中的 20 组组合做一次自动采样(同一脚本),比值应落在标注值 ±0.05 内。

取舍

解决了什么

牺牲了什么

什么场景下不适用

  1. 需要强色相语义的看板(如甘特/依赖图/多状态流转图):单色纪律会让状态可辨识性下降,应改用其它强调色更多的方案。
  2. 深色为默认的团队:本方案深色对等但为镜像设计(动作色是纸白块),视觉锚点弱于浅色;若产品定位深色优先,应选深色原生方案。
  3. 需要保留飞书视觉传承的项目(如要向已有用户强调「还是那个飞书」):暖奶油 + 方角 + 墨块是明确的反飞书外观。