koishi-plugin-ll-schedule 1.3.0 → 1.4.0

package/index.js

@@ -11,40 +11,81 @@ const { Schema, h } = require('koishi')
 
 exports.name = 'll-schedule'
 
-exports.usage = `定时提醒插件：到时间自动向订阅了该任务的群发送提醒。每个任务 = 一张"时间段列表"，点 + 添加一行，每行填 星期 / 时间 / 内容。
+exports.usage = `定时提醒插件：到时间自动向订阅了该任务的群发送提醒。每个任务就是一个**大文本框（日程）**，整张日程直接写进去，换行正常。
 
 ## 快速上手
 
-1. 在插件设置页的 \`tasks\` 里**添加任务**（键=任务名），在任务里 **添加时间段**：每行填 星期（留空=每天）/ 时间 / 内容
-2. 在任意群 @机器人 发：\`订阅 任务名\` → 该群加入此任务的订阅列表
-3. 到时间，插件自动把该时间段的内容发给所有订阅群
+1. 添加任务（键=任务名），在任务的 \`schedule\` 大文本框里直接写日程（格式见下）
+2. 在任意群 @机器人 发：\`订阅 任务名\` → 该群加入此任务订阅列表
+3. 到点自动发送
 
-## 每个时间段三格子
+## 日程怎么写
 
-- **星期**：留空 = 每天；写 \`周一\` \`周六\`...、\`工作日\`（周一到周五）、\`周末\`（周六日）、或 \`1,3,5\` 数字
-- **时间**：\`HH:MM\`，可填多个用逗号分隔，如 \`12:20, 18:20, 21:20\`（这些时间点都发同一段内容）
-- **内容**：到点发送的话；支持 Markdown 语法和模板变量 \`{date}\` \`{time}\` \`{week}\` \`{task}\`
+每个时间段 = 一行 **\`星期 时间\`** 开头，下面几行是该时间的内容（可多行 markdown，保留换行）。写到下一个 \`星期 时间\` 行，自动切到下一个时间段。不同时间段之间可空一行，更清晰。
 
-## 示例：每天定时提醒
+- **星期**：\`周一\` \`周六\`...、\`每天\`、\`工作日\`（周一到周五）、\`周末\`（周六日）、\`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啦
+
+> 地点：仙幻岛 → 白青山脉
+
+世界BOSS刷新！
+
+周二 21:00
+# 🐦 马上到世界BOSS啦
+
+> 地点：仙幻岛 → 大漠
+
+世界BOSS刷新！
+
+周三 21:00
+> 地点：仙幻岛 → 御龙林
+
+世界BOSS刷新！
+
+周四 21:00
+> 地点：仙幻岛 → 水月平原
+
+世界BOSS刷新！
+
+周五 21:00
+> 地点：白青山脉 → 大漠
+
+世界BOSS刷新！
+
+周六 15:00
+> 地点：仙幻岛 → 白青山脉
+
+世界BOSS刷新！
+
+周六 21:00
+> 地点：仙幻岛 → 御龙林
+
+世界BOSS刷新！
+
+周日 15:00
+> 地点：仙幻岛 → 大漠
+
+世界BOSS刷新！
+
+周日 21:00
+> 地点：仙幻岛 → 水月平原
+
+世界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刷新！仙幻岛 → 水月平原
+每天 12:20, 18:20, 21:20
+⏰ 轻功时间到了！
 \`\`\`
-每行对应一个时间段，内容各不相同。
 
 ## Markdown 卡片（官方QQ机器人）
 
@@ -128,10 +169,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,26 +279,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()
-    .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）'),
@@ -236,7 +302,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=所有人都能订阅。如需限制，先在控制台"用户管理"给指定账号提权，再调高此值）'),
@@ -621,11 +687,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}"`
     })
@@ -813,7 +879,7 @@ function apply(ctx, config) {
       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}"`
     })

package/package.json

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