前言¶
长时间盯屏是智能体开发者的常见问题。DeepSeek Harness（DSH）采用插件化架构，允许用户按需扩展功能。本插件通过定时提醒缓解眼部疲劳，属于客户端插件。
是什么¶
dsh-eye-care 是一个 DSH Web UI 插件，由维护者 LvenxjY 开发。它每隔一段可配置的时间弹出休息卡片，提示用户看远处 20 秒，默认间隔 20 分钟。
核心功能¶
定时提醒与倒计时¶
到点弹出一张休息卡片，显示倒计时 20 秒，提示「看 6 米（20 英尺）外」。
丝滑进度环¶
卡片左侧的圆环由 requestAnimationFrame 逐帧驱动，连续扫过。系统开启「减少动态效果」时会退回每秒刷新。
可配置间隔¶
默认 20 分钟，可在 1–240 分钟之间任意输入。输入后失焦或按回车生效，按 Esc 撤销；超出范围会自动夹到边界。
颜色选择¶
提供四种提示颜色：跟随主题、护眼浅绿、天蓝色、红色。点一下立即切换。
顶部悬浮卡片¶
提醒出现在对话区上方居中，不遮挡输入框。按 Esc 或点击「稍后 5 分钟」可推迟。
输入框倒计时胶囊¶
在输入框下方显示实时剩余时间，点击胶囊可暂停 / 恢复全部提醒。
只在可见时计时¶
页面切到后台时计时暂停，不把离开屏幕的时间算作用眼时间。
中英双语与主题一致¶
文案跟随 Harness 的语言设置；未注册时按浏览器语言回退。结构色取自 --dsw-alias-* 主题变量。
安装与启用¶
面向 DeepSeek Harness 桌面版（Web UI）。
- 打开左侧边栏的 Plugins
- 点 Add plugin
- 在包名输入框里粘贴这一行：
github:LvenxjY/dsh-eye-care#7453c79ce01f69db032743e410b92ffe30d1d5f1
- 点 Install，等待安装完成
插件是纯 JavaScript，没有构建步骤，不会弹出任何「是否允许运行安装脚本」的确认。
安装后没反应？¶
- Plugins 页面里确认是否出现
dsh-eye-care，开关是否为开 - 刷新一次页面（
Ctrl+R） - 打开
设置 → 通用，确认有「护眼提醒」这一行
版本要求¶
需要 DeepSeek Harness 0.2.1-rc.2 或更高（且低于 0.3.0）。低版本会在安装时被拒绝，并提示版本不兼容。
使用¶
装好后立即生效，无需重启。默认开启、间隔 20 分钟、颜色跟随主题。
设置 → 通用 → 护眼提醒 一行里有三个控件：
| 控件 | 说明 |
|---|---|
| 数字框 | 直接输入分钟数（1–240）。失焦或按回车生效，按 Esc 撤销；超出范围自动夹到边界 |
| 四个圆点 | 提示颜色：跟随主题 / 护眼浅绿 / 天蓝色 / 红色，点一下立即换色 |
| 开关 | 启用或停用全部提醒；关闭时数字框和色点变灰不可改 |
其他操作：点输入框下方的「护眼 19:58」胶囊可快速暂停；在提醒卡片上点「稍后 5 分钟」或按 Esc 可跳过这一次。
偏好保存在浏览器 localStorage 的 dsh-eye-care.settings.v1 键下，按浏览器独立生效。
卸载¶
Plugins → 找到 dsh-eye-care → Remove。
偏好设置独立于插件存在，卸载后会留在浏览器里；想彻底清干净，在开发者工具的 Console 里执行：
localStorage.removeItem('dsh-eye-care.settings.v1')
兼容性¶
engines.dsh 声明为 >=0.2.1-rc.2 <0.3.0-0。DSH 在安装和启动时检查这个范围，版本不匹配会拒绝加载。
插件用到三个 slot：shell.overlay、conversation.composer.dock、settings.general.item。它们由 DSH 的 Web bundle 声明；缺少时插件不会强行改写其他 UI。
适用场景与注意¶
适合需要在 DSH 中保持用眼健康、希望有自动提醒功能的开发者。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
结尾¶
本插件通过简单的提醒机制帮助开发者缓解眼部疲劳，属于 DSH 生态中客户端插件的一种。更多细节可查看插件目录页与 GitHub 仓库。
