DeepSeek Harness（DSH）採用插件化架構。對於桌面版用戶，dsh-theme-button 是一個掛件，允許在保持官方外觀設置的同時，爲 DSH 界面添加自定義背景。
安裝¶
環境要求：DeepSeek Harness 桌面版（Windows），無額外依賴。
安裝步驟：
1. 將插件文件夾放置在固定的位置（安裝後不要移動）。
2. 執行安裝命令：
dsh plugin --profile desktop add link:C:\dsh-plugins\dsh-theme-button
- 必須完全重啓 DSH。插件的宿主部分只在啓動時加載，刷新頁面無效。
安裝成功後，重啓 DSH 應該在右下角看到掛件圖標。訪問 http://127.0.0.1:<DSH 端口>/dsh-theme-button/version 也能驗證版本號。
核心功能¶
懸浮掛件¶
掛件默認位於右下角，可以拖動到任意位置。位置會自動記憶，重啓後保持。輕點圖標可打開/關閉設置面板，拖動時面板自動收起。
官方外觀¶
面板提供淺色、深色、跟隨系統三種模式。選擇會同步寫入 DSH 的官方外觀設置，與官方設置頁雙向一致。
自定義背景¶
面板提供“自定義背景”總開關。開啓後，可選擇純色或圖片作爲背景。
- 純色：使用預設色塊或取色器自定義。
- 圖片：支持上傳圖片，最多 6 張。點縮略圖切換，點 × 刪除。
背景參數¶
提供獨立調節項，分別作用於純色和圖片：
- 不透明度：0–10，控制背景顯示強度（0 爲關閉）。
- 模糊：0–24px，控制背景模糊程度。
- 亮度：0–10，5 爲 100%。
- 飽和度：0–10，5 爲 100%。
適配方式¶
支持四種填充方式：
* 填充（默認）：鋪滿區域，裁剪超出部分。
* 適應：完整顯示整張圖，可能留白。
* 平鋪：按原尺寸重複。
* 拉伸：拉伸到鋪滿（會變形）。
視覺效果¶
掛件、面板、取色器均採用半透明毛玻璃效果。關閉自定義背景後，效果消失，恢復 DSH 原生外觀。
取色器使用¶
面板內置自繪取色器，支持以下操作：
* 色相調整：拖動中間彩色條的手柄。
* 飽和度與明度：拖動上方方形區域的手柄。
* 手動輸入：底部輸入框支持 HEX、RGB、HSL 三種格式，回車或點擊別處生效。
* 格式切換：點擊 ▴ ▾ 按鈕在 HEX / RGB / HSL 之間切換。
注意事項¶
- 平臺限制：僅支持 Windows 桌面版 DSH。
- 圖片數量：圖片上傳上限爲 6 張。
- 浮層遮擋：取色器與面板繪製在獨立浮層，當 DSH 原生菜單或對話框打開時，可能會被遮擋。
- 更新承諾：功能完整可用，但不承諾持續更新。
卸載¶
如需卸載，執行：
dsh plugin --profile desktop remove dsh-theme-button
再次重啓 DSH。
