暖纸工作台

slug: notion | 参考:Notion 官网 DESIGN.md(theme: light / “warm paper notebook under afternoon sun”) 工作树:/Users/waw/Documents/code/wanman-worktree-design-notion(分支 codex/design-notion,基线 test@3d35969f) 交付物:docs/design-proposals/notion/{proposal.md, tokens.css, preview.html}

方案名与主张

中文方案名:暖纸工作台

一句话主张:给「480 人 / 148 个频道 / 457 个任务」的高密度协作台换一张暖纸底——#f6f5f4 画布 + #ffffff 贴纸卡 + 1px 发丝边界替代阴影,全站只保留一种彩色承诺(单一品牌蓝 #006bce),把颜色通道整个让给任务状态。

适用基调:浅色优先、深色对等。 参考源本身是 light-only,本方案把它的「暖纸 + 白卡」明暗关系完整迁移到浅色;深色不做简单反转,而是做同一色相的暖炭(#1e1d1b / #262522),使「暖」这一材质属性两套都在。

参考提炼

可迁移规则(5 条,均引用其原文要点):

  1. 表面栈不可倒置:“Use #f6f5f4 as the page canvas and #ffffff for card surfaces — never invert this hierarchy by putting a warm card on a white page”。→ 迁移为 --background:#f6f5f4 / --card:#ffffff,并补上 rail、sidebar 两阶,形成四级栈。
  2. 用发丝边界代替阴影:“Use 1px solid borders at rgba(0,0,0,0.08) instead of shadows to separate cards from the canvas”。→ --border 从实色 #dcdee1 改为暖墨 12% alpha(画布上合成 #dbdad9,1.282:1);内容卡一律靠边界+底色分层。
  3. 单一彩色承诺:“Reserve #0075de for the single primary action per screen; all secondary actions should use ghost (#e6f3fe bg) or text styles”、“Do not use multiple chromatic button colors in the same view”。→ 品牌蓝是唯一填充色,其余动作用 outline / secondary / ghost / link 官方 variant;--brand-soft 直接取参考的 Sky Tint #e6f3fe。
  4. 用一个墨色 + 透明度梯度做层级:“Do not use #000000 at 100% for all text — build hierarchy through alpha (100%, 95%, 60%, 40%)”,并有 Graphite #615d59 一档「带暖调的正文灰」。→ --foreground:#191817(暖墨)、--muted-foreground:#615d59(Graphite 原值),两档覆盖 90% 文本层级。
  5. 平涂、禁止渐变:“Do not use gradients — the system is strictly flat fills; visual depth comes from the warm-to-white surface contrast”。→ 把 --workspace-background 的 linear-gradient(...) 与深色的 radial-gradient(...)、header 的 linear-gradient(...) 全部改平涂。
  6. 圆角两档制:“Use 12px border-radius for cards and 8px for buttons; reserve 9999px for pills”。→ --radius 从 0.625rem 改为 0.5rem,使 Button/Input = rounded-lg = 8px、气泡 = rounded-xl = 11.2px≈12px。

适配判断

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

  1. 降眩光:一线人员「长时段驻留」(简报 §1)。纯白 #ffffff 画布在 1440×900 满屏时眩光明显;#f6f5f4 把画布亮度从 1.000 降到 0.914(相对亮度),正文对比从 17.7:1 降到 16.28:1,仍远高于 4.5:1,但主观疲劳显著降低。这是「任务清单盯一天」而不是「看一次落地页」的场景,暖底收益被放大。
  2. 密度不靠压缩、靠边界:消息流 + 任务卡在同一个屏里并存。Notion 的「白卡贴在暖底上、1px 发丝分隔、零阴影」正好给出不增加视觉噪声的分层手段——现有 --shadow-e2/e3 在 24px 行距的列表里会互相叠加成灰雾。
  3. 颜色即状态:「待补充 / 待处理 / 进行中 / 待验收 / 已完成 / 已关闭」6 个状态需要一眼分辨。把唯一的彩色承诺(品牌蓝)留给「进行中」,危险红只给风险/逾期,其余状态走灰阶 Badge variant——色彩信息量变成 2 bit,扫视成本最低。现状的 253 处 Tailwind 原始调色板(amber 69 / rose 68 / slate 44 …)恰恰是「颜色不值钱」的反例。
  4. 中文优先的层级:Notion 用同一墨色的 alpha 梯度做层级,不依赖字号差异。这对中文尤其友好——中文在 12–15px 区间字号拉开 1px 会产生「同一个列表两套字号」的破碎感(现状实测:他人 15px/400 与自己 14px/400 同列表并存)。
  5. 深浅同源:暖纸 ↔ 暖炭是同一色相的明暗两端,两套令牌可以共用一份对比度矩阵,而不是各自调一遍。

明确舍弃项(不可照搬):

舍弃 原因
Hero 大图、滚动叙事、80px section gap、96px display 字阶 简报 §1 明确「参考对象的营销页排版、hero 大图、滚动叙事一律不可照搬」;本产品是工具界面不是落地页
装饰插画 / character marks(圆形人物脸、squiggle、sparkle) 无插图资源;且 web/src/components/ui/ 只有 38 个官方组件,装不下装饰层
Lyon Text 衬线体 本栈无中文衬线;参考自己也规定 “Do not use Lyon Text for UI labels or navigation”
大字号负字距(-4.6px@96px 等) ① 中文不能做负字距压缩;② 需要覆盖 className,违反硬约束 2
多彩 accent 卡片背景(#ffb110/#f64932/#62aef0/#02093a 轮转) 本产品颜色已被 6 个任务状态占满;再引入多彩卡片会使状态色失效
营销页的 nav pill、logo wall 无对应界面面
参考的 #0075de 原值 作填充时白字 4.57:1 达标,但作正文/链接文字(Button variant="link"、Tab active 都用 text-primary)对画布只有 4.19:1,不过线;本方案加深一档到 #006bce(详见 §4)

令牌映射

改动面:web/src/styles.css 的 @theme inline(31–107 行)、:root(108–162 行)、.dark(163–212 行)。下表每行的「意图」以 ① 开头表示落在「语义令牌取值」这条途径(本表全部为 ①)。

浅色 :root

变量名 当前值 建议值 意图
--background #fcfcfc #f6f5f4 ① 取自参考画布原值;与白卡拉开层级(对 card 1.089:1),并降低 15px 正文满屏眩光
--foreground #060607 #191817 ① 参考 Ink Black 在暖底上 ~90% alpha 的合成值;canvas 上 16.28:1,去掉近纯黑的锐利感
--card #ffffff #ffffff ① 不变:参考「纯白只留给需要在页面之上的表面」
--card-foreground #060607 #191817 ① 与 foreground 同步;白卡上 17.73:1
--popover #ffffff #ffffff ① 不变
--popover-foreground #060607 #191817 ① 同步暖墨
--primary var(--brand) var(--brand) ① 保持间接引用,一处改 brand 全站生效
--primary-foreground var(--brand-foreground) var(--brand-foreground) ① 同上
--secondary #ebedef #e9e5df ① 他人消息气泡底(message-bubble.tsx 用 Bubble variant="secondary")从冷灰转暖灰;对画布 1.152:1,气泡边界可辨
--secondary-foreground #060607 #191817 ① 气泡内文字 14.13:1
--muted #f2f3f5 #f1eeea ① 弱底(Segmented/Tab 容器、空态块)暖化
--muted-foreground #5c5e66 #615d59 ① 参考 Graphite「warm cast body text」原值;canvas 5.99:1、白卡 6.53:1、muted 上 5.64:1
--accent #ebedef #eae6e0 ① hover 底暖化;与 secondary 同族但浅一档,避免 hover 与「他人气泡」同色
--accent-foreground #060607 #191817 ① 14.26:1
--destructive #da373c #b32518 ① 参考 Vermillion #e32d14 加深;保证 bg-destructive/10 + text-destructive(Badge/Button destructive 官方写法)也达标:canvas 6.04、白卡 6.57、/10 底上 5.13
--border #dcdee1 rgb(25 24 23 / 0.12) ① 复刻参考 hairline rgba(0,0,0,0.08) 的手法;画布上合成 #dbdad9,1.282:1,只作装饰分隔
--input #dcdee1 #8f8880 ① 输入框边界需被辨识:原值对画布仅 1.35:1,新值 3.21:1(canvas)/3.50:1(card),满足 WCAG 1.4.11 的 3:1
--ring var(--brand) var(--brand) ① 焦点环随 brand 走
--chart-1 oklch(0.87 0 0) #d9d4cc ① 单色渐变阶梯脚本不变,色相暖化
--chart-2 oklch(0.556 0 0) #b3ada3 ① 同上
--chart-3 oklch(0.439 0 0) #8c867c ① 同上
--chart-4 oklch(0.371 0 0) #6b655c ① 同上
--chart-5 oklch(0.269 0 0) #4a453e ① 同上
--radius 0.625rem 0.5rem ① 使 rounded-lg(Button/Input) = 8px,rounded-xl(气泡) = 11.2px,对齐参考「buttons 8px / cards 12px」两档制
--brand #2563eb #006bce ① 换参考蓝并加深一档:白字 5.26:1、对画布 4.83:1、对 --brand-soft 4.66:1,填充与文字两种用法同时过线
--brand-foreground #ffffff #ffffff ① 白字在 #006bce 上 5.26:1
--brand-soft rgb(37 99 235 / 0.12) #e6f3fe ① 直接取参考 Sky Tint 原值,用于选中底/浅蓝洗底(避免 alpha 值与侧栏底色多层叠加失真)
--brand-ink #1d4ed8 #005cba ① 弹窗左导航选中态前景(现状用它);对 --brand-soft 5.75:1、对画布 5.95:1
--message-self #e8f3fe #d9e9fc ① 本人气泡(MessageBubble 本地覆盖 --primary);比 Sky Tint 深一档,与暖灰的他人气泡在色相上彻底分开
--message-self-foreground #0d274a #0b2545 ① 12.46:1
--surface-chat-soft #e8f2ff #eef5fc ① 引用/回复块底;比 --brand-soft 更浅,避免与选中态混淆
--surface-chat-selected #e5ecfc #e2eefc ① 会话行选中底,蓝调收敛(对画布 1.079)
--mention #3370ff #0057b0 ① 消灭「三种蓝并存」(--brand / #006ce7 / #3370ff)中的第三种;对 --surface-chat-soft 6.39:1,落在浅蓝引用块上仍可读
--ink #060607 #191817 ① 与 foreground 同值,消除同文件里 8 处 #060607 字面量
--surface-rail #e1e8f2 #e6e3dd ① 蓝灰 rail 转暖灰,成为表面栈最深一阶(对画布 1.176:1)
--sidebar #fcfcfc #eeece8 ① 修掉「侧栏 #fcfcfc 与画布 #fcfcfc 完全相同、零层级对比」(简报 §3.3 实测);对画布 1.084:1
--sidebar-foreground #060607 #191817 ① 侧栏上 15.03:1
--sidebar-primary var(--brand) var(--brand) ① 不变
--sidebar-accent #ebedef #e2ded8 ① 侧栏 hover/选中底;对画布 1.13:1,正文对比 13.23:1
--sidebar-accent-foreground #060607 #191817 ① 同步
--sidebar-border #dcdee1 rgb(25 24 23 / 0.10) ① 与 --border 同法但更淡,侧栏内部分组用
--sidebar-ring var(--ring) var(--ring) ① 不变
--workspace-background linear-gradient(180deg, #e1e8f2, #e1e5f1) var(--surface-rail) ① 参考「strictly flat fills」:去渐变改平涂
--workspace-header-background var(--background) var(--background) ① 不变
--interactive #4e5058 #6b655e ① 图标/次要交互色暖化;对画布 5.29:1
--channel-icon #80848e #8a847c ① 频道 # 图标;对画布 3.40:1(图形 ≥3:1)

深色 .dark

变量名 当前值 建议值 意图
--background oklch(0.145 0 0) #1e1d1b ① 纯中性灰 → 暖炭,与浅色 #f6f5f4 同色相两端
--foreground oklch(0.985 0 0) #f0eee9 ① 暖白;14.53:1(原值 15.8:1,略降眩光)
--card oklch(0.205 0 0) #262522 ① 白卡对应物;对画布 1.099:1(表面栈依然成立)
--card-foreground oklch(0.985 0 0) #f0eee9 ① 13.22:1
--popover oklch(0.205 0 0) #262522 ① 与 card 同级
--popover-foreground oklch(0.985 0 0) #f0eee9 ① 同上
--primary / --primary-foreground var(--brand) / var(--brand-foreground) 同左 ① 继承 :root 的间接引用,随 brand 翻转
--secondary oklch(0.269 0 0) #2e2c28 ① 他人气泡底;对画布 1.209:1,与 --muted 拉开(原值两者同色)
--secondary-foreground oklch(0.985 0 0) #f0eee9 ① 12.02:1
--muted oklch(0.269 0 0) #2b2a27 ① 弱底
--muted-foreground oklch(0.708 0 0) #a8a29a ① 暖灰;canvas 6.66:1、card 6.06:1、muted 5.67:1
--accent oklch(0.269 0 0) #2b2a27 ① hover 底
--accent-foreground oklch(0.985 0 0) #f0eee9 ① 12.38:1
--destructive oklch(0.704 0.191 22.216) #ff8a7d ① 深色下 bg-destructive/20 + text-destructive 需 ≥4.5:canvas 5.06、card 4.63(原值偏暗)
--border oklch(1 0 0 / 10%) rgb(240 238 233 / 0.12) ① hairline 暖白化;合成 #373634,对画布 1.395:1
--input oklch(1 0 0 / 15%) rgb(240 238 233 / 0.40) ① 原 0.15 alpha 对卡片不足 3:1;0.40 合成 #777572,对卡片 3.34:1、对画布 3.67:1
--ring 继承 var(--brand) var(--brand) ① 焦点环
--chart-1..5 oklch(0.87/0.556/0.439/0.371/0.269 0 0) #e8e4dd / #b8b2a8 / #8f897f / #6a645b / #4a453e ① 暖中性阶
--brand oklch(0.68 0.15 256) #2f95ff ① 深色下的品牌蓝;--brand-foreground 在其上 6.16:1
--brand-foreground oklch(0.16 0.02 258) #06121f ① 深海军蓝字(与浅色「白字在蓝上」互逆,符合参考 Dark Feature Card 的「深色岛」思路)
--brand-soft oklch(0.28 0.05 256) #22384e ① 选中底;与 --brand-ink 组合 6.09:1
--brand-ink oklch(0.84 0.09 256) #7fbdff ① 链接/强调文字:canvas 8.52、card 7.76
--message-self #203b59 #1e3a54 ① 暖化后的深钢蓝,与 --brand-soft 区分
--message-self-foreground #e7f3ff #dceaff ① 9.65:1
--surface-chat-soft oklch(0.32 0.06 250) #24384e ① 引用块底
--surface-chat-selected oklch(0.28 0.04 250) #2a3a4d ① 选中底
--mention oklch(0.72 0.14 254) #86c5ff ① 比 --brand-ink 亮一档,在 chat-soft 上可区分:9.18(canvas)/6.54(chat-soft)
--ink oklch(0.16 0.02 258) #121110 ① 暖近黑,与浅色 --ink 对仗
--surface-rail #e3e5e8 #161514 ① 修掉简报 §3.3 实测缺陷「深色下 rail 仍是一条浅色竖带」;成为最深一阶
--sidebar oklch(0.205 0 0) #201f1d ① 与 card 同色 → 略深于画布的暖炭;深色下靠 --sidebar-border 分离
--sidebar-foreground oklch(0.985 0 0) #f0eee9 ① 14.20:1
--sidebar-accent oklch(0.269 0 0) #2e2c28 ① hover/选中底
--sidebar-accent-foreground oklch(0.985 0 0) #f0eee9 ① 12.02:1
--sidebar-border oklch(1 0 0 / 10%) rgb(240 238 233 / 0.10) ① 暖白 hairline
--workspace-background radial-gradient(ellipse at 8% 0%, color-mix(brand 10%, muted), muted 64%) var(--surface-rail) ① 去渐变改平涂(参考 flat fills)
--workspace-header-background linear-gradient(180deg, color-mix(background, brand 3%), background) var(--background) ① 同上
--workspace-rail-background color-mix(in oklab, var(--background) 45%, transparent) color-mix(in oklab, var(--background) 45%, transparent) ① 不变
--radius(继承) 0.625rem 0.5rem ① 深浅共用一套圆角刻度
--interactive / --channel-icon(新增到 .dark) 继承浅色(不翻转) #a09a92 / #8f897f ① 补上深色值,避免浅色图标色漏到深底(原 .dark 未声明这两个变量)
--shadow-e1..pop(@theme inline) rgb(4 4 5 / …)、rgb(15 23 42 / …) rgb(25 24 23 / …)、rgb(32 29 24 / …) ① 只换色相、保持 alpha 台阶与强度不变:暖纸/暖炭底上冷蓝阴影会悬挂出脏灰调

字体与排版

字体栈:不改。 web/src/styles.css:33 的 @theme inline --font-sans 沿用原文:

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

理由:参考的 NotionInter 是 “geometric humanist with slight quirks”,Geist Variable 同属几何人文无衬线,是栈内唯一有拉丁合成字的候选;Geist 无 CJK 字形(简报 §3.3 实测),中文稳定回落到 Noto Sans SC / PingFang SC,即「拉丁与中文各用各自最优字形」,正是参考 NotionInter + 独立 CJK 回退 的意图。不允许把 Inter 之类西文字体插到 CJK 之前去抢字形,也不允许把 CJK 提前挤掉 Geist 的数字字形。数字/ID 用 --font-mono(现状已如此,如 #f06f66、wanman3_rtc_calls)。

字号/行高/字重阶梯(正文 15px/1.375 来自 styles.css:262 的 @layer base body,不动):

角色 字号 行高 字重 落地方式
页面标题(登录页) 26px 1.25 600 ③ 容器:卡片内单行标题区,不放大
频道名 / 面板标题 16px 1.375 600 现状实测 16px/600,保持
消息正文 15px 1.375 400 ③ 现状 body 继承,统一到 15px(消掉「自己 14px / 他人 15px」并存,见 §8 风险 a)
任务卡标题 / 输入框 14px 1.5 400–500 官方 text-sm 组件默认
作者行 / 次要信息 13px 1.45 400 现状实测作者 13px/400,保持
Badge / 时间戳 / 计数 12px 1.4 500 官方 Badge text-xs=12px,即中文下限
代码 / ID / 数字 12.8px 1.4 400 --font-mono

关键界面改造

以下每条都用 ①令牌 / ②官方 variant·size / ③容器布局 标注实现途径。

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

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

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

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

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

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

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

深浅色与对比度

全部比值按 WCAG 2.1 相对亮度公式实算(sRGB → 线性 → 0.2126R+0.7152G+0.0722B)。

浅色(:root)

组合 前景 hex 背景 hex 对比度 达标
正文 / 画布 #191817 #f6f5f4 16.28:1 ✅ ≥4.5
正文 / 白卡 #191817 #ffffff 17.73:1 ✅
次级文字 / 画布 #615d59 #f6f5f4 5.99:1 ✅
次级文字 / 白卡 #615d59 #ffffff 6.53:1 ✅
次级文字 / muted #615d59 #f1eeea 5.64:1 ✅
正文 / 他人气泡 #191817 #e9e5df 14.13:1 ✅
正文 / hover 底 #191817 #eae6e0 14.26:1 ✅
正文 / 侧栏 #191817 #eeece8 15.03:1 ✅
正文 / 侧栏选中 #191817 #e2ded8 13.23:1 ✅
正文 / rail #191817 #e6e3dd 13.84:1 ✅
按钮白字 / brand #ffffff #006bce 5.26:1 ✅
brand 作文字 / 画布 #006bce #f6f5f4 4.83:1 ✅(#0075de 原值仅 4.19 ❌,故加深)
brand 作文字 / brand-soft #006bce #e6f3fe 4.66:1 ✅
brand-ink / 画布 #005cba #f6f5f4 5.95:1 ✅
brand-ink / brand-soft #005cba #e6f3fe 5.75:1 ✅
本人气泡文字 #0b2545 #d9e9fc 12.46:1 ✅
@提及 / 画布 #0057b0 #f6f5f4 6.45:1 ✅
@提及 / 引用底 #0057b0 #eef5fc 6.39:1 ✅
destructive / 画布 #b32518 #f6f5f4 6.04:1 ✅
destructive / 白卡 #b32518 #ffffff 6.57:1 ✅
destructive / destructive/10 底(画布上) #b32518 #f6f5f4+10% 5.13:1 ✅
图标 / 画布 #6b655e #f6f5f4 5.29:1 ✅
频道图标 / 画布(图形) #8a847c #f6f5f4 3.40:1 ✅ ≥3
输入框边界 / 画布(图形) #8f8880 #f6f5f4 3.21:1 ✅ ≥3
输入框边界 / 白卡(图形) #8f8880 #ffffff 3.50:1 ✅ ≥3
border hairline / 画布(装饰) 合成 #dbdad9 #f6f5f4 1.282:1 ⚠ 装饰性,见 §8 风险 h
表面层级 侧栏/画布 #eeece8 #f6f5f4 1.084:1 层级可辨(修掉现状 1.000)
表面层级 rail/画布 #e6e3dd #f6f5f4 1.176:1 层级可辨
表面层级 白卡/画布 #ffffff #f6f5f4 1.089:1 层级可辨
他人气泡/画布 #e9e5df #f6f5f4 1.152:1 气泡边界可辨

深色(.dark)

组合 前景 hex 背景 hex 对比度 达标
正文 / 画布 #f0eee9 #1e1d1b 14.53:1 ✅
正文 / 白卡 #f0eee9 #262522 13.22:1 ✅
次级文字 / 画布 #a8a29a #1e1d1b 6.66:1 ✅
次级文字 / 白卡 #a8a29a #262522 6.06:1 ✅
次级文字 / muted #a8a29a #2b2a27 5.67:1 ✅
正文 / 他人气泡 #f0eee9 #2e2c28 12.02:1 ✅
正文 / 侧栏 #f0eee9 #201f1d 14.20:1 ✅
正文 / 侧栏选中 #f0eee9 #2e2c28 12.02:1 ✅
正文 / rail #f0eee9 #161514 15.73:1 ✅
按钮深字 / brand #06121f #2f95ff 6.16:1 ✅
brand 作文字 / 画布 #2f95ff #1e1d1b 5.51:1 ✅
brand 作文字 / 白卡 #2f95ff #262522 5.01:1 ✅
brand-ink / 画布 #7fbdff #1e1d1b 8.52:1 ✅
brand-ink / brand-soft #7fbdff #22384e 6.09:1 ✅
本人气泡文字 #dceaff #1e3a54 9.65:1 ✅
@提及 / 画布 #86c5ff #1e1d1b 9.18:1 ✅
@提及 / 引用底 #86c5ff #24384e 6.54:1 ✅
destructive / 画布 #ff8a7d #1e1d1b 7.37:1 ✅
destructive / 白卡 #ff8a7d #262522 6.70:1 ✅
destructive / destructive/20 底(白卡上) #ff8a7d #262522+20% 4.63:1 ✅
destructive / destructive/20 底(muted 上) #ff8a7d #2b2a27+20% 4.35:1 ⚠ 唯一未达标组合,见 §8 风险 f
图标 / 画布 #a09a92 #1e1d1b 6.04:1 ✅
频道图标 / 画布(图形) #8f897f #1e1d1b 4.85:1 ✅ ≥3
输入框边界 / 白卡(图形) 合成 #777572 #262522 3.34:1 ✅ ≥3
输入框边界 / 画布(图形) 合成 #777572 #1e1d1b 3.67:1 ✅ ≥3
border hairline / 画布(装饰) 合成 #373634 #1e1d1b 1.395:1 ⚠ 装饰性
表面层级 白卡/画布 #262522 #1e1d1b 1.099:1 层级可辨
表面层级 rail/画布 #161514 #1e1d1b 1.083:1 层级可辨(修掉现状「rail 是浅色竖带」)
表面层级 侧栏/画布 #201f1d #1e1d1b 1.023:1 弱,靠 --sidebar-border 分离

深色的可达性前提(重要):简报 §3.3 实测——全仓 web/src 无任何代码给 <html> 加 .dark,localStorage 无主题键,color-scheme: normal,深色主题在当前生产不可达。本方案给出完整深色令牌,但「让用户真的能看到深色」需要另开一个「主题切换」任务(见 §8 风险 g)。

shadcn 兼容性

结论:在「只用官方组件 + 官方 variant/size」的前提下完全可以达成。 本方案的视觉改观 100% 落在 ① 语义令牌取值、② 官方 variant/size 选择、③ 容器 flex/grid/间距 三条途径上,没有一处需要自定义颜色、字号、圆角、阴影或状态样式。

用到的官方组件(全部已在 web/src/components/ui/ 的 38 个之列,无需新增安装): button(variant: default / outline / secondary / ghost / destructive / link;size: lg / default / sm / xs / icon-sm)、badge(default / secondary / outline / ghost / destructive)、input、textarea、tabs(default / line)、avatar、separator、card、dialog、popover、dropdown-menu、scroll-area、skeleton、item、field、bubble(default / secondary / tinted / outline / ghost)、message、message-scroller。

如需引入尚未安装的官方组件(可选、非必需): sidebar(官方 Sidebar 家族,可替代自建的 channel-sidebar.tsx DOM)、empty(官方空态块,可替代「这里还没有消息 / 在下方输入框发送第一条消息,把话题开起来。」的手写空态)、input-group(已在列,可用于搜索框)。这三项都不是本方案的前置条件。

必须显式标注的不合规 / 风险清单

# 风险 具体数值依据 处理建议
a 同一消息列表两套字号:他人 15px/400、自己 14px/400 要统一 简报 §3.3 S2 实测 统一需改消息文本节点的 className,超出硬约束 2 的三条途径 → 标注为风险,本方案不给伪造方案
b 字号刻度收敛不可达:单视图 10 档(9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26px)要收到 6 档 简报 §3.3 实测;styles.css 内硬编码 font-size 12px×12、13px×7、14px×2、11/15/16/22/24/27px 各 1 需改 className 或给 styles.css 新增 --text-* 令牌;本文件规定「只含真实存在的变量名」,故不允许新增 → 标注为风险(§5 已给出目标阶梯)
c 登录页分段控件选中态可能不可辨:若该控件写死 bg-background,选中态=#f6f5f4 与画布同色(1.00:1) 简报 §3.3 S7「选中态背景 --background #fcfcfc」 需 ② 改官方 variant 或 ③ 改容器;若两者都不可行则标注为风险
d 弹窗圆角 14.4px > 参考的 12px 上限 参考 “Do not apply border-radius larger than 12px to rectangular content”;现状 dialog 18px = rounded-2xl(1.8×10px) --radius 降到 0.4375rem 才能压到 12.6px,但那样 Button 只有 7px ≠ 参考 8px。取舍:保 8px 按钮,接受 14.4px 弹窗 → 标注为已知偏离
e 登录页页脚 11px < 中文 12px 下限 简报 §3.3 S7「页脚 11px」 需改 className → 风险;本方案不伪造
f 深色 destructive/20 落在 --muted #2b2a27 上只有 4.35:1 本文 §7 表格倒数第 3 行 只影响「危险 Badge 放在 muted 底上」这一种未见组合;如需全量达标把深色 --destructive 提到 #ff9b90(会让 destructive/20 on card 达 5.1:1)——当前按「Badge 只出现在 card/canvas」保留 4.63:1 的取舍,标注为风险
g 深色主题在生产不可达:<html> class 恒为空 简报 §3.3 实测(全仓无 .dark 添加点) 本方案只保证令牌侧正确;「主题切换」需另开任务。深浅两套令牌都必须给,但深色验收只能在 devtools 注入 .dark 下做
h --border 是 1.282:1 的装饰发丝线,不满足「图形边界 ≥3:1」 本文 §7;参考原规则就是 rgba(0,0,0,0.08) WCAG 1.4.11 只约束「识别组件所必需」的边界,输入框已由 --input(3.21:1)覆盖。若审计强制所有 1px 边界 ≥3:1,则把 --border 也提到 #8f8880(会明显加重界面)
i 253 处 Tailwind 原始调色板绕过语义令牌(amber 69 / rose 68 / slate 44 / emerald 42 …),深色下不翻转 简报 §3.3 令牌泄漏普查 不在本方案范围(需改 44 个非测试文件)。它会显著削弱本方案的效果上限,尤其头像首字底色(amber rgb(255,251,235)/rose rgb(255,241,242) 等 5 组硬编码)——本方案在 §6 S8 只处理 emoji 图标,不复述这一层的改造
j web/src 无 .dark 时 55 处 rgb(6,6,7) 前景硬编码 简报 §3.3 同 i,标注为风险而非本方案可达目标

实施成本

改动面

文件 位置 改动 必须
web/src/styles.css @theme inline 31–107 行 4 个 --shadow-* 换色相 ✅
web/src/styles.css :root 108–162 行 44 个变量 ✅
web/src/styles.css .dark 163–212 行 33 个变量(含新增 --interactive / --channel-icon) ✅
组件文件 — 0 处必须改 —
message-bubble.tsx 引用块 换 Bubble variant="tinted"(可选增强,②) 可选
task-hall.tsx / channel-work-items.tsx 状态标记 6 状态 → Badge variant 映射(②) 可选
group-hall.tsx hero 段落 ③ 删除营销 hero,改筛选条 + 卡片网格 强烈建议
app-center.tsx / assistant-board.tsx 卡片图标 emoji → lucide 图标(②) 强烈建议
message-list.tsx 等 44 个文件 Tailwind 调色板 253 处硬编码收口 不在本方案范围(风险 i)

人时估算

阶段 内容 人时
令牌替换 styles.css 三块替换 + 本地起 Vite 目视 2h
全站回归 13 个样例面(S1/S2/S3/S4/S5/S6/S7/S8 + 深色注入 2 面)逐面目视与实测复算 4h
状态色映射 6 个任务状态 → Badge variant 的组件侧调整 3h
营销 hero 拆除 + 应用中心图标 group-hall.tsx、app-center.tsx 4h
深色可达性(另开任务) 主题切换与 55 处硬编码 不估(风险 g/i,独立排期)
合计(不含另开任务) 约 13 人时

风险清单

  1. --radius 0.625rem → 0.5rem 会同时改变全部 rounded-sm/md/lg/xl/2xl/3xl/4xl(4.8/6.4/8/11.2/14.4/17.6/20.8px)。现状实测有 2/6/7/8/10/12/14/18/24/26/32px 共 11 档,其中 2px 与 9999px 不受影响;24/26/32px 三档会缩到 17.6/20.8px,若某处(如 reaction 胶囊、头像底座)依赖 32px 会出现视觉降级,需在回归里逐个检查。
  2. --border 从实色改 alpha 后,任何把 --border 当实色用的地方(如 blueprint 网格背景)在深色下会变成半透明白线——恰好是正确的(现状深色下 blueprint 网格是深灰实色,改变后会更清晰)。
  3. --input 从 #dcdee1 提到 #8f8880 是本方案视觉变化最「重」的一处(1.35:1 → 3.21:1)。如果不接受虚拟边框变深,退路是保留 #dcdee1 并显式承认输入框边界不满足 3:1(风险 h 同类)。
  4. --brand 从 #2563eb 换到 #006bce 会让所有品牌蓝元素(20 处群大厅、--mention 附近的 #006ce7 硬编码、Clerk 登录主题)出现色相偏移 6°、亮度降 12%,需在回归里对齐 web/src/styles.css 之外的两处硬编码蓝(message-list.tsx、composer-markdown.ts 的 #006ce7)。

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

用与简报 §3.3 同一套渲染脚本(/Users/waw/Documents/code/wanman/localtmp/design-render/ 的 JSON 产物结构)对 13 个样例面重跑,断言:

  1. getComputedStyle(document.documentElement).getPropertyValue('--background') === #f6f5f4,--card === #ffffff。
  2. 侧栏层级:aside 背景 ≠ body 背景(现状两者都是 #fcfcfc,比值 1.000);新值应为 #eeece8 vs #f6f5f4(1.084:1)。
  3. 圆角档位集合:全站 border-radius 去重集合应 ⊆ {4.8, 6.4, 8, 11.2, 14.4, 17.6, 20.8, 9999}px,且不再出现 7px 与 12px 两个无来源档位。
  4. 对比度回归:对 .textlines.json 里每条可视文本,用其 color 与最近祖先背景色算比值,断言正文 ≥4.5、图形边界 ≥3。
  5. 深色注入:手动加 .dark 后,--surface-rail 计算结果应为 #161514(现状为浅色 #e3e5e8,rail 是浅色竖带);同时统计 rgb(6,6,7) 命中数应从 55 下降(不会归零,用于区分「令牌侧已修」与「className 侧未修」)。
  6. 渐变归零:getComputedStyle 中 background-image 不再包含 gradient((--workspace-background 与 --workspace-header-background 已改平涂)。

取舍

解决了什么

  1. 修掉了 3 个可复算的层级缺陷:侧栏与画布零对比(1.000 → 1.084)、深色 rail 浅色竖带(#e3e5e8 → #161514)、两套圆角体系(10px/8px 混用 → 同一刻度派生)。这三条都不是「更清爽」,而是实测到的具体故障。
  2. 把色彩信息量从「4 种蓝 + 253 处调色板」压到「1 个填充色 + 2 bit 状态」:品牌蓝唯一填充(每屏 1 处),危险红只给风险,其余状态走灰阶。6 个任务状态在一眼扫视里可分辨。
  3. 把「颜色靠字重/透明度而不是字号」这条参考规则搬进中文界面:正文 15px 一档到底,层级靠 #191817 / #615d59 两档暖灰 + 字重,避免中文在 12–15px 之间拉出小数字号。
  4. 对比度全部有实测值:正文 16.28:1(浅)/14.53:1(深),次级 5.99/6.66,图形边界 3.21/3.34,25 组组合逐条列出。品牌蓝从参考原值 #0075de 加深到 #006bce 就是为了让「brand 作文字」也过 4.5(4.19 → 4.83)。
  5. 深浅同源:两套共用一份 4 级表面栈与一致的圆角刻度,深色不需要单独调参。

牺牲了什么

  1. 放弃了参考最出彩的「多彩贴纸卡」:#ffb110 / #f64932 / #62aef0 / #02093a 轮转的背景色不迁移。代价是方案「不那么像 Notion」,收益是任务状态色不被抢戏。这是一次刻意的品牌辨识度换功能清晰度。
  2. 界面会变「轻」:去除阴影 + 圆角整体缩小(10→8、14→11.2、18→14.4px)+ 边界变细,在高密度列表里容错变小——两行 64px 的会话行之间只靠 1.282:1 的 hairline 与 1.084:1 的底色差分区。在低质量显示器/投影上,浅色模式的层级会比现状弱。
  3. 输入框变重:--input 提到 #8f8880 是为满足 3:1 图形对比,视觉上比现状的 #dcdee1 明显更深,是「合规换美学」的净损失。
  4. 弹窗圆角 14.4px 偏离参考的 12px 上限(风险 d),换来按钮精确 8px。
  5. 效果上限受 253 处硬编码调色板拖累:令牌侧改完,全站最刺眼的「5 组 Tailwind 硬编码头像底色」与「3 种蓝并存」中的 2 处仍不会消失,本方案无法覆盖。

什么场景下不适用