退订事件去重

适用场景

处理邮件客户端重试、重复点击、批量导入和多系统回传造成的重复退订事件。

输入与输出

输入包含 normalizedstatus、subscriberref、channel、subscriptionref、eventref、eventtime、seenevents 和 dedupwindowseconds。输出 NEW/DUPLICATE/REVIEW、主事件引用、重复次数和 event_hash。

安装与执行

无需第三方依赖。执行 python scripts/dedup.py examples/input.json，不接数据库、不更新任何真实偏好。

错误恢复

上游未 READY、主体或事件引用缺失、窗口未配置时输出 REVIEW；重复事件保留主引用并建议幂等写入。

权限与隐私边界

只处理脱敏引用和时间，不发送通知、不改抑制名单、不覆盖较新偏好、不以重复点击推断用户意图。

验收方法

新事件输出 NEW；同主体同订阅同事件引用输出 DUPLICATE；缺 event_ref 或窗口输出 REVIEW。