[Aswellle]

概要

浮窗材质改造的前两步：接入 macOS 原生 Liquid Glass，并把「玻璃质感」与「正文可读性」拆成两套独立配方。

依赖升级

• Tauri 2.10.3 → 2.12.5，连带 tauri-utils 2.10.2、window-vibrancy 0.8.1、wry 0.57、tao 0.37
• 前端 @tauri-apps/api / cli → 2.12.4
• 版本下限锁到 2.12：更早的 Effect 枚举里没有 LiquidGlass 变体

macOS 原生材质

• 同时声明 LiquidGlassRegular 与 Popover：macOS 26+ 用原生 Liquid Glass，15 及以下由 Tauri 自动回退
• 两项必须成对声明，只留前者会让旧系统完全没有材质；这段回退在 Tauri 内部，Windows 上的测试看不见，因此补了单测锁住契约
• 材质状态维持 FollowsWindowActiveState：浮窗不可聚焦，会稳定渲染偏淡的 inactive 外观

建窗时序

• 改为始终隐藏、材质走 builder 的 effects()、最后按需 show()
• 原先 visible(true) 让窗口在 build() 返回前就可见，而材质是投递到主线程队列后才施加，首帧是一块没有玻璃的透明板

材质可观测性

• 原 popup_material_unavailable 是死代码：Tauri 内层用 let _ = 丢弃错误，set_window_effects 恒返回 Ok
• 改为建窗时记录 popup_material_decision，能区分本机打算用哪一档

玻璃层与阅读层分离

• --popup-bg 原先同时承担「玻璃染色」和「文字衬底」：想读清字就得加厚整块面板，玻璃随之闷成色板
• 拆成 --popup-glass-*（极薄染色、边缘高光、外阴影）与 --popup-reading-*（正文局部衬底）
• 新增 .popup-reading-surface，只铺正文区域，标题栏与操作栏保持通透
• 译文、骨架、错误信息三处统一套用，避免状态切换时衬底有无不一致

对比度实测

按 WCAG 相对亮度公式，取系统材质合成后的像素值：

主题	最坏背景	修复前	修复后
深色	纯白桌面	4.54:1	5.25:1
浅色	纯黑桌面	5.34:1	5.34:1

深色主题原配方仅比 4.5 门槛高 0.04，不足以覆盖不同 DPI 与系统缩放的合成偏差。改为 0.58 衬底 + 纯白正文。正文色提取为 --popup-text-primary，只作用于阅读衬底内，设置页等其他深色界面仍用 #F5F5F7。

高度余量

阅读衬底带来 padding 与内描边，译文 maxHeight 360 会让容器总高达到约 497px，超过后端 MAX_HEIGHT=480。被 clamp 的后果是滚动区被压扁。降到 300 后容器 416px，余量 64px，仍可显示约 11 行中文。

验证

• npx tsc --noEmit 通过
• npm test 4 个文件 / 25 个用例通过
• npm run build 通过
• cargo fmt --check 通过
• cargo clippy -- -D warnings 通过
• cargo test --lib 232 个用例通过（新增 1 个材质契约测试）

Windows 实机：材质决策日志顺序正确、Acrylic 生效（DWM backdrop=3）、深色下 immersiveDark=1、折叠 166→44→168、Escape 关闭、隐藏后重新弹出、拖拽禁区契约完好。

未验证

• macOS 全部视觉项：本机无 macOS 设备，Liquid Glass 是否出现、Popover 回退是否正确、首帧是否无错色，全部未验证。CI 的 macOS job 只能证明编译。
• 对比度采用 CSS 合成计算，未做真实桌面壁纸采样（当前环境无法让桌面完整露出）。