防篡改计时器

技能简介

TARDIS（原hour-meter）是一款数字式防篡改计时器，类似模拟霍布斯表。支持正计时、倒计时和区间计时三种模式，可设置里程碑提醒，并通过纸质验证码实现数据完整性校验。

业务背景

解决关键时间追踪的信任问题。无论是设备维保周期、项目里程碑还是合规审计窗口，传统计时器易被修改引发纠纷。TARDIS通过纸质验证码锁定机制，确保时间数据不可事后抵赖，为合同履约、质保索赔等场景提供可信的时间证据链。

落地案例：某工程租赁公司将TARDIS用于挖掘机工时管理。设备进场时启动正计时模式，设定500小时保养里程碑。系统自动邮件通知项目负责人，并在锁定后生成纸质验证码存档。当客户对计费时长提出异议时，公司出示带校验位的验证码原件，第三方可独立核验数据完整性，避免口头扯皮。

能做什么

• 追踪戒烟天数、设备运行时长、项目周期等时间事件
• 设置基于小时数或百分比的里程碑自动提醒
• 生成防篡改纸质验证码，支持后期核验
• 通过邮件自动发送锁定通知和里程碑提醒
• 导出计时数据用于备份或分析

使用说明

安装指令：

# 从ClawHub安装
claw install tardis

# 或手动克隆
git clone https://github.com/openclaw/skills.git
cd skills/rm289/tardis

基础用法：

# 创建正计时器（如戒烟追踪）
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

# 锁定并获取纸质验证码
meter.py lock smoke-free

# 使用纸质码验证完整性
meter.py verify smoke-free "318B-3229-C523-2F9C-V"

# 设置里程碑提醒
meter.py milestone smoke-free -t hours -v 720 -m "30 days smoke-free!"

# 检查并触发里程碑
meter.py check-milestones

邮件通知配置：

export SENDGRID_API_KEY=SG.xxxxx
export SENDGRID_FROM_EMAIL=verified@yourdomain.com

# 创建时绑定邮箱
meter.py create my-meter --notify-email you@example.com --from-email verified@yourdomain.com

输入与输出

见下方输入与输出表格。

风险提示

• 纸质验证码需妥善保管，丢失后无法恢复原始哈希
• SendGrid邮件功能需配置API密钥和已验证发件域名
• 见证文件默认存储于本地，建议同步至云盘防止单点故障
• 里程碑检查需定期执行（推荐加入HEARTBEAT.md），否则可能错过提醒时机

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rm289/tardis/SKILL.md
来源类型：GitHub仓库