# 3-18 [process][bug] WS 与 SSE delta 载荷合同分裂 v1

> 发现时间：2026-05-17
>
> 状态：`[process]`
>
> 关联主线：`03-rust-web`

## 1. 问题定义

SSE polling 可以从 bridgeLogs / domainEvents 解析 `streamDelta` 并附带 snapshot / resync 信息；WS 当前广播的是 `command_committed` 外壳，两者不是同一套 delta 合同。

## 2. 证据

- [stream_support.rs](/mnt/Data1T/mnote/rust/crates/mnote-web/src/routes/stream_support.rs:577) 附近解析 `streamDelta`。
- [command_support.rs](/mnt/Data1T/mnote/rust/crates/mnote-web/src/routes/command_support.rs:102) 附近广播 command committed 事件。
- [ws.rs](/mnt/Data1T/mnote/rust/crates/mnote-web/src/routes/ws.rs:40) 处理 WS socket。

## 3. 影响

- 同一 tree command 在 WS 与 SSE 下可能给客户端不同结构。
- 前端 live cache 需要维护两套 reducer，增加状态分裂风险。
- WS 切主时，SSE 已覆盖的 snapshot/resync 语义可能丢失。

## 4. 建议修复

- 抽出统一的 tree realtime envelope，WS 与 SSE 只作为 transport。
- 对同一命令分别跑 WS / SSE 合同测试，断言事件 kind、cursor、snapshot、resync 语义一致。
- 前端 reducer 只消费统一 envelope，不感知 transport 差异。

## 5. 状态

已确认 WS / SSE 事件结构不统一，尚未修复。