file-watchdog-paylisted

# 改坏的文件还原回去（一次付费 7 天不限次） 改文件之前先留底，改完之后看得见改了什么，改坏了一个文件就能单独还原回来。 本 Skill 分两段：**拍快照与对账免费**（不写回任何文件），**再取授权还原**（在你本机完成，文件不出本机）。 > **为什么需要授权**：还原是**真写回文件的动作**，需要一份由服务方签发的凭证。 > 授权**在你本机离线校验**，但**没有有效授权就不写回任何文件**——这是服务的一部分，不是限制。 --- ## 第 0 步 · 前置检查（必做，先判值不值得用） | 检查项 | 判定 | |---|---| | 时机 | **快照必须在动手之前拍**。已经改坏了才想起要快照 → 只能靠文件系统/编辑器自己的历史，先说明这一点 | | 范围 | 只操作你指定的那个目录。**内容副本放在该目录下的 `.watchdog/`**，不会写到别处 | | 期望 | 它**不做整目录回滚**——默认一次只还原你点名的那一个文件，避免把这段时间的正常改动一起抹掉 | | 大文件 | 超过阈值的文件**只记哈希不存内容**，报告里会如实标注「还原不了」。想要完整留底请自己另存 | ## 第 1 步 · 免费：拍快照 / 看改动 / 列快照（不收费） ```bash python scripts/run_paid.py snap <目录> [--name 标记] # 动手前拍快照 python scripts/run_paid.py diff <目录> [--name 标记] # 动手后出改动清单 python scripts/run_paid.py list <目录> # 看有哪些快照 ``` `diff` 会把删除、疑似截断、大幅改写标出来，并给出**风险判定**（有风险改动时退出码为 1）。 这三个命令**都不写回任何文件**。 ## 第 2 步 · 请求授权（未付费会返回 402） ``` POST https://skills-gate.airpriv.com/api/file-watchdog-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` ## 第 3 步 · 处理 402（完成支付） 把 `payment_needed` 对象（**不是整个响应信封**）交给**支付宝 AI 付**完成支付，拿回 **`Payment-Proof`**。 **不要自己伪造** —— 服务端会拿它去支付宝网关做真实校验。 ## 第 4 步 · 携凭证重试（拿到授权凭证） 同一请求加上头 `Payment-Proof: <凭证>` 重发，成功返回 `200`， `content.data.license` = 授权凭证（存成 `license.json`）。 **一次付费 = 一份授权 = 7 天有效**，期间反复还原**不需要再付费**。 ## 第 5