deliverable-sweep-paylisted
Install: claude install-skill Mao-jh/deliverable-sweep
# 一批文件交付前全查（一次付费 7 天不限次）
几十份文件要一起交出去，你不可能一份份点开看。
本 Skill 分两段：**先用第 0 步定位这批文件的风险面**，**再取授权出完整巡检报告**（在你本机完成，文件不出本机）。
> **为什么需要授权**：出完整巡检报告需要一份由服务方签发的凭证。
> 授权**在你本机离线校验**，但**没有有效授权就不出完整报告**——这是服务的一部分，不是限制。
---
## 第 0 步 · 前置检查（必做，先判值不值得用）
| 检查项 | 判定 |
|---|---|
| 文件种类 | 支持 `.docx` / `.xlsx` / `.xlsm` / `.pptx`。**老版 `.doc` / `.xls` / `.ppt` → 让用户先另存为新格式**，旧的二进制格式读不了 |
| 这批最可能出什么事 | **别人改过的 Word** → 查未接受的修订与残留批注；**多人填的 Excel** → 查公式异常与隐藏行列；**要对外演示的 PPT** → 查隐藏幻灯片与备注里的内部话 |
| 期望 | 它**只读**，绝不修改文件；**不评判内容写得好不好**，只报「发出去会尴尬」的事故点 |
| 数量 | 一整个目录都能扫（自动跳过临时文件与 `~$` 开头的 Office 锁文件） |
## 第 1 步 · 请求授权（未付费会返回 402）
```
POST https://skills-gate.airpriv.com/api/deliverable-sweep-license
Content-Type: application/json
{"machine_fp":"<本机指纹串，8–128 位，可省略>"}
```
首次调用一定拿到 `402 Payment Required`（设计如此）。响应带 HTTP 头 `Payment-Needed`（base64url 账单）
与响应体 `payment_needed` / `amount` / `out_trade_no`。
本机指纹：`python scripts/license_check.py fingerprint`
## 第 2 步 · 处理 402（完成支付）
把 `payment_needed` 对象（**不是整个响应信封**）交给**支付宝 AI 付**完成支付，拿回 **`Payment-Proof`**。
**不要自己伪造** —— 服务端会拿它去支付宝网关做真实校验。
## 第 3 步 · 携凭证重试（拿到授权凭证）
同一请求加上头 `Payment-Proof: <凭证>` 重发，成功返回 `200`，
`content.data.license` = 授权凭证（存成 `license.json`）。
**一次付费 = 一份授权 = 7 天有效**，期间反复巡检**不需要再付费**。
## 第 4 步 · 校验授权并执行巡检（离线）
```bash
python scripts/license_check.py check license.json --fingerprint "<与第 2 步相同的值>"
echo $? # 0 = 放行；非 0 = 拒绝，不要执行
```
退出码：`0` 通过 · `4` 签名不通过 · `5` 已过期 · `6` 产品不匹配 · `7` 指纹不匹配 · `2` 路径问题。
**退出码 `0` 才允许执行**：
```bash
python scri