3. 回放机制原理

实体解析回放（Entity Resolution Replay）是评估与调试解析规则的核心技术。它通过记录生产环境中的解析决策日志，在离线环境中按时间顺序重新执行，从而实现对规则变更、模型升级或参数调整的对比评估。理解回放机制的原理，是掌握后续对比评估方法的基础。

3.1 什么是回放

回放是指将实体解析系统在真实运行过程中产生的输入数据与决策上下文完整记录下来，然后在测试环境中按照相同的时序重新执行解析逻辑的过程。回放不是简单的数据重跑，而是对解析引擎状态的精确还原。

回放机制通常包含以下三个基本阶段：

1. 记录阶段：在生产环境中拦截解析请求，将输入记录、时间戳、引擎快照写入回放日志。
2. 加载阶段：在离线环境中读取回放日志，重建解析引擎的初始状态。
3. 执行阶段：按日志记录的时序逐条提交输入，驱动解析引擎重新计算。

3.2 回放与实时解析的区别

回放解析与实时解析在运行环境、数据来源、性能要求和评估目标上存在本质差异。下表从多个维度进行对比：

3.3 回放日志的构成要素

回放日志是回放机制的核心资产，其完整性和准确性直接决定回放评估的可信度。一个标准的回放日志应包含以下五大构成要素：

• 输入记录（Input Records）：每条待解析的原始记录，包含所有字段值、数据源标识、记录ID。这是回放执行的基本单元。
• 时间戳（Timestamps）：记录到达系统的精确时间，用于维持时序顺序。回放必须按原始时序执行，否则可能产生不同的合并结果。
• 引擎快照（Engine Snapshots）：在关键节点（如规则变更、缓存刷新）保存的解析引擎完整状态，包括实体索引、匹配缓存、已合并实体列表。
• 决策上下文（Decision Context）：原始执行时的规则版本、阈值参数、模型权重等配置信息，用于后续对比分析。
• 元数据（Metadata）：日志版本号、记录总数、数据源指纹、校验和等，用于验证日志完整性和一致性。

3.4 回放日志的存储格式示例

以下是一个简化的回放日志条目示例，采用 JSON 格式存储，便于解析和扩展：

{
  "log_version": "2.1",
  "session_id": "replay_20250301_001",
  "entries": [
    {
      "sequence": 1,
      "timestamp": "2025-03-01T10:00:00.123Z",
      "record": {
        "id": "REC-001",
        "source": "CRM",
        "fields": {
          "name": "张三",
          "id_card": "110101199001011234",
          "phone": "13800138001"
        }
      },
      "snapshot": {
        "entity_index_size": 1250,
        "cache_version": "v3.2",
        "merged_entities": 980
      },
      "context": {
        "rule_set": "standard_v2",
        "threshold": 0.85,
        "model": "match_model_202502"
      }
    },
    {
      "sequence": 2,
      "timestamp": "2025-03-01T10:00:01.456Z",
      "record": {
        "id": "REC-002",
        "source": "ORDER",
        "fields": {
          "name": "张先生",
          "phone": "13800138001",
          "address": "北京市朝阳区"
        }
      },
      "snapshot": {
        "entity_index_size": 1251,
        "cache_version": "v3.2",
        "merged_entities": 980
      },
      "context": {
        "rule_set": "standard_v2",
        "threshold": 0.85,
        "model": "match_model_202502"
      }
    }
  ],
  "checksum": "a1b2c3d4e5f6..."
}