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 提供了丰富的配色选择和设计令牌,适合追求视觉统一或进行二次开发的用户。