koishi-plugin-ll-schedule 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,16 @@
+name: Publish to npm
+on:
+  push:
+    branches: [master]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/index.js

@@ -0,0 +1,138 @@
+const { Schema, h } = require('koishi')
+
+// 定时任务项
+const TaskItem = Schema.object({
+  time: Schema.string()
+    .required()
+    .description('发送时间，HH:MM 格式（24小时制），如 08:30、21:00'),
+  groups: Schema.array(Schema.string())
+    .default([])
+    .description('目标群号（留空=所有群）'),
+  text: Schema.string()
+    .default('')
+    .description('文字内容（可留空）'),
+  image: Schema.string()
+    .default('')
+    .description('图片URL（可留空）'),
+  enabled: Schema.boolean()
+    .default(true)
+    .description('是否启用'),
+})
+
+const Config = Schema.object({
+  tasks: Schema.dict(TaskItem)
+    .default({})
+    .description('📋 定时任务表格（键=任务名）'),
+})
+
+function apply(ctx, config) {
+  // 记录当天已发送的任务，防止同一分钟重复发
+  let firedToday = {}
+
+  function nowHM() {
+    const d = new Date()
+    return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`
+  }
+
+  function todayStr() {
+    const d = new Date()
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`
+  }
+
+  async function checkAndSend() {
+    const today = todayStr()
+    // 跨天重置
+    if (firedToday.date !== today) {
+      firedToday = { date: today }
+    }
+
+    const hm = nowHM()
+    const tasks = config.tasks || {}
+
+    for (const [name, task] of Object.entries(tasks)) {
+      if (!task || task.enabled === false) continue
+      if (!task.time || task.time.trim() !== hm) continue
+      // 今天这个时间点已经发过这个任务 → 跳过
+      const fireKey = `${name}@${hm}`
+      if (firedToday[fireKey]) continue
+      firedToday[fireKey] = true
+
+      ctx.logger.info(`[schedule] 触发任务 "${name}" @ ${hm}`)
+      await sendTask(name, task)
+    }
+  }
+
+  async function sendTask(name, task) {
+    // 组装消息
+    const parts = []
+    if (task.text) parts.push(task.text)
+    if (task.image) {
+      if (parts.length) parts.push('\n')
+      parts.push(h.image(task.image))
+    }
+    if (!parts.length) {
+      ctx.logger.warn(`[schedule] 任务 "${name}" 没有文字也没有图片，跳过`)
+      return
+    }
+
+    const bots = ctx.bots || []
+    if (!bots.length) return
+
+    const groups = (task.groups && task.groups.length > 0) ? task.groups : null
+
+    for (const bot of bots) {
+      if (groups) {
+        for (const gid of groups) {
+          try { await bot.sendMessage(gid, parts) } catch (e) {
+            ctx.logger.error(`[schedule] 发送到群 ${gid} 失败: ${e.message}`)
+          }
+        }
+      } else {
+        ctx.logger.warn(`[schedule] 任务 "${name}" 未指定群号，跳过（请配置目标群）`)
+      }
+    }
+  }
+
+  // 每 20 秒检查一次（保证同一分钟内能触发）
+  const timer = setInterval(checkAndSend, 20000)
+  // 启动时立即检查一次
+  checkAndSend()
+
+  ctx.on('dispose', () => clearInterval(timer))
+
+  // ===== 命令 =====
+  ctx.command('schedule', '定时发送管理')
+    .action(() =>
+      '⚙️ 管理：插件设置页 → ll-schedule → tasks 表格\n' +
+      '命令：schedule.list 查看任务 | schedule.test <任务名> 立即测试发送'
+    )
+
+  ctx.command('schedule.list', '查看定时任务')
+    .action(() => {
+      const tasks = config.tasks || {}
+      const keys = Object.keys(tasks)
+      if (!keys.length) return '暂无定时任务\n请在插件设置页的 tasks 表格中添加'
+      return keys.map(k => {
+        const t = tasks[k]
+        const s = t.enabled === false ? '⛔' : '✅'
+        const content = [t.text && '文字', t.image && '图片'].filter(Boolean).join('+') || '(空)'
+        return `${s} ${k} @ ${t.time} → ${content} → 群:${(t.groups || []).join(',') || '未指定'}`
+      }).join('\n')
+    })
+
+  ctx.command('schedule.test <name>', '立即测试发送指定任务')
+    .action(async ({ session }, name) => {
+      const tasks = config.tasks || {}
+      const task = tasks[name]
+      if (!task) return `未找到任务 "${name}"，可用 schedule.list 查看任务名`
+      // 测试时：任务没配群就发到当前群
+      const testTask = { ...task }
+      if (!testTask.groups || !testTask.groups.length) {
+        testTask.groups = session.guildId ? [String(session.guildId)] : []
+      }
+      await sendTask(name, testTask)
+      return `✅ 已发送任务 "${name}"`
+    })
+}
+
+module.exports = { Config, apply }

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "koishi-plugin-ll-schedule",
+  "version": "1.0.0",
+  "description": "Scheduled message sender with text/image support",
+  "main": "index.js",
+  "license": "MIT",
+  "keywords": ["koishi", "koishi-plugin", "schedule", "timer", "定时"],
+  "peerDependencies": {
+    "koishi": "^4.18.0"
+  },
+  "koishi": {
+    "description": {
+      "zh": "定时发送插件。设置时间后自动发送文字/图片到指定群。",
+      "en": "Scheduled message sender. Auto-send text/image to groups at set times."
+    }
+  }
+}