qqbot-cron

QQ Bot 智能提醒

让 AI 帮用户设置、管理定时提醒，支持私聊和群聊。

---

⛔ 最重要的一条规则（读三遍）

调用 cron 工具时，payload.kind 必须是 "agentTurn"。绝对不能用 "systemEvent"！

systemEvent 只会在 AI 会话里插入一条文本，用户根本收不到 QQ 消息。 只有 agentTurn + deliver: true + channel: "qqbot" + to 才能真正把消息发到 QQ。

---

🤖 AI 决策指南

时间确认规则

设置提醒前，先确认当前系统时间（查看上下文中的时间信息，或执行 date）。 纯相对时间（"5分钟后"、"1小时后"）可以跳过确认，直接算 Date.now() + 延迟毫秒。

用户意图识别

用户说法	意图	cron 工具 action
"5分钟后提醒我喝水"	创建一次性提醒	add（schedule.kind=at）
"每天8点提醒我打卡"	创建周期提醒	add（schedule.kind=cron）
"我有哪些提醒"	查询	list
"取消喝水提醒"	删除	remove
"修改提醒时间"	删除+重建	remove → add
"提醒我" (无时间)	需追问	询问具体时间

必须追问的情况

1. 没有时间："提醒我喝水" → "请问什么时候提醒你？"
2. 时间模糊："晚点提醒我" → "具体几点呢？"
3. 周期不明："定期提醒我" → "多久一次？每天？每周？"

---

📋 创建提醒（最重要）

🚨🚨🚨 工具调用参数模板（AI 必须严格遵循）

AI 调用 cron 工具时，传的是 JSON 参数，不是 CLI 命令。以下是唯一正确的 JSON 格式：

一次性提醒（N 分钟后）：

{
  "action": "add",
  "job": {
    "name": "{任务名}",
    "schedule": {
      "kind": "at",
      "atMs": {当前时间戳毫秒 + N分钟*60000}
    },
    "sessionTarget": "isolated",
    "wakeMode": "now",
    "deleteAfterRun": true,
    "payload": {
      "kind": "agentTurn",
      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀",
      "deliver": true,
      "channel": "qqbot",
      "to": "{openid}"
    }
  }
}

周期提醒（每天/每周）：

{
  "action": "add",
  "job": {
    "name": "{任务名}",
    "schedule": {
      "kind": "cron",
      "expr": "0 8 * * *",
      "tz": "Asia/Shanghai"
    },
    "sessionTarget": "isolated",
    "wakeMode": "now",
    "payload": {
      "kind": "agentTurn",
      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀",
      "deliver": true,
      "channel": "qqbot",
      "to": "{openid}"
    }
  }
}