前言¶
在 DSH 的“一切皆插件”路線裏，界面外觀也可以做成可替換的客戶端插件。如果你長期使用 http://127.0.0.1:3080 的 DSH Web 界面，又希望按本地圖片或視頻調整背景，而不直接修改 DSH 源碼，dsh-client-ui-skins 就是這類場景下的一個可選方案。
它把內置皮膚、自定義圖片/視頻皮膚、背景遮罩和輸入框不透明度集中到 DSH 設置裏，完成安裝後刷新頁面即可使用。
這是什麼¶
當前倉庫爲 caoyiwei850/dsh-client-ui-skins，定位是 DSH Web 界面換膚插件。
已覈實的邊界如下：
- 面向 DSH Web 界面。
- 提供 4 套內置皮膚和自定義圖片/視頻皮膚。
- 純 client 插件，不改 DSH 源碼。
- 卸載後恢復原生外觀。
- 許可證爲 MIT。
- 需要 DSH web profile，路徑爲
~/.dsh/profiles/web。 - 依賴
pnpm。
核心功能¶
下面介紹已覈實的幾類能力。
內置皮膚¶
提供 4 套內置皮膚：
- 深海藍
- 櫻粉
- 薄荷
- 琥珀
這 4 套皮膚在深色和淺色外觀下都適配。
自定義圖片壁紙¶
支持任意 PNG、JPG、WebP 圖片。
導入後，界面配色會自動取自主圖，用於背景、強調色和交互高亮。
視頻動態壁紙¶
支持 MP4、WebM 視頻循環播放。
視頻皮膚使用首幀取色生成配色。
背景遮罩滑塊¶
用於獨立調節壁紙明暗。
當背景圖較複雜、文字對比不足時，可以通過遮罩降低背景干擾。
輸入框不透明度滑塊¶
用於獨立調節輸入框背景。
目標是保證在自定義背景上打字時，輸入區仍然清晰。
正文加強開關¶
用於給助手正文加一層輕磨砂底。
當背景圖高光區較強時，可以開啓這個開關，減少閱讀干擾。
安裝與啓用¶
一鍵安裝¶
先運行安裝腳本：
bash install-dsh-skins.sh
完成後刷新頁面：
http://127.0.0.1:3080
然後進入左下角：
設置 → 通用設置 → 皮膚
手動安裝¶
如果你需要手動操作，先在 DSH web profile 下安裝本地插件包：
cd ~/.dsh/profiles/web && pnpm add -w ./dsh-client-ui-skins-0.1.13.tgz
接着編輯註冊文件：
~/.dsh/profiles/web/cordis.patch.yml
追加以下插件項：
- insert:
- id: ui-skins
name: 'dsh-client-ui-skins'
最後重啓 DSH Web 進程：
launchctl kickstart -k gui/$(id -u)/com.deepseek.dsh.web
卸載¶
運行卸載腳本：
bash uninstall-dsh-skins.sh
典型用法¶
下面是一組可復現的使用步驟。
1、刷新 DSH Web 界面：
http://127.0.0.1:3080
2、進入設置入口：
設置 → 通用設置 → 皮膚
3、選擇內置皮膚。
可以直接點擊內置皮膚卡片切換，例如深海藍、櫻粉、薄荷、琥珀。
4、選擇自定義皮膚。
點擊：
自定義（選圖/視頻）
然後從本機選擇圖片或視頻。
5、調整自定義皮膚參數。
自定義皮膚激活後，會出現以下控件：
- 背景遮罩滑塊
- 輸入框不透明度滑塊
- 正文加強開關
這些參數可以即時預覽，插件也會記住偏好。
適用場景與注意¶
適合誰¶
這個插件更適合以下使用方式：
- 長期在 DSH Web 界面裏工作，希望調整視覺背景。
- 想使用本機圖片或視頻作爲背景，但不想改 DSH 源碼。
- 希望保留 DSH 原生功能，只在客戶端外觀層做擴展。
- 需要卸載後恢復原生外觀。
使用前注意¶
- 插件是純 client 插件，不改 DSH 源碼。
- 卸載後恢復原生外觀。
- 自定義圖片/視頻只在本機流轉：圖片存
localStorage，視頻存IndexedDB，不會上傳到任何服務器。 - 需要 DSH web profile：
~/.dsh/profiles/web
- 依賴
pnpm。 - 插件以當前 DSH 進程權限運行。安裝前建議檢查倉庫源碼、安裝腳本與許可證；當前資料給出的許可證爲 MIT。
- 已抓取資料中存在版本號不一致：README 與安裝包示例使用
0.1.13，package.json示例顯示0.1.14。本文手動安裝命令沿用已覈實用法中的0.1.13安裝包名，實際安裝前請以倉庫內實際文件爲準。
鏈接¶
- GitHub：
https://github.com/caoyiwei850/dsh-client-ui-skins
- 社區目錄頁：
https://www.skillhub.cn/plugins/caoyiwei850/dsh-client-ui-skins
如果你只是想給 DSH Web 界面換一套背景，並保持“不動源碼、可卸載”的邊界，這個插件的路徑比較直接：先執行安裝腳本，再進入設置裏選擇皮膚；需要個性化時，再導入本機圖片或視頻，並調好遮罩與輸入框不透明度。
