attachGatewayWsMessageHandler函数详细解释

一、代码整体作用与流程总结这段代码是Node.js环境下WebSocket网关的核心消息处理逻辑，主要实现客户端与网关建立WebSocket连接时的握手认证、设备配对、权限校验，以及连接建立后的请求处理。核心流程如下：初始化与上下文准备：解析连接上下文（IP、代理、配置等），判断客户端是否为本地/可信代理来源。握手阶段校验：验证首个消息必须是connect请求，校验协议版本、客户端角色/作用域。校验浏览器客户端（Control UI/Webchat）的Origin合法性。设备身份校验：验证设备公钥、签名、Nonce、时间戳等。认证决策：结合密码/Token/设备Token完成认证，判断是否需要设备配对。设备配对：未配对/权限升级时触发配对流程，本地客户端自动批准配对。连接建立：生成设备Token（如有），记录客户端在线状态（Presence）。向客户端返回hello-ok响应，包含网关能力、健康快照、Canvas权限等。针对Node角色客户端，注册节点信息、刷新远程节点资源。后续请求处理：校验请求格式