前言¶
DeepSeek Harness(DSH)的 Web 客户端支持通过外观设置切换 Light / Dark / System,但默认配色未必符合你长期盯屏时的视觉偏好。社区里已有不少皮肤类插件,常见做法是覆盖 CSS 变量或改宿主资源,维护成本和可逆性各不相同。本文介绍 dsh-grok-night-theme:一枚以 Grok Night / Grok Day 色板为灵感的纯 token 叠加层,不改宿主文件、不注入 DOM,停用即可还原。
这是什么¶
saber0616/dsh-grok-night-theme(Grok Night)由维护者 saber0616 发布,归类为趣味换装,当前 GitHub 星标为 0。插件面向 DeepSeek Harness Web UI,提供 GrokBot 风格的暖炭暗色与暖纸亮色两套语义色,并在新会话空白页注册一枚原创 SVG 机器人标记。README 明确标注为非官方社区项目,与 xAI / SpaceXAI / DeepSeek 均无隶属关系。
核心功能¶
明暗双生¶
dark走 Grok Night:画布#101012、抬升面#17181b,文字#f0eee8/#c3bfb5,琥珀强调#e0af68。light走 Grok Day:画布#f6f4ee、纸面#fffdf8,文字#1b1a17/#565249,深琥珀#8a5a12。- 跟随 DSH 外观设置(Light / Dark / System),不劫持主题偏好。
语义 token 覆盖¶
插件通过 ctx.theme.overrideTokens() 注入约 60 个 --dsw-* token,覆盖背景、层级、文字、品牌、按钮、边框、交互态、状态色、代码块、气泡、输入框、菜单、侧栏、滚动条、diff 等。状态色在暗色下为绿 #9ece6a、橙 #ff9e64、红 #f7768e;亮色下为绿 #2f7d3f、橙 #a05c00、红 #c0354d。
空白页机器人标记¶
标记注册在 conversation.hero.brand.mark,仅出现在空白会话页;随当前强调色着色。
实现方式与可逆性¶
全部逻辑集中在单文件 client.js,无构建步骤、无运行时依赖。theme/change 后会自动重新置顶 token,避免被其他皮肤层压住。在「设置 → 插件」停用或移除后,主题层整体移除,无持久状态需手动清理。
安装与启用¶
插件以当前 dsh 进程的权限运行,安装前请自行查阅仓库源码与 MIT 许可证。
从 GitHub 安装(推荐)¶
下面命令来自仓库 README,请原样使用:
dsh plugin --profile desktop add git+https://github.com/saber0616/dsh-grok-night-theme.git
安装后重启 dsh web(或按你平时的方式重启 DSH),再刷新浏览器页面。
从本地目录安装¶
在 DSH 的 plugin_manager 中使用 install_bundle,target 指向本仓库绝对路径:
install_bundle target: /absolute/path/to/dsh-grok-night-theme
卸载¶
dsh plugin --profile desktop remove dsh-grok-night-theme
或在「设置 → 插件」里停用/移除该 bundle。
典型用法与自定义¶
日常使用¶
安装并刷新后,无需额外配置:切换 DSH 外观即可在 Grok Day 与 Grok Night 之间切换,空白新会话页会显示机器人标记。
改色¶
所有色值集中在 client.js 的 TOKENS 对象,按 { light, dark } 成对声明。修改后重新加载插件或重启 DSH Web 即可;新增 token 时追加同名键,主题层会原样写入 CSS 变量。
兼容性与注意¶
- 开发与验证环境为 DSH
0.2.1-rc.5的 desktop profile,依赖ctx.theme.overrideTokens()与conversation.hero.brand.mark槽位。 - 与其它使用
overrideTokens的皮肤插件可共存:本插件在每次theme/change时重新置顶已设置的 token;未设置的 token 仍由宿主或其它插件决定。 - 若同时启用带壁纸/玻璃材质的皮肤,对方自定义 token 仍可能参与渲染;若要纯 Grok Night 画布,可暂时停用其它皮肤插件。
仓库结构(节选)¶
| 文件 | 作用 |
|---|---|
client.js |
Web Client:token 叠加层 + 机器人标记 |
index.js |
Host 侧 Loader |
cordis.patch.yml |
插件行插入 |
locale/en.json、locale/zh.json |
插件管理器文案 |
icon.svg |
插件图标 |
package.json 中版本为 1.0.0,许可证 MIT。
结尾¶
dsh-grok-night-theme 把 Grok Night / Grok Day 的暖炭与琥珀气质收敛成一枚可逆的 DSH Web 主题叠加层,适合希望在 Harness 里统一明暗两套克制配色的开发者。插件目录页与源码分别见:
- 目录页:https://www.skillhub.cn/plugins/saber0616/dsh-grok-night-theme
- GitHub:https://github.com/saber0616/dsh-grok-night-theme