Bot 登录流程

登录 API 只能操作插件绑定节点下的账号。发起登录前，账号必须已经创建且处于离线状态。

以下示例中的 self_id 是要登录的 Bot QQ 号：

const self_id = 123456789

也可以从 get_bot_list() 返回项的 self_id 取得：

const bots = await api.get_bot_list()
const self_id = bots[0].self_id

登录前检查

const bots = await api.get_bot_list()
const bot = bots.find(item => item.self_id === self_id)

if (bot && bot.status !== 0) {
  await api.offline_account(self_id)
}

密码登录

const result = await api.login_account(self_id)

返回基础结构：

{ code: Number, message: String }

常见状态：

security_url 仅在响应实际包含地址时出现，不应假定该字段始终存在。

滑块验证

const result = await api.submit_slider(self_id, ticket, randstr)

返回结构与 login_account 一致。如果返回另一种验证状态，继续按新的 code 处理。

安全验证

安全验证可通过 security_verify 判断当前可用方式，也可以调用 get_security_verify_methods 重新查询。根据返回的 methods 选择扫码、短信或其他验证方式。

扫码安全验证

当结果为 140022010 时，可使用响应中的 security_verify，也可以重新查询当前验证原因和可用方式：

const securityVerify = await api.get_security_verify_methods(self_id)

当 securityVerify.methods 包含扫码方式时，创建登录二维码：

const qr = await api.create_login_qr(self_id)
// 将 qr.qr_url 渲染为二维码

使用返回的 guarantee_token 每秒查询一次状态：

const result = await api.query_login_qr_status(
  self_id,
  qr.guarantee_token,
)

status 依次可能为 waiting、scanned、confirmed 或 expired。当状态为 confirmed 时，服务端会自动继续 NTLogin，当前响应的 code 与 message 即最终登录结果，应停止轮询。

短信安全验证

当结果为 140022010 且 security_verify.methods.verify_list 包含短信方式时，用该方式的 sign 请求短信验证。短信验证有两种类型，由 verify_type 指定，必填：

接收短信（verify_type 4）

const sms = await api.get_sms(self_id, 4, sign)

返回服务端原始响应：

{ result: { state: 1, code: 1 }, sign: 'NEW_SMS_SIGN', masked_phone: '166******00', country_code: '86' }

提交时必须使用这里新返回的 sign：

const result = await api.check_sms(self_id, 4, sms.sign, code)

发送短信（verify_type 3）

const sms = await api.get_sms(self_id, 3, sign)

返回里多出 sms（短信内容）和 send_to（接收号码）：

{ result: { state: 1, code: 1 }, sign: 'NEW_SMS_SIGN', sms: '验证QQ',
  send_to: '10690700511', masked_phone: '166******00', country_code: '86' }

引导用户用密保手机把 sms 的内容原样发送到 send_to，发送后回查，不需要传 code：

const result = await api.check_sms(self_id, 3, sms.sign)

结果处理

两种类型一致：校验通过后服务端自动继续 NTLogin Type 2，返回结构与 login_account 一致；校验未通过则返回 CheckSMS 的原始响应，result.prompt 是原因，登录会话保留，可以用同一个 sign 重试。

身份验证所需数据

身份验证流程可能需要账号当前使用的协议与设备指纹：

const bots = await api.get_bot_list()
const bot = bots.find(item => item.self_id === self_id)

const protocols = await api.get_protocol_list()
const protocol = protocols[bot.protocol_id]

const profiles = await api.get_device_profile_list()
const deviceProfile = profiles.find(
  item => item.id === bot.device_profile_id,
)

缓存登录

先检查缓存：

const cache = await api.check_cache(self_id)
// { valid: true | false }

缓存有效时：

const result = await api.cache_login(self_id)

成功：

{ code: 0, message: '登录成功' }

失败时可能返回：

{ code: 1, message: '...', cache_invalid: true }

cache_invalid 为 true 时，改用 login_account。