前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者擴展功能。dsh-image-skin 是一個 Web 插件，旨在解決界面定製的問題。它允許用戶設置背景圖片，並自動根據圖片的調色板適配 UI 的文本、背景、品牌和邊框顏色。
插件簡介¶
- 名稱：
dsh-image-skin - 維護者：YouHui1
- 類別：趣味換裝
- 許可證：MIT
- 定位：通過分析圖片顏色自動生成主題令牌，改變 DSH Web 界面的外觀。
核心能力¶
- 背景圖片：支持上傳圖片，系統會自動將其縮放至 1600px JPEG 存儲。
- 調色板適配：提取圖片的平均色和主導色，並以此生成完整的主題令牌集（包括背景、主次標籤、品牌色、邊框等）。
- 對比度保證：基於 WCAG 相對亮度檢查，確保生成的文字顏色與背景對比度達標（主次級 >= 4.5:1，三級文本 >= 3:1）。
- 不透明度控制：提供滑塊控制主表面不透明度；對於分層表面（菜單、彈出框），不透明度保持在 >= 80%。
- 圖片適配模式：支持覆蓋、包含、拉伸三種模式。
- 遮罩：在背景圖上添加一層色調遮罩，提高文字可讀性。
- 自動亮/暗模式：可選“跟隨圖片”開關，根據圖片亮度自動切換亮色或暗色主題。
- 持久化：圖片和設置保存在瀏覽器的
localStorage中，刷新頁面後自動恢復。 - 設置入口：在 DSH 設置中註冊了一個“Skin”頁面。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile web add link:<absolute path to this repo>
安裝完成後，重啓 DeepSeek Harness 並在瀏覽器中強制刷新頁面（Ctrl/Cmd+Shift+R）以生效。
技術細節與限制¶
- 存儲機制：圖片以
data:image/jpeg格式存儲在localStorage的dsh-image-skin.v1鍵下。 - 顏色限制：高飽和度圖片會強烈着色表面；背景飽和度被限制在 45 以內。分層表面（菜單/彈出框）不透明度不低於 80%。
- 重載規則：客戶端的更改需要強制刷新；主機端的更改需要重啓 DSH。
生態鏈接¶
- GitHub 倉庫：https://github.com/YouHui1/dsh-image-skin
- 社區目錄：https://www.skillhub.cn/plugins/YouHui1/dsh-image-skin
