1. PSI告警基础概念

1.1 PSI（策略信号接口）的定义

PSI（Policy Signal Interface，策略信号接口）是风控规则引擎中用于承载策略执行结果与外部系统信号之间交互的标准化数据通道。它定义了规则引擎在完成策略运算后，如何将命中规则、风险等级、处置动作等关键信号封装为统一格式，并输出至下游告警、决策、处置等模块。

1.2 告警触发机制

告警触发机制定义了 PSI 信号在何种条件下被提升为告警事件。触发条件由告警规则和阈值策略共同决定，通常包含以下三种模式：

• 阈值触发：风险评分超过预设阈值（如 > 85 分）时立即触发告警。
• 规则命中触发：特定高危规则（如“IP 黑名单命中”）被命中时无条件触发。
• 组合条件触发：多个信号同时满足条件（如“命中规则数 > 3 且 设备指纹异常”）时触发。

触发后的信号会进入告警队列，经过去重、聚合、优先级排序后，最终生成告警记录。以下 SVG 展示了从 PSI 信号产生到告警触发的完整链路：

1.3 告警生命周期

一个 PSI 告警从产生到最终关闭，会经历多个状态阶段。理解生命周期是进行回放验证的前提——只有知道每个阶段的数据特征，才能设计有效的验证用例。

以下 SVG 展示了告警生命周期的状态流转：

1.4 PSI 告警的核心数据字段

在进行回放验证时，以下字段是必须校验的关键字段：

{
  "eventId": "evt_20250321_001234",        // 事件唯一ID
  "psiVersion": "2.1.0",                   // PSI 协议版本
  "strategyId": "str_risk_loan_v3",        // 策略ID
  "hitRules": ["r001", "r007", "r023"],    // 命中规则列表
  "riskScore": 92,                         // 风险评分（0-100）
  "dispositionCode": "BLOCK",              // 处置码
  "triggerTimestamp": 1742544000000,       // 触发时间戳（毫秒）
  "lifecycle": "NEW",                      // 当前生命周期状态
  "sourceSystem": "rule-engine-01"         // 来源系统标识
}