前言¶
DeepSeek Harness (DSH) 的 Web UI 默認樣式統一。若希望將個人壁紙、GIF 或視頻應用到界面特定區域，並讓 UI 顏色跟隨壁紙變化，可以使用 dsh-image-skin。該插件允許你在不同界面區域放置獨立圖片或視頻，添加可拖拽貼紙，並採樣壁紙顏色以調整界面色調，無需上傳到雲端。
是什麼¶
dsh-image-skin 是一個爲 DSH Web UI 提供區域壁紙和取色功能的插件，由 Hwayn 維護，遵循 MIT 協議。它通過本地文件系統管理皮膚資源，支持圖片、GIF 和視頻，並利用壁紙顏色生成符合對比度要求的界面配色方案。
核心功能¶
-
區域藝術
支持爲多個界面區域獨立配置圖片或視頻，包括窗口背景、中心列、側邊欄、歡迎頁、右側面板和編輯器。每個區域均可獨立開關、設置圖片來源（淺色專用、兩模式共用或未設置）以及適配模式。 -
動畫支持
窗口背景支持 MP4 或 WebM 循環視頻，其他區域支持 GIF。可通過滑塊調節視頻播放速率。 -
亮暗主題
淺色和深色模式可配置不同的壁紙集。切換主題時壁紙會同步切換，並提供一個共享圖片作爲後備。 -
貼紙
在側邊欄和編輯器上添加兩個可自由拖拽和縮放的貼紙，位置會持久保存。 -
面板透明度
提供滑塊控制 DSH 自身面板的透明度，透過面板可以看到壁紙，但壁紙本身不會被壓暗。 -
取色
界面顏色從壁紙採樣。包含 0-4 的深度滑塊（無步進），以及三種取色模式：- 整屏染色：所有表面和邊框染上主色調。
- 只染三處：表面保持中性，僅選擇框、焦點環和邊框染上顏色。
- 雙聲部：表面使用主色調，交互色使用壁紙的第二色調。
-
性能與隱私
動畫僅作用於合成器友好的屬性，在長對話中優化文本顏色渲染。所有文件僅存儲在本地$DSH_HOME/image-skin/，關閉插件即可完全移除。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add dsh-image-skin
安裝完成後，需重啓 DSH Web 主機以應用配置：
dsh --profile web --no-open
最後在瀏覽器中執行硬刷新（Ctrl+F5）以加載新插件。
典型用法¶
進入 Settings → 圖片皮膚 / Image skin。配置分爲兩個獨立頁面：
「貼圖」/ Images
* 編輯模式：通過切換“淺色模式”和“深色模式”來編輯對應的壁紙集。
* 界面區域：點擊卡片添加或選擇圖片，可設置圖片來源和適配方式。
* 角標貼圖：添加可拖拽的貼紙。
* 全局效果：調節面板透明度及視頻播放速率。
* 存儲：清理未被任何區域引用的圖片文件。
「配色」/ Colour
* 深度：拖動 0-4 的滑塊，實時調整顏色覆蓋的深度。
* 顏色路徑：選擇整屏染色、只染三處或雙聲部模式。
* 取自壁紙：查看採樣到的顏色，確保壁紙已設置且有效。
注意事項¶
- 桌面應用兼容性：使用桌面應用（Electron）且版本 ≤ 0.4.1 的用戶，可能會因缺少
settingsScope而遇到啓動錯誤。請使用 0.4.2 或更高版本。若必須使用舊版本，需手動指定版本安裝，例如dsh plugin --profile web add dsh-image-skin@0.4.8。 - 舊功能移除：早期的“AI ornament”功能因 UI 衝突已被移除，當前版本專注於壁紙採樣和取色。
- 本地運行：插件完全在本地運行，不涉及雲端上傳或賬號綁定。
結語¶
dsh-image-skin 爲 DSH Web UI 提供了高度可定製的視覺體驗，支持視頻與動畫，並從本地壁紙中智能提取配色。對於追求界面個性化的開發者而言，這是一個輕量級且可逆的解決方案。
