订阅审计器

安装指南

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

什么是

订阅审计器可帮助你维护可靠的周期性订阅手动记录，无需抓取服务提供商数据、查找银行扣款，也不会将数据发送到任何地方。它会在本地 JSON 账本中记录每项订阅的费用、计费周期、续订日期、自动续订设置、货币和备注。
作为 Openclaw Skills 的一部分，它会计算可供比较的月度和年度支出总额，识别可配置时间范围内的续订，并清楚标记逾期续订。明确的计费计算、幂等更新、验证和原子文件写入，使其适用于个人财务管理和自动化。

应用场景

私密地维护软件、流媒体、健身、托管及其他周期性订阅清单。
status
命令查看预估的月度和年度订阅支出。
使用可配置的提醒时间范围，查找即将到期或已经逾期的续订。
当同名订阅应替换现有记录时，安全地添加或更新订阅。
当不希望服务提供商自动发现订阅时，使用受控的手动账本追踪订阅。
将结构化 JSON 输出用于脚本、仪表板或其他 Openclaw Skills 自动化。
使用自定义
SUBSCRIPTION_AUDITOR_STATE_DIR
目录运行隔离测试或并行工作流。

工作原理

技能会从本地账本 ~/.openclaw/subscription-auditor/ledger.json 读取数据，或从 SUBSCRIPTION_AUDITOR_STATE_DIR 指定的目录读取。
你可以添加订阅，并提供名称、非负费用、计费周期、可选续订日期、自动续订标记和备注。
如果未提供续订日期，技能会将其默认设为从今天起 30 天后；它不会抓取或推断服务提供商的计费数据。
每种计费周期都会先换算为年度金额，再换算为月度估算：月费乘以 12，年费除以 12，季度、每周和每日周期则使用经过明确测试的乘数。
list 命令显示账本条目，status 则计算月度和年度总额，并突出显示处于配置提醒时间范围内的续订。
remind 命令会筛选出在请求的天数内到期的续订，并包含逾期条目。
逾期日期会通过负数 days_left 值继续显示，并标记为 PAST-DUE，而不是将其限制为零。
账本和配置变更会通过临时文件和重命名操作原子写入，以防止部分写入。

配置指南

确认已安装 Python 3，且技能文件已安装在 OpenClaw 技能目录下。
python3 --version
设置技能使用的可执行文件路径。
A=~/.openclaw/plugin-skills/subscription-auditor/subscription_auditor.py
添加初始订阅。同名记录会替换之前的记录，因此此操作具有幂等性。
python3 "$A" add "IDE Rider" --cost 299 --cycle yearly --next-renewal 2026-12-01
python3 "$A" add Gym --cost 10 --cycle weekly
查看总额和即将到来的续订。
python3 "$A" status
python3 "$A" remind
根据需要配置提醒时间范围和显示货币。
python3 "$A" config --remind-ahead-days 14
python3 "$A" config --currency EUR
在程序名称后立即添加 --json，即可获得机器可读的输出。
python3 "$A" --json status
默认提醒时间范围为未来 7 天。请将账本中的货币保持一致，因为总额计算不会进行外汇换算。

数据架构

存储位置
数据 默认位置 用途
订阅账本 ~/.openclaw/subscription-auditor/ledger.json 存储本地订阅记录
配置 技能的本地状态目录 存储提醒提前天数和配置的货币
替代状态目录 SUBSCRIPTION_AUDITOR_STATE_DIR 支持测试和并行隔离运行
订阅记录分类
每条账本记录由以下字段组成：
id：转为小写并以下划线连接的订阅名称，供 rm 使用。
name：便于阅读的订阅名称，也是替换键。
cost：所选计费周期对应的非负数费用。
cycle：计费间隔，例如 monthly、yearly、quarterly、weekly 或 daily。
next_renewal：采用 YYYY-MM-DD 格式的续订日期。
auto_renew：该订阅是否设置为自动续订。
notes：用户可选填写的背景信息。
currency：添加时记录的货币，因此之后更改配置不会改写历史条目。
派生数据和配置数据
年度和月度总额根据 cost 和 cycle 派生，不会作为权威值存储。
提醒结果根据 next_renewal、当前日期以及已配置或命令指定的天数范围派生。
逾期续订的 days_left 可能为负数。
配置包含 remind-ahead-days 和 currency。
零字节账本文件会被视为空文件，而不是致命错误；写入时会先写入临时文件，再进行重命名。

高级特性

幂等的订阅更新：添加已有名称时会替换其记录，而不是创建重复项。 --json 标记提供结构化输出，适用于 shell 管道和自动化。
针对月度、年度、季度、每周和每日方案，提供明确且经过测试的计费周期换算。
准确处理逾期情况，保留负数天数，并清楚标记已逾期续订。
config --remind-ahead-days N
remind --days N
配置提醒时限。
为每条记录保留其货币，防止之后更改配置时改写已存储的历史记录。
使用临时文件和重命名操作原子写入账本和配置。
SUBSCRIPTION_AUDITOR_STATE_DIR
使用隔离状态目录，以便测试和并行使用。
仅在本地运行，不追踪支付方式、不抓取服务提供商数据、不自动发现订阅，也不向外部传输数据。
兼容 Openclaw Skills 工作流，可在不接入外部服务的情况下提供可靠的个人财务数据。

name: subscription-auditor description: > Personal admin: track subscriptions (cost, cycle, renewal date,
auto-renew), see monthly/yearly totals, and get renewal reminders
within a configurable window. Cycle math is explicit and tested;
past-due renewals are flagged, never clamped away. All data stays
local — nothing is sent anywhere and nothing is auto-discovered.
user-invocable: true