前言¶
長時間盯屏是智能體開發者的常見問題。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 倉庫。
