前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者通過不同插件擴展功能。wallpaper-engine-dsh 是一個 DSH 插件包，旨在解決在 DSH Web 界面 (dsh web) 中直接使用 Wallpaper Engine 本地壁紙庫的需求。
該插件由維護者 Weilv-D 開發，通過將本地 Wallpaper Engine 的項目（視頻和網頁壁紙）渲染爲 Web 界面的背景，替代原本靜態或單一的資源。
核心功能¶
壁紙庫與搜索
插件啓動時會掃描本地 Wallpaper Engine 庫，網格列表會展示所有瀏覽器可渲染的壁紙（視頻和網頁）。搜索框支持通過標題或 Workshop ID 快速篩選。場景和應用程序壁紙（.pkg）因屬於私有格式且無法被瀏覽器渲染，不會被列出。
智能遮罩
爲了確保文字可讀性，插件內置了智能遮罩。遮罩顏色會根據 DSH 的深色或淺色主題自動切換（黑色或白色），且會定期採樣壁紙亮度。如果壁紙過於明亮或昏暗，遮罩會自動增強，同時增強邊框對比度和玻璃磨砂效果。
手動裁剪與調整
提供多種佈局選項：封面、包含、拉伸、原始、自由和鏡像。
- Fit 行：用於設置基礎佈局。
- Adjust：進入全屏編輯模式，支持滾輪縮放和拖拽平移。在固定佈局下裁剪會被限制以防止露邊。
實時調節滑塊
提供四項實時調節功能，即時生效並持久保存：
- Blur：模糊程度
- Scrim：遮罩強度
- Borders：邊框
- Glass：玻璃磨砂效果
旋轉列表
支持創建輪播列表。可以自定義間隔（1-120 分鐘）、播放順序（順序或隨機）。當列表中有至少兩個可用壁紙且開啓自動旋轉時，狀態欄會顯示運行狀態。
資源監控
界面頂部顯示實時的 FPS，並在幀率過低時給出提示。支持在標籤頁隱藏或電量低時自動暫停壁紙播放。prefers-reduced-motion 優先級也會控制視頻的初始播放狀態。
容錯播放
切換壁紙時支持平滑的淡入淡出。如果媒體解碼失敗，系統會重試一次，隨後回退到預覽靜態圖，並在狀態欄提示。刷新按鈕會重新解析 URL 並恢復播放位置。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add wallpaper-engine-dsh
安裝完成後，重啓 dsh web，進入 Settings → General → Wallpaper Engine 即可啓用。
典型用法¶
- 選擇壁紙：在縮略圖網格或搜索框中選擇壁紙，背景會實時淡入。
- 控制播放：使用暫停/播放控制視頻播放，使用關閉按鈕淡出背景，使用刷新按鈕重新掃描庫（新訂閱的 Workshop 內容無需刷新頁面）。
- 調節混合效果：通過滑塊調整模糊、遮罩、邊框和玻璃效果，使背景與文字融合更舒適。
- 調整構圖：先使用 Fit 行設置佈局，再使用 Adjust 功能進行精細的縮放和平移。
- 設置輪播：點擊 New 創建列表，從網格或導入 WE 播放列表填充，最後開啓 Auto-rotate。
- 查看資源：資源行顯示當前 FPS 及自動暫停的開關狀態。
注意事項¶
- 不支持的格式：場景和應用程序壁紙（.pkg）由於是私有格式且只能在 Wallpaper Engine 桌面端運行，當前版本無法顯示或渲染。
- 權限與來源：插件以 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
總結¶
wallpaper-engine-dsh 通過將 Wallpaper Engine 的視頻和網頁壁紙引入 DSH Web 界面，爲開發者提供了可視化的個性化背景方案。其智能遮罩、手動裁剪、輪播列表以及資源監控功能，使其在兼顧美觀的同時也保證了界面的穩定性與可讀性。
- 項目地址：https://github.com/Weilv-D/wallpaper-engine-dsh
- 目錄頁：https://www.skillhub.cn/plugins/Weilv-D/wallpaper-engine-dsh
