koishi-plugin-ll-schedule 1.4.2 → 1.5.0

package/index.js

@@ -24,6 +24,9 @@ exports.usage = `定时提醒：每个任务一个大文本框(schedule)。每
 内容支持 Markdown 卡片、模板变量 {date} {time} {week} {task}
 
 群命令：订阅 任务名 / 取消订阅 任务名 / 订阅列表 / schedule.list / schedule.groups / schedule.test 任务名 / schedule.testcur 任务名(只发当前群) / 我的ID
+
+推送接口：POST /ll-schedule/push  {"secret":"密钥","task":"任务名","place1":"xxx","delay":0}
+
 `
 
 // ===== 纯函数（可单测） =====
@@ -173,6 +176,25 @@ function renderText(text, ctx) {
     .replace(/\{task\}/g, ctx.task)
 }
 
+// 接口推送默认模板（任务没配 pushTemplate 时用）
+const DEFAULT_PUSH_TEMPLATE = [
+  '# 🎉 {task}开始啦！',
+  '',
+  '> 地点1：{place1}',
+  '> 地点2：{place2}',
+  '{time}',
+].join('\n')
+
+// 渲染接口推送模板：body 里除 secret/task/delay 外的字段都可作为变量 {字段名} 填入
+// 然后走 renderText 处理内置变量 {date} {time} {week} {task}
+function renderPushTemplate(tpl, data, builtin) {
+  let out = String(tpl || DEFAULT_PUSH_TEMPLATE)
+  for (const [k, v] of Object.entries(data || {})) {
+    out = out.split('{' + k + '}').join(v === undefined || v === null ? '' : String(v))
+  }
+  return renderText(out, builtin)
+}
+
 // 组装 markdown：文本 + 图片
 function buildMd(text, image) {
   let md = String(text || '').trim()
@@ -195,7 +217,7 @@ function buildTextFromMd(md) {
     .trim()
 }
 
-exports._test = { parseTimes, todayDay, parseDays, dayMatches, parseScheduleBlocks, parseScheduleRows, computeFires, renderText, buildMd, buildTextFromMd }
+exports._test = { parseTimes, todayDay, parseDays, dayMatches, parseScheduleBlocks, parseScheduleRows, computeFires, renderText, renderPushTemplate, buildMd, buildTextFromMd }
 
 // ===== 配置 Schema =====
 
@@ -210,6 +232,10 @@ const TaskItem = Schema.object({
   markdown: Schema.boolean()
     .default(false)
     .description('用 QQ官方 Markdown 卡片发送（仅官方QQ机器人生效，失败自动回退纯文本；其他平台始终纯文本）'),
+  pushTemplate: Schema.string()
+    .role('textarea', { rows: [3, 8] })
+    .default('')
+    .description('接口推送模板（可选）：HTTP 接口推送时套用的卡片模板。变量 {place1} {place2} 等 = 推送方传入的字段；留空用默认模板。多行 markdown，例见 usage'),
   enabled: Schema.boolean()
     .default(true)
     .description('是否启用'),
@@ -219,6 +245,9 @@ const Config = Schema.object({
   tasks: Schema.dict(TaskItem)
     .default({})
     .description('📋 推送任务表格（键=任务名；每个任务 = 一个日程大文本框 schedule：星期/时间/内容）'),
+  pushSecret: Schema.string()
+    .default('')
+    .description('🔑 HTTP 推送接口密钥：外部系统调用 POST /ll-schedule/push 时须携带相同 secret（留空则接口拒绝所有推送）'),
   subscribeAuthority: Schema.number()
     .min(1).max(4).default(1)
     .description('执行订阅命令所需的最低权限等级（Koishi 用户权限等级，与QQ群主/管理员身份无关；默认 1=所有人都能订阅。如需限制，先在控制台"用户管理"给指定账号提权，再调高此值）'),
@@ -517,6 +546,57 @@ function apply(ctx, config) {
     }
   }
 
+  // ===== HTTP 推送接口：外部系统 POST 数据 → 转为卡片发给该任务订阅群 =====
+  if (ctx.router) {
+    ctx.router.post('/ll-schedule/push', async (ctx) => {
+      const respond = (status, body) => { ctx.status = status; ctx.body = body }
+      let body = null
+      try {
+        body = (typeof ctx.request.body === 'string') ? JSON.parse(ctx.request.body) : (ctx.request.body || {})
+      }
+      catch (e) {
+        return respond(400, { ok: false, error: 'invalid json body' })
+      }
+      // 密钥校验（未配置密钥则一律拒绝）
+      if (!config.pushSecret) return respond(403, { ok: false, error: 'pushSecret not configured' })
+      if (body.secret !== config.pushSecret) return respond(403, { ok: false, error: 'invalid secret' })
+
+      const taskName = String(body.task || '')
+      const task = (config.tasks || {})[taskName]
+      if (!taskName || !task) return respond(404, { ok: false, error: `task "${taskName}" not found` })
+
+      // 除 secret/task/delay 外的字段都作为模板变量（place1/place2/time/...）
+      const data = { ...body }
+      delete data.secret
+      delete data.task
+      delete data.delay
+      const now = new Date()
+      const rendered = renderPushTemplate(task.pushTemplate, data, {
+        date: todayStr(now),
+        time: nowHM(now),
+        week: '星期' + WEEK_CN[todayDay(now)],
+        task: taskName,
+      })
+      if (!rendered.trim()) return respond(400, { ok: false, error: 'empty content' })
+
+      const delay = Math.max(0, parseInt(body.delay, 10) || 0)
+      const push = async () => {
+        // 只发给订阅群（含手动 groups），不发全量已知群
+        await sendTask(taskName, task, { text: rendered, markdown: task.markdown })
+      }
+      if (delay > 0) {
+        setTimeout(push, delay * 60 * 1000)
+        logger.info(`[schedule] 接口已接收任务 "${taskName}"，${delay} 分钟后推送`)
+      }
+      else {
+        await push()
+        logger.info(`[schedule] 接口已推送任务 "${taskName}"`)
+      }
+      return respond(200, { ok: true, delay, task: taskName })
+    })
+    logger.info('[schedule] HTTP 推送接口已注册: POST /ll-schedule/push')
+  }
+
   async function checkAndSend() {
     const now = new Date()
     const today = todayStr(now)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-ll-schedule",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Scheduled message sender with weekly slots (per-day time & content), QQ official markdown card support",
   "main": "index.js",
   "files": [
@@ -25,3 +25,4 @@
 
 
 
+