dsh-theme-frost：DSH Web UI 的毛玻璃壁纸插件

DeepSeek Harness (DSH) 允许通过插件扩展 Web UI 功能。在开发或使用 Web UI 时，默认界面往往较为单调。dsh-theme-frost 插件解决了这一问题，它提供了一种轻量级的方式来定制界面背景和视觉风格。

插件介绍¶

这是一个 DSH Web UI 的壁纸插件。由 H2CO3w 维护。它的核心功能包括：
1. 将用户指定的图片设置为页面背景。
2. 将界面元素转换为毛玻璃效果，同时保持官方的配色方案。
3. 支持明暗主题切换。

核心功能¶

背景显示：支持多种图片格式，包括 png、jpg、jpeg、webp、gif、avif、bmp 和 svg。
界面样式：使用 CSS 实现毛玻璃效果，界面保持官方调色板。
主题支持：明暗主题共用一套代码，但可在配置中分别设置壁纸和参数。
配置调节：通过配置文件控制模糊度、透明度、图片亮度和饱和度。
即时生效：修改壁纸或配置后刷新页面即可，无需重启服务。

安装与启用¶

在安装前，请确保你的 DSH 版本为 0.2.0-rc.1 或更新。

    git clone https://github.com/H2CO3w/dsh-theme-frost.git ~/dsh-theme-frost

将插件链接到 DSH 的 Web 配置文件中：

    dsh plugin --profile web add link:$HOME/dsh-theme-frost

重启 dsh web 进程以使插件加载。

使用方法¶

使用该插件主要分为两步：

更换壁纸：将你想要作为背景的图片文件放入 wallpapers/ 目录。明暗主题可以在此目录下放置不同的图片。
调整效果：编辑 config.json 文件，调整模糊程度、透明度以及图片的亮度与饱和度。

完成上述任一操作后，刷新浏览器页面即可看到效果。

配置与文件夹结构¶

插件会在首次启动时自动生成 config.json 文件。

配置项说明¶

blur：背景模糊程度。
surfaceOpacity：主表面（UI 面板）的透明度。
panelOpacity：设置面板的透明度。
wallpaper：默认壁纸，留空则使用目录下第一个文件。
dark.wallpaper：暗色模式使用的壁纸。
light.wallpaper：亮色模式使用的壁纸。
dark.brightness / dark.saturate：暗色模式图片的亮度与饱和度。
light.brightness / light.saturate：亮色模式图片的亮度与饱和度。

如果 JSON 格式损坏或参数类型错误，插件会自动回退到默认值。

文件夹结构¶

dsh-theme-frost/
├── lib/              # 插件代码
├── wallpapers/       # 壁纸目录（包含示例图片 reimu.jpg 和 marisa.jpg）
├── config.json       # 配置文件（自动生成）
├── package.json      # 插件清单
├── cordis.patch.yml  # 挂载配置
├── test/             # 测试文件
└── README.md

适用场景与注意¶

系统要求：
- DSH 版本需为 0.2.0-rc.1 或更高。
- 浏览器需支持 CSS color-mix 属性（Chromium 111+、Firefox 113+、Safari 16.2+）。
许可证说明：
- 插件源码遵循 MIT 协议。
- 注意：捆绑在 wallpapers/ 目录下的示例图片文件（reimu.jpg 和 marisa.jpg）不受 MIT 协议覆盖。

dsh-theme-frost 是一个简单实用的工具，适合希望在 DSH Web UI 中快速实现个性化视觉体验的开发者。