插件定位¶
DeepSeek Harness (DSH) 的 web 平臺採用插件化架構。在現有環境中，切換主題通常需要手動編輯配置文件或刷新頁面。dsh-theme-manager 通過一個兩級式的主題管理器解決了這個問題，用戶無需接觸代碼即可通過界面選擇並應用主題。
核心功能¶
該插件由 runcat-tommy 維護，基於 MIT 許可證開源。它主要提供以下能力：
- 兩級選擇界面：在設置頁新增“主題管理器”入口。左側展示第一層分類（文化/場景、開發者等），右側展示具體的風格卡片，卡片包含配色預覽。
- 實時生效：通過
theme服務註冊，點擊“使用”後立即切換，無需刷新頁面。 - 狀態記憶：當前選擇的主題保存在瀏覽器 localStorage 中，刷新或重啓後自動恢復。切換回系統默認外觀時會自動清除記錄。
- 雙語支持：界面文案跟隨系統語言（zh / en）。
- 內置 58 套風格：涵蓋四個大類：
- 文化/場景（23 套）：如中國水墨、蘇州園林、日本浮世繪、賽博朋克、DeepSeek 深海藍等。
- 開發者主題（8 套）：如 Catppuccin Mocha、Dracula、Tokyo Night、Nord 等。
- 強烈對比（7 套）：如黑金對比、紅黑對比、熒光綠酸等。
- 國旗系列（20 套）：基於
flagSpec()生成器自動派生配色層級，包括美國、中國、日本、德國等國旗配色。
- 更新機制：啓動時自動檢查 npm 最新版本，每 6 小時檢查一次。發現新版本時，右下角彈出一次性 toast 和常駐氣泡。支持在設置頁進行“一鍵更新”、“忽略本版本”或“稍後提醒（24小時）”。
安裝與啓用¶
使用該插件前，請確保已安裝 DeepSeek Harness web 0.1.0-rc.6 或更新版本。
安裝步驟¶
通過 dsh 插件管理工具安裝：
dsh plugin --profile web add github:runcat-tommy/dsh-theme-manager
安裝完成後，重啓 dsh web 進程使插件生效。
使用方法¶
- 打開 DeepSeek Harness 的 設置 頁面。
- 點擊 主題管理器 入口。
- 在左側列表中選擇第一層分類（例如“中國”、“開發者”、“國旗”）。
- 在右側風格卡片中點擊 使用 按鈕。
- 界面會立即切換至選定的主題風格。刷新頁面後，該風格會自動保留。
若需恢復默認外觀，可點擊底部的“恢復默認外觀”，或在“設置”頁的“外觀”行切換系統默認選項。
更新與維護¶
插件內置了自動更新檢查邏輯。
* 檢查頻率：應用啓動時以及運行期間每 6 小時。
* 更新方式：npm 安裝和 GitHub 安裝方式均支持一鍵更新。更新過程會解析最新版本並自動重啓（或提示手動重啓）。
* 回滾功能：支持一鍵回滾到上一個版本。
* 開發安裝：如果使用 link: 方式或手動安裝，不支持自動更新，需在源碼目錄更新後重啓。
結語¶
dsh-theme-manager 爲 DeepSeek Harness web 提供了一套結構化、可視化的主題管理方案。通過內置的 58 套風格和自動更新機制，開發者可以快速調整界面風格以適應不同場景或個人偏好。更多細節與源碼可參考項目倉庫：https://github.com/runcat-tommy/dsh-theme-manager
