# DSH Eye Care

[English](README.md) | 中文

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

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

<p align="center">
  <img src="assets/eye-care-light.png" alt="DSH Eye Care 设置行：暖色日间主题，已选择日间和温暖" width="49%">
  <img src="assets/eye-care-dark.png" alt="DSH Eye Care 设置行：暖色夜间主题，已选择自动和温暖" width="49%">
</p>

## 功能

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：

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

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

重启或启动 Web UI：

```sh
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 就保持稳定。

## 开发

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

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

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

## 许可证

[MIT](LICENSE)