设计基础
设计哲学、几何、折射材质、暗色光学与 Token
设计基础
Tuffex(塔芙)的设计基础建立在物理真实度(Physical Honesty)、**零迟滞响应(Sub-100ms Velocity)与确定性工程纪律(Deterministic Discipline)**三大公理之上。
它不仅定义了基础 CSS 变量,更规定了桌面端人机交互的几何学、材料学与光学底线。
几何与曲率工程(Geometry & Squircles)
G2 曲率连续性与超椭圆
标准 CSS border-radius 采用圆弧拼接( 切线连续),在直线与圆弧交点处曲率 瞬间从 突跃至 ,在高光或折射材质下会产生肉眼可见的“折痕感”(Specular Break)。
TuffEx 在 TxCard、TxModal、TxCommandPalette、TxFlipOverlay、各类 Dialog 与 CoreBox 上使用超椭圆(Lamé Curve / Squircle)圆角:
超椭圆与直线相接处曲率为 0( 连续),45° 方向切入的深度与原来的圆角相同,反射与边缘浑然一体。实现见 style/mixins.scss 的 tx-squircle,不支持 corner-shape 的浏览器保留普通圆角。
同心圆角几何守恒
嵌套容器若使用相同的圆角数值,拐角处物理间隙会扩大 倍(约 1.414 倍),导致内部元素产生被挤压的悬空失衡感。 TuffEx 严格执行同心守恒定律:
水平内嵌防光标裁切
圆角弧线会向内侵占内容空间。为了防止输入框光标(Caret)切入圆弧,水平内边距必须完全覆盖圆角半径: 单行文字包裹层的垂直内边距取水平内边距的 0.6~0.75 倍(TxModeChip、TxTag 都是 0.625),抵消字体自带行高造成的头重脚轻感。
表面材质与次表面折射(Surfaces & Refraction)
Refraction(琉光折射)默认法则
所有带材质层的组件,默认材质一律且必须为 refraction:TxBaseSurface 的 mode、TxCard 的 background、TxFlipOverlay、TxModal、TxCommandPalette 与 TxPopperDialog、TxBlowDialog、TxBottomDialog、TxTouchTip 几种对话框的 surface,以及经 TxBaseAnchor 渲染的弹出面板(TxPopover、TxTooltip、下拉与右键菜单、TxSelect、TxSearchSelect)的 panelBackground。
TxDrawer 是经用户确认的例外(2026-10-25):面板默认 pure 实色,后面的页面不透进正文与表单;要琉光时传 surface="refraction"。
若因极端场景要换成其他材质(如 flat、mask、glass),必须经过用户明确手动确认;运动中的降级与 autoDetect 的临时降级不改声明的材质,不算切换。详见《Surface 8 种材质物理选型与确认门禁》。
斯涅尔折射与 RGB 色散管线
TxBaseSurface 的 refraction 以 TxGlassSurface 为玻璃层,用 SVG 位移贴图(Displacement Map)模拟光线穿透棱镜时的斯涅尔偏折(Snell's Law):Red、Green、Blue 三个通道各自位移一次,幅度略有不同(默认依次为 −180、−170、−160),通道错开后在折射边缘分离出微弱的光谱彩边(Chromatic Dispersion),打破塑料般的单调感。
120Hz 运动降级与 140ms 迟滞恢复
材质随元素移动时,backdrop-filter 的取样落后于元素的位置,滤镜层会拖着一块错位的背景走;在 120Hz 屏幕上拖动窗口时,重滤镜还要挤占只有 8.3ms 的帧预算。所以 TxBaseSurface 一运动就当帧降级(0ms,不做防抖):blur、glass、acrylic 整体换成 fallbackMode(默认 mask);refraction 不换材质,玻璃层与滤镜层在 140ms 内淡出,换上一层半透明遮盖。运动结束后再恢复,autoDetect 的信号要先安静 140ms,防止手势在阈值附近颤抖时反复切换:refraction 随即分层恢复,287ms 撤完遮盖;其他材质先保持降级 299ms 再换回。详见《材质自动推断与 120Hz 运动降级》。
色彩科学与暗色光学(Color Science)
#141414 深灰画布与三层表面阶梯
为什么不用绝对纯黑 #000000?
- 防 OLED 拖尾残影:纯黑导致子像素关闭,滚动时会产生令人眩晕的紫色拖尾(Purple Smearing)。
- 保留阴影空间:阴影的物理本质是比底板更暗。
#141414为弥散投影保留了空间纵深。 - 三层阶梯:L0 底板
--tx-bg-color: #141414,L1 容器--tx-bg-color-overlay: #1d1e1f(卡片、对话框、抽屉、弹出浮层),L2 高亮--tx-fill-color-light: #262727(悬停、选中)。暗色下--tx-fill-color-blank是transparent,不承担容器色。
暗色模式视网膜光晕字重补偿
根据亥姆霍兹视网膜光渗效应(Optical Irradiation),白字在暗黑底板上会向外发光扩散,看起来比浅色模式下同字重的字更粗,粗多少随亮度、对比度和字号而变,没有固定的百分比。
TuffEx 在暗色主题里把三档强调字重各调轻 40,组件以 var(--tx-font-weight-medium, 500) 这样的写法读取,切到暗色主题就随之变轻:
- 默认正文:
400,不下调(再低,静态字体就会落到 Light 字面) - 行内强调
--tx-font-weight-medium:500(浅色)460(暗色) - 小标题与按钮
--tx-font-weight-semibold:600(浅色)560(暗色) - 加粗与数值
--tx-font-weight-bold:700(浅色)660(暗色)
只有带字重轴的字体(San Francisco、Segoe UI Variable、Inter Variable)会真正画细;PingFang SC、Microsoft YaHei 这类静态字体把这些值归回浅色模式的同一个字面,补偿不生效,也不会变粗。每个暗色值都落在(浅色值 − 100,浅色值]之内,由 Sass 函数 tx-dark-weight 在构建时检查。默认字体栈在没装 Inter 的 macOS 上由 PingFang SC 绘制,看不出这档微调。详见《暗色视网膜光晕与字重微调补偿》。
color-mix 墨水融合与 WCAG 4.5:1
语义文字颜色绝不使用孤立纯色相,而是与主墨水在 sRGB 色彩空间动态混色,例如 TxModeChip 危险态的墨水:
color-mix(in srgb, var(--tx-color-danger) 55%, var(--tx-text-color-primary))。
占比按色相分开定:危险 55%,成功与警告 45%,信息取主色 50%。13px 文字放在 -light-9 淡底上,纯色相只有 2.03:1~2.61:1,混色后实测 5.07:1~5.32:1,达到 WCAG 2.1 AA 的 4.5:1。
排版工程与 13–14px 基准(Typography)
- 13px~14px 生产力基准:桌面生产力工具避免采用营销类大字号,确保关键上下文落在人眼 2 度中央凹扫读视窗内。
- 等宽代码 0.9em 调和:等宽字体的 x 高度略高于同字号的无衬线字体(按 macOS 自带字体实测,高出约 1.7%~7.7%),行内
<code>缩到0.9em并留在基线上,保持垂直行间节奏。.tx-prose里不在<pre>中的<code>自动套用,其他地方加.tx-inline-code。 - 现代软换行:短标题采用
text-wrap: balance(工具类.tx-heading,TxModal的标题已内置);长段落采用text-wrap: pretty自动规避段末单字孤行(Orphans;.tx-prose p、.tx-description、.tx-help-text);严禁硬编码<br>。流式生成的段落例外:还在写入时按普通断行,写完再换回pretty。 - 正文零 Tracking 铁律:正文严禁触碰
letter-spacing。它不会去掉字偶间距(Kerning Pairs),而是在其外给相邻字符统一加距,冲淡厂商调好的字距节奏;字距不为 0 时,浏览器也不再应用fi、fl这类可选连字。只有 ≤11px 的全大写微型标签、≥17px 的标题与展示数字、头像缩写三类豁免。
微动效与微交互节拍(Micro-Motion)
- 动效是空间锚点:绝大部分微交互压缩在 90ms~180ms 之间,动画绝不允许阻碍下一次点击或键盘输入。
- 悬停必须 0ms 瞬间响应:严禁在
:hover上过渡背景色和文字颜色(防止产生“泡在浆糊里”的迟滞感);仅状态形变允许挂载.is-morphing类名过渡。 - 90ms+90ms 确认律动:菜单点击后经历“90ms 清除高亮 + 90ms 激活脉冲”,消除点击即消失的不确定感。
- 四大合成器属性:高频动画、加载效果与循环特效只动
translate、scale、rotate、opacity,整段交给合成器线程,主线程繁忙时也跟得上刷新率。关键帧里可以用var()给起点、终点和幅度,但不给自定义属性本身做关键帧动画(它每一帧都在主线程上插值);重播动画靠两个关键帧名字交替,不用void el.offsetWidth强制重排。
AI 流式生成与防抖底线(Streaming & Anti-Jitter)
- useStreamPacer 节拍器:至少每 24ms 释放一个词元;积压时按期限均匀提速,每个词元最迟在到达后 600ms 显示;源结束后,剩余积压在 320ms 内放完。网络一次倾泻下来的大块文字,读起来是一段加快的字流。
- 双层 Reserve 镜像占位:重放已完成的内容时,隐形的占位层(
aria-hidden、inert、visibility: hidden)先撑住完整高度,文字放出期间容器不再长高、滚动条不跳。reserve默认关闭;实时流式输出(包括重新生成)还不知道最终高度,容器仍随内容增高。 - 即刻可读与框选复制:文字释放至 DOM 即为纯文本节点,严禁
user-select: none,用户在生成过程中随时按下Cmd+C立即完成复制。
颜色体系令牌
品牌色与语义色
| Token | Light | Dark | 用途 |
|---|---|---|---|
--tx-color-primary | #409eff | #409eff | 主操作 |
--tx-color-success | #67c23a | #4ade80 | 成功状态 |
--tx-color-warning | #e6a23c | #fbbf24 | 警告状态 |
--tx-color-danger | #f56c6c | #f87171 | 错误状态 |
--tx-color-info | #909399 | #909399 | 信息提示 |
主色阶梯
| Token | Light | Dark | 用途 |
|---|---|---|---|
--tx-color-primary-light-3 | #79bbff | #3375b9 | 悬停/聚焦 |
--tx-color-primary-light-5 | #a0cfff | #2a598a | 轻度背景 |
--tx-color-primary-light-7 | #c6e2ff | #213d5b | 微弱背景 |
--tx-color-primary-light-9 | #ecf5ff | #18222c | 面层底色 |
--tx-color-primary-dark-2 | #337ecc | #66b1ff | 激活态 |
文本颜色与无障碍基线
| Token | Light | Dark | 用途与对比度 |
|---|---|---|---|
--tx-text-color-primary | #303133 | #e5eaf3 | 主文本(最高对比度) |
--tx-text-color-regular | #606266 | #cfd3dc | 13px 正文必须基准(实测 5.69:1) |
--tx-text-color-secondary | #909399 | #a3a6ad | 次级文本(实测 3.08:1,仅限辅助图标) |
--tx-text-color-placeholder | #a8abb2 | #8d9095 | 占位文本 |
--tx-text-color-disabled | #c0c4cc | #6c6e72 | 禁用文本 |
背景与边框
| Token | Light | Dark | 用途 |
|---|---|---|---|
--tx-bg-color | #ffffff | #141414 | 应用背景底板 |
--tx-bg-color-page | #f2f3f5 | #0a0a0a | 页面画布 |
--tx-bg-color-overlay | #ffffff | #1d1e1f | 浮层底板 |
--tx-fill-color | #f0f2f5 | #303030 | 弱填充 |
--tx-fill-color-light | #f5f7fa | #262727 | 更浅填充 |
--tx-fill-color-lighter | #fafafa | #1d1d1d | 最浅填充 |
--tx-fill-color-darker | #ebeef5 | #3a3a3a | 更深填充 |
--tx-fill-color-blank | #ffffff | transparent | 透明填充 |
--tx-border-color | #dcdfe6 | #4c4d4f | 默认边框 |
--tx-border-color-light | #e4e7ed | #414243 | 浅边框 |
--tx-border-color-lighter | #ebeef5 | #363637 | 更浅边框 |
--tx-border-color-extra-light | #f2f6fc | #2b2b2c | 最浅边框 |
技术实现与规范延伸
- 样式源码:
packages/tuffex/packages/components/style/variables.scss,由@talex-touch/tuffex/base.css统一输出。 - 扩展深度概念手册:更深度的物理几何推导与代码实战详见
apps/nexus/content/docs/dev/concepts/专属专题板块。