websocket-hub-patterns

该 Skill 提供了一套完整的 Go 语言 WebSocket 水平扩展架构模式，通过 Redis 实现多实例间的消息协调。

核心用法上，该方案采用 Hub 结构体管理本地连接和频道订阅，通过惰性 Redis 订阅机制（仅在本地有订阅者时才订阅 Redis 频道）显著节省资源。开发者可通过 npx clawhub@latest install 安装后，参考提供的代码模板快速构建支持水平扩展的实时网关。主循环使用 Go 经典的 select 模式处理连接注册、注销和广播事件，配合独立的 write pump 和 ping/pong 机制维持连接活性。连接注册表（ConnectionRegistry）用于在分布式环境下追踪连接归属实例，支持优雅关闭流程确保消息不丢失。

显著优点包括：首先，架构充分考虑了云原生环境的水平扩展需求，通过 Redis Pub/Sub 实现无状态服务实例间的消息同步。其次，惰性订阅设计降低了 Redis 资源消耗，避免空订阅浪费。第三，代码体现了生产级品质，包含慢客户端检测（缓冲区满时自动断开）、完整的错误处理和明确的"NEVER Do"警示清单。最后，提供的决策树帮助开发者根据实际需求选择合适方案。

潜在缺点在于：仅提供 Go 语言示例，其他技术栈需自行移植；代码未包含 TLS/SSL 配置，生产环境需补充安全设置；强依赖 Redis，在网络分区时可能影响跨实例同步。此外，来源为 T3 级个人开发者，长期维护存在不确定性。

适合目标群体为需要构建高并发实时系统的后端工程师和架构师，特别是开发聊天应用、协同编辑、实时仪表盘等场景，且需要解决多实例部署环境下消息广播一致性问题的团队。单实例简单应用可能觉得过于复杂。

使用风险包括：生产环境必须配置 Redis 加密认证和 WebSocket TLS，防止敏感数据泄露；示例中的心跳间隔需根据实际负载均衡器调整；连接注册表需合理设置 TTL 避免僵尸连接；广播遍历方式在超大规模连接时可能成为性能瓶颈。