🌙 夜间护眼助手 v5.6.19 - 详细说明文档

📋 概述

夜间护眼助手是一个全网通用的用户脚本，为所有网站提供专业的夜间模式支持，特别针对123云盘、蓝奏云等常用网站进行了深度优化，并新增了影视反色模式和代码页面专用夜间模式，有效保护用户在夜间使用电脑时的眼睛健康。

🎯 主要特性

🌍 全网支持

· 通用适配：支持所有网站，无需单独配置
· 智能识别：自动检测网站类型并应用最佳夜间模式方案
· 黑白名单：灵活控制哪些网站启用/禁用护眼模式

🎨 多模式支持

1. 白天模式 (☀️)：正常显示，不应用任何滤镜
2. 夜间模式 (🌙)：标准的深色主题，适合大多数网站
3. 墨黑模式 (🖋️)：专业设计的高对比度深色主题
4. 滤镜模式 (🎨)：基于CSS滤镜的色彩调整方案
5. 影视反色模式 (🎬)：特别针对视频类网站优化的反色技术

🛡️ 智能功能

· 昼夜自动切换：根据自定义时间自动切换模式
· 跟随系统：自动同步操作系统暗色模式设置
· 智能排除：自动识别已有暗色主题的网站
· 全屏处理：进入全屏时自动调整滤镜，避免冲突
· 动态加载支持：实时监控页面变化，动态应用样式

🔧 核心功能详解

1. 网站专用模式配置

· 优先级最高：可以为每个网站单独设置专用模式
· 四模式可选：白天、夜间、墨黑、滤镜模式
· 独立存储：网站设置与全局设置分离

1. 黑白名单系统

优先级顺序：
1. 黑名单（最高优先级，始终禁用）
2. 强制启用（需要全局开关或白名单开启）
3. 全局开关
4. 白名单

1. 特殊网站优化

· 123云盘：影视反色技术优化版，完美恢复蓝色元素
· 蓝奏云 (lanzou)：专门优化的反色模式
· 代码页面：JSON文件和代码查看页面的专用夜间模式
· Bilivod：视频网站的专用夜间模式

1. 代码页面优化

特别针对以下类型的页面优化：

· GitHub Raw文件
· JSON配置文件
· 代码查看页面
· 用户脚本元数据页面
· Scriptcat.org代码页面

⚙️ 设置选项

全局设置

· 全局开关：启用/禁用整个扩展
· 智能排除：自动排除已有暗色主题的网站
· 白天开启：白天时间也保持护眼模式开启
· 跟随系统：自动跟随操作系统的暗色模式

时间设置

· 昼夜时间：自定义白天和夜晚的时间段（格式：6:00|18:00）
· 自动切换：根据时间自动在白天/夜间模式间切换
· 反色强度：调整夜间模式的反色效果强度（0-100）

模式配置

· 墨黑模式配色：自定义墨黑模式的配色方案
· 排除元素：设置不需要反色的元素选择器

🎮 使用方法

快速操作

1. 切换模式：通过油猴菜单快速切换白天/夜间模式
2. 管理网站：为当前网站启用/禁用护眼模式
3. 设置面板：打开完整设置界面进行详细配置

菜单命令

· ☀️/🌙 模式名称：切换白天/夜间模式
· 🌍 全局开关：开启/关闭全局功能
· ✅/❌ 本站状态：为当前网站启用/禁用护眼模式
· ⚙️ 设置面板：打开详细设置界面

设置面板功能

1. 网站专用模式设置：为当前网站选择专用模式
2. 强制启用管理：强制在特定网站启用护眼模式
3. 黑名单管理：管理禁用护眼模式的网站列表
4. 全局参数调整：调整所有高级设置参数

🛠️ 技术特性

兼容性

· 浏览器支持：Chrome、Firefox、Edge等主流浏览器
· 油猴支持：Tampermonkey、Violentmonkey等用户脚本管理器
· 性能优化：轻量级实现，不影响页面加载速度

样式处理

· 彻底清理：应用新模式前完全清理旧样式
· 渐进增强：逐步应用样式，避免页面闪烁
· 动态适配：实时响应页面DOM变化

存储机制

· 本地存储：所有设置保存在本地，保护隐私
· 配置同步：通过油猴API实现配置的保存和读取
· 默认值回退：配置错误时自动恢复默认值

🔍 特殊场景处理

1. JSON和代码页面

· 自动识别：通过URL、Content-Type和内容特征识别代码页面
· 语法高亮保持：优化后的夜间模式保持代码语法高亮效果
· 专业配色：使用开发者友好的深色配色方案

1. 视频网站

· 影视反色技术：采用特殊的反色+hue旋转技术
· 媒体元素保护：保持图片、视频等媒体元素原始色彩
· 播放器优化：不影响视频播放器的正常功能

1. 全屏模式

· 自动调整：进入全屏时自动禁用滤镜模式
· 无缝切换：退出全屏时恢复原有设置
· 兼容性好：支持所有主流浏览器的全屏API

⚠️ 注意事项

兼容性问题

· 部分网站：某些复杂网站可能需要手动调整
· 浏览器扩展：可能与某些浏览器扩展冲突
· 性能影响：在低性能设备上可能略有影响

使用建议

1. 先测试后使用：新网站先测试效果再启用
2. 合理设置强度：根据环境光线调整反色强度
3. 定期清理：定期清理黑白名单中的旧记录
4. 备份配置：重要配置建议截图备份

🔄 更新日志

v5.6.18 更新内容

1. 新增功能：影视反色模式（基于bilivod.com技术）
2. 优化功能：代码页面专用夜间模式
3. 修复问题：全局切换中的模式错误问题
4. 改进体验：优化123云盘蓝色元素恢复效果
5. 增强兼容：改进JSON文件页面识别逻辑

📞 技术支持

常见问题

1. 模式不生效：检查黑白名单设置和全局开关
2. 样式异常：尝试清理样式或恢复默认设置
3. 性能问题：降低反色强度或关闭智能排除

反馈渠道

· 脚本管理器：通过油猴的反馈功能
· 配置备份：定期导出配置以防丢失

夜间护眼助手致力于为用户提供舒适、健康的夜间浏览体验，通过智能化的设计和深度优化的算法，让每个网站都能拥有专业的夜间模式支持。