> ## Documentation Index
> Fetch the complete documentation index at: https://worldmonitor-spike-bun-package-manager.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 矿产生产与加工集中度

> WorldMonitor 如何基于 USGS 矿产商品摘要并以 BGS 补充，推导各商品的开采与精炼国家份额及 HHI 集中度。

## 从这里开始

**一种矿产埋在哪里、在哪里被挖出来、在哪里被加工成可用材料，是三张不同的地图**——而供应链真正断裂的地方，是最后那一张。

一个国家可以坐拥巨量储量却依然无能为力，因为精炼产能在别人手里。出口管制几乎总是卡在加工环节，而不是矿山，所以本数据集把两者严格分开：

* **`mine`**——矿石从地下开采出来的地方。
* **`refinery`**——它被加工成可用材料的地方。

对多数战略商品而言，精炼的集中度远高于开采。**这个落差本身就是结论。**

### 读懂集中度数字

每个阶段都带有一个按惯例的 0–10,000 标度的 **HHI**。数值越高，意味着主导国家越少。作为粗略参照：一种分散在众多生产者手中的商品会落在数百量级；而一种由单一国家掌握全球大部分产能的商品会高达数千。

<Warning>
  有三个字段，跳过它们就会读错，三者都在[改变解读的三个字段](#改变解读的三个字段)中说明：

  * **`residual`** 是"其他国家"这个汇总桶，不是一个生产国。它常常大到足以压过真实国家——在做任何排名之前请先把它过滤掉。
  * **`withheld`** 表示来源方隐去了该数字。那份额是*未知*，不是零；一个隐去行很多的阶段，其 HHI 相应地更不可靠。
  * **`year`** 是按"商品-阶段"各自计的。外层信封的 `dataYear` 只是整个数据集中最新的那个年份，不是你正在读的那一行的年份。
</Warning>

<Info>
  **访问方式。** 由 `GET /api/supply-chain/v1/get-mineral-production` 与 MCP `get_mineral_production` 提供。两者均需 Pro 订阅。
</Info>

## 数据源

| 来源           | 作用                                        |
| ------------ | ----------------------------------------- |
| USGS 矿产商品摘要  | 主要来源。年度发布，每年一月出版，涵盖开采与精炼产量。USGS 商品名称为规范键。 |
| 英国地质调查局（BGS） | 对 USGS 未细分的商品-阶段进行补充，通过别名映射对应到 USGS 名称。   |

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

## 词表

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

## 阶段

每种商品最多携带两个独立快照：

* `mine`——开采
* `refinery`——加工

一种商品可能只有其中一个阶段。缺失的阶段会从 JSON 中省略——不存在 `mine` 或 `refinery` 属性，既不是 `null`，也不是显式的不可用阶段对象。客户端应检查字段是否存在，而不是用 `=== null` 判断。

## 集中度

按阶段，赫芬达尔-赫希曼指数基于国家份额计算：

```text theme={null}
HHI = sum(share_i^2)   对每个生产国 i
```

以常规的 0–10,000 标度报告。数值越高表示主导生产国越少。

分母是该阶段已发布的全部产量，包含残余合计项。将其剔除会抬高每个具名国家的份额。

## 改变解读的三个字段

**`withheld`**——来源方压制了该国数据，通常出于商业保密。其份额是*未知*，而非零。阶段上的 `withheldCount` 说明受影响的行数；withheld 计数高的阶段，其 HHI 的可信度相应降低。

**`residual`**——USGS 的"其他国家"合计项。它是一个集合桶而非生产国，且经常大到足以超过真实国家：在铜的开采产量中它以约 13% 位列第三，将秘鲁挤出前三。排名前请将其滤除，如需展示则单独呈现。

**`year`**——每个商品-阶段各自选择自己的年份。由 BGS 补充的商品可能比快照的 `dataYear` 落后数年。行自身的 `year` 具有权威性；信封的 `dataYear` 只是整个集合中最新的年份。

## 更新频率

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

## 相关

* [Pro 情报套件](/zh/pro-intelligence-suite)
* [供应脆弱性](/zh/methodology/supply-vulnerability)——将这些份额作为其集中度输入
* [数据源](/zh/data-sources)