Skip to main content

​
范围

国家大宗商品脆弱性评分回答一个有限问题：一个国家对某种已审核商品的供应中断有多大暴露。它不是价格预测、短缺预测或国内需求指标。 方法版本为 supply-vulnerability-v2.0.0。每条记录都包含评分组成、来源证据、覆盖状态、新鲜度状态、原因和方法版本。缺失值保持缺失，绝不转为零。

​
评分

C 是来源集中度，T 是海运咽喉要道暴露，B 是缓冲脆弱性。三个分量都在 0–1 范围内。
C × T 使集中度和运输暴露产生复合效应。缓冲未知时，模型删除缓冲权重并重新归一化，因此未知是中性的，不是零。 进口 HHI 是供应伙伴份额平方和，并包含未列出伙伴的剩余份额。矿山和精炼 HHI 都可用时：
精炼权重较高，因为即使矿源多样，处理环节仍可高度集中。咽喉要道暴露采用 T = 1 - product(1 - ti)。活动中断把对应份额乘以 1.35，上限为 1.0。中断解除后恢复基线。缺失的流量状态分两种情况处理。若该路线有状态数据源但当前缺行，状态为 unknown：评分为 null，状态为 insufficient_data，并给出 missing_transit_status，直到状态证据恢复。若该路线根本没有流量状态数据源（暴露索引覆盖的咽喉要道多于 PortWatch/EIA 流量记录），状态为 uncovered：其过境份额按基线倍数计入评分，并在覆盖标签中给出 transit_status_uncovered，而不是让永远不会发布的证据把评分全部置空。uncovered 路线永远不会显示为 disrupted。 已知缓冲转换规则：食品使用 USDA PSD 库存使用比；LNG 代理使用 GIE AGSI+ 储气填充率；油品使用 IEA 覆盖天数。只有储备容量但没有消费分母时，缓冲保持未知。

​
分级和数据状态

ok 表示最低证据存在且输入未过期。stale_input 保留最后可用评分并明确标记过期输入。insufficient_data 表示来源集中度或运输暴露缺失，此时 score 和 band 为 null。

​
映射和来源

版本化注册表使用 UN Comtrade HS 2022 (H6)。它覆盖稀土、锂、钴、铜、镍、石墨、钨、镓、锗、氦、铝、铝土矿、氧化铝、铀、原油、LNG、成品油、小麦、大豆、玉米、大米、大麦和棕榈油。每行都包含 HS4、运输 HS2、映射理由、限制和来源 URL。可执行 JSON 注册表是映射事实的权威来源。 证据来自 UN Comtrade、USGS Mineral Commodity Summaries、World Bank PortWatch、USDA FAS PSD、GIE AGSI+ 和 IEA。许可和署名要求见来源署名。

​
发布与新鲜度

Railway 的 seed-bundle-static-ref-heavy 服务每日 04:00 UTC 启动，并在镜像输入完成后运行 Supply-Vulnerability 区段。该区段在一次内存计算中生成两个紧凑 Redis 清单：
  • supply-chain:vulnerability:v1
  • supply-chain:chokepoint-dependencies:v1
完整国家和咽喉要道记录存放在确定性的实体分片中。发布在两个槽位之间轮换：先写入非活动槽位的全部分片和两个公开清单，然后以原子方式切换唯一的权威批次描述符和永久激活标记。所有读取方使用该共享描述符。因此，任一清单写入失败都会继续提供上一个完整批次，下一次运行也不会覆盖仍被引用的槽位。清单和批次描述符 TTL 为 72 小时；分片 TTL 为 6 天。发布必须达到配置的国家和咽喉要道下限。系统会实测具有来源证据的商品 ID、双边输入中实际出现的 HS4、运输输入中实际出现的 HS2，以及包含全部已审核映射行的国家数量；注册表常量本身不算实际覆盖。覆盖测量写入 seed metadata 并由健康检查强制执行。健康检查会探测所有 RPC 实际读取的权威批次描述符。首个完整批次发布前，探针保持待定；原子激活后，缺失、过期或部分输出都会严格告警。国家记录和反向咽喉要道依赖来自同一快照，因此评分、状态、运输份额和方法版本可对账。 公开 RPC 是 GetCountryVulnerabilities、GetChokepointDependencies 和 ListVulnerabilityRankings。MCP 工具是 get_supply_vulnerabilities 和 get_chokepoint_dependencies。

​
手工校验

自动化测试包含 10 个固定合成案例：稀土/中国式集中度、氦/卡塔尔式集中度、镓、锗、海湾小麦进口方，以及德国 LNG 储气填充前后。它们验证单调性、集中度与运输复合、未知缓冲中性、中断敏感性和反向索引对账。这些输入只用于验证算术和方向，不代表当前实时国家状况。完整输入和预期值见英文方法页。

​
变更记录

  • supply-vulnerability-v2.0.0 — 首个公开版本。加入精炼主导的生产 HHI、集中度与运输复合、中性未知缓冲、中断敏感性、明确覆盖/新鲜度状态，以及单次生成的咽喉要道反向索引。