Skip to content

执行等级任务并刷新面板

从 v2.0.9 起提供;v2.0.8 及更早版本不包含此接口。

通过完成令牌认证的插件 WebSocket 服务调用 execute_level_task_selection

参数

参数类型必填说明
self_idnumberQQ 号,必须是框架已配置账号
client_typestring明确填写 android 或 linuxqq;等级加速目前只支持 android,linuxqq 返回不支持
tasksstring[]显式任务标题数组;省略或 [] 使用框架已选任务,若没有可执行已选项则补挂当前全部可执行未完成任务

示例

javascript
const result = await api.execute_level_task_selection({ self_id: 123456, client_type: "android", tasks: ["完成视频任务获得加速时长"] })

返回

返回 { tasks, skippedTasks, payload, refreshed, refreshError }。tasks 是实际提交执行的标题,skippedTasks 是显式请求中被过滤的标题,payload 是完成后的面板。已完成、付费、协议不可执行及不支持的任务均过滤。若执行成功但刷新失败,refreshed=false,保留执行前面板并返回 refreshError;请刷新面板,禁止据此自动重新执行。执行本身失败返回原 action 错误,不自动重试。

以上返回值是 WebSocket action_result.data;失败为 ok:falseerror。SDK 自动解包 data 并在失败时拒绝 Promise。

详见共享等级任务管理接入

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)

v2.1.0:会员签到

等级任务页面在“额外任务”后新增“会员签到”。会员成长值单独展示,不并入 QQ 加速天数;每项任务都有独立自动执行开关,默认关闭,保存后与现有计划共用框架调度器。

任务说明
QQ会员公众号签到使用本账号会员登录态执行活动
QQ会员每日签到原活动已结束,保留说明并禁用操作
超级会员成长储值奖励官网已公告活动下线,保留说明并禁用操作
QQ大会员官网签到完成签到后提交会员任务
分享QQ大会员官网活动接收者为本账号,完成后提交会员任务
QQ大会员师徒打卡需满足对应会员与师徒活动条件,业务拒绝如实显示
浏览QQ空间访客页面访问本账号访客页面并提交任务
QQ大会员空间专属点赞发布仅自己可见、24 小时后自动删除的说说,再执行大会员特效点赞
QQ音乐绿钻每日签到使用本账号音乐登录态调用会员接口,实际成长值以音乐会员页面为准

共享面板新增 payload.member_info.member_task_list。每项包含 titlecategory: 'membership'membership_groupavailablecan_executeis_donestatus_textexecution_messageattempted_today。不要把会员任务计入 QQ 加速天数。

javascript
const panel = await api.get_level_task_panel({
  self_id: 123456, client_type: 'android', refresh: false
})
const rows = panel.payload?.member_info?.member_task_list || []

// 手动执行明确选择的一项。
const result = await api.execute_level_task_selection({
  self_id: 123456, client_type: 'android', tasks: ['QQ会员公众号签到']
})
if (result.refreshed === false) console.warn(result.refreshError)

update_level_task_settings.selected_tasks 使用相同任务名称保存自动计划。设置操作会替换选中列表,请先读取旧设置再修改,避免覆盖已有等级任务。未选择会员任务的旧计划不会自动开启新项目。

执行记录保存在框架数据库。当天成功的项目不会重放;中断、超时或结果不明确时显示“待核对”,当天停止自动重试。多步骤任务保留已完成步骤,避免重复发说说。明确失败可核对原因后手动执行;定时计划同一天不反复尝试。接口执行成功不承诺固定成长值到账。

调用前必读

协议与使用指南

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