DeepSeek Harness Web 提供了基礎的主題切換功能。如果你需要更精細的配色控制,或者爲第三方插件開發提供統一的設計令牌,Spectrum 插件是一個可獨立安裝的解決方案。
插件定位¶
這是一個爲 DeepSeek Harness Web 提供淺色和深色主題預設的插件,由 qipenglin 維護。它提供十套配色預設,每套均有淺色與深色方案,同時兼容 DSH 內置的淺色、深色和跟隨系統設置。
核心功能¶
- 多套配色方案:提供十種預設風格,每套均包含淺色和深色兩種模式。
- 設計令牌支持:提供穩定的 CSS 變量,供擴展插件使用,確保視覺一致性。
- 靈活配置:支持通過 YAML 配置文件進行預設切換。
- 完全兼容:與 DSH 內置主題邏輯兼容,不覆蓋基礎佈局。
安裝與啓用¶
使用官方 CLI 安裝插件:
dsh plugin --profile web add github:qipenglin/dsh-theme-spectrum
安裝完成後,重啓 Web Profile,Spectrum 會出現在「設置 → 通用 → 主題風格」中。
典型用法¶
安裝後,可以通過 YAML 配置文件選擇預設。例如,選擇「石墨」預設並跟隨系統主題:
ui-theme:
preference: system
ui-theme-presets:
preset: graphite
插件提供了大量 CSS 變量供擴展使用,例如 --dsh-theme-spectrum-surface(窗口或面板背景)、--dsh-theme-spectrum-text(主要文字)、--dsh-theme-spectrum-border(邊框)以及 --dsh-theme-spectrum-accent(強調色)等。
適用場景與注意¶
- 全局生效:預設選擇影響瀏覽器 profile 全局,不支持按工作區或會話隔離。
- 變量覆蓋範圍:提供的 CSS 變量主要用於 DSH 內部組件及 Shadow DOM 內容。終端變量僅覆蓋容器,xterm、Monaco 等特定組件需要配合自身邏輯。
- 兼容性:Spectrum 不掃描 DOM、不應用全局
!important規則,也不保證未知第三方硬編碼 UI 自動跟隨主題。 - 安全性:安裝前建議檢查源碼與許可證。
總結¶
Spectrum 爲 DSH Web 提供了豐富的配色選擇和設計令牌,適合追求視覺統一或進行二次開發的用戶。