专注休息提醒

实现一个轻量级的、按用户/会话维护的状态机，用于触发休息提醒，避免频繁打扰。

配置

创建或加载 references/config.example.json 作为默认配置结构。

必需配置项：

• enabled
• timezone
• work_minutes
• cooldown_minutes
• idle_reset_minutes
• daily_max_reminders
• quiet_hours
• snooze_until
• templates

推荐采用实用且不具侵扰性的默认值：

• 工作时长：50 分钟
• 冷却时长：30 分钟
• 空闲重置阈值：15 分钟
• 每日上限：4 次

状态追踪

为每个用户（或初版中每个私聊/DM 会话）维护最小必要状态：

• session_start_at
• last_active_at
• last_remind_at
• remind_count_today
• today_key

将状态持久化至小型 JSON 文件，确保服务重启后提醒逻辑仍可继续运行。

更新活跃状态

每次收到用户消息时执行以下操作：

1. 若当前日期在配置的时区中已变更，则重置 remind_count_today 和 today_key。
2. 若距上次活跃时间 last_active_at 已超过 idle_reset_minutes，则将 session_start_at 设为当前时间。
3. 将 last_active_at 更新为当前时间。

评估是否可发送提醒

仅当全部条件满足时才触发提醒：

1. enabled 为 true。
2. 当前不在静默时段（quiet_hours）内。
3. 未处于小睡状态（即 now < snooze_until 时跳过）。
4. 当日提醒次数未达上限。
5. 当前持续活跃时长（now - session_start_at）≥ work_minutes。
6. 距离上次提醒已过冷却期（now - last_remind_at）≥ cooldown_minutes。

若所有条件均满足，则发送一条提醒，并更新以下字段：

• last_remind_at = now
• remind_count_today += 1

提醒内容交付

每次提醒使用一个简短模板。文案应务实、友好，避免医疗化表述。

示例模板：

• “你已经连续工作一段时间了。现在起身 2 分钟、喝口水，再看 20 秒远处 👀”

命令支持

支持以下聊天命令：

• /break on → 启用提醒
• /break off → 禁用提醒
• /break status → 显示当前配置及下一次可能触发提醒的时间窗口
• /break set → 更新 work_minutes
• /break snooze → 设置 snooze_until = now + minutes

需校验数值范围（例如工作时长限制为 15–180 分钟）。

心跳集成

通过心跳轮询机制，在检测到近期有用户活动时执行提醒资格检查，避免高频率无意义轮询。

建议行为：

• 若长时间无用户活动，则跳过检查。
• 若刚发送过提醒，则严格遵守冷却期，并快速返回。

安全与用户体验边界

• 不得提供任何医学诊断或治疗建议。
• 提醒功能必须为可选，且易于关闭。
• 仅存储提醒逻辑所必需的最少时间戳和配置项。
• 当数据缺失时，使用清晰明确的提示语，如：“待补充”。

测试清单

参考 references/test-cases.md 中的用例。

至少需验证以下场景：

• 在达到或超过工作时长后正确触发提醒
• 冷却期有效抑制重复提醒
• 空闲超时后正确重置会话计时器
• 静默时段内不触发提醒
• 小睡期间不触发提醒，直至小睡结束
• 达到每日上限后不再发送额外提醒