std-replace-check-paylisted

# 国标现行状态核验（一次付费 7 天不限次） 给一个标准号，答三件事：**它现在还有效吗？被谁替代了？什么时候换的？** > **为什么必须走服务端**：判断依据是**约 7.9 万条国标的完整状态库 + 持续更新**， > 不是本机几条 curl 能凑出来的（官方平台对高频访问做 IP 级限制，自己逐条爬会被拒）。 > 服务端直接返回查询结果本身。 --- ## 第 0 步 · 前置检查（免费，先判值不值得查） | 检查项 | 判定 | |---|---| | 标准类型 | 收录**国家标准**（`GB` 强制 / `GB/T` 推荐 / `GB/Z` 指导）。**行标 / 团标 / 地标不在收录范围**，问到的要如实说「未收录」 | | 输入格式 | 标准号，如 `GB/T 1.1-2009`。**只给半截号也行**（`GB/T 1.1` → 返回该标准号的全部历史版本） | | 要什么 | 现行/废止状态 · 被谁替代 · 替代生效日 · 历史版本序列 · 它又替代了谁 | ## 第 1 步 · 发起查询（未付费返回 402） ```bash python scripts/std_query.py "GB/T 1.1-2009" ``` 脚本会把标准号 POST 到 `https://skills-gate.airpriv.com/api/std-replace-check-license`。 首次调用一定拿到 **`402 Payment Required`**（设计如此），响应里带 `payment_needed`、`amount`、`out_trade_no`。 ## 第 2 步 · 完成支付 把响应里的 `payment_needed` 对象交给**支付宝 AI 付**（或按 `references/402-payment.md` 用 CLI）， 拿回 **`Payment-Proof`**。**不要自己伪造** —— 服务端会拿它去支付宝网关做真实校验。 ## 第 3 步 · 携凭证重试（直接拿到结果） ```bash python scripts/std_query.py "GB/T 1.1-2009" --proof "<Payment-Proof>" ``` 成功返回 `200`，`content` 就是查询结果： | 字段 | 含义 | |---|---| | `verdict` | 一句话结论，可直接转述给用户 | | `target` | 该标准的状态 / 发布日 / 实施日 / 废止日 / 归口单位 | | `replaced_by[]` | **被哪些标准替代 + 替代生效日**（`effective_from`） | | `family[]` | 同一标准号的**全部历史版本**及各自状态 | | `current_in_family` | 这一族当前现行的是哪一版 | | `replaces[]` | 它自己又替代了哪些旧标准 | | `changes[]` | 该标准被观测到的状态变更记录 | | `data_as_of` | **数据采集日**（口头结论必须带上它） | | `coverage` | `with_replacement` = 含替代关系；`state_only` = 本次只含状态与版本沿革 | **一次付费 = 7 天内可反复查询**。 ## 交付给用户的说法（照这个口径，别夸大） 1. **`coverage = state_only` 时不要说「它没有