# MetalsGoWhere 标准数据包 · 免费样例

MetalsGoWhere 标准数据包 · 免费样例 2026-10-10.standard-pack-v1。四个铅／锌条目，文件格式与每个付费数据包完全一致。可署名 MetalsGoWhere 自由下载与再分发；本样例不是付费数据包的授权副本。

先打开 projects.csv：每行一个项目—金属登记项。通过 production_observation_id 或 capacity_observation_id 查 observations.csv，再按 source_keys 查 sources.csv。跨金属相同编号不代表独立厂址。指标、单位、产品口径、权益及实体范围应一起使用；示例不生成全国排名或混合总量。

摘要规则：某指标只有一条当前输入观察且全部声明数字出处均可解析为允许的一手／官方URL时才选入。即使同时存在有效出处，缺失、未知或受限血缘仍使数量留空；声明／未解决的来源编号保留在标量JSON文本血缘字段。不得推断最新期间、实体关联、含水率、换算或日期。明确观察保留各自日期；旧 production_t/capacity_t 顶层字段标为 legacy_summary，其t单位仅来自字段后缀，年化单位未知。产能不继承产量年度或日期。多条候选摘要留空，明细全部保留。注册表可解析URL不表示已实时验证链接。

CSV采用带BOM的UTF-8（Python读取用 utf-8-sig）、单表头、逗号及规范引号。空字段对应JSON null，不是0。source_keys在CSV中为JSON数组字符串，在JSON中为数组。布尔值为true/false，JSON数字保留数值类型。类型见字段字典。防止Excel公式：以单引号开头或首个非空白字符为 = + - @ 的文本加一个前导单引号；示例读取器准确移除该转义，数值不转义。

在包目录运行 `python examples/load_snapshot.py .`（Python 3标准库）。示例将有类型CSV导入内存SQLite，运行 load_snapshot.sql，并核对Python与SQL的中国／韩国铅锌加工项目查询一致性。结果保留每条观察的指标、期间、口径，不汇总，未知仍为空。不承诺兼容所有研究系统。

全金属、单金属及四行样例均由同一规范版本筛选。构建日期不代表指标日期。八种金属是目录登记覆盖，不是全球完整覆盖或独立厂址计数。库存、历史序列、事件、内部研究及来源原件排除。首版没有可比历史包，不补造变更历史。实际数量及缺口见coverage.csv，SHA-256校验值见manifest.json。数据包包含可筛选的 MGW-Snapshot.xlsx 工作簿，以及内容一致的 CSV／JSON 文件；按现有工作习惯选择入口。