用途:realtime-systems 是一项面向实时通信系统设计与实现的技能规范,适合在开发 WebSocket、Server-Sent Events(SSE)或发布/订阅(pub/sub)功能时参考,重点解决在线状态(presence)、消息扇出、断线重连与背压等问题。
核心思路:资料强调实时系统不能简单用无限轮询模拟,而应维护持久双向或流式连接(WebSocket、SSE、gRPC 流),并通过连接生命周期管理、心跳健康检查、指数退避重连、水平发布/订阅扇出与严格背压处理,避免服务器内存耗尽。
主要能力(四步框架):
- 协议选型:SSE 适合服务器到客户端的单向流(如 LLM 逐词输出、行情、通知),基于标准 HTTP/2,浏览器原生 EventSource 支持自动重连;WebSocket 适合低延迟双向通信(协作编辑、多人游戏、互动聊天);WebTransport/UDP 适合极低延迟音视频与游戏。
- 连接生命周期与心跳:服务端每 30 秒发送 ping,期望 5 秒内收到 pong;连续两次未收到 pong 则终止连接(ws.terminate()),防止僵尸连接堆积。客户端重连应使用带抖动的指数退避,公式为 T_wait = min(T_max, T_base × 2^attempt) ± random_jitter,避免服务器重启时的惊群问题。
- 水平扩展与发布/订阅扇出:套接字是有状态连接,绑定在单个服务进程上,因此需用 Redis 或 NATS 作为消息总线解耦连接管理与消息广播;某个节点发布到频道(如 room:123)后,其他节点订阅并向本地连接广播。
- 背压与缓冲防御:监控 ws.bufferedAmount,当缓冲区超过阈值(示例 1MB)时丢弃临时消息(如光标位置)或暂停接收,避免慢客户端导致内存溢出(OOM)。
使用方式:资料要求产出 REALTIME-SPEC.md 规格文档,包含协议与基础设施(协议、TLS 1.3、Redis Cluster/NATS、目标并发数)、水平扇出拓扑(Mermaid 图)、韧性与心跳参数(心跳间隔、pong 超时、退避基数与上限、抖动比例、慢消费者策略)以及消息帧结构(event、room_id、sender_id、sequence_id、payload)。
示例与验证:资料给出协作文档在线状态引擎案例:1000 名工程师同时查看同一文档产生每分钟百万次光标更新导致 Node.js 崩溃;通过客户端将光标广播从 60Hz 降至 15Hz、推送前检查套接字缓冲、改用紧凑二进制 Protobuf,CPU 下降 72%,25000 连接下内存稳定在 300MB 以下。验证清单包括:心跳在 35 秒内终止死连接、重连使用带抖动指数退避、水平扩展依赖 Redis/NATS、缓冲溢出时丢弃或限流、连接仅走加密协议(wss:// 或 HTTPS)。
限制与反模式:资料未提供安装命令、版本要求、收费、平台支持与具体代码实现。应避免:用 500ms 短轮询冒充实时;断连时未移除事件监听器导致内存泄漏;向所有客户端广播全部事件并在前端过滤。