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 中快速實現個性化視覺體驗的開發者。