前言¶
DeepSeek Harness（DSH）的 Web 界面默認是純色或主題自帶的背景。若你長時間在聊天區、側欄和設置頁之間切換，只改聊天區背景往往顯得割裂；側欄與標題欄仍是系統默認色，整體觀感不統一。
社區維護者 Sostay 發佈的 dsh-wallpaper（倉庫 Sostay/dsh-wallpaper）是面向 DSH 的 Cordis 插件，在 SkillHub 目錄中歸類爲「趣味換裝」。它把壁紙鋪到整個窗口（含標題欄、左右側欄與主內容區），並支持預設、外鏈、本地上傳與磨砂面板等可調項。下面介紹其定位、能力與安裝用法。
這是什麼¶
dsh-wallpaper 是純 JavaScript、零構建的 UI 插件（Client half）：Host 側 index.js 僅導出空的 apply()，樣式與配置面板在瀏覽器側的 client.js 中完成。配置持久化在瀏覽器 localStorage 的鍵 dsh_wallpaper_config_v2。
許可證爲 MIT；package.json 中當前版本爲 1.0.4。插件不引入外部運行時包，React 由 DSH 瀏覽器模塊表提供。
核心功能¶
全窗口與作用域¶
- 全窗口壁紙：覆蓋標題欄、左側欄、右側欄與聊天區，而非僅聊天區。
- 作用域可選：「全部（含側欄）」或「僅聊天區」。
壁紙來源與預設¶
- 三種來源：精選預設 / 網絡圖片鏈接 / 本地圖片上傳（本地文件轉爲 Data URL 存儲；上傳前經 Offscreen Canvas 等比縮放與壓縮，減輕
localStorage配額壓力）。 - 10 個內置預設：5 個深色漸變（深邃極光、賽博霓虹、落日晚霞、幽藍深海、暗夜微芒）+ 5 張攝影類壁紙（清晨薄霧、星辰宇宙、靜謐雪山、賽博都市、晨霧密林）。
- 自定義鏈接：任意可訪問的圖片 URL。
- 適配方式：
cover/contain/repeat。
視覺效果¶
- 亞克力磨砂面板：可調壁紙不透明度、遮罩不透明度與背景模糊；側欄遮罩自動取聊天區遮罩值的 60%，側欄更通透。
- 主題自適應頂部漸變：跟隨 DSH 主題，暗色約爲
#151517，亮色約爲#FFFFFF，與body[data-ds-dark-theme]一致。 - 動態參數：通過
--dsh-wp-*CSS 變量驅動，拖動滑塊時只更新變量，避免整表重算。 - 主面板適配：對話區、插件頁及 Schedules 等
[data-slot="main"]下頁面均可透出磨砂壁紙；底部覆蓋 DSH 默認漸變節點，壁紙可延伸至窗口底邊。
安裝與啓用¶
安裝前請自行查看倉庫源碼與 MIT 許可證；插件在當前 DSH 進程對應的前端環境中運行，與你在該實例中啓用的其他插件相同，無額外沙箱。
方式一：從 GitHub 安裝（README 推薦）¶
將 <profile> 換成你的 DSH profile 名稱：
dsh plugin --profile <profile> add github:Sostay/dsh-wallpaper
README 說明：本插件無需 prepare 或編譯，安裝後即可使用。若希望生產環境鎖定源碼，可指定 commit：
dsh plugin --profile <profile> add github:Sostay/dsh-wallpaper#<commit-sha>
方式二：DSH Web GUI¶
打開 設置 → 插件 → 添加插件，填入倉庫地址 https://github.com/Sostay/dsh-wallpaper（或目錄頁給出的同源信息）。
方式三：從 tarball 安裝¶
在已下載的插件源碼目錄中打包並安裝（README 示例包名爲 dsh-wallpaper-plugin-1.0.2.tgz，以你本地 pnpm pack 產出爲準）：
pnpm pack
dsh plugin --profile <profile> add ./dsh-wallpaper-plugin-1.0.2.tgz
安裝並在 設置 → 插件 中啓用後，進入 設置 → 通用 → 背景壁紙 打開配置面板。
典型用法¶
配置面板中的主要項如下（與 README 表格一致）：
| 配置項 | 說明 |
|---|---|
| 啓用壁紙 | 總開關；關閉後不注入任何樣式 |
| 壁紙來源 | 精選預設 / 網絡圖片鏈接 / 本地圖片上傳 |
| 預設 | 10 個內置背景（5 漸變 + 5 圖片） |
| 自定義鏈接 | 任意可訪問的圖片 URL |
| 本地上傳 | 選擇本地圖片文件 |
| 不透明度 | 壁紙本身的透明度 |
| 遮罩不透明度 | 磨砂面板遮蓋強度 |
| 模糊 | 壁紙 blur() 半徑 |
| 適配方式 | cover / contain / repeat |
| 作用域 | 全部（含側欄）或僅聊天區 |
常見流程：先打開「啓用壁紙」，再選「精選預設」快速試色，或切到「網絡圖片鏈接」填入 HTTPS 圖牀地址；若需離線或私有圖，用「本地圖片上傳」。側欄過暗時可略降「遮罩不透明度」，或把「作用域」改爲「僅聊天區」做對比。
適用場景與注意¶
適合：希望在 DSH Web GUI（Electron PWA 與瀏覽器）中長期使用統一視覺、又需要跟亮/暗主題聯動的開發者或日常用戶。
兼容性（據 README）：需要支持 dsh.bundle 與 dsh.client 的 DSH 版本；亮色與暗色主題均已適配。
卸載：
dsh plugin --profile <profile> remove dsh-wallpaper-plugin
SkillHub 上的插件目錄由社區維護，與 DeepSeek / 幻方無官方從屬關係；星標與分類以目錄展示爲準（當前簡介側重全窗口壁紙與磨砂效果）。
結尾¶
dsh-wallpaper 把 DSH 界面從「僅聊天區換膚」擴展到全窗口，並把預設、外鏈、本地上傳和磨砂參數收到同一設置入口。需要詳情與 issue 時，見 GitHub 倉庫 與 SkillHub 目錄頁。
