WebSocket Development 是一份面向 WebSocket 开发与实时通信系统的实践指南，目标读者是构建基于 WebSocket 应用的开发者。其核心原则包括：在编写代码前逐步思考实现方案；严格遵循用户需求；始终优先考虑安全性、可扩展性与可维护性；不留下任何待办、占位或缺失部分。
用途 该技能用于指导开发者构建实时应用，覆盖从连接建立到消息处理、扩展、安全、测试和监控的完整开发流程。
主要能力与内容 连接管理：生产环境始终使用带 SSL/TLS 加密的 wss:// 协议，以保证传输数据加密、防止窃听或篡改；在接受连接前实现握手验证；设置合适的连接超时以防止资源耗尽。连接生命周期方面，实现心跳/乒乓机制以检测失效连接；对断开的连接使用带指数退避的重连逻辑；维护连接状态以优雅处理断开场景；连接关闭时正确清理资源。
消息处理：消息设计采用结构化格式（JSON 的 type/payload 模式）；包含消息 ID 以关联请求与响应；实现消息版本控制以保持向后兼容；保持消息负载较小以降低延迟。错误处理方面，始终为 WebSocket 连接包含错误处理逻辑；优雅处理可能的断开或消息失败；对无法处理的消息实现死信处理；记录带有足够上下文的错误以便调试。
可扩展性模式：横向扩展使用消息代理（Redis Pub/Sub、RabbitMQ）进行跨服务器通信；在需要时实现粘性会话或连接亲和性；尽可能设计无状态处理器；考虑使用专用的 WebSocket 网关服务。性能优化方面，在短暂断开期间缓冲消息；对高频更新实现消息批处理；对带宽敏感的应用使用二进制协议（MessagePack、Protocol Buffers）；监控连接数和消息吞吐量。
安全实践：认证方面，在握手阶段对连接进行认证；使用带适当过期时间的基于令牌的认证（JWT）；在连接时和周期性间隔校验令牌；对每个连接和每个用户实现速率限制。授权方面，对每种消息类型/通道验证权限；对发布/订阅模式实现基于通道的访问控制；绝不在未验证的情况下信任客户端提供的数据；对所有传入消息负载进行净化。
框架特定指南：Node.js 原生 WebSocket（v21+）可利用内置 WebSocket 客户端进行实时通信以减少依赖，内置客户端简化实时通信并确保更好的互操作性；服务器端使用 ws 等成熟库或特定框架方案。Bun 运行时优先使用 Bun 原生能力而非第三方替代方案，使用带 WebSocket 支持的 Bun.serve() 而非单独的 WebSocket 库，利用 Bun 内置的流处理和 fetch 实现。浏览器客户端为旧版浏览器实现优雅降级，使用标准 WebSocket API 以获得广泛兼容性，处理可见性变化以管理连接状态，实现离线检测与排队。
测试策略：单元测试方面，为隔离测试模拟 WebSocket 连接；独立测试消息的序列化/反序列化；验证错误处理路径。集成测试方面，测试完整的连接生命周期场景；验证各种故障模式下的重连行为；以真实连接数和消息速率进行负载测试。
监控与可观测性：跟踪连接数指标；监控消息延迟与吞吐量；对连接错误率告警；记录连接生命周期事件以供调试。
常见模式：发布/订阅模式实现通道订阅管理，使用高效数据结构进行订阅者查找，在断开时处理订阅清理。请求/响应模式使用唯一 ID 关联请求和响应，为待处理请求实现超时处理，考虑使用确认消息以提高可靠性。广播模式优化一对多消息投递，考虑消息去重策略，为慢消费者实现背压。
适用场景 适用于需要构建实时通信功能的 WebSocket 应用开发，包括实时消息推送、发布/订阅系统、高频数据更新等场景。
限制 资料未提供具体实现代码示例、完整配置参数、平台兼容性细节或收费信息。