视觉语言设计

桌面视觉的单一事实来源：尺寸、色彩、排版、图标、层级与主题自适应机制。所有数值为最终规格，实现不得自行调整；改数值先改本文档。

• 文档版本：1.0
• 定稿日期：2026-09-05

几何与间距 token

色彩 token

色彩定义在合成器的 float 线性域（0–1，每通道），8bit 十六进制仅为文档阅读近似值。全程 10bit 输出，任何环节无调色板。

深色玻璃档（dark）：

浅色玻璃档（light）：

强调色 accent：从壁纸主色提取，提取规则见下节；深浅两档共用同一提取结果，可读性校验失败时回退 accent.fallback。

主题自适应

跟随壁纸自动切换深/浅玻璃档，机制固定如下：

1. 采样：壁纸变更时（视频壁纸则每 2s）下采样至 64×64，取 Rec.709 亮度；用中位数而非平均，避免夜景单点光源、天空局部亮斑造成误判。
2. 判定：中位数亮度 L > 0.55 → 浅色档；L < 0.45 → 深色档；0.45–0.55 为滞回区间，维持当前档位，防止壁纸亮度在阈值附近时来回抖动。
3. 过渡：全部色彩 token 在 float 域逐帧插值 600ms（缓动见 interaction.md 的 duration.slow），切换连续无闪屏、无档位跳变。
4. 用户覆盖：设置中可选 自动（默认）/ 锁定深色 / 锁定浅色；锁定时跳过采样。

强调色提取：64×64 采样图直方图按出现频次加权取主色 → 饱和度钳制 S ≤ 0.60 → 亮度钳制 L 0.45–0.70 → 与 text.primary 校验对比度 ≥ 4.5:1，不满足则用 accent.fallback。深浅两档共用同一提取结果。

排版

字重档位：regular 400、medium 500、semibold 600，不做更细的字重档。

图标

• 系统图标：24px 网格线性风格，2px 描边，圆头圆角，随 text.primary 着色。
• 应用图标：Dock 内 44px，玻璃质感底座 + 内容层两层结构，内容层由应用自带。
• 运行指示：图标下方 4px 圆点；该应用有聚焦窗口时展开为 8px 长条。

显示缩放（HiDPI）

• 缩放档位：100% / 125% / 150% / 200%，每输出独立设置。
• 本文档全部像素值以 100% 缩放为基准，其余档位按比例放大，圆角与间距取整到物理像素。
• Qt6 应用按逻辑像素渲染，经输出 scale factor 换算缓冲尺寸；不感知缩放的应用由 Soke Display Server 声明输出 scale 供其自选。
• 截图与录屏按物理像素捕获。

色彩管理与 HDR

• 桌面默认色彩空间 sRGB（等效 gamma 2.2），以 10bpc 扫描输出。
• HDR 内容（HDR 视频壁纸、HDR 窗口）携带 PQ 曲线与 HDR 静态元数据，合成在 float 线性域完成 tone mapping 后输出。
• 8bit 应用面上采样至 16F 合成缓冲，再映射到 10bit 输出；全程禁止在 8bit 缓冲上做材质运算（防色带）。

z 序层级