前言¶
DeepSeek Harness (dsh) 是一個插件驅動的平臺，雖然它提供了核心的智能體開發與調試能力，但默認的 Web 界面視覺風格較爲單一。在長時間使用或需要定製工作區時，缺乏原生支持的壁紙主題方案往往需要依賴第三方瀏覽器擴展或手動修改代碼。zoyluoblue/deepseek-harness-avatar 插件解決了這一痛點，它允許用戶在設置頁面直接上傳圖片作爲 Web UI 背景，並提供可調節的可讀性遮罩和模糊效果，以保證界面元素的清晰度。
這是什麼¶
這是一個爲 DeepSeek Harness (dsh) 提供壁紙主題功能的插件，由用戶 zoytown 維護。它允許用戶在 Web 界面中上傳圖片，將其渲染爲整個 UI 的背景，並提供可調節的可讀性遮罩、背景模糊和填充模式。
核心功能¶
-
圖片上傳與管理
- 支持在設置頁點擊或拖拽上傳圖片（支持 png/jpg/webp/gif 格式，默認單文件限制 20MB）。
- 提供畫廊功能，顯示所有已上傳圖片的縮略圖。
- 在畫廊中點擊縮略圖即可應用壁紙，懸停可刪除。選擇 ‘None’ 可恢復默認純色背景。
-
可讀性控制
- 提供“可讀性遮罩”滑塊：使 UI 元素保持半透明，從而突出背景圖片。
- 提供“模糊”滑塊：柔化背景圖像，減少視覺干擾。
- 支持“填充模式”選擇：包括 Fill（填充）、Fit（適應）和 Tile（平鋪）。
-
主題自適應與存儲
- 遮罩顏色會根據 dsh 的淺色或深色主題自動調整。
- 圖片採用內容尋址方式存儲在本地目錄，不上傳任何數據。
安裝與啓用¶
通過官方命令安裝插件：
dsh plugin --profile web add @zoytown/dsh-avatar
安裝完成後，打開 dsh Web 界面的 設置 -> 背景 頁面即可開始使用。
典型用法¶
- 應用壁紙：在設置頁面上傳圖片，點擊縮略圖應用。
- 調整顯示效果：拖動“可讀性遮罩”或“模糊”滑塊，或更改填充模式，以改善文字可讀性。
- 恢復默認：在畫廊中選擇 ‘None’，恢復純色背景。
適用場景與注意¶
- 環境限制：僅支持 dsh 的 Web 界面。Electron 桌面應用不支持此插件。
- 遠程訪問限制：通過非 Loopback（非本地迴環）的遠程瀏覽器訪問時，插件僅處於只讀模式，無法應用壁紙。
- 隱私安全：所有圖片和設置均存儲在本地，不上傳任何數據到外部服務器。
該插件通過本地化存儲和簡單的 UI 控制，爲 dsh Web 界面提供了輕量級的視覺定製方案。所有文件存儲在 ~/.dsh/avatar/ 目錄下。
