外观
send_packet
使用当前 QQ 9.2.70 登录会话发送已组装的原生协议包。
调用
js
const responseHex = await api.send_packet(self_id, cmd, data, true, reserve)| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | number | 是 | 在线 Bot QQ 号 |
cmd | string | 是 | SSO 命令名 |
data | string | 是 | 请求体十六进制字符串，最大 4 MiB |
rsp | boolean | 否 | 是否等待回包，默认 true |
reserve | string | 否 | 自定义 reserve 十六进制；省略时由框架生成标准 reserve |
等待回包时返回小写十六进制字符串；rsp=false 时成功返回 null。
专属 Key
此 action 要求当前框架实例已经绑定有效的专属 Key。框架自动从本机安全存储读取 Key 并完成鉴权；插件不得在配置、action 外层或 params 中提交 access_key。
Key 被禁用、过期、超过限额、实例签名不匹配或验证服务不可用时，框架都会在发包前拒绝调用。Key 的绑定和轮换由框架管理员完成，不向插件暴露。
高权限接口
插件必须只发送自身业务明确需要的命令和数据。专属 Key 调用会记录关联用户、插件、框架实例、发送 QQ、命令、请求内容、发送时间和执行结果；协议正文按敏感数据加密保存。禁止将 Key 写入源码、URL或日志。