# DEMO-LOGPIPE：关闭时尾批未输出

日期：2026-10-28。范围：虚构 Python 教学夹具，不涉及公司源码、设备或真实网络服务。本轮未修改材料、提交或发布。

## 结论及边界

修改前 flush 在 closed=True 时提前 return，既不输出也不清空 pending；常规 closed=False 则逐条 append 后 clear。这解释了正常批次成功而关闭尾批滞留。材料证明队列没有被处理，不能据此断言真实磁盘或网络日志丢失。

修改后删除提前返回，closed 参数仍存在但不再影响执行。当关闭时确实调用 flush，且全部 append 和最后 clear 成功时，尾批按序输出并清空。普通批次行为保持。成功排空后、没有新增记录时再次调用关闭 flush 不重复输出。

已证实未解决：部分输出后异常再重试会重复。A 输出成功、B 首次拒绝时，clear 尚未执行，pending 仍为 [A,B]，published 已为 [A]；手动重试后得到 [A,A,B]。异常向调用者传播；代码没有自动重试。成功排空后的重复调用通过，不能推广为失败重试幂等或恰好一次交付。

## 本轮实际运行

环境：Windows PowerShell，Python 3.13.14。本轮实际重跑，退出码 0。根目录下的复现命令：

```powershell
python -B --version
python -B materials/v1/probe_batchpub.py
```

-B 禁用 Python 字节码缓存。探针只读取夹具并将 JSON 打印到标准输出。退出码 0 不代表所有断言条件都通过，还须核对 passed 与 duplicate_free。

| 用例 | 修改前 | 修改后 |
| --- | --- | --- |
| normal_flush | pending=[]，published=[A,B]，通过 | 同前，通过 |
| close_drain | pending=[A,B]，published=[]，失败 | pending=[]，published=[A,B]，通过 |
| repeat_close_flush | pending=[A,B]，published=[]，失败 | pending=[]，published=[A,B]，通过 |

修改后 partial_publish_then_retry：首次异常 `simulated sink rejection on B`，pending=[A,B]，published=[A]；重试后 pending=[]，published=[A,A,B]，duplicate_free=false。此失败探针仅运行修改后版本，不推定修改前的对应结果。

[本轮结果](DEMO-LOGPIPE-2026-10-28-run.json) 与 [已有结果](materials/v1/observations.json) 已通过 Python 按 JSON 结构比较完全一致。材料目录检查未发现 __pycache__ 或 .pyc。

## 证据和复核方法

- [修改前源码](materials/v1/batchpub_before.py)：关闭分支提前 return。
- [修改后源码](materials/v1/batchpub_after.py)：移除该分支，逐条 append 后整批 clear 的顺序不变。
- [探针](materials/v1/probe_batchpub.py)：常规、关闭、重复关闭，以及 B 首次拒绝后的手动重试。
- [历史运行记录](materials/v1/observations.json)：既有证据；本轮结果另存，避免覆盖。

本轮探针记录的 SHA-256：

| 文件 | SHA-256 |
| --- | --- |
| batchpub_before.py | 517567bc6059fe03fc7326759b33b4fd9d67b2d474ea2ffe639eea7998460c89 |
| batchpub_after.py | 31a38f06f439318cec9450ec58eb990a81abed2f0d84b3edae233019efbca3ac |
| probe_batchpub.py | b74424e01766f3537b9bc5ae9c6de8017f9d8449b60ff28ec73b7145eb58a66e |

后续先核对指纹，再执行上述 -B 命令，核对每个用例的 pending、published、异常、passed 与 duplicate_free。指纹变化后需重新建立版本证据，不直接套用结论。

## 尚未验证和后续方向

未覆盖并发 flush/写入、真实关闭调用顺序、是否保证调用 flush、输出端关闭、进程崩溃恢复、磁盘/网络持久化、下游确认及 clear 失败。内存列表夹具不能证明真实系统的端到端交付保证。

针对已证实的重复问题，后续应先定义逐条确认和重试语义，再考虑确认后逐条出队，或输出端基于稳定记录标识去重。这些仅为待验证设计方向，本轮未实现。

可复用方法：比较正常与关闭路径的控制流，验证成功排空后的重复调用，再注入逐条输出中途失败并重试；分别记录队列、已输出前缀、异常和重试结果，区分尾批未处理与重复交付。

## 后续导航（不改变本轮历史范围）

以上结论保留为 v1 第一轮验证范围。“未解决”和“待验证”描述针对当时材料。独立 v2 接收端验证见 [后续记录](DEMO-LOGPIPE-2026-10-28-v2.md)；条件化结论见 [当前状态与复用说明](DEMO-LOGPIPE-current.md)；按版本复做见 [操作说明](DEMO-LOGPIPE-runbook.md)。v2 的限定通过不改写本轮失败。
