dsh-wallpaper：給 DeepSeek Harness 桌面端換一張自定義壁紙

前言¶

DeepSeek Harness（DSH）的桌面應用默認是統一的界面背景，用久了難免單調。對按「一切皆插件」理念構建的 DSH 來說，這類外觀定製不需要改動主程序，裝一個插件就能解決。

下面介紹的就是這樣一款插件：dsh-wallpaper，作者 keke050，許可證爲 MIT。它的作用是給 DeepSeek Harness 桌面應用設置自定義背景壁紙，支持預設、圖片 URL、本地上傳三種來源，並提供透明度滑塊控制壁紙的顯示強度。

dsh-wallpaper 是一個 DSH 插件，當前版本爲 0.1.0，客戶端平臺爲 web（安裝時需要指定 --profile web）。它解決的問題是：讓桌面應用的背景可以自定義，並且壁紙能透過對話區域顯示，而不只是停留在側邊欄。

插件分爲宿主端和客戶端兩部分，這是理解它行爲方式的基礎，後面單獨說明。

按照 README 的描述，插件提供以下能力：

預設壁紙：內置 6 種漸變壁紙（aurora、ocean、sunset、forest、night、sakura），另有 none（無壁紙）選項。
圖片 URL：粘貼任意 http(s) 圖片地址作爲壁紙。
本地上傳：選擇本地 PNG / JPG / GIF / WebP 圖片，大小不超過 10MB。圖片存儲在宿主端，重啓後仍保留。
透明度滑塊：從 0%（隱藏）到 100%（主導顯示）。拉到 100% 時，基礎背景、卡片甚至消息氣泡都會變爲半透明，讓壁紙鋪滿整個窗口。
持久化：配置和上傳的圖片存放在 $DSH_HOME/storages/wallpaper/，通過穩定的 /dsh-wallpaper/image 路徑提供。桌面應用重新綁定隨機迴環端口時，數據不會丟失。

安裝命令如下，注意帶 --profile web 參數，因爲插件的客戶端平臺是 web：

dsh plugin --profile web add github:keke050/dsh-wallpaper

安裝完成後重啓 DeepSeek Harness，然後打開 Settings → 壁紙 / Wallpaper，就能看到設置界面。

插件的 peerDependencies 爲 @deepseek-ai/cordis ^4.0.1 和 react ^18.2.0，如果自行開發或排查依賴問題時可以參考。

進入設置界面後，按下面的步驟操作：

三種來源（預設、URL、上傳）可以隨時切換，配合滑塊調整，幾分鐘內就能找到合適的顯示效果。

瞭解插件的內部結構，有助於判斷它的工作原理和數據去向。

宿主端註冊了三個迴環 HTTP 路由，分別負責配置、上傳和圖片讀取：

壁紙數據持久化在 $DSH_HOME/storages/wallpaper/ 目錄。由於圖片通過穩定的 /dsh-wallpaper/image 路徑提供服務，即使桌面應用重啓後重新綁定了隨機迴環端口，已上傳的壁紙和配置也不會失效。

客戶端部分負責渲染設置區塊，並注入 CSS 把壁紙放到 body 上。它通過覆蓋 --dsw-alias-bg-* 和 --dsw-specific-* 兩類設計令牌，讓應用原有的背景表面變爲半透明——這正是壁紙能透過對話區域（而不只是側邊欄）顯示出來的原因。

這個插件適合長期使用 DeepSeek Harness 桌面端、希望界面更符合個人喜好的開發者。它只改動外觀層，不涉及對話邏輯和數據處理，屬於典型的「換裝」類插件。

安裝前有幾點需要注意：

dsh-wallpaper 做的事情很單一：讓你能自定義 DeepSeek Harness 桌面端的背景。三種壁紙來源、一個透明度滑塊、可靠的持久化，功能剋制但完整。如果你每天都對着這個界面工作，花兩分鐘換個背景是划算的。