什么是Hydration Tracker
Hydration Tracker 是一款专为命令行环境设计的每日饮水追踪工具，旨在帮助用户建立并维持健康的补水习惯。它通过简洁的命令行界面，让用户能够轻松记录每天的饮水量、设定个性化目标，并在达成目标时获得即时反馈与鼓励。所有数据均本地存储于 JSON 文件中，无需联网或注册账户，确保隐私与安全。该工具特别适合那些偏好轻量级、无干扰方式管理日常健康行为的用户。无论是忙碌的上班族还是注重养生的个体，都可以借助 Hydration Tracker 实现全天候的水分摄入监控。其设计哲学强调易用性和实用性，避免复杂配置，让用户专注于核心功能——喝水这件事本身。 作为一款完全离线的应用，Hydration Tracker 不依赖任何外部服务或 API 密钥，仅需 Bash 4+、Python 3（标准库）以及常见的 POSIX 工具即可运行。数据存储在用户主目录下的 `~/.water_reminder/` 文件夹中，包括每日摄入记录（`data.json`）和自定义目标（`goal.json`），最多保留最近 30 天的历史数据。这种本地化处理方式不仅保障了数据安全，也提升了响应速度，使命令执行几乎瞬时完成。此外，工具内置了多种快捷操作，如快速记录一杯水或一瓶水，极大提升了使用效率。整体架构清晰、代码简洁，非常适合集成到自动化脚本或习惯养成流程中。
核心功能特点
- 支持按毫升精确记录每次饮水量，默认单位为250ml，并可自定义每日补水目标
- 提供‘cup’和‘bottle’快捷命令，一键记录常见饮水量，提升操作便捷性
- 实时显示当日累计摄入量与目标进度，并在达成目标时触发庆祝提示增强正向激励
- 具备‘check’功能，根据当前时间判断是否按计划补水，帮助用户在下午前及时调整
- 生成7日 hydration 趋势报告，直观展示每日完成情况与周平均摄入水平
- 内置随机 hydration 小贴士功能，通过命令行推送科学饮水建议辅助习惯养成
适用场景
Hydration Tracker 最适用于希望系统性改善日常饮水行为的个人。对于那些长期忽视主动补水、容易因工作繁忙而忘记喝水的人群来说，该工具能通过持续的数据反馈培养规律性饮水意识。例如，程序员或远程工作者可在长时间编码后使用 `drink 300` 快速记录一次补充，再通过 `today` 查看剩余缺口，从而避免晚间一次性过量饮水。学生群体也可利用其统计功能回顾考试周期间的 hydration 表现，分析压力对生活习惯的影响。 另一个典型应用场景是健康管理需求者，如正在进行体重控制、运动训练或患有轻度脱水倾向的人士。他们可通过调整 `goal` 参数设置更高或更低的每日目标，结合 `week` 命令观察长期趋势，科学评估自身水分摄入是否满足身体实际需求。对于喜欢量化自我（Quantified Self）的用户而言，Hydration Tracker 提供的历史回溯与统计分析功能，使其成为构建个人健康仪表盘的重要组成部分。 此外，该工具还适合嵌入自动化提醒系统。例如，结合定时任务每天中午执行 `hydration-tracker check`，若发现进度滞后则自动发送桌面通知，形成被动式干预机制。由于其完全本地化运行且无网络依赖，也适用于对隐私敏感或对在线服务持保留态度的用户群体。无论是作为独立命令行工具使用，还是与其他健康类应用联动，Hydration Tracker 都能以极简的方式融入用户的数字生活节奏中。