前言¶

DeepSeek Harness 的 Web GUI 支持通过插件扩展功能。dsh-liquid-glass-wallpaper 是一个插件，用于读取本地 Wallpaper Engine 库并将其渲染为全屏液态玻璃背景。它提供霜、光泽、暗角和颗粒等效果，使浏览器界面看起来具有磨砂玻璃质感。

核心功能¶

插件通过读取本地文件来工作，不会上传或分发内容。

1. 读取本地库
   插件会自动发现 Wallpaper Engine 的安装位置（Steam 应用 431960），扫描 libraryfolders.vdf 和 appmanifest 文件，枚举 Workshop 内容、myprojects 和 defaultprojects 中的壁纸。

2. 液态玻璃渲染
   将壁纸渲染为全屏背景层，包含以下效果：

   • backdrop-filter: blur() 霜化效果。
   • 软光光泽。
   • 径向暗角，提升 Chrome 可读性。
   • SVG 电影颗粒层，消除模糊带。
   • 可选的指针视差效果。

3. 实时设置与控制
   在 Web GUI 中提供设置卡片（路径：设置 → 液态玻璃壁纸）。支持：

   • 搜索和类型筛选的壁纸网格。
   • 实时调整模糊、饱和度、色调和暗角滑块。
   • 切换颗粒、视差和适配模式（cover / contain）。

4. Range 流媒体
   视频文件使用 HTTP 206 Range 请求进行流式传输，避免加载整个 4K 文件，支持快速跳转和循环播放。

5. 状态记忆
   选择的壁纸和玻璃设置会保存在 localStorage 中，页面刷新或重新加载后自动恢复。

安装与启用¶

安装需要在 Windows 环境下进行，且需已安装 Wallpaper Engine。

1. 使用命令行安装
   确保已安装 Node 20+ 和 dsh CLI，运行以下命令：

    dsh plugin --profile <your-profile> add github:XINGRUYU33224/dsh-liquid-glass-wallpaper

这会将插件添加到指定配置文件的 bundle 列表中。

2. 使用安装脚本（可选）
   也可以直接克隆仓库并运行安装脚本：

    git clone https://github.com/XINGRUYU33224/dsh-liquid-glass-wallpaper.git
    cd dsh-liquid-glass-wallpaper
    pwsh -File install.ps1

3. 启用插件
   安装完成后，完全退出 DeepSeek Harness Desktop 应用（不能仅刷新页面），重新打开后即可在 设置 → 液态玻璃壁纸 中找到控制卡片。

典型用法¶

1. 打开 DSH 设置，进入 液态玻璃壁纸 卡片。
2. 在搜索框中输入关键词，或使用类型筛选器选择壁纸（视频、图片或网页）。
3. 点击“当前壁纸”条带选择要显示的文件。
4. 打开主开关启用背景。
5. 拖动滑块调整模糊半径、饱和度、色调和暗角强度，实时查看效果。

适用场景与注意¶

• 适用壁纸类型：支持视频、图片和网页壁纸。
• 不支持类型：场景壁纸（.pkg 文件）不支持。插件无法解析场景文件，且直接使用预览图会导致画质严重缩放。
• 平台限制：壁纸库的自动发现依赖 Steam 注册表和 libraryfolders.vdf，因此仅支持 Windows 系统。
• 版权与隐私：插件仅读取本地文件，不上传或分发任何内容。Workshop 内容版权归原作者所有。手动添加的路径不会写入磁盘。

结尾¶

该插件为 DeepSeek Harness 提供了一个基于本地 Wallpaper Engine 库的动态玻璃背景方案。它通过 CSS 滤镜和 Range 流技术实现了实时、流畅的视觉效果。更多细节及源码，请访问 GitHub 仓库。