---
type: guide
project: DEMO-PacketCache
status: draft
updated: 2026-10-28
---
# PacketCache v1/v2 接收指南

[项目](./README.md)

原 v1 路径来自预置的虚构历史指南。2026-10-28 依据用户新提供的 v2 规范补充版本分支，来源与接口边界见[规范学习笔记](../../Domains/PacketCache-v1.md)。未取得真实实现或执行实验；两条路径均未经过真实操作验证，继续保持草稿状态。

使用前先确认规范版本，再选择对应路径：

| 版本 | 按规范推导的接收步骤 |
| --- | --- |
| v1（原定义仍成立） | `stage(packet)` → `commit()` 返回，确认发布完成 → `receiver.read()`。 |
| v2 | `stage(packet)` → `commit()` 返回并保存 token → `wait(token)` 成功，确认发布完成 → `receiver.read()`。 |

v2 收到 token 后不能直接把发布记为完成；若尚未取得 `wait(token)` 的成功结果，发布状态仍未确认。规范未定义失败、超时与重试处理，不能据此指南自行认定可安全重新提交。

两个版本的 `receiver.read()` 都只读取接收队列。发布完成不保证包此刻仍在队列中，也不确认业务处理完成；业务完成需要另行确认。后续取得实现时，需分别验证对应版本的接收路径，尤其是 v2 的 token 与等待成功条件。

