收据与保修追踪器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install receipt-warranty-tracker
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 receipt-warranty-tracker。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Receipt & Warranty Tracker 是一款 Openclaw Skills 实用工具，可用于记录购买物品、收据备注、价格和保修保障日期。通过其命令行界面查看每件物品的状态、估算保障结束日期，并设置提醒，无需依赖远程服务。
记录保存在磁盘上的 ~/.openclaw/receipt-warranty-tracker/ledger.json。此技能不会向任何地方发送数据；如果缺少日期，也不会猜测保修范围；并且允许你调整提醒提前触发的时间。

应用场景

购买后记录物品和收据详情，包括照片说明或其他收据备注。
使用天数时长或已知结束日期追踪保修保障。
查看哪些物品仍在保障期内、即将到期、已过期或未记录保修。
在保修保障到期前运行提醒，并避免重复通知。
为尚未录入的较早购买物品估算保修结束日期。
在本地维护私密的购买记录，不向外部服务发送数据。

工作原理

运行此技能的 Python CLI，并添加包含收据详情和价格的物品。
如果已知保障信息，请提供 --warranty-days 或 --warranty-until；否则，该条目会明确标记为没有保修期限。
此技能会将条目保存到其 JSON 记录文件中。添加同名物品会替换其先前记录。
使用 status 查看每个条目的状态和剩余天数，或使用 list 查看登记清单。
运行 remind 查找处于配置提醒窗口内的条目，并保存今天的提醒标记。条目在编辑或删除前不会再次提醒。
使用 config 更新提醒时间，使用 estimate 估算日期，或使用 rm 删除条目。

配置指南

此技能需要 python3；其元数据未列出其他二进制文件、文件或配置前提条件。请从 OpenClaw plugin-skills 目录运行脚本：
R=~/.openclaw/plugin-skills/receipt-warranty-tracker/receipt_warranty.py
python3 "$R" add --item "MacBook Pro 14" --receipt "photo: 4 lines, $2499" --price 2499 --warranty-days 365
python3 "$R" status
python3 "$R" remind
如果知道保障结束日期而不是保障时长，请使用 --warranty-until YYYY-MM-DD。无效日期会被拒绝。将 --json 紧跟在程序名称后，可生成结构化输出。默认记录文件为 ~/.openclaw/receipt-warranty-tracker/ledger.json；设置 RECEIPT_WARRANTY_STATE_DIR 可覆盖整个状态目录。使用以下命令设置提醒提前时间：
python3 "$R" config --remind-ahead-days 7

数据架构

此技能将状态保存在本地 JSON 记录文件中：
数据 描述
记录文件路径 默认是 ~/.openclaw/receipt-warranty-tracker/ledger.json；可使用 RECEIPT_WARRANTY_STATE_DIR 覆盖状态目录。
物品 用于识别记录的物品名称；添加同名物品会替换现有记录。
收据 用户提供的收据备注或说明。
价格 用户提供的金额；此技能不会解读或格式化金额。使用 --currency 标记币种。
保修 可选的保障时长（--warranty-days）或结束日期（--warranty-until）。如果两者都未提供，则不会臆造保障信息。
状态 ok、REMIND、EXPIRED 或 no-warranty；适用时会显示剩余天数。
提醒状态 记录提醒是否已触发，因此在条目被编辑或删除前不会重复提醒。
配置 remind_ahead_days，默认值为 3 天。
CLI 还支持 list、estimate 和 rm 操作。更新记录文件时会使用临时文件并进行原子重命名；文档中提到的 fcntl 锁文件已不再使用。

高级特性

结构化输出： --json 紧跟在脚本名称后，可生成机器可读的命令输出。
可配置的提醒窗口：
设置保修结束日期前多少天触发提醒；默认提前 3 天。
防重复提醒：
条目触发提醒后，在该条目被编辑或删除前不会再次提醒。
幂等的物品更新：
添加已存在的物品名称会替换先前记录，而不是创建重复项。
灵活的保修输入：
提供保修时长或经过验证的结束日期；此技能绝不会推断缺失的保障信息。
币种标记： --currency 标记价格，无需此技能解读或格式化金额。
隔离的状态目录：
为测试或并行实例设置
RECEIPT_WARRANTY_STATE_DIR
。
原子保存记录：
先写入临时文件再重命名，有助于串行处理并发 CLI 更新。

name: receipt-warranty-tracker description: > Personal admin: photograph a receipt, it stores the item, price, and
warranty end date, then reminds you before coverage lapses.
user-invocable: true