前言¶

DeepSeek Harness（DSH）通過插件機制擴展功能。默認的靜態界面往往難以提供沉浸感。b-tq/dsh-wallpaper 插件旨在解決這一問題，它允許用戶將本地視頻或圖片作爲全屏動態背景，通過調節參數獲得更好的視覺效果。

功能概覽¶

該插件具備以下能力：
* 全屏動態壁紙：視頻靜音循環播放，圖片平鋪全屏。
* 效果調節：支持調節遮罩暗度、面板透明度、縮放模式（填充/適應/拉伸）。
* 一鍵切換：在壁紙庫列表中點選即用，或隨時刪除。
* 上傳導入：支持本地上傳（mp4/webm/gif/jpg/png/webp，上限 1GB）及 Wallpaper Engine 工坊掃描導入。
* 永久保存：設置寫入 ~/.dsh/wallpaper-config.json，重啓後不丟失。
* 輕量無依賴：不依賴僅限 macOS/Linux 的包，Windows 原生可跑。

安裝與啓用¶

前置要求：已安裝 DeepSeek Harness（dsh web 能正常打開），Node.js >= 22.19。

使用一條命令即可自動註冊：

dsh plugin --profile web add "github:B-TQ/dsh-wallpaper"

安裝完成後，強制刷新瀏覽器（Ctrl + Shift + R），在設置菜單中找到「動態壁紙」即可看到插件界面。

使用方法¶

進入 設置 → 動態壁紙，即可控制壁紙。

1. 開關與庫：開啓總開關。在壁紙庫中查看 ~/.dsh/wallpapers 下的文件，點擊使用立即切換，或刪除不需要的文件。
2. 上傳本地文件：點擊上傳，選擇本地視頻或圖片，文件會自動入庫並設爲當前壁紙。
3. 掃描工坊：點擊掃描，插件會查找 Wallpaper Engine 工坊中的壁紙並導入。
4. 效果調節：調節遮罩暗度、面板透明度、縮放模式，改動實時生效。

配置與注意事項¶

工坊目錄掃描：默認掃描 D:\steam\steamapps\workshop\content\431960。若 Steam 庫路徑不同，可設置環境變量 DSH_WALLPAPER_WORKSHOP_ROOT 指定路徑。

常見問題：
* Windows 報錯 EBADPLATFORM：因不依賴僅限 macOS/Linux 的包，此錯誤可忽略。
* 設置頁空白：瀏覽器緩存問題，請強制刷新。

卸載¶

1. 刪除 ~/.dsh/profiles/web/cordis.patch.yml 中的 wallpaper 條目。
2. 刪除 ~/.dsh/profiles/web/package.json 中的 dsh-wallpaper 依賴行。
3. 刪除鏈接及源碼目錄 ~/.dsh/plugins/dsh-wallpaper。

結語¶

該插件爲 DSH 提供了輕量級的動態背景方案。更多細節可查看插件目錄或源碼。