koishi-plugin-ll-schedule 1.3.1 → 1.4.1

package/index.js

@@ -11,62 +11,19 @@ const { Schema, h } = require('koishi')
 
 exports.name = 'll-schedule'
 
-exports.usage = `定时提醒插件：到时间自动向订阅了该任务的群发送提醒。每个任务 = 一张"时间段列表"，点 + 添加一行，每行填 星期 / 时间 / 内容。
+exports.usage = `定时提醒：每个任务一个大文本框(schedule)。每段 = 一行"星期 时间"，下面几行是内容。
 
-## 快速上手
+例：
+周一 21:00
+# 世界BOSS马上刷新啦！
+> 地点1：仙幻岛
+> 地点2：白青山脉
+游戏下方有遁地按钮可以直达～
 
-1. 在插件设置页的 \`tasks\` 里**添加任务**（键=任务名），在任务里 **添加时间段**：每行填 星期（留空=每天）/ 时间 / 内容
-2. 在任意群 @机器人 发：\`订阅 任务名\` → 该群加入此任务的订阅列表
-3. 到时间，插件自动把该时间段的内容发给所有订阅群
+星期：周一/周六/每天/工作日/周末/1,3,5   时间：12:20, 18:20, 21:20（可多个）
+内容支持 Markdown 卡片、模板变量 {date} {time} {week} {task}
 
-## 每个时间段三格子
-
-- **星期**：留空 = 每天；写 \`周一\` \`周六\`...、\`工作日\`（周一到周五）、\`周末\`（周六日）、或 \`1,3,5\` 数字
-- **时间**：\`HH:MM\`，可填多个用逗号分隔，如 \`12:20, 18:20, 21:20\`（这些时间点都发同一段内容）
-- **内容**：到点发送的话；支持 Markdown 语法和模板变量 \`{date}\` \`{time}\` \`{week}\` \`{task}\`
-
-## 示例：每天定时提醒
-
-任务「轻功」，添加 1 行： 星期=空（每天） 时间=\`12:20, 18:20, 21:20\` 内容=\`⏰ 轻功时间到了！\`
-→ 每天这三个点都发这句。
-
-## 示例：按天/按时段发不同内容（如世界BOSS）
-
-任务「世界BOSS」，添加多行：
-\`\`\`
-周一  21:00   世界BOSS刷新！仙幻岛 → 白青山脉
-周二  21:00   世界BOSS刷新！仙幻岛 → 大漠
-周三  21:00   世界BOSS刷新！仙幻岛 → 御龙林
-周四  21:00   世界BOSS刷新！仙幻岛 → 水月平原
-周五  21:00   世界BOSS刷新！白青山脉 → 大漠
-周六  15:00   世界BOSS刷新！仙幻岛 → 白青山脉
-周六  21:00   世界BOSS刷新！仙幻岛 → 御龙林
-周日  15:00   世界BOSS刷新！仙幻岛 → 大漠
-周日  21:00   世界BOSS刷新！仙幻岛 → 水月平原
-\`\`\`
-每行对应一个时间段，内容各不相同。
-
-## Markdown 卡片（官方QQ机器人）
-
-任务勾选 \`markdown\` 后，会用 QQ 官方 Markdown 卡片发送（仅官机生效，失败自动回退纯文本；其他平台始终纯文本）。内容里可用标题/加粗/引用/链接/图片（图片直接写在内容里，如 \`![配图](https://...)\`），模板变量自动替换。
-
-## 其他配置
-
-- \`groups\`：手动指定目标群（推荐留空，用群内"订阅"命令自动添加）
-- \`enabled\`：是否启用该任务
-
-## 群内命令
-
-- \`订阅 [任务名]\`：当前群订阅指定任务
-- \`取消订阅 [任务名]\`：当前群取消订阅
-- \`订阅列表\`：查看所有任务的订阅群
-- \`schedule.list\`：查看任务列表（含每段时间段）
-- \`schedule.test <任务名>\`：立即测试发送
-- \`lls.*\`：以上命令的备用入口
-
-## 官机（官方QQ机器人）说明
-
-官方平台没有群号只有 openid——用群内"订阅"命令即可，插件自动记录当前群 openid。手动填 \`groups\` 时用 \`schedule.groups\` 查看已知群 openid。官机主动发群消息有平台频率限制，且机器人需在群里。
+群命令：订阅 任务名 / 取消订阅 任务名 / 订阅列表 / schedule.list / schedule.groups / schedule.test 任务名 / 我的ID
 `
 
 // ===== 纯函数（可单测） =====
@@ -128,10 +85,46 @@ function dayMatches(daysSet, day) {
   return !daysSet || daysSet.has(day)
 }
 
+// 判断某 token 是否是合法的星期写法
+const WEEK_TOKEN_RE = /^(?:工作日|周末|休息日|每天|每日|天天|(?:每)?(?:星期|周|礼拜)[一二三四五六日天]|[一二三四五六日天]|[1-7](?:[，,、\s]+[1-7])*|[1-7]\s*[-~]\s*[1-7])$/
+
+// 解析"日程大文本框"：每个时间段 = 一行"星期 时间"作为开头，之后（到下一个"星期 时间"行之前）的行都是该时间段的内容（多行 markdown，保留换行）
+// 例：
+//   周一 21:00
+//   # 马上到世界BOSS
+//   > 地点：仙幻岛 → 白青山脉
+//   游戏底部有道地按钮
+//
+//   周六 15:00
+//   # 世界BOSS
+//   > 地点：仙幻岛 → 白青山脉
+function parseScheduleBlocks(text) {
+  const lines = String(text || '').split(/\r?\n/)
+  const blocks = []
+  let cur = null
+  for (const raw of lines) {
+    const line = raw.replace(/\s+$/, '')
+    // 尝试识别块头行：星期token 开头 + 后面是时间串
+    const m = line.match(/^(\S+)\s+(\d{1,2}:\d{2}(?:[，,、;；\s]*\d{1,2}:\d{2})*)\s*$/)
+    if (m && WEEK_TOKEN_RE.test(m[1])) {
+      cur = { idx: blocks.length, wd: m[1], time: m[2], textLines: [] }
+      blocks.push(cur)
+    }
+    else if (cur) {
+      cur.textLines.push(line)
+    }
+    // 未识别且还没遇到任何块头 → 忽略（前面是说明/空行）
+  }
+  return blocks.map(b => ({ idx: b.idx, wd: b.wd, time: b.time, text: b.textLines.join('\n').trim() }))
+}
+
 // 把任务的时间段解析成统一行列表：[{ idx, wd(星期), time, text }]
-// 兼容三种写法：新 slots 数组（优先）、旧 time/text（每天）、旧 slots(days)
+// 兼容四种写法：schedule 大文本框（优先）、旧 slots 数组、旧 time/text（每天）、旧 slots(days)
 function parseScheduleRows(task) {
   if (!task) return []
+  if (typeof task.schedule === 'string' && task.schedule.trim()) {
+    return parseScheduleBlocks(task.schedule)
+  }
   if (Array.isArray(task.slots) && task.slots.length) {
     return task.slots
       .map((s, i) => ({
@@ -202,27 +195,15 @@ function buildTextFromMd(md) {
     .trim()
 }
 
-exports._test = { parseTimes, todayDay, parseDays, dayMatches, parseScheduleRows, computeFires, renderText, buildMd, buildTextFromMd }
+exports._test = { parseTimes, todayDay, parseDays, dayMatches, parseScheduleBlocks, parseScheduleRows, computeFires, renderText, buildMd, buildTextFromMd }
 
 // ===== 配置 Schema =====
 
-const SlotItem = Schema.object({
-  wd: Schema.string()
-    .default('')
-    .description('星期：留空=每天；周一/周二...；工作日（周一到五）/周末（周六日）；或 1,3,5 / 1-5'),
-  time: Schema.string()
-    .required()
-    .description('时间（24小时制 HH:MM），可多个用逗号分隔，如 12:20, 18:20, 21:20'),
-  text: Schema.string()
-    .role('textarea', { rows: [3, 10] })
-    .default('')
-    .description('内容：到点发送的话，支持 Markdown 和模板变量 {date} {time} {week} {task}（大多行文本框，可多行写卡片）'),
-})
-
 const TaskItem = Schema.object({
-  slots: Schema.array(SlotItem)
-    .default([])
-    .description('📅 时间段列表：每行 = 星期 + 时间 + 内容，点 + 可添加多行；每行内容各自独立'),
+  schedule: Schema.string()
+    .role('textarea', { rows: [6, 16] })
+    .default('')
+    .description('📅 日程：多行文本框，直接写整张日程。每个时间段分两段：第一行写 星期 时间，下面几行写内容（可多行 markdown）。示例见 usage。'),
   groups: Schema.array(Schema.string())
     .default([])
     .description('手动指定的目标群 ID（可留空；推荐用群内"订阅"命令自动添加，无需手动填 openid）'),
@@ -237,7 +218,7 @@ const TaskItem = Schema.object({
 const Config = Schema.object({
   tasks: Schema.dict(TaskItem)
     .default({})
-    .description('📋 推送任务表格（键=任务名；每个任务 = 时间段列表：星期/时间/内容）'),
+    .description('📋 推送任务表格（键=任务名；每个任务 = 一个日程大文本框 schedule：星期/时间/内容）'),
   subscribeAuthority: Schema.number()
     .min(1).max(4).default(1)
     .description('执行订阅命令所需的最低权限等级（Koishi 用户权限等级，与QQ群主/管理员身份无关；默认 1=所有人都能订阅。如需限制，先在控制台"用户管理"给指定账号提权，再调高此值）'),
@@ -622,11 +603,11 @@ function apply(ctx, config) {
       if (!testTask.groups || !testTask.groups.length) {
         testTask.groups = session.guildId ? [String(session.guildId)] : []
       }
-      // 发"今天会命中的第一行"的内容，更贴近真实
+      // 优先发"今天会命中的行"，否则发第一条（保证测试总能发出内容）
       const rows = parseScheduleRows(task)
       const day = todayDay()
       const hit = rows.find(r => dayMatches(parseDays(r.wd), day))
-      const sendText = hit ? (hit.text || '') : (task.text || '')
+      const sendText = hit ? (hit.text || '') : (rows.length ? (rows[0].text || '') : '')
       await sendTask(name, testTask, { text: sendText, markdown: task.markdown, onlyBotSid: session.bot?.sid })
       return `✅ 已发送任务 "${name}"`
     })
@@ -661,7 +642,7 @@ function apply(ctx, config) {
   function resolveSubscribeTaskName(taskName) {
     const tasks = config.tasks || {}
     if (taskName) {
-      if (!tasks[taskName]) return { name: null, hint: `未找到任务 "${taskName}"，可用"订阅列表"或 lls.list 查看任务名` }
+      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)
@@ -707,24 +688,12 @@ function apply(ctx, config) {
       return await subscribeCurrentGroup(session, taskName)
     })
 
-  ctx.command('lls.sub [taskName:text]', '订阅推送（备用入口）')
-    .action(async ({ session }, taskName) => {
-      if (!(await checkSubscribePerm(session))) return permDeniedHint()
-      return await subscribeCurrentGroup(session, taskName)
-    })
-
   ctx.command('取消订阅 [taskName:text]', '让当前群取消订阅指定任务的推送')
     .action(async ({ session }, taskName) => {
       if (!(await checkSubscribePerm(session))) return permDeniedHint()
       return await unsubscribeCurrentGroup(session, taskName)
     })
 
-  ctx.command('lls.unsub [taskName:text]', '取消订阅（备用入口）')
-    .action(async ({ session }, taskName) => {
-      if (!(await checkSubscribePerm(session))) return permDeniedHint()
-      return await unsubscribeCurrentGroup(session, taskName)
-    })
-
   ctx.command('订阅列表', '查看所有任务的订阅群')
     .action(async () => {
       logger.info('[schedule] 命令被调用: 订阅列表')
@@ -742,23 +711,6 @@ function apply(ctx, config) {
       return '📋 订阅列表：\n' + lines.join('\n')
     })
 
-  ctx.command('lls.sublist', '查看订阅列表（备用入口）')
-    .action(async () => {
-      logger.info('[schedule] 命令被调用: lls.sublist')
-      if (!subs.size) return '暂无任何群订阅。群内发"订阅 任务名"即可订阅'
-      const lines = []
-      for (const [taskName, taskSubs] of subs) {
-        const entries = [...taskSubs.values()]
-        lines.push(`【${taskName}】${entries.length} 个群`)
-        for (const s of entries) {
-          const bot = ctx.bots.find(b => b.sid === s.botSid)
-          const name = bot ? await resolveGroupName(bot, s.guildId) : ''
-          lines.push(`  · ${name || '未知群名'} (${s.guildId})`)
-        }
-      }
-      return '📋 订阅列表：\n' + lines.join('\n')
-    })
-
   ctx.command('我的ID', '查看自己的账号信息（openid/群ID/角色）')
     .action(({ session }) => {
       logger.info('[schedule] 命令被调用: 我的ID')
@@ -771,56 +723,8 @@ function apply(ctx, config) {
       return lines.join('\n')
     })
 
-  ctx.command('lls.me', '查看自己的账号信息（备用入口）')
-    .action(({ session }) => {
-      logger.info('[schedule] 命令被调用: lls.me')
-      const role = session.author?.roles?.[0]?.id || session.event?.member?.roles?.[0]?.id
-      const roleName = role === 'owner' ? '群主' : role === 'admin' ? '群管理' : role === 'member' ? '普通成员' : (role || '未知')
-      const lines = ['👤 我的账号信息：', `平台：${session.platform}`, `用户ID：${session.userId}`]
-      if (session.guildId) lines.push(`当前群ID：${session.guildId}`)
-      if (session.guildId) lines.push(`本群角色：${roleName}`)
-      if (session.channelId && session.channelId !== session.guildId) lines.push(`频道ID：${session.channelId}`)
-      return lines.join('\n')
-    })
-
-  ctx.command('lls', 'll-schedule 管理（备用入口）')
-    .action(() => {
-      logger.info('[schedule] 命令被调用: lls')
-      return `⚙️ 备用入口：lls.list / lls.groups / lls.test <任务名> / lls.sub / lls.unsub / lls.sublist`
-    })
-
-  ctx.command('lls.list', '查看定时任务（备用入口）')
-    .action(() => {
-      logger.info('[schedule] 命令被调用: lls.list')
-      return formatTaskList()
-    })
-
-  ctx.command('lls.groups', '查看机器人已知的群（备用入口，官机显示 openid）')
-    .action(async () => {
-      logger.info('[schedule] 命令被调用: lls.groups')
-      return await listKnownGroups()
-    })
-
-  ctx.command('lls.test <name>', '立即测试发送指定任务（备用入口）')
-    .action(async ({ session }, name) => {
-      logger.info(`[schedule] 命令被调用: lls.test name=${name}`)
-      const tasks = config.tasks || {}
-      const task = tasks[name]
-      if (!task) return `未找到任务 "${name}"，可用 lls.list 查看任务名`
-      const testTask = { ...task }
-      if (!testTask.groups || !testTask.groups.length) {
-        testTask.groups = session.guildId ? [String(session.guildId)] : []
-      }
-      const rows = parseScheduleRows(task)
-      const day = todayDay()
-      const hit = rows.find(r => dayMatches(parseDays(r.wd), day))
-      const sendText = hit ? (hit.text || '') : (task.text || '')
-      await sendTask(name, testTask, { text: sendText, markdown: task.markdown, onlyBotSid: session.bot?.sid })
-      return `✅ 已发送任务 "${name}"`
-    })
-
   logger.info('[schedule] 命令已注册: schedule / schedule.list / schedule.groups / schedule.test / ' +
-    `"订阅" / "取消订阅" / 订阅列表 / lls.*`)
+    `"订阅" / "取消订阅" / 订阅列表 / 我的ID`)
 
   Promise.all([loadKnownGroups(), loadSubs()]).then(() => checkAndSend())
 }

package/package.json

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