前言¶
DeepSeek Harness（DSH）的 Web 界面默認是純色背景。長時間盯着對話區、軌跡區或側邊欄工作時，界面容易顯得單調；若只想給某個區域換一張圖，又往往得改全局樣式或自己寫 CSS，維護成本高。
dsh-plugin-background 是 gameswu 維護的 DSH 壁紙插件，在 SkillHub 社區目錄中歸類爲「趣味換裝」。它借鑑 VSCode 的 background 擴展思路，爲對話區、軌跡區、側邊欄、設置頁等界面區域分別配置背景，支持圖片輪播與靜音視頻，並在設置頁提供獨立管理入口。
這是什麼¶
dsh-plugin-background（當前版本 0.2.1，MIT 許可證）是一個面向 DSH Web 平臺的客戶端插件。它以組合包形式發佈（dsh.bundle + cordis.patch.yml），通過 Cordis 補丁層注入 Web 界面，在 設置 → 插件 → 背景 中提供配置界面。
維護者 gameswu 在 GitHub 上開源該倉庫；SkillHub 目錄頁與 GitHub 倉庫爲同一插件的不同入口，社區目錄由 SkillHub 運營，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
下面介紹插件已實現的背景管理能力，均來自倉庫 README 與 package.json 說明。
按區域獨立配置¶
每個界面區域可擁有一套獨立背景。圖片組按 PPT 式輪播切換；視頻組靜音循環播放。每組只含一種媒體類型（圖片或視頻，不混用）。
支持的區域包括對話區、軌跡區、側邊欄、設置頁等；若已安裝 dsh-plugin-vscode-sidebar，其右側面板、下側面板整體以及其中每個標籤頁也可作爲獨立背景區域。
素材來源與持久化¶
添加背景時可：
- 粘貼 URL（逗號分隔多張）
- 選擇本地圖片或視頻
- 選擇整個文件夾
本地文件以 IndexedDB blob 形式存儲，刷新頁面後仍保留，不採用 base64 打包。
勾選多個區域後添加，同一批素材可一次落到多個區域。
單張圖片的顯示參數¶
點擊縮略圖進入編輯器，可爲每張圖單獨設置：
- 顯示模式：填充、適應、拉伸、平鋪、居中、自定義
- 不透明度、模糊
- 自定義模式下還可調整位置、縮放、尺寸、重複、旋轉、圓角等（見
package.json描述）
輪播與切換¶
可配置輪播間隔、順序或隨機播放，並手動切換下一張。切換前會預加載並交叉淡入，避免閃空。
跨區域合併¶
在表面列表中，把一個區域行拖到另一個區域行上，可合併爲一張跨區域大圖（類似多顯示器壁紙效果）；拖出即拆分。
安裝與啓用¶
本插件是自帶補丁層的組合包。用 dsh plugin 安裝即可——命令把參數轉發給 profile 的 pnpm，並自動把包掛載進 dsh.profile.bundles，無需手動編輯配置文件。
從本地路徑安裝（<路徑>/background 爲本倉庫目錄）：
dsh plugin --profile web add <路徑>/background
從 GitHub 安裝時，建議鎖定 commit：
dsh plugin --profile web add github:gameswu/dsh-plugin-background#<sha>
從 GitHub 安裝時，pnpm 會在安裝後運行本包的 prepare 腳本以構建 lib/client.js。pnpm ≥10 默認拒絕執行此類腳本，首次 add 可能失敗並提示把包鍵加入該 profile 的 pnpm-workspace.yaml 後重試：
allowBuilds:
dsh-plugin-background: true
授權構建意味着安裝時會在本機執行該包的構建腳本，請只對可信來源授權。
安裝完成後重啓 Web 界面（dsh web）即可生效。
典型用法¶
打開 設置 → 插件 → 背景，按以下步驟配置：
- 在表面列表中點擊要配置的區域；勾選多行可一次添加到多個區域
- 粘貼圖片或視頻鏈接，或選擇本地文件
- 點擊縮略圖進入編輯器，調整顯示模式與參數
- 把一個區域行拖到另一個區域行上，即可合併爲跨區域大圖
若以本地路徑安裝（pnpm link），重新構建後硬刷新瀏覽器（Ctrl+Shift+R）即可看到變更，無需重啓服務。開發相關命令：
pnpm install # 安裝依賴
pnpm build # 打包 → lib/client.js
pnpm typecheck # 類型檢查
適用場景與注意¶
適合希望在 DSH Web 界面中按區域自定義壁紙、輪播圖或靜音背景視頻的用戶，尤其是長期開着對話區或軌跡區工作的智能體開發者。
使用前請注意：
- 插件以當前
dsh進程的權限在瀏覽器端運行，本地文件會寫入 IndexedDB；安裝前應閱讀源碼並確認 MIT 許可證 - 從 GitHub 安裝需授權
prepare構建腳本，僅對可信倉庫操作 - 跨區域合併與 vscode-sidebar 插件的獨立區域能力，依賴對應插件已正確安裝
結尾¶
dsh-plugin-background 把「每個區域一套背景、輪播與視頻、本地持久化、跨區域大圖」收斂到設置頁的一個入口，無需改全局 CSS。若你使用 DSH Web 界面且想給工作區加一點視覺區分，可以從下面鏈接查看目錄信息或閱讀源碼。
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/gameswu/dsh-plugin-background
- GitHub 倉庫：https://github.com/gameswu/dsh-plugin-background
