Skip to content

报时任务详解 ​

目标:掌握任务五步编辑器、九种时间规则和失败处理,配出可靠的定时发送。

📋 任务列表 ​

列表字段包括:状态、任务名、机器人、目标群、时间规则、模板、下次执行、最后结果和操作。

默认停用

新建任务默认为 停用 状态,确认配置无误后再启用,避免半成品配置直接群发。

🧩 五步编辑器 ​

第 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 群发送消息」。

排查建议

任务没有按时发送时,先到发送记录查状态与错误原因,再用「立即测试」复现;时间规则的法定调休识别依赖节假日日历,维护方法见扩展内容。


📚 下一节:模板与变量

薇薇官机平台 · ZL 系列插件