---
title: MiniDispatch 批次结束时调用 flush 的拟议方案
type: review
project: DEMO-Dispatch
subsystem: software
status: maintained
resolution: open
verification: unverified
delivery: local-only
created: 2026-10-26
updated: 2026-10-26
---

# MiniDispatch 批次结束时调用 flush 的拟议方案

[返回任务索引](./README.md) · [项目首页](../README.md)

给定材料支持优先检验消息的发布时机，并提出在批次结束时调用 `flush()`。

## 协议与时序依据

来源为 2026-10-26 用户请求 W01，全部是虚构测试材料。MiniDispatch 协议 v1 的摘记明确规定：`queue()` 只把消息放入生产者私有缓冲，`flush()` 才将它发布到消费者可读队列。用户给定的时序如下，未附实验执行记录：

| 时间 | 动作或结果 |
| --- | --- |
| 10ms | `queue(16)` |
| 11ms | consumer read 超时 |
| 200ms | `flush()` |
| 201ms | consumer read 得到 16 字节 |

按该协议，入私有缓冲不等于对消费者可见。11ms 的读取在发布动作之前超时，与消息仍在私有缓冲的解释一致；200ms 发布后读到 16 字节，也与该解释一致。这份时序支持发布延迟这一判断方向，不能据此排除实际系统中的其他原因。

## 方案条件与检验

拟议方案是在批次结束时调用 `flush()`，让这一批消息在结束处从私有缓冲转入消费者可读队列。成立条件是：实际接口遵循摘记语义，批次结束路径可达，且 `flush()` 位于该批最后一次 `queue()` 之后。

目前没有真实源码，没有应用修改，也没有执行实验，因此上述条件和方案效果都尚未核实。后续应先核对真实实现及批次结束路径，再在相同读取条件下对照有、无批次结束 `flush()` 的行为，记录最后一次入缓冲、发布和消费者读取的时间及字节数，检验是否确实改变可见时机。
