一个不打断你编码的桌面健康管家，默默守护你的眼睛、颈椎、腰椎。
Screen Reminder 是一款面向程序员的跨平台桌面健康提醒工具，通过全屏遮罩倒计时 + 智能调度，在不打断编码心流的前提下帮助你建立健康的屏幕使用习惯。
| 模块 | 触发间隔 | 提醒方式 |
|---|---|---|
| 👁 护眼 | 默认 20 min（可配 5–60 min） | 全屏遮罩倒计时 20 s |
| 🚶 久坐 | 默认 55 min（可配 20–120 min） | 全屏遮罩倒计时 3 min |
| 💧 补水 | 默认 45 min（可配 15–120 min） | 半屏弹窗卡片（喝了/跳过） |
| 🧠 智能调度 | 工作时段感知、空闲检测、暂停 | 09:00–18:00 每天有效 |
三个提醒均直接弹出全屏遮罩，无桌面通知打扰。按 Esc 跳过。
左键单击 → 只读状态卡片
┌──────────────────────────────────┐
│ ● Screen Reminder │
│ │
│ 👁 护眼：下次 15 分 30 秒 │
│ 🚶 久坐：下次 40 分 12 秒 │
│ 💧 饮水：下次 5 分 20 秒 │
│ │
│ ─────────────────────────────── │
│ 📊 今日统计 │
│ 护眼：完成 3 次，跳过 1 次 │
│ 久坐：站立 2 次，跳过 0 次 │
│ 饮水：800 / 2000ml (40%) │
│ │
│ 右键单击图标进行操作 │
└──────────────────────────────────┘
右键单击 → 操作菜单
┌──────────────────────┐
│ ⏸ 暂停 30 分钟 │
│ ⏸ 暂停 1 小时 │
│ ⏸ 暂停 2 小时 │
│ 🚫 今天禁用 │
├──────────────────────┤
│ 🚶 记录走动 │
│ 💧 记录喝水 (100ml) │
│ 💧 记录喝水 (200ml) │
│ 💧 记录喝水 (300ml) │
├──────────────────────┤
│ ⚙ 设置 │
├──────────────────────┤
│ ❌ 退出程序 │
└──────────────────────┘
手动记录喝水/走动后，对应的提醒计时器自动重置。
git clone git@github.com:hlltc/screen-reminder.git
cd screen-reminder
uv sync
uv run python -m srcuv run python -m src --demo
# +8s 护眼遮罩 → +16s 喝水弹窗 → +24s 久坐遮罩uv run python build.py
# 输出: dist/ScreenReminder.exe (Windows)
# dist/ScreenReminder (macOS/Linux)右键托盘图标 → ⚙ 设置，四个标签页即时生效：
- 通用：工作时段、午休、空闲检测阈值、遮罩透明度
- 护眼：提醒间隔 (5–60 min)、休息时长 (10–120 s)
- 久坐：提醒间隔 (20–120 min)、站立时长 (30–600 s)
- 补水：提醒间隔 (15–120 min)、单次/每日水量
| 技术 | 用途 |
|---|---|
| Python 3.11+ | 核心语言 |
| PySide6 (Qt) | 跨平台 GUI + 系统托盘 |
| pynput | 键盘/鼠标空闲检测 |
| SQLAlchemy + SQLite | 本地数据持久化 |
| pydantic-settings | 配置管理 |
| loguru | 日志 |
| Pillow | 图标处理 |
| uv | 虚拟环境 & 依赖管理 |
| PyInstaller | 打包分发 |
screen-reminder/
├── src/
│ ├── main.py # 入口
│ ├── app/ # 应用生命周期、单例控制
│ ├── tray/ # 系统托盘 + 弹出小组件
│ ├── ui/ # 设置窗口、全屏遮罩、喝水弹窗
│ ├── modules/ # 健康模块（护眼/久坐/补水）
│ ├── engine/ # 调度引擎、空闲检测
│ ├── data/ # 数据库模型 & 访问层
│ └── utils/ # 配置、常量、资源路径
├── assets/icons/ # 应用图标
├── build.py # 打包脚本
├── pyproject.toml # 项目元数据 & 依赖
└── doc/PRD.md # 产品需求文档
- Phase 1 — MVP：护眼 + 久坐 + 补水 + 托盘小组件 + 设置 + Demo 模式 + 今日统计 + 手动记录
- Phase 2 — 体验：APM 工作强度感知、Lottie 拉伸动画、数据面板
- Phase 3 — 智能：摄像头姿态检测、日历联动、PDF 健康报告
- Phase 4 — 生态：移动端 App、手表联动、浏览器扩展
MIT License