前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在构建或使用 DSH Web UI 时，除了核心的模型交互，界面的视觉呈现往往也是开发者或高频用户关注的重点。普通的背景修改往往伴随着性能损耗，或者破坏系统的原生主题逻辑。
dsh-liquid-glass-ui 插件旨在解决这些问题。它提供了一种基于 iOS 风格的液态玻璃透明效果，允许用户自定义背景并调整透明度，同时通过轻量级的渲染方式，在不影响流式输出性能的前提下实现个性化界面。
核心功能¶
该插件通过原生 DSH 服务进行集成，具备以下能力：
- 背景与图片支持：支持选择远程背景 URL，也允许上传本地图片（最大 4MB，以 Data URL 形式存储在设置文档中）。
- 视觉参数调整：提供玻璃不透明度、背景变暗程度、尺寸及位置的控制选项。
- 性能优化：使用轻量级的 alpha 混合技术，避免引入实时模糊或复杂的滤镜管道，防止在流式输出时触发全局重绘。
- 主题兼容：通过
theme.overrideTokens()与 DSH 原生主题配合。当插件被禁用或卸载时，系统会自动恢复原有的主题设置。 - 设置持久化与预览：修改内容在保存前可在设置卡片中实时预览，且设置会通过 DSH 原生用户设置服务持久化保存。
安装与启用¶
通过 npm 安装该插件：
dsh plugin --profile web add dsh-liquid-glass-ui
安装完成后，需要重启 dsh web 以加载插件。随后进入 Settings → Plugins → Liquid Glass Appearance 进行配置。
典型用法¶
在设置界面中，你可以选择上传一张本地图片，或者输入一个远程图片的 URL。系统会即时渲染出玻璃效果背景。根据需要调整滑块来改变玻璃的透明度和背景的亮度。配置完成后点击保存，界面即会应用新的外观。
适用场景与注意事项¶
适用场景：适合需要深度定制 DeepSeek Harness Web UI 视觉风格，同时希望保持系统轻量、不干扰流式输出的用户。
注意事项：
* 隐私风险：如果使用远程背景 URL，浏览器会直接请求该图片，可能会向图片托管服务暴露 DSH 用户的 IP 地址。建议在个人环境或信任的图片源下使用。
* 本地文件安全：本地上传的图片仅作为 Data URL 存储在 DSH 设置文档中，插件本身不会上传至外部服务。
* 弹窗权限：插件包含一个可选功能——在 DSH 会话开始新的思考步骤时，自动在独立标签页打开抖音或 Bilibili。此功能默认禁用。启用时，浏览器必须允许 DSH 站点的弹窗，且该娱乐网站会获得正常的网络元数据。
* 共享环境：由于配置文件中可能包含本地图片数据，请避免在共享计算机上设置敏感图片，并遵守配置的 DSH 设置提供者的访问控制规则。
结语¶
dsh-liquid-glass-ui 提供了一种在保持 DeepSeek Harness 核心功能稳定性的同时，提升界面美观度的方案。通过轻量级的渲染机制和良好的主题兼容性，它让 UI 定制变得可控且安全。
