用眼过度提醒工具说明文档

📖 脚本简介

这是一个基于Python开发的用眼过度提醒工具，遵循kuai格式规范。该工具能够在用户长时间使用电脑时定时提醒休息，有效预防眼睛疲劳和干眼症，保护视力健康。

✨ 功能特点

⏰ 智能定时提醒

工作计时：可配置的工作时长（默认25分钟），专注工作不被打扰
休息提醒：定时提醒休息，避免长时间用眼导致视力疲劳
循环运行：工作-休息循环自动进行，无需人工干预

🔊 多重提醒方式

桌面通知：使用plyer库发送桌面通知，清晰醒目
声音提示：支持系统提示音和自定义蜂鸣声
控制台显示：实时显示倒计时和工作状态

⚙️ 灵活配置选项

工作时间：1-120分钟可调（默认25分钟）
休息时间：1-30分钟可调（默认5分钟）
声音设置：启用/禁用声音，选择声音类型
通知设置：自定义通知标题和显示时长
自动开始：程序启动后自动开始计时

🖥️ 实时状态显示

剩余时间：显示当前时段剩余时间
工作周期：记录已完成的工作周期数
休息统计：统计累计休息时间
进度指示：显示当前时段的完成进度

💻 系统要求

操作系统：Windows 11（推荐），支持其他Windows版本
Python版本：Python 3.11.0+
屏幕权限：需要允许桌面通知权限

📦 依赖库说明

必需库

plyer：跨平台桌面通知库，用于发送桌面提醒

库功能说明

库名	作用	缺失影响
plyer	发送桌面通知	无法弹出桌面提醒窗口
winsound	Windows声音播放	声音提示功能不可用

🚀 使用方法

启动参数配置

1. 时间设置

工作时间：设置每次连续工作的时长（1-120分钟）
休息时间：设置每次休息的时长（1-30分钟）

2. 提醒设置

通知标题：设置桌面通知的标题文字
启用声音提醒：开启或关闭声音提示
声音类型：选择系统提示音或自定义蜂鸣声
蜂鸣设置：自定义蜂鸣频率和时长
通知显示时间：设置通知显示的时长（5-30秒）

3. 显示设置

显示频率：控制台状态更新的频率（每分钟/每5分钟/仅通知）
自动开始：程序启动后是否自动开始计时

运行流程

启动kuai客户端
配置工作时间和提醒方式
点击"运行脚本"
程序开始计时工作
工作时长结束后弹出休息提醒
休息时间结束后自动开始下一工作周期
点击"中断运行"可停止程序

📊 工作原理

计时循环

提醒机制

工作结束时：
- 弹出桌面通知（使用配置的标题）
- 播放提示音（根据配置）
- 显示随机的休息建议
休息结束时：
- 弹出桌面通知（使用配置的标题）
- 显示随机的用眼建议
- 开始下一工作周期

状态跟踪

当前状态：工作中/休息中
剩余时间：当前时段剩余分钟数
周期计数：已完成的工作周期数
累计休息：今日累计休息时间

🔧 故障排除

常见问题

1. 没有桌面通知

现象：工作/休息结束时没有弹出桌面通知解决：

检查是否安装了plyer库：pip install plyer
检查系统通知权限设置
确保没有其他程序阻挡通知

2. 没有声音提醒

现象：提醒时没有播放声音解决：

检查"启用声音提醒"是否开启
检查系统音量设置
Windows系统确保winsound库可用

3. 程序无法停止

现象：点击"中断运行"后程序仍在运行解决：

使用任务管理器强制结束Python进程
重新启动kuai客户端

4. 手动启动模式问题

现象：输入命令没有响应解决：

确保在正确的命令行界面输入
检查输入的命令是否正确
尝试重新运行程序

⚠️ 注意事项

权限要求

桌面通知权限：需要允许程序发送桌面通知
系统声音权限：需要允许程序播放系统声音

兼容性说明

Windows最佳：在Windows系统下功能最完整
其他系统：macOS/Linux下可能部分功能受限
虚拟环境：在虚拟桌面环境中通知可能不显示

使用建议

合理设置时间：建议采用25分钟工作+5分钟休息的番茄工作法
及时响应提醒：听到提醒后应及时休息眼睛
调整显示器：保持适当距离和亮度
配合眼保健操：休息时可以做简单的眼部放松运动

🌟 特色功能

1. 智能休息建议

每次休息提醒时随机显示不同的护眼建议：

20-20-20法则：看20英尺外的物体20秒
眼部放松：闭眼深呼吸，放松眼部肌肉
眼部运动：转动眼球，做眼保健操
起身活动：喝杯水，伸展肩膀和颈部

2. 实时状态显示

控制台实时显示：

当前工作/休息状态
剩余时间（分钟）
完成进度百分比
累计工作周期数

3. 灵活的声音设置

支持两种声音模式：

系统提示音：使用Windows系统标准提示音
自定义蜂鸣：可调频率（37-32767Hz）和时长（100-5000ms）

4. 便捷的操作控制

自动开始：配置一次，自动运行
手动启动：灵活控制启动时机
优雅退出：支持Ctrl+C安全退出

🎯 适用人群

1. 办公室工作者

长时间面对电脑屏幕，需要定时提醒休息

2. 程序员/设计师

需要长时间专注工作，容易忘记休息时间

3. 学生

网课学习时间长，需要保护视力健康

4. 自由职业者

工作时间不规律，需要建立健康的工作节奏

🔄 工作流程示例

14:00:00 - 程序启动，显示配置信息
14:00:05 - 用户输入 'start' 启动系统
14:00:05 - 开始第1个工作周期
14:00:05 - [工作中] 剩余: 25分钟 | 进度: 0% | 周期: 1
14:25:00 - 工作时间结束！请休息
桌面通知弹出："👀 护眼提醒"
播放提示音
显示休息建议："远眺窗外，让眼睛看远处景物"
14:30:00 - 休息时间结束！继续工作
桌面通知弹出："👀 护眼提醒"
显示工作建议："调整显示器高度"
14:30:00 - 开始第2个工作周期

📈 健康效益

预防眼疾

减少眼睛干涩和疲劳
预防近视加深
降低干眼症风险

提高效率

规律休息提高工作效率
避免长时间工作导致的注意力下降
改善工作节奏，提升专注度

健康习惯

建立健康的用眼习惯

定期活动身体
保持适当饮水量

📞 技术支持

👨‍💻 作者： 程序员 curen
📧 反馈邮箱： 1139632166@qq.com

如有问题或建议，请：

检查是否按照要求安装所有依赖库
确认系统通知和声音权限已开启
尝试重新运行程序
查看控制台输出的错误信息
通过反馈邮箱联系作者

保护视力，从定时休息开始！ 👁️💻

用眼过度提醒工具