前言¶
DeepSeek Harness（DSH）的 Web GUI 使用 --dsw-* 系列的設計 token，界面配色是固定的，沒有提供設置壁紙的入口。同時，wallhaven.cc 這類圖站在很多網絡環境下屬於“瀏覽器打不開、命令行也打不開”的那一類——通常涉及 DNS 污染或需要特定代理。
本插件通過將搜索與圖片獲取轉移到 DSH 宿主進程，解決了這兩個問題。瀏覽器不需要直接訪問 wallhaven，宿主端負責取圖，插件通過路由與宿主通信，從而在設置頁提供搜索和設置背景的功能。
安裝與啓用¶
安裝前需要確認當前使用的 profile。桌面版只會啓動 desktop profile，命令行工具使用 web profile。
# DeepSeek Harness 桌面版
dsh plugin --profile desktop add github:HaydenSmith1121/dsh-wallhaven-wallpaper
# dsh web / dsh tui 命令行
dsh plugin --profile web add github:HaydenSmith1121/dsh-wallhaven-wallpaper
安裝後重啓 Harness 生效。
核心功能¶
- 搜索與設爲背景：在設置頁搜索 wallhaven，點擊縮略圖即可將圖片鋪滿界面背景。
- 宿主端取圖：宿主端負責調用 API 和獲取圖片字節，瀏覽器僅與本地插件路由通信，因此即使瀏覽器被網絡策略限制，壁紙依然能顯示。
- 代理支持：支持自動探測可用代理（掃描常見端口）或手動填寫代理地址。宿主端實現 HTTP CONNECT 隧道，支持複用環境變量
HTTPS_PROXY。 - 下載與外觀：支持一鍵下載原圖到本地；提供透明度、模糊、變暗遮罩控制。
- 分級過濾：支持 API Key 過濾分級，默認只搜索 SFW 內容。
典型用法¶
- 打開 設置 -> 壁紙。
- 在搜索框輸入關鍵詞或選擇分類，點擊縮略圖將圖片設爲背景。
- 如需下載原圖，點擊“下載原圖”按鈕，文件將保存到默認目錄（如
圖片/DSH Wallpapers）或指定的下載目錄。 - 如遇網絡問題，打開 設置 -> 訪問 -> 代理，可以手動填寫代理地址，或點擊自動探測結果。
- 在 外觀 設置中調整透明度、模糊度和遮罩，以平衡壁紙顯示與界面文字的可讀性。
技術細節與限制¶
- 兼容性探測：插件按接口探測兼容性，不按版本號判斷。若某接口缺失，會在設置頁的“兼容性”欄目中顯示，但不會導致插件失效。
- 網絡邊界：只允許
w.wallhaven.cc和th.wallhaven.cc兩個域名。寫操作（如配置修改、下載）要求同源，確保安全性。 - 資源佔用：不觸碰模型，不影響 KV cache；零運行時依賴。配置文件存儲在
$DSH_HOME/storages/dsh-wallhaven-wallpaper/，縮略圖緩存也會存放在該目錄下。
結語¶
這是一個輕量級的插件，通過將網絡請求從瀏覽器移至宿主端，解決了在受限網絡環境下更換壁紙的需求。
