什么是ReefBeat
ReefBeat 是一款专为 Red Sea ReefBeat 水族生态系统设计的本地控制工具，通过标准的 HTTP API 实现对所有 ReefBeat 设备的直接管理与监控。该工具完全基于局域网运行，无需依赖云端服务或外部认证机制，确保了设备控制的实时性与隐私安全性。无论是 ReefLED 系列照明系统、ReefRun 水泵与蛋白质分离器，还是 ReefATO+ 自动补水装置、ReefMat 滤棉卷盘以及 ReefWave 波浪泵，均可通过统一的命令行接口进行精细操作。其核心优势在于本地直连、全功能覆盖和即插即用，为专业水族爱好者和自动化系统集成商提供了高度可控且低延迟的硬件交互方案。
ReefBeat 工具采用 Python 编写，支持跨平台部署，用户可通过简单的脚本命令完成设备发现、状态查询、参数配置及远程控制等操作。它利用 UDP 探测技术自动识别网络中的 ReefBeat 设备，随后通过 HTTP GET、POST、PUT 和 DELETE 请求与设备通信，实现诸如调节灯光强度、切换喂食模式、启动预览波形、手动推进滤棉卷或重置 ATO 故障状态等功能。所有指令均可在本地执行，避免了因网络延迟或云服务中断导致的控制失效问题。
此外，ReefBeat 提供了详尽的 API 参考文档（位于 `references/api.md`），涵盖每个端点的用途、请求格式与响应结构，极大降低了二次开发门槛。对于希望构建自定义水族管理系统的开发者而言，这套本地 API 不仅稳定可靠，还具备完整的可编程能力，能够无缝集成到智能家居平台或自动化流程中，真正实现无人值守的智能海洋缸运维。
核心功能特点
- 完全本地化运行，无需云端连接或账户认证
- 支持所有 ReefBeat 设备类型：ReefLED、ReefRun、ReefATO+、ReefMat、ReefWave
- 提供设备自动发现功能，一键扫描局域网内所有可用设备
- 通过标准 HTTP 方法（GET/POST/PUT/DELETE）实现全功能控制
- 命令行驱动设计，便于脚本化集成与自动化操作
- 包含详细的 API 文档与示例代码，降低开发使用门槛
适用场景
ReefBeat 特别适用于需要高可靠性与低延迟控制的专业水族应用场景。例如，在大型海水缸或珊瑚繁殖系统中，用户可通过 ReefBeat 脚本定时触发喂食模式或调整光照周期，确保生物节律精准同步；当 ReefATO+ 检测到水位异常时，管理员可立即调用 `/resume` 接口恢复自动补水，避免因软件界面卡顿或网络波动造成的水位失控风险。对于使用 ReefWave 的用户，ReefBeat 允许启动短时预览模式测试水流效果，而无需反复切换手机 App，显著提升调试效率。
在家庭自动化场景中，ReefBeat 可作为 Home Assistant 或其他智能家居中枢的本地插件，实现与其他环境传感器联动。比如结合温度探头数据动态调节 ReefRun 水泵转速，或在夜间自动开启 ReefLED 的月光模式营造自然氛围。由于全程在局域网内通信，即使互联网断开也不会影响核心功能，保障了长期稳定运行。
对于从事水族设备二次开发的工程师，ReefBeat 提供的开放 API 是理想的底层控制接口。开发者可以基于其命令集构建图形化管理面板、数据分析模块或远程监控告警系统，而无需深入理解硬件协议细节。无论是批量配置多个水族箱设备，还是记录历史操作日志用于优化饲养策略，ReefBeat 都能提供灵活且强大的支持。