zeri-forge-paylisted

# 择日·搬家结婚开业选日子 本 Skill 分两段：**先免费体检**（只读，不写任何文件），**再取授权真写**（在你本机完成，不联网）。 > **为什么需要授权**：批量写出文件需要一份由服务方签发的凭证。 > 授权**在你本机离线校验**，但**没有有效授权就不执行写盘** —— 这是服务的一部分。 --- ## 第 0 步 · 先体检（免费，建议必做） ```bash python scripts/zeri.py --day 2026-10-01 ``` | 用法 | 作用 | 参数 | |---|---|---| | `--matter 搬家` | 要办什么事 | 也认俗称：领证→结婚、乔迁→搬家、开张→开业 | | `--from` / `--to` | 日期范围 | 不给范围默认从今天起 60 天 | | `--days 60` | 从起始日往后看几天 | 上限两年 | | `--top 10` | 列出前几个候选 | 默认 10 | | `--day 2026-10-01` | 只看某一天（免费） | 农历/干支/建除/黄道/宜忌全给 | | `--all-days` | 把范围内每一天的明细都列出 | 默认只给候选 | | `--json` | 额外导出机器可读的结果 | 配合 --out | | `--out 择日.md` | 把结果写到文件 | 付费 | **没给 `--apply` 时，什么都不会被写出** —— 只打印将要发生什么。 ## 第 1 步 · 请求授权（未付费会返回 402） ``` POST https://skills-gate.airpriv.com/api/zeri-forge-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 步 · 完成支付 把 `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` 指纹不匹配 ·