Skip to content

get_bot_info

获取指定协议 Bot 的运行信息。框架根据 self_id + client_type 定位账号,并使用账号自己的登录节点。账号可以处于离线、登录中或在线状态。

调用

js
const bot = await api.forProtocol('android').get_bot_info(self_id)

参数

参数类型必填说明
self_idnumberBot QQ 号

返回值

js
{
  self_id: 123456789,
  protocol_id: 0,
  device_profile_id: 1,
  nickname: '示例账号',
  status: 1,
  login_time: 1710000000,
  online_time: 3600,
  last_active: 1710003600,
  level: 42,
  is_qq_vip: true,
  friend_count: 100,
  group_count: 20,
  received: 1234,
  sent: 567,
  extra_info: '',
}

status0 离线、1 在线、2 登录中。

is_qq_vip:是否已开通 QQ 会员,true 为已开通,false 为未开通。

调用前必读

协议与使用指南

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 开发文档