Eye眼改的是显示器的 Gamma 查找表，不是在屏幕上盖一层半透明色板。
所以黑色还是黑色、画面不发灰，也不会挡住任何窗口。它只管「屏幕发什么色」，
顺便按 20-20-20 提醒你抬头看远处。
01 · 快速开始
- 点右上角的总开关打开护眼。关掉它，屏幕会还原成原来的颜色。
- 拖色温滑杆，或直接点一个预设。数值越小越暖、越偏橙；6500K 接近原色。
- 想让颜色跟着时间自己变，去「24 小时曲线」卡片打开「按时间自动」开关。
- 想收到休息提醒，去「20-20-20」卡片打开开关。默认每 20 分钟一轮。
「按时间自动」和「20-20-20」是两个独立开关：前者管颜色，后者管提醒，互不影响。
02 · 面板速览
| 卡片 | 用来做什么 |
|---|
| 色温 | 手动调色温、颜色、亮度，选「应用到」哪几块屏 |
| 预设 | 一键套用常用配色，也能把当前配色存起来 |
| 20-20-20 | 休息倒计时、间隔、跳过、休息时是否调暗 |
| 24 小时曲线 | 按钟点或日出日落自动变色，锚点增删与过渡 |
| 用眼 | 今天用了多久、休息几次、最近七天，以及用眼建议 |
| 逐屏与免打扰 | 每块屏单独设，以及什么时候不打扰你 |
首页右上角的「手动 / 自动 / 跟随日光」小标签，显示的是当前颜色的来源。
03 · 手动调色
- 色温：1000–6500K。往左更暖，适合晚上；往右接近屏幕原色。
- 颜色：点取色器选任意颜色，会立刻切到「滤色」模式，此时顶部大数字变成色块，色温滑杆变淡表示它暂时不参与取值。想回到色温，拖一下色温滑杆或点一个色温预设即可。
- 亮度：10–100%。这是 Gamma 表里的亮度，不是显示器背光，不会让面板本身变暗或更省电，拉到底也不会像关灯。
- 应用到：一个快捷范围选择（全部屏幕 / 某一块屏）。它是筛选，不是逐屏配置；想给每块屏不同的颜色，用「逐屏与免打扰」卡片。
04 · 预设
内置七个：原色、轻度、办公、夜间、睡前、豆沙绿、纸质暖黄。前五个是色温，后两个是滤色。点一下就生效。
调出满意的配色后，点「存为预设」，起个名字保存，色温（或颜色）和亮度会一起记下来。自己存的预设把鼠标移上去，右上角会出现 ×，点它删除；内置预设删不掉。
05 · 24 小时曲线
曲线上每个圆点是一个锚点：某个时刻对应某个色温。两个锚点之间颜色保持不变，只在快到下一个锚点前按「过渡」分钟数慢慢变过去，不会一整天都在飘。
- 按时间自动：卡片右上角的开关。不打开，曲线画得再好也不生效，屏幕仍用手动值。
- 钟点 / 日出日落：钟点模式用你自己摆的锚点；日出日落模式按当地日出日落自动生成锚点。
- 锚点增删：拖动曲线上的圆点改时刻和色温；选中后用下方的时间、K 输入框精确填；「＋ 添加」在选中点附近加一个，「删除」去掉选中的那个。至少留 1 个、最多 12 个。
- 过渡：0–180 分钟，决定提前多久开始向下一个锚点渐变。
- 工作日 / 周末：两套曲线。周末单独设过之后，点旁边的「恢复跟随工作日」就能并回一套。
- 转暖倒数：曲线下方显示距离下一次变暖还有多久；日出日落模式下跟着当天日落走。
日出日落模式按配置文件里的经纬度算，本机算、不联网、不要定位权限。当前版本的面板没有经纬度输入框，需要改数据目录里 config.json 的 lat / lon。
06 · 20-20-20 与休息提醒
这条经验法则是：每连续看近处 20 分钟，看 20 英尺（约 6 米）外至少 20 秒，让睫状肌从近距离调节里松一松。它是缓解视疲劳的习惯，不是治疗近视的方案。
- 默认固定 20 分钟一轮，在「间隔」里可改成 1–180 分钟。人离开、全屏或演示时只会把到点时间往后顺延，回来接着算，不会重置整轮。
- 到点时屏幕会短暂变暖压暗，默认 6 秒后自动恢复，不打开面板也能察觉；旁边的秒数输入框能改成 2–60 秒。横幅上是休息倒数。不想要这个效果，关掉「休息时调暗」，只留横幅。
- 「跳过这次」把这一轮跳过去。开着「真的停手才记休息」时，休息期间还在敲键鼠，这一次就不计入「休息了几次」。
「休息了几次」只统计护眼开启期间、确实触发过的休息，是全插件里最不精确的一个数，看看趋势就好。
07 · 逐屏与免打扰
「每块屏单独设置」里，每行从左到右是：屏幕名、参与开关、模式、取值、亮度、当前生效。
| 模式 | 含义 |
|---|
| 跟随 | 用全局色温 / 曲线，取值列显示当前跟随值，不能改 |
| 独立 | 这块屏用自己的色温，忽略全局设置 |
| 滤色 | 这块屏用自己的颜色，取值列变成取色器 |
关掉某块屏的开关，它就保持原色；「应用到」只是快速把范围收窄到一块屏，两者叠加时以逐屏设置为准。
- 人离开时暂停计时：超过两分钟没碰键鼠，暂停提醒和用眼计时。查不到空闲信息的平台按「人在」处理，不会悄悄停掉提醒。
- 全屏内容时让位：前台是全屏游戏、播放器、演示时，暂停写屏和提醒。
- 演示模式：一键暂停 60 分钟，适合投屏开会，到点自动恢复；再点一次可提前结束。
- 抢桌检测：写屏前会读回 Gamma 表，发现被 f.lux、Night Shift、显卡驱动之类改过，就暂停写屏并在页面顶部提示。确认后点「重新接管」继续。
08 · 用眼记录与用眼建议
「用眼」卡片显示今天累计时长、休息次数、最长连续时长和最近七天的柱状图。记录按天存，只保留最近 30 天；人离开的时段不算进去。
用眼建议默认关闭。打开后才分析本机记录，找出最容易连续用眼的时段，攒够至少 3 天带钟点的数据才给结论。它只给一句话和一个「应用建议」按钮，不打开就完全不分析。
点「应用建议」只会往曲线里加（或更新）一个锚点，不会替你打开「按时间自动」。想让它生效，要自己去曲线卡片把那个开关打开。日出日落模式下、附近已有锚点或锚点已经到 12 个时，按钮不会出现或会提示加不上。
09 · 隐私与数据
- 不联网：插件只申请了工作台和事件两个宿主能力，没有网络权限，日出日落也是本机按公式算的。
- 不读窗口标题、不记按键内容、不订阅输入事件：在场感知只查询「距上次键鼠输入多少秒」和前台窗口的矩形大小，用来判断人是否离开、是否全屏。
- 不起子进程、不监听端口：侧车只通过标准输入输出和宿主讲 JSON-RPC。
- 数据全在本机：宿主指定的数据目录里只有三个文件——
config.json（配置）、stats.json（用眼记录）、original_ramp.txt（改屏前拍下的原始 Gamma 表）。
- 能还原：关掉总开关、正常退出插件，屏幕都会还原成原始 Gamma 表。万一插件被强杀来不及清理，下次启动会先按备份还原再继续，不会让屏幕一直偏色。
10 · 常见问题
开关开了，屏幕没变化？
依次看：总开关是否打开；该屏在「逐屏」里是否被关掉或「应用到」被收窄；是不是开了 HDR；是不是正在独占全屏；页面顶部有没有 Gamma 冲突提示。Wayland 会话明确不支持，面板会直接写明原因。
HDR 屏为什么不变色？
系统在 HDR 下会绕过 Gamma 表，这是系统行为，插件改不了。关掉 HDR 才生效。
装了 f.lux / Night Shift / 显卡自带护眼，颜色互相跳？
只留一个。插件检测到 Gamma 表被别人改过会自动暂停写屏，页面上出现提示，点「重新接管」才继续。
多屏只有一块变色？
看「逐屏与免打扰」里每块屏的开关和模式，以及手动控制里的「应用到」范围。
亮度拉到 10% 屏幕还是刺眼？
这个亮度改的是 Gamma 表，不是背光。想真正变暗请用系统亮度或显示器按键。
应用了用眼建议，颜色没变？
建议只加锚点，还要自己去曲线卡片打开「按时间自动」。
离开一会儿回来马上又提醒？
空闲只把到点时间往后顺延，不重置一轮。开会可用「演示模式」暂停 60 分钟。
日出日落时间不准？
检查 config.json 的 lat / lon；当前面板没有输入控件，也没有城市列表。
关掉插件后屏幕还偏色？
正常退出会还原。若是强杀，重新打开插件一次让它读备份还原，再关掉即可；实在不行重启系统也会重置 Gamma 表。
11 · 已知限制
- HDR 开启、独占全屏程序会绕过 Gamma 表，属正常现象。
- Linux Wayland 没有公开接口改 Gamma，插件会直接说明不支持；XWayland 里改的是它自己那份表，桌面不变。
- macOS 上「全屏内容时让位」尚未实现，空闲暂停仍然可用；查不到空闲信息的平台一律按「人在」处理。
- 日出日落模式需要手填经纬度，面板暂无输入框和城市列表。
- 本说明整篇随插件打包，不联网也能看；按 Esc 或点弹框外的空白处关闭，文字可选中复制。
