Skip to content

execute_level_tasks

按数组顺序执行指定的 QQ 等级加速任务。

调用

js
await api.execute_level_tasks(self_id, tasks)

参数

参数类型必填说明
self_idnumber在线 Bot QQ 号
tasksstring[]非空任务标题数组

框架会在执行前强制查询当前 QQ 等级,等级必须达到 16 级。低于 16 级时请求会被拒绝,任务不会执行;该限制同样应用于能够直接完成对应等级任务的原始 API,不能通过绕开本接口规避。

当前支持的任务标题:

  • 去日签卡打一次卡
  • 每日登录QQ经典农场
  • 去免费小说看任一本书
  • 体验任一款小游戏15s
  • 看10秒漫剧
  • 发布一条空间说说
  • 点赞一条好友动态
  • 加一位好友
  • 去QQ会员福利社领福利券

建议从 get_level_tasks 返回的任务中选择标题。任务在本次调用内按数组顺序执行;任一任务报错时 Promise 会拒绝并包含任务标题。

返回值

全部执行成功时 Promise 解析为 null

v2.1.0:电脑 QQ 在线

电脑QQ在线 已支持手动补挂和框架定时计划。目标仍传在线安卓账号的 self_idclient_type: 'android';框架使用同 QQ 安卓会话授权 Linux 免扫登录。已有 Linux 在线会话直接复用,已有账号的节点和设备不被覆盖;没有 Linux 账号时,框架生成独立设备配置并沿用安卓账号的登录节点创建 Linux 账号。

登录成功只表示开始或继续累计电脑在线时长,不会将任务强行标记完成。加速与完成状态以 QQ 返回的任务面板为准。安卓离线、授权拒绝、二维码过期或登录失败都会返回错误;请查看账号状态和日志,必要时从账号页人工扫码完成验证。框架已有等级门槛、任务过滤和计划执行规则继续生效。

javascript
const result = await api.execute_level_task_selection({
  self_id: 123456, client_type: 'android', tasks: ['电脑QQ在线']
})
// refreshed=false 时说明执行后的面板刷新失败,不要自动重放任务。
if (!result.refreshed) console.warn(result.refreshError)

调用前必读

协议与使用指南

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;务必显式选择协议,避免把操作发送到错误会话。

萌卡NT 开发文档