level_task_management

管理当前账号的等级任务设置、每日调度与执行结果。

适用协议

Android（手机 / 平板）；电脑在线任务可关联同 QQ 的 Linux 实例。

调用方式

{
  "type": "action",
  "id": "level_task_management-1",
  "action": "level_task_management",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "operation": "status"
  }
}

参数

参数	类型	必填	说明
self_id	number	是	当前框架内的 QQ 号，5–10 位整数。
protocol_id	number	是	账号实例的协议 ID；必须显式提供，0 是有效 ID。用 get_protocol_list 查询，不使用 client_type 替代。
operation	string	是	status、settings、panel 或 run。
tasks	string[]	按操作	settings 必填，run 可选；任务名称来自 status.supported_tasks，最多 100 项。
schedule_enabled	boolean	settings 必填	是否启用每日自动执行；允许 tasks 为 []，空计划不会执行任务。
schedule_time	string	settings 必填	上海时间（UTC+8），24 小时 HH:mm。
refresh	boolean	否	仅 panel 使用，默认 false；true 强制重新获取任务面板。
pc_protocol_id	number	否	涉及电脑在线任务时，可指定同 QQ 已存在的 Linux QQ 实例协议 ID；省略时自动选择。

返回值

status、settings、run 返回任务状态：

字段	类型	说明
settings	object	selected_tasks、schedule_enabled、schedule_time、last_run_date、可选 pc_protocol_id
status	string	当前任务运行状态，如 idle、running、completed、failed
results	array	每项为 task、success、status 和失败时的 error；只有 status=confirmed 才表示已确认完成。
started_at、finished_at	string	最近执行的开始／结束时间
supported_tasks	string[]	此账号当前可调用的任务名称
membership_tasks	array	会员任务的资格与执行状态

panel 返回 { payload, state, cached }：payload 为等级任务面板数据，state 为上述状态；cached 表示是否复用服务器本地同一天的面板。

注意事项

status 可以读取离线账号。settings、panel、run 的任务执行器支持 Android；允许先保存空任务列表并设置时间。此插件 API 的所有操作均须满足下方权益条件。框架管理员页面仍可读取已保存计划和关闭已有定时，不代表插件可以绕过本接口的限制。

电脑在线任务自动匹配同 QQ 的 Linux 账号。没有匹配实例时，执行任务时复用安卓账号的密码、设备信息创建 Linux 3.2.32 账号并尝试免扫登录；保存配置不会创建账号。需要明确指定已有实例时使用 pc_protocol_id。

run 最长执行 15 分钟。检查 results 中每项的 success、status、error；仅请求提交成功不代表已获得加速。元宝任务以 QQ 面板确认结果为准。账号离线、会话改变或取消执行会终止对应流程。

操作规则

operation	允许参数	行为
status	self_id、protocol_id	不接受任务设置或 refresh=true
settings	tasks、schedule_enabled、schedule_time、可选 pc_protocol_id	原子保存完整调度设置，不接受 refresh=true
panel	可选 refresh	不接受 tasks、调度设置或 pc_protocol_id
run	可选 tasks、pc_protocol_id	tasks 省略时采用已保存选择；不接受调度设置或 refresh=true

任务名称应从当前 status 响应选择，不能将所有旧版本任务名称当成可用项。保存每日调度示例：

{"self_id":123456789,"protocol_id":0,"operation":"settings","tasks":["去日签卡打一次卡"],"schedule_enabled":true,"schedule_time":"04:00"}

执行前应确认该任务存在于当前账号的 supported_tasks 中。

调用条件

Free 不可调用。Plus 每次调用核对当前 QQ 最新等级，至少需要 32 级；Pro 不设这项 QQ 等级门槛。仍需满足当前授权及接口本身的业务条件，获取最新等级失败时不继续操作。