我的 AI 使用报告（一次付费 7 天不限次）

把你在这台机器上的 AI 使用记录，折成一份能看、能截图、能转发的报告。分两段： 先免费体检（看数据全不全），再取授权出报告（按次计费，在你本机完成，数据不出本机）。

为什么需要授权：报告生成动作需要一份由服务方签发的凭证。授权在你本机离线校验（不联网即可验证真伪与有效期），但没有有效授权就不生成报告——这是服务的一部分，不是限制。

第 0 步 · 前置检查（必做，先判值不值得用这个工具）

在调用任何服务之前先确认三件事：

| 检查项 | 判定 | |---|---| | 数据在哪 | 默认读 ~/.workbuddy（Windows: C:\Users\<你>\.workbuddy）。装在别处就先找到它，用 --home <目录> 指定 | | 数据够不够 | 会话数少于 20、或时间跨度不到两周 → 先别出报告。样本太薄的报告只会给你一堆"100%"的假精确。先体检看一眼：体检会直接告诉你覆盖范围 | | 期待是否合理 | 报告不评价你干得好不好，只报事实：用了什么、什么时候用、消耗多少、哪里报错。它也不读你的对话内容——报告里没有你说的任何一句话 |

只有第 0 步谈过，才进入第 1 步。

第 1 步 · 免费体检（scan，只读，不收费）

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 凭证。

不要自己伪造、不要跳过这一步 —— 服务端会拿它去支付宝网关做真实校验。

第 4 步 · 携凭证重试（拿到授权凭证）

同一个请求，加上支付凭证头重发：

POST https://skills-gate.airpriv.com/api/ai-usage-report-license
Content-Type: application/json
Payment-Proof: <第 3 步拿到的凭证>

{"machine_fp":"<与第 2 步相同的值>"}

成功时返回 200，content.data.license 就是授权凭证。把它存成 license.json。 一次付费 = 一份授权，有效期 7 天（grant_mode=per_build）。期间反复出报告不需要再付费。

第 5 步 · 校验授权并生成报告（离线，不联网）

python scripts/license_check.py check license.json --fingerprint "<与第 2 步相同的 machine_fp>"
echo $?    # 0 = 放行；非 0 = 拒绝，不要生成报告

| 退出码 | 含义 | 你要做的 | |---|---|---| | 0 | 授权有效 | 继续出报告 | | 4 | 签名不通过（被篡改 / 不是本服务签发） | 停，回报用户并重走第 2 步 | | 5 | 授权已过期 | 停，回报用户并重走第 2 步 | | 6 | 产品不匹配 | 停 | | 7 | 机器指纹不匹配 | 停（这份授权是给另一台机器的） | | 2 | 读不到文件 / 公钥缺失 | 检查路径 |

退出码 0 才允许生成报告：

python scripts/aireport.py report -o 我的AI使用报告.md
# 可选：--no-titles（隐藏会话标题，适合截图/转发）
# 可选：--home <目录>（数据目录不在默认位置时）

工具自带回读校验（写完自己读一遍，报告不完整会删除产物并报错，不会交一份残缺报告）。

报告里有什么

| 段 | 内容 | |---|---| | 0 · 关键数字 | 会话次数 / 活跃天数 / 工作区数 / 模型数 / token / 额度，全部一行三列（全部 · 近30天 · 近7天） | | 1 · 数据源台账 | 每个源的记录数 + 覆盖面 + 读数口径 | | 2 · 你在用什么 | 模型分布、工作区 Top 10、模式、权限模式、后台自动化次数 | | 3 · 你什么时候用 | 连续活跃、会话跨度中位数、24 小时与一周分布、最长的几次会话 | | 4 · 你干了多少 | token 累计与占满率、额度消耗（含覆盖率说明） | | 5 · AI 在哪翻车 | span 状态分布、出过错的工具 + 出错率、最慢的工具、被平台拦下的命令数、审计链校验结果 | | 6 · 交叉校验 | 会话流水数 vs 会话数、轨迹与会话的时间对齐 | | 7 · 口径与边界 | 抽样率、缺失项、单位口径、哪些数字是下界 |

第 0 段是给截图用的（纯数字、无标题）；第 5 段是这产品真正的价值。

交付给用户的说法（照这个口径，别夸大）

只报事实，不评价。报告不会说"你的用法有问题"，只给数字和分布。
轨迹与审计是抽样的。覆盖面写在第 1 段和每个数字旁边——别当成全量念给用户听。
额度消耗是下界。只对有记录的会话求和；没有记录的会话没算进去，报告里标了。
playground 标记的会话不计入统计口径（报告里写明个数）。
会话跨度不是工时。「创建到最后一次活动」跨十几小时的，多半是挂着没关，报告里也这么写。

诚实边界（用户问到时照实说）

授权是「付费门」，不是版权保护。授权离线可验，防的是「没付钱就用」；不防「付一次之后在本地自行延长使用」。更强保护只能把报告生成放到服务端执行，而报告必须在用户自己的机器上跑（要读用户本机数据）——架构上不可兼得。
只读元数据，不读对话正文。读的是会话清单（时间/模型/工作区/状态）、用量数字、轨迹里每个工具调用的名称与耗时、审计条目的事件类型与判定结果。报告全文不含用户说过的任何一句话、不含命令原文。
数据不出本机：不联网、不上传。授权服务只收一个可选的机器指纹，不接收也不留存用户的任何数据内容。
结构变了会拒绝，不会瞎猜。如果应用升级改了内部数据结构（缺列、时间戳格式变化），工具会拒绝出报告并说明原因，而不是按猜测给你一份数字看着对、其实全错的报告。
未识别项照实登记：额度消耗的单位口径未识别（不写成"元"）；轨迹为抽样，不是全量。

付费链路自检（与平台五项自查一一对应）

本 Skill 的付费链路由服务端承担验付、资源交付与商家履约确认；Skill 只负责发起请求、调用官方支付能力并展示结果。逐条对应平台自查项如下：

| 平台自查项 | 本 Skill 的实现 | |---|---| | 402 账单 | 未付款时请求 POST https://skills-gate.airpriv.com/api/ai-usage-report-license 返回 HTTP 402 Payment Required；响应头 Payment-Needed 携带账单，响应体含 payment_needed / amount / out_trade_no。 | | 凭证重试 | 支付后携带请求头 Payment-Proof: <凭证> 重发同一个请求（URL、请求方法、请求体与原请求保持一致），服务端校验通过后返回 200，结果在 content.data 内。 | | 服务端验付 | 服务端调用支付宝 AI 按量付费凭证校验接口 alipay.aipay.agent.payment.verify 验签并核对订单、金额与服务标识；凭证无效或已过期时不交付任何资源，只回 402 账单让用户重新支付。 | | 商家履约 | 资源交付后由服务端调用 alipay.aipay.agent.fulfillment.confirm 上报履约确认；上报失败可对同一订单重试，重试幂等，不会产生第二次扣费。 | | 订单与幂等 | 每笔订单以唯一 out_trade_no 持久化于服务端订单库，状态可恢复；同一订单重复请求只履约一次、不重复扣费；本机授权凭证可离线校验（python scripts/license_check.py check license.json），有效期内重复使用不再计费。 |

支付能力由支付宝 AI 按量付费官方链路承担，本 Skill 不接触支付密钥、不自行实现付款或签名。