用途:在 QQ 通道下为用户注册真正的定时提醒,替代无效的口头承诺。
主要能力:支持一次性提醒(schedule.kind 为 at,使用绝对毫秒时间戳 atMs)与周期性提醒(schedule.kind 为 cron,使用 cron 表达式并指定 tz),以及查询(action: list)、删除(先 list 取 jobId,再 action: remove)。修改需删除后重建。
必要规则:payload.kind 必须为 agentTurn,不能用 systemEvent;payload.deliver 为 true;payload.channel 为 qqbot;payload.to 为用户 openid(群聊格式 group:{group_openid});sessionTarget 为 isolated。一次性任务加 deleteAfterRun: true,周期任务不加。周期提醒必须带 "tz": "Asia/Shanghai"。
用法:一次性提醒用 schedule.at + atMs(当前时间戳毫秒 + 延迟毫秒),不写系统命令,仅调用 cron 工具并传入对应 action 与 job 字段。周期提醒用 schedule.cron + expr,例如每天 8 点 "0 8 * * *"、工作日 9 点 "0 9 * * 1-5"、每小时整点 "0 * * * *"。查询用 { "action": "list" },删除用 { "action": "remove", "jobId": "{id}" }。
适用场景:QQ 用户提出「提醒」「闹钟」「定时」「X 分钟/小时后」「每天 X 点」「叫我」等延时或定时请求;纯相对时间可直接计算,时间模糊或缺失需追问。
限制:无内存或后台线程,只能靠 cron 工具注册;atMs 必须是绝对毫秒时间戳,不支持 "5m" 等相对字符串;systemEvent 不会发出 QQ 消息。其他平台支持与价格等资料暂未提供。