foliko 1.0.9 → 1.0.12

package/.claude/settings.local.json

@@ -34,7 +34,9 @@
       "Bash(node -c plugins/default-plugins.js && node -c src/core/plugin-manager.js && echo \"Syntax OK\")",
       "Bash(node -c plugins/install-plugin.js && echo \"Syntax OK\")",
       "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/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\")"
     ]
   }
 }

package/SPEC.md

@@ -304,8 +304,34 @@ const response = await agent.chat('你好')
 'agent:message'             // Agent消息
 'agent:tool-call'          // Agent调用工具
 'agent:tool-result'         // 工具执行结果
+'scheduler:task_created'   // 定时任务创建
+'scheduler:task_cancelled'  // 定时任务取消
+'scheduler:task_completed'  // 定时任务完成
+'scheduler:task_failed'     // 定时任务失败
+'scheduler:reminder'       // 定时提醒触发
+'think:thought_completed'  // 思考完成
+'think:reflection_needs_attention'  // 反思需要关注
 ```
 
+### 事件详情
+
+#### Scheduler 事件
+
+| 事件 | 数据 | 说明 |
+|------|------|------|
+| `scheduler:task_created` | `{ taskId, taskName, type, scheduleTime, cronExpression }` | 任务创建时触发 |
+| `scheduler:task_cancelled` | `{ taskId, taskName }` | 任务取消时触发 |
+| `scheduler:task_completed` | `{ taskId, taskName, type }` | 任务完成时触发 |
+| `scheduler:task_failed` | `{ taskId, taskName, error }` | 任务失败时触发 |
+| `scheduler:reminder` | `{ taskId, taskName, message, sessionId, llm }` | 提醒触发时触发 |
+
+#### Think 事件
+
+| 事件 | 数据 | 说明 |
+|------|------|------|
+| `think:thought_completed` | `thought` | 思考完成时触发 |
+| `think:reflection_needs_attention` | `{ thought, reason }` | 反思需要关注时触发 |
+
 ## 六、热重载机制
 
 ### 设计原则
@@ -491,7 +517,7 @@ class Framework {
 - [x] Session 管理 (`plugins/session-plugin.js`) - 多会话支持、历史记录
 - [x] Audit 审计日志 (`plugins/audit-plugin.js`) - 操作日志记录和查询
 - [x] Rules 规则引擎 (`plugins/rules-plugin.js`) - 权限控制、内容过滤
-- [x] Scheduler 定时任务 (`plugins/scheduler-plugin.js`) - Cron 调度
+- [x] Scheduler 定时任务 (`plugins/scheduler-plugin.js`) - Cron 调度、事件系统、自动 LLM 检测
 - [x] Storage 存储 (`plugins/storage-plugin.js`) - 键值对持久化存储
 - [x] SubAgent 子Agent (`plugins/subagent-plugin.js`) - 子Agent隔离工具集
 - [x] Email 插件 (`plugins/email.js`) - 邮件收发

package/cli/src/ui/chat-ui.js

@@ -1,75 +1,31 @@
 /**
  * 聊天界面组件
- * 处理用户输入、粘贴检测、输出渲染
+ * 使用 readline question() 实现多行输入
  */
 
 const readline = require('readline')
-const { EventEmitter } = require('events')
 const { CLEAR_LINE, CYAN, DIM, GREEN, RED, YELLOW, colored } = require('../utils/ansi')
-const { render, renderLine } = require('../utils/markdown')
+const { renderLine } = require('../utils/markdown')
 
-class ChatUI extends EventEmitter {
+class ChatUI {
   constructor(agent) {
-    super()
     this.agent = agent
     this.rl = null
-    this.currentLine = ''
-    this.lines = []
-    this.pasteId = 0
-    this.isFirstLine = true
-
-    // 粘贴检测
-    this.lastKeyTime = 0
-    this.pasteBuffer = ''
-    this.isPasting = false
-
-    // 多行输入：记录上次 Enter 时间，检测连续两次空回车
-    this.lastEnterTime = 0
-    this.LINE_ENDING_INTERVAL = 800  // 毫秒内连续两次空回车结束输入
+    this.lines = []  // 多行输入的累积
   }
 
   /**
    * 启动聊天界面
    */
   start() {
-    this.setupReadline()
-    this.printWelcome()
-    this.prompt()
-  }
-
-  /**
-   * 设置 readline
-   */
-  setupReadline() {
     this.rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout,
       crlfDelay: Infinity
     })
 
-    // 使用 keypress 事件支持特殊按键
-    readline.emitKeypressEvents(process.stdin)
-
-    if (process.stdin.isTTY) {
-      process.stdin.setRawMode(true)
-    }
-
-    // 监听按键
-    process.stdin.on('keypress', this.handleKey.bind(this))
-
-    // 退出时清理
-    process.on('exit', () => {
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(false)
-      }
-    })
-
-    process.on('SIGINT', () => {
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(false)
-      }
-      process.exit(0)
-    })
+    this.printWelcome()
+    this.promptUser()
   }
 
   /**
@@ -77,174 +33,77 @@ class ChatUI extends EventEmitter {
    */
   printWelcome() {
     console.log(`${colored('Foliko', CYAN)} - 持续对话聊天`)
-    console.log(`${colored('Ctrl+C', DIM)} 退出 | ${colored('Enter', DIM)} 换行 | ${colored('双Enter', DIM)} 发送\n`)
+    console.log(`${colored('Ctrl+C', DIM)} 退出 | ${colored('连续两次回车', DIM)} 发送多行 | ${colored('!!', DIM)} 立即发送\n`)
   }
 
   /**
-   * 显示提示符
+   * 获取多行输入
    */
-  prompt() {
-    const prefix = this.isFirstLine ? colored('> ', GREEN) : colored('- ', DIM)
-    process.stdout.write(`\r${CLEAR_LINE}${prefix}${this.currentLine}`)
-  }
-
-  /**
-   * 处理按键
-   */
-  handleKey(str, key) {
-    // Ctrl+C 退出
-    if (key.ctrl && key.name === 'c') {
-      console.log('\n再见！')
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(false)
-      }
-      process.exit(0)
-      return
-    }
-
-    // Enter 发送
-    if (key.name === 'return') {
-      this.handleSubmit()
-      return
-    }
+  getMultilineInput() {
+    return new Promise((resolve) => {
+      const lines = []
+
+      const question = (isFirst) => {
+        const prompt = isFirst ? colored('> ', GREEN) : colored('- ', DIM)
+        this.rl.question(prompt, (input) => {
+          // 输入 !! 立即结束
+          if (input.trim() === '!!') {
+            const result = lines.join('\n').trim()
+            resolve(result)
+            return
+          }
 
-    // Ctrl+Enter 换行
-    if (key.ctrl && key.name === 'return') {
-      this.lines.push(this.currentLine)
-      this.currentLine = ''
-      this.isFirstLine = false
-      this.prompt()
-      return
-    }
+          // 空行：结束输入并发送（第一次空行就发送）
+          if (input.trim() === '') {
+            const result = lines.join('\n').trim()
+            resolve(result)
+            return
+          }
 
-    // Backspace 退格
-    if (key.name === 'backspace') {
-      if (this.currentLine.length > 0) {
-        this.currentLine = this.currentLine.slice(0, -1)
-        this.prompt()
-      } else if (this.lines.length > 0) {
-        this.currentLine = this.lines.pop()
-        this.isFirstLine = this.lines.length === 0
-        this.prompt()
+          // 非空行：添加到 lines，继续输入
+          lines.push(input)
+          question(false)
+        })
       }
-      return
-    }
-
-    // 普通字符
-    if (str && !key.ctrl && !key.meta) {
-      // 直接添加到当前行
-      this.currentLine += str
-      this.prompt()
-    }
-  }
-
-  /**
-   * 处理粘贴
-   */
-  handlePaste() {
-    if (this.pasteBuffer.includes('\n')) {
-      const allLines = this.pasteBuffer.split('\n')
-      this.lines.push(...allLines.slice(0, -1))
-      this.currentLine = allLines[allLines.length - 1]
-      this.isFirstLine = false
-      this.pasteId++
 
-      console.log(`\n${CLEAR_LINE}${colored(`[Pasted text #${this.pasteId} +${this.lines.length + 1} lines]`, CYAN)}`)
-    } else {
-      this.currentLine = this.pasteBuffer
-      this.lines = []
-    }
-    this.pasteBuffer = ''
+      question(true)
+    })
   }
 
   /**
-   * 处理发送
+   * 提示用户输入
    */
-  async handleSubmit() {
-    const now = Date.now()
-    const content = this.lines.length > 0
-      ? [...this.lines, this.currentLine].join('\n')
-      : this.currentLine
-
-    const trimmed = content.trim()
-
-    // 检测连续两次空回车（多行输入结束）
-    if (this.currentLine.trim() === '' && this.lines.length > 0) {
-      if (now - this.lastEnterTime < this.LINE_ENDING_INTERVAL) {
-        // 第二次空回车，结束输入
-        const finalContent = this.lines.join('\n').trim()
-        this.resetInput()
-        console.log()
-
-        if (!finalContent) {
-          this.prompt()
-          return
-        }
+  async promptUser() {
+    try {
+      const input = await this.getMultilineInput()
 
-        await this.sendMessage(finalContent)
+      if (!input) {
+        await this.promptUser()
         return
       }
-    }
-    this.lastEnterTime = now
-
-    // 输入 !! 立即结束多行输入
-    if (this.currentLine.trim() === '!!') {
-      const finalContent = this.lines.join('\n').trim()
-      this.resetInput()
-      console.log()
 
-      if (finalContent) {
-        await this.sendMessage(finalContent)
-      } else {
-        this.prompt()
+      // 退出命令
+      if (input.toLowerCase() === 'exit' || input.toLowerCase() === 'quit') {
+        console.log('再见！')
+        this.rl.close()
+        return
       }
-      return
-    }
 
-    // 显示空行
-    console.log()
+      // 发送消息
+      await this.sendMessage(input)
 
-    // 退出命令
-    if (trimmed.toLowerCase() === 'exit' || trimmed.toLowerCase() === 'quit') {
-      console.log('再见！')
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(false)
-      }
-      process.exit(0)
-      return
-    }
-
-    if (!trimmed) {
-      this.resetInput()
-      this.prompt()
-      return
+      // 继续等待下一条消息
+      await this.promptUser()
+    } catch (err) {
+      console.error(`\n${colored('[错误]', RED)} ${err.message}`)
+      await this.promptUser()
     }
-
-    // 重置输入
-    this.resetInput()
-
-    // 发送消息
-    await this.sendMessage(trimmed)
-  }
-
-  /**
-   * 重置输入状态
-   */
-  resetInput() {
-    this.currentLine = ''
-    this.lines = []
-    this.isFirstLine = true
-    this.pasteId = 0
-    this.isPasting = false
-    this.pasteBuffer = ''
-    this.lastEnterTime = 0
   }
 
   /**
    * 发送消息并显示响应
    */
   async sendMessage(message) {
-    console.log(colored('Agent:', GREEN))
     console.log()
 
     // 用于打断的标志
@@ -263,43 +122,18 @@ class ChatUI extends EventEmitter {
 
     try {
       let lineBuffer = ''
-      // 渲染状态追踪
       const renderState = { inThink: false, inCodeBlock: false }
 
-      // 检查是否还有孤立的代理对
-      const hasOrphanedSurrogate = (str) => {
-        if (!str || str.length === 0) return false
-        let i = 0
-        while (i < str.length) {
-          const code = str.charCodeAt(i)
-          if (code >= 0xD800 && code <= 0xDBFF) {
-            const nextCode = str.charCodeAt(i + 1)
-            if (nextCode >= 0xDC00 && nextCode <= 0xDFFF) {
-              i += 2
-              continue
-            }
-            return true // 孤立的高代理
-          }
-          i++
-        }
-        return false
-      }
+      console.log(colored('Agent:', GREEN))
+      console.log()
 
       for await (const chunk of this.agent.chatStream(message)) {
-        // 检查是否被打断
         if (interrupted) break
 
         if (chunk.type === 'text') {
           lineBuffer += chunk.text
 
-          // 如果有孤立代理对，等待下一个chunk补充
-          if (hasOrphanedSurrogate(lineBuffer)) {
-            continue
-          }
-
-          // 当有一行完整内容时，渲染并输出
           while (lineBuffer.includes('\n')) {
-            // 检查是否被打断
             if (interrupted) break
 
             const nlIndex = lineBuffer.indexOf('\n')
@@ -316,7 +150,6 @@ class ChatUI extends EventEmitter {
         }
       }
 
-      // 输出剩余内容
       if (lineBuffer.trim() && !interrupted) {
         console.log(renderLine(lineBuffer, renderState))
       }
@@ -325,11 +158,8 @@ class ChatUI extends EventEmitter {
         console.error(`\n${colored('[错误]', RED)} ${err.message}\n`)
       }
     } finally {
-      // 移除监听器
       process.removeListener('SIGINT', interruptHandler)
     }
-
-    this.prompt()
   }
 }
 

package/package.json

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

package/plugins/scheduler-plugin.js

@@ -106,25 +106,60 @@ class SchedulerPlugin extends Plugin {
     // 注册调度工具
     framework.registerTool({
       name: 'schedule_task',
-      description: '设置定时提醒任务。支持多种时间格式：相对时间(1 minute, 2 hours)、具体时间(12:00)、Cron表达式(* * * * *)',
+      description: '设置定时提醒任务。支持多种时间格式：相对时间(1 minute, 2 hours)、具体时间(12:00)、Cron表达式(* * * * *)。系统会自动判断任务是否需要 LLM 处理。',
       inputSchema: z.object({
         name: z.string().optional().describe('任务名称'),
         scheduleTime: z.string().describe('执行时间。支持格式：\n- 相对时间: "1 minute", "2 hours", "1 day"\n- 具体时间: "12:00", "14:30"\n- Cron表达式: "*/5 * * * *" (每5分钟)'),
-        message: z.string().describe('提醒消息内容'),
+        message: z.string().describe('提醒消息内容。系统会自动判断：\n- 简单提醒（喝水、吃饭）直接显示\n- 需要查询/分析的任务（查看列表、分析数据）自动启用 LLM'),
         repeat: z.boolean().optional().describe('是否重复执行 (默认 false)'),
-        cronExpression: z.string().optional().describe('Cron 表达式 (当 repeat 为 true 时使用)')
+        cronExpression: z.string().optional().describe('Cron 表达式 (当 repeat 为 true 时使用)'),
+        sessionId: z.string().optional().describe('会话 ID（提醒将发送到该会话，不填则使用默认会话）'),
+        llm: z.boolean().optional().describe('是否需要 LLM 处理（自动检测，可手动覆盖）')
       }),
       execute: async (args) => {
         try {
-          const { scheduleTime, message, repeat, cronExpression } = args
+          const { scheduleTime, message, repeat, cronExpression, sessionId } = args
           const agent = this._getAgent()
           if (!agent) {
             return { success: false, error: 'Agent not available' }
           }
 
+          // 如果没有指定 sessionId，自动获取当前活跃会话
+          let targetSessionId = sessionId
+          if (!targetSessionId) {
+            const sessionPlugin = this._framework.pluginManager.get('session')
+            if (sessionPlugin) {
+              const sessions = sessionPlugin.listSessions()
+              // 获取最近的活跃会话
+              if (sessions.length > 0) {
+                // 按 lastActive 排序，取最新的
+                sessions.sort((a, b) => {
+                  const aTime = a.lastActive ? new Date(a.lastActive).getTime() : 0
+                  const bTime = b.lastActive ? new Date(b.lastActive).getTime() : 0
+                  return bTime - aTime
+                })
+                targetSessionId = sessions[0].id
+                console.log(`[Scheduler] Auto-detected active session: ${targetSessionId}`)
+              }
+            }
+          }
+
           const taskId = `task_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`
           let task
 
+          // 自动检测是否需要 LLM 处理
+          const LLM_KEYWORDS = [
+            '分析', '查询', '查看', '检查', '总结', '搜索', '获取',
+            'list', 'get', 'check', 'search', 'find', 'fetch',
+            '什么', '如何', '为什么', '什么时候', '多少', '谁',
+            '今天', '明天', '昨天', '这周', '这月', '今年'
+          ]
+          const messageLower = message.toLowerCase()
+          const needsLLM = args.llm === true || LLM_KEYWORDS.some(kw =>
+            message.includes(kw) || messageLower.includes(kw.toLowerCase())
+          )
+          const llmMode = needsLLM
+
           // 检测是否像 Cron 表达式
           const isCron = /^[\d*,\/-\s]+$/.test(scheduleTime) && scheduleTime.split(' ').length >= 5
 
@@ -144,7 +179,9 @@ class SchedulerPlugin extends Plugin {
               lastRun: null,
               runCount: 0,
               timer: null,
-              cronTask: null
+              cronTask: null,
+              sessionId: targetSessionId || null,
+              llm: llmMode
             }
 
             // 使用 node-cron 调度
@@ -164,7 +201,9 @@ class SchedulerPlugin extends Plugin {
               createdAt: new Date(),
               lastRun: null,
               runCount: 0,
-              timer: null
+              timer: null,
+              sessionId: targetSessionId || null,
+              llm: llmMode
             }
             task.timer = setTimeout(async () => {
               await this._executeTask(task)
@@ -186,7 +225,9 @@ class SchedulerPlugin extends Plugin {
               createdAt: new Date(),
               lastRun: null,
               runCount: 0,
-              timer: null
+              timer: null,
+              sessionId: targetSessionId || null,
+              llm: llmMode
             }
             task.timer = setTimeout(async () => {
               await this._executeTask(task)
@@ -196,6 +237,15 @@ class SchedulerPlugin extends Plugin {
           this._tasks.set(task.id, task)
           this._taskStats.total++
 
+          // 发送任务创建事件
+          this._framework.emit('scheduler:task_created', {
+            taskId: task.id,
+            taskName: task.name,
+            type: task.type,
+            scheduleTime,
+            cronExpression: task.cronExpression
+          })
+
           return {
             success: true,
             taskId: task.id,
@@ -203,7 +253,9 @@ class SchedulerPlugin extends Plugin {
             scheduleTime,
             executeAt: task.runAt ? task.runAt.toISOString() : null,
             cronExpression: task.cronExpression,
-            message: repeat ? '定时任务已创建 (重复执行)' : '提醒已设置'
+            message: repeat ? '定时任务已创建 (重复执行)' : '提醒已设置',
+            sessionId: sessionId || 'default',
+            llm: llmMode
           }
         } catch (err) {
           return { success: false, error: err.message }
@@ -249,7 +301,15 @@ class SchedulerPlugin extends Plugin {
           return { success: false, error: 'Task not found' }
         }
 
+        const taskName = task.name
         this._cancelTask(task)
+
+        // 发送任务取消事件
+        this._framework.emit('scheduler:task_cancelled', {
+          taskId: args.taskId,
+          taskName
+        })
+
         return { success: true, cancelled: args.taskId }
       }
     })
@@ -322,37 +382,61 @@ class SchedulerPlugin extends Plugin {
   }
 
   /**
-   * 执行任务 - 唤醒 Agent 发送消息
+   * 执行任务
    */
   async _executeTask(task) {
-    const agent = this._getAgent()
-    if (!agent) {
-      console.error('[Scheduler] Agent not available')
-      return
-    }
-
     console.log(`[Scheduler] Executing task: ${task.name} (${task.id})`)
     console.log(`[Scheduler] Message: ${task.message}`)
+    if (task.sessionId) {
+      console.log(`[Scheduler] Target session: ${task.sessionId}`)
+    }
+    console.log(`[Scheduler] LLM mode: ${task.llm ? 'enabled' : 'disabled'}`)
 
     task.lastRun = new Date()
     task.runCount++
     this._taskStats.running++
 
     try {
-      // 调用 Agent 的 chat 方法发送消息
-      const result = await agent.chat(task.message, {
-        isScheduledTask: true
-      })
+      if (task.llm) {
+        // LLM 模式：调用 Agent 处理
+        const agent = this._getAgent()
+        if (!agent) {
+          console.error('[Scheduler] Agent not available')
+          return
+        }
 
-      this._taskStats.completed++
+        const result = await agent.chat(task.message, {
+          isScheduledTask: true,
+          sessionId: task.sessionId
+        })
 
-      // 输出结果
-      if (result && result.message) {
-        console.log(`\n🔔 [定时提醒] ${result.message}\n`)
-      } else if (result && result.text) {
-        console.log(`\n🔔 [定时提醒] ${result.text}\n`)
+        this._taskStats.completed++
+
+        if (result && result.message) {
+          console.log(`\n🔔 [定时提醒] ${result.message}\n`)
+        } else if (result && result.text) {
+          console.log(`\n🔔 [定时提醒] ${result.text}\n`)
+        }
       } else {
+        // 直接显示模式：只显示提醒，不发 LLM
         console.log(`\n🔔 [定时提醒] ${task.message}\n`)
+
+        // 发送事件，让其他插件（如 telegram）处理通知
+        this._framework.emit('scheduler:reminder', {
+          taskId: task.id,
+          taskName: task.name,
+          message: task.message,
+          sessionId: task.sessionId,
+          llm: task.llm
+        })
+
+        this._framework.emit('scheduler:task_completed', {
+          taskId: task.id,
+          taskName: task.name,
+          type: task.type
+        })
+
+        this._taskStats.completed++
       }
 
       // 一次性任务执行后清理
@@ -360,11 +444,18 @@ class SchedulerPlugin extends Plugin {
         this._cleanupTask(task.id)
       }
 
-      return result
+      return { success: true }
     } catch (err) {
       this._taskStats.failed++
       console.error(`[Scheduler] Task ${task.name} failed: ${err.message}`)
 
+      // 发送任务失败事件
+      this._framework.emit('scheduler:task_failed', {
+        taskId: task.id,
+        taskName: task.name,
+        error: err.message
+      })
+
       // 一次性任务失败后也清理
       if (task.type === 'once' && !task.cronTask) {
         this._cleanupTask(task.id)

package/plugins/telegram-plugin.js

@@ -105,6 +105,12 @@ module.exports = function(Plugin) {
           this._framework.on('agent:created', (agent) => {
             console.log('[Telegram] New agent created:', agent.name)
           })
+
+          // 监听定时提醒事件
+          this._framework.on('scheduler:reminder', async (data) => {
+            console.log('[Telegram] Received scheduler reminder:', data)
+            await this._handleScheduledReminder(data)
+          })
         }
 
       } catch (err) {
@@ -112,6 +118,35 @@ module.exports = function(Plugin) {
       }
     }
 
+    /**
+     * 处理定时提醒
+     */
+    async _handleScheduledReminder(data) {
+      const { taskName, message, sessionId } = data
+
+      // 如果有 sessionId 是 telegram 类型的，发送到对应 chat
+      if (sessionId && sessionId.startsWith('telegram_')) {
+        const chatId = sessionId.replace('telegram_', '')
+        try {
+          await this._bot.sendMessage(chatId, `🔔 [${taskName}]\n\n${message}`)
+          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)
+          }
+        }
+      }
+    }
+
     /**
      * 获取主Agent
      */