cache_login

使用保存的会话缓存登录。

适用协议

Android（手机 / 平板）/ Linux QQ；需要当前账号、当前协议的有效登录缓存。

调用方式

{
  "type": "action",
  "id": "cache_login-1",
  "action": "cache_login",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0
  }
}

参数

参数	类型	必填	说明
self_id	number	是	当前框架内的 QQ 号，5–10 位整数。
protocol_id	number	是	账号实例的协议 ID；必须显式提供，0 是有效 ID。用 get_protocol_list 查询，不使用 client_type 替代。

返回值

data 的基本字段为 code: number、message: string、next: string。

next	后续步骤
done	登录完成
slider	用 slider_url 完成验证，再调用 submit_slider
security	按 security_verify 或 get_security_verify_methods 的可用方式继续
identity	使用 identity_url 开始身份验证
qr	Linux 扫码登录，轮询 query_login_qr
failed	本次登录失败，读取 code/message

验证分支按实际响应附加 slider_url、identity_url、security_url、security_verify 或 security_verify_error。外层 ok: true 只表示调用已返回结果，不能代替登录成功判断。

缓存失败分支可带 cache_invalid: boolean，区分缓存失效与其他失败；没有缓存时为 false。

注意事项

账号必须离线。缓存不存在或服务端拒绝时仍需检查 data.code/data.next，不要只看外层 ok。