在 DSH（DeepSeek Harness）的開發與調試流程中，Web 界面的視覺呈現往往是定製化需求的起點。雖然 DSH 提供了基礎的插件架構，但默認的背景樣式較爲單一。dsh-whale-background 插件旨在解決這一問題，爲 DSH Web GUI 提供深海鯨魚娘主題壁紙，並支持應用半透明磨砂效果，允許開發者自定義背景圖片、透明度及鋪放方式。
插件定位¶
這是一個針對 DSH Web GUI 的背景擴展插件，屬於「趣味換裝」類別。由開發者 tuogusa 維護，採用 MIT 許可證。它通過注入 CSS 樣式和模板，改變應用表面的視覺呈現，不涉及核心邏輯修改。
核心功能¶
- 內置鯨魚壁紙：插件包含默認的深海鯨魚娘壁紙，該圖片在構建時被內聯爲 Base64，因此無需加載外部資源即可直接使用。
- 設置頁自定義背景：進入 DSH Web 的設置頁即可操作。
- 本地圖片：選擇本地文件，插件會自動將其轉換爲 data URL。
- 遠程圖片：粘貼圖片 URL，插件會進行預加載檢查，若加載失敗會明確提示。遠程圖片加載時會自動添加
no-referrer策略，以降低防盜鏈影響。
- 恢復與清除：支持一鍵清除自定義圖片設置，恢復至內置的鯨魚壁紙。
- 表面透明度：提供 0-100% 的滑塊，實時調節應用表面的透明度，實現磨砂玻璃效果。
- 鋪放方式：支持背景圖片的鋪放邏輯選擇。
contain：完整顯示圖片，兩側留白。cover：鋪滿全屏，裁切多餘部分。
- 持久化存儲：所有配置（背景圖、透明度、鋪放方式）保存在瀏覽器的
localStorage中，刷新頁面或重啓 DSH 後設置依然存在。
安裝與配置¶
安裝插件¶
插件僅兼容 Profile web（DSH Web GUI）。安裝時請使用以下命令：
dsh plugin --profile web add github:tuogusa/dsh-whale-background
安裝完成後，重啓 DSH 並按 Ctrl+Shift+R 刷新瀏覽器（若未連接 HMR）。
更新插件¶
如需更新到最新版本，可以使用 CLI 命令：
dsh plugin --profile web update dsh-whale-background
自定義壁紙（開發者操作）¶
如果你希望替換默認的鯨魚壁紙，可以直接替換源碼中的圖片文件。
- 將新的壁紙圖片（支持 JPG/PNG/WebP/GIF）覆蓋到
assets/wallpaper.jpg。 - 執行構建腳本重新生成客戶端代碼：
node build.js
這會重新生成 lib/client.js，將新壁紙內聯進去。若已連接 HMR，更新會自動生效；否則需刷新瀏覽器。
使用說明¶
安裝並重啓後，進入 DSH Web 界面：
- 點擊右上角設置按鈕。
- 找到「背景」選項卡。
- 在此頁面進行以下操作：
- 更換背景：點擊「選擇文件」上傳本地圖片，或粘貼 URL。
- 調節透明度：拖動滑塊調整磨砂效果強度。
- 調整鋪放：選擇
contain或cover模式。 - 恢復默認：點擊「恢復默認」按鈕清除所有自定義設置。
注意事項¶
- 兼容性：僅適用於 DSH Web GUI，不兼容其他 Profile。
- 網絡策略：遠程圖片加載使用了
no-referrer策略，這是爲了減少因 Referer 簽名導致的防盜鏈攔截。 - 刷新機制：如果在未連接 HMR 的情況下修改了插件源碼或配置，建議使用
Ctrl+Shift+R強制刷新瀏覽器以確保樣式生效。
該插件爲開發者提供了一個輕量級的 UI 定製方案，通過簡單的配置即可改變 DSH Web 的視覺風格。更多細節與源碼，可參考插件目錄或 GitHub 倉庫。
