前言¶
DeepSeek Harness（DSH）的界面默認是純色面板。長時間寫提示詞、看會話時，有人希望窗口背後有一張自己的圖，又不想動系統桌面壁紙，也不想把圖片發到網上。
社區插件 dsh-wallpaper 做的是另一件事：在側邊欄 deepseek HARNESS 字標旁加一個圓形按鈕，從本機選圖，按可調不透明度鋪滿 DSH 窗口；圖片和設置只存在本機 IndexedDB 裏。下面介紹它是什麼、怎麼裝、怎麼用，以及安裝前要注意的權限與兼容性。
這是什麼¶
dsh-wallpaper 由維護者 VictorGol 發佈，歸類爲「趣味換裝」。一句話：給 DSH 提供一個壁紙選擇器，選本地圖片作爲窗口壁紙，默認 70% 不透明度（滑桿可在 0–100% 調節）。
- 目錄頁：https://www.skillhub.cn/plugins/VictorGol/dsh-wallpaper
- 源碼與說明：https://github.com/VictorGol/dsh-wallpaper
- 許可證：MIT（README 與
package.json一致） - 當前包版本：
package.json中爲 1.0.5；引擎要求dsh>=0.2.0-rc.1；README 寫明需要 DSH 0.2.x 桌面版，純 JavaScript，無構建步驟
核心功能¶
以下能力均來自倉庫 README，安裝後可直接對照界面驗證。
字標旁的入口按鈕¶
圓形按鈕註冊在 shell.overlay 槽位，貼在側邊欄 deepseek HARNESS 字標右側。配色跟隨主題反轉：深色主題白底黑圖標（--dsw-alias-button-primary-fill / --dsw-alias-label-primary-foreground），淺色主題相反。側邊欄收起時隨品牌行一起隱藏，不替換內置控件。
選圖與不透明度¶
- 點按鈕打開面板後，可用「選擇圖片」，或將圖片拖入預覽框。
- 不透明度默認 70%，拖動滑桿即時生效，範圍 0–100%。
面板半透明與移除¶
壁紙存在時，插件通過 ctx.theme.overrideTokens 調整 --dsw-alias-bg-base，使會話區、側邊欄、右欄、底欄一起半透明，壁紙才能透出來。點「移除」會去掉壁紙並恢復原來的純色界面。
本地持久化與語言¶
圖片以 Blob 存入 IndexedDB，透明度一併保存；不上傳、不髮網絡請求。重開 DSH 會自動恢復。界面文案跟隨 DSH 語言（中文/英文）。
安裝與啓用¶
插件在 DSH 進程內運行，安裝前建議瀏覽 GitHub 源碼與 MIT 許可證，確認符合你的使用環境。
- 打開 DSH → 插件 → 添加插件
- 填入本倉庫地址（須與官方 README 一致）：
https://github.com/VictorGol/dsh-wallpaper
- 確認安裝。圓形按鈕應出現在字標右側；若未出現，重開一次 DSH。
典型用法¶
經過上面的步驟裝好插件後，日常操作如下。
- 點圓形按鈕打開面板。
- 「選擇圖片」或拖入圖片 → 壁紙立刻鋪滿窗口底層。
- 用「不透明度」滑桿調整濃淡（默認 70%）。
- 不需要壁紙時，點「移除」，界面恢復默認純色。
卸載：在插件頁卸載即可。若要連本地保存的圖片一併清除，先打開面板點「移除」。
實現要點（便於排查問題）¶
README 中給出了實現摘要，遇到「有壁紙但看不見」或按鈕位置異常時可對照：
- 壁紙層：
position: fixed; inset: 0; z-index: -1的圖片層插在#root之前；macOS 桌面端 frame 透明時，層落在所有面板之下。 - 按鈕定位：按側邊欄品牌行實測定位（
[data-sidebar-toggle]等），窗口縮放、側邊欄拖寬會重新測量。 - 持久化：IndexedDB 存 Blob 與透明度。
適用場景與注意¶
適合誰：希望在 DSH 桌面客戶端裏個性化背景、且只使用本地圖片、不關心雲端同步的用戶。
兼容性（以 README 爲準，勿誇大驗證範圍）：
| 環境 | 說明 |
|---|---|
| macOS 桌面版 DSH 0.2.x | 實測通過 |
| Windows 桌面版 | 按鈕按品牌行計算，避免壓住標題欄菜單；README 註明未在 Windows 真機驗證 |
| 瀏覽器標籤頁 | 面板可半透明，但宿主窗口不透明時壁紙可能只在部分區域可見，取決於殼層背景 |
插件與社區目錄 SkillHub 均爲社區生態，遵循 DSH「一切皆插件」的思路；目錄站與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
安全提醒：插件以當前 DSH 進程權限運行，僅能訪問其設計範圍內的本地存儲與 UI 槽位；仍應在安裝前自行審閱 index.js、client.js 等入口文件。
結尾¶
dsh-wallpaper 用一個小按鈕把「本地圖 + 可調透明度 + 面板半透明」接到 DSH 窗口上，數據留在本機 IndexedDB。若你需要在 0.2.x 桌面版裏換一張自己的背景，可按 README 地址安裝試用。
