前言¶

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 倉庫。