WaterBuddy：一个提醒，怎样变成真实反馈

小七 · 项目开发记录 · 2026-10-08

从计划估算、触摸确认到云端记录，梳理提醒设备与网站之间的几次调整。

WaterBuddy 从喝水与活动提醒出发，把桌面原型、网站和云端连接起来。这篇记录整理的是截至2026年9月27日的网站与固件对齐工作：怎样安排提醒，怎样让设备解释状态，以及网站该怎样展示真实发生的事情。这里没有把概念图当成量产设备，也没有把网站发布当成实机验收。

提醒之后，还需要一个清楚的回应

原型采用 ESP32-C3，配有 OLED、触摸模块、存在感应模块和七灯灯环。网站可以配置提醒计划、查看设备状态与历史；设备负责按计划发出提醒，并把事件或命令结果回传。灯环的喝水提醒使用蓝青色，活动提醒使用暖橙色。震动与声音仍是预留能力，不在网页里写成已经安装的功能。

网站根据云端的时间段和间隔估算下一次提醒，但设备可能离线、尚未同步配置，或者已经在本地延后提醒。原来过于确定的倒计时容易让这两个状态混在一起。调整后，界面明确写“按计划预计下一次”，并说明离线、待同步和延期会影响实际执行时间；设备没有上报的延期截止时间，网站不自行推算。

计划计算还有一个容易忽略的细节：当时间段重叠时，固件使用列表中第一个包含当前时刻的时间段。源码核对后，网站保留配置顺序，过滤被前序时间段遮蔽的候选，继续寻找有效提醒时间，不把多个时间段简单合并。

时间段（按配置顺序）：14:00–18:00、08:00–12:00、09:15–10:00
喝水间隔：40 分钟；当前时间：09:10
按首个匹配时间段计算：下一次为 09:20，而不是 09:15

网站发起的设备测试和本地交互演示，用来验证显示、灯光与响应，不能进入每天的习惯统计。Dashboard 只聚合真实提醒和用户确认事件；命令的 COMPLETED 结果只表示这条测试命令完成。触摸确认也不等于测量到实际饮水量，因此界面使用“提醒触发”“用户确认”，不把它包装成健康评分。

V0.5.5 配套说明区分单击确认、双击延后与测试交互，并补充绿色确认、黄色延期和自然结束淡出的反馈。但这些说明只对已经核对的固件与原型硬件组合显示。旧版、未上报版本和未审查的未来版本继续显示基础说明；网站不因为版本号更大，就假定设备一定具备新能力。灯环超时也保留失败状态，给出中文提示。

9月27日的记录显示，网站侧26项自动测试、构建和上线后的登录与业务读取检查通过。这轮仅替换网站应用，没有改固件、设备协议或数据库。上述计划规则还经过固件源码和主机测试核对；这些结果可以证明网站的处理逻辑，却不能代替真实设备操作。

同一轮发布记录中，真实设备最后上报的是0.5.4，发布时离线。因此0.5.5真机的单击、双击、灯环反馈、事件传输与命令最终结果，仍需要设备重新上线后逐项核验。这是9月27日的历史验证边界，不作为设备今天在线状态的声明。下一篇值得补的，是这条完整实机链路的过程和结果。