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 条,引原文要点)
- 单一强调色纪律:“Use
#533afdexclusively 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 意图列),不进入装饰位。 - 零阴影、靠底色递进造层级:“Stripe avoids shadows entirely. Depth and hierarchy are created through background tint progression (white →
#f8fafd→#e5edf5→#e8e9ff→#533afd)”。 → 迁移:把当前「面板靠shadow-e2立起来」改成「底色四级递进 + 规则线」,--card/--muted/--secondary/--accent直接落在这条递进上。 - 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 家族同量级。 - 1px 规则线是主要结构元素:“A 1px solid line in
#e5edf5spanning 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)。 - 排版节制 + 表格数字:“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)。
因产品形态必须舍弃的项(明确列出)
- 营销页结构:hero 大图、
display56px、1320px 居中大留白、96px 段间距、客户 logo 竖排 rail、西班牙语文案——/app是 1440×900 下72px rail + 256px 侧栏 + 860px 频道区的满屏工具,没有滚动叙事。 - 「无阴影」的绝对化:实测面板边界靠
md:ring-1 md:ring-foreground/[0.06](web/src/components/app/chrome.ts:46)只有约 1.1:1,若同时把shadow-e2归零,面板会「消失」。本方案保留阴影但收敛(见 §8 R2),把分层交给底色递进与靛色 rail 带。 - 单一字体家族:
sohne-var无中文字形,保留现有"Geist Variable","gg sans","Noto Sans SC","PingFang SC",…回退链。 - 参考的 ghost 按钮
#b9b9f9描边:shadcn 官方 Button 无「自定义描边色」能力,改用官方variant="outline"(描边取--border)与variant="ghost"。
适配判断
为什么这套语言适合「任务 + 频道消息」双核心
- 账本 = 可审计。产品核心是「发布 → 接单 → 履约 → 验收 → 存档」,本质是带责任人的流水账。参考的 “the whole interface behaves like a ledger or terminal: dense information, crisp rules” 与这个任务的审计语义同构:每行任务卡是一条账目,
待补充/待处理/进行中/待验收/已完成/已关闭(简报 §3.3 真实状态词)就是账目状态。 - 单一强调色 = 状态可读。实测单视图内同时出现 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)。
- 底色递进替代描边 = 高密度下的可扫读性。1554 条消息、457 个任务的长列表里,逐行读 1px 灰线是很累的;参考的做法是把「这属于哪个区域」交给底色,把「这条数据在哪」交给对齐与留白。首屏 4 个区域(rail / 会话列 / 频道区 / 成员栏)用 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 档。
中文长文本与数字的注意点
- 中文最小 12px(简报 §2.4),本方案不产生 <12px 的文字:
--muted-foreground用参考 Steel#50617a(白底 6.3:1、他人气泡底 5.6:1),因为 12px 汉字笔画密,需要比拉丁文更高的对比度余量(拉丁文 4.5:1 的边界值在汉字上会糊成一团)。 - 行高 ≥1.375:正文 14px/1.5 = 21px 满足;频道消息正文沿用
BubbleContent的leading-relaxed(1.625)。 - 数字对齐:任务计数(457)、消息计数(1554)、时间戳(
14:23)、占比在参考里靠tnum对齐。font-feature-settings: "tnum" on需要写进@layer base(styles.css的body规则,约 232 行)——这一行不在:root/.dark令牌段内,属途径①②③之外的改动,本方案不默认启用;短期替代方案是这些位置统一使用--font-mono(等宽,天然对齐)。 - 中英混排基线: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 行)。因此本节只写代码可推导的令牌用法,不作任何截图声明:
- 通话面板的成员状态(麦克风开/关、通话中/已断开)在
rtc-mic-status.tsx与rtc-group-call-ui.tsx中按语义色渲染;接 S3 的状态编码约定:已连接/进行中用--chart-1/--chart-2,连接中/重连中用--chart-3,已断开/连接失败用--destructive,已关闭用--chart-5(依据:web/src/components/app/rtc-mic-status.tsx与rtc-group-call-ui.tsx的 tone 分支,与简报 §3.3 的连接态词表已连接 / 连接中 / 重连中 / 已断开 / 连接失败对齐)。 - 面板底/边框/圆角与 S5 弹窗同源(同一套
--popover/--border/--radius)。 - 风险:该面无法在 Test 环境目视验收,方案落地后必须用
GET /api/v1/rtc/*与TRTC_ENABLED=true的预发环境复核(R8)。
深浅色与对比度
对比度按 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 |
兼容性保证
- 所有改动落在
--radius与语义令牌取值上,官方组件的 class 表达式(rounded-lg、bg-card、border-input…)一行都不用改,因此未来shadcn组件更新可以原样覆盖。 - 唯一涉及组件内部写法的两处(
ui/bubble.tsx的气泡圆角已是rounded-xl、ui/input.tsx的h-8)不改,符合「不偏离官方」的要求。 --radius: 0.375rem会让所有官方组件的派生圆角同时变化(--radius-sm 3.6px→--radius-4xl 15.6px),这是唯一一处「全局波及」的改动,故在 §10 取舍中单独说明。- 深色下的实心危险按钮:官方
Button variant="destructive"是bg-destructive text-white,在深色--destructive #ff8a8f上白字仅 2.1:1(官方深色oklch(0.704 0.191 22.216)同样偏低)。本方案的处理是:深色下删除类操作改用variant="outline"+ 危险色文字/描边(8.12:1),颜色仍由--destructive令牌驱动,不新增 variant。浅色保持实心destructive(白字 5.53:1)。 preview.html的读法:左栏浅色、右栏深色(同一套 class,仅换变量);顶部「整体切换浅/深」可把两栏同时翻转。右栏用脚本克隆左栏的控件/骨架样例,因此 JS 被禁用时右栏仍会给出「关键令牌对照表」(全部数值见 §7)。
不合规 / 超出三途径的显式风险清单
| 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 人日) |
验证方式(可复现,不需要截图)
- 令牌一致性:
git diff --stat web/src/styles.css只应出现令牌段;grep -c "^ --" web/src/styles.css与基线相等(不新增/不删除变量名,包括--chart-*只改值)。 - 令牌可达性:
grep -rn "ring-foreground/\|border-border/\|bg-foreground/\[" web/src应只剩 R2/R3 列出的行——用来确认「哪些边界永远拿不到 3:1」。 - 对比度断言(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 两张表)。 - 硬编码残留计数(用于量化 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。 - 回归重点:频道列表行高(未读点不变形)、任务大厅分页(徽标换
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 待验收」)只能靠图标 + 文字区分,无法靠专属样式 |