夜间护眼助手
夜间护眼助手 使用说明
📖 简介
夜间护眼助手是一款功能全面的浏览器护眼工具,支持为任意网站添加自定义护眼模式。它整合了多种视觉方案(夜间模式、滤镜、豆沙绿、深暖色等),并允许为不同网站设置专用模式,实现全局与局部的灵活搭配。同时,智能排除功能可自动识别已自带深色模式的网站,避免重复叠加。
🚀 主要功能
· 多种护眼模式
· 🌙 夜间模式:经典反色方案
· 🎨 滤镜模式:色彩滤镜,护眼效果强
· ⚫ 原版深色:100% 反色,无额外调光
· 🌿 柔和护眼:柔和反色 + 轻微对比度/饱和度调整
· 👁️ 护眼暗色:更柔和的亮度/对比度优化
· 🌱 豆沙绿:经典豆沙绿底色,浓度可调
· 🧡 深暖色:暖色滤光,浓度可调
· 全局与网站专用模式
· 可设置全局默认模式(通过菜单栏切换)
· 支持为特定域名设置专用模式,且优先级高于全局
· 提供“全局专用总开关”,一键临时禁用所有专用模式,快速回到全局设置
· 智能排除
· 自动检测已自带深色模式的网站(如 GitHub、YouTube 等),避免护眼模式叠加
· 可通过白名单强制对某些网站启用护眼(即使它自带暗色)
· 灵活的触发规则
· 全局开关、白名单、黑名单、强制启用,多级控制
· 支持按时间段自动切换模式(自定义昼夜时间)
· 可跟随系统暗色模式
· 自定义循环切换顺序
· 自由配置点击菜单时循环的模式列表(白天 → 模式1 → 模式2 → … → 白天)
· 浓度调节
· 豆沙绿、深暖色模式下可调节底色浓度(专用/全局)
⚙️ 安装与初次使用
- 在 Tampermonkey 或 Violentmonkey 等脚本管理器中新建脚本,粘贴提供的完整代码,保存。
- 脚本自动生效,浏览器右上角菜单栏会出现“夜间护眼助手”相关菜单项。
- 点击菜单项即可切换模式或打开设置面板。
🖥️ 菜单栏说明
脚本安装后,在 Tampermonkey 菜单中会显示以下条目:
· 当前模式名称(带图标)—— 点击可按照预设的循环顺序切换模式(白天 → 夜间 → 原版深色 → … → 白天)
· 🌍 全局: 开启/关闭 —— 控制是否在所有网站(除黑名单外)应用护眼模式
· ✅/❌ 本站: 启用/禁用 —— 将当前网站加入或移出白名单
· ⚙️ 设置面板 —— 打开详细设置界面
如果当前网站已设置专用模式,菜单中的模式名称后会有 [专用] 标记,点击切换会提示请去设置面板修改。
🛠️ 设置面板详解
点击菜单中的“⚙️ 设置面板”可打开详细配置窗口,包含以下区域:
- 当前状态
显示当前网站的模式、全局开关状态、白名单/黑名单状态、强制启用状态以及网站专用模式设置情况。
- 网站专用模式设置
· 域名或网址:输入要设置的域名(如 google.com)或完整网址(https://www.google.com),脚本会自动提取主机名。
· 专用模式:为该域名选择固定模式,或选择“默认(跟随全局设置)”。
· 豆沙绿/深暖色浓度:当选择豆沙绿或深暖色时,会出现浓度滑条,可独立调节该网站的底色浓度。
· 全局专用总开关:此开关开启后,所有网站的专用模式将被临时禁用,页面统一使用全局设置;关闭即恢复。开关旁显示当前状态(已启用/已关闭),且颜色会变化(启用时红色,关闭时蓝色)。
· 模式说明:可折叠展开,介绍各模式特点。
· 应用专用模式:将当前选择保存到指定域名。
· 重置为默认:清除该域名的专用模式设置。
- 全局豆沙绿浓度 / 全局深暖色浓度
这两个滑块仅在当前全局模式为豆沙绿或深暖色时出现,用于调整全局默认浓度(当没有专用模式覆盖时生效)。
- 强制启用管理
· 显示当前网站的强制启用状态。
· 强制启用后,即使全局开关关闭,只要网站处于白名单或全局开启,仍然会应用护眼模式(不受黑名单影响)。
· 可清空整个强制启用列表。
- 黑名单管理
· 黑名单中的网站将始终禁用护眼模式(优先级最高)。
· 可加入/移除当前网站,或清空所有黑名单。
· 显示当前黑名单列表。
- 全局循环模式配置
· 自定义点击菜单时循环的模式顺序(白天模式固定为起点和终点)。
· 支持添加、删除、上下移动模式。
· 至少保留一个模式。
- 全局设置(实时生效)
· 全局开关:主开关,控制是否启用护眼。
· 智能排除:开启后,脚本会检测网站背景色,若为深色则自动排除(白名单网站不受影响)。
· 白天开启:仅在白天时段(根据“昼夜时间”)自动保持开启(若与自动切换冲突,以自动切换为准)。
· 跟随系统:跟随浏览器/系统的暗色模式偏好。
- 时间设置
· 昼夜时间:自定义白天时段,格式如 6:00|18:00(24小时制)。
· 自动切换模式:格式 白天模式代码|夜间模式代码(0=白天模式,1=夜间模式)。
· 夜间强度:调整夜间模式的反色强度(0-100),默认 90。
- 底部按钮
· 切换模式:按全局循环顺序切换到下一个模式(与菜单项相同)。
· 启用/禁用本站:快捷将当前网站加入白名单或移出。
· 保存设置:保存所有更改(全局设置开关为实时生效,无需保存)。
· 恢复默认:将所有设置重置为脚本初始状态。
🔧 智能排除逻辑说明
当“智能排除”开启且当前网站不在白名单中时,脚本会检测以下条件,满足任一即不应用护眼模式:
- 页面存在 <meta name="color-scheme" content="dark">
- <html> 或 <body> 的 class 包含 dark
- data-theme 或 data-color-mode 属性值包含 dark
- 页面背景色 RGB 总和 < 150(判断为深色背景)
该阈值经过测试可准确识别绝大多数深色网站,同时避免误判浅色网站(如 liteapks.com)。
❓ 常见问题
Q1:为什么某些网站(如 YouTube)开启了全局模式却不起作用?
A:因为智能排除检测到该网站已自带深色模式,自动排除了。如果您仍希望应用护眼模式,可将其加入白名单(点击菜单“✅ 本站: 启用”即可)。
Q2:如何快速测试不同模式的效果?
A:使用菜单中的模式名称项(或设置面板底部的“切换模式”按钮),它会按照您配置的循环顺序切换。
Q3:专用模式与全局模式的关系?
A:专用模式优先级高于全局模式。如果某网站设置了专用模式(非“默认”),则无论全局模式如何,都会使用该专用模式。通过“全局专用总开关”可临时忽略所有专用模式,使用全局设置。
Q4:豆沙绿/深暖色浓度滑块为什么有时不显示?
A:浓度滑块仅在当前模式为豆沙绿或深暖色时出现。若在全局模式下,需将全局模式切换到对应模式;若在专用模式下,需为该网站选择对应模式。
Q5:设置面板打开缓慢或卡顿?
A:脚本已优化,首次打开会有短暂加载提示,之后操作流畅。若遇异常,可尝试刷新页面后重试。
📝 版本记录
· v5.21.5:优化按钮样式,修复滑块显示,统一专用模式设置区按钮布局。
· v5.21.4:改进智能排除逻辑,调整背景色阈值,优化全局专用总开关样式。
· v5.21.3:增强智能排除功能,支持向上查找背景色,避免误判。
· ……
📄 许可与致谢
本脚本为开源项目,基于原有“夜间模式”脚本整合开发,加入了豆沙绿、深暖色等护眼模式及专用模式管理功能。感谢所有贡献者和测试用户。
如有问题或建议,请在脚本评论区留言。祝您护眼愉快!