前言¶
DSH Web 界面的默認外觀比較固定。如果只希望更換背景，或者在幾張本地圖片、圖片地址和內置預設之間切換，可以看一下 dsh-wx-skin。它是一個面向 DSH Web GUI 的皮膚插件，提供側欄「皮膚」面板，支持本地圖片 / URL 作爲全屏背景，幷包含預設、暗化、模糊、關閉皮膚與跨刷新持久化能力。
這是什麼¶
dsh-wx-skin 由 wangxilhy23 維護，許可證爲 MIT。它的定位是 DSH Web GUI 皮膚插件，屬於外部 client 插件，採用 dsh-web-ui 風格。它不改 DSH 倉庫，也不影響主界面與其它插件，主要在瀏覽器端提供背景替換與顯示參數調節。
核心功能¶
側欄入口¶
安裝後，側欄會出現「皮膚」入口。點擊該入口會彈出設置面板。資料描述該面板爲浮層，不遮擋聊天內容。
背景選擇¶
支持通過瀏覽器原生文件對話框選擇本地圖片。已覈實支持的位圖格式爲：
- PNG
- JPEG
- WebP
- GIF
- BMP
SVG 等矢量格式不支持。
資料說明本地圖片不限文件大小，超尺寸會自動縮放。
也支持粘貼 http(s):// 圖片地址直接應用。
預設皮膚¶
內置預設包括：
- 墨藍
- 石板
- 暖沙
- 落日漸變
- 深海漸變
- 極光漸變
效果調節¶
可調節項包括：
- 暗化：0–80%
- 模糊：0–24px
- 透出：0–100%，默認 72%
面板還提供啓用開關與恢復默認操作。
持久化與主題¶
設置會持久化到 localStorage，並鏡像到宿主副本：
~/.dsh/dsh-wx-skin.settings.json
資料說明刷新、重啓、桌面端換端口後會自動恢復。
插件也支持明暗主題自動適配。
安裝與啓用¶
前置條件¶
需要先滿足以下條件：
- 已安裝
deepseek-harness - 已初始化
web profile package.json中聲明Node >=22.19.0和packageManager pnpm@11.7.0
安裝命令¶
已覈實資料給出的安裝命令是：
pnpm dsh plugin --profile web add dsh-wx-skin@0.1.2
該命令使用固定版本 0.1.2。
重啓與刷新¶
安裝後重啓 dsh web，然後刷新：
http://127.0.0.1:3080
側欄出現「皮膚」入口即可使用。
驗證是否掛載¶
可執行：
pnpm dsh --profile web --dump-config
輸出中應看到：
"# == dsh-wx-skin"
典型用法¶
1、點擊側欄「皮膚」。
2、選擇背景：選擇本地圖片、粘貼 http(s):// 圖片 URL，或選擇預設。
3、調節「暗化」「模糊」「透出」。
4、打開「啓用皮膚」；需要還原時執行「恢復默認」。
如果只想先預覽效果，可以打開自包含演示源：
assets/demo.html
資料說明該文件可直接用瀏覽器打開預覽。
卸載¶
已覈實的卸載命令是：
pnpm dsh plugin --profile web remove dsh-wx-skin
重啓 dsh web 後，側欄入口消失，皮膚設置一併清除。
適用場景與注意¶
適合使用 DSH Web 界面、希望替換背景並保留聊天主界面可讀性的開發者。
使用前建議：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 僅接受位圖 PNG / JPEG / WebP / GIF / BMP；SVG 等矢量格式不支持。
- 側欄入口依賴 DSH shell 的 DOM 結構；若 DSH 版本變更導致入口未出現，資料說明只會記錄日誌，不影響 GUI。
- 皮膚依賴應用根
#root爲掛載根，通過z-index: 0與#root抬升方案渲染背景。 - 本地圖片以 data URL 存於
localStorage，並鏡像到~/.dsh/dsh-wx-skin.settings.json。
鏈接¶
GitHub：
https://github.com/wangxilhy23/dsh-wx-skin
資料中提到的目錄頁：
https://www.skillhub.cn/plugins/wangxilhy23/dsh-wx-skin
該目錄頁鏈接來自插件線索，未單獨抓取覈實；這裏僅作爲資料中出現的地址列出。
