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。

共 12 篇 ZL-自定义报时 / 报时任务详解 0 字 0 行 zhangxiaolin
创建 2026-09-29T06:02:41.615770070Z 更新 2026-09-29T06:02:54.265953080Z