rawtap

Overview ¶

Package rawtap 提供上游原始字节的旁路归档。

职责：

• 在 adapter 解析上游消息**之前**，把原始字节按行旁写到一个文件
• 由环境变量 HANDOFF_RAW_TAP_DIR 门控，缺省完全关闭（Open 返回 nil）

边界：

• 不解析、不过滤、不判断内容：拿到什么写什么，样本的价值就在于未经加工
• 不参与任何回合判定：Write 的返回值是 void，adapter 无从依赖它
• 不做轮转与容量上限：这是诊断开关，开着跑一次探针就关，不是常驻设施

为什么需要它：grok 与 codex 的上游是进程内 WebSocket、opencode 的 SSE 端口 由 adapter 随机选，三者都无法从进程外 tee。没有旁路就没有原始样本， 而没有原始样本的现场无法从任何一个 clone 复核——B74 的原始现场（2026-08-12） 正是因此永久丢失。