前言¶
DeepSeek Harness（DSH）桌面端的聊天界面默認是純色或主題色背景，長時間對着同一套 UI 寫提示詞、看 agent 輸出，視覺疲勞很常見。換主題只能動配色，很難像桌面壁紙那樣用自己喜歡的圖鋪滿窗口，還要保證側欄文字仍然可讀。社區插件 dsh-chat-background 在本地運行，把背景圖、側欄遮罩、輸入欄裝飾和用量信息收進「設置 → 頁面設置」，不依賴外網資源。
下面介紹這個插件的定位、能力、安裝方式與日常使用要點。
這是什麼¶
dsh-chat-background 是 LittleLemonJam 維護的 DSH 桌面端插件，分類屬於社區目錄中的「趣味換裝」。它在 Web GUI 上疊加聊天背景圖，並附帶三欄獨立遮罩、背景輪換與分組、輸入欄背景條、任務進度條，以及全會話 Token 總用量顯示；各項均在「設置 → 頁面設置」裏調整。
插件以當前 DSH 進程權限在本機讀寫背景目錄與會話投影，安裝前建議在 GitHub 倉庫覈對源碼與 MIT 許可證。
核心功能¶
資料中列出的能力如下，均可在設置頁配置。
| 能力 | 說明 |
|---|---|
| 聊天背景 | 從背景文件夾選圖鋪滿界面；支持 png / apng / jpg / jpeg / webp / gif / avif / bmp / svg；GIF、動畫 WebP、APNG 會播放動畫 |
| 背景輪換 | 固定一張或自動輪換；輪換間隔 5–300 秒 |
| 切換特效 | 淡入淡出、漸變過渡、無；時長 0–3 秒 |
| 輪換分組 | 只輪換勾選的圖片；縮略圖、5 行滾動列表、拖動排序，勾選不改變順序 |
| 三欄遮罩 | 左側欄 / 主窗口 / 右側欄分別設置 0–100 遮罩不透明度 |
| 背景條 | 輸入欄下方一條等寬背景條，包住用量數據，可自定義顏色 |
| 任務進度條 | 有任務清單時顯示完成度，執行中按步數估算，空閒時隱藏 |
| Token 總用量 | 左下角顯示所有會話（含已歸檔）的累計 token 用量，可調字號 |
| 圖片滾輪縮放 | 聊天圖片燈箱、右側欄圖片預覽可滾輪縮放；燈箱雙擊還原 |
淺色 / 深色主題會自動適配；遮罩調到 100 時該區域完全不透明，調到 0 時完全顯示背景。右側欄全屏預覽時，左側欄保持可見，主窗口與原右欄變爲右欄內容，退出後恢復原佈局。
安裝與啓用¶
前置條件：DSH 桌面端 ≥ 0.2.1-rc.3。從源碼構建需要 Node ≥ 22.19，普通安裝不需要 Node。
從 GitHub 安裝（推薦）¶
在終端執行：
dsh plugin --profile desktop add github:LittleLemonJam/dsh-chat-background
從 npm 安裝¶
npm 包與 GitHub 發佈同步（當前 1.1.0），任選其一：
dsh plugin --profile desktop add dsh-chat-background
安裝後完全退出並重新打開 DSH 桌面端；宿主半在啓動時加載，只刷新頁面不夠。可在 插件 → 已安裝 確認 dsh-chat-background 處於啓用狀態。
背景圖目錄¶
圖片放在 ~/.dsh/backgrounds/（Windows 爲 C:\Users\<用戶名>\.dsh\backgrounds\）。也可用環境變量 DSH_BACKGROUNDS_DIR 指向其他目錄。目錄不存在時不必手動創建：第一次打開設置頁或點「打開文件夾」時插件會自動建好。放入圖片後，在 設置 → 頁面設置 → 背景 點「重新掃描」即可看到。
典型用法¶
- 固定或輪換背景：在「背景顯示方式」裏選擇。輪換時只使用「輪換分組」裏勾選的圖片；全部不勾選則使用整個背景庫。
- 調節可讀性：分別拖動左欄、主窗口、右欄遮罩，在壁紙與文字對比度之間取捨。
- 看 agent 進度：有任務清單時進度條按「已完成 / 總數」顯示；沒有清單但正在執行時按本輪步數估算（最高 92%）；空閒時隱藏。
- 看累計 Token：左下角彙總所有會話（含已歸檔）的 token 用量，每 10 秒緩存、每分鐘刷新；數據只在本機讀取。
適用場景與注意¶
適合希望在 DSH 桌面端長期使用、又想把聊天窗口做成「帶壁紙的工作臺」的用戶。背景與 Token 數據均本地處理；插件不訪問互聯網、不讀取憑據，HTTP 路由默認只監聽本機迴環地址。
若通過非迴環地址（反向代理或遠程訪問）打開 GUI，圖片與 Token 路由默認會被請求柵欄拒絕。需在可信代理環境下設置 DSH_CHAT_BACKGROUND_ALLOWED_HOSTS=<你的主機名> 後再使用。
兼容性方面，資料記載已驗證 DSH 0.2.1-rc.3（Electron 44 / Node 24），支持 Windows / macOS / Linux 桌面端。SVG 以沙箱 CSP 提供；文件名、圖片大小、目錄掃描數量和會話文件大小均有上限，細節見倉庫 SECURITY.md。
結尾¶
dsh-chat-background 把壁紙式背景、側欄柔化和小型用量 UI 收進同一套頁面設置，適合在不動核心對話邏輯的前提下給 DSH 桌面端換膚。社區目錄頁：https://www.skillhub.cn/plugins/LittleLemonJam/dsh-chat-background；源碼與完整說明：https://github.com/LittleLemonJam/dsh-chat-background。
