前言¶
用 DSH 的人，大部分時間停留在 Web GUI 上。官方界面的樣式是固定的，想給整個頁面換一張背景圖，或者把配色調成自己喜歡的樣子，並沒有現成入口。qe2592008/dsh-ui-customizer 解決的就是這個問題：它在官方設置彈窗裏新增「背景圖」「主題」兩個子菜單，支持圖片/視頻壁紙與全界面顏色定製。下面介紹它的功能、安裝與卸載方式，內容以插件 README 和 package.json 爲準。
這是什麼¶
dsh-ui-customizer（GitHub 倉庫 qe2592008/dsh-ui-customizer，npm 包名 @dsh-external/dsh-client-ui-customizer，版本 0.1.0）是 DeepSeek Harness Web GUI 的界面定製插件，MIT 許可，維護者爲 qe2592008。
它的做法不是另起一個獨立界面，而是把「背景圖」「主題」兩個子菜單內嵌進官方設置彈窗，位置緊隨「通用設置」之後，隨官方彈窗一起打開/關閉。點側邊欄「設置」即可看到。
核心功能¶
背景圖：整個 Web 界面的壁紙¶
「背景圖」子菜單把背景鋪在所有內容之下，形成壁紙效果：
1、「背景類型」圖片/視頻二選一，均支持網絡 URL 或本地上傳。
2、本地上傳的文件自動保存到插件目錄的 images/ 文件夾，換瀏覽器、清站點數據都不丟失。上傳上限：視頻 100 MB，圖片 10 MB。
3、視頻支持 mp4 / webm / ogv / mov，靜音循環播放、不參與裁剪；預覽區點擊播放，設置彈窗開合期間播放進度不丟失。
4、透明度/模糊/暗化三個滑桿對圖片和視頻通用，即時生效；模糊範圍 0–24px，暗化疊加 0–90%。
圖片背景另有幾項細化能力：
- 交互式裁剪預覽：滾輪或按住中鍵上下拖動縮放，左鍵拖動平移，只有預覽中框選出來的區域會作爲背景，「復位」一鍵恢復整圖。
- 拉伸方式四種：鋪滿（cover，默認）/ 適應（contain）/ 平鋪 / 拉伸（fill）；裁剪生效時平鋪回退爲鋪滿。
- 最近使用：自動保留最近 10 張用過的背景圖片，點縮略圖即可切換，右上角 ✕ 可刪除。
主題：50 項界面顏色定製¶
「主題」子菜單通過顏色選擇器定製界面元素的顏色，共 50 項，覆蓋背景、文字、彈窗、按鈕、狀態、字體等，分 8 組摺疊面板，明暗主題下都生效。「恢復默認」可一鍵還原全部修改。
配好的主題可保存任意多份，保存時可以連同當前背景（圖片或視頻）一起，之後隨時應用或刪除。
字體預設¶
字體方面提供 2 個字體 token 共 42 種預設（系統字體 + 主流開源字體），下拉即選。插件會自動檢測本機是否安裝了對應字體，未安裝的會標註「未安裝」。
通用行爲¶
所有設置自動保存，刷新頁面後依然保留；界面中英雙語。性能上，打開設置彈窗時背景視頻自動暫停，關閉後無縫恢復，彈窗開合不受影響。
安裝與啓用¶
在 dsh 安裝目錄（能運行 dsh 的地方）執行：
dsh plugin --profile web add github:qe2592008/dsh-ui-customizer
開發場景可以用本地路徑 link 方式安裝，改源碼即時生效：
dsh plugin --profile web add D:\Work\工作目錄\dsh-ui-customizer
插件自帶 dsh.bundle 激活層（cordis.patch.yml），安裝後會自動激活 ui-customizer 條目，不需要手動修改 $DSH_HOME/profiles/web/cordis.patch.yml。經過上面的步驟，重啓 DSH Web 後生效，點側邊欄「設置」即可看到「背景圖」「主題」兩個子菜單。
兩點補充說明：
1、本插件不依賴任何 npm 包，安裝時不需要網絡。
2、dsh plugin 依賴 pnpm。若機器上沒有，可按 README 給出的手工方式安裝：把插件目錄 junction 到 $DSH_HOME/profiles/web/node_modules/@dsh-external/dsh-client-ui-customizer，在 profile 的 package.json 登記依賴，並在 dsh.profile.bundles 中加入 @dsh-external/dsh-client-ui-customizer。
卸載¶
先執行：
dsh plugin --profile web remove @dsh-external/dsh-client-ui-customizer
然後重新構建 profile：再次執行 dsh plugin --profile web add（對任意已安裝包），觸發 reconcile，插件條目會隨依賴移除自動從 bundles 列表刪除。
適用場景與注意¶
這個插件不改變 DSH 的功能行爲，只作用於 Web 界面觀感，在社區目錄中歸爲「趣味換裝」，適合想長時間盯着一個順眼界面的開發者。
使用前注意：
1、插件以當前 dsh 進程的權限運行，安裝第三方插件前應先閱讀源碼、確認許可證。本插件爲 MIT，README 與 package.json 的 license 字段一致。
2、本地上傳有大小上限（視頻 100 MB、圖片 10 MB）；視頻不參與裁剪，需要精確取景時用圖片。
3、裁剪生效時，平鋪拉伸方式會回退爲鋪滿。
結尾¶
dsh-ui-customizer 把「換壁紙、調配色」這類觀感需求做成了官方設置彈窗裏的兩個子菜單：設置自動保存、本地上傳持久化、安裝後自動激活，裝完即用。項目地址：
- GitHub：https://github.com/qe2592008/dsh-ui-customizer
- 社區插件目錄：https://www.skillhub.cn/plugins/qe2592008/dsh-ui-customizer
其中目錄爲獨立社區站點，與 DeepSeek、幻方無官方從屬關係。
