dsh-thirteen-bg：DeepSeek Harness Web GUI 動態背景插件

前言¶

DeepSeek Harness（DSH）採用插件化架構，Web GUI 作爲其中的一部分也支持通過插件擴展功能。默認界面較爲簡潔，對於希望在開發或使用過程中增加視覺個性的用戶，靜態背景難以滿足需求。dsh-thirteen-bg 旨在爲 DSH Web GUI 提供動態背景支持，通過引入 GIF、視頻或靜態圖片，使界面具備類似 Live Wallpaper 的效果。

這是什麼¶

dsh-thirteen-bg 是一個由 feng78-boop 維護的 Live Wallpaper 插件，專門用於 DeepSeek Harness 的 Web GUI。它支持將本地文件或網絡鏈接的媒體資源設置爲瀏覽器窗口的動態背景，並內置了壓暗控制功能，以確保前景文字的可讀性。

核心功能¶

多格式支持：支持 GIF、動圖 WebP、APNG、靜態 PNG 以及 JPG 圖片，同時也支持 MP4、WebM 和 MOV 視頻。
自動格式識別：插件會根據文件擴展名或 MIME 類型自動判斷是使用圖片渲染還是視頻渲染。
渲染方式：
- 視頻：使用 HTML5 <video> 標籤渲染，配置爲靜音、循環播放、開啓硬件加速，並在切後臺時自動暫停。
- 圖片：使用 CSS background-image 渲染。
存儲機制：完全基於客戶端運行。設置參數保存在瀏覽器的 localStorage 中，用戶上傳的本地文件則存儲在 IndexedDB 中，支持不限大小的文件上傳。
壓暗滑塊：內置調節背景亮度的滑塊，防止背景過亮影響界面閱讀。

安裝與啓用¶

插件安裝後需重啓 Web 進程方可生效。

執行安裝命令：

    dsh plugin --profile web add dsh-thirteen-bg

安裝完成後，重啓 DSH Web 服務或直接刷新瀏覽器。
在瀏覽器中硬刷新頁面（Ctrl+F5）。
進入「設置」→「通用」，找到「動態背景」卡片。

典型用法¶

在「動態背景」卡片中，支持以下兩種操作：

上傳本地文件：點擊上傳按鈕選擇本地文件（支持不限大小的動圖或視頻）。
粘貼 URL：粘貼有效的 HTTP(S) 媒體鏈接。

設置生效後，使用滑塊調節背景的壓暗程度，以獲得最佳的視覺體驗。

注意事項¶

本地路徑限制：瀏覽器安全策略禁止直接使用本地文件路徑（如 C:\... 或 file:///...）作爲 URL。必須通過「上傳」按鈕選擇本地文件，遠程媒體纔可使用 URL。
兼容性：背景層是一個真實的 DOM 元素（div 或 video），掛載在 <html> 下，不佔用僞元素。因此它與 dsh-client-ui-skins、dsh-dream-skin 等依賴僞元素的皮膚插件零衝突，動態背景始終可見。
性能建議：爲保證流暢度，建議圖片長邊不超過 1920px，視頻分辨率控制在 1080p，文件體積建議在幾十 MB 以內。

參考資料¶

插件目錄：https://www.skillhub.cn/plugins/feng78-boop/dsh-thirteen-bg
源碼地址：https://github.com/feng78-boop/dsh-thirteen-bg