前言¶
DeepSeek Harness（DSH）是智能體開發與調試的核心界面工具。在長時間運行智能體或調試會話時，靜態的界面背景容易造成視覺疲勞。dsh-wallpaper-bg 插件爲 DSH 的 Web 界面（dsh web）和 0.2 版桌面端提供了一個獨立的動畫壁紙層，將瀏覽器 UI 懸浮在動態背景之上。
插件支持內置壁紙、自定義上傳和 Wallpaper Engine 壁紙庫三種來源。它不解析本地場景包，不生成緩存文件，視頻渲染在瀏覽器內完成。在淺色主題下會自動疊加半透明白色霧氣，深色主題下則應用變暗遮罩，以確保文字的可讀性。主對話頁面的「原生背景」開關可以一鍵清除這些遮罩和霧氣，讓壁紙完全透出。
核心功能¶
三種壁紙來源¶
- 內置壁紙：提供 10 張高分辨率 Unsplash 圖片，無需本地服務即可使用。
- 自定義上傳：支持本地圖片和視頻，存儲在 IndexedDB 中，刷新不丟失。插件通過擴展名檢測自動識別 MIME 類型爲空的文件（如
.mkv、.mov），將其作爲視頻渲染而非黑屏。自定義隊列僅支持圖片/視頻。 - WE 壁紙庫：只讀連接本地 Wallpaper Engine 庫（默認
http://127.0.0.1:8088），僅顯示已訂閱的壁紙。
播放隊列與渲染模式¶
- 播放隊列：從內置、自定義或 WE 庫的網格中拖拽壁紙到隊列中，開啓循環播放。隊列支持拖拽排序、點擊跳轉、單條移除和清空，內容持久化存儲。WE 隊列支持視頻、場景預覽圖、網頁和圖片。
- 三種渲染模式：
- 靜態圖片：封面適配。
- 視頻：使用
<video object-fit: cover>，通過 GPU 合成，無黑邊或變形。支持 4K 視頻優化。 - 場景預覽：顯示 WE 工坊的
preview.gif或preview.jpg。場景的完整動態效果建議通過 WE 的屏幕錄製工具錄製爲 MP4 並通過自定義上傳導入。 - 網頁壁紙：在瀏覽器內原生渲染
index.html。
性能與交互優化¶
- 零本地渲染與緩存：插件不解析
scene.pkg，不渲染場景幀，不烘焙視頻，也不截取桌面屏幕。無本地緩存文件夾。 - 黑閃消除：切換壁紙時使用 0.42 秒的交叉淡入淡出， incoming 壁紙預加載解碼後纔開始混合，舊圖層完全淡出後才移除。視頻路徑等待
requestVideoFrameCallback確保第一幀繪製後再進入，避免出現空白幀。 - 下一項預熱：當前項播放時，下一項已在後臺加載（網絡圖片下載解碼、WE 視頻緩衝、IndexedDB 讀取），切換時無需等待網絡。
- 白屏跳過：針對部分視頻（如 Arknights “喧鬧法則”）的開頭純白畫面，預熱階段檢測首個非白幀，從此處開始播放。
- 解碼器管理：退出圖層淡出時暫停解碼，待完全移除後才釋放視頻資源，防止連續切換導致 FPS 下降。
調節與開關¶
- 四項調節：
- 霧氣/遮罩：淺色主題爲半透明白色霧氣，深色主題爲變暗遮罩，隨 DSH 主題自動切換。
- 模糊：0–20px。
- 亮度：50–150%。
- 安全放大：0–10%，用於裁剪邊緣黑邊。
- 原生背景開關：主對話頁面的開關可一鍵清除霧氣、遮罩和半透明 UI 層面，展示完整壁紙，同時保持對話界面的清晰度。關閉後恢復之前的設置值。
安裝與使用¶
安裝¶
可以通過 DSH 的 CLI 執行安裝，或在桌面版的插件管理頁面輸入包名。
典型用法¶
- 設置循環播放：在「自定義上傳」或「WE 壁紙庫」標籤頁，將喜歡的壁紙拖入頂部的隊列中，調節循環時長（1–10 分鐘）。
- 調整顯示效果：在設置面板的「壁紙」標籤頁，根據喜好調節模糊度、亮度和安全放大比例。淺色模式下霧氣會自動疊加。
- 清除遮罩：在主對話頁面點擊「原生背景」開關，讓壁紙完全顯示，同時保持對話界面的清晰度。
- 使用 WE 庫：確保本地運行了 Wallpaper Engine 的 API 服務（不在 npm 包內，插件面板會提示），即可讀取本地訂閱的壁紙。
注意事項¶
- 權限與資源：插件以當前 DSH 進程權限運行。WE 壁紙庫來源需要
wallpaper-engine-api服務在本地運行。 - 桌面獨立性：DSH 內部的壁紙切換不會影響桌面壁紙，桌面壁紙的變化也不會反向同步到 DSH（除非使用「同步桌面壁紙」功能，但此功能在當前版本中被移除，目前僅作爲只讀展示）。
- 許可證：MIT 許可證。
- 性能：4K 視頻通過 GPU 合成實現，無需 CPU 逐幀繪製，性能開銷極低。
總結¶
dsh-wallpaper-bg 是一個爲 DeepSeek Harness 提供獨立動畫背景的插件。它通過三種來源、隊列播放、零緩存渲染和 GPU 優化，解決了靜態背景帶來的視覺疲勞問題，同時保持了界面的可讀性和穩定性。
- 插件主頁：https://www.skillhub.cn/plugins/nishuoyang/dsh-wallpaper-bg
- GitHub 倉庫：https://github.com/nishuoyang/dsh-wallpaper-bg
