> ## Documentation Index
> Fetch the complete documentation index at: https://www.worldmonitor.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 矿产生产与加工集中度

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

## 目的

矿藏与生产是两张不同的地图。关键矿产图层显示资源*所在位置*；本数据集显示它实际在何处被开采，以及分别在何处被精炼。精炼通常是两者中更集中的环节，也是在出口管制下最先失效的环节。

由 `GET /api/supply-chain/v1/get-mineral-production` 与 MCP `get_mineral_production` 提供。两者均需 Pro 订阅。

## 数据源

| 来源           | 作用                                        |
| ------------ | ----------------------------------------- |
| 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 情报套件](/docs/zh/pro-intelligence-suite)
* [供应脆弱性](/docs/zh/methodology/supply-vulnerability)——将这些份额作为其集中度输入
* [数据源](/docs/zh/data-sources)