计时仪表

技能简介

计时仪表（hour-meter）追踪从设定时间点开始的经过时间，支持防篡改锁定。类似数字版模拟霍布斯仪表，用于跟踪正常运行时间、服务小时数、事件发生后的时间、清醒计数器、项目持续时间、设备运行时间。

业务背景

计时仪表为需要可信时间记录的业务场景提供防篡改解决方案。适用于设备维保追踪、项目工时审计、SLA倒计时监控等场景，确保关键时间节点不可抵赖，满足合规审计要求，降低人工记录的时间争议风险。

落地案例：某设备租赁公司使用区间计时模式记录每台机械的累计运行时长，设置500小时保养里程碑。计时器锁定后生成纸质备份代码存档，到期前自动邮件提醒运维团队。验证功能可快速识别数据异常，保障计费依据的可信度。

能做什么

• 正计时：追踪事件发生后的时间
• 倒计时：追踪距离事件还有多久
• 区间计时：从开始到结束的完整旅程
• 设置里程碑通知
• 防篡改锁定和验证
• 纸质代码备份
• 通过邮件自动通知里程碑
• 支持 SendGrid 邮件集成

使用说明

安装 Skill：

通过 ClawHub 安装：

clawhub install hour-meter

创建计时器（正计时）：meter.py create smoke-free --start "2025-06-15T08:00:00Z" -d "Last cigarette"

创建倒计时：meter.py create baby --start "2026-01-15" --end "2026-10-15" --mode down -d "Baby arriving!"

设置里程碑：按小时：meter.py milestone smoke-free -t hours -v 720 -m "30 days smoke-free!"，按百分比：meter.py milestone baby -t percent -v 33 -m "First trimester complete!"

锁定计时器：meter.py lock smoke-free，会生成纸质代码如 318B-3229-C523-2F9C-V，可写在纸上、拍照保存、自动保存到见证文件或邮件发送。

验证计时器：meter.py verify smoke-free "318B-3229-C523-2F9C-V"，可检测打字错误（校验和）或篡改。

邮件通知：设置 SendGrid：export SENDGRID_API_KEY=SG.xxxxx，创建时添加：meter.py create my-meter --notify-email you@example.com。

检查里程碑：meter.py check-milestones可集成到心跳或 cron。

输入与输出

见下方输入与输出表格。

风险提示

• 锁定后需妥善保存纸质代码
• 邮件通知需要 SendGrid 配置
• 见证文件存储在 ~/.openclaw/meter-witness.txt
• 验证失败可能表示数据被篡改
• 建议定期备份见证文件

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rm289/hour-meter/SKILL.md

来源类型：GitHub