日志导出教学示例库

DEMO-LOGPIPE:v2 接收端去重验证

普通整理原稿

DEMO-LOGPIPE-2026-10-28-v2.md下载原文件
示例库目录(4 篇文档)

日期:2026-10-28。独立后续轮次;仅进程内 Python 教学模拟,无真实网络、磁盘持久化或产品验收。旧客户端和第一轮材料未改。

实测与证据

Windows PowerShell / Python 3.13.14,以 python -B materials/v2/probe_dedup.py 实际运行,退出码 0。输出另存为 v2 本地结果,与 维护者结果 按 JSON 结构完全相同。运行前后既有文件指纹未变,未发现 pycache 或 .pyc。

条件 / 结果字段 本次观察 解释
first_attempt pending 仍为 L-101/A、L-102/B;stored 已包含两条;异常 record stored, acknowledgement lost B 已存入后抛异常,客户端没有执行整批 clear;异常不等于未存入
same_receiver_retry pending=[];stored 仍仅两条;duplicate_free=true 手动重试相同稳定 ID 和内容、同一实例保留 seen 时去重有效
id_conflict same record id with different payload 已见 L-101 改内容被 ValueError 拒绝
after_dedup_reset stored 为 A,B,A,B(各保留原 ID);duplicate_free=false 清空内存 seen 后重放同一批,重复重新出现

新接收端 用 seen 保存 ID 到 payload 的映射;同 ID 同内容直接返回,同 ID 不同内容拒绝。对新记录先登记和追加,再为 L-102 模拟一次确认丢失。新探针 仍加载 v1 修改后客户端,未给客户端添加自动重试或逐条出队。

去重范围是同一接收端实例中尚保留的映射;本次只验证探针中的稳定 ID、相同内容重试。reset 是同实例清空 seen 并保留 stored 的边界模拟,不是实际进程重启或持久化恢复测试。探针没有改变 ID 的重试、并发、真实网络、崩溃、跨实例共享或持久化去重测试;不能推导端到端恰好一次。

旧结论如何继续适用

本次也用 -B 重跑 v1 探针,退出码 0;输出同时等于维护者 v1 结果和第一轮保存结果。旧客户端搭配无去重接收端时,B 首次拒绝后重试仍得到 [A,A,B]。v1 修改前关闭分支仍导致尾批滞留。v2 只为指定接收端条件增加通过证据,不能改写这些历史失败。

第一轮所列“稳定 ID 接收端去重”为当时待验证方向;现在仅本页指定条件已验证,其余未验证项保留。当前汇总见 状态与复用说明,逐版本复做见 操作说明。

本轮源文件 SHA-256

文件 SHA-256
v1/batchpub_after.py 31a38f06f439318cec9450ec58eb990a81abed2f0d84b3edae233019efbca3ac
v2/idempotent_sink.py a24df08c000ea0fc53da8f0996c2296982c5948a55fa95c644a1b4cf2fb061fc
v2/probe_dedup.py 853844dd0435db05557c74e44704d887d9f413cd5ea15cf5ed3133a911235c68