前言¶
DeepSeek Harness（dsh）的 Web 界面默認是純色或主題 token 背景，長時間在本地調試智能體時，界面容易顯得單調。若只在瀏覽器裏用 CSS 或擴展換背景，換端口、換瀏覽器或重裝後往往要重來，圖片也不一定能和淺色/深色主題一起協調。
下面介紹社區插件 ferii-dsh-wallpaper（維護者 ferii-87）：在 Harness 主機上保存一張本地圖片，由 Web UI 繪製在窗口後方，並提供原圖、清晰、平衡、柔和四檔顯示效果，隨當前淺色/深色主題自動調整。圖片不發起外網請求，適合在本地 Web UI 裏做輕量「換裝」。
這是什麼¶
ferii-dsh-wallpaper 是面向 DeepSeek Harness Web 界面的背景圖片插件，npm 包名爲 @ferii87/dsh-wallpaper，源碼託管於 GitHub。在 SkillHub 等社區目錄中歸類爲「趣味換裝」。
它解決的是：上傳一次本地圖片，由 Harness 主機持久化存儲；在 Settings → General → 背景圖片 中預覽、切換效果或移除，無需每次手動改樣式。
核心功能¶
根據項目 README，已覈實能力如下。
- 設置入口：Settings → General → 背景圖片 — 上傳、替換、移除、預覽，並顯示文件名與尺寸。
- 主機側存儲：圖片保存在
$DSH_HOME/wallpapers/（默認~/.dsh/wallpapers/），含image與meta.json，重啓或 Web 端口變更後仍保留。 - 四檔效果：原圖（raw）、清晰（thin mask）、平衡（默認）、柔和（stronger mask）；切換立即生效，插件會測量圖片平均亮度並在當前色板下做歸一化。
- 無 Web 載體時的回退：若沒有 Web carrier 路由，圖片保存在當前瀏覽器的 storage 中。
- 隱私：不訪問外網，圖片不離開本機。
Host 端（index.js）在 Web carrier 上註冊讀寫路由；瀏覽器端（client.js）負責設置項、亮度測量與主題 token 疊層渲染。無路由時回退到 localStorage。
安裝與啓用¶
安裝時需指定 --profile web。官方 README 給出兩種方式。
npm 包：
dsh plugin --profile web add @ferii87/dsh-wallpaper
GitHub：
dsh plugin --profile web add github:ferii-87/ferii-dsh-wallpaper
Desktop 應用可在 Settings → Plugins（或插件市場）中安裝。若設置裏暫時看不到「背景圖片」一行，需重啓 dsh web 或 Desktop 應用。
插件以當前 dsh 進程權限運行；安裝前建議瀏覽 源碼倉庫 與 MIT 許可證。README 記載在 DeepSeek Harness 0.2.1-rc.5、Windows、Desktop Web UI 下測試；需要 composition 具備 Web UI、webServer 以及 settings.general.item 插槽。
典型用法¶
- 打開 Settings → General → 背景圖片。
- 上傳圖片。長邊會縮至最多 1920 px，並以 JPEG 形式存儲。
- 在 效果 中選擇一檔：
- 原圖 — 存儲圖，無遮罩與表面 tint。
- 清晰 — 輕量表面處理，接近原圖。
- 平衡 — 默認，兼顧背景可見度與文字對比度。
- 柔和 — 更強表面 tint，利於文字可讀性。 - 點擊 移除 會刪除主機上的圖片並恢復默認背景。
適用場景與注意¶
適合誰：在本地或 Desktop 里長期使用 DSH Web UI、希望背景圖持久化且隨主題切換的開發者；分類上屬於「趣味換裝」，不改變 Harness 核心邏輯。
安全與綁定地址：插件路由默認無 session 鑑權；讀接口只返回已存壁紙，寫接口需要 JSON body 及請求頭 x-dsh-wallpaper: 1。Harness 默認將 Web carrier 綁在 loopback；若將 Web 綁到局域網或公網接口，這些路由會對該網段暴露，不應在共享/公網 bind 下把壁紙當作私密數據。
生態說明：DSH 採用「一切皆插件」的擴展方式；SkillHub 目錄頁 是社區收錄站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
ferii-dsh-wallpaper 把背景圖收進 $DSH_HOME/wallpapers/，在 Web 設置裏即可完成上傳與四檔效果切換，並適配淺/深色主題。需要細節時可查閱 SkillHub 插件頁 與 GitHub 倉庫 README。
