03 · 报时任务详解
目标:掌握任务五步编辑器、九种时间规则和失败处理,配出可靠的定时发送。
📋 任务列表
列表字段:状态、任务名、机器人、目标群、时间规则、模板、下次执行、最后结果和操作。
⚠️ 新建任务默认为停用状态,确认配置无误后再启用,避免半成品配置直接群发。
🧩 五步编辑器
第 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 步 · 内容规则
默认模板+工作日 周末 法定节假日替换模板(可只填默认)。
每个计划时间只发送一次,按优先级选第一个可用模板:
群组覆盖 → 特殊日期 → 法定节假日 → 工作日/周末 → 时段主题 → 默认模板。想一次发"文字+图片+语音",请在模板中组合多个消息段(见
04-模板与变量.md),而不是配多个模板。
第 5 步 · 失败处理
错误分四类:
临时错误(超时、网络):自动重试。
内容错误(文件缺失、格式不支持):直接降级。
权限错误(不在群、被禁言):不重试,记录并提示。
配置错误(模板变量无效):标记异常。
默认策略:首次发送 → 等 3 秒重试 → 等 10 秒重试 → 执行降级。
降级链示例:
TTS 语音 → 文字
本地语音 → 文字
音乐卡片 → 歌名+时间文字
天气失败 → 去掉天气的基础报时
降级发送会在记录中标记为 降级成功,不会伪装成完全成功。
底部操作:取消 保存为停用 保存并启用 / 立即测试。
▶️ 立即执行与测试
| 操作 | 区别 |
|---|---|
| 立即测试 | 可模拟时间、星期、天气等变量,只发往你明确选择的单个群;写入日志但标为 test,不影响正式任务计划 |
| 立即执行 | 用真实时间和真实数据马上跑一次任务,遵守群开关、权限与限速 |
测试面板会显示最终渲染结果,并明确提示"这会真实向 QQ 群发送消息"。
💡 时间规则的法定调休识别依赖节假日日历,维护方法见
06-扩展内容.md。