wanman /app 重设计方案 —— Stripe(靛蓝账本)

方案名与主张

中文方案名:靛蓝账本

一句话主张:把近白画布改造成一本「分层账本」——用 #ffffff → #f0f5fa → #edf2f8 → #e5edf5 四级底色递进划分区域、用 3:1 以上的实线规则取代当前 1.35:1 的浅灰描边、把圆角从 10px 收到 6px;品牌靛蓝 #533afd 只在按钮、选中态、@提及、图标描边这类小面积功能位出现,绝不铺大面积背景。

适用基调:浅色优先,深色对等。 浅色是主场景(一线人员白天驻留、高信息密度);深色两套令牌全部给满值并逐条给出对比度实测,因为 /app 的深色当前生产不可达(见 §8 风险 R6),方案必须先把两套值备好,开关一旦补上即可验收。


参考提炼

项 值
参考风格名 Stripe — indigo-ink ledger on frosted glass
slug stripe(stripe.design.md / stripe.design-extended.md)
来源站点 stripe.com
theme light(参考本身只声明浅色,深色由本方案按同一纪律反推)

可迁移规则(5 条,引原文要点)

  1. 单一强调色纪律:“Use #533afd exclusively for primary actions, active links, and icon strokes — never for body text, backgrounds spanning large areas”、“Do not introduce additional accent colors — the system is monochromatic plus one indigo”。 → 迁移:--brand: #533afd 只做按钮/选中/@提及/图标描边;--chart-1..5 的状态色属于功能色(见 §4 意图列),不进入装饰位。
  2. 零阴影、靠底色递进造层级:“Stripe avoids shadows entirely. Depth and hierarchy are created through background tint progression (white → #f8fafd → #e5edf5 → #e8e9ff → #533afd)”。 → 迁移:把当前「面板靠 shadow-e2 立起来」改成「底色四级递进 + 规则线」,--card/--muted/--secondary/--accent 直接落在这条递进上。
  3. 4px 圆角家族:“Use 4px border-radius on all buttons, inputs, and cards — never 0px (too sharp), never pill (too friendly), never 8px+ (too soft)”。 → 迁移为 --radius: 0.375rem(6px)。这是对参考数值的有意偏离:参考是营销页 16–56px 拉丁文排版,/app 正文 14–15px 且中文小字(12px)笔画密集,4px 在 12px 汉字旁过锐;6px 仍落在「非 0、非 pill、非 8px+」的规则区间内,且 --radius-lg/md 分别是 6px/4.8px,与参考的 4px 家族同量级。
  4. 1px 规则线是主要结构元素:“A 1px solid line in #e5edf5 spanning the full content width… This is the primary structural element of the layout”。 → 迁移方向一致但数值上调:参考的 #e5edf5 在白底上只有 1.18:1,实测当前 --border #dcdee1 对白底也仅 1.35:1,这正是简报 §3.3「会话侧栏与页面底色零层级对比」的根因。本方案把边界分成两档:--input #6e7d93(4.19:1,控件边界)与 --border #7d8b9f(3.46:1,结构规则),两个都 ≥3:1(WCAG 1.4.11)。
  5. 排版节制 + 表格数字:“Weight 300 dominates… Weight 400 appears only at 14–16px where small-size readability needs the extra stroke”、“Apply font-feature-settings: 'ss01' on, 'tnum' on”。 → 迁移:中文界面全量用 400(300 在 12px 汉字上不可读),只在展示级数字(任务总数 26px)用 300;数字列用 --font-mono 或 tnum 对齐(落点见 §5)。

因产品形态必须舍弃的项(明确列出)


适配判断

为什么这套语言适合「任务 + 频道消息」双核心

  1. 账本 = 可审计。产品核心是「发布 → 接单 → 履约 → 验收 → 存档」,本质是带责任人的流水账。参考的 “the whole interface behaves like a ledger or terminal: dense information, crisp rules” 与这个任务的审计语义同构:每行任务卡是一条账目,待补充/待处理/进行中/待验收/已完成/已关闭(简报 §3.3 真实状态词)就是账目状态。
  2. 单一强调色 = 状态可读。实测单视图内同时出现 9/9.375/11/11.25/12/12.8/13.125/14/15/26px 十档字号、2/6/7/8/10/12/14/18/24/26/32/9999px 十二档圆角,视觉噪音已经很高(简报 §3.3)。再叠加 253 处 Tailwind 原始调色板(amber 69 / rose 68 / slate 44 / emerald 42…),颜色也在互相竞争。把装饰性颜色全部收成「靛蓝 + 雾/霜灰阶」,剩下的颜色预算就能全部让给状态(§6 S3)。
  3. 底色递进替代描边 = 高密度下的可扫读性。1554 条消息、457 个任务的长列表里,逐行读 1px 灰线是很累的;参考的做法是把「这属于哪个区域」交给底色,把「这条数据在哪」交给对齐与留白。首屏 4 个区域(rail / 会话列 / 频道区 / 成员栏)用 4 级底色,比 4 条线更快被眼睛分区。
  4. 挫折点直击:实测 3 个具体缺陷都能被这套语言直接修掉——会话侧栏 #fcfcfc 与页面底色 #fcfcfc 完全相同;面板圆角 14px 与弹窗 18px、卡片 10px/8px 混用;他人气泡 15px / 自己气泡 14px 两套字号。

舍弃项(列出并给出原因)

舍弃项 原因
全站权重 300 中文最小 12px(简报 §2.4),Noto Sans SC Light 在 12–13px 下发虚;只保留展示级数字用 300
40–56px display 字号 /app 最大标题实测 26px(登录页主标题),任务卡标题 14px;引入 display 档位无落点
1320px 居中内容列 频道区实测宽 860px、消息列表本身要满宽滚动,居中列会浪费 1440 屏宽
「完全无阴影」 见 §2 舍弃项第 2 条
参考的 #7389ff / #839bc8 / #b9b9f9 用作文字色 #7389ff 白底仅 3.4:1、#839bc8 2.8:1,均不满足 4.5:1;它们只作为深色系品牌色与描边的推导依据,不作浅色文字

令牌映射

落点全部在 web/src/styles.css(:root 从 108 行起、.dark 从 145 行起、@theme inline 从 27 行起),改动方式 = 途径①(语义令牌取值)。当前值取自简报 §3.1 原文;「建议值」的推导写在意图列。本方案的 tokens.css 可直接替换这三段。

浅色 :root

变量名 当前值 建议值 意图
--background #fcfcfc #ffffff 采用参考 Canvas「纯白」;白底让 3:1 规则线的计算基准唯一,也让 rail 靛带成为唯一的彩色区域
--foreground #060607 #061b31 参考 Midnight Ink;冷蓝调近黑与靛蓝强调色同色系,17.37:1 于白底
--card #ffffff #ffffff 不变;账本的「纸」
--card-foreground #060607 #061b31 同 --foreground
--popover #ffffff #ffffff 不变;弹窗与卡片同纸
--popover-foreground #060607 #061b31 同 --foreground
--primary var(--brand) var(--brand) 不变(映射保留)
--primary-foreground var(--brand-foreground) var(--brand-foreground) 不变(映射保留)
--secondary #ebedef #edf2f8 参考 Mist #f8fafd 与 Frost #e5edf5 的 40/60 线性混合;这是他人消息气泡底色(components/app/message-bubble.tsx:20 用 variant="secondary"),改冷色相与自己的紫调气泡区分
--secondary-foreground #060607 #061b31 他人气泡文字 15.43:1
--muted #f2f3f5 #f0f5fa Mist/Frost 60/40 混合;用作非 IM 侧栏画布(chrome.ts:40 sidebarAside)与看板底、hover 底,比 --background 深一档形成区域层级
--muted-foreground #5c5e66 #50617a 参考 Steel;次级文字(时间戳 12px、成员数 12px、预览 11.25px),白底 6.3:1、在他气泡底 5.6:1,留足中文小字余量
--accent #ebedef #e5edf5 参考 Frost 原值;hover 底与下拉菜单 hover(*:bg-accent 系),比 --muted 再深一档
--accent-foreground #060607 #061b31 Frost 上 14.69:1
--destructive #da373c #c0343b 当前值对白底只有 4.27:1(12px 文字不达标);压深到 4.5:1 以上(实测 5.53:1),并在 destructive/10 底上仍 4.84:1
--border #dcdee1 #7d8b9f 本方案最重要的改动。当前 1.35:1(实测),区域/控件边界无法分辨;新值 = Frost 30% + Steel 70% 线性混合,对白底 3.46:1、对 --muted 底 3.16:1,满足 WCAG 1.4.11 的 3:1
--input #dcdee1 #6e7d93 控件边界要比结构线更实,用户才能一眼找到「可输入处」;= Frost 20% + Steel 80%,白底 4.19:1、--muted 底 3.82:1
--ring var(--brand) var(--brand) 不变;焦点环 3px、ring/50 换算后约 2.3:1,但同一状态下 focus-visible:border-ring 会把 1px 边框变 #533afd(6.19:1),焦点态整体 ≥3:1
--chart-1 oklch(0.87 0 0) #0f6f57 功能色:任务状态「已完成/成功」。全仓无消费者(grep -rn "chart-[0-9]" web/src 只命中 styles.css 自身与 @theme 映射),因此按状态语义重排为「成功」档,白底 6.12:1
--chart-2 oklch(0.556 0 0) #533afd 「进行中」= 品牌靛蓝本身(进行中的任务就是系统正在处理的那笔账),白底 6.19:1
--chart-3 oklch(0.439 0 0) #8a5300 「待处理/待补充」= 低饱和琥珀,只承担「排队中」语义,白底 6.33:1
--chart-4 oklch(0.371 0 0) #b3262e 「风险/逾期」,白底 6.49:1(与 --destructive 同色相、更深一档,用于徽标底色)
--chart-5 oklch(0.269 0 0) #50617a 「已关闭/归档」= 中性 Steel,白底 6.3:1
--radius 0.625rem 0.375rem 参考 4px 圆角家族的最近可用值(理由见 §2 规则 3);派生值:radius-md 4.8px、radius-lg 6px、radius-xl 8.4px、radius-2xl 10.8px、radius-3xl 13.2px、radius-4xl 15.6px。实测当前最密集的两档(rounded-lg 10px×48、rounded-md 8px×37)随之收敛为 6px/4.8px
--brand #2563eb #533afd 参考 Indigo Ink;白底 6.19:1,作为按钮底时白字 6.19:1
--brand-foreground #ffffff #ffffff 不变;按钮文字
--brand-soft rgb(37 99 235 / 0.12) rgb(83 58 253 / 0.12) 换成新品牌色通道;混合到白底为 #eae7ff,前景文字 14.37:1
--brand-ink #1d4ed8 #4726e8 选中态文字色(chrome.ts:18 selectedRow 用 text-brand-ink)。必须同时压得住 --surface-chat-selected #ded9ff(5.71:1)与白底(7.75:1)
--message-self #e8f3fe #e8e9ff 参考 Periwinkle Wash;自己气泡改成紫调,与灰色调的他人气泡形成色相区分(不再靠「浅蓝 vs 浅灰」这种低区分度组合)
--message-self-foreground #0d274a #182659 参考 Deep Violet;在 #e8e9ff 上 12.0:1,读数最舒服的一档
--surface-chat-soft #e8f2ff #f1f0ff 最浅一档紫调面,用于回复引用块/软强调(比自己气泡底色更浅,避免三层紫底混淆)
--surface-chat-selected #e5ecfc #ded9ff 会话/频道选中底。参考把「选中」视为最强的强调位(Indigo Ink…selected navigation states),故取三档紫底中最深的一档,白底 1.36:1(靠颜色而非亮度表达选中),文字 5.71:1
--mention #3370ff #4726e8 消灭「三种蓝」(简报 §3.3:令牌 --brand、硬编码 #006ce7、--mention #3370ff)。@提及重新并入单一强调色,且在紫调气泡上仍 6.47:1
--ink #060607 #061b31 与 --foreground 同值,语义别名保留
--surface-rail #e1e8f2 #e6e7fd 最左 72px 轨道带改为靛调(Periwinkle 家族),把品牌色限制在这条细带里,同时让「白卡片浮在靛带上」成为全站最强的分区信号
--workspace-background linear-gradient(180deg, var(--surface-rail), #e1e5f1) linear-gradient(180deg, var(--surface-rail) 0%, #f4f4fe 58%, var(--background) 100%) 任务允许的「渐变只用于强调区块」= 这条 72px 竖带:上端靛蓝、下端落回纸白,面板之间的 4–8px 缝因此呈渐变靛色而不是旧的蓝灰
--workspace-rail-background transparent transparent 不变(保留渐变可见)
--workspace-header-background var(--background) var(--background) 不变
--interactive #4e5058 #50617a rail 图标色(chrome.ts:34 railItemBase 用 text-interactive);在 #e6e7fd 带上 5.17:1,图标 ≥3:1
--channel-icon #80848e #64748d 参考 Slate;频道 # / 锁形图标,白底 4.75:1,比当前 #80848e(4.1:1)更稳
--sidebar #fcfcfc #f0f5fa 由 --muted 对齐(chrome.ts:40 非 IM 侧栏即 bg-muted),让 shadcn sidebar 令牌族与真实侧栏一致
--sidebar-foreground #060607 #061b31 同 --foreground
--sidebar-primary var(--brand) var(--brand) 不变
--sidebar-primary-foreground var(--brand-foreground) var(--brand-foreground) 不变
--sidebar-accent #ebedef #e5edf5 对齐 --accent(Frost)
--sidebar-accent-foreground #060607 #061b31 不变语义
--sidebar-border #dcdee1 #7d8b9f 对齐 --border(3:1 规则线)
--sidebar-ring var(--ring) var(--ring) 不变

深色 .dark

深色在参考中无对应(参考只声明 light),因此按同一纪律反推:靛蓝当强调、底色递进反向(越靠内容越亮),并把当前「未定义的变量靠 :root 继承」补成显式值。

变量名 当前值 建议值 意图
--background oklch(0.145 0 0) #0a1522 中性灰改为 Midnight Ink 家族的深藏青,与浅色 #061b31 同色相;纯灰会在靛蓝旁边发脏
--foreground oklch(0.985 0 0) #e6edf7 冷白文字,15.59:1;避免纯白在深藏青上产生光晕
--card oklch(0.205 0 0) #111f30 比背景亮一档(递进反向),14.12:1
--card-foreground oklch(0.985 0 0) #e6edf7 同 --foreground
--popover oklch(0.205 0 0) #16263a 弹窗是更高一层,比 card 再亮一档
--popover-foreground oklch(0.985 0 0) #e6edf7 同 --foreground
--primary 继承 var(--brand) var(--brand) 在 .dark 显式声明(原先靠继承,易被误读为「深色无此令牌」)
--primary-foreground 继承 var(--brand-foreground) 同上
--secondary oklch(0.269 0 0) #1b2c42 他人气泡底色(暗色下用藏青而非紫,与自己的紫调气泡区分)
--secondary-foreground oklch(0.985 0 0) #dbe5f3 11.12:1
--muted oklch(0.269 0 0) #152335 侧栏/看板画布,比 --background 亮一档
--muted-foreground oklch(0.708 0 0) #9fb0c9 次级文字;纯灰 oklch(0.708 0 0) 在藏青底上发闷,改成带蓝调;8.33:1
--accent oklch(0.269 0 0) #1e3048 hover 底,比 muted 再亮一档
--accent-foreground oklch(0.985 0 0) #e6edf7 同 --foreground
--destructive oklch(0.704 0.191 22.216) #ff8a8f 深底需要更高明度才够 4.5:1(8.12:1),并保持与浅色 #c0343b 同一「警示」色相
--border oklch(1 0 0 / 10%) rgb(226 233 245 / 0.42) 10% 在深底上实测约 1.5:1;42% 混合到 #0a1522 得 #656e7b(3.56:1)、到 #111f30 得 #697483(3.51:1)
--input oklch(1 0 0 / 15%) rgb(226 233 245 / 0.56) 控件边界更实:混合得 #838c98(5.40:1)/#86909e(5.15:1)
--ring 继承 var(--brand) 显式声明
--chart-1 oklch(0.87 0 0) #4fd6a5 「已完成」在深底用高明度绿,10.05:1
--chart-2 oklch(0.556 0 0) #8b7bff 「进行中」= 深色品牌靛蓝(--brand),5.58:1
--chart-3 oklch(0.439 0 0) #f0b25c 「待处理」琥珀,9.82:1
--chart-4 oklch(0.371 0 0) #ff8a8f 「风险」与 --destructive 同值,8.12:1
--chart-5 oklch(0.269 0 0) #9fb0c9 「已关闭」中性蓝灰,8.33:1
--brand oklch(0.68 0.15 256) #8b7bff 深底上的强调色需要更亮才能承载白/黑字;参考的 #7389ff 作推导依据,实际取更紫一档以保持与浅色 #533afd 同色相(257°)
--brand-foreground oklch(0.16 0.02 258) #0c1226 按钮文字用深藏青(沿用原值思路),在 #8b7bff 上 5.64:1
--brand-soft oklch(0.28 0.05 256) rgb(139 123 255 / 0.22) 与浅色同构的写法(alpha 表达式),混合到 #0a1522 得 #262b53
--brand-ink oklch(0.84 0.09 256) #b3a6ff 选中态文字;对 #2b2a63 6.08:1、对背景 8.59:1
--message-self #203b59 #211d52 自己气泡改成紫调面,与浅色方案同构
--message-self-foreground #e7f3ff #e9ecff 13.15:1
--surface-chat-soft oklch(0.32 0.06 250) #171a3a 最浅一档紫面(在暗色系里是「最不亮」的一档)
--surface-chat-selected oklch(0.28 0.04 250) #2b2a63 选中底,三档紫面中最强
--mention oklch(0.72 0.14 254) #b3a6ff 与 --brand-ink 同值,保持「一个强调色」
--ink oklch(0.16 0.02 258) #0a1522 与背景同值,语义别名
--surface-rail #e3e5e8 color-mix(in oklab, var(--brand) 22%, var(--background)) 修 BUG:当前深色下 #e3e5e8 是一条浅色竖带(简报 §3.3)。改为由品牌色混出的暗紫带(实测约 #262b53),图标 --interactive 在其上 6.42:1
--workspace-background radial-gradient(…var(--brand) 10%…) linear-gradient(180deg, var(--surface-rail) 0%, color-mix(in oklab, var(--surface-rail) 45%, var(--background)) 58%, var(--background) 100%) 与浅色同构的竖带渐变;上端紫、下端落回背景
--workspace-rail-background color-mix(in oklab, var(--background) 45%, transparent) transparent 与浅色一致,让渐变带完整可见(原值会让轨道带半透明叠在渐变上)
--workspace-header-background linear-gradient(180deg, color-mix(…var(--brand) 3%), var(--background)) 同原表达式 不变,仅保留品牌色轻微参与
--interactive 继承 #9fb0c9 rail 图标色,在暗紫带上 6.42:1
--channel-icon 继承 #8b9ab2 频道图标,背景上 6.44:1
--sidebar oklch(0.205 0 0) #0f1b2b 对齐 --muted 语义
--sidebar-foreground oklch(0.985 0 0) #e6edf7 同 --foreground
--sidebar-primary 继承 var(--brand) 显式声明
--sidebar-primary-foreground 继承 var(--brand-foreground) 显式声明
--sidebar-accent oklch(0.269 0 0) #1e3048 对齐 --accent
--sidebar-accent-foreground oklch(0.985 0 0) #e6edf7 同 --foreground
--sidebar-border oklch(1 0 0 / 10%) rgb(226 233 245 / 0.42) 对齐 --border
--sidebar-ring 继承 var(--ring) 显式声明

未改动但需要说明的令牌:--shadow-e1..e3、--shadow-pop、--animate-*、--font-sans、--font-mono、--radius-* 计算式全部沿用原文(tokens.css 中 @theme inline 段逐行照抄)。原因见 §8 R2:面板边界 ring-foreground/[0.06] 是硬编码 alpha、无法被令牌提升到 3:1,此时把阴影归零会让面板失去唯一可见边界。

字体与排版

字体栈:保持不动。 web/src/styles.css:29-33 现有 "Geist Variable","gg sans","Noto Sans SC","PingFang SC",ui-sans-serif,system-ui,"Segoe UI","Microsoft YaHei",Roboto,Helvetica,Arial,sans-serif,中文回退链完整(@fontsource-variable/geist 是本地字体资源,@import 在 styles.css:4)。参考的 sohne-var 无中文字形,不替换:拉丁与中文混排时如果引入第三套拉丁字体,Geist→sohne-var 的字宽差会让中英混排的基线更乱。若后续要贴参考气质,正确做法是替换 --font-sans 首项为 Inter Tight 并同时新增字体资源(超出本方案范围,不作为交付项)。

--font-mono 保持不动(ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,"Liberation Mono",monospace),用于任务编号、@提及回执、时间戳与代码块。

字号/行高/字重阶梯(目标值)

实测单视图存在 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26px 十档——其中 9.375 / 11.25 / 12.8 / 13.125 来自以 15px 为基准的 em 计算,不是设计决定。虽无 --text-* 令牌(styles.css 里不存在字号令牌),仍必须先把刻度定下来,作为改组件时的唯一参照:

角色 字号 行高 字重 用途(含实测落点) 令牌可达?
微型标签 11px 1.45(15.95px) 500 「共 14 个应用」计数、连接态、kbd 否,需改 text-[11px](如 agent-chat-panel.tsx:288、task-hall.tsx:1125)
次级/时间戳 12px 1.5(18px) 400/500 时间戳、成员数(实测 12px/500 #5c5e66)、列头计数 否,需改 text-xs 家族
密集列表 13px 1.5(19.5px) 400/500 频道预览、卡片元信息、作者名(实测 13px/400) 否
正文 14px 1.5(21px) 400 消息正文、表单标签、任务卡标题……全站唯一正文档,修掉实测「他人 15px / 自己 14px」混用 否,但 BubbleContent(ui/bubble.tsx:74)已是 text-sm,所以自己气泡不需要改,改的是绕过 BubbleContent 的正文容器(见 §8 R7)
强调正文 15px 1.5(22.5px) 500 频道标题、区块小标题(实测 16px/600 的频道名降一档) 否
卡片标题 16px 1.4(22.4px) 500 任务看板标题、弹窗区块标题(实测 16px/600) 否
中标题 20px 1.4(28px) 500 弹窗主标题(实测 18px 圆角弹窗内标题) 否
展示数字 26px 1.2(31.2px) 300 仅登录页主标题(实测 26px)与看板统计数字——参考的「whisper weight」唯一保留位 否

加减法:删掉 9 / 9.375 / 11.25 / 12.8 / 13.125px 四档(它们是 em 运算的副产品);上表 8 档必须严格使用,不允许出现第 9 档。

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

  1. 中文最小 12px(简报 §2.4),本方案不产生 <12px 的文字:--muted-foreground 用参考 Steel #50617a(白底 6.3:1、他人气泡底 5.6:1),因为 12px 汉字笔画密,需要比拉丁文更高的对比度余量(拉丁文 4.5:1 的边界值在汉字上会糊成一团)。
  2. 行高 ≥1.375:正文 14px/1.5 = 21px 满足;频道消息正文沿用 BubbleContent 的 leading-relaxed(1.625)。
  3. 数字对齐:任务计数(457)、消息计数(1554)、时间戳(14:23)、占比在参考里靠 tnum 对齐。font-feature-settings: "tnum" on 需要写进 @layer base(styles.css 的 body 规则,约 232 行)——这一行不在 :root/.dark 令牌段内,属途径①②③之外的改动,本方案不默认启用;短期替代方案是这些位置统一使用 --font-mono(等宽,天然对齐)。
  4. 中英混排基线:Geist 无中文字形,中文走 Noto Sans SC/PingFang SC,两套字体的 x-height 不同;因此禁止在同一行内混用 300 与 500 字重(中文会明显更粗),全站中文只用 400/500 两档,300 仅用于纯数字展示位。

关键界面改造

途径标记:① 令牌 / ② 官方 variant·size / ③ 容器 flex·grid·尺寸·间距·滚动。凡超出这三条的实现路径,一律在 §8 的 R 编号风险里单列。

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

# 现状(实测/代码) 改后 途径
1.1 会话侧栏 background #fcfcfc = 页面底色 --background #fcfcfc,零层级对比(简报 §3.3) --muted 变 #f0f5fa、--background 变 #ffffff:非 IM 侧栏(chrome.ts:40 sidebarAside = bg-muted)与主区(bg-background)立刻分成两级底色 ①
1.2 空间 rail 背景 transparent,其下是 #e1e8f2 → #e1e5f1 的蓝灰渐变,与面板边缘区分度约 1.1:1 --surface-rail 改 #e6e7fd、--workspace-background 改为「上靛蓝下纸白」的三段渐变,rail 带成为全站唯一的彩色区域(渐变只用在强调区块) ①
1.3 面板间隔 4px(app-shell.tsx:12281 md:mr-1 md:ml-1),缝里露出的渐变太浅,看不出「卡片」 容器间距 4px → 8px(列表列与主区各 8px;右侧成员栏同理),缝合后白卡片与靛色底带形成「账页浮在靛带上」的层级 ③
1.4 面板圆角 14px(md:rounded-xl,chrome.ts:46),与弹窗 18px、卡片 10px/8px 并存 --radius: 0.375rem → 面板 8.4px、卡片 6px、弹窗 10.8px:三档仍是阶梯,但同一 --radius 派生,实测最密的 10px×48/8px×37 收敛为 6px/4.8px ①
1.5 侧栏分隔线 bg-border/45(chrome.ts:12,实测对白底约 1.6:1)、轨道区块线 bg-foreground/22(chrome.ts:27) 令牌把 --border 提到 3.46:1 后,分隔线本体提到约 2.6:1;要拿满 3.46:1 需把 /45 去掉(chrome.ts:12 一行) ①(正文)/ 超出三途径(尾部,见 R3)
1.6 rail 图标按钮 71×48、选中态已有 bg-brand + shadow-[0_4px_12px_-3px_var(--brand)](chrome.ts:37) 保持尺寸(触屏命中区靠 tap-target 已合格);仅靠新 --brand #533afd 与靛底带产生对比;未读点/图标色走 --interactive ①
1.7 搜索框 30px 高、圆角 10px、底 rgba(235,238,239,0.75)(=--secondary 75% alpha) 高度对齐官方 Input 的 h-8(32px),底走 --secondary #edf2f8,圆角随 --radius 变 8.4px(rounded-xl);聚焦态 focus-within:border-brand/55 已是令牌驱动 ③(尺寸)+①

密度:侧栏行高维持 64px 不变(1440×900 下可见 11 行,够用);不压缩行高——高密度靠字号刻度收敛与对比度,不靠压行。 层级顺序(自外向内):靛色渐变带 #e6e7fd→#ffffff(rail 72px)→ 缝隙 → 白纸面板 #ffffff → 面板内非内容区 --muted #f0f5fa。

S2 频道消息流(message-list.tsx、message-bubble.tsx、bubble.tsx、message-composer.tsx)

# 现状(实测/代码) 改后 途径
2.1 他人气泡底 rgb(235,237,239)、自己气泡底 rgb(232,243,254)——两者都是浅色高亮度面,仅色相略有差别 他人 = --secondary #edf2f8(冷灰蓝),自己 = --message-self #e8e9ff(参考 Periwinkle Wash)——灰 vs 紫的色相分工;本人气泡还额外靠右对齐,共三重编码 ①
2.2 自己气泡正文色 #0d274a --message-self-foreground #182659(参考 Deep Violet),在 #e8e9ff 上 12.0:1 ①
2.3 同一列表两套字号:他人 15px/400、自己 14px/400(自身气泡走 BubbleContent 的 text-sm,ui/bubble.tsx:74) 全列表统一 14px/400(§5 正文档);作者 13px/400、时间 12px/500 色 --muted-foreground #50617a ②(气泡统一走官方 BubbleContent)+ 超出三途径的正文容器改动(R7)
2.4 气泡圆角 14px(rounded-xl = --radius × 1.4) 随 --radius 变 8.4px,与参考的 4px 家族同量级 ①
2.5 三种蓝并存:--brand #2563eb、硬编码 #006ce7(message-list.tsx)、--mention #3370ff(chat-mention.ts 硬编码 #3370FF) 令牌把 --mention 并回 #4726e8(与 --brand-ink 同值);两个硬编码点属代码改动(R1) ①(令牌侧)
2.6 回复引用块、置顶块 引用块用 --surface-chat-soft #f1f0ff(最浅紫面);置顶/选中用 --surface-chat-selected #ded9ff + text-brand-ink(chrome.ts:18 已是令牌驱动) ①
2.7 输入区外层只有上边框 rgb(220,222,225),textarea 628×33 无边框(message-composer.tsx:932 border-t border-border/70) 令牌把 --border 提到 3.46:1 后这条上边框可见度提升约 2.6×;更彻底的做法是给输入卡片补 1px 全边框 + 8.4px 圆角(需改 composer 容器 class,R7) ①(+R7)
2.8 悬停动作(点赞/回复/更多/已读状态「0 人已读,4 人未读」) 用官方 Button variant="ghost" size="icon-xs"(24×24)挂在行尾,hover 底走 --accent #e5edf5;已读状态用 --muted-foreground 文字,不再叠第二种灰 ②

状态与层级:消息流不引入任何新颜色——「日期分隔线 / 未读分隔线」用 --border 3.46:1 的 1px 规则线 + --muted-foreground 文字,与参考的 Section Divider 用法一致。

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

# 现状(实测/代码) 改后 途径
3.1 圆角 10px×48 与 8px×37 两套混用 --radius 统一派生:rounded-lg 6px、rounded-md 4.8px、rounded-xl 8.4px、rounded-2xl 10.8px;形成「卡片 6px、内嵌块 4.8px、浮层 10.8px」三级 ①
3.2 状态色走硬编码 Tailwind 调色板:border-rose-200 bg-rose-50 text-rose-700(task-hall.tsx:178)、border-amber-200 bg-amber-50 text-amber-800(:181)、rounded-full border border-rose-200 bg-rose-50 …(:1325) 状态改由官方徽标承载:已完成 = Badge variant="ghost";进行中 = Badge variant="default"(靛蓝实心);待处理 = Badge variant="secondary";待补充/待验收 = Badge variant="outline"(两者靠 lucide 图标 + 文字区分);已关闭 = Badge variant="ghost" + text-muted-foreground;逾期/风险 = Badge variant="destructive" ②
3.3 「AI 助手」chip、频道 chip 混在手写 span 里(:1164、:1269) 统一为 Badge variant="outline"(元信息)与 Badge variant="secondary"(归属),尺寸用 Badge 默认 h-5,不再出现 rounded-full px-1.5 py-0.5 text-[11px] 这类手写体 ②
3.4 顶部琥珀色提示条 rounded-2xl border-amber-200 bg-amber-50 px-4 py-3 text-xs(:373);空态/加载提示底走 bg-muted/70(:1008、:1124) 提示条改 --chart-3 只用于文字与图标、底用 --muted,避免大块琥珀面(参考:大色块只允许靛蓝在强调位);提示条圆角随 --radius 变 10.8px ①+②
3.5 弹窗内分隔线 border-slate-100(:705、:860、:1044,属 44 处 slate 硬编码) 目标为 --border(3.46:1);这是代码改动,令牌无法覆盖硬编码 class 超出三途径(R1)
3.6 任务卡密度:标题 14px/500 + chip 行 + 「查看任务」+ 负责人 保持信息项,仅收敛字号(12/13/14 三档)与间距:卡片内边距 12px、chip 行间距 6px、卡间距 12px;看板列头用 12px/500 + --muted-foreground,列计数用 --font-mono 对齐 ③(间距)+①
3.7 看板/大厅内容列宽(chrome.ts:118-119 workspaceCatalogPadding / workspaceCatalogGrid) 列数保持,容器 gap 8px → 12px、卡片网格 minmax(280px,1fr),让 1440 下 4 列、1024 下 3 列、<768 下 1 列(纯 grid 调整) ③

密度:任务大厅是 457 条任务的分页列表,行密度靠 h-5 徽标 + 12/13px 元信息维持;不压行高,靠底色与规则线分区。

S7 登录页(routes/login.tsx、components/auth/auth-shell.tsx、login-glass-shell.tsx、login-code-form.tsx)

# 现状(实测/代码) 改后 途径
7.1 玻璃拟态外壳:login-glass-bg 径向渐变 + 620px/660px/500px 三个光晕 + 44px 网格 + blur(18px) 毛玻璃卡片(styles.css:1091-1176),页脚状态条靠 --brand 发光 所有颜色表达式都已经是 color-mix(… var(--brand) …) / var(--background) / var(--muted) 形式,换令牌即可把整套光晕从「飞书蓝」变成「靛蓝」,无需改一行组件代码 ①
7.2 卡片 max-w-[430px] rounded-[32px] p-7(login-glass-shell.tsx:86,32px 圆角为字面量) 圆角收到 --radius-3xl(13.2px)量级;宽度 430px 保持(实测主按钮 356px、卡片内容区合理) ③(尺寸类改动)
7.3 主按钮 356×52、login-primary-btn 用 linear-gradient(135deg, var(--brand), var(--brand-ink)) + 光辉 + shimmer 流光(styles.css:1247-1279) 渐变两端的令牌换成 #533afd → #4726e8,梯度自然变窄、从「霓虹蓝」变「靛蓝墨」;文案「登录 WanChat」14px/500 保持 ①
7.4 通道切换块 173×42,选中态底 --background #fcfcfc + 品牌蓝文字(login-code-form.tsx:43 data-active:text-brand) 选中态文字色随 --brand 变为 #533afd(白底 6.19:1);滑块底色 var(--card) 保持白——与「纸白卡片」一致 ①
7.5 输入框/验证码格用 color-mix(… var(--foreground) 10% …) 描边(styles.css:1204、:1236) 这条描边换算后仍约 1.1:1,是登录页唯一的低对比边界;修复需要改 styles.css 中非令牌段(:1204/:1236 两行 → 改用 var(--input)),属途径外,列 R9 超出三途径(R9)
7.6 页脚 11px、WanChat Enterprise 保持 11px(§5 微型标签档);.login-glass-card 的 border-top 用 --border 后自 1.35:1 升到 3.46:1 ①

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

# 现状(实测/代码) 改后 途径
4.1 AI 助手空间是全站最密集视图:一次渲染内 12.8px×2765、12px×2381、12px×1994、14px×1724 四个档位;圆角 8px×1591、10px×844(简报 §3.3) 字号收敛到 12/13/14 三档(§5);圆角随 --radius 变成 4.8px/6px/8.4px 三级。注意:12.8px 这类值来自 em 计算或字面量,令牌无法直接改(见 R5) ①(圆角)+超出三途径(字号,R5)
4.2 代码/统计块 my-1.5 rounded-lg bg-muted text-[13px](agent-chat-panel.tsx:186) --muted #f0f5fa 让「AI 输出块」与「用户气泡」明确分层;数字用 --font-mono(等宽,天然对齐任务编号/耗时) ①
4.3 结果卡片/来源引用(:281 rounded-xl px-3 py-2.5,agent-citation-badge.tsx) 来源徽标统一 Badge variant="outline";「正在生成」等待态用官方 Skeleton(ui/skeleton.tsx 已装),不再用 --animate-breathe 手写呼吸灯 ②
4.4 流式正文 15px(:409 text-sm leading-relaxed + 外层 text-[15px]) 统一到 §5 正文档 14px/1.5 超出三途径(R5),但方向明确
4.5 AI 面板的容器宽度、结果区滚动 结果区与输入区之间用 Separator(官方)代替 border-t;面板内 gap 8→12px,让「回答 / 来源 / 操作」三段可扫 ②+③

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

# 现状(实测/代码) 改后 途径
5.1 弹窗 704×512,圆角 18px(space-manage-dialog.tsx:183 rounded-2xl = --radius × 1.8),底 #ffffff 圆角随 --radius 变 10.8px;底色 --popover #ffffff 保持;shadow-pop 沿用(浮层需要唯一阴影) ①
5.2 左侧导航项 135×36 圆角 8px,选中态 --brand-soft + --brand-ink(已是纯令牌驱动) 选中底混合后为 #eae7ff、文字 #4726e8(14.37:1);圆角随 --radius-md 变 4.8px ①
5.3 输入框 488×32 圆角 10px(ui/input.tsx:11 h-8 rounded-lg border-input bg-transparent) 令牌把 --input 提到 4.19:1 后,输入框边界第一次真正可见(当前 #dcdee1 仅 1.35:1);圆角 6px ①
5.4 表单标签 14px、危险项前景 --destructive #da373c 标签落到 §5 正文档 14px;--destructive #c0343b 5.53:1(危险按钮底色 destructive/10 上 4.84:1) ①
5.5 弹窗内 rounded-2xl border border-brand/25 bg-brand/[0.04] 强调块(space-manage-dialog.tsx:1873)、bg-brand-soft text-brand 图标块(:1859) 全部随 --brand 变靛蓝;强调块底改用 --surface-chat-soft #f1f0ff,避免 brand/4% 这种手写 alpha 与其它紫面不一致 ①+②
5.6 弹窗两栏:左导航 + 右表单 左导航 w-[135px] → 160px(中文权限名「成员管理」不再折行)、内容区间距 8→16px、表单行间距 12→16px ③

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

# 现状(实测/代码) 改后 途径
8.1 应用/助手图标当前是 emoji(简报 §3.3:视觉一致性的明显缺口;app-center.tsx:529 rounded-2xl text-4xl) emoji 内容本身不能靠令牌改;但承载它的底板可由 bg-muted 改为 --surface-chat-soft,圆角随 --radius 从 10.8px 变 10.8px→按 rounded-2xl 计算实为 10.8px(同 18px 档)。正式修法:图标位换成官方 Avatar + AvatarFallback(首字+底色)或 lucide 线性图标,属组件替换 ①(底板)/②(Avatar 替换,需改代码)
8.2 分类筛选 8 项 + 「共 14 个应用」计数 分类条用官方 Tabs variant="line"(ui/tabs.tsx:33),比 rounded-lg 药丸条更贴账本的规则线语言;计数用 11px + --font-mono ②
8.3 卡片 rounded-xl border-0 bg-card p-5 shadow-[0_0_18px_-2px] shadow-foreground/10(:1189) 圆角随 --radius 变 8.4px;阴影保留(卡片需要有边界),但 bg-card 在白底上无对比,靠 3.46:1 的 --border 规则线或 --muted 底分区 ①
8.4 徽标「运行中 / 开发中」、元信息 Agent · 第三方 · chat 运行中 = Badge variant="secondary"、开发中 = Badge variant="outline";元信息 12px --muted-foreground ②+①
8.5 卡片网格与顶部品牌块(:864 bg-brand-soft text-brand) 网格 gap 改 16px、卡片 minmax(280px,1fr);品牌块随 --brand 变靛蓝 ③+①

S6 语音频道/通话(rtc-group-call-ui.tsx)——依据为代码与数据库,不是截图

本栈 TRTC_ENABLED=false,界面一个语音元素都不渲染(简报 §3.3:DOM 内 aria-label 匹配「语音/通话/加入」命中 0、正文不含「语音」,/api/v1/rtc/* 返回 RTC_DISABLED;而库内 wanman3_rtc_voice_channels 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行)。因此本节只写代码可推导的令牌用法,不作任何截图声明:


深浅色与对比度

对比度按 WCAG 2.x 相对亮度公式计算((L1+0.05)/(L2+0.05)),全部为 sRGB 直接计算值,非估计。深色的 --border/--input 是 alpha 表达式,表中给出的是混合到对应底色后的等效值。

浅色(:root)

组合 值 对比度 要求 结论
正文 foreground / background #061b31 / #ffffff 17.37:1 ≥4.5 达标
正文 foreground / card #061b31 / #ffffff 17.37:1 ≥4.5 达标
次级 muted-foreground / background #50617a / #ffffff 6.30:1 ≥4.5 达标
次级 muted-foreground / muted(侧栏画布) #50617a / #f0f5fa 5.75:1 ≥4.5 达标
次级 muted-foreground / 他人气泡 secondary #50617a / #edf2f8 5.60:1 ≥4.5 达标
他人气泡 secondary-foreground / secondary #061b31 / #edf2f8 15.43:1 ≥4.5 达标
按钮 brand-foreground / brand #ffffff / #533afd 6.19:1 ≥4.5 达标
选中 brand-ink / surface-chat-selected #4726e8 / #ded9ff 5.71:1 ≥4.5 达标
自己气泡 message-self-foreground / message-self #182659 / #e8e9ff 12.00:1 ≥4.5 达标
@提及 mention / message-self #4726e8 / #e8e9ff 6.47:1 ≥4.5 达标
@提及 mention / background #4726e8 / #ffffff 7.75:1 ≥4.5 达标
危险 destructive / background #c0343b / #ffffff 5.53:1 ≥4.5 达标(当前 #da373c 仅 4.27:1,不达标)
危险 destructive / destructive/10 底 #c0343b / #f9eded 4.84:1 ≥4.5 达标
状态·已完成 chart-1 / background #0f6f57 / #ffffff 6.12:1 ≥4.5 达标
状态·进行中 chart-2(=brand) / background #533afd / #ffffff 6.19:1 ≥4.5 达标
状态·待处理 chart-3 / background #8a5300 / #ffffff 6.33:1 ≥4.5 达标
状态·风险 chart-4 / background #b3262e / #ffffff 6.49:1 ≥4.5 达标
状态·已关闭 chart-5 / background #50617a / #ffffff 6.30:1 ≥4.5 达标
控件边界 input / card #6e7d93 / #ffffff 4.19:1 ≥3 达标
控件边界 input / muted #6e7d93 / #f0f5fa 3.82:1 ≥3 达标
结构规则 border / card #7d8b9f / #ffffff 3.46:1 ≥3 达标(当前 #dcdee1 仅 1.35:1)
结构规则 border / muted #7d8b9f / #f0f5fa 3.16:1 ≥3 达标
焦点 ring(=brand) / card #533afd / #ffffff 6.19:1 ≥3 达标(焦点态另叠 ring/50 3px 外环,外环本身约 2.3:1,但同一状态下边框已变 6.19:1,整体满足)
rail 图标 interactive / surface-rail 带 #50617a / #e6e7fd 5.17:1 ≥3 达标
频道图标 channel-icon / background #64748d / #ffffff 4.75:1 ≥3 达标
品牌软底叠加后的文字 #061b31 / #eae7ff(brand-soft over white) 14.37:1 ≥4.5 达标

层级差(非文字,仅用于分区):#ffffff → #f0f5fa → #edf2f8 → #e5edf5 四级底色的相邻亮度比为 1.10 / 1.03 / 1.05;它们不承担「识别边界」职责(那是 --border 的 3.46:1),只承担「区域归属」。选中底 #ded9ff 对白底 1.36:1、自己气泡 #e8e9ff 对白底 1.20:1——选中/本人消息靠颜色而非亮度表达,这与深度依赖明度差的旧方案不同,但配合 text-brand-ink(在选中底上 5.71:1)与右对齐,识别路径完整。

深色(.dark)

组合 值 对比度 要求 结论
正文 foreground / background #e6edf7 / #0a1522 15.59:1 ≥4.5 达标
正文 foreground / card #e6edf7 / #111f30 14.12:1 ≥4.5 达标
次级 muted-foreground / background #9fb0c9 / #0a1522 8.33:1 ≥4.5 达标
次级 muted-foreground / card #9fb0c9 / #111f30 7.55:1 ≥4.5 达标
次级 muted-foreground / muted #9fb0c9 / #152335 7.20:1 ≥4.5 达标
他人气泡 secondary-foreground / secondary #dbe5f3 / #1b2c42 11.12:1 ≥4.5 达标
按钮 brand-foreground / brand #0c1226 / #8b7bff 5.64:1 ≥4.5 达标
选中 brand-ink / surface-chat-selected #b3a6ff / #2b2a63 6.08:1 ≥4.5 达标
自己气泡 message-self-foreground / message-self #e9ecff / #211d52 13.15:1 ≥4.5 达标
@提及 mention / message-self #b3a6ff / #211d52 7.21:1 ≥4.5 达标
@提及 mention / background #b3a6ff / #0a1522 8.59:1 ≥4.5 达标
危险 destructive / background #ff8a8f / #0a1522 8.12:1 ≥4.5 达标
危险 destructive / card #ff8a8f / #111f30 7.35:1 ≥4.5 达标
状态·已完成 chart-1 / background #4fd6a5 / #0a1522 10.05:1 ≥4.5 达标
状态·进行中 chart-2(=brand) / background #8b7bff / #0a1522 5.58:1 ≥4.5 达标
状态·待处理 chart-3 / background #f0b25c / #0a1522 9.82:1 ≥4.5 达标
状态·风险 chart-4 / background #ff8a8f / #0a1522 8.12:1 ≥4.5 达标
状态·已关闭 chart-5 / background #9fb0c9 / #0a1522 8.33:1 ≥4.5 达标
控件边界 input / background 等效 #838c98 / #0a1522 5.40:1 ≥3 达标
控件边界 input / card 等效 #86909e / #111f30 5.15:1 ≥3 达标
结构规则 border / background 等效 #656e7b / #0a1522 3.56:1 ≥3 达标(当前 oklch(1 0 0/10%) 约 1.5:1)
结构规则 border / card 等效 #697483 / #111f30 3.51:1 ≥3 达标
焦点 ring(=brand) / card #8b7bff / #111f30 5.05:1 ≥3 达标
rail 图标 interactive / 暗紫带(color-mix 22% 实测约 #262b53) #9fb0c9 / #262b53 6.42:1 ≥3 达标
频道图标 channel-icon / background #8b9ab2 / #0a1522 6.44:1 ≥3 达标

深色递进方向:#0a1522(底)→ #111f30(卡片)→ #152335(画布/muted)→ #1e3048(hover)→ #16263a(浮层)——越「靠前」越亮,与浅色的「越靠前越白」同构。

两套共用一个强调色族:浅色 #533afd / 深色 #8b7bff 同为 oklch 色相 ≈257°,因此同一套 --brand-soft/--brand-ink 派生写法(浅色用固定 hex,深色用 rgb(139 123 255 / 0.22))在两端都成立。


shadcn 兼容性

web/components.json:style: base-nova、iconLibrary: lucide、baseColor: neutral、css: src/styles.css。web/src/components/ui/ 下已有 38 个官方组件 + chat/ 子目录(bubble.tsx、message.tsx、empty.tsx、trace.tsx、input-group.tsx)。本方案不新增组件文件、不新增 variant、不新增 size,只用官方能力。

用到的组件与官方 variant/size

组件 用到 依据(源码)
Button variant: default(主操作·靛蓝实心)/outline(次级·边界靠 --border)/secondary(三级)/ghost(行内动作)/destructive(删除)/link;size: xs(24px)/sm(28px)/default(32px)/lg/icon-sm/icon-xs ui/button.tsx variants/sizes 定义;实测频道列表主按钮 104×32 = default、20 个「编辑」按钮 67×24 = xs,不引入自定义高度
Badge default(进行中)/secondary(待处理)/outline(待补充·待验收·元信息)/ghost(已完成·已关闭)/destructive(逾期·风险);默认 h-5(20px) ui/badge.tsx variants
Input / Textarea 默认 h-8 + border-input(本方案把 --input 提到 4.19:1 后该边界才第一次可见) ui/input.tsx:11、ui/textarea.tsx
Tabs variant="line"(应用中心分类、设置页签)/ 默认(bg-muted 分段控件,如登录页通道切换) ui/tabs.tsx:32-33
Avatar + AvatarFallback size: sm/default/lg;底色 bg-muted、after:border-border(换 --border 后头像环第一次可见) ui/avatar.tsx:19
Separator 面板/区块内的规则线(替代手写 border-t) ui/separator.tsx
Card 应用卡/任务卡容器(rounded-xl bg-card ring-1 ring-foreground/10,见 R2) ui/card.tsx
Dialog/AlertDialog/Sheet 管理设置(R2 同问题) ui/dialog.tsx:37
Skeleton AI 助手等待态、列表加载态(替代 --animate-breathe 手写呼吸灯) ui/skeleton.tsx
ScrollArea 频道列表、消息流、任务大厅三个滚动区统一(保留现有滚动行为,不改虚拟化) ui/scroll-area.tsx
Tooltip/DropdownMenu/ContextMenu/Command/Popover 不改造,随令牌自动变色 —
chat/Bubble + chat/BubbleContent 消息气泡(自己 = variant="default" 并把 --primary/--primary-foreground 内联覆盖为 --message-self/--message-self-foreground;他人 = variant="secondary") components/app/message-bubble.tsx:20-22、ui/bubble.tsx:74

兼容性保证

不合规 / 超出三途径的显式风险清单

ID 事实(可复现) 影响 归属
R1 253 处 Tailwind 原始调色板硬编码:amber 69、rose 68、slate 44、emerald 42、teal 12、blue 7、red 3、violet 2、purple 2、neutral 2、sky 1、cyan 1(44 个非测试文件)。例:task-hall.tsx:178/181/373/705/860/1008/1044/1325/1363、app-center.tsx:582/961/1189 这些颜色不随主题翻转,深色下会出现亮琥珀/亮玫瑰块 令牌路径无法覆盖;需逐个替换为 --chart-*/--border/--muted 或 Badge variant
R2 面板/卡片/弹窗边界是硬编码 alpha:chrome.ts:46 md:ring-1 md:ring-foreground/[0.06](≈1.1:1)、ui/card.tsx ring-foreground/10、ui/dialog.tsx:37 ring-foreground/10 这三类浮层/面板的边界达不到 3:1;本方案只能靠底色递进与 shadow-e2 补偿,不能靠 --border 需把 ring-foreground/10 改成 ring-border 才能达标(3 处代码)
R3 其它硬编码 alpha:chrome.ts:12 panelDivider = bg-border/45(≈2.6:1 封顶)、chrome.ts:15 hoverRow = hover:bg-foreground/[0.04]、chrome.ts:24 border-r border-border/55、chrome.ts:27 railSep = bg-foreground/22 分隔线永远拿不满 --border 的 3.46:1 需去掉 /45、/55 两处斜杠后缀
R4 圆角字面量 3 处:create-task-dialog.tsx:154(rounded-[14px])、:982、:1203(rounded-[10px]) 这 3 处不随 --radius 变化,与全站 6px 并存 需替换为 rounded-xl/rounded-lg
R5 字号硬编码:agent-chat-panel.tsx:141 text-[15px]、:186 text-[13px]、:288 text-[11px],以及 styles.css 内 font-size: 12px×12、13px×7、14px×2 等 实测单视图 10 档字号(9/9.375/11/11.25/12/12.8/13.125/14/15/26px)无法靠令牌收敛 需按 §5 刻度逐处替换
R6 深色主题生产不可达:全仓无任何代码添加 .dark、localStorage 无主题键、<html> class 恒为空、color-scheme: normal;强制注入 .dark 后仍有 55 处前景 rgb(6,6,7)、27 处 rgb(92,94,102)、6 处边框 rgb(220,222,225)、3 处浅色头像底 本方案的深色值无法在未补开关前目视验收;--surface-rail 的浅色带 BUG 已在本方案修掉,但需要开关才能验证 需一次性补主题开关(<html class="dark"> + color-scheme 同步);这也是 R1 硬编码色会暴露的前提
R7 message-composer.tsx:932 输入区仅保留上边框;消息正文字号 15px/14px 混用(BubbleContent 已是 text-sm,差异来自绕过它的外层容器) §5 的正文档统一需要改组件容器 class 需改 message-composer.tsx 与正文容器
R8 S6 语音频道本栈不可见:TRTC_ENABLED=false;DOM 内 aria-label 匹配「语音|通话|加入」命中 0;/api/v1/rtc/* 返回 RTC_DISABLED;库内 wanman3_rtc_voice_channels 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行 该面只能靠代码依据,不能目视验收 需 TRTC_ENABLED=true 的预发环境复核
R9 登录页输入/OTP 描边为 color-mix(… var(--foreground) 10% …)(styles.css:1204、:1236),换算 ≈1.1:1 登录表单边界不达标;且这两行在令牌段之外 需改 styles.css 非令牌段(替换为 var(--input))
R10 应用/助手图标为 emoji(app-center.tsx:529 等),size-16 rounded-2xl text-4xl 令牌无法改变图标表现形态(跨平台字形不一致) 需替换为 Avatar+AvatarFallback 或 lucide 图标

实施成本

本方案的交付物是设计与令牌,不是代码改动;下表的「工作项」是落地时的工作量估计,用于横向对比选型。

工作项 落点(文件:行) 估计工时 风险
A. 替换令牌三段 web/src/styles.css(@theme inline 27–106、:root 108–143、.dark 145–196) 2h(含逐变量核对) 低:grep -rn "var(--" 无遗漏即可;--radius 全局波及(见 §10)
B. 补深色主题开关 <html> 注入 .dark + color-scheme 同步(无现成落点,需新增) 4h 中:开关一开,R1 的 253 处硬编码色与 R6 的 55 处 rgb(6,6,7) 全部暴露
C. 修硬编码边界与分隔线 chrome.ts:12(去 /45)、:24(去 /55) 1h 低
D. 状态徽标改官方 Badge variant task-hall.tsx(:178/181/373/901/902/1058/1135/1269/1271/1272/1325)、app-center.tsx:582/961、agent-chat-panel.tsx 状态芯片 8h 中:需与产品确认「待补充 vs 待验收」的图标区分
E. 字号刻度收敛 agent-chat-panel.tsx:141/186/288/409、message-composer.tsx、task-hall.tsx 元信息行、task-hall.tsx:1008/1124/1363 12h 中:视觉回归面广,建议按面分批
F. 容器布局(缝隙 4→8px、面板圆角、看板网格、弹窗左栏 135→160px) app-shell.tsx:12281、chrome.ts:46/118/119、space-manage-dialog.tsx 6h 低
G. 登录页令牌外套 + OTP 描边修复 styles.css:1204/1236(改 var(--input))、login-glass-shell.tsx:86(圆角) 3h 低
H. 图标从 emoji 换 Avatar/lucide app-center.tsx:529 区域 6h 中:需图标选型与产品确认
I. 视觉回归与对比度复核 见下 8h —
合计 ≈50h(6.5 人日)

验证方式(可复现,不需要截图)

  1. 令牌一致性:git diff --stat web/src/styles.css 只应出现令牌段;grep -c "^ --" web/src/styles.css 与基线相等(不新增/不删除变量名,包括 --chart-* 只改值)。
  2. 令牌可达性:grep -rn "ring-foreground/\|border-border/\|bg-foreground/\[" web/src 应只剩 R2/R3 列出的行——用来确认「哪些边界永远拿不到 3:1」。
  3. 对比度断言(Node/jsdom 中跑,或在浏览器 devtools 粘贴):对 document.documentElement 取 getComputedStyle,断言 --foreground/--background、--muted-foreground/--muted、--border/--card、--input/--card、--message-self-foreground/--message-self 的对比度分别 ≥4.5/4.5/3/3/4.5;深色在 <html class="dark"> 下重跑同一组断言(数值即 §7 两张表)。
  4. 硬编码残留计数(用于量化 R1/R5):grep -roE "\b(amber|rose|slate|emerald|teal|blue|red|violet|purple|neutral|sky|cyan)-[0-9]{2,3}\b" web/src --include=*.tsx --include=*.ts | grep -v test | wc -l 期望从 253 降到 <30;grep -rn "text-\[1[0-9]" web/src/components 期望从 4 个文件降到 0。
  5. 回归重点:频道列表行高(未读点不变形)、任务大厅分页(徽标换 Badge 后行高不变)、登录页(渐变与流光在 --brand 变值后仍连续)、深色(开关打开后无 rgb(6,6,7) 白底黑字残留)。

取舍

取舍点 选择 放弃的 理由与代价
圆角 6px vs 参考 4px --radius: 0.375rem 参考的 4px 家族 4px 在 12px 汉字旁过锐;6px 牵动 radius-2xl 10.8px(弹窗),比当前 18px 收敛 40%。代价:与参考书里的数字不同,横向对比时会被判为「偏离参考值」
边界 3:1 vs 参考 1.18:1 --border #7d8b9f(3.46:1) 参考 #e5edf5 细线 参考线在 1440 宽白底上只是「分割」,在 /app 里要承担「控件可点击边界」的语义(WCAG 1.4.11 硬要求);且现行 #dcdee1 1.35:1 已被实测判定为零层级。代价:界面比 Stripe 官网「重」一档,截图里线更明显
状态用色彩阶梯 vs 单强调色纪律 --chart-1..5 承担 5 档任务状态 参考「不引入额外强调色」 任务六态必须可区分且需过 4.5:1;--chart-* 全仓零消费者,是唯一可安全占用的槽位,且它本身就是 shadcn 的状态色槽。代价:出现绿/琥珀/红三个色相,与参考的单色纪律有张力;缓解手段是把状态同时用 Badge variant + 图标 + 文字三重编码,颜色只回答「是否需要动作」
保留阴影 vs 零阴影 保留 --shadow-e1..e4/shadow-pop/面板 shadow-e2 参考的「完全无阴影」 面板边界 ring-foreground/[0.06] 是硬编码 alpha(R2),阴影是当前唯一的可见浮起信号;同时去掉会「面板消失」。前置条件:先把 chrome.ts:46、ui/card.tsx、ui/dialog.tsx:37 的 ring-foreground/* 改成 ring-border,之后 --shadow-e1/e2 可归零
字体栈不动 vs 引入参考的 sohne-var/Inter 沿用 Geist + 中文回退链 参考的字体气质 中英混排的字宽/基线风险大于收益;中文 Light 在 12px 下不可读,字重只能 400/500。代价:方案的「气质」更多来自颜色与密度,而非字体,横向对比时字体项会成为弱项
不新增组件、不加自定义 variant 全部走 §6 的 ①③ + Badge/Tabs/Avatar/Skeleton 等官方 ② 设计自由度(例如自绘「状态药丸」) 保证 shadcn 上游可覆盖、后续 npx shadcn@latest add 不冲突。代价:个别表达(如「待补充 vs 待验收」)只能靠图标 + 文字区分,无法靠专属样式