Hex · 羊皮纸与紫墨 —— WanChat /app 重设计方案
参考风格:Hex(slug
hex,来源站点 hex.tech,theme = light) 交付目录:docs/design-proposals/hex/|三文件:proposal.md、tokens.css、preview.html基线:test@3d35969f,实测环境 1440×900、真实数据(580 用户 / 30 空间 / 148 频道 / 1554 消息 / 457 任务)
方案名与主张
中文方案名:羊皮纸紫墨(6 字)
一句话主张: 把整站从「冷蓝灰、近白、纯黑文字」的通用 SaaS 底色,换成暖羊皮纸画布 + 紫墨文字 + 单一暮紫品牌色的「研究笔记簿」气质;标题交给中文衬线(宋体系)承担文学性,正文交给无衬线承担数据密度,任务与消息列表一律压到 12/13/14.5px 三档刻度,用骨架与层级而不是装饰色来表达状态。
适用基调:浅色优先(浅色是产品的唯一可达主题,也是本方案的主战场);深色对等补齐(实测全仓 web/src 无任何代码添加 .dark,<html> class 恒为空 → 深色在生产不可达,本方案把它从「半不可读」修成「可交付」,见 §7)。
参考提炼
参考风格:Hex|slug hex|来源 hex.tech|theme light|一句话定位:alchemy lab on cream parchment — literary serif headline over dense data notebook(羊皮纸上的炼金实验室:文学性衬线标题悬在密集数据笔记簿之上)。
从 Hex 的 DESIGN.md 提炼出 5 条可迁移规则(引用其原文要点):
| # | Hex 原文要点 | 本方案的可迁移做法 |
|---|---|---|
| R1 | "Set the page background to #fffcfc (warm near-white), not #ffffff. The cream cast ties the canvas to the violet ink." |
画布 --background 由 #fcfcfc 改 #fffcfc,卡片保持纯白 #ffffff,形成「纸上有纸」而非靠阴影堆层级 |
| R2 | "Don't use pure black (#000000) for body text or shadows. Use #01011b… the violet undertone is what makes the system feel in-brand." |
正文由 #060607 改 #01011b(Ink Violet),灰阶令牌全部换成带紫调的对应值 |
| R3 | "Never fill a CTA with brand color — the restraint is the brand." + "Don't use large border-radii (12px+) on cards or buttons. 3px and 6px are the system." | 品牌紫只用于焦点环、选中态、单个主行动与 @提及;圆角基准由 10px 降到 6px(--radius: 0.375rem)。⚠ 该条在本产品需部分舍弃,见 §3 |
| R4 | "Pair … serif display … with … condensed sans" + 类型化 scale + "IBM Plex Mono … confined to 11px in product screenshots" | 把 --font-heading 切成中文衬线栈,交给 shadcn 既有 cn-font-heading 消费点(CardTitle / DialogTitle / 空态标题);数字与任务 ID 走 --font-mono |
| R5 | "Data Visualization Panel … Bar fills use a viridis-style ramp" + "Don't apply the viridis chart colors to UI elements. They are content/visualization colors, not interface tokens." | --chart-1..5 换成紫→青→陶土的数据色阶,禁止泄漏到按钮/徽标等界面色;界面里的状态色只允许用语义令牌推导 |
明确不迁移的部分: Hex 是营销站,其 1200px 单栏滚动、80px 段落 gap、78px 斜体 hero、logo trust bar、产品截图作 hero——这些是落地页排版,本产品是长时段驻留的高密度协作工具,一律不采用(简报 §1 明确禁止照搬营销排版)。
适配判断
为什么这套语言适合「任务 + 频道消息」的企业工具:
- 暖底长时间看不发灰。 现网画布
#fcfcfc是中性冷白,实测「会话侧栏background #fcfcfc与页面底色完全相同」→ 侧栏与画布零层级。Hex 的暖白画布 + 纯白卡片天然给出两档表面,不需要新组件(途径①)。 - 衬线标题给中文界面补上「人味」。 现网单视图实测字号档位有
9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26 px十档,且 Cap 高度全靠字重区分。把标题收进衬线栈,正文收到 12/13/14.5 三档,标题与数据各自有明确字体信号,密度不需要靠缩字号换取。 - 单一紫色品牌色让状态色重新可用。 现网实测 Tailwind 原始调色板泄漏 253 处 / 44 个文件(amber 69、rose 68、slate 44、emerald 42…),深色下全部不翻转。品牌色收敛成暮紫后,amber/rose 这些只剩状态语义,可回收进语义令牌。
- 紫墨阴影/边界契合「工程笔记簿」气质。 Hex 的
rgba(71,57,130,0.1)紫调边界适合做表格撇线、任务卡边界——本产品最密集的界面正是任务表(AI 助手空间实测一次渲染12.8px/500 ×2765个文本节点)。
必须舍弃的项:
| 舍弃 | 原因 |
|---|---|
| 78px 斜体大标题 / 60px SemiExtended 章节标题 | 产品内最大标题是登录页 26px、频道头 16px;放大字号即挤压消息流可视条数(实测频道头仅 52px 高) |
| 3px 按钮圆角 | shadcn 单一 --radius 驱动全部圆角,按钮固定 rounded-lg;要 3px 必须改 button.tsx 的 className → 违反硬约束 §2.1。落到 6px 并记录为受限项(§8) |
| 「CTA 永不填充品牌色」 | 登录页主按钮实测 356×52 是产品唯一主行动,必须保持填充对比(default variant)。改为:只有这一个行动位用填充,其余全部 outline/ghost/secondary |
| 1200px 居中单栏 + 80px 段落 gap | 产品是三栏外壳(rail 72px + 侧栏 256px + 内容区),非滚动叙事页 |
| logo trust bar / 产品截图 hero / 4 角星装饰 | 无对应场景 |
#fffcfc 之外的暖粉渐变 rgb(205,160,165) |
与 OPC 工业零工场景不符,且会与 --destructive 争红 |
令牌映射
改动全部落在途径①(语义令牌取值)。下表覆盖简报 §5.1 第 4 条要求的全部变量名;primary / primary-foreground / ring / sidebar-primary / sidebar-ring 保持间接引用(var(--brand) / var(--brand-foreground)),不拆开。
浅色 :root
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
#fcfcfc |
#fffcfc |
R1:中性冷白 → 暖羊皮纸,与紫墨文字同源 |
--foreground |
#060607 |
#01011b |
R2:纯黑 → 紫墨,20.15:1 |
--card |
#ffffff |
#ffffff |
保持纯白,靠羊皮纸底色形成层级(不靠阴影) |
--card-foreground |
#060607 |
#01011b |
卡片正文紫墨,20.56:1 |
--popover |
#ffffff |
#ffffff |
浮层保持纯白 |
--popover-foreground |
#060607 |
#01011b |
浮层正文紫墨 |
--primary |
var(--brand) |
var(--brand) |
间接引用不变 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
间接引用不变 |
--secondary |
#ebedef |
#ecedf2 |
次级面换 Bone Mist 骨雾(带紫调) |
--secondary-foreground |
#060607 |
#31263b |
次级面文字 Plum Charcoal,软化纯黑 |
--muted |
#f2f3f5 |
#f4f2f6 |
弱化面单独一档(原与 secondary 同族不同值,现拉开) |
--muted-foreground |
#5c5e66 |
#5f6880 |
Slate Iris 压深版;Hex 原值 #717a94 在羊皮纸上仅 4.19:1,不达标故压深到 5.45:1 |
--accent |
#ebedef |
#ecedf2 |
悬停面/他人消息气泡 → 骨雾(实测他人气泡当前 = #ebedef) |
--accent-foreground |
#060607 |
#01011b |
悬停面文字紫墨 |
--destructive |
#da373c |
#c2173c |
换与紫系同调的绯红,羊皮纸上 5.91:1 |
--border |
#dcdee1 |
#dbd7da |
Fog Border:中性灰 → 带紫调的雾边(1px 分隔线) |
--input |
#dcdee1 |
#8b8291 |
交互控件边界加深到 3.61:1,满足图形边界 ≥3:1(shadcn Input/Textarea/Select 用 border-input) |
--ring |
var(--brand) |
var(--brand) |
焦点环取品牌紫 |
--brand |
#2563eb |
#473982 |
品牌蓝 → Twilight Plum 暮紫,9.46:1 |
--brand-foreground |
#ffffff |
#fffcfc |
紫底上的前景用羊皮纸白(9.46:1) |
--brand-soft |
rgb(37 99 235 / 0.12) |
rgb(71 57 130 / 0.12) |
选中态柔光底色,沿用 12% 透明度做法 |
--brand-ink |
#1d4ed8 |
#544692 |
选中态/链接文字,羊皮纸上 7.71:1 |
--message-self |
#e8f3fe |
#f0ecf8 |
自己气泡:淡蓝 → 淡紫洗底(实测当前 rgb(232,243,254)) |
--message-self-foreground |
#0d274a |
#31263b |
自己气泡文字:深蓝 → 梅炭,12.28:1 |
--surface-chat-soft |
#e8f2ff |
#f4f1fa |
回复/引用底色同步去蓝 |
--surface-chat-selected |
#e5ecfc |
#ece7f7 |
会话选中底同步去蓝 |
--mention |
#3370ff |
#473982 |
@提及收进品牌紫,9.46:1,消除「三种蓝并存」 |
--ink |
#060607 |
#01011b |
兼容令牌与 foreground 同步,避免旧引用拿纯黑 |
--surface-rail |
#e1e8f2 |
#e6e3ec |
rail 底:蓝灰 → 紫调骨雾,与画布 1.24:1,去掉 72px 竖带的冷蓝 |
--sidebar |
#fcfcfc |
#f3f0f5 |
关键:与画布 #fffcfc 拉开 1.11:1,修掉实测「侧栏=画布、零层级」 |
--sidebar-foreground |
#060607 |
#31263b |
侧栏正文梅炭色 |
--sidebar-accent |
#ebedef |
#ecedf2 |
侧栏悬停/选中底 |
--sidebar-accent-foreground |
#060607 |
#01011b |
侧栏悬停文字 |
--sidebar-border |
#dcdee1 |
#dbd7da |
侧栏分隔线与 --border 统一 |
--chart-1 |
oklch(0.87 0 0) |
#31263b |
R5:灰阶 → 梅炭,数据色第 1 档 13.99:1 |
--chart-2 |
oklch(0.556 0 0) |
#473982 |
暮紫 9.46:1 |
--chart-3 |
oklch(0.439 0 0) |
#6f63b7 |
紫水晶 4.97:1 |
--chart-4 |
oklch(0.371 0 0) |
#21918c |
青绿 3.75:1 |
--chart-5 |
oklch(0.269 0 0) |
#9c4a2f |
陶土 5.99:1(5 档全部 ≥3:1) |
--radius |
0.625rem(10px) |
0.375rem(6px) |
R3:圆角基准 10px → 6px;派生 --radius-sm 3.6px / md 4.8px / lg 6px / xl 8.4px / 2xl 10.8px / 3xl 13.2px / 4xl 15.6px |
深色 .dark
| 变量名 | 当前值 | 建议值 | 意图 |
|---|---|---|---|
--background |
oklch(0.145 0 0) |
#0e0b1a |
中性灰 → 紫调墨夜,17.51:1 |
--foreground |
oklch(0.985 0 0) |
#f4f2fb |
纯白 → 淡紫白 |
--card |
oklch(0.205 0 0) |
#1a1626 |
卡片比画布亮一档,紫调同源 |
--card-foreground |
oklch(0.985 0 0) |
#f4f2fb |
15.96:1 |
--popover |
oklch(0.205 0 0) |
#1a1626 |
与 card 同族 |
--popover-foreground |
oklch(0.985 0 0) |
#f4f2fb |
浮层正文 |
--primary |
var(--brand) |
var(--brand) |
间接引用不变 |
--primary-foreground |
var(--brand-foreground) |
var(--brand-foreground) |
间接引用不变 |
--secondary |
oklch(0.269 0 0) |
#262036 |
紫炭 |
--secondary-foreground |
oklch(0.985 0 0) |
#f4f2fb |
次级面文字 |
--muted |
oklch(0.269 0 0) |
#221d31 |
弱化面比 secondary 深半档,拉开两档 |
--muted-foreground |
oklch(0.708 0 0) |
#a79fc0 |
淡薰衣草,7.73:1(原灰 0.708 在紫底上偏冷) |
--accent |
oklch(0.269 0 0) |
#262036 |
悬停面/他人气泡 |
--accent-foreground |
oklch(0.985 0 0) |
#f6f4fc |
14.35:1 |
--destructive |
oklch(0.704 0.191 22.216) |
#ff8095 |
亮绯红,8.11:1 |
--border |
oklch(1 0 0 / 10%) |
rgb(158 145 214 / 0.26) |
白色 10% → 薰衣草 26%,分隔线带紫 |
--input |
oklch(1 0 0 / 15%) |
#6f6398 |
控件边界实心化到 3.62:1(原 15% 白在紫底上不可测) |
--ring |
var(--brand) |
var(--brand) |
焦点环 |
--brand |
oklch(0.68 0.15 256) |
#9e91d6 |
品牌蓝 → 薰衣草紫 |
--brand-foreground |
oklch(0.16 0.02 258) |
#16101f |
紫底上用深墨字,6.63:1 |
--brand-soft |
oklch(0.28 0.05 256) |
rgb(158 145 214 / 0.18) |
选中态柔光 18% |
--brand-ink |
oklch(0.84 0.09 256) |
#b9aeee |
亮紫,9.57:1 |
--message-self |
#203b59 |
#2a2340 |
深蓝气泡 → 深紫气泡 |
--message-self-foreground |
#e7f3ff |
#eae6f7 |
12.15:1 |
--surface-chat-soft |
oklch(0.32 0.06 250) |
#241f38 |
回复底色去蓝 |
--surface-chat-selected |
oklch(0.28 0.04 250) |
#2a2440 |
选中底去蓝 |
--mention |
oklch(0.72 0.14 254) |
#b9aeee |
@提及亮紫,9.57:1 |
--ink |
oklch(0.16 0.02 258) |
#f4f2fb |
兼容令牌同步翻转 |
--surface-rail |
#e3e5e8 |
#0b0916 |
关键修复:深色下浅色竖带 → 比画布更深的暗紫 |
--sidebar |
oklch(0.205 0 0) |
#141021 |
侧栏比画布亮一档 |
--sidebar-foreground |
oklch(0.985 0 0) |
#eae6f7 |
15.24:1 |
--sidebar-accent |
oklch(0.269 0 0) |
#262036 |
侧栏悬停 |
--sidebar-accent-foreground |
oklch(0.985 0 0) |
#f6f4fc |
侧栏悬停文字 |
--sidebar-border |
oklch(1 0 0 / 10%) |
rgb(158 145 214 / 0.2) |
侧栏分隔带紫 |
--interactive |
(.dark 未声明,继承浅色 #4e5058) |
#cfc7e0 |
补声明:原深色下交互文字继承浅色值,会沉进底色 |
--channel-icon |
(.dark 未声明,继承浅色 #80848e) |
#9e91d6 |
补声明:频道图标改亮紫,替代继承来的中性灰 |
--chart-1 |
oklch(0.87 0 0) |
#9e91d6 |
6.30:1 |
--chart-2 |
oklch(0.556 0 0) |
#b9aeee |
8.72:1 |
--chart-3 |
oklch(0.439 0 0) |
#6f63b7 |
3.49:1 |
--chart-4 |
oklch(0.371 0 0) |
#5ec9c0 |
8.93:1 |
--chart-5 |
oklch(0.269 0 0) |
#f2d94f |
12.48:1 |
--radius |
0.625rem |
0.375rem |
与浅色同基准,保证深浅切换圆角不跳变 |
同文件内需要同步的 3 个非颜色令牌(也在途径①):--workspace-background 浅色渐变终点 #e1e5f1 → #e4e1ec;深色 --surface-rail 修复见上;--interactive #4e5058 → #43394c、--channel-icon #80848e → #717a94。
字体与排版
字体栈(@theme inline,途径①)
--font-heading: "Songti SC", "Noto Serif SC", "Source Han Serif SC",
ui-serif, Georgia, "Times New Roman", serif;
--font-sans: "Geist Variable", "gg sans", "Noto Sans SC", "PingFang SC",
ui-sans-serif, system-ui, "Segoe UI", "Microsoft YaHei", …; /* 原文保留 */
--font-mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, …; /* 原文保留 */
- 中文回退纪律:
--font-sans一个字符都不动,中文仍走Noto Sans SC → PingFang SC → Microsoft YaHei;--font-heading里中文衬线排在ui-serif之前,保证「Geist 无中文字形」的老问题不会因为换 serif 而让中文掉到 Georgia 的方框。 --font-heading的实际消费点只有 3 处(cn-font-heading):web/src/components/ui/card.tsx:40(CardTitle)、alert-dialog.tsx:121(AlertDialogTitle)、chat/empty.tsx:62(空态标题)。改动面精确可控,不会把正文染成衬线。- 拉丁使用
ui-serif(macOS 落到 New York / Times),这也是 Hex 的 Cormorant Garamond Italic 200 在无外链字体条件下的替代路径;深色/浅色共用一套。
字号 / 行高 / 字重阶梯
| 角色 | 字体 | 字号 | 行高 | 字重 | 对应现状实测 | 说明 |
|---|---|---|---|---|---|---|
| 页面标题 | --font-heading |
26px | 33.8px (1.3) | 600 | 登录页主标题 26px | 保留 26px,只换字体家族 |
| 区块标题 | --font-heading |
20px | 27px (1.35) | 600 | 弹窗/空态标题 | 弹窗标题原为 16px font-medium,衬线化后允许 20px |
| 频道/卡片标题 | --font-heading |
16px / 14px | 1.35–1.4 | 600 | 频道头 16px/600、任务卡标题 14px/500 | 任务卡字重 500→600,靠衬线本身给层级 |
| 正文 | --font-sans |
14.5px | 21.75px (1.5) | 400 | 实测同列表 15px 与 14px 两套并存 | 统一到 14.5px,消灭「他人 15px / 自己 14px」双档 |
| 次级 | --font-sans |
13px | 18.85px (1.45) | 400 | 作者 13px/400 | 保留 |
| 标签 / 元信息 | --font-sans |
12px | 16.8px (1.4) | 500 | 时间 12px/500、成员数 12px/500 | 保留,中文最小 12px 红线不破 |
| 数字 / 代码 | --font-mono |
12px | 18px (1.5) | 400 | 会话行预览 11.25px | 11.25px 抬到 12px,落在中文最小字号上 |
中文长文本与数字的注意点:
- 现网单视图实测出现
9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 px—— 这些小数来自以 15px 为基准的em计算。方案要求正文层收敛到 12 / 13 / 14.5 px 三档;11.25px(会话行预览)与12.8px(AI 助手空间密集表 2765 个节点)必须显式抬到 12px,否则中文在 11.25px 下笔画糊成一片。 - 行高:正文 1.5(21.75px),比现状
body 1.375(20.63px)更松。中文方块的视觉重量高于拉丁,1.375 在 15px 下只有 20.63px 行距、连续中文行距不足;14.5px × 1.5 = 21.75px,比现状反而多 1.1px 行距但字号小 0.5px,净效果是阅读更稳、总高度基本不变。 - 数字:任务数(457)、消息数(1554)、时间(今天 10:07)一律
--font-mono,中文与数字混排时数字不参与中文行高的光学对齐,避免「457 项任务」里数字被撑高。 - 字重只用 400 / 500 / 600 三档(不引入 700),中文衬线 600 已足够区分层级;字重换来的层级让位给字体家族差异。
关键界面改造
每条都标注落在哪条途径:①令牌 / ②官方 variant / ③容器布局。覆盖 7 个样例面:S1、S2、S3、S7(必含)+ S4、S5、S8。
S1 应用外壳 + 空间/频道侧栏(app-shell.tsx、channel-sidebar.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | aside 256×715 @x=76,background #fcfcfc,与页面底色 --background #fcfcfc 完全相同 |
--sidebar: #f3f0f5,画布 #fffcfc;侧栏呈一档可辨的暖灰,层级来自色值而非阴影 |
① |
| 2 | 空间 rail nav 72×900 背景 transparent,右边框 rgba(220,222,225,0.55)(≠ --border #dcdee1);分隔线 rgba(5,5,9,0.22) |
--surface-rail: #e6e3ec + --sidebar-border: #dbd7da;把「带 alpha 的旁路值」收回语义令牌,rail 与侧栏靠 rail 更深的底分档 |
① |
| 3 | 侧栏头部 52px;搜索框 30px 高、圆角 10px、背景 rgba(235,238,239,0.75) |
头部 44px(h-11 的官方高度节奏);搜索框改官方 Input(h-8)+ 容器 --radius 6px。净省 8px 垂直,给频道行 |
③ + ② |
| 4 | 会话行 240×64 | 压缩到 56px(py-2 + 两行 12/13px),1440×900 下侧栏可视会话行由 11 行 → 12–13 行 |
③ |
| 5 | 频道图标 --channel-icon #80848e、未读点品牌蓝 |
--channel-icon: #717a94;未读徽标用官方 Badge(default variant = bg-primary 暮紫) |
① + ② |
| 6 | 壁纸渐变 linear-gradient(180deg,#e1e8f2,#e1e5f1) |
终点改 #e4e1ec,去掉整屏冷蓝调 |
① |
S2 频道消息流(message-list.tsx、channel-header.tsx、channel-tabs.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 同一列表两套字号:他人 15px/400 #060607,自己 14px/400 #0d274a |
两套都收敛到 14.5px / 1.5 / 400;差异只留气泡底色(--accent #ecedf2 vs --message-self #f0ecf8) |
①(字号在组件层,属容器/排版层:见 §8 风险) |
| 2 | 他人气泡 rgb(235,237,239) = --accent;自己 rgb(232,243,254) = --message-self;圆角 14px |
圆角随 --radius 由 14px → 6px;他人 #ecedf2、自己 #f0ecf8(淡紫洗底),气泡文字 #31263b(12.28:1) |
① |
| 3 | 频道头 860×52,标题 16px/600 #060607,成员数 12px/500 #5c5e66 |
标题 16px/600 但走 --font-heading 衬线;成员数 --muted-foreground #5f6880 |
① |
| 4 | @提及硬编码 #3370FF(chat-mention.ts),与 --mention #3370ff、#006ce7 三蓝并存 |
提及色统一到 --mention: #473982(9.46:1),并在组件里删除硬编码值改用 text-mention;message-list.tsx/composer-markdown.ts 的 #006ce7 同理清掉 |
①(+ 删除旁路,见 §8) |
| 5 | 输入区 textarea 628×33 无边框,容器只有上边框 rgb(220,222,225);工具按钮 28×28 |
上边框用 --border #dbd7da;发送/工具按钮用官方 Button variant=ghost size=icon-sm(28px,与现尺寸一致);输入区外框用 --input #8b8291 给出可辨识边界 |
① + ② |
| 6 | 悬停动作(点赞 / 回复 / 更多 / 阅读状态「0 人已读,4 人未读」) | 保持官方 Button variant=ghost size=icon-xs;阅读状态文字 12px --muted-foreground |
② |
| 7 | 引用块 | 引用条 border-left 用 --brand-ink #544692,底色 --surface-chat-soft #f4f1fa(替换 image-preview-dialog.tsx 里硬编码的 #f2f3f5) |
① |
S3 任务大厅与任务卡(task-hall.tsx、group-hall.tsx、create-task-dialog.tsx、channel-work-items.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 实测圆角分布 10px×48、8px×37 两套混用 | 全部由 --radius 派生(6px / 4.8px / 3.6px),消灭两套圆角 |
① |
| 2 | 卡片 = 标题 14px/500 + 频道 chip + AI 助手 chip + 查看任务 + 负责人 |
标题 14px/600 衬线;频道 chip / AI 助手 chip 用官方 Badge variant=outline;查看任务 用 Button variant=outline size=sm(Hex 的描边克制);负责人用 Avatar + 12px --muted-foreground |
① + ② |
| 3 | 状态流转 待补充 / 待处理 / 进行中 / 待验收 / 已完成 / 已关闭 目前依赖 Tailwind 原始调色板(amber 69 / rose 68 / emerald 42 处泄漏) |
六态全部收敛到语义令牌推导的 Badge:待补充/待处理 variant=secondary(#ecedf2/#31263b);进行中 variant=outline + text-brand-ink bg-brand-soft(#544692 on 12% 暮紫);待验收 variant=outline(#dbd7da 边界);已完成 variant=outline + --chart-4 青绿系文字;已关闭/过期 variant=destructive(#c2173c) |
② + ① |
| 4 | 任务看板「全部频道 / 5 项任务」「待补充 0 / 待处理 5」 | 列头数字走 --font-mono 12px;筛选「全部频道」用官方 Tabs,分组用 ButtonGroup 既有组件 |
② |
| 5 | 群聊大厅「营销式 hero 段落 + 全部群聊筛选 + 群卡片」,品牌蓝出现 20 处 | 删除 hero 段落(简报 §1 禁止营销排版),直接进「筛选行 + 卡片网格」;20 处品牌蓝收敛为 1 处(选中 Tab 的 --brand-soft 底) |
③ + ① |
| 6 | 卡片布局 | 网格容器改 grid-template-columns: repeat(auto-fill, minmax(280px,1fr)),间距 10px;1440px 内容区约 860px 时稳定 3 列(现状 2 列宽卡导致扫读跳行) |
③ |
| 7 | AI 助手空间(395 项任务)实测 12.8px/500 ×2765、12px/500 ×2381、12px/400 ×1994、14px/400 ×1724 |
收敛到 12px(元信息/标签)与 14px(任务名)两档,12.8px 抬到 12px;密度靠行高 1.4 与 Table 组件的官方紧凑行高维持,不靠缩字号 |
③ + ② |
S7 登录页(web/src/routes/login.tsx、web/src/components/auth/*)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 居中卡片,主标题 26px;页脚 11px | 主标题 26px 换 --font-heading 衬线(本方案唯一「文学性时刻」);页脚 11px 抬到 12px(中文最小字号) |
① |
| 2 | 「邮箱验证码 / 短信验证码」切换块 173×42,选中态 background #fcfcfc + 品牌蓝文字 |
选中态底改 --card #ffffff(在羊皮纸画布上仍可辨),文字 --brand-ink #544692;整块用官方 Tabs,容器底 --muted #f4f2f6 |
① + ② |
| 3 | 主按钮 356×52、白字、#2563eb |
唯一允许填充的 CTA:Button variant=default size=lg(h-9)→ bg-brand #473982 + --brand-foreground #fffcfc(9.46:1)。圆角由 10px → 6px,与全站一致 |
① + ② |
| 4 | 文案「登录 WanChat」「使用企业邮箱验证码继续」「企业邮箱 @example.com」「获取验证码」 | 文案保留;「获取验证码」为次级行动,视觉改成 Button variant=outline size=default,与主按钮形成 Hex 式「主静次更静」的按钮对 |
② |
| 5 | 卡片布局 | --card 纯白 + --border #dbd7da 1px;不再依赖 --shadow-e2 抬卡(Hex 的纸感靠边界而非投影) |
① + ③ |
S4 AI 助手频道(agent-chat-panel.tsx、agent-channel.tsx、agent-channel-results.tsx、channel-summary-panel.tsx)
| # | 现状 | 改后 | 途径 |
|---|---|---|---|
| 1 | 流式回答 / 来源引用 / 结果卡片,字号混杂 12.8px 等多档 | AI 回答正文与人类消息同规格 14.5px/1.5;来源引用 12px --muted-foreground;「思考中」呼吸灯沿用 --animate-breathe 不改 |
③ + ① |
| 2 | 结果卡片 | 用官方 Card(cn-font-heading 自动把 CardTitle 变衬线)+ Badge variant=outline 标来源;结果表格用官方 Table,数字列 --font-mono |
② |
| 3 | 引用/来源高亮色 | 用 --brand-soft 底 + --brand-ink 文字(#544692 on 12% 暮紫 = 6.77:1),不再用 Tailwind amber/rose |
① |
S5 管理与设置弹窗(space-manage-dialog.tsx、channel-settings-dialog.tsx、group-members.tsx、channel-permission-picker.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | [role=dialog] 704×512,圆角 18px,背景 #ffffff |
圆角随 --radius-xl(1.4 × 6 = 8.4px)→ 由 18px 收到约 8px;背景 --popover #ffffff |
① |
| 2 | 左侧导航项 135×36 圆角 8px,选中态 --brand-soft + --brand-ink #1d4ed8 |
圆角 6px;选中态 --brand-soft(暮紫 12%)+ --brand-ink #544692(7.71:1) |
① |
| 3 | 危险项前景 --destructive #da373c |
#c2173c(5.91:1) |
① |
| 4 | 输入框 488×32 圆角 10px;表单标签 14px | Input 官方 h-8(32px 不变)+ --radius 6px + border-input #8b8291(3.61:1 边界);表单标签 14px 走 --font-sans,弹窗标题走衬线 |
① + ② |
| 5 | 成员列表 / 权限选择器 | 用官方 Avatar、Separator、Checkbox/RadioGroup、Field、Item;权限分组用 Tabs |
② |
S8 应用中心(app-center.tsx、assistant-board.tsx)
| # | 现状(实测) | 改后 | 途径 |
|---|---|---|---|
| 1 | 分类筛选(全部 / Agent / 人事行政 / 数据与报表 / 项目管理 / 行业模板 / 研发协作 / 智能办公)+「共 14 个应用」 | 筛选改官方 Tabs(--muted 容器 + --card 选中片);「共 14 个应用」走 --font-mono 12px |
② |
| 2 | 应用/助手图标当前用 emoji(视觉一致性明显缺口) | emoji 不替换(不引入图标资源),改用容器统一:图标位固定 32×32 圆角 6px、底色 --muted、居中;文字侧元信息(Agent · 第三方 · chat)12px --muted-foreground。影响收窄为「图标位规格统一」而非换图标 |
③ |
| 3 | 运行中 / 开发中 徽标 |
运行中 用 Badge variant=outline + --chart-4 青绿文字;开发中 用 Badge variant=secondary |
② + ① |
| 4 | 卡片网格 | grid-template-columns: repeat(auto-fill, minmax(240px,1fr)),间距 10px |
③ |
S6 语音频道(rtc-group-call-ui.tsx)——依据为代码与数据库,非截图
本栈
TRTC_ENABLED=false:DOM 内aria-label匹配「语音|通话|加入」命中 0,正文不含「语音」,/api/v1/rtc/*返回RTC_DISABLED。以下全部来自代码与库表,没有截图证据。 库内事实:wanman3_rtc_voice_channels30 行(空间 395/396/398/399 各有 active 频道)、wanman3_rtc_calls183 行、会议纪要 20 行。 设计取舍:通话面板的成员状态沿用同 6 个语义色(--accent通话面、--brand-soft发言态、--destructive断连、--chart-4连接中);连接态文案已连接 / 连接中 / 重连中 / 已断开 / 连接失败用 12px + 状态点,不新增令牌。本方案不渲染、不验证 S6。
深浅色与对比度
WCAG 相对亮度公式自算(0.2126R + 0.7152G + 0.0722B,sRGB 线性化),比值保留两位。
浅色关键组合
| 组合 | 前景 hex | 背景 hex | 对比度 | 达标 |
|---|---|---|---|---|
| 正文 / 画布 | #01011b |
#fffcfc |
20.15:1 | ✅ AA/AAA |
| 正文 / 卡片 | #01011b |
#ffffff |
20.56:1 | ✅ |
| 次级文字 / 画布 | #5f6880 |
#fffcfc |
5.45:1 | ✅ AA(正文) |
| 次级文字 / 卡片 | #5f6880 |
#ffffff |
5.56:1 | ✅ |
| 品牌前景 / 品牌底 | #fffcfc |
#473982 |
9.46:1 | ✅ |
| 品牌墨 / 画布(选中态文字、@提及) | #544692 |
#fffcfc |
7.71:1 | ✅ |
| 品牌墨 / 柔光底(引用块) | #544692 |
#f0ecf8 |
6.77:1 | ✅ |
| 自己气泡文字 / 气泡底 | #31263b |
#f0ecf8 |
12.28:1 | ✅ |
| 他人气泡文字 / 气泡底 | #01011b |
#ecedf2 |
17.59:1 | ✅ |
| 侧栏文字 / 侧栏底 | #31263b |
#f3f0f5 |
12.64:1 | ✅ |
| 侧栏底 / 画布(层级) | #f3f0f5 |
#fffcfc |
1.11:1(表面分层,非文字) | ✅ |
| rail 底 / 画布(层级) | #e6e3ec |
#fffcfc |
1.24:1(表面分层,非文字) | ✅ |
| 危险色 / 画布 | #c2173c |
#fffcfc |
5.91:1 | ✅ |
| 交互文字 / 画布 | #43394c |
#fffcfc |
10.67:1 | ✅ |
| 控件边界 / 画布 | #8b8291 |
#fffcfc |
3.61:1 | ✅ 图形边界 ≥3:1 |
| 分隔线 / 画布 | #dbd7da |
#fffcfc |
1.40:1 | ⚠ 见下注 |
| 数据色 1–5 / 画布 | #31263b / #473982 / #6f63b7 / #21918c / #9c4a2f |
#fffcfc |
13.99 / 9.46 / 4.97 / 3.75 / 5.99 | ✅ 全部 ≥3:1 |
深色关键组合
| 组合 | 前景 hex | 背景 hex | 对比度 | 达标 |
|---|---|---|---|---|
| 正文 / 画布 | #f4f2fb |
#0e0b1a |
17.51:1 | ✅ |
| 正文 / 卡片 | #f4f2fb |
#1a1626 |
15.96:1 | ✅ |
| 次级文字 / 画布 | #a79fc0 |
#0e0b1a |
7.73:1 | ✅ |
| 次级文字 / 卡片 | #a79fc0 |
#1a1626 |
7.05:1 | ✅ |
| 品牌前景 / 品牌底 | #16101f |
#9e91d6 |
6.63:1 | ✅ |
| 品牌墨 / 画布(@提及) | #b9aeee |
#0e0b1a |
9.57:1 | ✅ |
| 品牌墨 / 卡片 | #b9aeee |
#1a1626 |
8.72:1 | ✅ |
| 自己气泡文字 / 气泡底 | #eae6f7 |
#2a2340 |
12.15:1 | ✅ |
| 侧栏文字 / 侧栏底 | #eae6f7 |
#141021 |
15.24:1 | ✅ |
| 悬停面文字 / 悬停面底 | #f6f4fc |
#262036 |
14.35:1 | ✅ |
| 危险色 / 画布 | #ff8095 |
#0e0b1a |
8.11:1 | ✅ |
| 控件边界 / 画布 | #6f6398 |
#0e0b1a |
3.62:1 | ✅ |
| 控件边界 / 卡片 | #6f6398 |
#1a1626 |
3.30:1 | ✅ |
| 数据色 1–5 / 卡片 | #9e91d6 / #b9aeee / #6f63b7 / #5ec9c0 / #f2d94f |
#1a1626 |
6.30 / 8.72 / 3.49 / 8.93 / 12.48 | ✅ 全部 ≥3:1 |
注 1(分隔线):--border #dbd7da 在画布上 1.40:1,深色 rgb(158 145 214 / 0.26) 合成后约 2.13:1。这类 1px 撇线属纯装饰,WCAG 1.4.11 对「非理解内容所必需」的图形不设下限;方案把所有交互控件的边界统一交给 --input(3.61:1 / 3.62:1),两者职责分离。风险在 §8 备注。
注 2(响应深浅切换的真实收益):现状实测「注入 .dark 后前景 rgb(6,6,7) 仍有 55 处、rgb(92,94,102) 27 处、边框 rgb(220,222,225) 6 处不翻转,--surface-rail 仍是浅色 #e3e5e8」。本方案修掉的是令牌层里能修的两个(--surface-rail → #0b0916;--ink → #f4f2fb);剩下的 253 处 Tailwind 原始调色板与头像 50/700 硬编码必须改组件文件,不在令牌方案射程内 —— 详见 §8 风险 R1。
shadcn 兼容性
结论:可以在只用官方组件与官方 variant/size 的前提下达成;不需要引入尚未安装的官方组件。
web/src/components/ui/现有 38 个 官方组件已覆盖本方案全部需要: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、Avatar、Separator、Card、Dialog/AlertDialog、ScrollArea/ScrollRegion/ScrollSurface、Table、Tooltip、DropdownMenu/ContextMenu、Field/FieldSelect、Checkbox/RadioGroup、Skeleton、Message/Bubble/MessageScroller、ButtonGroup、InputGroup、Item、Popover、Collapsible、Accordion、Calendar、FloatingLayer。- 本方案没有新增任何 variant,没有
className覆盖颜色/字号/圆角/阴影,没有内联style,没有全局 CSS 改组件。唯一触碰组件行为的是删除现有硬编码色(chat-mention.ts的#3370FF、message-list.tsx的#006ce7、composer-markdown.ts、image-preview-dialog.tsx的#f2f3f5)改用语义工具类——这是减代码,不是视觉变体。 - 组件消费
--radius的方式决定了一处受限:Button固定rounded-lg(=--radius),所以按钮圆角只能等于 6px,拿不到 Hex 的 3px。方案接受 6px 并统一。 - 字体家族改动通过既有
cn-font-heading生效,未新增工具类。
不合规风险(显式标注)
| 编号 | 事项 | 是否违反硬约束 | 处理 |
|---|---|---|---|
| R1 | 深色下 253 处 Tailwind 原始调色板 + 头像 50/700 硬编码不翻转 | 不违反(改组件文件才能修,本方案不改组件) | 方案只承诺修令牌层可达的两处(--surface-rail、--ink);其余标注为遗留风险,需另立工单 |
| R2 | 消息正文字号统一 14.5px 需要动 message-list.tsx 的排版类 |
属途径③/容器排版边界情形 | 字号不是「颜色/字重/行高/尺寸」以外的新变体;若评审认为字号也受 §2.1 约束,则该条降级为「保留双档字号」,其余改造不受影响 |
| R3 | --border 1.40:1(浅)/2.13:1(深)低于 3:1 |
不违反(纯装饰撇线豁免 1.4.11) | 交互控件边界另由 --input(3.61/3.62:1)承担 |
| R4 | outline 按钮的边界走 border-border(1.40:1)而非 --input |
官方组件默认行为 | 主行动一律 default(9.46:1);outline 仅用于有上下文可辨的次级位 |
| R5 | 衬线标题在无外链字体条件下依赖系统字体(macOS Songti SC / Windows 无则落 Noto Serif SC / 再落 ui-serif) |
不违反 | 字体替换链已给三层回退;Linux CI 截图为无衬线,属已知差异 |
实施成本
改动面
| 文件 | 改动 |
|---|---|
web/src/styles.css |
替换 @theme inline(1 行 --font-heading)+ :root(约 36 行)+ .dark(约 34 行)。单文件,最大头 |
web/src/components/chat/chat-mention.ts |
删除硬编码 #3370FF → 用 --mention 令牌 |
web/src/components/app/message-list.tsx |
删除 #006ce7;正文字号统一 14.5px(R2) |
web/src/components/app/composer-markdown.ts |
同上删 #006ce7 |
web/src/components/app/image-preview-dialog.tsx |
#f2f3f5 → --surface-chat-soft |
web/src/components/app/tone.ts |
#23a55a / #f0b232 收进 --chart-4 / --chart-5 语义(状态色) |
web/src/components/app/chrome.ts |
#f06f66 → --destructive |
task-hall.tsx / group-hall.tsx / app-center.tsx |
容器网格 + Tabs + Badge variant 替换(途径②③),删除 hero 段落 |
channel-sidebar.tsx |
搜索框改 Input、会话行高度(途径②③) |
| 头像硬编码(多处) | 50/700 配对 → --brand-soft / --brand-ink 派生(R1) |
预估人时
| 阶段 | 人时 |
|---|---|
令牌层(styles.css 一文件 + 回归对比) |
6 h |
| 硬编码色清理(8 个文件,全是删除/替换) | 5 h |
| S1/S2 外壳与消息流(容器层) | 6 h |
| S3 任务大厅(含删 hero、六态收敛) | 6 h |
| S5/S7/S8 弹窗、登录、应用中心 | 5 h |
深色可达性接线(<html> 加 .dark + 主题开关) |
3 h |
| 联调 / 回归 / 截图复算 | 5 h |
| 合计 | 约 36 h(≈4.5 人日) |
风险清单
- 深色仍不可达:全仓
web/src无代码加.dark,localStorage无主题键。令牌改完后深色仍是「能用但没人能打开」。需 3h 接线(本方案不含,标注为前置项)。 - R1 遗留泄漏:253 处原始调色板改不干净时,深色下会出现冷色碎片,破坏紫墨一致性。建议先收敛 Leak 普查 Top 3(
text-rose-600 ×31、border-slate-100 ×25、text-amber-700 ×19)。 - 衬线字体跨平台差异:Windows 无
Songti SC,落到Noto Serif SC或ui-serif,标题观感在 CI 截图与个人机不同。 - 字号统一引发的回归:把消息正文从 15/14 双档统一到 14.5px 会轻微改变气泡换行位置,需回归长消息列表。
验证方式(哪些检查能证明改动生效)
getComputedStyle(document.body).backgroundColor===rgb(255,252,252)(浅色)/rgb(14,11,26)(深色)。getComputedStyle(document.querySelector('[class*=font-heading]')).fontFamily含Songti SC。- 注入
.dark后getComputedStyle(document.documentElement).getPropertyValue('--surface-rail')===#0b0916(不再是#e3e5e8)。 - 全仓
grep -rn "text-rose-600\|border-slate-100\|bg-amber-50" web/src命中数从 253 降到 <30。 - 对比度复算:对
--foreground/--background、--brand-foreground/--brand、--muted-foreground/--background三对跑 §7 的公式,应分别得到 20.15 / 9.46 / 5.45(浅)与 17.51 / 6.63 / 7.73(深)。 - 圆角抽查:任务卡
border-radiuscomputed 值应为6px家族(原实测 10px×48 与 8px×37 两套消失)。
取舍
解决了什么
- 零层级侧栏:
--sidebar与--background从同值#fcfcfc拉开到#f3f0f5/#fffcfc(1.11:1),rail 再深一档#e6e3ec(1.24:1),不需要新组件或阴影。 - 品牌色收敛:
#2563eb/#006ce7/#3370FF三蓝并为单暮紫#473982(浅)/#9e91d6(深),@提及与选中态不再各说各话。 - 圆角两套混用(10px×48 / 8px×37)与字号十档(9–26px)收敛为 6px 派生 + 12/13/14.5px 三档。
- 深色两个致命点修好:
--surface-rail浅色竖带、--ink深蓝黑,其余留给组件层工单。 - 状态色脱离 Tailwind 原始调色板,六种任务态改由语义令牌 + 官方 Badge variant 推导,深色可翻转。
- 图片/图标缺口用规格收窄:应用中心 emoji 不换图标,但图标位统一 32×32 / 6px /
--muted底,视觉不再散。
牺牲了什么
- 不再有「品牌蓝」的即时识别度:紫色在 OPC 工业零工场景里不是既有认知色。收益是它与 warning(琥珀)、danger(绯红)、success(青绿)都不冲突,状态色可用空间变大。
- 按钮圆角只能 6px,拿不到 Hex 的 3px「机械感」;整体因此更接近「笔记本」而非「仪表盘」。
- 暖白画布在低色域屏 / 老旧的 sRGB 面板上会偏黄,与打印机上「纸」的联想绑定更强,纯数据报表场景会显得不够冷峻。
- 衬线标题在 Windows 上退化,跨平台观感不一致。
- 统一字号会改变现有消息换行位置,短期有回归成本。
什么场景下不适用
- 需要纯冷冽、强对比、零暖调的监控大屏 / 值班看板场景 —— 羊皮纸暖底会削弱「告警红」的锐度。
- 需要多品牌色并行区分业务线的产品 —— 本方案把品牌色压到单一紫,多业务线要靠数据色(
--chart-*)而非界面色区分。 - 需要深色优先的产品 —— 本方案是浅色优先,深色是对等补齐而非主战场;Hex 的原始语言(羊皮纸)在深色下只能借「墨紫夜」近似,失去羊皮纸的物理联想。
- 若评审不接受「衬线标题」这种强风格信号(企业工具求中性),可只保留调色板与圆角改造,把
--font-heading回退为var(--font-sans),成本为零、风格锐度减半。