Skip to main content

概览

系统提供两个 WebSocket 端点: 两者均通过 JWT token 进行认证(query 参数传递)。

聊天 WebSocket

连接

连接时服务端校验 JWT,校验失败立即关闭连接。

客户端发送

服务端响应

内部消息格式

服务端将 WebSocket 消息标准化为 UnifiedMessage

通知 WebSocket

连接

工作模式

  • 单向推送:服务端主动向客户端发送通知,客户端只需保持连接
  • 心跳:客户端通过 receive_text() 保持连接存活
  • 多连接:同一用户可同时打开多个连接,所有连接都会收到通知

推送消息格式

NotificationHub 架构


SSE 流式输出

除 WebSocket 外,HTTP 端点也支持 SSE(Server-Sent Events)流式输出:
服务端返回 text/event-stream,逐块推送 Agent 输出。

错误处理