Skip to main content

​
从这里开始

一种矿产埋在哪里、在哪里被挖出来、在哪里被加工成可用材料，是三张不同的地图——而供应链真正断裂的地方，是最后那一张。 一个国家可以坐拥巨量储量却依然无能为力，因为精炼产能在别人手里。出口管制几乎总是卡在加工环节，而不是矿山，所以本数据集把两者严格分开：
  • mine——矿石从地下开采出来的地方。
  • refinery——它被加工成可用材料的地方。
对多数战略商品而言，精炼的集中度远高于开采。这个落差本身就是结论。

​
读懂集中度数字

每个阶段都带有一个按惯例的 0–10,000 标度的 HHI。数值越高，意味着主导国家越少。作为粗略参照：一种分散在众多生产者手中的商品会落在数百量级；而一种由单一国家掌握全球大部分产能的商品会高达数千。
有三个字段，跳过它们就会读错，三者都在改变解读的三个字段中说明：
  • residual 是”其他国家”这个汇总桶，不是一个生产国。它常常大到足以压过真实国家——在做任何排名之前请先把它过滤掉。
  • withheld 表示来源方隐去了该数字。那份额是未知，不是零；一个隐去行很多的阶段，其 HHI 相应地更不可靠。
  • year 是按”商品-阶段”各自计的。外层信封的 dataYear 只是整个数据集中最新的那个年份，不是你正在读的那一行的年份。
访问方式。 由 GET /api/supply-chain/v1/get-mineral-production 与 MCP get_mineral_production 提供。两者均需 Pro 订阅。

​
数据源

两者均允许衍生合计值。快照存储的是国家份额，而非任一出版物的镜像。

​
词表

商品清单是定义于 scripts/shared/ 的受控集合，初始包含战略组：稀土、锂、钴、铜、镍、石墨、钨、镓、锗、氦、铝和铀。USGS 名称为规范名；BGS 名称通过别名映射解析，因此同一商品绝不会以两种拼写被重复计算。

​
阶段

每种商品最多携带两个独立快照：
  • mine——开采
  • refinery——加工
一种商品可能只有其中一个阶段。缺失的阶段会从 JSON 中省略——不存在 mine 或 refinery 属性，既不是 null，也不是显式的不可用阶段对象。客户端应检查字段是否存在，而不是用 === null 判断。

​
集中度

按阶段，赫芬达尔-赫希曼指数基于国家份额计算：
以常规的 0–10,000 标度报告。数值越高表示主导生产国越少。 分母是该阶段已发布的全部产量，包含残余合计项。将其剔除会抬高每个具名国家的份额。

​
改变解读的三个字段

withheld——来源方压制了该国数据，通常出于商业保密。其份额是未知，而非零。阶段上的 withheldCount 说明受影响的行数；withheld 计数高的阶段，其 HHI 的可信度相应降低。 residual——USGS 的”其他国家”合计项。它是一个集合桶而非生产国，且经常大到足以超过真实国家：在铜的开采产量中它以约 13% 位列第三，将秘鲁挤出前三。排名前请将其滤除，如需展示则单独呈现。 year——每个商品-阶段各自选择自己的年份。由 BGS 补充的商品可能比快照的 dataYear 落后数年。行自身的 year 具有权威性；信封的 dataYear 只是整个集合中最新的年份。

​
更新频率

年度。种子程序在每次 USGS 发布后写入 supply-chain:mineral-production:v1。两次发布之间快照刻意保持静止——年中看到看似陈旧的 dataYear 是预期状态，而非种子程序故障。

​
相关