Skip to content

get_user_agent

获取当前 Bot 协议和设备指纹对应的 QQ Android WebView User-Agent。

v2.0.5 起,此已有 action 纳入服务管理能力发现。插件通过服务令牌认证后调用;使用 api.forProtocol('android') 明确账号协议,不能把服务连接当成固定账号节点。

调用

js
const result = await api.get_user_agent(self_id)

参数

参数类型必填说明
self_idnumberBot QQ 号,登录验证过程中也可调用

返回值

js
{
  user_agent: 'Mozilla/5.0 ...'
}

返回值根据 Bot 当前绑定的协议版本和设备指纹生成。

调用前必读

协议与使用指南

Android + Linux QQ
适用协议
Android + Linux QQ
使用前准备
插件服务必须先使用框架服务 Token 完成 WebSocket 认证。当前契约不使用 system_management 开关或 allowed_actions 逐项授权。
选择协议
const targetApi = api.forProtocol('linux') // 或 'android'

原始 action 请求只使用附件约定的 client_type: 'android' | 'linuxqq';省略时选择 Android。

建议搭配

常见失败原因

  • 服务 Token 无效或 WebSocket 连接已断开
  • 插件与框架 management_api_version 不匹配
  • 目标节点、账号或协议状态不符合管理操作要求

注意事项

  • 这是跨节点或框架级管理能力;服务端必须以服务 Token 认证为边界,不能依赖前端按钮显隐,所有变更都应记录审计日志。
  • 同一 QQ 可同时运行 Android 与 Linux;务必显式选择协议,避免把操作发送到错误会话。
  • 查询结果可能受 QQ 服务端分页、缓存与权限影响,不应假设一次调用返回全部数据。

萌卡NT 开发文档