Skip to content

读取等级任务计划

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

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

参数

参数类型必填说明
self_idnumberQQ 号,必须是框架已配置账号
client_typestring明确填写 android 或 linuxqq;等级加速目前只支持 android,linuxqq 返回不支持

示例

javascript
const result = await api.get_level_task_settings({ self_id: 123456, client_type: "android" })

返回

返回 { selectedTasks, scheduleEnabled, scheduleTime, lastRunDate }。未保存时默认为 [] / false / "04:00" / ""。从框架 SQLite 读取,离线也可用。lastRunDate 是框架调度器记录的执行日期,只读。

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

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

调用前必读

协议与使用指南

无需账号协议
适用协议
无需账号协议
使用前准备
插件服务必须先使用框架服务 Token 完成 WebSocket 认证。当前契约不使用 system_management 开关或 allowed_actions 逐项授权。

建议搭配

常见失败原因

  • 服务 Token 无效或 WebSocket 连接已断开
  • 插件与框架 management_api_version 不匹配
  • 目标节点、账号或协议状态不符合管理操作要求

注意事项

  • 这是跨节点或框架级管理能力;服务端必须以服务 Token 认证为边界,不能依赖前端按钮显隐,所有变更都应记录审计日志。
  • 查询结果可能受 QQ 服务端分页、缓存与权限影响,不应假设一次调用返回全部数据。

萌卡NT 开发文档