前言¶
DeepSeek Harness (DSH) 的 Web 界面支持通过插件扩展功能。对于习惯特定视觉风格的开发者,内置主题往往难以满足需求。dsh-plugin-dracula-color-theme 是一个第三方主题插件,旨在将经典的 Dracula 配色方案完整移植到 DSH Web GUI 中。
插件简介¶
- 插件名:
hoodyhuo/dsh-plugin-dracula-color-theme - 核心定位:DSH Web GUI 主题插件,应用官方 Dracula 配色,覆盖 alias + specific 两层设计令牌与 shiki 语法高亮,并提供系统主题接管功能。
- 维护者:HoodyHuo
- 许可证:MIT
核心功能¶
-
全量配色覆盖
背景色采用官方 VS Code 分层标准(标题栏、侧边栏、主内容、浮层),并对侧边栏、会话气泡、输入框、菜单等 specific 层面的元素单独映射。 -
代码高亮
针对基于shiki的css-variables主题,重写了 14 个变量,使其符合 Dracula 语法色板(如关键字粉、函数绿、常量紫、字符串黄等)。 -
守护机制
由于第三方主题 ID 不会被持久化,宿主在加载设置、推送或重连时可能会回退到内置偏好。本插件通过三层机制防止回退:- Body 内联 token(级联优先级最高);
- 监听
theme/change事件; - 1.5 秒轮询。
-
设置开关
在设置 → General 中,存在一个「接管系统主题偏好(Dracula)」的开关。开启后,插件将接管主题;关闭后则恢复内置浅/深色切换逻辑。
安装与启用¶
安装该插件需要管理员权限或对目标 profile 有写入能力。
- 执行安装命令:
dsh plugin --profile web add dsh-plugin-dracula-color-theme
-
安装完成后,必须重启
dsh web(或在配置了patchReload: live的情况下刷新页面)才能使插件生效。 -
在 Web UI 中进入「设置 → General」。
- 开启「接管系统主题偏好(Dracula)」开关。
维护与卸载¶
更新
如果是通过 Git 克隆方式使用,更新命令如下:
git -C <克隆目录> pull
也可以直接重新执行安装命令以更新到最新版本。
卸载
dsh plugin --profile web remove dsh-plugin-dracula-color-theme
注意事项¶
- 重启生效:安装后必须重启
dsh web应用,插件才会加载。 - 持久化行为:第三方主题 ID 不会被持久化,宿主会在设置加载时重新采用内置偏好,这是正常行为,插件通过守护机制处理此问题。
- 许可证:基于 MIT 许可证开源。
总结¶
dsh-plugin-dracula-color-theme 提供了一套完整的 Dracula 配色方案,解决了 DSH 默认主题与个人审美不符的问题。通过覆盖设计令牌和语法高亮,它为开发者提供了一个沉浸式的编码环境。更多细节请查阅项目主页或插件目录。