暖笺工作台(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),本方案诚实标注而不假装已实现。
参考提炼
- 参考风格名:Airtable — warm workshop with color-coded chapters;slug
airtable;来源站点airtable.com;theme light。 - 提炼的 5 条可迁移规则(均来自其 DESIGN.md 原文要点):
- 「Use Parchment Cream (#faf5e8) as the base canvas — never pure #ffffff for full-page backgrounds」→ 页面画布必须是有色调的暖底,纯白只用于卡片层。迁移为
--background:#faf5e8、--card:#fffdf8。 - 「Anchor interactive elements with Onyx (#181d26) rather than a brand-colored fill」「Don't use a brand-blue or chromatic color for CTA buttons」→ 主操作=暖墨黑,蓝只作低频强调。迁移为
--brand:#1f1a14/--mention:#1b5fc4。 - 「Give each major use case section its own saturated color identity」→ 多色身份系统,每个「章节」一个色。迁移为
--chart-1..5承载任务状态色码(这是本项目最需要颜色纪律的地方)。 - 圆角纪律「buttons 12px / cards 16px / tags 32px,Don't use sharp corners, minimum 12px」→ 迁移为
--radius:0.75rem(12px),--radius-xl≈16.8px承接卡片 16px 档。 - 「Don't mix more than 2 text weights in a single body paragraph」+ 克制字重(400/500/600)→ 迁移为正文只用 400/500,标题 600,禁止无限字重堆叠。
- 「Use Parchment Cream (#faf5e8) as the base canvas — never pure #ffffff for full-page backgrounds」→ 页面画布必须是有色调的暖底,纯白只用于卡片层。迁移为
- 必须舍弃:48px 展示字号、900 字重展示衬线面(Haas Groot Disp,本项目
--font-heading: var(--font-sans)无独立展示面,且中文 48px 在高密度列表里是灾难);8px 舒适节奏与 64px 段间距(消息流需要更紧的 4/8/12 节奏);1200px 居中营销栅格、hero 大图、滚动叙事;#faf5e8直接铺满消息正文区(暖底大面积会使 15px 中文长文本降低长时间可读性,故画布与内容卡片分成两层)。
适配判断
为什么适合「任务 + 频道消息」的企业工具:
- 暖沙底色天然降低长时间驻留的视觉疲劳。现状
--background:#fcfcfc与--sidebar:#fcfcfc完全相同(简报 §3.3 实测:aside背景#fcfcfc、border-radius 14px,与页面底零层级对比),侧栏靠一条 14px 圆角浮起来,属于「用圆角代替层级」。暖纸三层(画布#faf5e8/ 侧栏#f2ebda/ 卡片#fffdf8)用明度差建立层级,比再多加阴影更稳。 - Onyx 黑主按钮解决了「三种蓝并存」。现状令牌
--brand:#2563eb、硬编码#006ce7(message-list.tsx、composer-markdown.ts、voice-channel-history-dialog.tsx)、--mention:#3370ff(chat-mention.ts硬编码#3370FF)三方打架。把主操作从蓝移到墨黑后,蓝色只剩一个明确语义(@ 提及/链接 = Cobalt#1b5fc4),冗余的品牌蓝冲突被结构性消除。 - 色码章节系统正是任务状态所需。现状任务卡只有标题 14px/500 + 频道 chip +
AI 助手chip(简报 §3.3),6 个状态(待补充/待处理/进行中/待验收/已完成/已关闭)没有视觉色码。Airtable 的多色身份系统在这里的落地形态就是状态色,而且是唯一应该用彩色的地方——颜色集中在标签上,符合「多彩但克制」。 - 与中文排版不冲突:Airtable 的正文字号(16–18px)在高密度中文列表里过大,舍弃;保留现有 15px/1.375 正文基线(满足简报 §2 第 4 条 14–15px、行高 ≥1.375)。
明确舍弃项:展示衬线字体与 900 字重、48px 展示字号、营销页栅格与 hero、8px 基础节奏、纯色大面积饱和色块(彩色只允许出现在徽标/图表/左侧 3px 状态条上,不允许铺满卡片背景)。
令牌映射
全部变量名取自
web/src/styles.css现有声明(:root108 行起 /.dark153 行起),未新增任何令牌名,故@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、代码 | 混合 | 途径外 |
中文长文本与数字注意点:
- 只允许 400/500/600 三档字重(参考「≤2 字重/段」纪律的中文化),现状
12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724四档并存的密集视图(简报 §3.3 S4 实测)应收敛为 13px/500(标签)与 15px/400(正文)。 - 中文字号下限 12px;现状存在 9px / 9.375px / 11px / 11.25px 档位,全部属违规,需逐处提升(风险 R4)。
- 中文不做正字距(参考的 0.005–0.02em 只针对西文大字号),避免中文字间发虚。
- 数字/金额/任务 ID 用
--font-mono,避免中文黑体下的等宽抖动。
关键界面改造
每条标注落点:① 语义令牌取值 / ② 官方 variant·size / ③ 容器布局·间距·滚动。
S1 外壳 + 空间/频道侧栏(app-shell.tsx L12126 h-full w-64 …、channel-sidebar.tsx)
- 现状:
nav72×900 背景transparent、右边框rgba(220,222,225,0.55)(≠ 令牌--border #dcdee1);aside256×715 @x=76border-radius 14px、背景#fcfcfc与页面底完全相同;搜索框 30px 高、圆角 10px、底rgba(235,238,239,0.75);侧栏头部 52px。 - 改后:①
--sidebar:#f2ebda比画布#faf5e8暗一档 → 侧栏不靠 14px 圆角而是靠明度差成立;--surface-rail:#ece3cd+--workspace-background暖渐变让 72px rail 成一条暖沙竖带。③ 侧栏容器由w-64(256px)保持,但移除 14px 外圆角带来的「浮岛感」改由令牌分层承担(圆角属 className,风险 R3b,见 §8);rail 图标按钮保持 71×48 但间距由令牌无关的gap控制 → 保持不动。 - 组件:
Button variant="ghost" size="icon"(rail 项)、Input(搜索框,高度由官方h-8=32px 决定,现状 30px 属自定义 → 收敛到 32px)、Separator(分组线)。 - 层级/态:连接态
已连接/连接中/重连中/已断开/连接失败用Badge variant="outline"(常态)与variant="destructive"(断开/失败)。
S2 频道消息流(message-list.tsx、channel-thread.tsx、channel-header.tsx、channel-tabs.tsx)
- 现状:气泡圆角 14px;他人
rgb(235,237,239)(=--accent)、自己rgb(232,243,254)(=--message-self);同一列表两套字号:他人 15px/400#060607,自己 14px/400#0d274a;作者 13px/400、时间 12px/500#5c5e66;输入区textarea628×33 无边框,工具按钮 28×28。 - 改后:① 他人气泡 =
--accent #ece4d1、自己气泡 =--message-self #fbe3cd,两色明度都低于卡片#fffdf8,形成「纸面/桃色便签」层级;--mention #1b5fc4让 @ 提及成为全屏唯一蓝色,--surface-chat-soft #f7f0dd给引用块。② 时间戳/成员数用Badge variant="ghost" size语义;表情与更多操作用Button variant="ghost" size="icon-xs"(24px,收掉现状 28px 自定义按钮)。③ 消息行padding: 6px 0、气泡padding: 8px 12px、圆角由 14px 归到calc(var(--radius) * 1.17) ≈ 14px(保持观感但值来自令牌);输入区外层由「只有上边框」改为--card底面 +--radius圆角 +--border描边(令牌承担,容器 padding 归 ③)。 - 状态色:本条不改字号(属风险 R4),但他人/自己字号统一到 15px是必须的修法,写入 §9 验证项。
- 组件:
Button(ghost/outline、size="icon-xs"|"sm")、Badge(ghost/outline)、Separator、Avatar(size="sm")、Textarea(官方组件,无边样式)。
S3 任务大厅 + 任务卡(task-hall.tsx L1183 TaskHallCard、L1215 卡片容器、group-hall.tsx)
- 现状:卡片
rounded-2xl border border-l-[3px] border-border bg-white shadow-e1(bg-white硬编码,绕过--card);圆角实测 10px×48 与 8px×37 两套混用;列头「待补充 0 / 待处理 5」;群聊大厅是营销式 hero + 品牌蓝 20 处。 - 改后:① 卡片底色改用
--card #fffdf8(令牌驱动,深色可翻转);左侧 3px 状态条色取自--chart-*(待处理--chart-4 #8a6100、进行中--chart-1 #1b61c9、待验收--chart-2 #b4441f、已完成--chart-3 #2f6b3a、已关闭/风险--chart-5 #9a5280、待补充--muted-foreground)——这是「多彩但克制」的落点:颜色只在 3px 条与徽标上出现,卡片底始终是纸白。② 状态徽标改用官方Badge variant="outline"(底色为bg-{chart}/12%属自定义 → 改用variant="outline"+variant="secondary"轮换,避免新增变体;见 §8 说明)。③ 列容器grid列宽与卡片padding归位到 12px/14px;圆角统一到--radius-2xl(≈21.6px,替代 8px/10px 混用);群聊大厅的 hero 段落降级为普通h1 16px/600+ 一行说明(属容器布局改动)。 - 组件:
Badge(outline/secondary/default)、Button(default 主操作「新建任务」、outline 次操作「查看任务」、ghost 行内)、Tabs(variant="default"承载「全部频道/待处理/待补充」筛选)、Avatar size="sm"、Separator。
S4 AI 助手频道(agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx、channel-summary-panel.tsx)
- 现状:单视图最密集页(395 项任务),一次渲染内 4 档字号(
12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724),圆角8px ×1591、10px ×844。 - 改后:① 结果卡片底
--card、引用来源底--surface-chat-soft #f7f0dd、AI 强调色沿用--brand(深色下自动反相为暖白,保证 AI 区块在深浅两态都有明确「非人」身份);--mention用于回答中的引用锚点。② 结果卡片外层用官方Card,内部行用Item/ItemContent(app-center.tsxL1198 已在用,属已采纳的官方模式);密度由Badge variant="secondary"承载状态。③ 4 档字号收敛到 2 档(13px 标签 + 15px 正文)属组件类改动(风险 R4),令牌层只负责把--brand-soft从蓝水洗降到墨水洗,减少大片高亮块的视觉噪声。
S5 管理与设置弹窗(space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx、channel-permission-picker.tsx)
- 现状:
[role=dialog]704×512、圆角 18px、底#ffffff;左侧导航项 135×36 圆角 8px;选中态底--brand-soft+ 前景--brand-ink;危险项前景--destructive #da373c;输入框 488×32 圆角 10px;表单标签 14px。 - 改后:① 弹窗底由
#ffffff归到--popover #fffdf8(暖白,深色下自动变#262117);选中态--brand-soft(墨色 8%) +--brand-ink #1f1a14,深色下自动反相为暖白水洗 + 暖白字,同一处样式两态均达标;危险项--destructive #9e2b16。② 导航项统一到Button variant="ghost"+Tabs variant="line"的官方尺寸节奏(去掉 135×36 自定义块,改用官方h-8/h-7)。③ 弹窗 704×512 尺寸、表单gap与padding归到 12/16 节奏(现状 488×32 输入框 → 官方Input h-832px,一致)。圆角 18px→--radius-2xl(≈21.6px)属 className 改动(风险 R3b)。
S7 登录页(web/src/routes/login.tsx、sign-in.$.tsx)
- 现状:居中卡片;主标题 26px;「邮箱验证码/短信验证码」切换块 173×42(选中态底
--background #fcfcfc+ 品牌蓝文字);主按钮 356×52、白字、底#2563eb;页脚 11px。文案「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」。 - 改后:① 页面底
--background #faf5e8(暖纸),卡片底--card #fffdf8—— 登录页是「暖纸」气氛最强的入口,也是与飞书最直观的差异点;主按钮Button variant="default"由蓝变暖墨黑#1f1a14(白字 16.56:1,参考「CTA 用 Onyx 不用品牌蓝」纪律);切换块选中态底改--brand-soft(墨色 8%)+ 前景--brand-ink,替掉现状「选中=页面底色」的弱对比。② 切换块用Tabs(官方,选中态由 Tabs 的data-[selected]承担);主按钮用size="lg"(官方 36px 高的 lg;现状 356×52 是自定义尺寸 → 收敛到官方尺寸 + 容器max-w控制宽度,宽度归 ③)。③ 卡片padding24px、表单gap12px、页脚 12px(现状 11px 低于中文下限)。主标题 26px→20px 属组件类(风险 R4)。
S8 应用中心(app-center.tsx、assistant-board.tsx)
- 现状:分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」;卡片用
运行中/开发中徽标 + emoji 图标(app-center.tsxL529text-4xl leading-none)+Agent · 第三方 · chat元信息;警告条border-amber-200 bg-amber-50 text-amber-800(Tailwind 原始调色板,深色不翻转)。 - 改后:① 警告条改
--chart-4 #8a6100系(暖琥珀),卡片底--card,运行中用--chart-3 #2f6b3a、开发中用--chart-4、异常用--chart-5—— 全部走令牌,深色自动提亮(#e0b356等)。② 徽标统一Badge variant="secondary"|"outline";卡片沿用已存在的官方Item/ItemContent/ItemMedia组合(L1189–1215)。③ 图标位由 emoji(text-4xl)换成 lucide 线性图标(--channel-icon色)—— 属 markup 改动(风险 R5),但这是简报 §3.3 点名的「视觉一致性明显缺口」,建议优先批准;分类筛选用Tabs variant="line"承载,去掉「全部 / 已加入 / 未加入」三段式按钮组的自定义外观。
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 兼容性
- 只靠官方组件与 variant 可以达成主目标:
Button(default/outline/secondary/ghost/destructive/link × xs/sm/default/lg/icon/icon-xs/icon-sm/icon-lg)、Badge(default/secondary/destructive/outline/ghost/link)、Input、Textarea、Tabs(default/line)、Avatar(default/sm/lg)、Separator、Card、Item/ItemContent/ItemMedia、Dialog、DropdownMenu、Checkbox、RadioGroup、Select、Popover—— 均已存在于web/src/components/ui/(38 个官方组件,components.json用base-nova、iconLibrary: lucide),无需引入任何尚未安装的组件。 - 天然受益的机制:base-nova 的
Button variant="default"取bg-primary text-primary-foreground、Badge default取bg-primary text-primary-foreground、focus-visible:ring-ring取--ring—— 把--brand从蓝改黑(深色改暖白)后,全站主操作与焦点环自动、一致地换风格,零 class 改动。 - 不合规处(必须显式标注):
| 编号 | 位置 | 问题 | 标记 |
|---|---|---|---|
| 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 附近,仍属暖色系) |
实施成本
- 改动面
- ① 令牌(唯一必需改动):
web/src/styles.css——:root块(108 行起,约 45 行)+.dark块(153 行起,约 40 行)。@theme inline、@utility、@layer base零改动。 - ② 官方 variant/size 调整:
task-hall.tsx、app-center.tsx、channel-sidebar.tsx、space-manage-dialog.tsx、routes/login.tsx(徽标/按钮/筛选控件换官方变体)。 - ③ 容器布局:
app-shell.tsx(L12126 侧栏列)、message-list.tsx(消息行与输入区 padding)、task-hall.tsx(L353/L487 网格与列)、login.tsx(表单gap/max-w)。
- ① 令牌(唯一必需改动):
- 预估人时(单人熟悉代码库):令牌层 0.5 天(含深浅双态目检);②③ 逐面调整 2.5 天(7 个样例面);R1–R7 例外项 1.5 天(主要是 R2 的 253 处替换与 R4 的字号收敛);合计 ≈4.5 人日。若只做令牌层(不含 R1–R7),0.5 人日即可看到主色/画布/层级/圆角/状态色的全部改观。
- 风险清单:R1 深色不可达(阻塞项,无此项深色方案无法验证);R2/R6 令牌泄漏导致「改了令牌却看不见效果」的预期落差;R3b 圆角不统一仍会残留 8/10/14/18px 四档;R4 字号下限违规残留;R7 深色输入框观感待目检。
- 验证方式(可证明改动生效的最小检查集):
getComputedStyle(document.documentElement).getPropertyValue('--background')→ 期望#faf5e8;.dark下 →#17140f。- 抓
aside与body的background-color,期望#f2ebda≠#faf5e8(现状两者都是#fcfcfc,这是「层级已建立」的判据)。 - 抓主按钮的
background-color,浅色期望rgb(31,26,20)、深色期望rgb(240,230,210);同时抓--brand-ink应用处的前景,确认不再出现#1d4ed8。 - 用 §7 表中任一组合做一次 devtools 对比度抽查(正文/画布 = 15.83:1)。
- 令牌泄漏复查重跑:
leaks-*.json中的rgb(6,6,7)计数值应由 55 下降(R2 完成后)。
取舍
解决了什么
- 侧栏与画布「零层级」(现状两者同为
#fcfcfc)——用暖纸三层一次性解决,且不依赖阴影或自定义圆角。 - 三种蓝并存的结构性混乱——主操作移到墨黑后,蓝只剩「@ 提及/链接」一个语义(
#1b5fc4)。 - 任务状态无色码——
--chart-1..5把 6 个状态(待补充/待处理/进行中/待验收/已完成/已关闭)落成可辨认、深浅两态都 ≥5.31:1 的色码。 - 深色
--surface-rail:#e3e5e8的浅色竖带硬伤、--ink在深色下仍是深蓝的错配。 - 冷灰调(
#ebedef/#f2f3f5/#dcdee1/#5c5e66)整体暖化,与「OPC 行业一线人员」的工作台气质一致。
牺牲了什么
- 不是纯粹的品牌表达:主按钮从蓝变黑,品牌蓝在界面上几乎消失(仅
--mention保留蓝色语义)。若公司要求「WanChat 蓝」出现在主操作上,本方案不适用。 --input提到 3:1(#9c8b64)在浅色下是一道明显的暖描边,输入框会比现状「更重」;若追求极致轻盈,可回退到#b9a882(2.30:1)但必须标注为不达标。- 暖色画布
#faf5e8在 1440×900 上全屏铺开会比#fcfcfc明显「有色」,对「绝对中性」有偏好的团队会不适。 - 彩色集中在状态标签上,不做大面积色块,因此不像参考官网那样「章节感强烈」——这是刻意的高密度工具取舍。
什么场景下不适用
- 若产品未来要做深色优先(如运维夜班场景占主导),本方案浅色优先的暖纸底需要重新配一组暖墨夜色值,且必须先解决 R1(
.dark不可达)。 - 若要求所有界面元素严格中性灰(例如需要与第三方白标系统拼装),暖色相会成为干扰。
- 若决定彻底照抄 Airtable 官网的多色大色块章节,消息流会因大面积饱和色降低长时段可读性——本方案明确不做。