ai-usage-report-paylisted

# 我的 AI 使用报告（一次付费 7 天不限次） 把你在这台机器上的 AI 使用记录，折成一份能看、能截图、能转发的报告。分两段： **先免费体检**（看数据全不全），**再取授权出报告**（按次计费，在你本机完成，数据不出本机）。 > **为什么需要授权**：报告生成动作需要一份由服务方签发的凭证。 > 授权**在你本机离线校验**（不联网即可验证真伪与有效期）， > 但**没有有效授权就不生成报告**——这是服务的一部分，不是限制。 --- ## 第 0 步 · 前置检查（必做，先判值不值得用这个工具） 在调用任何服务之前先确认三件事： | 检查项 | 判定 | |---|---| | 数据在哪 | 默认读 `~/.workbuddy`（Windows: `C:\Users\<你>\.workbuddy`）。装在别处就先找到它，用 `--home <目录>` 指定 | | 数据够不够 | **会话数少于 20、或时间跨度不到两周 → 先别出报告**。样本太薄的报告只会给你一堆"100%"的假精确。先体检看一眼：体检会直接告诉你覆盖范围 | | 期待是否合理 | 报告**不评价你干得好不好**，只报事实：用了什么、什么时候用、消耗多少、哪里报错。它**也不读你的对话内容**——报告里没有你说��任何一句话 | **只有第 0 步谈过，才进入第 1 步。** --- ## 第 1 步 · 免费体检（scan，只读，不收费） ```bash python scripts/aireport.py scan ``` 输出：五个数据源各自的**能不能读到 / 记录数 / 说明**、时间跨度、活跃天数、连续活跃、 近 7 天的逐日柱状图。另外会原样列出采集过程的提示（比如"某段数据不可校验"）——**不隐去**。 **先把体检结果拿给用户看**：如果主数据源（会话与用量库）读不到、或记录数少得可怜， 就停在这里，别去取授权。体检会直接说清楚。 想要机器可读的版本：`scan --json`。 --- ## 第 2 步 · 请求授权（未付费会返回 402） ``` POST https://skills-gate.airpriv.com/api/ai-usage-report-license Content-Type: application/json {"machine_fp":"<本机指纹串，8–128 位字母数字/连字符，可省略>"} ``` **首次调用一定拿到 `402 Payment Required`** —— 这是设计，不是错误。响应里带： - HTTP 头 `Payment-Needed`（base64url 编码的账单） - 响应体 `payment_needed` / `payment_needed_token` / `amount` / `out_trade_no` > `machine_fp` 可选：带上则这份授权**绑定这台机器**，换机器需重新授权。省略则不绑定。 > 本机指纹：`python scripts/license_check.py fingerprint` ## 第 3 步 · 处理 402（完成支付） 把 `payment_needed_token`（或整个 `Payment-Needed`）交给**支付宝 AI 付**完成授权支付。 支付完成后你会拿到一个 **`Payment-Proof`** 凭证。 **不要自己伪造、不要跳过这一步** —— 服务端会拿它去支付