WebSocket

连接

1. 填写 ws:// 或 wss:// 地址。
2. 点击 连接；状态点变绿（已连接）后即可收发消息。
3. 再次点击按钮即断开。

消息收发

• 消息日志：接收（绿）/ 发送（蓝）/ 系统（灰）/ 错误（红）分色展示，顶部统计 ↑↓ 条数与连接时长。
• 发送框：支持 JSON / 纯文本；⌘/Ctrl + Enter 快速发送；「格式化 JSON」一键美化。

子协议

「握手配置」标签中的子协议填逗号分隔列表，例如：

graphql-transport-ws, v1.json

自定义握手 Header（隧道模式）

浏览器原生 WebSocket 不能携带自定义 Header（如 Authorization、X-API-Key）。OpsxAPI 的处理方式：

1. 「握手配置」中填写 Header 后，工具自动改走本地 Gin 隧道：
   • 浏览器 → Gin /v1/proxy/ws/attach（普通 WS）
   • Gin → 目标服务器（携带你填的全部 Header）
2. 不填 Header 时直连目标，零额外开销。

注意：隧道要求本地 Gin 服务（:8787）在运行，即用 ./run.sh web / gui 启动的默认形态。

调试技巧

• 消息过多时点「清空」；日志上限 500 条，超出自动滚动淘汰。
• 把常用报文保存在「说明」里，或为不同报文建多个 WS 请求节点。