User guide

打开一次,然后让它安静地提醒。

主面板负责记录与查看,设置页负责工作时段和提醒频率。关闭窗口不会退出 App。

快速上手

菜单栏和程序坞都是入口。

v1.3.0 默认显示程序坞图标,菜单栏水杯仍是快捷入口;可在设置中关闭程序坞图标。

左键点击

打开健康提醒面板

查看今日饮水进度、下一个重点提醒、快捷记录和最近七天完成情况。

右键点击

打开菜单或退出

可以从菜单栏重新打开主面板,也可以从菜单栏或程序坞彻底退出 App。

快捷记录

按容器容量添加饮水

+50、+100、+250、+500、+850、+1000 ml 都能直接记录。

默认提醒

装好以后,默认这样运行。

上午与下午工作时段、提醒间隔、持续时间、声音、程序坞图标和登录启动都可以在设置页修改。

工作时间
08:30–12:00
13:30–18:00
护眼
每 20 分钟
休息 50 秒
起身
每 60 分钟
活动 5 分钟
稍后起身
10 分钟后
再次提醒
饮水目标
2000 ml
按工作进度检查
午休
12:00–13:30
暂停提醒

提醒出现时

你始终可以决定这一次怎么处理。

提醒不会锁住屏幕或强抢正在输入的窗口。起身卡片提供三个清晰动作。

开始活动

立即进入默认 5 分钟活动倒计时。

稍后 10 分钟

先完成手头工作,到时间后再出现一次提醒。

跳过

只跳过这一次,不会关闭后续提醒。

系统刚从睡眠恢复?

App 不会连续补发睡眠期间错过的旧提醒。Mac 已经闲置一段时间时,也会自动跳过相应提示。

权限与声音

通知权限决定系统横幅能否出现。

第一次启动时请允许通知。如果曾经拒绝,可以进入“系统设置 → 通知 → 喝水提醒”重新开启。

通知饮水与起身横幅
提示音跟随 Mac 系统提醒音量
程序坞默认显示,可在设置中关闭
登录启动可在 App 设置中开关
辅助权限不需要

常见问题

先排查这些情况。

为什么第一次启动时 macOS 提示无法验证?

当前公开版使用本地 ad-hoc 签名,没有 Apple Developer ID 签名和 Apple 公证。请只对从本项目 GitHub Releases 下载的版本,在系统设置的“隐私与安全性”中选择“仍要打开”。

可以关闭程序坞图标吗?

可以。v1.3.0 默认显示程序坞图标,方便重新打开和退出 App;在设置中关闭“在程序坞中显示图标”后,菜单栏水杯仍会保留。

升级 macOS 后菜单栏图标消失怎么办?

先从程序坞打开 App,再进入“系统设置 → 菜单栏”,确认“喝水提醒”已允许显示,然后退出并重新启动 App。建议确认恢复前先保留程序坞图标。

提醒会不会打断我正在输入的内容?

护眼和起身提示设计为不抢输入焦点。每小时的起身提醒会和饮水进度检查合并,避免同一分钟连续出现多条提醒。

数据会上传到服务器吗?

不会。App 没有网络功能,不需要账号;饮水与休息记录只保存在当前 Mac,并仅保留最近 7 个日历日。

支持 Intel 芯片的 Mac 吗?

当前公开版只提供 Apple 芯片(arm64)版本,不支持 Intel Mac。最低系统要求是 macOS 13.0。

退出窗口后提醒还会继续吗?

关闭主面板不会退出 App,提醒仍会继续。可以从菜单栏右键菜单、程序坞菜单或设置页选择退出,彻底停止提醒。