WebSocket 实时通信
实时未读推送、任务状态、节点在线状态
WebSocket 实时通信
OpenVort 的 Web 面板通过 WebSocket 实现实时双向通信,用户无需手动刷新即可感知最新状态。
自动连接
用户登录后,前端自动建立 WebSocket 连接。连接断开时自动重连(指数退避:1s -> 2s -> 4s -> ... 最大 30s)。
消息类型
| 类型 | 方向 | 说明 |
|---|---|---|
unread_update | 服务端 → 前端 | 会话未读计数更新 |
task_status | 服务端 → 前端 | AI 员工任务执行状态(executing/idle) |
task_completed | 服务端 → 前端 | 任务执行完成 |
task_failed | 服务端 → 前端 | 任务执行失败 |
schedule_result | 服务端 → 前端 | 定时任务执行结果 |
node_status_change | 服务端 → 前端 | 远程节点上线/下线 |
offline_summary | 服务端 → 前端 | 用户上线时推送离线期间摘要 |
presence | 双向 | 在线状态广播 |
typing | 双向 | 正在输入状态 |
ping / pong | 双向 | 心跳保活 |
断线重连
WebSocket 重连后,自动拉取离线期间的未读计数和活跃任务列表,确保状态同步。