PomodoroScreen · 智能番茄钟（macOS）

一款轻量、优雅、可定制的番茄钟应用。专注你的工作节奏，适时提醒休息，并以健康建议与可视化数据帮助你找到更高效、更健康的工作方式。

适合谁

• 需要高效时间管理、避免过度用眼/久坐的人
• 喜欢简洁、不打扰的状态栏工具
• 期望在“专注与健康”之间取得平衡的创作者、程序员、学生

亮点功能

🍅 状态栏番茄钟

• 清晰显示剩余时间与图标状态（运行/暂停/空闲）
• 菜单一键操作：开始、暂停/继续、停止、设置、快速测试

⏰ 灵活的计时

• 可自定义番茄钟与休息时长（默认 25/3 分钟）
• 支持长休息（例如每 2 个番茄钟后 5 分钟）
• 可选择将中断的短休息自动累积到长休息

🖥️ 全屏休息遮罩（不打扰，但有效）

• 半透明遮罩，柔和提示你“该休息啦”
• 背景可设为图片/视频，并支持轮播与播放速率
• 自动动画与轻交互：提示淡出、按钮悬停反馈、3 分钟后自动收起
• 专注模式：静默休息，不弹出遮罩

🤖 智能自动化

• 可选：无操作/锁屏/屏保时暂停或恢复
• 进入熬夜时间可触发“强制休息”保护
• 防抖与去重优化，避免重复弹窗与统计异常

📊 健康报告与建议

• 今日概览与每周趋势
• 工作时长、休息次数与总时长
• 健康建议（例如超 8 小时工作提示）与轻量庆祝动画
• 一键分享报告截图（包含完整页面内容）

🎨 个性化背景

• 图片（JPG/PNG/GIF）与视频（MP4/MOV/AVI）
• 列表管理、顺序轮播、播放速率（0.1x ~ 8x）

快速开始

1. 运行应用后，状态栏会出现番茄钟图标与 25:00
2. 右键图标 → 选择“开始”
3. 倒计时结束后将进入休息，显示全屏遮罩
4. 休息结束自动回到工作；也可点击“取消休息”立即返回

提示：你可以先在菜单中选择“测试完成（立即打开休息遮罩）”，用来体验遮罩与背景效果。

常用操作

• 开始/暂停/继续/停止：状态栏菜单
• 查看/修改设置：状态栏菜单 → 设置
• 查看报告：状态栏菜单 → 今日报告
• 分享报告截图：在报告页面使用“分享”按钮（自动隐藏按钮，截图为完整页面）

设置一览（建议先保持默认）

• 基础：番茄钟与休息时长、是否自动启动
• 自动处理：无操作/锁屏/屏保的暂停与恢复策略
• 计划：长休息周期、长休息时长、是否累积短休息
• 背景：添加图片/视频、顺序与速率
• 专注模式：开启后休息静默进行，不弹窗

关于“强制休息”（熬夜保护）

• 到达预设熬夜时间后，会触发强制休息保护
• 若你选择“关机”，遮罩会立即隐藏，避免因其他应用阻止关机而卡住
• 次日恢复后，遮罩会自动关闭

常见问题（FAQ）

• 看不到桌面/无法切换应用？
  • 休息遮罩是故意的“强提醒”，3 分钟后会自动隐藏；也可点击“取消休息”。
• 截图不包含完整页面？
  • 应用已支持完整页面截图（自动隐藏按钮）；如仍异常，可重试或稍等 1–2 秒再点。
• 统计数据异常（数量暴增）？
  • 版本已优化去重与强制休息链路。若你从旧版本升级，可在隔天观察统计是否恢复正常。
• 我不想要全屏遮罩，但想统计休息？
  • 打开“专注模式”，休息期间不会弹出遮罩，但仍会进入休息状态并计时。

隐私与本地数据

• 所有数据均保存在本地（应用支持目录）
• 不会上传到云端或任何服务器
• 你可以随时备份应用支持目录中的数据文件

系统要求

• macOS 14.0 或更高版本

版本速览

• v1.0.1：多标签设置、可视背景、休息动画与轮播、智能状态机、今日报告
• v1.0.0：基础番茄钟、状态栏、全屏休息提醒

帮助与反馈

• 在状态栏菜单中选择“设置”检查你的偏好是否生效
• 若遇到问题：
  • 重启应用
  • 检查是否启用专注模式或自动处理策略
  • 减少体积过大的视频背景
  • 仍未解决？请在项目中提交 Issue 并描述你的系统版本、复现步骤与期望结果