koishi-plugin-ll-schedule 1.5.1 → 1.6.1

package/index.js

@@ -23,7 +23,13 @@ exports.usage = `定时提醒：每个任务一个大文本框(schedule)。每
 星期：周一/周六/每天/工作日/周末/1,3,5   时间：12:20, 18:20, 21:20（可多个）
 内容支持 Markdown 卡片、模板变量 {date} {time} {week} {task}
 
-群命令：订阅 任务名 / 取消订阅 任务名 / 订阅列表 / schedule.list / schedule.groups / schedule.test 任务名 / schedule.testcur 任务名(只发当前群) / 我的ID
+群命令：
+  订阅            → 列出可以订阅的推送
+  订阅 任务名      → 本群订阅
+  取消订阅         → 列出本群已订阅的推送
+  取消订阅 任务名   → 本群取消订阅
+  订阅列表 / schedule.list / schedule.groups / schedule.test 任务名 / schedule.testcur 任务名(只发当前群) / 我的ID
+管理员：schedule.unsuball 任务名（取消该任务全部群订阅并通知各群；填 all 清空全部）
 
 推送接口：POST /ll-schedule/push  {"secret":"密钥","task":"任务名","place1":"xxx","delay":0}
 
@@ -144,6 +150,25 @@ function parseScheduleRows(task) {
   return []
 }
 
+// 汇总时间段的中文概览（用于订阅清单显示）
+function summarizeRows(rows) {
+  if (!rows || !rows.length) return '不定时推送（有新内容时通知）'
+  const daily = rows.every(r => {
+    const w = String(r.wd || '').trim()
+    return !w || w === '每天' || w === '每日' || w === '天天'
+  })
+  if (daily) {
+    const times = []
+    for (const r of rows) {
+      for (const t of parseTimes(r.time)) if (!times.includes(t)) times.push(t)
+    }
+    return `每天 ${times.join(', ')}`
+  }
+  if (rows.length <= 3) return rows.map(r => `${r.wd || '每天'} ${r.time}`).join(' / ')
+  const head = rows.slice(0, 2).map(r => `${r.wd || '每天'} ${r.time}`).join(' / ')
+  return `${rows.length} 个时间段（${head} 等）`
+}
+
 // 计算"现在这一刻该发什么"：返回 [{ name, key, text, markdown, image }]
 function computeFires(tasks, date, hm) {
   const day = todayDay(date)
@@ -217,7 +242,7 @@ function buildTextFromMd(md) {
     .trim()
 }
 
-exports._test = { parseTimes, todayDay, parseDays, dayMatches, parseScheduleBlocks, parseScheduleRows, computeFires, renderText, renderPushTemplate, buildMd, buildTextFromMd }
+exports._test = { parseTimes, todayDay, parseDays, dayMatches, parseScheduleBlocks, parseScheduleRows, summarizeRows, computeFires, renderText, renderPushTemplate, buildMd, buildTextFromMd }
 
 // ===== 配置 Schema =====
 
@@ -248,6 +273,9 @@ const Config = Schema.object({
   pushSecret: Schema.string()
     .default('')
     .description('🔑 HTTP 推送接口密钥：外部系统调用 POST /ll-schedule/push 时须携带相同 secret（留空则接口拒绝所有推送）'),
+  unsubAllNotice: Schema.string()
+    .default('本群已取消「{task}」的推送')
+    .description('管理员用 schedule.unsuball 取消全部订阅时，发到每个被取消群的提示语（{task}=任务名；留空则不发送提示）'),
   subscribeAuthority: Schema.number()
     .min(1).max(4).default(1)
     .description('执行订阅命令所需的最低权限等级（Koishi 用户权限等级，与QQ群主/管理员身份无关；默认 1=所有人都能订阅。如需限制，先在控制台"用户管理"给指定账号提权，再调高此值）'),
@@ -737,24 +765,44 @@ function apply(ctx, config) {
       (config.subscribeAdminBypass ? '，或为本群群主/群管理' : '')
   }
 
-  function resolveSubscribeTaskName(taskName) {
+  // 列出所有可订阅的任务（含时间概览 + 本群是否已订阅）
+  function listSubscribable(session) {
     const tasks = config.tasks || {}
-    if (taskName) {
-      if (!tasks[taskName]) return { name: null, hint: `未找到任务 "${taskName}"，可用"订阅列表"或 schedule.list 查看任务名` }
-      return { name: taskName, hint: null }
-    }
     const names = Object.keys(tasks).filter(k => tasks[k] && tasks[k].enabled !== false)
-    if (names.length === 1) return { name: names[0], hint: null }
-    if (names.length === 0) return { name: null, hint: '暂无启用的任务，请先在插件设置页的 tasks 表格中添加' }
-    return { name: null, hint: `有多个任务，请指定任务名：${names.join(' / ')}` }
+    if (!names.length) return '暂无任何可订阅的推送（请在插件设置页的 tasks 里添加任务）'
+    const key = (session.bot && session.guildId) ? `${session.bot.sid}:${session.guildId}` : null
+    const lines = ['📋 可以订阅的推送：', '']
+    names.forEach((n, i) => {
+      const rows = parseScheduleRows(tasks[n])
+      const subbed = (key && subs.get(n) && subs.get(n).has(key)) ? '  ✅本群已订阅' : ''
+      lines.push(`${i + 1}. ${n} —— ${summarizeRows(rows)}${subbed}`)
+    })
+    lines.push('', `发送「订阅 任务名」即可订阅，例如：订阅 ${names[0]}`)
+    return lines.join('\n')
+  }
+
+  // 列出本群已订阅的任务
+  function listMySubs(session) {
+    const key = `${session.bot.sid}:${session.guildId}`
+    const mine = []
+    for (const [tn, m] of subs) {
+      if (m.has(key)) mine.push(tn)
+    }
+    if (!mine.length) return '本群还没有订阅任何推送\n发送「订阅」可查看有哪些可以订阅'
+    return '📋 本群已订阅：\n' + mine.map((n, i) => `${i + 1}. ${n}`).join('\n') +
+      '\n\n发送「取消订阅 任务名」可取消'
   }
 
   async function subscribeCurrentGroup(session, taskName) {
-    logger.info(`[schedule] 命令被调用: 订阅 taskName=${taskName || '(自动)'}`)
+    logger.info(`[schedule] 命令被调用: 订阅 taskName=${taskName || '(列表)'}`)
     if (!session.guildId || !session.bot) return '❌ 订阅只能在群聊里使用'
-    const { name, hint } = resolveSubscribeTaskName(taskName)
-    if (!name) return hint
-    const task = config.tasks[name]
+    // 不带任务名 → 直接列出可以订阅什么
+    if (!taskName) return listSubscribable(session)
+    const tasks = config.tasks || {}
+    if (!tasks[taskName]) return `未找到任务 "${taskName}"\n发送「订阅」可查看可以订阅的列表`
+    if (tasks[taskName].enabled === false) return `任务 "${taskName}" 已停用，暂时不能订阅`
+    const name = taskName
+    const task = tasks[name]
     const key = `${session.bot.sid}:${session.guildId}`
     const taskSubs = getTaskSubs(name)
     if (taskSubs.has(key)) return `ℹ️ 本群已在任务 "${name}" 的推送列表里`
@@ -763,21 +811,21 @@ function apply(ctx, config) {
     persistSub(name, entry)
     logger.info(`[schedule] 群 ${session.guildId} 已订阅任务 "${name}"`)
     const rows = parseScheduleRows(task)
-    return `✅ 本群已加入任务 "${name}" 的推送列表\n时间段：${rows.length} 个（schedule.list 查看详情）`
+    return `✅ 本群已订阅「${name}」\n时间：${summarizeRows(rows)}`
   }
 
   async function unsubscribeCurrentGroup(session, taskName) {
-    logger.info(`[schedule] 命令被调用: 取消订阅 taskName=${taskName || '(自动)'}`)
+    logger.info(`[schedule] 命令被调用: 取消订阅 taskName=${taskName || '(列表)'}`)
     if (!session.guildId || !session.bot) return '❌ 取消订阅只能在群聊里使用'
-    const { name, hint } = resolveSubscribeTaskName(taskName)
-    if (!name) return hint
-    const taskSubs = subs.get(name)
+    // 不带任务名 → 列出本群订阅了哪些
+    if (!taskName) return listMySubs(session)
+    const taskSubs = subs.get(taskName)
     const key = `${session.bot.sid}:${session.guildId}`
-    if (!taskSubs || !taskSubs.has(key)) return `ℹ️ 本群不在任务 "${name}" 的推送列表里`
+    if (!taskSubs || !taskSubs.has(key)) return `ℹ️ 本群没有订阅「${taskName}」\n发送「取消订阅」可查看本群已订阅的推送`
     taskSubs.delete(key)
-    removeSub(name, session.bot.sid, session.guildId)
-    logger.info(`[schedule] 群 ${session.guildId} 已取消订阅任务 "${name}"`)
-    return `✅ 本群已取消订阅任务 "${name}"`
+    removeSub(taskName, session.bot.sid, session.guildId)
+    logger.info(`[schedule] 群 ${session.guildId} 已取消订阅任务 "${taskName}"`)
+    return `✅ 本群已取消订阅「${taskName}」`
   }
 
   ctx.command('订阅 [taskName:text]', '让当前群订阅指定任务的推送')
@@ -809,6 +857,67 @@ function apply(ctx, config) {
       return '📋 订阅列表：\n' + lines.join('\n')
     })
 
+  // 管理员：取消指定任务的全部群订阅（并通知每个被取消的群）
+  // 任务名可填 all / * 表示清空所有任务的全部订阅
+  ctx.command('schedule.unsuball <name>', '取消某任务的全部群订阅（管理员；填 all 清空全部）', { authority: 3 })
+    .action(async ({ session }, name) => {
+      logger.info(`[schedule] 命令被调用: schedule.unsuball name=${name}`)
+      const tasks = config.tasks || {}
+      const all = name === 'all' || name === '*'
+      if (!all && (!name || !tasks[name])) {
+        return `未找到任务 "${name}"，可用 schedule.list 查看任务名（也可以填 all 清空全部任务的订阅）`
+      }
+      // 收集要取消的订阅
+      const targets = []
+      if (all) {
+        for (const [tn, m] of subs) {
+          for (const e of m.values()) targets.push({ taskName: tn, botSid: e.botSid, guildId: e.guildId })
+        }
+      }
+      else {
+        const m = subs.get(name)
+        if (m) for (const e of m.values()) targets.push({ taskName: name, botSid: e.botSid, guildId: e.guildId })
+      }
+      if (!targets.length) return all ? 'ℹ️ 当前没有任何群订阅' : `ℹ️ 任务 "${name}" 当前没有任何群订阅`
+
+      // 逐群发送"已取消"提示
+      let notified = 0
+      if (config.unsubAllNotice) {
+        for (const t of targets) {
+          const bot = (ctx.bots || []).find(b => b.sid === t.botSid)
+          if (!bot || !bot.online) continue
+          const text = String(config.unsubAllNotice).split('{task}').join(t.taskName)
+          try {
+            await bot.sendMessage(t.guildId, [text])
+            notified++
+          }
+          catch (e) {
+            logger.warn(`[schedule] 取消提示发送失败 ${t.botSid}:${t.guildId}: ${e.message}`)
+          }
+        }
+      }
+
+      // 清空订阅（内存 + 数据库）
+      if (all) {
+        for (const m of subs.values()) m.clear()
+        if (ctx.database) {
+          try {
+            await ctx.database.remove('ll_schedule_subs', {})
+          }
+          catch (e) {
+            logger.warn('[schedule] 清空订阅表失败:', e)
+          }
+        }
+      }
+      else {
+        const m = subs.get(name)
+        if (m) m.clear()
+        for (const t of targets) await removeSub(t.taskName, t.botSid, t.guildId)
+      }
+      logger.info(`[schedule] 已取消 ${targets.length} 个群订阅（通知 ${notified} 个群）${all ? '（全部任务）' : `任务 "${name}"`}`)
+      return `✅ 已取消 ${targets.length} 个群订阅${all ? '（全部任务）' : `（任务「${name}」）`}\n已向 ${notified} 个群发送取消提示`
+    })
+
   ctx.command('我的ID', '查看自己的账号信息（openid/群ID/角色）')
     .action(({ session }) => {
       logger.info('[schedule] 命令被调用: 我的ID')

package/package.json

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