反向 WebSocket
插件独立监听 WebSocket 地址,框架主动连接插件。
配置服务
先启动插件的 WebSocket 服务,再在框架管理后台的“插件”中创建反向 WebSocket 服务,填写 ws:// 或 wss:// 地址、服务名称、令牌与重连设置,然后启用。
地址必须能从框架所在机器访问。127.0.0.1 指框架本机;插件在另一台机器时应使用它的实际地址。
验证连接
框架发起握手时携带以下请求头:
| 请求头 | 内容 |
|---|---|
Authorization | Bearer 服务令牌 |
X-Meng-Ka-Token | 服务令牌 |
X-Meng-Ka-Service | 服务名称 |
插件服务端必须先验证配置中的令牌,再接受连接。不要把服务名称当作认证凭据。
调用接口
连接后使用与正向 WebSocket 相同的 action/action_result 帧。账号操作使用 self_id 与显式 protocol_id 选择当前框架内的账号。事件接收权限由框架中的服务配置决定。
完整消息格式见通信协议。连接断开后框架按配置尝试重连;插件仍须正确处理 Ping/Pong,并用请求 id 区分响应。不要依赖旧 SDK 的托管控制帧、client_type 或 action_stream。
