用途：以全球镍供给结构为核心，量化各国主导程度（如印尼）、主要矿区供给量，以及政策配额/减产情境对全球供需平衡与价格的非对称影响。
主要能力：提供 Analyze、Scenario、Validate、Ingest 四类流程，计算 Country Share、CR_n、HHI、Policy Leverage；支持三层情境输出（Hard cut、Half success、Soft landing），默认 execution_prob=0.5；强调口径一致，区分 t_Ni_content（默认基准）、t_ore_wet、t_NPI_product、t_matte，口径不明须标为 model_estimate，输出含 unit 字段。数据源分 Tier 0（USGS MCS、INSG）、Tier 1（公司年报）、Tier 2（S&P Global MI）、Tier 3（政策/新闻）。
使用方式：CLI 例如 python scripts/nickel_pipeline.py analyze --asof=2026-01-16 --scope=mined；scenario 用 --cut=20 --target=Indonesia --exec-prob=0.5；validate 用 --claim="Indonesia 60% share"。也可用库接口 NickelConcentrationAnalyzer(asof_date, scope, data_level) 并调用 compute_concentration()。
适用场景：镍供给集中度评估、政策减产的供需冲击测算、市场说法口径验证、数据标准化与可视化。
限制：付费数据源精度验证为可选；具体价格预测、收费与平台信息暂未提供；须避免混用不同口径数据。