4. 排放因子库版本控制：因子库版本号策略、变更日志、历史版本回溯、版本对比与差异分析

排放因子库是碳足迹核算的“计量基准”，其版本管理直接决定了不同时期、不同项目间核算结果的可比性与合规性。缺乏版本控制的因子库，将导致历史数据无法追溯、审计证据链断裂、跨期报告口径不一致等严重问题。本节围绕版本号策略、变更日志、历史回溯与差异分析四个核心维度，构建因子库的版本控制体系。

4.1 版本号策略：语义化与合规化双重约束

版本号不仅是标识符，更是变更语义的载体。推荐采用 “主版本号.次版本号.修订号+合规标签” 的四段式结构，兼顾技术演进与监管要求。

4.2 变更日志：结构化记录与审计追踪

变更日志（Changelog）是版本控制的核心证据。每条变更记录应包含以下结构化字段，并采用机器可读与人工可读双格式存储。

# 排放因子库变更日志（示例）
## [1.3.0] - 2025-03-15
### 新增
- 新增“锂电池生产”排放因子（EF-ID: BAT-001~BAT-012），覆盖正极材料、电解液、组装三个工序
- 新增“生物质颗粒燃烧”CH₄因子（EF-ID: BIO-023），基于2024年最新实测数据

### 修正
- 修正“天然气发电”CO₂因子（EF-ID: ENE-045），从 0.201 kg/kWh 调整为 0.198 kg/kWh（来源：IEA 2024）
- 修正“水泥熟料生产”过程排放因子（EF-ID: CEM-008），修正了原料碳酸盐含量计算偏差

### 废弃
- 废弃“燃煤发电（无脱硫）”因子（EF-ID: ENE-012），因技术已淘汰，替代为 EF-ID: ENE-013

## [1.2.5] - 2025-01-10
### 修复
- 修复“铝电解”因子（EF-ID: MET-003）单位错误，从 tCO₂/t 修正为 kgCO₂/t
- 更新所有因子的参考文献DOI链接，确保可解析

4.3 历史版本回溯：快照存储与时间旅行

历史版本回溯的核心机制是 “快照+增量” 混合存储策略。每次发布正式版本时，生成一份完整的因子库快照（Snapshot），并记录该快照的哈希值（SHA-256）以确保完整性。日常开发中的小版本变更，则通过增量补丁（Patch）记录差异。

4.4 版本对比与差异分析：结构化差异报告

版本对比的核心产出是 结构化差异报告（Diff Report），该报告需从三个维度量化分析：因子值变化、因子元数据变化、因子增删情况。

4.4.1 差异分析维度与输出格式

4.4.2 差异分析流程

1. 加载基线版本与目标版本：分别加载两个版本的完整快照或通过增量补丁重建。
2. 因子ID匹配：以因子唯一ID（EF-ID）为键，进行全量匹配，识别“仅存在于基线”“仅存在于目标”“两版本共存”三类集合。
3. 数值对比：对共存因子，逐字段计算差值与相对变化率，标记超过阈值（如±5%）的因子。
4. 生成差异报告：输出机器可读的JSON/XML格式差异报告，同时生成人工可读的HTML/PDF摘要。

{
  "diff_metadata": {
    "baseline_version": "1.2.5",
    "target_version": "1.3.0",
    "comparison_date": "2025-03-16",
    "total_factors_baseline": 1250,
    "total_factors_target": 1285
  },
  "added_factors": [
    {"ef_id": "BAT-001", "name": "锂电池-正极材料", "value": 12.5, "unit": "kgCO₂/kg"}
  ],
  "removed_factors": [
    {"ef_id": "ENE-012", "name": "燃煤发电（无脱硫）", "reason": "技术淘汰"}
  ],
  "modified_factors": [
    {
      "ef_id": "ENE-045",
      "name": "天然气发电",
      "field": "value",
      "old_value": 0.201,
      "new_value": 0.198,
      "change_percent": -1.49,
      "threshold_exceeded": false
    }
  ]
}

4.5 版本控制与合规披露的衔接

在合规披露场景下，版本控制信息必须嵌入披露报告。推荐在报告附录中增加 “排放因子库版本声明” 表格：