暖笺工作台(Warm-Parchment Workshop)

目标代码:wanman-worktree-design-airtable(分支 codex/design-airtable,基线 test@3d35969f) 覆盖样例面:S1 外壳/侧栏、S2 频道消息流、S3 任务大厅+任务卡、S4 AI 助手频道、S5 管理设置弹窗、S7 登录页、S8 应用中心(7 面) 参考设计:Airtable(airtable.design.md / airtable.design-extended.md)

方案名与主张

中文名:暖笺工作台(Warm-Parchment Workshop)

一句话主张:把冷白飞书采样换成「暖纸工作台」——画布是暖米白 #faf5e8,主操作按钮走暖墨黑 Onyx #1f1a14 而不是品牌蓝,颜色只降级为章节标签(任务状态、分类徽标),用 5 个 chart 槽承载「多彩但克制」的色码体系。

适用基调:浅色优先、双主题对等。浅色是产品主战场(一线人员长时段驻留、高信息密度);深色同步给全量令牌,但当前深色在代码层不可达(见 §8 风险 R1),本方案诚实标注而不假装已实现。

参考提炼

适配判断

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

  1. 暖沙底色天然降低长时间驻留的视觉疲劳。现状 --background:#fcfcfc 与 --sidebar:#fcfcfc 完全相同(简报 §3.3 实测:aside 背景 #fcfcfc、border-radius 14px,与页面底零层级对比),侧栏靠一条 14px 圆角浮起来,属于「用圆角代替层级」。暖纸三层(画布 #faf5e8 / 侧栏 #f2ebda / 卡片 #fffdf8)用明度差建立层级,比再多加阴影更稳。
  2. Onyx 黑主按钮解决了「三种蓝并存」。现状令牌 --brand:#2563eb、硬编码 #006ce7(message-list.tsx、composer-markdown.ts、voice-channel-history-dialog.tsx)、--mention:#3370ff(chat-mention.ts 硬编码 #3370FF)三方打架。把主操作从蓝移到墨黑后,蓝色只剩一个明确语义(@ 提及/链接 = Cobalt #1b5fc4),冗余的品牌蓝冲突被结构性消除。
  3. 色码章节系统正是任务状态所需。现状任务卡只有标题 14px/500 + 频道 chip + AI 助手 chip(简报 §3.3),6 个状态(待补充/待处理/进行中/待验收/已完成/已关闭)没有视觉色码。Airtable 的多色身份系统在这里的落地形态就是状态色,而且是唯一应该用彩色的地方——颜色集中在标签上,符合「多彩但克制」。
  4. 与中文排版不冲突:Airtable 的正文字号(16–18px)在高密度中文列表里过大,舍弃;保留现有 15px/1.375 正文基线(满足简报 §2 第 4 条 14–15px、行高 ≥1.375)。

明确舍弃项:展示衬线字体与 900 字重、48px 展示字号、营销页栅格与 hero、8px 基础节奏、纯色大面积饱和色块(彩色只允许出现在徽标/图表/左侧 3px 状态条上,不允许铺满卡片背景)。

令牌映射

全部变量名取自 web/src/styles.css 现有声明(:root 108 行起 / .dark 153 行起),未新增任何令牌名,故 @theme inline 映射表无需改动。对比度用 WCAG 相对亮度公式实算(Python脚本,见 §7 说明)。

浅色 :root

变量名 当前值 建议值 意图
--background #fcfcfc #faf5e8 暖纸画布,替掉冷白;与侧栏/卡片拉开层级
--foreground #060607 #201a13 暖调近黑(Onyx 暖化版),在暖底上不发灰
--card #ffffff #fffdf8 纯白→暖白,避免纸面上出现刺眼冷白块
--card-foreground #060607 #201a13 与 --foreground 对齐
--popover #ffffff #fffdf8 浮层与卡片同层,靠阴影分层
--popover-foreground #060607 #201a13 同上
--primary var(--brand) var(--brand) 保持指针式引用(映射不变)
--primary-foreground var(--brand-foreground) var(--brand-foreground) 同上
--secondary #ebedef #f0e9d9 冷灰→暖沙,用于 secondary 按钮/徽标
--secondary-foreground #060607 #201a13 与前景统一
--muted #f2f3f5 #f2ecdd 弱化面暖化,比 secondary 略浅
--muted-foreground #5c5e66 #6b6154 冷灰字→暖灰字(5.57:1 / 卡片 5.97:1)
--accent #ebedef #ece4d1 hover/选中底,同时是他人消息气泡色
--accent-foreground #060607 #201a13 13.61:1
--destructive #da373c #9e2b16 亮红→焦陶红(Burnt Sienna 系),暖底上 6.86:1,不再与暖色打架
--border #dcdee1 #e2d9c6 冷灰发丝→暖发丝;装饰性,不承担 1.4.11
--input #dcdee1 #9c8b64 输入描边抬到非文本 3:1(卡片 3.28:1 / 画布 3.07:1)
--ring var(--brand) var(--brand) 焦点环跟随主色(墨黑环=最高对比)
--brand #2563eb #1f1a14 核心动作:CTA 从品牌蓝改成暖墨黑(白字 16.56:1)
--brand-foreground #ffffff #fdfaf2 黑底上的暖白字,与暖纸同族
--brand-soft rgb(37 99 235 / 0.12) rgb(31 26 20 / 0.08) 选中底由蓝水洗改墨色水洗,降低整屏蓝污染
--brand-ink #1d4ed8 #1f1a14 选中态前景,浅沙底上 14.04:1
--message-self #e8f3fe #fbe3cd 自己的气泡:参考 Peach Glow 水洗版(暖桃)
--message-self-foreground #0d274a #3a1f06 桃底焦棕字 12.31:1;与「他人=--accent」明确分离
--surface-chat-soft #e8f2ff #f7f0dd 引用/置顶条底色暖化
--surface-chat-selected #e5ecfc #f0e7cf 会话选中底,与 hover 区分
--mention #3370ff #1b5fc4 @ 提及收敛到参考的 Cobalt 蓝,画布 5.54:1
--ink #060607 #201a13 与前景统一
--surface-rail #e1e8f2 #ece3cd 空间 rail 从冷蓝灰改正暖沙,去掉冷色断层
--sidebar #fcfcfc #f2ebda 修零层级:侧栏比画布暗一档
--sidebar-foreground #060607 #201a13 14.50:1
--sidebar-accent #ebedef #e8dfc9 侧栏行 hover/选中,行文字 12.99:1
--sidebar-accent-foreground #060607 #201a13 同上
--sidebar-border #dcdee1 #e0d6c0 侧栏内发丝线暖化
--chart-1 oklch(0.87 0 0) #1b61c9 进行中(Cobalt)
--chart-2 oklch(0.556 0 0) #b4441f 待验收(Terracotta)
--chart-3 oklch(0.439 0 0) #2f6b3a 已完成(Forest)
--chart-4 oklch(0.371 0 0) #8a6100 待处理(Marigold 压暗至 5.45:1)
--chart-5 oklch(0.269 0 0) #9a5280 已关闭/风险(Petal Pink 压暗至 5.31:1)
--radius 0.625rem (10px) 0.75rem (12px) 对齐参考 Button 12px,--radius-xl≈16.8px 落到卡片 16px 档

其余真实存在、一并调整的变量(同属 ① 途径):--workspace-background: linear-gradient(180deg,#ece3cd,#e7dcc2)(去冷色断层)、--workspace-rail-background: transparent(不变)、--workspace-header-background: var(--background)(不变)、--interactive: #6b6154、--channel-icon: #8d8270(侧栏上 3.18:1,图形边界达标)、--sidebar-primary: var(--brand)、--sidebar-primary-foreground: var(--brand-foreground)、--sidebar-ring: var(--ring)。

深色 .dark

变量名 当前值 建议值 意图
--background oklch(0.145 0 0) #17140f 中性黑→暖墨黑;正文 15.89:1
--foreground oklch(0.985 0 0) #f4eee1 冷白→暖白
--card oklch(0.205 0 0) #211d16 暖炭,比画布亮一档
--card-foreground oklch(0.985 0 0) #f4eee1 14.51:1
--popover oklch(0.205 0 0) #262117 浮层再亮一档,用亮度分层替代阴影
--popover-foreground oklch(0.985 0 0) #f4eee1 13.84:1
--primary var(--brand) var(--brand) 引用不变
--primary-foreground var(--brand-foreground) var(--brand-foreground) 引用不变
--secondary oklch(0.269 0 0) #2e2820 暖炭次级面
--secondary-foreground oklch(0.985 0 0) #f4eee1 同上
--muted oklch(0.269 0 0) #2b251c 比 secondary 略深
--muted-foreground oklch(0.708 0 0) #b3a893 暖灰次级字:画布 7.82:1、卡片 7.14:1
--accent oklch(0.269 0 0) #332c21 hover / 他人气泡
--accent-foreground oklch(0.985 0 0) #f4eee1 同上
--destructive oklch(0.704 0.191 22.216) #e0735a 提亮陶红:画布 5.92:1 / 卡片 5.41:1
--border oklch(1 0 0 / 10%) rgb(244 238 225 / 0.14) 中性发丝→暖白发丝,略微提高不透明度
--input oklch(1 0 0 / 15%) #7d7156 不明透明→不透明暖描边,非文本 3:1(卡片 3.49:1)
--ring var(--brand) var(--brand) 引用不变
--brand oklch(0.68 0.15 256) #f0e6d2 深色反相:主操作=暖白填充(对应浅色墨黑),替掉蓝
--brand-foreground oklch(0.16 0.02 258) #1f1a13 暖白底上的墨字 13.95:1
--brand-soft oklch(0.28 0.05 256) rgb(240 230 210 / 0.12) 选中底改暖白水洗
--brand-ink oklch(0.84 0.09 256) #f0e6d2 选中态前景 12.13:1
--message-self #203b59 #4a3524 自己气泡深暖棕(与浅色桃色同族)
--message-self-foreground #e7f3ff #fbe8d4 气泡内文字 9.64:1
--surface-chat-soft oklch(0.32 0.06 250) #2e2618 引用底暖化
--surface-chat-selected oklch(0.28 0.04 250) #3a3123 选中底暖化
--mention oklch(0.72 0.14 254) #7fb0ff 提亮 Cobalt,卡片 7.63:1
--ink oklch(0.16 0.02 258) #f4eee1 深色下 ink 必须是亮色(原值深蓝仅适配旧蓝体系)
--surface-rail #e3e5e8 #2a2419 修硬伤:原值是浅色,深色下会是一条浅竖带
--sidebar oklch(0.205 0 0) #211d16 与卡片同层
--sidebar-foreground oklch(0.985 0 0) #f4eee1 14.51:1
--sidebar-accent oklch(0.269 0 0) #2e2820 行 hover/选中
--sidebar-accent-foreground oklch(0.985 0 0) #f4eee1 同上
--sidebar-border oklch(1 0 0 / 10%) rgb(244 238 225 / 0.14) 暖白发丝
--chart-1 oklch(0.87 0 0) #7fb0ff 进行中,卡片 7.63:1
--chart-2 oklch(0.556 0 0) #e8896a 待验收,6.56:1
--chart-3 oklch(0.439 0 0) #7fbf8a 已完成,7.76:1
--chart-4 oklch(0.371 0 0) #e0b356 待处理,8.59:1
--chart-5 oklch(0.269 0 0) #d79cc0 已关闭/风险,7.51:1
--radius 0.625rem 0.75rem 与浅色一致(深浅圆角不应分叉)
--interactive (深色未声明,继承 #4e5058) #b3a893 补上暖灰,避免沿用浅色的深灰在深底上不可读
--channel-icon (深色未声明,继承 #80848e) #a99d88 侧栏上 6.28:1

深色保留原文件中的 --workspace-background / --workspace-rail-background / --workspace-header-background 表达式结构,仅让其引用的 --brand/--muted/--background 走新值(无需改公式)。

字体与排版

字体栈(不变,web/src/styles.css:38 @theme inline): "Geist Variable", "gg sans", "Noto Sans SC", "PingFang SC", ui-sans-serif, system-ui, "Segoe UI", "Microsoft YaHei", Roboto, Helvetica, Arial, sans-serif ——Geist 无中文字形,中文自动回落 Noto Sans SC / PingFang SC;拉丁用 Geist、中文用系统黑体,两者互不挤占。数字/代码继续用 --font-mono(ui-monospace, "SF Mono", …)。参考的 Haas Groot Disp 展示衬线面不迁移(本项目 --font-heading: var(--font-sans),无独立展示面)。

字号/行高/字重阶梯(目标规范)——令牌层无字号位(web/src/styles.css 现有 116 个令牌名里没有 --text-*),故本表是规范与验收基准,落地途径见「实现途径」列:

阶梯 字号 行高 字重 用途 现状 实现途径
display 20px 1.3 600 登录页主标题(现状 26px 偏大且无阶梯) 26px/600 途径外(组件类)→ 风险 R4
title 16px 1.35 600 频道头标题、大厅标题 16px/600 ✅ 已达标
body 15px 1.375 400 消息正文、表单正文 15px/400 ✅ 已达标(@layer base body)
body(self) 15px 1.375 400 自己的消息正文 14px(与同列表他人 15px 不一致) 途径外 → 风险 R4
label 13px 1.4 500 任务卡标题、表单标签、导航项 14px / 13px 混用 途径外 → 风险 R4
meta 12px 1.4 400 时间戳、成员数、预览 12px/500、11.25px、11px 途径外 → 风险 R4
mono 12–14px 1.4 400 数字、任务 ID、代码 混合 途径外

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

关键界面改造

每条标注落点:① 语义令牌取值 / ② 官方 variant·size / ③ 容器布局·间距·滚动。

S1 外壳 + 空间/频道侧栏(app-shell.tsx L12126 h-full w-64 …、channel-sidebar.tsx)

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

S3 任务大厅 + 任务卡(task-hall.tsx L1183 TaskHallCard、L1215 卡片容器、group-hall.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)

S6 语音频道(本栈不可见,仅代码依据)

本机 TRTC_ENABLED=false,DOM 内 aria-label 匹配「语音|通话|加入」命中 0,正文不含「语音」,/api/v1/rtc/* 返回 RTC_DISABLED,本方案未看到任何语音界面截图或 DOM。设计依据仅为代码 web/src/components/app/rtc-group-call-ui.tsx 与库表(wanman3_rtc_voice_channels 30 行、wanman3_rtc_calls 183 行、会议纪要 20 行)。若启用,建议:通话中状态用 --chart-3(已在用)、断开/失败用 --destructive、成员静音用 --muted-foreground,面板底 --card——全部为 ① 途径。不宣称已覆盖此面。

深浅色与对比度

用 WCAG 相对亮度公式实算(L = 0.2126R + 0.7152G + 0.0722B,通道先做 ((c+0.055)/1.055)^2.4 线性化;CR = (L₁+0.05)/(L₂+0.05))。下表单次计算,可复现。

浅色

组合 前景 hex 背景 hex 对比度 是否达标
正文 / 画布 #201a13 #faf5e8 15.83:1 ✅(≥4.5)
正文 / 卡片 #201a13 #fffdf8 16.95:1 ✅
次级文字 / 画布 #6b6154 #faf5e8 5.57:1 ✅
次级文字 / 卡片 #6b6154 #fffdf8 5.97:1 ✅
主按钮文字 / 主按钮底 #fdfaf2 #1f1a14 16.56:1 ✅
自己气泡文字 / 气泡底 #3a1f06 #fbe3cd 12.31:1 ✅
他人气泡文字 / 气泡底 #201a13 #ece4d1 13.61:1 ✅
@ 提及 / 画布 #1b5fc4 #faf5e8 5.54:1 ✅
危险文字 / 画布 #9e2b16 #faf5e8 6.86:1 ✅
选中态前景 / 选中底 #1f1a14 #ece4d1 14.04:1 ✅
侧栏文字 / 侧栏底 #201a13 #f2ebda 14.50:1 ✅
侧栏行文字 / 行选中底 #201a13 #e8dfc9 12.99:1 ✅
状态色(chart-1..5)/ 卡片 — #fffdf8 5.74 / 5.45 / 6.29 / 5.45 / 5.31:1 ✅(全部 ≥4.5)
输入描边 / 卡片 #9c8b64 #fffdf8 3.28:1 ✅(非文本 ≥3)
输入描边 / 画布 #9c8b64 #faf5e8 3.07:1 ✅
频道 # 图标 / 侧栏 #8d8270 #f2ebda 3.18:1 ✅(图形边界 ≥3)
结构发丝线 / 卡片 #e2d9c6 #fffdf8 1.38:1 ⚪ 装饰性分隔线,不承载信息(AC 1.4.11 不适用);交互控件边界由 --input 承担
侧栏分隔线 / 侧栏 #e0d6c0 #f2ebda 1.21:1 ⚪ 同上

深色

组合 前景 hex 背景 hex 对比度 是否达标
正文 / 画布 #f4eee1 #17140f 15.89:1 ✅
正文 / 卡片 #f4eee1 #211d16 14.51:1 ✅
正文 / 浮层 #f4eee1 #262117 13.84:1 ✅
次级文字 / 画布 #b3a893 #17140f 7.82:1 ✅
次级文字 / 卡片 #b3a893 #211d16 7.14:1 ✅
主按钮文字 / 主按钮底 #1f1a13 #f0e6d2 13.95:1 ✅
自己气泡文字 / 气泡底 #fbe8d4 #4a3524 9.64:1 ✅
@ 提及 / 卡片 #7fb0ff #211d16 7.63:1 ✅
危险文字 / 画布 #e0735a #17140f 5.92:1 ✅
危险文字 / 卡片 #e0735a #211d16 5.41:1 ✅
选中态前景 / 选中底 #f0e6d2 #2b261d 12.13:1 ✅
侧栏文字 / 侧栏底 #f4eee1 #211d16 14.51:1 ✅
状态色(chart-1..5)/ 卡片 — #211d16 7.63 / 6.56 / 7.76 / 8.59 / 7.51:1 ✅
输入描边 / 卡片 #7d7156 #211d16 3.49:1 ✅
输入描边 / 画布 #7d7156 #17140f 3.82:1 ✅
频道 # 图标 / 侧栏 #a99d88 #211d16 6.28:1 ✅

必须同时声明的限制:以上深色值只在 <html class="dark"> 被加上后生效,而全仓 web/src 无任何代码添加 .dark(简报 §3.3 实测:<html> class 恒为空、localStorage 无主题键、color-scheme: normal),故深色主题在生产不可达;且注入 .dark 后仍有 55 处前景 rgb(6,6,7)、27 处 rgb(92,94,102)、6 处边框 rgb(220,222,225) 是浅色硬编码,不随令牌翻转(见 §8 风险 R1/R2)。

shadcn 兼容性

编号 位置 问题 标记
R1 app-shell.tsx 根节点 / 全局 深色主题需要给 <html> 或根容器加 .dark,属代码改动,超出 ①②③ 三条途径 不合规风险,需批准一行改动
R2 44 个非测试文件、253 处 Tailwind 原始调色板(amber 69 / rose 68 / slate 44 / emerald 42 …);头像首字 50/700 硬编码;#006ce7(message-list.tsx 等 3 处)、#3370FF(chat-mention.ts) 这些颜色绕过语义令牌,改令牌对它们无效,深色下不翻转 不合规风险,需逐处替换为令牌色
R3 task-hall.tsx:1215 bg-white、group-hall.tsx hero 段落 卡片底色/营销式排版属 className 与结构改动 部分为 ③ 允许(容器布局),底色替换需改 class → 需批准
R3b 侧栏 14px 外圆角、弹窗 18px、任务卡 8/10px 混用 圆角来自组件 class(rounded-2xl/rounded-[18px]),令牌只到 --radius-2xl≈21.6px 属 className 改动,标注为不合规风险
R4 9 / 9.375 / 11 / 11.25 / 12.8 / 13.125px 等 spec 外字号;自己消息 14px vs 他人 15px 字号不在令牌层,收敛必须改组件 class 不合规风险,建议单独批准一批(不影响令牌文件)
R5 app-center.tsx:529 emoji 图标、assistant-board.tsx 换成 lucide 图标属 markup 改动 不合规风险,建议批准(简报点名的缺口)
R6 task-hall.tsx:373、app-center.tsx:582 的 border-amber-200 bg-amber-50 text-amber-800 警告条;task-hall.tsx:1363 border-slate-100 原始调色板,深色下成浅色块 不合规风险(同 R2)
R7 Input 官方类含 dark:bg-input/30;--input 在深色下是不透明 #7d7156,30% 叠加后的实际观感与底色对比未在浏览器中验证(本任务不跑浏览器) 需人工目检一次 待验证([INFERENCE]:按官方类推导,深色输入框底约为 #2a2519 附近,仍属暖色系)

实施成本

取舍

解决了什么

  1. 侧栏与画布「零层级」(现状两者同为 #fcfcfc)——用暖纸三层一次性解决,且不依赖阴影或自定义圆角。
  2. 三种蓝并存的结构性混乱——主操作移到墨黑后,蓝只剩「@ 提及/链接」一个语义(#1b5fc4)。
  3. 任务状态无色码——--chart-1..5 把 6 个状态(待补充/待处理/进行中/待验收/已完成/已关闭)落成可辨认、深浅两态都 ≥5.31:1 的色码。
  4. 深色 --surface-rail:#e3e5e8 的浅色竖带硬伤、--ink 在深色下仍是深蓝的错配。
  5. 冷灰调(#ebedef/#f2f3f5/#dcdee1/#5c5e66)整体暖化,与「OPC 行业一线人员」的工作台气质一致。

牺牲了什么

  1. 不是纯粹的品牌表达:主按钮从蓝变黑,品牌蓝在界面上几乎消失(仅 --mention 保留蓝色语义)。若公司要求「WanChat 蓝」出现在主操作上,本方案不适用。
  2. --input 提到 3:1(#9c8b64)在浅色下是一道明显的暖描边,输入框会比现状「更重」;若追求极致轻盈,可回退到 #b9a882(2.30:1)但必须标注为不达标。
  3. 暖色画布 #faf5e8 在 1440×900 上全屏铺开会比 #fcfcfc 明显「有色」,对「绝对中性」有偏好的团队会不适。
  4. 彩色集中在状态标签上,不做大面积色块,因此不像参考官网那样「章节感强烈」——这是刻意的高密度工具取舍。

什么场景下不适用