Skip to content

保存等级任务计划

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

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

参数

参数类型必填说明
self_idnumberQQ 号,必须是框架已配置账号
client_typestring明确填写 android 或 linuxqq;等级加速目前只支持 android,linuxqq 返回不支持
selected_tasksstring[]选择的任务标题;可传 [] 清空,去空白、去重,最多 100 项
schedule_enabledboolean是否启用框架定时执行;false 必须原样保留
schedule_timestring框架主机本地时间,严格 HH:mm,例如 04:00

示例

javascript
const result = await api.update_level_task_settings({ self_id: 123456, client_type: "android", selected_tasks: [], schedule_enabled: false, schedule_time: "04:00" })

返回

返回保存后的 { selectedTasks, scheduleEnabled, scheduleTime, lastRunDate }。这是完整设置替换,三项均必填;不修改 lastRunDate,不接受由插件指定执行日期。保存操作不执行任务,框架现有调度器使用该计划。

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

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

调用前必读

协议与使用指南

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

建议搭配

常见失败原因

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

注意事项

  • 这是跨节点或框架级管理能力;服务端必须以服务 Token 认证为边界,不能依赖前端按钮显隐,所有变更都应记录审计日志。

萌卡NT 开发文档