前言¶
DeepSeek Harness Web 提供了換膚功能，但在刷新頁面或跟隨系統設置時，常出現短暫的白屏閃爍，且官方主題定製能力有限。dsh-client-ui-theme-manager 作爲一個客戶端插件，通過持久化樣式注入和本地存儲，提供了可視化的主題管理方案，支持零閃爍換膚、背景圖配置以及主題的導入導出。
插件簡介¶
該插件由 thooy 維護，採用 MIT 許可證。它通過 cordis.patch.yml 註冊客戶端入口，向官方主題服務註冊自定義主題，並在設置面板中添加了“Dream Skin 換膚”選項。所有主題數據存儲在瀏覽器本地，無需重啓 dsh 即可生效。
核心功能¶
該插件提供以下功能：
* 內置主題：提供 10 套預設主題，包括財神金、深空紅、米金白、極夜藍、青竹綠、櫻花粉、薄荷蘇打、紫晶、檸檬汽水和石墨灰。
* 主題管理：支持創建新主題（命名、深淺外觀、配色）、導入主題（支持 .zip 格式或 theme.json 文件）、導出當前主題。
* 背景圖配置：可爲主題配置背景圖（自動壓縮至 1600px 以下）、設置文字遮罩（安全區），無圖時自動生成漸變背景。
* 官方換膚控制：支持暫停/繼續換膚（保留記憶）以及還原官方外觀。
* 零閃爍：刷新或重開頁面後，主題即時生效，全程不出現官方淺色。
* 輕量體檢：提供狀態條提示，用於檢測背景掛載類名是否失效（例如 dsh 升級後可能出現）。
* 持久化存儲：主題和背景圖數據保存在瀏覽器的 localStorage 中。
安裝與啓用¶
安裝有兩種方式，二選一即可。混用會導致重複入口。
方式 A：原生插件安裝¶
通過 dsh 插件管理命令安裝。這種方式加載瞬間可能會閃一下官方淺色（約 0-8ms）。
dsh plugin --profile web add dsh-client-ui-theme-manager
安裝完成後重啓 dsh web 並刷新頁面。
方式 B：一鍵安裝（推薦）¶
下載最新版 zip 包，運行安裝腳本。這種方式包含零閃爍的首幀引導樣式。
- 從 Release 頁面下載最新版壓縮包（如
dsh-client-ui-theme-manager-1.4.0.zip），解壓到任意目錄。 - 在該目錄下運行 PowerShell 腳本：
powershell -ExecutionPolicy RemoteSigned -File .\install.ps1
- 重啓 dsh web 進程，並在瀏覽器中執行 Ctrl+F5 硬刷新。
卸載¶
若要卸載，先根據安裝方式執行對應命令：
# 方式 A
dsh plugin --profile web rm dsh-client-ui-theme-manager
# 方式 B
powershell -ExecutionPolicy RemoteSigned -File .\install.ps1 -Uninstall
重啓 dsh web 並刷新頁面。
使用說明¶
打開 設置 → 找到 Dream Skin 換膚。
* 換膚：點擊內置的主題卡片即可切換。
* 導入：點擊導入按鈕，選擇本地的 .zip 壓縮包或 theme.json 文件，插件會自動解析並應用。
* 導出：點擊導出按鈕，可下載當前的 theme.json 配置文件（若包含背景圖，會一併打包）。
注意事項¶
- 安裝衝突：兩種安裝方式不可混用，若已安裝 A 請先卸載再安裝 B。
- 數據丟失：主題和背景圖存儲在瀏覽器 localStorage 中，更換瀏覽器、清除緩存或換設備會導致數據丟失，建議定期使用“導出主題”進行備份。
- 版本兼容：升級 DeepSeek Harness 後，可能需要重新運行一次
install.ps1以更新前端入口的引導樣式和插件副本。
