koishi-plugin-scheduled-reminder

定时群提醒插件。你可以配置多条 Cron 任务，把固定文案发送到多个频道，并为单条任务附带一张本地图片。

依赖说明

本插件依赖 koishi-plugin-cron 提供的 ctx.cron()。

• 如果没有配置任何有效任务，插件不会注册任何调度。
• 如果配置了任务但当前没有可用的 cron 服务，插件会记录一条 warning，然后跳过所有任务注册。
• 单条任务的 Cron 表达式无效时，只会 warning 该任务，不会影响后续任务继续注册。

配置示例

plugins:
  scheduled-reminder:
    imageDirectory: data/scheduled-reminder-images
    tasks:
      - name: morning-checkin
        cron: '0 9 * * *'
        guilds:
          - '1234567890'
          - '9876543210'
        message: '早上好，记得打卡。'
        image: morning.png
      - name: evening-summary
        cron: '0 21 * * *'
        guilds:
          - '1234567890'
        message: '晚间总结时间。'
        image: /opt/qqbot/reminders/evening.jpg
      - name: text-only
        cron: '*/30 * * * *'
        guilds:
          - '1234567890'
        message: '半小时提醒一次。'

频道 ID 说明

这里的目标 ID 填的是 Koishi 看到的 guildId 或 channelId，不是传统 QQ 群号。最稳妥的做法是用 inspect 或日志确认机器人实际收到的频道 ID。

图片规则

• image 留空或只填空白时，插件只发送文本。
• image 是绝对路径时，直接读取这个文件。
• image 是相对路径时，会基于 imageDirectory 解析。
• 图片文件存在且可读取时，会发送图片 + 文本组合消息。
• 图片路径能解析但文件不存在、不可读或读取失败时，插件会记录 warning，并自动回退为纯文本发送。