> 本模块随 Harness Research Studio 统一发布。安装、迁移和构建请以[根目录说明](../../README.md)为准。

# Harness 液态玻璃界面

**v0.2.0**，适配 **DeepSeek Harness Web 0.1.5-rc.2**。参考 [Apple Liquid Glass 材质设计](https://developer.apple.com/design/human-interface-guidelines/materials)，将玻璃用于浮动的导航、输入与操作层：真实背景模糊、透景、圆润高光边缘、轻阴影和局部跟随反光。浅色为清透白灰，深色为中性石墨灰，静态环境色从玻璃下透出。正文、公式和科研图表保持稳定的阅读层。

安装后默认启用。进入 **设置 → 通用设置 → 界面风格**，可选择「液态玻璃」「经典」，再选择「通透」「轻量」，并单独开关「轻动效」。通透默认开启有限区域模糊；轻量关闭插件的背景模糊和鼠标跟随，保留玻璃边缘、光泽及圆角，适合大量图表或较低配置电脑。颜色跟随 Harness 的浅色、深色或系统设置；本插件不会改写这些设置。外观偏好仅保存在当前浏览器，旧版偏好会保留。

鼠标高光只作用于当前指向的一个表面，更新上限 30 Hz；指针不动时没有动画循环或定时器，离开页面、切换经典／轻量、关闭动效时立即释放工作。系统开启「减少动态效果」时停用动效；减少透明度或不支持背景模糊时使用实色面板，强制高对比使用系统颜色。

模糊放在独立装饰伪元素上，不改变原生设置弹窗、工作区虚线框、模型与斜杠菜单的定位。正常页面只有侧栏、当前工具栏和输入区等少量区域采样背景；地图节点和每条消息不增加模糊层。打开设置时关闭底层玻璃采样，由设置遮罩处理背景。主题不创建 WebGL 画布或持续动态壁纸，不触发数学模型或图表重算。输入区反光会引起局部背景重绘，负载敏感时可选轻量档；不承诺所有设备上的固定帧率。

## 范围与维护

主题只通过官方 `theme.overrideTokens` 添加可撤销的颜色覆盖层，通过 `settings.general.item` 添加一行设置；不注册模型工具，不访问对话、文件或网络，不调用 `setTheme`。选择「经典」或卸载插件后会移除自己的覆盖层，不覆盖其他主题或原有明暗偏好。

玻璃布局样式使用公开的 `data-*` 标记，以及已核对的 0.1.5-rc.2 AppFrame、Sidebar、ConversationView、SettingsRoot 模块类。升级 Harness 后若原生模块类变化，可能只剩语义配色，需要重新核对这些少量样式；不会改写宿主代码。

会话地图 v0.2.1、数学实验室 v0.2.0 的适配随本主题提供，无需重装这两个插件。其他本地插件可在 `body[data-dsh-glass]` 下使用 `--dsh-glass-panel`、`--dsh-glass-raised`、`--dsh-glass-line`、`--dsh-glass-shadow`、`--dsh-glass-blur` 与 `--dsh-glass-accent`；`--dsh-glass-blur` 是完整 filter 值，不能再套 `blur()`。本实现以渐变边缘近似镜面／折射高光，不是 Apple 原生光学渲染器。

入口为本说明；源码位于 `src/`，生成文件为 `client.js` 和 `index.js`。本插件无第三方运行时依赖，React 由 Harness 提供。