茄紫工作台 — wanman /app 重设计方案

方案名与主张

中文方案名:茄紫工作台(5 字)

一句话主张: 用一条 72px 的浅茄紫轨道定住全站,把内容面统一成纯白,让茄紫只出现在「动作 / 选中 / 激活」三类锚点上——面的层级靠明度三级递进(轨道 #d5bfe4 → 画布洗面 #f1e8f8→#e9dbf3 → 面板 #ffffff),状态与色彩纪律靠令牌收敛(Tailwind 原色 253 处泄漏归零),字号从实测 10 档收敛到 4 档。

适用基调:双主题对等(浅色为默认与主推,因为生产只有浅色可达;深色同构完整给出取值,并额外修掉现状的三处深色缺陷)。参考来源主题为 light。

三条实现途径的分工(全文所有条目都标号):


参考提炼

项 值
参考风格名 Slack — Aubergine stage with white spotlights
slug slack
来源站点 slack.com(设计语言采样页,非产品 UI 截图)
theme light
参考文件 /Users/waw/Documents/code/wanman/localtmp/gradientdeck/slack.design.md、slack.design-extended.md

可迁移规则 5 条(引用参考原文要点,逐条给出落到本项目的位置):

  1. 「Aubergine #611f69 — Filled CTA buttons, primary navigation fills … dense enough to ground without veering black」→ 直接把 --brand 取 #611f69:它不是装饰色,而是实心动作与选中锚点的唯一色相。落地:--brand(浅)白字对比 11:1。
  2. 「Purple Haze #f9f0ff — Softest lilac wash … the quiet brand tint that never competes with text」→ 同族淡紫作为次级面(他人气泡、次级按钮、选中洗面)的取色区间 #ece2f3 / #f5f0f9 / #efe3f7,全部保证文字对比 ≥4.5:1。
  3. 「Lavender Mist #eac8fe — bridges white and purple without harsh contrast」→ 深色主题里细线与控件边界用 rgb(234 200 254 / 0.14 | 0.45),而不是中性白 alpha——深紫底上更协调,且仍满足 1.4.11 的 3:1(实测 3.4:1)。
  4. 「Do: Use 16px radius on all cards … pair with a 1px lavender border instead of heavy shadows for the default card state」→ 面板/卡片靠 --border 细线 + 圆角定形,--shadow-e2 只留给浮层(弹窗/抽屉/下拉)。落地:--radius: 0.5rem 后卡片 8px、面板/弹窗 14.4px。
  5. 「Do: Set eyebrow labels at 12px/700 with 0.057em tracking」「Do not set body copy below 14px or above 18px」→ 分组标签固定 12px/600;正文锁定 14px(本产品 15px→14px,见 §5)。

明确不迁移(因产品形态与硬约束舍弃):

参考做法 舍弃原因
Avant-Garde 展示体 64–96px、-0.012em 紧字距 表格/看板密排界面不存在展示级标题;中文也没有该字面的对应字重
1200px 居中 max-width、80–100px 段间距、hero + 双 CTA + 信任 logo 营销页排版;本产品是长时段驻留的三栏工具
白 ←→ #481a54 全幅深色带交替的节奏 应用内没有"滚动叙事"段落,深色带只会制造无意义的强对比块
黑→#ba01ff 渐变文字填充 渐变文字在 12–14px 中文下不可读,且不可用令牌表达
#eac8fe 直接做卡片边框、badge 90px 圆角、32px 环境阴影 三者在 250+ 组件的密集工具里会立刻变成视觉噪声源
product screenshot 卡(16:10 + 环境阴影)作为视觉主体 本产品的"产品画面"就是产品本身

适配判断

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

  1. 参考的 chrome 语汇与本产品一致:Slack 的 rail / sidebar / canvas 三级面,正是本仓 workspace-rail.tsx(72px)+ channel-sidebar.tsx(<aside> 256px)+ 消息面板的结构;参考给的"品牌色只做锚点、大面积靠中性"恰好是本仓最缺的纪律(实测 253 处 Tailwind 原色、44 个非测试文件绕开语义令牌)。
  2. 高密度工具需要"明度分层 + 色彩逐点"的取色规则:一线人员长时间驻留、任务状态又多(待补充/待处理/进行中/待验收/已完成/已关闭),如果把状态和面都用彩色表达就会糊成一片;参考的规则(面用中性、色只点在锚点上)把彩色预算让给状态与主操作。
  3. 浅紫中性阶与现有品牌族同族:把中性阶从"蓝灰(#e1e8f2/#f2f3f5/#dcdee1)"迁到"紫灰(#ece2f3/#f5f0f9/#ded4e7)",中文 14px 正文比纯灰更不易显脏,且与 --brand 同色相,不需要引入任何旁路。

明确舍弃/否定的方向(含实测依据):


令牌映射

值来源与意图逐行标注;「途径」列中 ①=令牌取值。所有对比度按 WCAG 相对亮度公式实算(脚本口径见 §7)。当前值均取自 web/src/styles.css:108 起的 :root / .dark 原文。

浅色 :root

变量名 当前值 建议值 意图
--background #fcfcfc #ffffff 面板/内容/卡片统一纯白,成为最高明度层;原值与侧栏 --sidebar:#fcfcfc 同值造成零层级
--foreground #060607 #1d1c1d 取参考 Carbon;中文 14px 下少一点硬黑,白底 16.99:1
--card #ffffff #ffffff 不变;纯白继续承担卡片面
--card-foreground #060607 #1d1c1d 与 --foreground 同步
--popover #ffffff #ffffff 不变
--popover-foreground #060607 #1d1c1d 与 --foreground 同步
--primary var(--brand) var(--brand) 保持链路,不新增旁路
--primary-foreground var(--brand-foreground) var(--brand-foreground) 保持链路
--secondary #ebedef #ece2f3 他人消息气泡 / 次级按钮专用面:淡紫中性,对纯白 1.25:1(可读为"面"而非"色块")
--secondary-foreground #060607 #1d1c1d 气泡文字同步 Carbon;气泡上 15.6:1
--muted #f2f3f5 #f5f0f9 最轻洗面(浅底气泡、hover 底);不承担层级职责
--muted-foreground #5c5e66 #655c6d 时间戳/成员数/预览:在他人气泡 #ece2f3 上从 4.4:1 提到 5.06:1
--accent #ebedef #e3d6ed hover / 次要 chip 面,比 --secondary 深一档(1.11:1),hover 与静默面可区分
--accent-foreground #060607 #1d1c1d 同步 Carbon
--destructive #da373c #b3261e 白底 6.54:1(原值 4.5:1 边缘);同时保证 10% 淡红底上的文字可读
--border #dcdee1 #ded4e7 1px 装饰细线,紫灰;不承担控件边界职责(1.43:1,1.4.11 对非交互分割线不要求 3:1)
--input #dcdee1 #9c8aa8 控件边界:1.4.11 要求 ≥3:1,实测 3.17:1(原值 1.33:1 不达标)
--ring var(--brand) var(--brand) 焦点环跟随主色
--chart-1 oklch(0.87 0 0) #611f69 图表色从 0 chroma 灰阶换成同族紫阶,白底 11:1
--chart-2 oklch(0.556 0 0) #8a2fa6 紫阶二档,白底 6.91:1
--chart-3 oklch(0.439 0 0) #b03fc9 紫阶三档,白底 4.77:1
--chart-4 oklch(0.371 0 0) #1264a3 参考 Channel Blue,给紫系一个冷色锚,白底 6.22:1
--chart-5 oklch(0.269 0 0) #a15c00 深琥珀(不是 Tailwind amber-500),白底 5.19:1
--radius 0.625rem(10px) 0.5rem(8px) 收敛圆角:按钮/输入 8、卡片/气泡/弹窗 11.2、面板 14.4、抽屉 17.6、徽标 20.8;替换实测 2/6/7/8/10/12/14/18/24/26/32px 混排
--brand #2563eb #611f69 参考 Aubergine:实心动作/选中/激活的唯一色相,白字 11:1
--brand-foreground #ffffff #ffffff 不变
--brand-soft rgb(37 99 235 / 0.12) rgb(97 31 105 / 0.12) 选中洗面跟随主色;叠在纯白上 ≈ #f2e7f4
--brand-ink #1d4ed8 #3d0157 参考 Plum Shadow;选中行文字压在同族洗面上 13.07:1
--message-self #e8f3fe #f1e3f8 自己的气泡:淡茄紫洗面,与"他人淡紫中性"靠色相而非深浅区分
--message-self-foreground #0d274a #3d0157 自气泡文字取 Plum Shadow,气泡上 12.75:1
--surface-chat-soft #e8f2ff #f7f2fa 引用/回复底:比他人气泡更淡,两层气泡不打架
--surface-chat-selected #e5ecfc #efe3f7 会话行选中底:与 --brand-soft 视觉等强(1.24:1 于白底)
--mention #3370ff #730394 参考 Iris;@提及在白底 9.68:1,且消除 #3370FF 硬编码与 --brand 的"两种蓝"并存
--ink #060607 #1d1c1d 深色文字令牌与 --foreground 对齐
--surface-rail #e1e8f2 #d5bfe4 72px 轨道底色;同时是未读徽标的 ring 取色(workspace-rail.tsx:102,159),二者必须同色
--sidebar #fcfcfc #f7f2fa 若后续接入 sidebar 家族:淡紫洗面,与面板纯白构成第二级
--sidebar-foreground #060607 #1d1c1d 同步 Carbon
--sidebar-accent #ebedef #ece2f3 侧栏选中/悬停面与 --secondary 同族
--sidebar-accent-foreground #060607 #1d1c1d 同步 Carbon
--sidebar-border #dcdee1 #ded4e7 与 --border 同步

附加真实变量(同样存在于 styles.css,为达成上面的层级必须给值):

变量名 当前值 建议值 意图
--workspace-background linear-gradient(180deg,#e1e8f2,#e1e5f1) linear-gradient(180deg,#f1e8f8,#e9dbf3) 蓝灰画布 → 紫色洗面画布;.workspace-shell(app-shell.tsx:12070)唯一使用点,它决定 8px 缝隙与圆角面板是否看得见
--workspace-rail-background transparent var(--surface-rail) 轨道由"透明"变为可见的浅茄紫竖带,且自动与徽标 ring 同色
--workspace-header-background var(--background) var(--background) 保持不变,顶栏与内容面同白
--interactive #4e5058 #574d61 chrome 图标色迁到紫灰,白底 7.96:1
--channel-icon #80848e #665c6f 弱图标/弱说明文字;原值白底 3.9:1(作为文字不达标),新值 6.32:1
--sidebar-primary / --sidebar-primary-foreground / --sidebar-ring var(--brand) 链路 不变 保持链路

深色 .dark

变量名 当前值 建议值 意图
--background oklch(0.145 0 0) #211426 纯灰黑 → 深茄紫面板面(参考 Deep Plum 家族)
--foreground oklch(0.985 0 0) #f3ecf8 中性白 → 带紫的暖白,面板上 15.23:1
--card oklch(0.205 0 0) #2a1b31 卡片抬亮一档,与面板 1.19:1
--card-foreground oklch(0.985 0 0) #f3ecf8 同步
--popover oklch(0.205 0 0) #2c1d33 弹层比卡片再亮一档
--popover-foreground oklch(0.985 0 0) #f3ecf8 同步
--secondary oklch(0.269 0 0) #33223b 他人气泡面(对面板 1.2:1)
--secondary-foreground oklch(0.985 0 0) #f3ecf8 同步
--muted oklch(0.269 0 0) #2a1b30 与 --secondary 拉开一档,避免两者同值
--muted-foreground oklch(0.708 0 0) #b6a8c1 面板上 7.85:1、气泡上 6.53:1
--accent oklch(0.269 0 0) #3d2946 悬停/次要面抬亮
--accent-foreground oklch(0.985 0 0) #f3ecf8 同步
--destructive oklch(0.704 0.191 22.216) #ff9aa0 面板上 8.7:1;10% 淡红底上 5.79:1(原值在该底上仅 4.54:1)
--border oklch(1 0 0 / 10%) rgb(234 200 254 / 0.14) 细线改用参考 Lavender Mist alpha,深紫底更协调(1.39:1,装饰线)
--input oklch(1 0 0 / 15%) rgb(234 200 254 / 0.45) 控件边界需 3:1;实测叠在面板上 3.4:1(原值 ≈1.2:1)
--ring var(--brand) var(--brand) 焦点环跟随主色
--chart-1..5 灰阶 #c77ee8 / #a978e0 / #e0a0ff / #6aa9e0 / #e8bb63 深色图表五色,对面板分别 6.35 / 5.41 / 8.92 / 7.01 / 9.83:1
--brand oklch(0.68 0.15 256) #c77ee8 深色主色上提为亮紫(参考 Iris Light 家族),对面板 6.35:1
--brand-foreground oklch(0.16 0.02 258) #240f2b 填充上的深茄紫字:6.43:1
--brand-soft oklch(0.28 0.05 256) rgb(199 126 232 / 0.18) 选中洗面:透明叠加,任意底色上等强
--brand-ink oklch(0.84 0.09 256) #e6c3f7 选中行文字:选中底上 8.46:1
--message-self #203b59 #3c2147 自气泡:深茄紫洗面
--message-self-foreground #e7f3ff #f6e9fd 自气泡文字 11.99:1
--surface-chat-soft oklch(0.32 0.06 250) #341f3c 引用底
--surface-chat-selected oklch(0.28 0.04 250) #3f2749 会话行选中底
--mention oklch(0.72 0.14 254) #dda6ff @提及在面板上 9.2:1
--ink oklch(0.16 0.02 258) #f3ecf8 深色下 ink 是亮色(与浅色语义相反,跟随 --foreground)
--surface-rail #e3e5e8 #3a2245 修掉"深色下轨道是一条浅色竖带";同时仍是徽标 ring 取色,激活块对其 5.07:1
--workspace-background radial-gradient(brand 10% …) linear-gradient(180deg,#2c1a34,#1a0f1f) 与浅色同构的上下渐变,面板/画布 1.09~1.24:1
--workspace-rail-background color-mix(background 45% transparent) var(--surface-rail) 与浅色同构,轨道色不由 background 混出
--workspace-header-background 渐变 var(--background) 顶栏不再单独渐变,与内容面同色
--interactive(深色新增) 继承 #4e5058(深底不可读) #cfc3d8 chrome 图标在深底 10.44:1
--channel-icon(深色新增) 继承 #80848e #b0a3bc 弱图标/文字 7.39:1
--sidebar / --sidebar-accent / --sidebar-border / --sidebar-foreground / --sidebar-accent-foreground `oklch(0.205 0.269 0 0)、oklch(1 0 0/10%)、oklch(0.985 0 0)` #2a1b31 / #3d2946 / rgb(234 200 254/0.14) / #f3ecf8 / #f3ecf8
--sidebar-primary / --sidebar-primary-foreground / --sidebar-ring var(--brand) 链路 不变 保持链路

深色下 --radius 不再声明(与原文一致,继承 :root 的 0.5rem)。


字体与排版

字体栈(@theme inline --font-sans,保留 Geist 首发):

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

字号阶梯(4 档 + mono 一档;路径:全部用官方组件内建字号,任何 ad-hoc 字号一律删除):

角色 字号 行高 字重 实现来源(官方内置)
页面主标题(仅登录页/空态) 24px 1.33 (32px) 600 固定值 text-2xl(24px),替换实测 26px 这一档自造字号
区块标题 / 频道名 / 面板标题 16px 1.375 (22px) 500 官方 card.tsx CardTitle 内置(text-base leading-snug font-medium);频道头实测 600 收敛到官方 500
正文(消息、任务描述、表单) 14px 1.5 (21px) 400 styles.css @layer base 的 body + 官方 bubble.tsx BubbleContent(text-sm leading-relaxed)、input.tsx(text-sm)、button.tsx(text-sm)
次级信息(时间、成员数、预览、元信息) 12px 1.5 (18px) 400/500 官方 message.tsx 元信息行(text-xs font-medium)、badge.tsx(text-xs)
数字/编号/代码(任务 ID、计数、时间轴刻) 12px 1.5 400 --font-mono(font-mono tabular-nums)

两处必须一起改的类型学事实:

  1. styles.css @layer base 的 body 从 text-[15px] leading-[1.375] 改为 text-[14px] leading-[1.5]。 依据:实测同一消息列表出现 15px(他人)与 14px(自己)两套正文(BubbleContent 内建 text-sm=14px,另一条渲染路径用 15px 基准),改 body 后二者天然对齐 14px;且 14px×1.5=21px 行高 > 现状 20.63px,视觉密度不降反升。
  2. 同一次改动必须把 em 派生字号换成固定值。 实测 S4-agent-space 存在 12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、13.125px、11.25px 等档位,它们是以 15px 为基准的 em 计算产物。body 降到 14px 后这些值会等比缩小 6.7%(12.8→11.95、11.25→10.5),跌破"中文最小 12px"底线。因此:凡是以 em 计算出来的字号,一律写成固定 text-xs(12px) 或 text-sm(14px)。这是本方案唯一要求"覆盖既有 ad-hoc 字号"的地方(删除而非新增覆盖)。

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


关键界面改造

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

现状(实测) 改后 途径
空间 rail nav 72×900 背景 transparent;空间图标块是 bg-background/85 的白块贴在近白画布上,只能靠 ring-1 ring-foreground/5 分辨 轨道底 --workspace-rail-background: var(--surface-rail) = #d5bfe4 → 得到一条可见的浅茄紫竖带;白块对轨道 1.69:1,激活块(bg-brand)对轨道 6.5:1 ①
分隔线 bg-foreground/22(chrome.ts railSep)压在近白底上几乎不可见 同上:#1d1c1d 22% 叠在 #d5bfe4 上 = 10.03:1,分隔线成立 ①
未读徽标 ring-2 ring-surface-rail,而 --surface-rail:#e1e8f2 与轨道实际底色无关 → 徽标外圈出现"另一块色" ring 色与轨道底色强制同源(--surface-rail 即 --workspace-rail-background),徽标等于从轨道上"挖"出来 ①
会话侧栏 aside 256×715 border-radius 14px、background #fcfcfc 与页面底色 --background:#fcfcfc 完全相同 → 零层级 面板 #ffffff / 画布洗面 #f1e8f8→#e9dbf3:面板对画布 1.19~1.32:1,加上 md:my-2 的 8px 缝隙与既有 ring-foreground/[0.06] + --shadow-e2,面板真正"浮"起来 ①+③(chrome.ts imSplitPanel/workspaceSplitPanelFrame 的容器底色不改类名,只换令牌取值;画布梯度由 --workspace-background 决定)
侧栏头部 52px、搜索框 30px 高 搜索框沿用 imSearchField(h-8 rounded-xl bg-secondary/75)→ 令牌改后自动成为淡紫填充;头部高度由 52px 收到 48px(px-4 不变) ①(填充色)+③(尺寸)
会话行 240×64,预览 11.25px 行高 64→56px(900px 高度内可见行数 +1~2),预览字号 11.25→12px(固定值) ③(尺寸)+ 字号收敛(见 §5)
侧栏颜色纪律:--sidebar* 全家族当前零引用(grep -rn "bg-sidebar|text-sidebar|border-sidebar" src 无命中) 取值与 --secondary/--border 同族,接通时不改变观感;不为了"用上令牌"而新增类 ①

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

现状(实测) 改后 途径
他人气泡 rgb(235,237,239)、自己气泡 rgb(232,243,254)+文字 rgb(13,39,74):靠"灰 vs 蓝"区分 他人 = --secondary #ece2f3(紫灰),自己 = --message-self #f1e3f8(茄紫洗面)+ --message-self-foreground #3d0157(12.75:1);自己消息仍是官方 variant="default"(message-bubble.tsx 把 --primary/--primary-foreground 映射到 --message-self*),他人仍是 variant="secondary" ①(取值)+②(沿用官方变体,不新增变体)
同一列表两种正文字号:他人 15px / 自己 14px 统一 14px(BubbleContent 内建 text-sm);删除另一条渲染路径以 15px 基准计算的字号类 见 §5 第 1 条(删除 ad-hoc 字号,不加覆盖)
气泡圆角 14px --radius: 0.5rem → 气泡 rounded-xl = 11.2px,与卡片/弹窗 11.2px、输入框/按钮 rounded-lg = 8px 同链条 ①
@提及 --mention #3370ff 已被 chat-mention.ts 硬编码 #3370FF 绕过;另有 #006ce7 硬编码,全站三种蓝并存 --mention: #730394(Iris);chat-mention.ts 的硬编码改为 var(--mention);#006ce7(message-list.tsx/composer-markdown.ts/voice-channel-history-dialog.tsx)改 var(--link)→统一用 var(--mention),把"三种蓝"归一到一种紫 ①
输入区 textarea 628×33 无边框,外层仅上边框 rgb(220,222,225);工具按钮 28×28 外层上边框 = --border #ded4e7;聚焦时整体 focus-within 描边用 --brand(现成链路),工具按钮沿用官方 Button size="icon-sm"(28×28) 不变 ①(边框色)+②(沿用官方尺寸)
消息列宽度无约束(头宽 860px,气泡 max-w-[80%]) 消息列容器 max-w-[720px] 居中,长中文单行 40–46 字 ③

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

现状(实测) 改后 途径
任务卡圆角 10px×48 与 8px×37 两套混用 统一到 --radius 链条:卡片 11.2px(官方 card.tsx 的 rounded-xl)、chip/徽标 20.8px(官方 badge.tsx 的 rounded-4xl → 胶囊) ①
卡片用自绘 div:标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人 换成官方 card.tsx(Card/CardHeader/CardTitle/CardDescription/CardContent/CardFooter):标题 CardTitle 16px/600 或 14px/500(列表模式),chip 用官方 Badge,操作按钮用官方 Button variant="outline" size="sm" ②
群聊大厅有营销式 hero 段落 + 全部群聊 / 全部 / 已加入 / 未加入 筛选,品牌蓝出现 20 处 删除 hero 段落(首屏直接给筛选 + 网格);筛选控件用官方 Tabs(TabsList/TabsTrigger)或官方 Button 变体组(选中 variant="secondary");品牌色出现位置收敛到 ≤3 处/屏(主操作、选中、未读计数) ③(容器/信息层级)+②(官方组件)
状态六档 待补充/待处理/进行中/待验收/已完成/已关闭,当前靠 tone.ts 里硬编码的 Tailwind amber/emerald/rose 上色(泄漏普查里 amber 69 / rose 68 / emerald 42) 状态一律官方 Badge 六变体 + lucide 图标双编码:进行中 variant="default"(茄紫实心,白字 11:1)Zap;待处理 variant="secondary" Clock;待补充 variant="outline" Circle;待验收 variant="outline" ShieldCheck;已完成 variant="secondary" CheckCircle2;已关闭/逾期 variant="destructive" XCircle;删除 tone.ts 内所有 Tailwind 原色类 → 改指向语义令牌 ②(官方变体)+①(destructive/secondary 取值)
看板列头 待补充 0 / 待处理 5,列容器为自绘 列头用官方 Badge variant="secondary" 计数;列容器固定宽度 280px、gap-3,列内纵向滚动(ScrollRegion 现成) ③
卡片列表密度 大厅默认视图用密集行(h-56 卡片、gap-3、3 列 ≥1280px / 2 列 ≥768px / 1 列以下),单屏可扫 12–15 条任务 ③

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

现状(实测) 改后 途径
主按钮 356×52、白字、#2563eb 官方 Button(默认 variant + size="lg" h-9=36px,宽度由容器给 w-full max-w-[356px]),填充色 = --brand #611f69,白字 11:1 ①+②(官方尺寸)+③(容器宽度)
「邮箱验证码 / 短信验证码」自绘切换块 173×42(选中态背景 --background #fcfcfc + 品牌蓝文字) 换成官方 Tabs(TabsList/TabsTrigger):选中底 = --secondary #ece2f3,文字 = --foreground;gap-2,整块宽度占满卡片内容宽 ②
主标题 26px 自绘 官方 Card + CardTitle(text-2xl=24px/600),去掉 26px 这一档 ②
页脚 11px(低于"中文最小 12px") text-xs(12px) + --muted-foreground #655c6d(白底 6.35:1) 字号合规修正(删除 11px,不加新样式)
页面底色沿用应用画布 登录页画布 = --workspace-background 紫色洗面梯度,卡片 = --card #ffffff + --border #ded4e7;文案「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」不变 ①

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

现状(实测) 改后 途径
全站最密集视图:一次渲染 12.8px×2765 / 12px×500×2381 / 12px×400×1994 / 14px×1724;圆角 8px×1591 与 10px×844 并存 字号按 §5 收敛为 12/14 两档(12.8 → 12 固定值);圆角统一到 --radius 链条 ①(圆角)+ 字号收敛
AI 回答气泡与人类气泡同色(都是 --secondary/--accent) AI 回答 = --surface-chat-soft #f7f2fa + 官方 Bubble variant="outline";人类消息维持 --secondary → "机器 / 人"靠面区分 ①+②
流式等待态自绘(--animate-breathe 三个呼吸点) 保留 --animate-breathe;结构化等待用官方 skeleton.tsx;引用来源 chip 用官方 Badge variant="outline" ②
结果卡片自绘、单列堆叠 官方 Card + 结果列表 grid gap-3 md:grid-cols-2(宽屏两列),卡内元信息 12px --muted-foreground ②+③
395 项任务的长列表 容器滚动交给现成 ScrollRegion/scroll-surface.tsx,列表行高 44px,右侧固定操作列 ③

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

现状(实测) 改后 途径
[role=dialog] 704×512、圆角 18px、#ffffff 官方 Dialog(DialogContent/DialogHeader/DialogTitle/DialogDescription);圆角随 --radius 由实测 18px 变 11.2px(官方 DialogContent 的 rounded-xl)并统一;高度上限 max-h-[min(80svh,640px)],避免长表单被裁切 ①(圆角)+②(官方组件)+③(尺寸)
左侧导航项 135×36 圆角 8px,选中态 --brand-soft + --brand-ink,危险项 --destructive #da373c 官方 Button:未选中 variant="ghost"、选中 variant="secondary"(#ece2f3)、危险项 variant="destructive"(官方 10% 红底 + 红字,字色 #b3261e 白底 6.54:1);导航列固定 148px、行高 32px ②(官方变体)+①(取值)+③(列宽)
输入框 488×32 圆角 10px,边界 #dcdee1(白底 1.33:1,不达 3:1) 官方 input.tsx(h-8)保持尺寸,边界色 = --input #9c8aa8(3.17:1);表单用官方 field.tsx/field-select.tsx 对齐标签与错误态 ①+②
表单标签 14px 保持 14px,色用 --foreground;帮助/错误文案 12px --muted-foreground/--destructive 字号收敛
成员列表、权限选择器自绘行 官方 Item(item.tsx)+ Avatar + Checkbox/RadioGroup;权限矩阵用官方 Table ②

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

现状(实测) 改后 途径
分类筛选 8 项(全部/Agent/人事行政/数据与报表/项目管理/行业模板/研发协作/智能办公)+「共 14 个应用」 官方 Tabs(横向,TabsList)承载分类;计数用 12px --muted-foreground 文案 ②
卡片:运行中 / 开发中 徽标 + emoji 图标 + Agent · 第三方 · chat 元信息 徽标 = 官方 Badge:运行中 = variant="default"(茄紫实心)/开发中 = variant="secondary";图标从 emoji 换成 lucide(components.json iconLibrary: lucide,已在依赖内),图标色 = --brand(bg-brand-soft 圆底)或 --muted-foreground,形状统一为 20px ②(官方组件 + 官方图标库)+①(色)
卡片元信息 Agent · 第三方 · chat 用小字硬编码色 12px --muted-foreground,分隔符用官方 Separator(orientation="vertical") ①+②
卡片网格(现为自适应) 3 列 ≥1280px / 2 列 ≥768px,卡片等高 148px、gap-4,Card 官方组件承载 ③

S6 语音频道(依据为代码与库数据,不是截图)


深浅色与对比度

计算口径:WCAG 2.2 相对亮度公式,L = 0.2126R + 0.7152G + 0.0722B(通道先做 sRGB 线性化),比值 (L_hi+0.05)/(L_lo+0.05);带 alpha 的值先按底色做合成再计算。正文阈值 4.5:1,图形边界 3:1。

浅色

组合 前景 hex 背景 hex 比值 达标
正文 / 面板 #1d1c1d #ffffff 16.99 ✅(≥4.5)
正文 / 自气泡 #3d0157 #f1e3f8 12.75 ✅
次级文字 / 面板 #655c6d #ffffff 6.35 ✅
次级文字 / 他人气泡 #655c6d #ece2f3 5.06 ✅
次级文字 / 画布洗面 #655c6d #f1e8f8 4.99 ✅
弱图标文字 / 面板 #665c6f #ffffff 6.32 ✅
弱图标文字 / 他人气泡 #665c6f #ece2f3 5.03 ✅
主按钮文字 / 主色填充 #ffffff #611f69 11.00 ✅
选中行文字 / 选中行底 #3d0157 #efe3f7 12.68 ✅
选中行文字 / --brand-soft 叠白 #3d0157 #f2e7f4 13.07 ✅
@提及 / 面板 #730394 #ffffff 9.68 ✅
@提及 / 引用底 #730394 #f7f2fa 8.77 ✅
@提及 / 自气泡 #730394 #f1e3f8 7.87 ✅
危险文字 / 面板 #b3261e #ffffff 6.54 ✅
控件边界 / 面板 #9c8aa8 #ffffff 3.17 ✅(≥3,1.4.11)
轨道底 / 激活块 #d5bfe4 #611f69 6.50 ✅(≥3)
图标白块 / 轨道底 #ffffff #d5bfe4 1.69 ✅(面层级,非文字)
轨道底 / 画布洗面(上/下) #d5bfe4 #f1e8f8 / #e9dbf3 1.42 / 1.28 ✅(面层级)
面板 / 画布洗面(上/下) #ffffff #f1e8f8 / #e9dbf3 1.19 / 1.32 ✅(面层级,另有 8px 缝隙 + ring-foreground/[0.06] + --shadow-e2 定边)
他人气泡 / 面板 #ece2f3 #ffffff 1.25 ✅(面层级)
装饰细线 / 面板 #ded4e7 #ffffff 1.43 ⚪ 非交互分割线,1.4.11 不适用(控件边界另由 --input 承担 3.17:1)

深色

组合 前景 hex 背景 hex 比值 达标
正文 / 面板 #f3ecf8 #211426 15.23 ✅
正文 / 卡片 #f3ecf8 #2a1b31 13.98 ✅
正文 / 他人气泡 #f3ecf8 #33223b 12.68 ✅
次级文字 / 面板 #b6a8c1 #211426 7.85 ✅
次级文字 / 他人气泡 #b6a8c1 #33223b 6.53 ✅
弱图标文字 / 面板 #b0a3bc #211426 7.39 ✅
chrome 图标 / 面板 #cfc3d8 #211426 10.44 ✅
主按钮文字 / 主色填充 #240f2b #c77ee8 6.43 ✅
主色 / 面板 #c77ee8 #211426 6.35 ✅
选中行文字 / 选中行底 #e6c3f7 #3f2749 8.46 ✅
@提及 / 面板 #dda6ff #211426 9.20 ✅
@提及 / 引用底 #dda6ff #341f3c 7.80 ✅
自气泡文字 / 自气泡 #f6e9fd #3c2147 11.99 ✅
危险文字 / 面板 #ff9aa0 #211426 8.70 ✅
危险文字 / 10% 淡红底 #ff9aa0 #45232c 5.79 ✅
控件边界 / 面板 rgb(234 200 254 / .45)→#7b6587 #211426 3.40 ✅(≥3)
轨道底 / 激活块 #3a2245 #c77ee8 5.07 ✅
轨道底 / 画布(下) #3a2245 #1a0f1f 1.32 ✅(面层级)
面板 / 画布(上) #211426 #2c1a34 1.09 ✅(面层级 + ring/shadow)
他人气泡 / 面板 #33223b #211426 1.20 ✅(面层级)
装饰细线 / 面板 rgb(234 200 254 / .14)→#3d2d44 #211426 1.39 ⚪ 非交互分割线

深色现状缺陷的三处修复(均可复算): ① --surface-rail 由 #e3e5e8 改 #3a2245,消除"深色下轨道是一条浅色竖带";② 深色新增 --interactive: #cfc3d8、--channel-icon: #b0a3bc,修掉继承浅色值后在深底不可读的图标/弱文字;③ --input 由 15% 中性白 alpha(≈1.2:1)改为 45% lavender(3.4:1),控件边界满足 1.4.11。


shadcn 兼容性

结论:三条途径内可以达成全部改造,不新增任何自定义视觉变体、不用 className 覆盖组件样式。

复用的官方组件(web/src/components/ui/,38 个之内,无需安装):button、badge、input、textarea、tabs、avatar、separator、card、dialog、popover、dropdown-menu、tooltip、checkbox、radio-group、select、field、field-select、item、table、skeleton、scroll-area、scroll-region、scroll-surface、collapsible、accordion、context-menu、calendar、button-group、input-group、bubble、message、message-scroller、floating-layer。

用到的官方 variant/size(全部来自组件源码):button variant default|outline|secondary|ghost|destructive|link,size xs|sm|default|lg|icon|icon-xs|icon-sm|icon-lg;badge variant default|secondary|destructive|outline|ghost|link;bubble variant default|secondary|muted|tinted|outline|ghost|destructive(default 已在 message-bubble.tsx 中通过 --primary 重映射承载"自己"的气泡色)。

尚未安装、如需则要 shadcn add 的官方组件(本方案默认不用,列出以备): alert(任务逾期/错误横幅,当前只能用 Card + Badge variant="destructive" 近似)、progress(任务进度条)、sheet(现有自绘抽屉可换)、switch/toggle(设置开关)、empty(空态组件,现为手写空态)、pagination(长列表分页)。

不合规风险(必须显式标注,共 5 条):


实施成本

改动面:

类别 文件 说明
令牌(必须) web/src/styles.css(:root / .dark 两段,共 ~90 行) 直接替换为 tokens.css 的对应段落;另加 @layer base 的 body 14px/1.5 一行与 --font-sans 回退顺序一处
令牌泄漏清理(深色成立的前提) components/app/tone.ts、chat-mention.ts、message-list.tsx、composer-markdown.ts、voice-channel-history-dialog.tsx、chrome.ts、image-preview-dialog.tsx+file-preview/*(按 §6 清单) bg-white 57 处/26 文件、Tailwind 原色 253 处/44 文件按面分批替换为语义令牌
S1 workspace-rail.tsx(无代码改动,靠令牌)、chrome.ts(容器底色/尺寸)、channel-sidebar.tsx(行高 64→56、预览字号) 轨道与徽标 ring 同源是令牌收益,零组件改动
S2 message-list.tsx、message-bubble.tsx(不变)、channel-thread.tsx(列宽 720px 容器) 字号统一 + 三种蓝归一
S3 task-hall.tsx、group-hall.tsx、channel-work-items.tsx、create-task-dialog.tsx 官方 Card/Badge/Button 替换自绘卡片 + 删除 hero
S7 routes/login.tsx、sign-in.$.tsx Tabs/Button/Card 替换自绘控件
S4 agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx 字号固定值 + AI 气泡面 + 结果卡两列
S5 space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx、channel-permission-picker.tsx 官方 Button/Input/Field/Item/Table
S8 app-center.tsx、assistant-board.tsx 官方 Tabs/Badge/Card/Separator + emoji→lucide

预估人时(单人串行):

阶段 工时
令牌替换 + body/字体顺序 + 浅色逐面对比度复核 3h
深色的硬编码泄漏清理(按 26 个 bg-white 文件分批) 12h
S1 + S2(外壳与消息流) 6h
S3 + S7(任务大厅与登录页) 8h
S4 + S5 + S8 10h
状态双编码(六状态 × 图标 × 列表/看板/详情三处视图) 4h
回归与验收(下表全部检查项) 5h
合计 约 48h(6 人日)

风险清单: R1~R5(见 §8);另加两条执行风险——(a) --radius 从 10px 降到 8px 会同时改变所有 rounded-lg/xl/2xl 面板的几何,需一次全量视觉复核;(b) --input 明显加深(#9c8aa8)会让"大量输入框"的界面(任务创建弹窗、权限矩阵)密度感变重,需在 S3/S5 复核是否改用 variant="outline" 的官方容器替代裸露输入框。

验证方式(能证明改动生效的具体检查):

  1. getComputedStyle 抽查 6 个令牌落地值:--background → #ffffff、--surface-rail → #d5bfe4、--brand → #611f69、--message-self → #f1e3f8、--input → #9c8aa8、--radius → 8px(在任意页 document.documentElement 上读取)。
  2. 面层级可见性:截图/取色确认「轨道 72px 竖带 = #d5bfe4」「面板 = #ffffff」「两者之间的 8px 缝隙 = 画布梯度色」,三点取色互不相同。
  3. 对比度:对 §7 两张表逐行取实际渲染值复算(脚本口径与本文一致)。
  4. 圆角收敛:全量扫描 getComputedStyle(el).borderRadius,确认只出现 {0, 4.8, 6.4, 8, 11.2, 14.4, 17.6, 20.8, 9999}px 集合(现存 2/7/24/26/32px 清零;面板 rounded-2xl 14.4、抽屉 rounded-3xl 17.6、徽标 rounded-4xl 20.8)。
  5. 字号收敛:全量扫描 fontSize,确认只出现 {12, 14, 16, 24}px + mono(现存 9/9.375/11/11.25/12.8/13.125/26px 清零)。
  6. 泄漏回归:重跑 localtmp/design-render/probe-leaks.js 口径的普查,Tailwind 原色类命中数由 253 降到 0(或仅剩测试文件)。
  7. 主题切换:给 <html> 加 .dark 后重跑第 1–5 项,深色取值全部命中且无浅色硬编码残留(即 rgb(6,6,7) 55 处归零)。

取舍

解决了什么:

牺牲了什么:

什么场景下不适用: