wanman /app 重设计方案 · 白纸绘图
方案名与主张
中文方案名:白纸绘图(4 字)
一句话主张: 把 /app 当成一张白纸上的工程图来画——面板与画布只靠纸色差值与 1px 描边分层,全系统只留一种彩色(钴蓝 #266df0)承担「未读 / @提及 / 进行中 / 选中」,其余一律墨黑与石板灰。
适用基调:浅色优先、深色对等。 浅色是设计基准面;深色按同一套语义名给出完整对应值,且不是浅色机械反相:深色下品牌填充改用深墨字(#0b1526 on #407ff2 = 4.82:1),因为白字在抬明度后的钴蓝上只有 3.79:1。
实测基线(test@3d35969f,1440×900,DOM/getComputedStyle 取证):现状是「飞书本机外观采样」——蓝灰 rail --surface-rail #e1e8f2、近白内容区 #fcfcfc、圆角 10px、品牌蓝 #2563eb。本方案要解决两个实测硬缺陷:
- 会话侧栏
aside256×715 @x=76,background #fcfcfc与页面底色--background #fcfcfc完全相同,层级对比 1.00:1。 - 同一消息列表两套字号:他人消息 15px/400,自己消息 14px/400(
message-list.tsx)。
以及三个系统性缺口:三种蓝并存(--brand #2563eb / 硬编码 #006ce7 / --mention #3370ff)、253 处绕过语义令牌的 Tailwind 原始调色板(44 个非测试文件)、深色令牌块在生产不可达且 55 处前景 rgb(6,6,7) 不翻转。
参考提炼
- 参考风格名: Attio — Architectural editorial on white marble(白色大理石上的建筑式编辑排版)
- slug:
attio;来源站点: attio.com;theme: light - 参考文件:
/Users/waw/Documents/code/wanman/localtmp/gradientdeck/attio.design.md、attio.design-extended.md
从参考 DESIGN.md 提炼的 5 条可迁移规则(原文要点 + 在我们的令牌上落哪一行):
| # | 参考原文要点 | 迁移到本方案 |
|---|---|---|
| 1 | Do:「Use #266df0 (Cobalt Core) as the single accent for all interactive highlights, active states, and link text — never introduce additional saturated colors」;Don't:「Don't introduce secondary accent colors, gradients on buttons, or decorative color — one blue accent is the rule」 | --brand: #266df0、--mention: #1d4ed8(同相文字版)、--ring: var(--brand);状态色不再新增色相(见 §6 任务状态表) |
| 2 | Do:「Use 10px border-radius for all buttons and inputs, 7px for tags and badges, 11-14px for cards」;Don't:「Don't use rounded buttons with radius above 12px」 | --radius: 0.625rem(10px)不动,靠现有派生链拿到 md=8px / lg=10px / xl=14px;Badge 官方是 26px 胶囊,不自定义(见 §10 取舍) |
| 3 | Do:「Apply blue-tinted shadows at very low opacity (rgba(28, 40, 64, 0.04) to rgba(28, 40, 64, 0.1)) — never use warm-gray or pure-black shadows」 | @theme inline 的 --shadow-e1/e2/e3/pop 全部换成 rgb(28 40 64 / …) 蓝调四步 |
| 4 | 「Sidebar Navigation … Light background (#ffffff or #f4f5f6), no visible border separating from main content」+ Surfaces:「Paper #f4f5f6 — subtle elevated panels, alternate section backgrounds」 |
层级改为 纸色画布 --muted #f4f5f6 + 白面板 --background #ffffff/--sidebar #ffffff,分隔靠 --border #e4e7ec hairline;--surface-rail 从 #e1e8f2 降到纸色,去掉那条蓝灰竖带 |
| 5 | Do:「Use Inter weight 500 as the default UI weight, not 400 — the slightly heavier weight is the system's default voice」 | 官方组件已经满足(button.tsx 的 text-sm font-medium、badge.tsx 的 text-xs font-medium);正文不加粗,靠徽标/标题 500–600 形成两级声部 |
必须舍弃的参考规则(因产品形态不同):InterDisplay 56px hero(本产品无营销面)、TiemposText 衬线引用声部(会与消息引用块冲突)、1440px 居中 + 80–120px 段落间距(高密度工具是满屏分栏)、Logo strip / 黑色 Footer / 促销条、Inter 的 ss03 特性字形(需要新字体资产,且会挤掉中文回退位次)、letter-spacing: -0.02em 跟踪(中文禁负字距,见 §5)。
适配判断
为什么这套语言适合「任务 + 频道消息」的企业工具:
- 双核心天然是分栏面板。 空间/频道(S1)+ 消息流(S2)+ 任务卡(S3)在 1440×900 上至少三列并置。Attio 的「纸色画布 + 白面板 + hairline」用结构表达层级,不需要阴影和粗边框,因此三列并置时不会出现「一堆浮起来的卡片」的噪声;实测现状正是这一噪声的另一面:
--shadow-e2围绕每个分栏 +md:ring-1 md:ring-foreground/[0.06](web/src/components/app/chrome.ts的workspaceSplitPanelFrame)叠加蓝灰渐变画布,边界来源有四套。 - 高密度中文长时段驻留,靠明度差而不是色彩差抗疲劳。 白底 + Ink
#1c1d1f(16.87:1)+ 次级#5f6875(5.17:1)三段明度就能承载「正文 / 元信息 / 禁用」,一整天不刺眼;反之现状把注意力信号分散在 amber/rose/slate 等 12 个色相上(253 处)。 - 单一钴蓝正好对上零工的三种注意力信号。 「未读」(
--brand圆点)、「@提及」(--mention #1d4ed8)、「进行中」(Badgedefault)本就是同一种语义——需要你看一眼。用同一个色相承担,语义不打架,且天然稀缺(Attio:its rarity makes it meaningful)。 - 任务状态是离散枚举,适合用 variant + 图标表达(官方 Badge 有 6 个 variant、lucide 图标可作
data-icon子节点),不需要发明新色。
明确舍弃项:
- 参考的营销页构件全部舍弃:hero 大图、56/64px InterDisplay 标题、Logo strip、黑色 Footer、48px 促销条、80–120px 段落间距、1440px 居中容器。
/app是满屏三栏,横向不留白。 - 参考的 TiemposText 衬线声部舍弃:消息流里已有「引用块」承担引用语义,衬线会与之冲突。
- 参考的
#000000Onyx 深色面舍弃:本产品深色是应用主题,需要三级表面(画布#101113/ 卡片#17191c/ 弹层#1c1e22),纯黑会把三级压成一级。 - 参考的 7px 徽标圆角舍弃(官方 Badge 是胶囊);参考的
ss03/Inter 字体舍弃(无字体资产、会破坏中文回退)。 - 参考页面的「单页滚动」节奏舍弃:本产品是空间/频道/任务三处并列的信息架构,全部靠容器布局(途径 ③)实现。
令牌映射
途径标注:本表全部改动落在途径 ①(语义化主题令牌取值,web/src/styles.css)。
浅色 :root(当前值取自共享简报 §3.1 原文)
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
#fcfcfc |
#ffffff |
Page Canvas 纯白:面板与画布分离的前提;当前近白使所有白面板失效 |
--foreground |
#060607 |
#1c1d1f |
Attio Ink Black:纯黑在纯白上过硬,抬明度到 16.87:1(仍远超 AA) |
--card |
#ffffff |
#ffffff |
保持:卡片与画布同为白,层级交给 hairline |
--card-foreground |
#060607 |
#1c1d1f |
与 --foreground 对齐,全站一种墨色 |
--popover |
#ffffff |
#ffffff |
保持:弹层白 + 蓝调 --shadow-pop 脱离画布 |
--popover-foreground |
#060607 |
#1c1d1f |
同上 |
--primary |
var(--brand) |
var(--brand) |
保持原文映射,不新增品牌覆盖 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
保持原文映射 |
--secondary |
#ebedef |
#eeeff1 |
Haze:灰底控件(secondary 按钮、Badge secondary)更中性、少蓝 |
--secondary-foreground |
#060607 |
#1c1d1f |
墨色统一 |
--muted |
#f2f3f5 |
#f4f5f6 |
Paper:外层画布(chrome.ts 的 bg-muted)与 hover 行底;与白面板 1.09:1 纸感差值 |
--muted-foreground |
#5c5e66 |
#5f6875 |
次级文字:Attio Slate 600 #6f7988 在 #f4f5f6 上仅 4.04:1 不达标,同相下沉到 5.17:1 |
--accent |
#ebedef |
#eeeff1 |
hover/选中底:与 --secondary 收敛为同一灰,消除原本两套灰 |
--accent-foreground |
#060607 |
#1c1d1f |
墨色统一 |
--destructive |
#da373c |
#c62a2f |
危险色:原值在 destructive/10 底上仅 4.26:1,加深后底上 4.91:1、白底 5.57:1 |
--border |
#dcdee1 |
#e4e7ec |
Mist 50:全站唯一 hairline 主描边,替掉偏蓝的 #dcdee1 |
--input |
#dcdee1 |
#cad0d9 |
Cloud 200:输入描边比 border 深一档,强化可点区域(距 3:1 仍不足,见 §9 风险 R1) |
--ring |
var(--brand) |
var(--brand) |
焦点环沿用品牌钴蓝(白底 4.64:1,满足非文本 3:1) |
--chart-1 |
oklch(0.87 0 0) |
#266df0 |
图表主序列 = Cobalt Core,与品牌同色 |
--chart-2 |
oklch(0.556 0 0) |
#538bf3 |
第二序列 = Cobalt Soft(白底 3.30:1) |
--chart-3 |
oklch(0.439 0 0) |
#1c1d1f |
第三序列 = Ink(16.87:1) |
--chart-4 |
oklch(0.371 0 0) |
#78828f |
第四序列 = 石板灰(3.90:1) |
--chart-5 |
oklch(0.269 0 0) |
#1d4ed8 |
第五序列 = 深钴蓝(6.70:1) |
--radius |
0.625rem |
0.625rem |
保持 10px:Attio 按钮/输入圆角,派生链给 xl=14px 卡片圆角 |
--brand |
#2563eb |
#266df0 |
品牌蓝换成 Attio Cobalt Core;全系统唯一彩色 |
--brand-foreground |
#ffffff |
#ffffff |
钴蓝填充上的白字 4.64:1(AA 正文) |
--brand-soft |
rgb(37 99 235 / 0.12) |
#e4edff |
Ice Wash 实色:透明叠加在灰底上偏色,实色可复算(选中态 5.48:1) |
--brand-ink |
#1d4ed8 |
#1d4ed8 |
保留:在 #e4edff 上 5.70:1,已是可读的深钴蓝 |
--message-self |
#e8f3fe |
#e4edff |
自己气泡由偏青浅蓝改到品牌同相冰蓝,消除第三种蓝 |
--message-self-foreground |
#0d274a |
#14315c |
气泡内文字 11.00:1,与 --brand-ink 同族 |
--surface-chat-soft |
#e8f2ff |
#eef3fd |
引用/回复块底:比气泡淡一档,形成「软 / 冰 / 选中」三级蓝 |
--surface-chat-selected |
#e5ecfc |
#dfe9fb |
会话选中底:比 chat-soft 深一档,选中不再靠 font-semibold 硬扛 |
--mention |
#3370ff |
#1d4ed8 |
@提及与 --brand-ink 同值:句内链接统一到可读深钴蓝(白底 6.70:1) |
--ink |
#060607 |
#1c1d1f |
全站墨色别名与 --foreground 对齐 |
--surface-rail |
#e1e8f2 |
#f4f5f6 |
空间轨降到纸色:去掉实测那条蓝灰竖带,与画布同色、只靠 hairline 分隔 |
--workspace-background |
linear-gradient(180deg,var(--surface-rail),#e1e5f1) |
#f4f5f6 |
外层画布由渐变改纯纸色:单个渐变里叠了 2 个硬编码蓝灰,无法随主题翻转 |
--workspace-rail-background |
transparent |
transparent |
保持原文 |
--workspace-header-background |
var(--background) |
var(--background) |
保持原文(顶栏与内容区同白) |
--interactive |
#4e5058 |
#2e3238 |
次级交互文字/图标 → Attio Carbon(白底 12.89:1) |
--channel-icon |
#80848e |
#78828f |
频道图标灰:实测 #80848e 白底仅 2.8:1,改后 3.90:1(图标需 ≥3:1) |
--sidebar |
#fcfcfc |
#ffffff |
侧栏提成纯白面板:修掉「侧栏 = 页面底色 1.00:1」 |
--sidebar-foreground |
#060607 |
#1c1d1f |
墨色统一 |
--sidebar-primary |
var(--brand) |
var(--brand) |
保持原文 |
--sidebar-primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
保持原文 |
--sidebar-accent |
#ebedef |
#eeeff1 |
侧栏 hover 底收敛到统一灰 |
--sidebar-accent-foreground |
#060607 |
#1c1d1f |
墨色统一 |
--sidebar-border |
#dcdee1 |
#e4e7ec |
侧栏描边统一到 hairline |
--sidebar-ring |
var(--ring) |
var(--ring) |
保持原文 |
深色 .dark
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
oklch(0.145 0 0) |
#101113 |
Obsidian 画布(Attio 最深表面),代替中性灰 |
--foreground |
oklch(0.985 0 0) |
#f2f3f5 |
略降纯白:17.02:1,长时间阅读不刺眼 |
--card |
oklch(0.205 0 0) |
#17191c |
卡片比画布亮一档(1.07:1)+ hairline |
--card-foreground |
oklch(0.985 0 0) |
#f2f3f5 |
与 foreground 对齐 |
--popover |
oklch(0.205 0 0) |
#1c1e22 |
弹层再亮一档,形成画布<卡片<弹层三级 |
--popover-foreground |
oklch(0.985 0 0) |
#f2f3f5 |
同上 |
--primary |
var(--brand) |
var(--brand) |
保持原文映射 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
保持原文映射 |
--secondary |
oklch(0.269 0 0) |
#232529 |
Graphite:深色灰底控件 |
--secondary-foreground |
oklch(0.985 0 0) |
#f2f3f5 |
同上 |
--muted |
oklch(0.269 0 0) |
#17191c |
深色「沉下去」的画布:与浅色 muted 的语义镜像 |
--muted-foreground |
oklch(0.708 0 0) |
#9fa1a7 |
Fog 400:画布 7.31:1、Graphite 上 5.94:1 |
--accent |
oklch(0.269 0 0) |
#26292e |
hover 底比 secondary 亮一档 |
--accent-foreground |
oklch(0.985 0 0) |
#f2f3f5 |
同上 |
--destructive |
oklch(0.704 0.191 22.216) |
#ff7b72 |
深色危险色:画布 7.49:1、卡片 6.99:1 |
--border |
oklch(1 0 0/10%) |
#2e3238 |
Carbon:透明描边在多层深色面上会算出不同值,改实色可复算(1.47:1) |
--input |
oklch(1 0 0/15%) |
#3a4049 |
输入描边比 border 亮一档(1.81:1,见 §9 风险 R1) |
--ring |
var(--brand) |
var(--brand) |
焦点环 = 深色品牌蓝(画布 4.98:1) |
--chart-1 |
oklch(0.87 0 0) |
#407ff2 |
深色图表主序列(4.98:1) |
--chart-2 |
oklch(0.556 0 0) |
#8fb4fa |
第二序列(9.07:1) |
--chart-3 |
oklch(0.439 0 0) |
#f2f3f5 |
第三序列 = 前景(17.02:1) |
--chart-4 |
oklch(0.371 0 0) |
#9fa1a7 |
第四序列(7.31:1) |
--chart-5 |
oklch(0.269 0 0) |
#538bf3 |
第五序列(5.72:1) |
--radius |
继承 :root 0.625rem |
0.625rem | 深浅同一套圆角 |
--brand |
oklch(0.68 0.15 256) |
#407ff2 |
Cobalt Bright 一档:深底上需要更高明度 |
--brand-foreground |
oklch(0.16 0.02 258) |
#0b1526 |
深墨字于钴蓝填充(4.82:1);深色下白字只有 3.79:1 |
--brand-soft |
oklch(0.28 0.05 256) |
#16233c |
深色冰蓝软底(选中态背景) |
--brand-ink |
oklch(0.84 0.09 256) |
#8fb4fa |
冰蓝底上的品牌文字 7.52:1 |
--message-self |
#203b59 |
#1d3357 |
自己气泡:与 brand-soft 同族但亮一档,避免与选中行糊在一起 |
--message-self-foreground |
#e7f3ff |
#dbe8ff |
气泡内文字 10.22:1 |
--surface-chat-soft |
oklch(0.32 0.06 250) |
#17273d |
深色引用块底,比品牌软底更中性 |
--surface-chat-selected |
oklch(0.28 0.04 250) |
#22354f |
深色会话选中底:与前景 11.19:1,且不与 chat-soft 混同 |
--mention |
oklch(0.72 0.14 254) |
#8fb4fa |
深色 @提及(画布 9.07:1) |
--ink |
oklch(0.16 0.02 258) |
#0b1526 |
深色下 --ink 仍是「浅底上的墨字」角色(钴蓝芯片文字),与 --brand-foreground 同值 |
--surface-rail |
#e3e5e8 |
#17191c |
修掉实测缺陷:原值在深色下是一条浅色竖带 |
--workspace-background |
radial-gradient(…brand 10%…muted 64%) |
linear-gradient(180deg,#17191c,#101113) |
深色画布:顶略亮、底到 Obsidian;去掉彩色径向光斑 |
--workspace-rail-background |
color-mix(in oklab,var(--background) 45%,transparent) |
同原文 | 保持原文 |
--workspace-header-background |
linear-gradient(…) |
同原文 | 保持原文 |
--interactive |
继承浅色 #4e5058 |
#c3c9d2 |
深色次级交互文字(画布 11.34:1)——原文件 .dark 未覆盖此项,浅色值直接漏进深色 |
--channel-icon |
继承浅色 #80848e |
#9fa1a7 |
深色频道图标(7.31:1)——同上,原文件漏覆盖 |
--sidebar |
oklch(0.205 0 0) |
#17191c |
侧栏 = 卡片级表面,比画布亮一档 |
--sidebar-foreground |
oklch(0.985 0 0) |
#f2f3f5 |
15.86:1 |
--sidebar-accent |
oklch(0.269 0 0) |
#232529 |
侧栏 hover 底 = Graphite |
--sidebar-accent-foreground |
oklch(0.985 0 0) |
#f2f3f5 |
同上 |
--sidebar-border |
oklch(1 0 0/10%) |
#26292e |
侧栏描边比 --border 暗一档,避免并置面板糊在一起 |
--sidebar-ring |
var(--ring) |
var(--ring) |
保持原文 |
36 个必需变量 +
--chart-1..5+--radius全部覆盖;tokens.css另附@theme inline中 4 条阴影令牌的新值(途径 ①)。
字体与排版
字体栈(不动,原文保留):
"Geist Variable", "gg sans", "Noto Sans SC", "PingFang SC", ui-sans-serif,
system-ui, "Segoe UI", "Microsoft YaHei", Roboto, Helvetica, Arial, sans-serif
--font-mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace
为什么不引入 Attio 的 Inter / InterDisplay: styles.css 只 @import "@fontsource-variable/geist";引入 Inter 需要新增依赖与字体资产,且 Inter 无中文字形——把它插到 "Noto Sans SC" 之前不会改变中文渲染(中文仍走 Noto/PingFang),只会让拉丁与中文的基线与字面率差异更大;插到之后则等于没改。改字体的收益为零、风险为「挤掉中文回退」,故本方案不动字体栈。 途径 ① 之外的字体改动一律列为风险(§9 R7)。
字号/行高/字重阶梯(收敛目标 7 档 + 1 档数字):
| 角色 | 字号 | 行高 | 字重 | 落点 |
|---|---|---|---|---|
| 微型标签 | 11px | 1.45 (15.95px) | 500 | 时间戳、4 人未读、共 14 个应用、页脚 |
| 元信息 / 标签 | 12px | 1.4 (16.8px) | 500 | Badge(官方 text-xs)、成员数、任务 chip、频道图标计数 |
| 次级正文 | 13px | 1.45 (18.85px) | 400 | 作者名、时间、表单标签、引用块正文 |
| 正文(紧凑) | 14px | 20px | 400 | 任务卡标题、设置项、Button(官方 text-sm) |
| 正文(主) | 15px | 1.375 (20.63px) | 400 | 消息流正文、body 基准(原文保留) |
| 面板标题 | 15px | 1.3 (19.5px) | 600 | 频道头「任务看板」、弹窗小节标题 |
| 页面/弹窗标题 | 20px | 1.3 (26px) | 600 | Dialog 标题、空态标题、登录页主标题 |
| 数字 / 代码 | 13px(--font-mono) |
1.4 (18.2px) | 500 | 任务编号 WM-2049、统计数字 457 任务、kbd-chip |
对照实测的 10 档(9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26 px):小数字号(9.375 / 11.25 / 12.8 / 13.125px)全部来自以 15px 为基准的 em 计算,方向改为只用上表 7 档。注意: 既有组件的字号写在 app/ 组件的 className 里,收敛它们需要改组件文件,不属于途径 ①②③,见 §9 风险 R2;本表作为新写/重写页面级容器(空态、页脚、侧栏计数、任务大厅筛选栏)时的取值依据。
中文长文本与数字的注意点:
- 中文禁负字距。 Attio 的
-0.02em @14px、-0.015em @56px只对拉丁生效;CJK 方块字加负字距会挤压字面,在 15px 中文正文上直接掉可读性。本方案不使用任何 tracking 工具类。 - 西文字体不能挤掉中文回退: 顺序必须保持
Geist Variable → gg sans → Noto Sans SC → PingFang SC,不得在"Noto Sans SC"之前插入任何新字体名。 - 中文最小 12px: 实测
9.375px / 9.375px/400 ×14、11.25px/400 ×206这类档位用于中文会低于 12px 下限;上表把中文内容的最小档位定在 11px 仅限数字/拉丁(时间08:42、计数),中文标签最低 12px。 - 数字用
--font-mono: 任务编号、统计数字、时间在等宽字体下按列对齐,避免「457 任务 / 1554 消息」在小卡片里左右跳动;kbd-chip已经用--font-mono。 - 15px 中文 + 1.375 行高 = 20.63px 行距,实测即当前值,满足简报「正文 14–15px、行高 ≥1.375」;不要为了塞更多行把行高降到 1.3 以下(中文无词间空格,行高压缩后串行)。
关键界面改造
每条改造标注途径:① 语义令牌取值(
web/src/styles.css)|② 官方variant/size选择|③ 页面容器 flex/grid、区域尺寸/间距/滚动。
S1 应用外壳 + 空间/频道侧栏(app-shell.tsx、channel-sidebar.tsx、workspace-rail.tsx;样式常量在 web/src/components/app/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 —— 与页面底色 --background #fcfcfc 完全相同,层级对比 1.00:1;侧栏 header 52px;搜索框 30px 高、圆角 10px、底 rgba(235,238,239,0.75);会话行 240×64,时间/预览 11.25px;rail 内分隔线 rgba(5,5,9,0.22)。
改后:
| 部位 | 改后 | 途径 |
|---|---|---|
| 外层画布 | --muted #f4f5f6(纸色)铺满,去掉 --workspace-background 的上下渐变与 #e1e5f1 硬编码 |
① |
| 空间 rail | --surface-rail #f4f5f6 与画布同色;workspace-rail-surface 的右边框由 border-border/55 收敛为 hairline(--border #e4e7ec,与画布 1.14:1),不再出现「画布内一条更深的蓝灰线」 |
①(chrome.ts 的 /55 透明度属组件常量为合规简化,见 §9 R9) |
| 会话侧栏面板 | --sidebar #ffffff + --sidebar-border #e4e7ec + 14px 圆角:面板对画布 1.09:1 纸感差值 + 1px 描边,取代原「1.00:1 无层级」 |
① |
| 侧栏 header | 与内容区同白,仅用 --border 下分割线(对应参考「no visible border separating from main content」的弱化版:只留结构线,不留色块) |
① |
| 搜索框 | 底 --secondary #eeeff1(原 rgba(235,238,239,0.75) 计算后约为同色系但含 25% 透明,叠在画布上会随底色变),高度/圆角保持 30px/10px |
① |
| 会话行选中态 | --surface-chat-selected #dfe9fb + --brand-ink #1d4ed8 前景(chrome.ts 的 selectedRow 已指向这两个令牌,5.48:1),去掉 font-semibold 依赖(属组件类,见 §9 R2) |
① |
| 会话行 hover | --muted #f4f5f6 |
① |
| 未读点 / rail 选中 pill | --brand #266df0(rail 选中块为 bg-brand + text-brand-foreground 白字 4.64:1) |
① |
| 密度 | rail 图标块 71×48 → 48×48 保持(官方 size 不可改),行高结构不变;会话行 64px 保持,不压缩密度:密度收益来自去掉渐变与蓝灰层,而非挤压行高 | ③ |
S2 频道消息流(message-list.tsx、channel-thread.tsx、channel-header.tsx、channel-tabs.tsx)
现状(实测): 频道头 860×52,标题 16px/600 #060607,成员数 12px/500 #5c5e66;他人气泡 rgb(235,237,239)(= --accent)圆角 14px;自己气泡 rgb(232,243,254)(= --message-self)+ 文字 rgb(13,39,74);他人消息 15px/400,自己消息 14px/400 —— 同一列表两套字号;作者 13px/400、时间 12px/500;输入区 textarea 628×33 无边框、外层只有上边框;工具按钮 28×28;悬停动作含点赞/回复/更多/图片预览/已读状态(0 人已读 · 4 人未读)。
改后:
| 部位 | 改后 | 途径 |
|---|---|---|
| 他人气泡 | 底 --accent #eeeff1(原 #ebedef 偏蓝 → 中性灰),圆角 14px 保持 |
① |
| 自己气泡 | 底 --message-self #e4edff + 文字 --message-self-foreground #14315c(11.00:1);三蓝(#006ce7 硬编码 / #3370ff / #2563eb)收敛为一种钴蓝族 |
① |
| 引用 / 回复块 | 底 --surface-chat-soft #eef3fd、左边 2px --brand 竖线、正文 13px --muted-foreground #5f6875(5.17:1) |
① + ③ |
| 消息正文 | 统一 15px/400(自己/他人一致);自己气泡 14px 的分支删除(需改组件 className,见 §9 R2) |
③(容器/文案层级) |
| @提及 | --mention #1d4ed8(白底 6.70:1、冰蓝气泡底 5.70:1) |
① |
| 频道头 | 标题 16px/600 → 15px/600(与面板标题档合并,少一档);成员数 12px/500 --muted-foreground |
③ + ① |
| 输入区 | 外层容器底 --background(白)、上边框 --border #e4e7ec、圆角 14px(与面板一致);textarea 保持官方无边框 |
① |
| 悬停动作 / 已读态 | --interactive #2e3238(图标)、--muted-foreground(4 人未读 文案);不使用彩色 |
① |
| 状态色 | 消息域不引入任何状态色:错误/失败态用 --destructive,其余全灰阶 |
① |
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 处;AI 助手空间 395 项任务时一次渲染圆角 8px ×1591 / 10px ×844。
改后:
| 部位 | 改后 | 途径 |
|---|---|---|
| 任务卡容器 | Card(官方)+ --card #ffffff + --border #e4e7ec hairline + --shadow-e1 蓝调单步(原 --shadow-e2 双步);圆角统一到 --radius-xl 14px(消灭 8/10 混用:8px 是最小控件档,不用于卡片) |
① + ③ |
| 卡片状态脊 | 左侧 3px 竖线由 Badge variant 决定(见下表),不再用 5 个 Tailwind 色相(--chart-1/4/destructive 三个令牌值轮换) |
① |
| 状态徽标 | 官方 Badge + lucide 图标作 data-icon="inline-start",见下方状态表 |
② |
| 负责人 | Avatar(size="sm")+ 姓名 13px --muted-foreground;头像底色走 --brand-soft/--brand-ink 或 --secondary/--interactive,不再用 Tailwind 50/700 配对(实测 amber/rose/blue/emerald/teal 五组硬编码) |
① + ② |
| 大厅筛选 | Tabs(官方,variant="default",官方样式是 bg-muted 胶囊底 + 活动项白底 --shadow-e1)替代现在的自定义筛选块;全部频道 / 我发布的 / 待验收 三项 |
② |
| 列头计数 | 待处理 5 → Badge variant="secondary" + --font-mono 数字 |
② |
| 群聊大厅 hero | 营销式 hero 段落删除,改为「筛选 Tabs + 计数 + 卡片网格」三段式;网格 grid-cols-1 md:grid-cols-2 xl:grid-cols-3,卡间距 12px |
③ |
| 任务卡网格 | 三档列数(S3 实测 1440 下单列卡片过宽):minmax(280px,1fr) 自适应网格,卡内边距 12px、标题→meta 间距 8px |
③ |
| 逾期 | 唯一使用 --destructive #c62a2f(Badge destructive)的地方:逾期 2 天 与已关闭任务 |
② |
任务状态用官方 variant + 图标(不新增色相):
| 状态 | 官方 Badge variant | 图标(lucide) | 亮度/色相 |
|---|---|---|---|
| 待补充 | ghost |
circle-dashed |
--muted-foreground #5f6875 5.64:1 |
| 待处理 | secondary |
circle |
--secondary-foreground #1c1d1f on #eeeff1 14.66:1 |
| 进行中 | default |
loader-circle |
全页唯一彩色:--brand #266df0 + 白字 4.64:1 |
| 待验收 | outline |
shield-check |
hairline + --foreground 16.87:1 |
| 已完成 | outline |
circle-check |
同上,靠图标与文字明度区分 |
| 已关闭 | destructive |
circle-x |
--destructive #c62a2f 于 10% 底 4.91:1 |
「待验收 / 已完成」共用
outline:「6 态 6 variant」不可达(官方只有 5 个可用 variant +link),强行区分的代价是自定义样式(违反硬约束)。记入 §10 取舍。
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。
改后:
| 部位 | 改后 | 途径 |
|---|---|---|
| 结果卡片 | Card + --border hairline + --shadow-e1;圆角统一 --radius-xl 14px(8px 只留给徽标/小控件) |
① + ② |
| 回答正文 | 14px / 行高 20px / --foreground(不用 12.8px 这种 em 派生值;在 14 与 12 两档之间收敛) |
③ |
| 流式等待三点 | 沿用 --animate-breathe,颜色改 --brand(原为硬编码蓝);不自定义动效 |
① |
| 来源引用 | Badge variant="outline" + 域名/频道名(来源 · 任务看板),12px/500;不再另造一个 chip 组件 |
② |
| 结果统计 | --font-mono 数字 + 3 条 Separator 分隔的键值行(待处理 5 / 进行中 12 / 待验收 3 / 逾期 2),逾期数字 --destructive |
① + ③ |
| 面板宽度 | 右侧结果面板固定 320px、主区 flex-1 min-w-0;容器间距 10px,与 S1 的 8px 缝统一到 8–10px 档 |
③ |
| 滚动 | ScrollArea(官方)承担长列表,避免一次渲染 2765 个 12.8px 文本节点造成字号感知混乱 |
② |
S5 管理与设置弹窗(space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx、channel-permission-picker.tsx)
现状(实测): [role=dialog] 704×512、圆角 18px、背景 #ffffff;左侧导航项 135×36、圆角 8px;选中态底 --brand-soft(rgb(37 99 235/0.12))+ 前景 --brand-ink #1d4ed8;危险项前景 --destructive #da373c;输入框 488×32 圆角 10px;表单标签 14px。
改后:
| 部位 | 改后 | 途径 |
|---|---|---|
| 弹窗表面 | --popover #ffffff + --border #e4e7ec + --shadow-pop(新值:蓝调 rgb(28 40 64/0.1) 双步,取代原来的通用投影) |
① |
| 尺寸 | 704×512 → 720×560(max-w-[720px],官方 Dialog 的尺寸类属容器层);左导航栏 168px 固定、内容区自适应 |
③ |
| 左导航项 | 官方按钮样式(ghost 未选中 / 选中态由令牌 --brand-soft #e4edff + --brand-ink #1d4ed8 提供,5.70:1);36px 高、8px 圆角保持 |
① + ② |
| 危险项 | --destructive #c62a2f(删除频道),白底 5.57:1 |
① |
| 表单 | Field + Field.Label(官方,14px)+ Input(32px 高、10px 圆角);标签与控件间距 8px,字段间 14px |
② + ③ |
| 成员列表 | Item + Avatar + Badge variant="secondary"(角色:群主 / 管理员 / 研发 / 产品 / pmo);行高 44px |
② + ③ |
| 权限选择 | Checkbox / Select(官方)替代自定义多选块;选中项底 --secondary |
② |
| 底部动作 | 右侧 Button variant="ghost"(取消)+ Button(保存);删除单独放左侧用 variant="destructive" |
② |
S7 登录页(web/src/routes/login.tsx、sign-in.$.tsx)
现状(实测): 居中卡片,主标题 26px;「邮箱验证码 / 短信验证码」切换块 173×42(选中态背景 --background #fcfcfc + 品牌蓝文字);主按钮 356×52、白字、#2563eb;页脚 11px;文案「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」。
改后:
| 部位 | 改后 | 途径 |
|---|---|---|
| 页面画布 | --muted #f4f5f6 纸色满屏(与登录后外壳同一张纸);登录卡片 --card #ffffff + hairline --border + --shadow-e2 蓝调 |
① |
| 主标题 | 26px/600 → 20px/600 --foreground #1c1d1f(回到标题档;26px 是营销档,与 §5 阶梯冲突) |
③ |
| 切换块 | 官方 Tabs(variant="default",胶囊底 --muted、活动项白底 + --shadow-e1 + --foreground);选中态不再依赖「底色 = 页面底色」这种巧合 |
② |
| 主按钮 | 官方 Button(size="lg" = 36px 高,variant="default");52px 高度属组件尺寸类,不改——容器层改为 w-full max-w-[356px] 保持版心宽度 |
② + ③ |
| 按钮色 | --brand #266df0 + --brand-foreground #ffffff(4.64:1,达 AA 正文) |
① |
| 输入框 | Input + --input #cad0d9 描边 + 焦点 --ring 3px 光圈 |
① + ② |
| 页脚 | 11px --muted-foreground #5f6875(5.64:1;11px 用于拉丁/数字,中文若出现在此处提到 12px) |
① + ③ |
S8 应用中心(app-center.tsx、assistant-board.tsx)
现状(实测): 分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」+ 卡片(运行中 / 开发中 徽标、emoji 图标、Agent · 第三方 · chat 元信息)。
改后:
| 部位 | 改后 | 途径 |
|---|---|---|
| 应用图标 | 取消 emoji:改用 lucide 图标(bot / users / chart-bar / kanban / blocks / sparkles)置于 40×40 圆角 10px 的 --brand-soft 底 + --brand-ink 前景(5.70:1);未来接真实图标时占位不变 |
② + ① |
| 卡片 | Card + hairline + 14px 圆角;卡内:图标行 → 名称 14px/500 → 描述 13px --muted-foreground → 元信息 12px |
② + ③ |
| 状态徽标 | 运行中 → Badge variant="default"(唯一彩色,钴蓝);开发中 → Badge variant="secondary"(灰) |
② |
| 分类筛选 | Tabs(官方)+ 计数 共 14 个应用 用 --font-mono;横向滚动容器处理 8 个分类 |
② + ③ |
| 网格 | grid-cols-1 sm:grid-cols-2 xl:grid-cols-3,间距 12px;卡片 metadata 单行省略(text-overflow: ellipsis) |
③ |
| 硬编码清理 | 该视图实测含大量 Tailwind 原始调色板类(text-rose-600 ×31 等),本方案只在令牌层解决品牌一路;其余列入 §9 R3 |
①(部分) |
S6 语音频道 / 通话(rtc-group-call-ui.tsx)— 说明:依据是代码与库内数据,不是截图
本机 TRTC_ENABLED=false,界面一个语音元素都不渲染(DOM 内 aria-label 匹配「语音|通话|加入」命中 0,正文不含「语音」),/api/v1/rtc/* 返回 RTC_DISABLED;因此本方案没有 S6 的实测视觉证据,也不假装有。可给的仅是令牌级结论:
- 通话面板属于弹层 → 落
--popover/--shadow-pop(①),圆角 18px 保留(与 S5 一致); - 成员状态(
已连接 / 连接中 / 重连中 / 已断开 / 连接失败)应复用 S3 的「variant + 图标」表,而不是tone.ts里硬编码的#23a55a/#f0b232/#f06f66(实测该文件绕过语义令牌,深色不翻转 —— 列入 §9 R3); - 库里
wanman3_rtc_voice_channels30 行、wanman3_rtc_calls183 行、会议纪要 20 行说明该面是在用功能,落地时需补一次真实渲染取证后再定夺,故本方案不为其冻结任何颜色决策。
深浅色与对比度
比值按 WCAG 相对亮度公式自算(L = 0.2126R + 0.7152G + 0.0722B,sRGB 线性化;(L1+0.05)/(L2+0.05)),全部为本次取值实算,未使用估算。判定标准:正文/小字 ≥4.5:1,大字号与图形边界 ≥3:1。
浅色(实测值)
| 组合(前景 / 背景) | 前景 hex | 背景 hex | 对比度 | 是否达标 |
|---|---|---|---|---|
| 正文 / 面板 | #1c1d1f |
#ffffff |
16.87:1 | ✅ 正文 |
| 正文 / 纸色画布 | #1c1d1f |
#f4f5f6 |
15.45:1 | ✅ |
| 正文 / 灰底控件 | #1c1d1f |
#eeeff1 |
14.66:1 | ✅ |
| 正文 / 侧栏面板 | #1c1d1f |
#ffffff |
16.87:1 | ✅ |
| 次级文字 / 面板 | #5f6875 |
#ffffff |
5.64:1 | ✅ 正文 |
| 次级文字 / 纸色画布 | #5f6875 |
#f4f5f6 |
5.17:1 | ✅(Attio 原值 #6f7988 仅 4.04:1 ❌) |
| 次级文字 / 灰底控件 | #5f6875 |
#eeeff1 |
4.90:1 | ✅ |
| 次级交互(图标/导航)/ 面板 | #2e3238 |
#ffffff |
12.89:1 | ✅ |
| 频道图标 / 面板(图形) | #78828f |
#ffffff |
3.90:1 | ✅ 图形(原 #80848e 约 2.8:1 ❌) |
| 按钮白字 / 品牌钴蓝 | #ffffff |
#266df0 |
4.64:1 | ✅ 正文(临界,勿再抬明度) |
| 品牌蓝作为文字 / 面板 | #266df0 |
#ffffff |
4.64:1 | ✅ |
| 品牌深文字 / 冰蓝软底 | #1d4ed8 |
#e4edff |
5.70:1 | ✅ |
| @提及 / 面板 | #1d4ed8 |
#ffffff |
6.70:1 | ✅ |
| @提及 / 自己气泡 | #1d4ed8 |
#e4edff |
5.70:1 | ✅ |
| 自己气泡文字 / 气泡底 | #14315c |
#e4edff |
11.00:1 | ✅ |
| 会话选中行文字 / 选中底 | #1d4ed8 |
#dfe9fb |
5.48:1 | ✅ |
| 危险色 / 面板 | #c62a2f |
#ffffff |
5.57:1 | ✅(原 #da373c 4.83:1 ✅) |
| 危险色 / 10% 危险底 | #c62a2f |
#f9eaea |
4.91:1 | ✅(原组合 4.26:1 ❌) |
| 墨色 / 冰蓝软底 | #1c1d1f |
#e4edff |
14.34:1 | ✅ |
| 白面板 / 纸色画布(层级,非文本) | #ffffff |
#f4f5f6 |
1.09:1 | ⚠️ 见下方说明 |
| hairline 描边 / 白面板(非文本) | #e4e7ec |
#ffffff |
1.24:1 | ⚠️ 见下方说明 |
| 输入描边 / 白面板(非文本) | #cad0d9 |
#ffffff |
1.55:1 | ⚠️ <3:1,风险 R1 |
深色(实测值)
| 组合(前景 / 背景) | 前景 hex | 背景 hex | 对比度 | 是否达标 |
|---|---|---|---|---|
| 正文 / 画布 | #f2f3f5 |
#101113 |
17.02:1 | ✅ |
| 正文 / 卡片 | #f2f3f5 |
#17191c |
15.86:1 | ✅ |
| 正文 / 侧栏 | #f2f3f5 |
#17191c |
15.86:1 | ✅ |
| 次级文字 / 画布 | #9fa1a7 |
#101113 |
7.31:1 | ✅ |
| 次级文字 / 灰底控件 | #9fa1a7 |
#232529 |
5.94:1 | ✅ |
| 次级文字 / 画布(muted) | #9fa1a7 |
#17191c |
6.82:1 | ✅ |
| 次级交互 / 画布 | #c3c9d2 |
#101113 |
11.34:1 | ✅ |
| 频道图标 / 画布(图形) | #9fa1a7 |
#101113 |
7.31:1 | ✅ |
| 深墨字 / 品牌钴蓝(按钮) | #0b1526 |
#407ff2 |
4.82:1 | ✅ 正文(白字方案仅 3.79:1 ❌,故反相) |
| 品牌蓝作为文字 / 画布 | #407ff2 |
#101113 |
4.98:1 | ✅ |
| 品牌浅文字 / 冰蓝软底 | #8fb4fa |
#16233c |
7.52:1 | ✅ |
| @提及 / 画布 | #8fb4fa |
#101113 |
9.07:1 | ✅ |
| 自己气泡文字 / 气泡底 | #dbe8ff |
#1d3357 |
10.22:1 | ✅ |
| 会话选中行文字 / 选中底 | #8fb4fa |
#22354f |
5.96:1 | ✅ |
| 正文 / 引用块底 | #f2f3f5 |
#17273d |
13.57:1 | ✅ |
| 危险色 / 画布 | #ff7b72 |
#101113 |
7.49:1 | ✅ |
| 危险色 / 卡片 | #ff7b72 |
#17191c |
6.99:1 | ✅ |
| 危险色 / 20% 危险底 | #ff7b72 |
#452d2d |
5.00:1 | ✅ |
| 卡片 / 画布(层级,非文本) | #17191c |
#101113 |
1.07:1 | ⚠️ 见下方说明 |
| hairline 描边 / 画布(非文本) | #2e3238 |
#101113 |
1.47:1 | ⚠️ 见下方说明 |
| 输入描边 / 画布(非文本) | #3a4049 |
#101113 |
1.81:1 | ⚠️ <3:1,风险 R1 |
关于三个 ⚠️(诚实声明)
- 面板 / 画布的 1.07–1.09:1 是有意的。 参考的实现方式就是「白面板浮在纸色画布上 + hairline 收口」;相邻表面的面积比描边对比更决定层级感知。它不承担文本可读性,也不是 WCAG 1.4.11 意义上的「识别组件所必需的边界」——真正的组件边界是输入框描边(风险 R1)。
- hairline
#e4e7ec在#ffffff上只有 1.24:1。 这是 Attio 的原始取值(Mist 50#e4e7ec),也明显低于 3:1。它只做分组线,不界定可交互控件;交互控件由--input承担。 --input1.55:1 仍低于 3:1 —— 明确记为风险 R1,缓解手段是焦点态--ring #266df0的 3px 光圈(4.64:1)与--muted纸色画布上的白输入框(1.09:1 反向对比)。若验收要求输入边界必须 ≥3:1,唯一合规做法是把--input压到 ~#767676(3.0:1),这将直接摧毁参考的细描边语言 —— 需要产品与设计明确取舍,本方案不擅自决定。
shadcn 兼容性
结论:全部改造只用官方组件与官方 variant/size 即可达成,不需要新增自定义样式。 涉及组件(全部已安装,路径 web/src/components/ui/):
| 用途 | 组件 | 用到的官方 variant / size |
|---|---|---|
| 主/次/危险动作 | button.tsx |
default / outline / secondary / ghost / destructive / link;xs / sm / default / lg / icon |
任务状态、运行中/开发中、来源引用、计数 |
badge.tsx |
default / secondary / outline / ghost / destructive |
| 登录与表单输入 | input.tsx |
唯一形态,颜色全部走 --input / --ring |
| 大厅筛选、登录验证码切换、应用中心分类 | tabs.tsx |
tabsListVariants 的 default(bg-muted 胶囊) |
| 负责人、成员列表 | avatar.tsx + separator.tsx |
默认尺寸 + sm |
| 任务卡、应用卡、结果卡 | card.tsx |
默认 |
| 设置弹窗、发布任务 | dialog.tsx (+ field.tsx、input-group.tsx) |
官方组合 |
| 成员行、应用行 | item.tsx |
默认 |
| 长列表滚动(AI 结果、成员) | scroll-area.tsx / scroll-region.tsx |
默认 |
| 提示 | tooltip.tsx |
默认 |
图标: components.json 的 iconLibrary: "lucide" 已是官方选择;S3 状态图标与 S8 应用图标全部从 lucide 取,size 由组件自带的 [&_svg]:size-4 / size-3 决定,不写自定义尺寸类。
需要新增的官方组件:无。 统计视图的图表组件不在 web/src/components/ui/(该目录无 chart.tsx),--chart-1..5 令牌仅服务自有图表实现;本方案只改这 5 个令牌的值,不涉及组件引入。
必须显式声明的不合规风险(改动确实超出「①令牌 ②variant ③容器」三条途径的部分):
| 编号 | 内容 | 性质 |
|---|---|---|
| R2 | 修改 app/ 组件内既有的字号/底色 className:message-list.tsx 自己消息 14px → 15px、chrome.ts 的 selectedRow 去掉 font-semibold、railSep 的 bg-foreground/22、workspaceSplitPanelFrame 的 md:ring-1 md:ring-foreground/[0.06] |
不合规风险:属于对组件的类覆盖。若维护者判定不可行,则保留现状并接受「同一消息列表两套字号」这一实测缺陷 |
| R3 | tone.ts 的 6 组 Tailwind 原始调色板(bg-emerald-50/text-emerald-700 …)与 chrome.ts/tong.ts/voice-channel-history-dialog.tsx/message-list.tsx 里的硬编码 #23a55a、#f0b232、#f06f66、#006ce7、#3370FF |
令牌层无法覆盖(253 处 / 44 文件)。改它们=改代码,记为风险;本方案仅在令牌层把「品牌蓝一路」收敛 |
| R4 | 深色主题在生产不可达(全仓无代码添加 .dark、无 localStorage 主题键、<html> class 恒空) |
本方案交付的深色令牌可生效但不可见,需要另立「主题切换」任务;不改代码则深色分支无法验收 |
| R5 | 深色下 55 处前景 rgb(6,6,7)、27 处 rgb(92,94,102)、6 处边框 rgb(220,222,225)、3 处头像底 rgb(255,251,235) 等浅色硬编码 |
令牌无法翻转它们;这些必须由 R2/R3 的代码清理覆盖 |
| R1 | --input 边界对比 1.55:1(浅)/ 1.81:1(深)< WCAG 1.4.11 的 3:1 |
合规范畴的风险,见 §7 说明;需产品决策 |
| R7 | 参考的 Inter/ss03 字体特征、-0.02em 负字距、InterDisplay 大标题、TiemposText 衬线声部不迁移 |
主动舍弃(不是违规) |
| R8 | S6 语音频道无实测视觉证据(TRTC_ENABLED=false) |
交付范围不含 S6 的颜色冻结 |
| R9 | chrome.ts 中 /55、/45、/22 这类透明度修饰(如 border-border/55)会算出非令牌值(实测 rail 右边框 rgba(220,222,225,0.55)) |
令牌层无法消除;属 R2 同类,需代码清理才可复算 |
实施成本
改动面
| 范围 | 文件 | 规模 | 途径 |
|---|---|---|---|
| 必做(令牌) | web/src/styles.css::root 43 行 + .dark 45 行 + @theme inline 4 条阴影 |
约 92 行替换 | ① |
| 必做(验证) | 无代码;用 devtools getComputedStyle 抽查 |
— | — |
| 选做 A(容器布局) | app-shell.tsx、channel-sidebar.tsx、task-hall.tsx、group-hall.tsx、app-center.tsx、login.tsx、五处弹窗:只改 flex/grid、宽度、间距,不碰组件类 |
约 8–12 处容器 | ③ |
| 选做 B(variant/图标) | 任务状态徽标、应用图标、大厅筛选、登录切换块、设置弹窗表单:换成官方 Badge/Tabs/Button variant + lucide 图标 |
约 6 处 JSX | ② |
| 清理(风险项) | chrome.ts(/55、font-semibold、ring)、tone.ts(6 组 Tailwind 调色板 → 语义令牌)、message-list.tsx(字号统一、#006ce7) |
3 个文件,约 40 行 | R2/R3,需豁免确认 |
人时预估(单人,熟悉本仓)
| 任务 | 预估 | 说明 |
|---|---|---|
替换 styles.css 令牌块 + 自检对比度 |
1.5 h | 令牌可直接粘贴 tokens.css |
| S1 + S2 容器层调整与目视核对 | 3 h | 分栏宽度、会话行选中态、消息流间距 |
| S3 + S8 徽标/图标/筛选改造 | 3 h | 官方组件替换 + lucide 图标映射 |
| S4 + S5 + S7 容器与表单 | 3 h | 弹窗尺寸、成员列表、登录页版心 |
| R2/R3 清理(若批准) | 4 h | 涉及 3 个文件与深色回归 |
| 深色可达性(R4,另立任务) | 2 h | 注入 .dark 的开关 + 持久化 |
| 合计(不含 R4) | ≈14.5 h | 纯令牌部分仅 1.5 h 就能拿到主要观感收益 |
风险清单(按严重度排序)
- R4 深色不可达 —— 最大风险:本方案的深色分支无法在现网验收。必须与产品确认是否同批做主题开关;否则深色部分只能作为「令牌已就绪」的证据。
- R2 组件类改动需豁免 —— 若不批准,S2 的双字号、S1 的选中态字重依赖会保留。
- R3 253 处硬编码色 —— 深色下仍会有浅色块(头像底、
tone.ts六色、文件预览色板);本方案不承诺消除。 - R1 输入框边界 <3:1 —— 需产品在「细描边美学」与「WCAG 1.4.11」之间做决定。
--brand-foreground语义反转(浅色白字 / 深色深字) —— 若某个页面把brand-foreground当作「总是白」来用(如登录页按钮硬要求白字),深色下会变成深字。需按 R4 一起回归。
验证方式(能证明改动生效的检查)
- 令牌生效: 在
/app控制台执行getComputedStyle(document.documentElement).getPropertyValue('--background')→ 期望#ffffff;--brand→#266df0;--sidebar→#ffffff;--surface-rail→#f4f5f6。 - 层级修复: 对比
aside的background与body的background,改后应分别为rgb(255,255,255)与rgb(244,245,246)(改前两者同为#fcfcfc)——这是 S1 缺陷是否修掉的唯一判据。 - 对比度: 用 §7 的 22 组 hex 重新跑相对亮度脚本,断言全部 ≥4.5(文本)或 ≥3.0(图形);⚠️ 三组(面板/画布、hairline、input 边界)为已知例外,脚本里显式白名单。
- 深色回归: 往
<html>注入.dark后执行简报同款普查,断言--surface-rail不再是#e3e5e8(浅色竖带消失);同时确认仍存在的rgb(6,6,7)前景数量 —— 该数字不下降即证明 R3/R5 未被本次改动覆盖,避免误判「深色已修好」。 - 消息字号一致性: 在频道消息流里选自己与他人各一条消息,
getComputedStyle(...).fontSize应同为15px(改前为14px/15px)。 - 状态徽标: 任务大厅中「进行中」是全页唯一彩色徽标;用颜色计数脚本断言
#266df0在徽标集合内只出现在defaultvariant 上。
取舍
解决了什么:
- 层级归位。 侧栏/画布从 1.00:1 的零对比改成「纸色画布 + 白面板 + hairline」三层结构,且层级来源只剩两类(面积 + 描边),不再有渐变、多重 ring、阴影混用。
- 一种彩色。 三种蓝(
#2563eb/#006ce7/#3370ff)在令牌层收敛为钴蓝族;「进行中 / 未读 / @提及 / 选中」共享同一色相,注意力信号可视化更贵——只有需要你看一眼的东西才配变色。 - 对比度全部可算且达标。 22 组关键组合实测,文本 ≥4.64:1、图形 ≥3.90:1(除 3 组已声明的非文本边界例外)。
- 深色从「一半不可读」到「有完整取值」。 修掉
--surface-rail浅色竖带、补齐.dark未覆盖的--interactive/--channel-icon,并把品牌填充反相为深墨字(3.79:1 → 4.82:1)。 - 零新增依赖、零组件变体。 全部改动落在
styles.css一个文件的令牌块内即可复现。
牺牲了什么:
- 纸感层级很弱(1.07–1.09:1)。 在低亮度屏幕或强环境光下,白面板与纸色画布可能几乎看不出差别;这是参考语言本身的代价,靠 hairline 兜底。若要更强分层就必须回退到阴影或更深的画布色,直接偏离参考。
- 颜色信息量下降。
tone.ts的六色相(emerald/teal/amber/blue/rose/slate)在语义上更易区分(比如「项目 / 行业 / 优先级」分类);统一到钴蓝+灰阶后,这些分类必须改用文字或图标表达。本方案不为非品牌色相提供替代令牌(那等于引入第二个强调色)。 - 6 个任务状态用 5 个可用 variant 表达,「待验收 / 已完成」只能靠图标与文字明度区分。 在 1440×900 的任务看板里,小尺寸下这种区分弱于颜色区分;要更强区分必须新增自定义 variant(违反硬约束)。
- 输入框边界仍低于 3:1(R1)。 保留了细描边美学,代价是无障碍合规上的一个明确缺口。
- Badge 保持 26px 胶囊,无法拿到参考的 7px 徽标圆角;在密集看板上胶囊比方形更占宽,卡片标题可用宽度略减。
什么场景下不适用:
- 需要多色相区分语义:如果后续「任务类别 / 业务线 / 优先级」都要颜色编码,本方案的单一彩色纪律会成为阻塞(届时需要重新定义
--chart-*或引入一套官方组件之外的样式系统)。 - 深色为主的使用场景:本方案深色是对等而非优先,且强依赖 R4 的主题开关落地;纯深色产品应另选以深色为基准面的方案。
- 需要强品牌表达对外:参考是「让产品自己安静」,若
/app需要承载品牌营销面(活动、行业模板展示),本方案的克制会显得过于朴素。 - 触摸/移动优先:本方案沿用桌面三栏与 64px 会话行,未针对触屏重排(仅保留
tap-target的 44px 命中区扩展)。