WebSocket 实时通信

所属位置: 第二篇·通讯协议 — WebSocket 通道协议 前置要求: 先读认证协议和 API 层 阅读目标: 掌握 ACP 事件如何从 VM 流到前端

flowchart TB
    Client["Proxy 代理层"]
    Stream["WS /tasks/stream<br/>ACP 事件流"]
    Control["WS /tasks/control<br/>RPC 控制"]
    TaskLive["TaskLive WS<br/>后端↔TaskFlow"]
    Term["WS Terminal<br/>交互式 TTY"]

    Client -->|建立连接| Stream
    Client -->|查询状态| Control
    Client -->|终端操作| Term

    subgraph ACP["ACP 事件"]
        MSG["agent_message_chunk<br/>文本输出"]
        THK["agent_thought_chunk<br/>推理过程"]
        TOOL["tool_call / update<br/>工具调用"]
        USG["usage_update<br/>Token 用量"]
    end

    Stream --> ACP

#	文件	内容	行数
1	Task Stream	ACP 事件流、用户输入、重连机制	279L
2	Task Control	RPC 调用：文件操作、重启、切换模型	237L
3	Terminal TTY	交互式终端、二进制帧、Keepalive	290L
4	TaskLive 内部通信	Backend ↔ TaskFlow 节点通信	212L
5	语音转文本	Doubao ASR、PCM S16LE 编码	259L
6	ACP 事件参考	完整事件类型、字段、示例	201L
7	会话生命周期	mode=attach 多轮复用协议	465L