dsh-wallpaper-rotator (Enhanced)

前言¶

DeepSeek Harness (DSH) 採用插件化架構，允許開發者通過插件擴展 Web UI 的表現層。在開發或使用 Web UI 時，背景壁紙直接影響視覺沉浸感。原版插件僅支持靜態圖片，且存在毛玻璃模糊失效、視頻轉圖片過渡黑屏等技術缺陷，導致在複雜界面下可讀性不足。本插件在原版基礎上進行二開，重點修復了渲染兼容性問題並增強了多媒體支持。

是什麼¶

dsh-wallpaper-rotator (Enhanced) 是基於 liceses/dsh-wallpaper-rotator 的二開增強版。它作爲 DSH Web UI 插件運行，旨在解決動態背景下的渲染穩定性與多媒體支持問題，同時保持原版的 MIT 許可證授權。

核心功能¶

本插件通過以下機制提升背景切換體驗與界面可讀性：

多媒體支持與無縫切換
- 支持 mp4、webm、mov、m4v 格式的視頻背景，自動循環靜音播放。
- 圖片與視頻在輪換過程中通過淡入淡出效果無縫銜接，避免視覺突兀。
視頻層獨立渲染
- 視頻層擁有獨立的壓暗層，與圖片層共用“壁紙壓暗”設置。切換至視頻背景時，壓暗漸變不會丟失。
- “毛玻璃模糊”設置對視頻層同樣生效（已修復原版 CSS 語法錯誤）。
- 單個視頻文件上限放寬至 1GB（圖片仍爲 64MB）。
表面中和
- 新增自動清除大尺寸不透明面板背景的功能。側邊欄、文件樹、繪畫面板、輸入條等面板的背景色會被自動設爲透明，使壁紙鋪滿整個頁面。
- 識別純色、半透明及漸變背景，並清除裝飾性的淡出蒙層。
- 使用 data-wp-neutralized 標記和 CSS !important 確保在 React 重渲染時保持透明度，同時保護插件自身的視頻層不被誤清除。
兼容性與修復
- 毛玻璃修復：修正了原版 filter: blur(blur(8px)) 的非法 CSS 寫法，使模糊滑塊恢復正常工作。
- 黑屏修復：解決了視頻轉圖片輪換結束時 cur 圖層不透明度未恢復導致的黑屏問題。
- rc.6 兼容：移除已廢棄的 client timer 服務，改用原生 setInterval、setTimeout 及自實現的 debounce，確保在較新的 DSH 版本（rc.6）中能正常加載。

安裝與啓用¶

使用官方命令行工具安裝插件：

dsh plugin --profile web add github:Jieice/dsh-wallpaper-rotator-enhanced

安裝完成後，重啓 dsh web，進入 設置 → 壁紙輪換 即可開始配置。

典型用法¶

配置數據持久化存儲在 $DSH_HOME/wallpaper-rotator.json。可配置項包括：

資源管理：壁紙文件夾路徑（支持圖片與視頻混合），輪換間隔（秒/分/時），順序或隨機。
界面調節：面板透明度、壁紙壓暗程度、毛玻璃模糊半徑（0-24px）、文字陰影樣式。

注意事項¶

本插件二開版本全部使用原生定時器實現，不再依賴廢棄的 client 服務。
視頻文件較大（上限 1GB），加載速度取決於網絡帶寬與主機性能。
插件以當前 dsh 進程的權限運行，安裝前建議檢查源碼與許可證。

結語¶

dsh-wallpaper-rotator (Enhanced) 爲 DSH Web UI 提供了從靜態到動態、從單一到混合的完整壁紙解決方案。通過修復渲染細節並引入視頻支持，它提升了界面的美觀度與實用性。更多細節可查閱插件目錄或源碼倉庫。