报时任务详解
目标:掌握任务五步编辑器、九种时间规则和失败处理,配出可靠的定时发送。
📋 任务列表
列表字段包括:状态、任务名、机器人、目标群、时间规则、模板、下次执行、最后结果和操作。
默认停用
新建任务默认为 停用 状态,确认配置无误后再启用,避免半成品配置直接群发。
🧩 五步编辑器
第 1 步 · 基本信息
填写任务名、启用开关、说明和颜色标签。任务名建议带用途,如「整点问候」「周末晚报」,便于在列表和发送记录中辨认。
第 2 步 · 发送范围
发送范围支持三种指定方式:
- 指定一个机器人和一个 / 多个群。
- 指定机器人管理的全部已启用群。
- 可配置备用机器人:主 Bot 离线且备用 Bot 在群内时接管发送。
机器人绑定
任务必须绑定明确的机器人;主 Bot 离线时不会自动换号发送,避免身份混乱。多机器人同框架时,务必确认所选 Bot 真的在目标群里。
第 3 步 · 时间规则(九选一)
| 类型 | 示例 | 说明 |
|---|---|---|
| 整点 | 每小时第 0 分 | 分钟填 0–59,可配合每日允许时段 |
| 半点 | 每小时第 30 分 | 可与整点任务并存 |
| 间隔 | 每 30 分钟 | 以每日起始时间对齐 |
| 多时间点 | 08:00, 12:30, 18:00 | 同一任务维护多个时间 |
| 每天 | 每天 07:30 | 固定时间 |
| 工作日 | 周一至周五 08:00 | 默认按星期判断,启用节假日日历后可识别法定调休 |
| 周末 | 周六、周日 | 可绑定周末专用模板 |
| 每周 | 每周一、三、五 | 多选星期 |
| 指定日期 | 2026-10-01 00:00 | 用于活动、纪念日一次性报时 |
通用限制:开始 / 结束日期、每日允许时段、静默时段、时区、错过补发窗口(默认 10 分钟,可设 0–120 分钟)。
槽位扫描机制
插件每 15 秒扫描一次「计划槽位」而不是卡秒判断,电脑短暂阻塞或休眠恢复后不会漏发;超过补发窗口的计划自动放弃,不会集中刷屏。
第 4 步 · 内容规则
- 默认模板+工作日 / 周末 / 法定节假日替换模板(可只填默认)。
- 每个计划时间 只发送一次,按优先级选第一个可用模板:
text
群组覆盖 → 特殊日期 → 法定节假日 → 工作日/周末 → 时段主题 → 默认模板- 想一次发「文字+图片+语音」,请在模板中组合多个消息段(见模板与变量),而不是配多个模板。
第 5 步 · 失败处理
错误按四类区分:
| 错误类型 | 典型场景 | 处理方式 |
|---|---|---|
| 临时错误 | 超时、网络 | 自动重试 |
| 内容错误 | 文件缺失、格式不支持 | 直接降级 |
| 权限错误 | 不在群、被禁言 | 不重试,记录并提示 |
| 配置错误 | 模板变量无效 | 标记异常 |
默认策略:首次发送 → 等 3 秒重试 → 等 10 秒重试 → 执行降级。
降级链示例:
| 发送内容 | 降级后 |
|---|---|
| TTS 语音 | 文字 |
| 本地语音 | 文字 |
| 音乐卡片 | 歌名+时间文字 |
| 天气 | 去掉天气的基础报时 |
降级发送会在记录中标记为 降级成功,不会伪装成完全成功。
编辑器底部操作:取消 / 保存为停用 / 保存并启用 / 立即测试。
▶️ 立即执行与测试
| 操作 | 与正式发送的区别 |
|---|---|
| 立即测试 | 可模拟时间、星期、天气等变量,只发往你明确选择的单个群;写入日志但标为 test,不影响正式任务计划 |
| 立即执行 | 用真实时间和真实数据马上跑一次任务,遵守群开关、权限与限速 |
测试面板会显示最终渲染结果,并明确提示「这会真实向 QQ 群发送消息」。
📚 下一节:模板与变量
