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 明确禁止照搬营销排版)。


适配判断

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

  1. 暖底长时间看不发灰。 现网画布 #fcfcfc 是中性冷白,实测「会话侧栏 background #fcfcfc 与页面底色完全相同」→ 侧栏与画布零层级。Hex 的暖白画布 + 纯白卡片天然给出两档表面,不需要新组件(途径①)。
  2. 衬线标题给中文界面补上「人味」。 现网单视图实测字号档位有 9 / 9.375 / 11 / 11.25 / 12 / 12.8 / 13.125 / 14 / 15 / 26 px 十档,且 Cap 高度全靠字重区分。把标题收进衬线栈,正文收到 12/13/14.5 三档,标题与数据各自有明确字体信号,密度不需要靠缩字号换取。
  3. 单一紫色品牌色让状态色重新可用。 现网实测 Tailwind 原始调色板泄漏 253 处 / 44 个文件(amber 69、rose 68、slate 44、emerald 42…),深色下全部不翻转。品牌色收敛成暮紫后,amber/rose 这些只剩状态语义,可回收进语义令牌。
  4. 紫墨阴影/边界契合「工程笔记簿」气质。 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-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,落在中文最小字号上

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

  1. 现网单视图实测出现 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 下笔画糊成一片。
  2. 行高:正文 1.5(21.75px),比现状 body 1.375(20.63px) 更松。中文方块的视觉重量高于拉丁,1.375 在 15px 下只有 20.63px 行距、连续中文行距不足;14.5px × 1.5 = 21.75px,比现状反而多 1.1px 行距但字号小 0.5px,净效果是阅读更稳、总高度基本不变。
  3. 数字:任务数(457)、消息数(1554)、时间(今天 10:07)一律 --font-mono,中文与数字混排时数字不参与中文行高的光学对齐,避免「457 项任务」里数字被撑高。
  4. 字重只用 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_channels 30 行(空间 395/396/398/399 各有 active 频道)、wanman3_rtc_calls 183 行、会议纪要 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 的前提下达成;不需要引入尚未安装的官方组件。

不合规风险(显式标注)

编号 事项 是否违反硬约束 处理
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 人日)

风险清单

  1. 深色仍不可达:全仓 web/src 无代码加 .dark,localStorage 无主题键。令牌改完后深色仍是「能用但没人能打开」。需 3h 接线(本方案不含,标注为前置项)。
  2. R1 遗留泄漏:253 处原始调色板改不干净时,深色下会出现冷色碎片,破坏紫墨一致性。建议先收敛 Leak 普查 Top 3(text-rose-600 ×31、border-slate-100 ×25、text-amber-700 ×19)。
  3. 衬线字体跨平台差异:Windows 无 Songti SC,落到 Noto Serif SC 或 ui-serif,标题观感在 CI 截图与个人机不同。
  4. 字号统一引发的回归:把消息正文从 15/14 双档统一到 14.5px 会轻微改变气泡换行位置,需回归长消息列表。

验证方式(哪些检查能证明改动生效)

  1. getComputedStyle(document.body).backgroundColor === rgb(255,252,252)(浅色)/ rgb(14,11,26)(深色)。
  2. getComputedStyle(document.querySelector('[class*=font-heading]')).fontFamily 含 Songti SC。
  3. 注入 .dark 后 getComputedStyle(document.documentElement).getPropertyValue('--surface-rail') === #0b0916(不再是 #e3e5e8)。
  4. 全仓 grep -rn "text-rose-600\|border-slate-100\|bg-amber-50" web/src 命中数从 253 降到 <30。
  5. 对比度复算:对 --foreground/--background、--brand-foreground/--brand、--muted-foreground/--background 三对跑 §7 的公式,应分别得到 20.15 / 9.46 / 5.45(浅)与 17.51 / 6.63 / 7.73(深)。
  6. 圆角抽查:任务卡 border-radius computed 值应为 6px 家族(原实测 10px×48 与 8px×37 两套消失)。

取舍

解决了什么

  1. 零层级侧栏:--sidebar 与 --background 从同值 #fcfcfc 拉开到 #f3f0f5 / #fffcfc(1.11:1),rail 再深一档 #e6e3ec(1.24:1),不需要新组件或阴影。
  2. 品牌色收敛:#2563eb / #006ce7 / #3370FF 三蓝并为单暮紫 #473982(浅)/ #9e91d6(深),@提及与选中态不再各说各话。
  3. 圆角两套混用(10px×48 / 8px×37)与字号十档(9–26px)收敛为 6px 派生 + 12/13/14.5px 三档。
  4. 深色两个致命点修好:--surface-rail 浅色竖带、--ink 深蓝黑,其余留给组件层工单。
  5. 状态色脱离 Tailwind 原始调色板,六种任务态改由语义令牌 + 官方 Badge variant 推导,深色可翻转。
  6. 图片/图标缺口用规格收窄:应用中心 emoji 不换图标,但图标位统一 32×32 / 6px / --muted 底,视觉不再散。

牺牲了什么

  1. 不再有「品牌蓝」的即时识别度:紫色在 OPC 工业零工场景里不是既有认知色。收益是它与 warning(琥珀)、danger(绯红)、success(青绿)都不冲突,状态色可用空间变大。
  2. 按钮圆角只能 6px,拿不到 Hex 的 3px「机械感」;整体因此更接近「笔记本」而非「仪表盘」。
  3. 暖白画布在低色域屏 / 老旧的 sRGB 面板上会偏黄,与打印机上「纸」的联想绑定更强,纯数据报表场景会显得不够冷峻。
  4. 衬线标题在 Windows 上退化,跨平台观感不一致。
  5. 统一字号会改变现有消息换行位置,短期有回归成本。

什么场景下不适用

  1. 需要纯冷冽、强对比、零暖调的监控大屏 / 值班看板场景 —— 羊皮纸暖底会削弱「告警红」的锐度。
  2. 需要多品牌色并行区分业务线的产品 —— 本方案把品牌色压到单一紫,多业务线要靠数据色(--chart-*)而非界面色区分。
  3. 需要深色优先的产品 —— 本方案是浅色优先,深色是对等补齐而非主战场;Hex 的原始语言(羊皮纸)在深色下只能借「墨紫夜」近似,失去羊皮纸的物理联想。
  4. 若评审不接受「衬线标题」这种强风格信号(企业工具求中性),可只保留调色板与圆角改造,把 --font-heading 回退为 var(--font-sans),成本为零、风格锐度减半。