Anionex/dsh-eye-care

DSH Eye Care

暖色浅色、暖色暗色，自动跟随系统。

这是一个 DeepSeek Harness Web Profile Bundle：用六套暖色语义主题替换冷白界面配色，同时保持原生外观偏好不被破坏。

功能

DSH Web 内置的 Light 与 Dark 主题偏冷。护眼模式在不使用全局 sepia 滤镜或图片变换的前提下，提供暖色浅色、暖色暗色和自动明暗切换。

- 四种模式： off、auto、light、dark。
- 三档暖色强度： soft、balanced、warm。
- 六套具体主题通过官方 ThemeService 注册。
- 真正的语义 token覆盖背景、文字、边框、按钮、sidebar、bubble、输入框、代码块、滚动条与 Shiki 配色。
- 原生外观仍然权威： 选择浅色、深色或跟随系统会关闭护眼模式，并保留新选择的主题。
- Loopback 持久化把选择保存到 Host settings；远程浏览器则把选择保留在当前进程。

预览

上方截图分别展示暖色日间与暖色夜间状态下的 General 设置行。日间与夜间是显式模式；自动模式会按所选暖色强度跟随 prefers-color-scheme。设置行还提供 aria-live 状态提示和键盘可见的焦点状态。

安装

把公共 npm 包一键安装到 Web Profile：

dsh plugin --profile web add @anionex/dsh-eye-care

本地开发时，把包名替换为 checkout 的绝对路径或本地打包的 tarball。DSH_HOME 默认指向 ~/.dsh；只想试用而不改动主 Profile 时，可把它指向一个临时目录。

重启或启动 Web UI：

dsh web

打开 设置 → 通用设置 → 护眼模式，选择模式与暖色强度。

主题矩阵

| 明暗 | 柔和 | 均衡 | 温暖 |
|---|---|---|---|
| 浅色 | eye-care-light-soft | eye-care-light-balanced | eye-care-light-warm |
| 暗色 | eye-care-dark-soft | eye-care-dark-balanced | eye-care-dark-warm |

工作原理

Host 半区注册 eye-care Settings 命名空间，并暴露仅限 loopback 的 Connection RPC 通道 /eye-care。写入串行执行，并以 expectedRevision 做版本栅栏；发生冲突时重新读取 Host 快照，再重试最新意图。

Browser 半区注册六套主题，注入 General 设置行，并管理控制器生命周期。控制器订阅 theme/change 与 prefers-color-scheme，在关闭或卸载时恢复启用护眼前的主题，并在 dispose 时注销全部主题。远程浏览器不注入 Host RPC，因此选择保持进程本地。

兼容性与限制

- 需要包含标准 settings、connection、locale、slots 和 theme 服务的 DeepSeek Harness Web Profile。
- 原生外观切换按设计视为明确退出护眼模式。
- 远程浏览器会话不会把护眼选择回写到 Host。
- 不使用全局颜色滤镜；所有颜色都来自命名的语义 token。
- 该包处于预发布阶段，遵循 Profile Bundle 格式；只要 bundle 已安装，其生成的主题 id 就保持稳定。

开发

cd dsh-eye-care
pnpm install --frozen-lockfile
pnpm run check
pnpm run test
pnpm run build

运行可选的干净 Profile 安装测试：

DSH_EYE_CARE_PROFILE_E2E=1 pnpm exec vitest run tests/profile-install.e2e.spec.ts

许可证

MIT