暖纸工作台
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),使「暖」这一材质属性两套都在。
参考提炼
- 风格名:Notion(
notion),来源站点notion.so官网,theme =light。 - 一句话气质原文:“a well-loved paper notebook under afternoon light: a warm off-white canvas (#f6f5f4) that feels tactile rather than clinical”。
可迁移规则(5 条,均引用其原文要点):
- 表面栈不可倒置:“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 两阶,形成四级栈。 - 用发丝边界代替阴影:“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);内容卡一律靠边界+底色分层。 - 单一彩色承诺:“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。 - 用一个墨色 + 透明度梯度做层级:“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% 文本层级。 - 平涂、禁止渐变:“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(...)全部改平涂。 - 圆角两档制:“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)。纯白
#ffffff画布在 1440×900 满屏时眩光明显;#f6f5f4把画布亮度从 1.000 降到 0.914(相对亮度),正文对比从 17.7:1 降到 16.28:1,仍远高于 4.5:1,但主观疲劳显著降低。这是「任务清单盯一天」而不是「看一次落地页」的场景,暖底收益被放大。 - 密度不靠压缩、靠边界:消息流 + 任务卡在同一个屏里并存。Notion 的「白卡贴在暖底上、1px 发丝分隔、零阴影」正好给出不增加视觉噪声的分层手段——现有
--shadow-e2/e3在 24px 行距的列表里会互相叠加成灰雾。 - 颜色即状态:「待补充 / 待处理 / 进行中 / 待验收 / 已完成 / 已关闭」6 个状态需要一眼分辨。把唯一的彩色承诺(品牌蓝)留给「进行中」,危险红只给风险/逾期,其余状态走灰阶 Badge variant——色彩信息量变成 2 bit,扫视成本最低。现状的 253 处 Tailwind 原始调色板(amber 69 / rose 68 / slate 44 …)恰恰是「颜色不值钱」的反例。
- 中文优先的层级:Notion 用同一墨色的 alpha 梯度做层级,不依赖字号差异。这对中文尤其友好——中文在 12–15px 区间字号拉开 1px 会产生「同一个列表两套字号」的破碎感(现状实测:他人 15px/400 与自己 14px/400 同列表并存)。
- 深浅同源:暖纸 ↔ 暖炭是同一色相的明暗两端,两套令牌可以共用一份对比度矩阵,而不是各自调一遍。
明确舍弃项(不可照搬):
| 舍弃 | 原因 |
|---|---|
| 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 |
- 收敛目标:现状单视图实测 10 档(9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26 px),其中 9–11.25px 三档来自以 15px 为基准的 em 计算。本方案的可达边界是 6 档(12 / 12.8 / 13 / 14 / 15 / 16 / 26 中的 6 个角色),但把 11.25px 这类档位拉回 12px 需要改
className,属于硬约束 2 之外的改动,见 §8 风险 b。本方案不通过令牌伪造字号(styles.css里没有--text-*变量,也不允许新增变量名)。 - 中文长文本注意点:① 不做负字距(参考的
-0.036em@42px等不迁移),中文没有可压缩的字间冗余;② 中文行高下限 1.375,消息正文用 1.5 更稳(15×1.5=22.5px,一行 5 个汉字的密度仍可读);③ 中英混排时不要用等宽字体包住整句(「@吴十 日报补录 & 次日未填提示」这种句子里的@与&由--mention与正文色承担,只有纯数字/ID 走--font-mono);④ 12px 是中文最小可用字号,Badge的text-xs正好压在线上,不允许再往 11px 走。 - 数字对齐:任务计数(
5 项任务、0 人已读、183 行)与时间戳(09:24)落在右对齐列时用--font-mono或tabular-nums,避免等宽抖动。
关键界面改造
以下每条都用 ①令牌 / ②官方 variant·size / ③容器布局 标注实现途径。
S1 应用外壳 + 空间/频道侧栏(app-shell.tsx、channel-sidebar.tsx)
- 现状 → 改后:
nav72×900 背景transparent、右边框rgba(220,222,225,0.55)(≠--border #dcdee1,两个不同源的值)→ ①--surface-rail从#e1e8f2改#e6e3dd,rail 不再透出画布色;② rail 右侧分隔线统一由--border(rgb(25 24 23/0.12))承担,消掉 0.55 alpha 的旁路值。 - 现状 → 改后:会话侧栏
aside256×715 @x=76、border-radius 14px、background #fcfcfc=画布色,零层级对比 → ①--sidebar改#eeece8(对画布 1.084:1)、--sidebar-border改暖墨 10% alpha;② 会话行选中/hover 由官方--sidebar-accent(#e2ded8)承担,不再让选中底与画布同色;③ 保留 256px 宽与 64px 行高(密度不变),头部仍 52px。 - 搜索框:现状 30px 高、圆角 10px、背景
rgba(235,238,239,0.75)→ ① 底色改--muted #f1eeea(不再用带 alpha 的冷灰);圆角随--radius变 4.8px(rounded-sm)或 8px(rounded-lg),由组件现有类决定。 - 语音频道区:现在 rail/侧栏已渲染「语音频道」分组容器,但
TRTC_ENABLED=false下界面一个语音元素都不渲染(简报 §3.3:aria-label匹配「语音|通话|加入」命中 0)。改造只做 ① 令牌(分组标题用--muted-foreground,在线态圆点用--brand),不做任何 RTC 相关渲染假设。
S2 频道消息流(message-list.tsx、channel-thread.tsx、channel-header.tsx、channel-tabs.tsx)
- 气泡配色:他人
rgb(235,237,239)(=--accent)与自身rgb(232,243,254)(=--message-self)在浅色下相差 1.034:1,几乎同色。改后:他人气泡走Bubble variant="secondary"→--secondary #e9e5df(暖灰,对画布 1.152:1);自身走variant="default"+ 本地覆盖--message-self #d9e9fc(色相蓝,与暖灰彻底分家)。→ ①(--secondary/--message-self取值)+ ②(message-bubble.tsx已用variant="default"/"secondary",不需要新 variant)。 - 气泡圆角:14px → ①
--radius 0.5rem⇒rounded-xl= 11.2px,向参考「cards 12px」靠拢。 - 引用块:现状引用号用边框实现 → ②(可选增强) 把引用容器切到官方
Bubble variant="tinted"(该 variant 由--primary派生oklch(from var(--primary) 0.93 calc(c*0.4) h),会随--brand自动变色);若不改组件,则 ①--surface-chat-soft #eef5fc承担引用底。 - @提及:
chat-mention.ts硬编码#3370FF(第三种蓝)→ ①--mention #0057b0,在--surface-chat-soft上 6.39:1。 - 频道头:860×52、标题 16px/600、成员数 12px/500 → ③ 保持 52px 高;① 成员数走
--muted-foreground(6.53:1);② 头部右侧动作按钮从 32px 高改size="sm"(28px),让 52px 头里留出 12px 呼吸。 - 输入区:
textarea628×33 无边框、外层只有上边框rgb(220,222,225)→ ① 该上边框统一为--border;② 发送按钮用variant="default" size="sm",工具按钮(Aa等 28×28)保持size="icon-sm"。 - 密度:保持现状消息行距(作者行 + 气泡 + 悬停动作行),不引入参考的 24px 卡片内边距——那会让 1554 条消息的滚动成本翻倍。
S3 任务大厅 + 任务卡(task-hall.tsx、group-hall.tsx、create-task-dialog.tsx、channel-work-items.tsx)
圆角混用:实测同屏圆角
10px×48+8px×37两套 → ①--radius 0.5rem让两档变为8px(rounded-lg= 卡片/按钮)与6.4px(rounded-md= chip),二者由同一刻度派生,视觉上不再「两套体系」。状态色映射(6 个业务状态 → 官方 Badge variant,全部为 ②):
业务状态 Badge variant 落地颜色(浅色) 对比 进行中 default--brand #006bce填充 + 白字5.26:1 待验收 secondary--secondary #e9e5df+--secondary-foreground14.13:1 待处理 / 待补充 outline边框 --border+--foreground16.28:1 已完成 / 已关闭 ghost无底 + --muted-foreground5.99:1 风险 / 逾期 destructive--destructive #b32518on/105.13:1 深色对等:
default用--brand #2f95ff+--brand-foreground #06121f(6.16:1)、destructive用#ff8a7don/20(4.63:1 on card)。任务卡结构:标题 14px/500 + 频道 chip +
AI 助手chip + 负责人头像 → ③ 卡片网格改grid-template-columns: repeat(3, minmax(0,1fr))、gap:10px、卡内padding:10px 12px;② 「查看任务」用variant="outline" size="sm",负责人头像用官方Avatar(size由sm控制到 24px)。群聊大厅(
group-hall.tsx):现状是营销式 hero 段落 + 筛选 + 群卡片,品牌蓝单面出现 20 处 → ③ 删掉 hero 段落,改成与任务大厅同构的「筛选条 + 卡片网格」;② 「全部群聊 / 全部 / 已加入 / 未加入」改用官方Tabs variant="line"(现状是自建按钮组);20 处品牌蓝收敛为「每屏 1 个填充动作」,其余走outline/ghost,这正是参考第 3 条规则。建任务弹窗:①② 表单标签 14px 保持;输入框
Input/Textarea官方尺寸;圆角 10px→8px(--radius)。
S4 AI 助手频道(agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx、channel-summary-panel.tsx)
- 现状 → 改后:AI 助手空间是全站最密集视图(395 项任务),一次渲染里字号
12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724,圆角8px ×1591、10px ×844→ ① 两套圆角收敛为由--radius派生的 8px / 6.4px;② 结果卡片改用官方Card(现状是裸div+ 裸border),来源引用条用Badge variant="outline"+--muted-foreground;「AI 助手」标记底用--brand-soft #e6f3fe,与任务状态色互不抢占。 - 流式回答等待态:沿用
--animate-breathe(1.2s 呼吸),不新增动效令牌。 - 来源引用块:用 ①
--surface-chat-soft #eef5fc作底,链接用--brand-ink #005cba(5.75:1 on 浅蓝底)。 - 密度:③ 消息列 + 右侧
channel-summary-panel用grid-cols-[minmax(0,1fr)_320px],在 1440px 宽度下消息列仍有 ≥860px(与现状频道头 860px 一致),避免密集视图在双栏后压缩到 12.8px 级字号。
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(原rgb(37 99 235/0.12)) +--brand-ink(#1d4ed8),危险项--destructive #da373c→ ①--brand-soft改#e6f3fe、--brand-ink改#005cba(配 5.75:1)、--destructive改#b32518(在/10底上 5.13:1);圆角 18px → 14.4px(rounded-2xl= 1.8×8px),导航项 8px 不变(rounded-lg=8px)。 - 控件:输入框 488×32 圆角 10px→8px(①);② 左侧导航项用
Button variant="ghost"的选中态(或保留自建列表,仅靠令牌改色)——注意:官方Tabs variant="vertical"也可实现该左导航,但它会改变语义(设置项 ≠ 页签),本方案不推荐,仅在 §8 列为可选项。 - 危险操作:删除频道等用 ②
Button variant="destructive" size="sm",前景--destructive,与 Badge 状态色同源。 - 表单标签 14px 保持(中文可读)。
S7 登录页(web/src/routes/login.tsx、sign-in.$.tsx)
- 现状 → 改后:居中卡片、主标题 26px;「邮箱验证码 / 短信验证码」切换块 173×42(选中态背景
--background #fcfcfc+ 品牌蓝文字);主按钮 356×52 白字#2563eb;页脚 11px。 - 主按钮:①
--brand从#2563eb改#006bce(白字 5.26:1,现状#2563eb白字 5.17:1,对比略升而色相回到参考蓝);③ 356×52 的按钮高度官方size="lg"上限是 36px(h-9)——若坚持 52px 就需要 className 覆盖,属不合规,因此本方案主张:按钮改size="lg"(36px)+ 外层w-full容器,用卡片上下留白补回视觉重量。 - 切换块:选中态用
--background与画布同色(现状 173×42 选中底=#fcfcfc=画布),在暖纸方案里这个值变成#f6f5f4,与未选中态差异仅 1.06:1,不可辨 → ① 让未选中项走--muted #f1eeea、选中项走--card #ffffff,形成 1.089:1 的白卡抬升(这一条依赖该分段控件本身用--card作选中底;若它写死bg-background,则见 §8 风险 c)。 - 登录卡片:①
--card #ffffff贴在--background #f6f5f4上(1.089:1),配--borderhairline,不用阴影。 - 页脚 11px:低于中文 12px 下限 → 见 §8 风险 e。
S8 应用中心(app-center.tsx、assistant-board.tsx)
- 现状 → 改后:分类筛选 8 类(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」+ 卡片(
运行中/开发中徽标、emoji 图标、Agent · 第三方 · chat元信息)。 - 徽标:②
运行中→Badge variant="default"(品牌蓝填充,全屏唯一填充色);开发中→Badge variant="outline";元信息Agent · 第三方 · chat用--muted-foreground(6.53:1)。 - 图标:emoji 是「视觉一致性的明显缺口」(简报 §3.3 原文)。② 改用
lucide图标——web/components.json已配"iconLibrary": "lucide",官方Button/Badge的[&_svg]尺寸规则也已就位,无需引入新库。这条同时是唯一一处会被外部审计质疑的「视觉元素替换」,但它属于 ②「官方 variant/图标的选择」,不引入自定义样式。 - 布局:③ 卡片网格
grid-cols-4、gap:12px,卡片内padding:12px;筛选条用官方Tabs variant="line"。
深浅色与对比度
全部比值按 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 人时 |
风险清单
--radius0.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 会出现视觉降级,需在回归里逐个检查。--border从实色改 alpha 后,任何把--border当实色用的地方(如blueprint网格背景)在深色下会变成半透明白线——恰好是正确的(现状深色下 blueprint 网格是深灰实色,改变后会更清晰)。--input从#dcdee1提到#8f8880是本方案视觉变化最「重」的一处(1.35:1 → 3.21:1)。如果不接受虚拟边框变深,退路是保留#dcdee1并显式承认输入框边界不满足 3:1(风险 h 同类)。--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 个样例面重跑,断言:
getComputedStyle(document.documentElement).getPropertyValue('--background')===#f6f5f4,--card===#ffffff。- 侧栏层级:
aside背景 ≠body背景(现状两者都是#fcfcfc,比值 1.000);新值应为#eeece8vs#f6f5f4(1.084:1)。 - 圆角档位集合:全站
border-radius去重集合应 ⊆{4.8, 6.4, 8, 11.2, 14.4, 17.6, 20.8, 9999}px,且不再出现7px与12px两个无来源档位。 - 对比度回归:对
.textlines.json里每条可视文本,用其 color 与最近祖先背景色算比值,断言正文 ≥4.5、图形边界 ≥3。 - 深色注入:手动加
.dark后,--surface-rail计算结果应为#161514(现状为浅色#e3e5e8,rail 是浅色竖带);同时统计rgb(6,6,7)命中数应从 55 下降(不会归零,用于区分「令牌侧已修」与「className 侧未修」)。 - 渐变归零:
getComputedStyle中background-image不再包含gradient((--workspace-background与--workspace-header-background已改平涂)。
取舍
解决了什么
- 修掉了 3 个可复算的层级缺陷:侧栏与画布零对比(1.000 → 1.084)、深色 rail 浅色竖带(
#e3e5e8→#161514)、两套圆角体系(10px/8px 混用 → 同一刻度派生)。这三条都不是「更清爽」,而是实测到的具体故障。 - 把色彩信息量从「4 种蓝 + 253 处调色板」压到「1 个填充色 + 2 bit 状态」:品牌蓝唯一填充(每屏 1 处),危险红只给风险,其余状态走灰阶。6 个任务状态在一眼扫视里可分辨。
- 把「颜色靠字重/透明度而不是字号」这条参考规则搬进中文界面:正文 15px 一档到底,层级靠
#191817/#615d59两档暖灰 + 字重,避免中文在 12–15px 之间拉出小数字号。 - 对比度全部有实测值:正文 16.28:1(浅)/14.53:1(深),次级 5.99/6.66,图形边界 3.21/3.34,25 组组合逐条列出。品牌蓝从参考原值
#0075de加深到#006bce就是为了让「brand 作文字」也过 4.5(4.19 → 4.83)。 - 深浅同源:两套共用一份 4 级表面栈与一致的圆角刻度,深色不需要单独调参。
牺牲了什么
- 放弃了参考最出彩的「多彩贴纸卡」:
#ffb110/#f64932/#62aef0/#02093a轮转的背景色不迁移。代价是方案「不那么像 Notion」,收益是任务状态色不被抢戏。这是一次刻意的品牌辨识度换功能清晰度。 - 界面会变「轻」:去除阴影 + 圆角整体缩小(10→8、14→11.2、18→14.4px)+ 边界变细,在高密度列表里容错变小——两行 64px 的会话行之间只靠 1.282:1 的 hairline 与 1.084:1 的底色差分区。在低质量显示器/投影上,浅色模式的层级会比现状弱。
- 输入框变重:
--input提到#8f8880是为满足 3:1 图形对比,视觉上比现状的#dcdee1明显更深,是「合规换美学」的净损失。 - 弹窗圆角 14.4px 偏离参考的 12px 上限(风险 d),换来按钮精确 8px。
- 效果上限受 253 处硬编码调色板拖累:令牌侧改完,全站最刺眼的「5 组 Tailwind 硬编码头像底色」与「3 种蓝并存」中的 2 处仍不会消失,本方案无法覆盖。
什么场景下不适用
- 纯数字看板/图表密集页:暖纸底会削弱
chart-1..5暖灰阶的可分辨度(暖灰阶两端#d9d4cc与#4a453e明度差 0.55,比原冷灰阶窄);若产品后续要做 BI 大屏,需要为图表另配一组非暖中性色阶。 - 需要强色彩编码的场景:如果产品决定给「6 个任务状态」各配一种颜色(现状 253 处泄漏的实质诱因),本方案的「单一彩色承诺」会成为约束而不是优势。
- 移动端小屏强光直射(户外一线巡检):暖纸底在强光下比纯白更暖也更暗,
#f6f5f4的相对亮度 0.914 只比白低 8.6%,影响有限;但若实测在强光下不可读,应回退到#fbfbfa(保留一点点暖,接近现状)。