前言¶
DeepSeek Harness（DSH）默認界面偏工具向，長時間對着同一套配色工作時，有人會想換成自己的圖或漸變，又希望對話區文字仍然可讀。改客戶端文件或注入腳本既難維護，也和 DSH「一切皆插件」的方向不一致。下面介紹社區插件 dsh-private-background：通過官方插件接口註冊面板與樣式，在桌面版裏給工作區（可選整窗）換背景，素材只留在本機。
這是什麼¶
dsh-private-background 由維護者 lubanaishuxue 開發，在 SkillHub 插件目錄 中歸類爲「趣味換裝」。它解決的是：在 DeepSeek Harness 界面裏設置自定義壁紙——本地圖片、動圖（GIF / 動態 WebP / APNG）、視頻、漸變或純色，並調節模糊、壓暗、取景位置，以及面板 / 對話區 / 輸入框不透明度；可選液態玻璃質感。默認只作用於右側工作區，左側對話欄保持 DSH 原樣。
README 寫明：非官方插件，第三方開發，DSH 官方不提供支持；不修改客戶端文件、不注入腳本、不觸碰賬號與憑據，但安裝任何插件前仍建議查看源碼。當前資料中的版本爲 1.3.3，在 Windows + DSH 桌面版 0.2.1-rc.2 上開發和測試；macOS / Linux 未驗證。許可證爲 MIT。
核心功能¶
背景來源¶
| 類型 | 說明 |
|---|---|
| 關閉 | 恢復 DSH 原樣 |
| 圖片 | 圖庫中的靜圖、動圖或視頻 |
| 漸變 | 6 個內置預設：極光、夜幕、落日、深海、青檸、紙感 |
| 純色 | 6 個色板或自選顏色 |
添加文件時支持 JPG、PNG、GIF、WebP、MP4、WebM 等。靜圖會縮到約 2560px 寬再壓成 JPEG 存入 IndexedDB；動圖與視頻保留原始字節（單文件上限 96 MB），視頻用第一幀做封面與亮度判斷。同一份內容通過 SHA-256 指紋去重，不會重複入庫。
觀感與範圍¶
五條滑桿（質感爲「液態玻璃」時第五條變爲「玻璃模糊」）：
- 模糊 0–40px、壓暗 0–80%、面板不透明度 0–100%、對話區不透明度 0–100%、輸入框不透明度 0–100%（實心模式）或 玻璃模糊 0–40px（液態玻璃模式）。
- 默認：模糊 20、壓暗 15、面板 50、對話區 0、輸入框 50。
- 質感：實心（默認）或液態玻璃（磨砂半透明 + 高光，作用於輸入框、狀態欄、消息氣泡等）。
- 同時應用到左側對話欄：默認關；開啓後整窗鋪滿，左側欄也半透明。
- 字體顏色：跟隨主題 / 自動 / 淺色 / 深色 / 自定義；README 推薦在亮暗圖之間切換時用「自動」。
每張背景單獨記住模糊、壓暗、取景位置與各檔不透明度、質感；玻璃模糊、作用範圍、字體顏色爲全局共用。換壁紙時有約 0.6 秒淡入；系統開啓「減少動態效果」時動圖、視頻與過渡會相應受限。
隱私與存儲¶
圖片、動圖、視頻只寫入 DSH 頁面下的 IndexedDB，資料說明無網絡請求、無統計上報；卸載插件後存儲隨頁面清掉，也可在設置頁逐張刪除。
安裝與啓用¶
前置條件：Node.js ≥ 20、DSH 自帶 dsh 命令、pnpm 在 PATH 上（缺 pnpm 會報 pnpm was not found）。
桌面版安裝（命令來自項目 README）：
dsh plugin --profile desktop add github:lubanaishuxue/dsh-private-background
機器上沒有 git 時：
dsh plugin --profile desktop add https://github.com/lubanaishuxue/dsh-private-background/archive/refs/heads/main.tar.gz
從本地目錄安裝（自行改代碼時）：
dsh plugin --profile desktop add D:/path/to/dsh-private-background
裝完後需要 重啓 DSH（重新打開窗口不算）。入口有兩處，同一套表單：左欄底部壁紙圖標，或 設置 → 插件 → 界面背景。
插件以當前 DSH 進程權限運行；安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證。SkillHub 爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係。
典型用法¶
按 README「一分鐘上手」可復現如下：
- 點左欄底部的壁紙圖標。
- 背景類型選「圖片」。
- 點「添加圖片」，選擇本地文件。
- 拖 壓暗 和 面板不透明度，直到文字可讀（多數情況下先調壓暗，再微調面板，模糊可最後加）。
- 主體不在畫面中央時，在預覽圖上拖動調整取景，或使用「左右」「上下」滑桿。
- 若希望壁紙含左側對話欄，打開「同時應用到左側對話欄」。
改完即時生效並自動保存，無需「應用」按鈕或再次重啓。圖庫下方可用 瀏覽文件夾 批量列出文件夾內尚未入庫的圖片與視頻，逐張添加。
調參順序上，README 建議：先選圖 → 壓暗 → 面板不透明度 → 模糊 → 需要時再開液態玻璃並調玻璃模糊。
適用場景與注意¶
適合：希望在 DSH 桌面版用本地壁紙或漸變個性化界面、且在意素材不出本機的用戶。
注意：
- 作用範圍依賴 DSH 外殼 DOM 結構，宿主大改佈局可能失效；設置頁底部有
樣式 / 激活 / 框架 / 三欄診斷讀數，出現異常時可對照 README「出問題了」一節。 - 只改工作區時標題欄仍爲側欄色；視頻壁紙持續解碼，筆記本上更費電。
- WebP 在實現上按動圖路徑處理，靜態 WebP 可能佔用大於靜圖縮存後的體積。
- 左欄圖標無響應時，檢查 DSH 啓動日誌是否加載
dsh-private-background。
停用插件後界面改動撤回，設置仍留在本機直至卸載或清數據。
結尾¶
dsh-private-background 把壁紙、漸變、純色和可讀性調節收進一個官方插件面板裏，數據留在 IndexedDB，不上傳、不進會話。若要安裝或看更新說明，可打開 SkillHub 目錄頁 與 GitHub 倉庫。
