国标现行状态核验(一次付费 7 天不限次)
给一个标准号,答三件事:它现在还有效吗?被谁替代了?什么时候换的?
> 为什么必须走服务端:判断依据是约 7.9 万条国标的完整状态库 + 持续更新,
> 不是本机几条 curl 能凑出来的(官方平台对高频访问做 IP 级限制,自己逐条爬会被拒)。
> 服务端直接返回查询结果本身。
第 0 步 · 前置检查(免费,先判值不值得查)
| 检查项 | 判定 |
|---|---|
| 标准类型 | 收录国家标准(GB 强制 / GB/T 推荐 / GB/Z 指导)。行标 / 团标 / 地标不在收录范围,问到的要如实说「未收录」 |
| 输入格式 | 标准号,如 GB/T 1.1-2009。只给半截号也行(GB/T 1.1 → 返回该标准号的全部历史版本) |
| 要什么 | 现行/废止状态 · 被谁替代 · 替代生效日 · 历史版本序列 · 它又替代了谁 |
第 1 步 · 发起查询(未付费返回 402)
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 步 · 携凭证重试(直接拿到结果)
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 天内可反复查询。
交付给用户的说法(照这个口径,别夸大)
coverage = state_only时不要说「它没有被替代」 —— 那表示我们尚未确认替代关系(不等于没有)。照实说「替代关系待确认,以官方平台为准」。- 带上
data_as_of:状态是采集日的快照,标准状态会变,别当成实时。 - 只覆盖国标(GB/GB-T/GB-Z)。用户问行标、团标、地标 → 明说未收录,不要说「查不到 = 不存在」。
诚实边界(用户问到时照实说)
- 替代关系目前是"部分覆盖 + 越用越全":服务端在查询时按需向官方平台确认并写入共享库,
所以同一个标准第 2 个人来查会更快更全。首次查一个冷门标准可能只有状态、没有替代关系。 - 服务端只读我们的库:官方平台限流或维护时,本服务仍然可用(这正是用服务端库而不用本机现查的理由)。
- 数据来源为官方公开标准信息平台;本服务只做事实聚合,不下「这个标准合不合规」之类的判断。
- ⚠️ 不要把它当作法规/合规意见。它只回答标准的现行有效性。
<!-- skillhub-payblock -->
付费链路自检(与平台五项自查一一对应)
本 Skill 的付费链路由服务端承担验付、资源交付与商家履约确认;Skill 只负责
发起请求、调用官方支付能力并展示结果。逐条对应平台自查项如下:
| 平台自查项 | 本 Skill 的实现 |
|---|---|
| 402 账单 | 未付款时请求 POST https://skills-gate.airpriv.com/api/std-replace-check-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 持久化于服务端订单库,状态可恢复;同一订单重复请求只履约一次、不重复扣费。 |
> 支付能力由支付宝 AI 按量付费官方链路承担,本 Skill 不接触支付密钥、不自行实现付款或签名。
<!-- /skillhub-payblock -->