前言¶
DeepSeek Harness (DSH) 桌面客戶端的默認背景通常較爲單調。如果你希望在開發或工作間隙使用本地圖片或視頻作爲動態壁紙，同時保持界面清晰可讀，dsh-client-ui-wallpaper 插件提供了一個直接的解決方案。它通過鋪滿窗口、背景模糊、獨立調節面板與側欄透明度，以及根據壁紙亮度自動切換文字顏色，解決了背景與內容可讀性衝突的問題。
核心功能¶
背景與佈局¶
- 鋪滿整窗：圖片或視頻按
object-fit: cover鋪滿窗口，彈窗保持不透明。 - 模糊與紗層：背景模糊支持 0–60px 調節，並可選紗層（淺色/深色外觀）。
- 獨立透明度：面板與右側欄透明度可分別調節（0–100%）。
智能顯示¶
- 墨水模式：根據壁紙亮度自動切換深色或淺色文字。
- 代碼塊適配：代碼塊只跟隨外觀調整，不受
pre.shiki透明背景干擾。
素材管理¶
- 靜態/動態分離：靜態圖片與同名視頻分開管理，網格中可一鍵切換。
- 輪換控制：支持輪換（間隔 15 秒–24 小時）與隨機輪換，支持手動選擇不打斷輪換。
- 自動入庫：新素材自動加入輪換列表。
穩定性保障¶
- 圖層自愈：每 10 秒審計一次壁紙層，回收殘留節點。
- 探針上報：通過
/_probe路由實時上報狀態。 - 大文件處理：超過 50MB 的素材不預熱。
- 錯誤上報：加載失敗與選擇器失效時通過探針靜默記錄，不靜默報錯。
安裝與啓用¶
本插件要求宿主 DSH 版本 >= 0.2.0-rc.2。
桌面客戶端安裝¶
DSH 的 desktop profile 由 Electron 應用獨佔管理，命令行會拒絕直接安裝。請在 設置 → 插件市場 中搜索並安裝 dsh-client-ui-wallpaper。
Web Profile / CLI 安裝¶
對於 web profile 或自建 profile，使用以下命令：
dsh plugin --profile web add dsh-client-ui-wallpaper
注意：命令需要 pnpm 在 PATH 中。
手動安裝¶
如果環境受限，可手動安裝：
npm i dsh-client-ui-wallpaper
node node_modules/dsh-client-ui-wallpaper/scripts/install.mjs --profile desktop
注意：手動修改配置可能被 DSH 覆蓋。
典型用法¶
使用 Dynamic Wallpaper.app 素材¶
默認配置下，插件會直接讀取 Dynamic Wallpaper.app 的素材庫：
~/Library/Containers/whbalzac.Dongtaizhuomian/Data/Documents/{Wallpaper,Videos}
使用自定義目錄¶
在配置文件中指定絕對路徑（插件不支持 ~ 展開）：
imageDir: /Users/you/.dsh/wallpapers
videoDir: /Users/you/.dsh/videos
同步播放列表¶
使用腳本同步 Dynamic Wallpaper.app 的播放列表：
./sync-wallpaper-playlist.sh
注意事項¶
- 權限要求：讀取同步目錄需要給 DSH 完全磁盤訪問權限。
- 路徑限制：配置路徑必須是絕對路徑。
- CLI 依賴：CLI 命令需要
pnpm在PATH。 - 升級限制：使用
dsh plugin add時需指定版本號以避免 pnpm 11 的 24 小時限制。 - 手動安裝風險：手動安裝的配置可能被插件管理器覆蓋。
結尾¶
該插件通過精細的圖層控制和探針監控，實現了對 DSH 桌面客戶端背景的深度定製。更多細節可參考 GitHub 倉庫。
