前言¶
在使用 DeepSeek Harness (DSH) Web 客戶端時，默認的基礎背景往往較爲單調。dsh-client-background 插件接管了這一層，用 Unsplash 上精選的隨機圖片替換基礎背景，並通過半透明表面來展示圖片。
是什麼¶
這是一個由 imcp-pro 維護的 DSH Web 客戶端插件。它旨在爲 Web 界面提供動態、可定製的背景層，不依賴框架，僅使用瀏覽器原生 API 實現。
核心功能¶
- 精選壁紙輪播：內置 100 張精選壁紙，支持配置間隔自動切換。
- 運行時控制：可以在不卸載插件的情況下通過設置面板開啓或關閉背景效果。
- 客戶端更新檢查：插件會定期輪詢 GitHub 倉庫，檢測新版本並提示具體的更新命令。
- 無框架耦合：視覺效果的實現僅依賴瀏覽器全局變量（
document、Image、setInterval），對宿主框架侵入性低。
安裝與啓用¶
安裝前請確保已配置 dsh 的 web profile，並且該 profile 包含 web-app bundle。
官方安裝命令：
dsh plugin --profile web add github:imcp-pro/dsh-client-background
注意：從 GitHub 安裝時，prepare 腳本會在安裝時構建 lib/ 目錄。如果使用 pnpm ≥ 10，可能會遇到 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 錯誤。此時需要將錯誤提示中生成的 allowBuilds 鍵添加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 中。
配置與用法¶
安裝後，通過設置面板進行配置：
- 打開 Settings → Plugins → Plugin list。
- 展開 Wallpaper background（在 Global plugins 下）。
- 調整以下字段：
| 字段 | 默認值 | 說明 |
|---|---|---|
| Enable background | on | 運行時開關，關閉效果但不卸載插件 |
| Rotation interval | 20 | 圖片自動切換的間隔（秒） |
| Check for updates | off | 是否開啓自動更新檢查 |
| Check interval | 21600 | 更新檢查的間隔（秒） |
修改保存後立即生效。
注意事項¶
- 即時切換：圖片切換爲即時刷新，沒有淡入淡出動畫，但通過預加載機制減少了加載時的閃爍。
- iOS Safari 兼容性：在 iOS Safari 上，
background-attachment: fixed樣式會被忽略，圖片會隨頁面內容一起滾動。 - 更新機制：更新檢查是純客戶端行爲，瀏覽器直接對比 GitHub 默認分支的提交與構建時嵌入的提交哈希，不會修改正在運行的安裝實例。
- 主題適配：插件會自動跟隨 DSH 的主題切換（亮色模式顯示半透明白，暗色模式顯示半透黑），但暗色模式通常能提供更好的視覺對比度。
總結¶
該插件通過輕量級的方式爲 DSH Web 客戶端增加了視覺豐富度，適合希望快速定製界面風格的開發者或用戶。
