foliko 1.0.12 → 1.0.13

package/.claude/settings.local.json

@@ -36,7 +36,8 @@
       "Bash(node -c cli/src/ui/chat-ui.js && echo \"Syntax OK\")",
       "Bash(node -c plugins/default-plugins.js && echo \"Syntax OK\")",
       "Bash(node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")",
-      "Bash(node -c plugins/telegram-plugin.js && node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")"
+      "Bash(node -c plugins/telegram-plugin.js && node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")",
+      "Bash(node -c plugins/telegram-plugin.js && echo \"Syntax OK\")"
     ]
   }
 }

package/SPEC.md

@@ -410,6 +410,10 @@ agent.chat('请重载 my-plugin 插件')
 - 绑定主 Agent 持续对话
 - 支持 MarkdownV2
 - 图片/文档接收保存
+- 监听 `scheduler:reminder` 事件发送定时提醒
+
+**监听事件**：
+- `scheduler:reminder` - 接收定时任务提醒并发送到 Telegram
 
 **配置**：
 ```javascript
@@ -421,6 +425,53 @@ agent.chat('请重载 my-plugin 插件')
 }
 ```
 
+### 7.5 Scheduler Plugin (plugins/scheduler-plugin.js)
+
+**功能**：
+- 定时任务调度（Cron 表达式、相对时间、绝对时间）
+- 支持 LLM 自动检测（简单提醒直接显示，需要处理的任务启用 LLM）
+- 会话自动检测（自动发送到最近活跃的会话）
+- 事件系统（供其他插件监听和响应）
+
+**工具**：
+- `schedule_task` - 创建定时任务
+- `schedule_list` - 列出所有任务
+- `schedule_cancel` - 取消任务
+- `cron_examples` - Cron 表达式示例
+
+**schedule_task 参数**：
+```javascript
+{
+  name: '任务名称',           // 可选
+  scheduleTime: '10 minutes', // 必填，支持多种格式
+  message: '提醒内容',         // 必填
+  repeat: false,              // 可选，是否重复
+  cronExpression: '*/5 * * * *',  // 可选，Cron 表达式
+  sessionId: 'telegram_123', // 可选，会话 ID
+  llm: true                  // 可选，是否需要 LLM 处理（自动检测）
+}
+```
+
+**时间格式**：
+| 格式 | 示例 | 说明 |
+|------|------|------|
+| 相对时间 | `10 seconds`, `5 minutes`, `1 hour`, `2 days` | 多久后执行 |
+| 绝对时间 | `12:00`, `14:30:00` | 具体时间（次日开始） |
+| Cron | `*/5 * * * *`, `0 9 * * *` | Cron 表达式 |
+
+**自动 LLM 检测**：
+- 简单提醒（喝水、吃饭）→ 直接显示
+- 查询/分析任务（查看列表、分析数据）→ 启用 LLM
+
+**事件**：
+| 事件 | 时机 |
+|------|------|
+| `scheduler:task_created` | 任务创建时 |
+| `scheduler:task_cancelled` | 任务取消时 |
+| `scheduler:task_completed` | 任务完成时 |
+| `scheduler:task_failed` | 任务失败时 |
+| `scheduler:reminder` | 提醒触发时 |
+
 ## 八、使用示例
 
 ### 8.1 基础用法

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {

package/plugins/telegram-plugin.js

@@ -124,26 +124,40 @@ module.exports = function(Plugin) {
     async _handleScheduledReminder(data) {
       const { taskName, message, sessionId } = data
 
+      // 构建提醒消息
+      const reminderText = `🔔 [${taskName}]\n\n${message}`
+
       // 如果有 sessionId 是 telegram 类型的，发送到对应 chat
       if (sessionId && sessionId.startsWith('telegram_')) {
         const chatId = sessionId.replace('telegram_', '')
         try {
-          await this._bot.sendMessage(chatId, `🔔 [${taskName}]\n\n${message}`)
+          await this._bot.sendMessage(chatId, reminderText)
           console.log(`[Telegram] Reminder sent to chat ${chatId}`)
         } catch (err) {
           console.error(`[Telegram] Failed to send reminder:`, err.message)
         }
-      } else if (sessionId) {
-        // 如果是其他类型的 sessionId，尝试发送到所有活跃的 telegram 会话
-        for (const [chatId, session] of this._sessions) {
-          try {
-            await this._bot.sendMessage(chatId, `🔔 [${taskName}]\n\n${message}`)
-            console.log(`[Telegram] Reminder sent to chat ${chatId}`)
-            break // 只发送一个
-          } catch (err) {
-            console.error(`[Telegram] Failed to send reminder to ${chatId}:`, err.message)
-          }
+        return
+      }
+
+      // 其他情况（包括 null 或其他 sessionId），发送到最近的 Telegram 会话
+      if (this._sessions.size > 0) {
+        // 按最后活跃时间排序
+        const sortedSessions = Array.from(this._sessions.entries())
+          .sort((a, b) => {
+            const aTime = a[1].lastActive ? new Date(a[1].lastActive).getTime() : 0
+            const bTime = b[1].lastActive ? new Date(b[1].lastActive).getTime() : 0
+            return bTime - aTime
+          })
+
+        const [chatId] = sortedSessions[0]
+        try {
+          await this._bot.sendMessage(chatId, reminderText)
+          console.log(`[Telegram] Reminder sent to chat ${chatId}`)
+        } catch (err) {
+          console.error(`[Telegram] Failed to send reminder to ${chatId}:`, err.message)
         }
+      } else {
+        console.log('[Telegram] No active Telegram sessions to send reminder')
       }
     }