核心用法
hour-meter 是一款数字化的"霍布斯计时器"（Hobbs meter），用于精确追踪从特定时间点起经过的时间。支持三种核心模式：
- COUNT UP：正向计时，记录自某事件起的流逝时间（如戒烟天数、设备运行时长）
- COUNT DOWN：倒计时，追踪距离目标事件的剩余时间（如预产期、项目截止日）
- COUNT BETWEEN：区间计时，显示在起止时间点之间的进度百分比（如职业生涯跨度）
关键操作流
1. 创建计时器：meter.py create <name> --start <timestamp> [--end <timestamp>] [--mode up|down|between]
2. 锁定密封：meter.py lock <name> 生成带校验和的"纸质验证码"，可手写备份或邮件归档
3. 里程碑设置：支持按小时数或百分比触发通知，可配置邮件自动提醒或代理执行（ACTION:前缀）
4. 验证查验：通过纸质验证码校验数据完整性，检测篡改或输入错误
显著优点
- 防篡改设计：锁定后生成校验和编码，任何数据修改都会导致验证失败
- 多模态备份：纸质记录、照片存档、云同步见证文件、邮件自发送、SendGrid自动化五种保存方式
- 灵活集成：支持Discord webhook、SendGrid事件回调、心跳/cron双模式触发
- 隐私友好：本地优先存储，可选外部邮件服务，无强制云端依赖
潜在局限与风险
- 单点依赖：核心数据存储于本地
~/.openclaw/目录，若未配置云同步则存在设备丢失风险 - 邮件服务门槛：SendGrid功能需API密钥和域名验证，对非技术用户配置复杂
- 时间精度限制：推荐心跳模式30分钟级轮询，高频cron可能产生显著API成本
- 无内置加密：数据文件明文存储，依赖文件系统权限保护
适合人群
- 戒瘾/康复追踪者（ sobriety counters ）
- 设备运维工程师（运行时长记录）
- 自由职业者/项目经理（计费周期、里程碑管理）
- 个人成长记录者（80,000小时职业规划概念实践者）
常规风险提示
- 纸质验证码需妥善保管，遗失后无法恢复原始校验状态
- SendGrid webhook暴露公网时需配置签名验证防止伪造事件
- 里程碑邮件通知依赖外部服务可用性，关键场景建议冗余备份