前言¶
DSH Web 界面默認的背景通常較爲簡單。對於希望利用本地 Wallpaper Engine 資源的開發者或用戶，需要一個方案將動態壁紙無縫集成到 dsh web 的後臺。該插件通過宿主與客戶端的協作，實現了壁紙的發現、渲染與界面融合。
插件介紹¶
這是一個 DSH 插件，核心功能是將本機 Wallpaper Engine 的壁紙變成 DSH 網頁界面的背景。
- 核心能力：支持 Video（直接播放）、Web（iframe 加載）、Scene（提取主紋理作爲靜態幀或實時渲染）三種類型。
- 維護者：elysia395。
- 開源協議：MIT。
核心功能¶
插件提供了從渲染到界面的完整控制能力：
- 實時渲染與降載：支持 Scene 和 Web 壁紙的實時渲染。具備高幀率源降載功能（轉碼爲 4K/AV1），可降低 GPU 佔用；支持遮擋暫停（最小化/失焦/電池供電時暫停）。
- iOS 風格液態玻璃界面：對設置窗口、字體、光標、吉祥物與側邊欄進行液態玻璃改造，支持配色、玻璃顏色與透明度調節。
- 壁紙管理：自動發現本機 Wallpaper Engine 安裝。支持內容分級與類型過濾（全部/Everyone/PG13/Mature/未分級，全部/視頻/網頁/圖片/場景）。支持自定義壁紙上傳，具備黑膠唱片展示、視頻倍速與翻轉、自動輪播功能。
安裝與啓用¶
安裝插件需要使用官方命令行工具。
- 執行安裝命令：
dsh plugin --profile web add dsh-plugin-wallpaper-engine
- 安裝完成後，重啓
dsh web，進入 設置 即可看到 Wallpaper Engine 相關選項。
典型用法¶
- 啓用壁紙：重啓
dsh web並打開設置，壁紙即可被識別並使用。 - 選擇壁紙：使用選擇彈窗瀏覽壁紙縮略圖並選擇，支持批量隱藏與恢復。
- 控制播放：使用暫停/播放控制視頻壁紙，或使用關閉清除壁紙。
- 查看進度：在設置頁可以查看轉碼實時進度條。
注意事項¶
- 系統差異：macOS 原生沒有 Wallpaper Engine 客戶端，需使用社區維護的 macOS 版（如
dsh-plugin-wallpaper-engine-mac）。 - 類型限制：不支持 Application（應用）類壁紙。
- 兼容性：網頁壁紙在非官方桌面殼可能導致 403 錯誤。
- 依賴項：依賴 ffmpeg 進行高幀率轉碼。
- 前置更新：安裝前需更新 DSH 內核與
dsh-better-sidebar到最新版本。
結尾¶
該插件通過本地渲染與液態玻璃風格的結合，豐富了 DSH Web 界面的表現力。更多技術細節與源碼請參考插件目錄與 GitHub 倉庫。
