目的
矿藏与生产是两张不同的地图。关键矿产图层显示资源所在位置；本数据集显示它实际在何处被开采，以及分别在何处被精炼。精炼通常是两者中更集中的环节，也是在出口管制下最先失效的环节。 由GET /api/supply-chain/v1/get-mineral-production 与 MCP get_mineral_production 提供。两者均需 Pro 订阅。
数据源
两者均允许衍生合计值。快照存储的是国家份额，而非任一出版物的镜像。
词表
商品清单是定义于scripts/shared/ 的受控集合，初始包含战略组：稀土、锂、钴、铜、镍、石墨、钨、镓、锗、氦、铝和铀。USGS 名称为规范名；BGS 名称通过别名映射解析，因此同一商品绝不会以两种拼写被重复计算。
阶段
每种商品最多携带两个独立快照：mine——开采refinery——加工
mine 或 refinery 属性，既不是 null，也不是显式的不可用阶段对象。客户端应检查字段是否存在，而不是用 === null 判断。
集中度
按阶段，赫芬达尔-赫希曼指数基于国家份额计算：改变解读的三个字段
withheld——来源方压制了该国数据，通常出于商业保密。其份额是未知，而非零。阶段上的 withheldCount 说明受影响的行数；withheld 计数高的阶段，其 HHI 的可信度相应降低。
residual——USGS 的”其他国家”合计项。它是一个集合桶而非生产国，且经常大到足以超过真实国家：在铜的开采产量中它以约 13% 位列第三，将秘鲁挤出前三。排名前请将其滤除，如需展示则单独呈现。
year——每个商品-阶段各自选择自己的年份。由 BGS 补充的商品可能比快照的 dataYear 落后数年。行自身的 year 具有权威性；信封的 dataYear 只是整个集合中最新的年份。
更新频率
年度。种子程序在每次 USGS 发布后写入supply-chain:mineral-production:v1。两次发布之间快照刻意保持静止——年中看到看似陈旧的 dataYear 是预期状态，而非种子程序故障。