Linux QQ API 使用范围

Linux QQ 与 Android 共用接口调用格式，通过 self_id + protocol_id 区分账号。同一 QQ 使用不同协议时，各实例分别管理登录状态与设备指纹。

选择协议

先调用 get_protocol_list，选取 Linux 项返回的配置 ID，再传入账号接口。不要使用数组下标或 client_type 替代 protocol_id。

{
  "type": "action",
  "id": "groups-1",
  "action": "get_group_list",
  "params": { "self_id": 123456789, "protocol_id": 1 }
}

示例中的 1 仅用于说明，请替换为实际配置 ID。

登录

Linux 支持密码与二维码登录；已有有效缓存时可使用缓存登录。接口及后续验证步骤见账号登录流程。

业务接口

消息、好友、群聊和媒体接口的支持范围见各接口正文。仅支持 Android 的操作不能通过选择 Linux 协议调用；不支持的操作返回错误或明确的跳过结果，不能当作成功。

get_level_tasks 对 Linux 返回跳过结果。等级任务中的“电脑 QQ 在线”使用对应的 Linux 实例，不表示 Linux 账号能够执行 Android 等级任务。

事件与消息标识

事件使用 self_id 与 protocol_id 标识来源，详见事件参考。消息缓存、引用编号和插件业务状态应按账号与协议隔离，不能只以 QQ 号作为唯一键。