# 浏览器消息与输入

WebSocket升级前先等待内部ready信号；该ready被handler消费，不是客户端必收的第一事件。frame先发文本元数据，再发原始图像二进制。非frame事件作为文本转发。客户端须保持帧与图像配对；不要把下一条任意事件当图像。

| 客户端消息 | 关键字段 | 规则 |
| --- | --- | --- |
| ack | type、seq | seq为已处理帧的正序号。 |
| release | type | 发送释放信号；不能仅凭连接断开推断任务已恢复或浏览器已停止。 |
| input_mouse | eventType、x/y、button等 | 仅mousePressed/mouseReleased/mouseMoved/mouseWheel。 |
| input_keyboard | eventType、key/code/text等 | 仅keyDown/keyUp/char。 |

键鼠公共字段还包括clickCount、deltaX/deltaY、modifiers和windowsVirtualKeyCode；输入对象按服务端类型处理。文本最多4096字节，key/code最多64字节，modifiers为0至15，虚拟键码0至255。鼠标button为空或left/right/middle，clickCount为0至3，坐标非负，数值需有限且绝对值不超过100000。

传入消息只允许文本帧，最多16384字节；解压后同样限长。沙箱输入decoder拒绝未知结构字段及尾随JSON，不能将它当任意JavaScript/CDP/导航接口。输出scanner有4MiB单行限制，该限制不同于客户端输入上限。

当前handler连接最多10分钟，15秒ping、45秒读超时，约每30秒重新绑定当前访问并验证浏览器。期限与网络失败不能当业务取消。压缩是无损传输协商，帧的解码图像字节保持，不承诺固定帧率或压缩比例。

关闭查看连接不等于结束原浏览器。令牌取得与状态检查不创建替代沙箱、不启动浏览器。浏览器未运行与原环境已结束分别为409/BROWSER_NOT_RUNNING和410/BROWSER_SESSION_ENDED；恢复需要原任务与真实环境状态。
