前言¶
DeepSeek Harness(DSH)的 Web 界面默认只有「浅色 / 深色 / 跟随系统」三档外观。长时间看对话和代码时,纯白背景和偏冷的强调色容易加重视觉疲劳;若只靠浏览器扩展或页面滤镜,往往和 Harness 自带的设置页、插件页、代码块、diff 样式对不齐,卸载后还容易留痕迹。
下面介绍社区插件 dsh-eye-care-theme(维护者 houguofei,分类:趣味换装)。它在不改动组件结构的前提下,通过 DSH 官方的 ctx.theme.register 注册第三套浅色系主题 eye-care,用暖色纸感 token 覆盖 --dsw-* 设计变量,并提供设置开关与侧栏一键切换。
这是什么¶
dsh-eye-care-theme 是给 DeepSeek Harness Web GUI 用的护眼主题 bundle。仓库地址:https://github.com/houguofei/dsh-eye-care-theme;社区目录页:https://www.skillhub.cn/plugins/houguofei/dsh-eye-care-theme。
插件在 package.json 中的描述为:在 light/dark 之外提供第三套配色,并在 Settings 与侧栏提供开关。许可证为 MIT(README 与 package.json 一致);当前 GitHub 星标为 0(以目录页信息为准)。
核心功能¶
第三套外观 eye-care¶
主题 id 为 eye-care,colorScheme: light。实现方式是覆盖 Harness 的 --dsw-* token,而不是逐个改组件样式,因此设置、插件页、代码块、菜单、diff 等会一起变暖。思路是重写 --dsw-static-* 色阶(暖灰、柔化强调色、降饱和状态色),并补少数 alias 与代码高亮色,避免「米黄底 + 冷灰零件」的割裂。
两个入口¶
- 设置 → 通用 → 护眼模式:紧跟「外观」下方,带说明文字的显式开关(
settings.general.item,order: 10.5)。 - 侧栏底部眼睛图标:一键切换;开启时瞳孔实心并染青绿,关闭为描边。侧栏折叠成轨道时图标改为 36px(
sidebar.footer.action,order: 10)。
状态与生命周期¶
- 开关状态以及开启前的原外观偏好(浅色 / 深色 / 跟随系统)写入本机
localStorage(键:dsh-eye-care:enabled、dsh-eye-care:previous),刷新或重开窗口可恢复。 - 若在「外观」里改选浅色或深色,护眼模式会立即退出,两个入口状态一致。
- 主题、样式、字典、槽位注册由
ctx.effect持有;卸载插件(插件管理器remove_bundle)后完整回退,不留残留 token。
安装与启用¶
本仓库即 DSH bundle 包根(package.json 含 dsh.bundle.patch 与 dsh.client)。尚未发布到 npm;README 说明发布后可直接按包名 dsh-eye-care-theme 安装。
当前 README 给出的获取仓库方式如下:
git clone https://github.com/houguofei/dsh-eye-care-theme
取得目录后,在 DSH 中将其作为插件安装:对 agent 说明「把 <克隆路径> 装成插件」,会走插件管理器的 install_bundle,把 bundle 加入当前 profile。安装完成后刷新一次页面即可看到开关。
插件以当前 DSH 进程权限运行;安装前请自行查看源码与 MIT 许可证,确认符合你的环境策略。SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
典型用法¶
- 点击侧栏底部眼睛图标,或进入 设置 → 通用 → 护眼模式 打开护眼。
- 关闭护眼时,界面回到开启前保存的外观偏好(例如原先为深色则回到深色)。
- 卸载插件后,如需清理本地记录,可删除
localStorage中的dsh-eye-care:enabled与dsh-eye-care:previous(内置浅色/深色偏好不受影响)。
配色相对内置浅色的部分对比如下(摘自 README):
| 用途 | token | 内置浅色 | 护眼 |
|---|---|---|---|
| 应用背景 | --dsw-alias-bg-base |
#ffffff |
#fbf7ee |
| 侧栏 | --dsw-specific-sidebar-fill |
#f9fafb |
#f5efe2 |
| 链接 / 品牌点 | --dsw-static-deepseek-500 |
#4176e6 |
#4a8177 |
适用场景与注意¶
适合:长时间使用 DSH Web GUI、希望在不改组件的前提下整体降低刺眼感与蓝光倾向的用户。
已知限制(README):
- 内置 bootstrap 会先按已保存的浅色/深色绘制首屏,插件加载后再切到护眼,启动时可能有极短配色过渡。
- 护眼偏好仅存于当前浏览器;换浏览器或清站点数据后需重新开启。
- 只改设计 token,组件内硬编码颜色或内嵌第三方内容不会跟随变化。
- 护眼为浅色系;在深色偏好下开启会明显变亮,属预期行为。
改配色时只需编辑 client.js 顶部的 TOKENS 对象;语法自检:
node --check client.js && node --check index.js
结尾¶
dsh-eye-care-theme 把 DSH 外观从「浅 / 深 / 系统」扩展为可选的暖色纸感第三主题,并通过设置与侧栏双入口切换,卸载可完整回退。详情与 issue 见 GitHub:https://github.com/houguofei/dsh-eye-care-theme;目录页:https://www.skillhub.cn/plugins/houguofei/dsh-eye-care-theme。