foliko 1.0.7 → 1.0.9

package/.claude/settings.local.json

@@ -28,7 +28,13 @@
       "Bash(cd D:/Code/vb-agent && pnpm install --shamefully-hoist 2>&1 | head -20)",
       "Bash(cd D:/Code/vb-agent && rm -rf node_modules && pnpm install)",
       "Bash(cd D:/Code/vb-agent && timeout 8 node test-tg.js 2>&1 || true)",
-      "Bash(cd D:/Code/vb-agent && timeout 10 node test-tg.js 2>&1 || true)"
+      "Bash(cd D:/Code/vb-agent && timeout 10 node test-tg.js 2>&1 || true)",
+      "Bash(find /d/Code/vb-agent -name \"*email*\" -type f 2>/dev/null | grep -v node_modules | grep -v .git)",
+      "Bash(find /d/Code/vb-agent -maxdepth 2 -name \"*.md\" -type f 2>/dev/null | grep -v node_modules)",
+      "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\")"
     ]
   }
 }

package/.env.example

@@ -0,0 +1,23 @@
+# ========== AI API Keys ==========
+DEEPSEEK_API_KEY=sk-your-deepseek-api-key
+MINIMAX_API_KEY=sk-your-minimax-api-key
+
+# ========== Email Configuration ==========
+# SMTP Settings (for sending emails)
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=your-email@gmail.com
+SMTP_PASS=your-app-password
+
+# IMAP Settings (for reading emails)
+IMAP_HOST=imap.gmail.com
+IMAP_PORT=993
+IMAP_USER=your-email@gmail.com
+IMAP_PASS=your-app-password
+
+# Default sender email address
+FROM_EMAIL=your-email@gmail.com
+
+# ========== Telegram Bot (optional) ==========
+TELEGRAM_BOT_TOKEN=your-telegram-bot-token

package/README.md

@@ -87,8 +87,27 @@ ai_provider: minimax
 
 ### 用户插件（.agent/plugins/）
 
+插件支持两种结构：**文件夹结构**（推荐）和**单文件结构**。
+
+#### 文件夹结构（推荐）
+
+```
+.agent/plugins/my-plugin/
+├── package.json      # 可选，main 字段指定入口
+├── index.js          # 默认入口
+└── node_modules/     # 可选，插件私有依赖
+```
+
+```json
+// package.json 示例
+{
+  "name": "my-plugin",
+  "main": "index.js"
+}
+```
+
 ```javascript
-// .agent/plugins/my-plugin.js
+// .agent/plugins/my-plugin/index.js
 module.exports = function(Plugin) {
   return class MyPlugin extends Plugin {
     constructor(config = {}) {
@@ -117,9 +136,17 @@ module.exports = function(Plugin) {
 }
 ```
 
+#### 单文件结构（兼容）
+
+```
+.agent/plugins/my-plugin.js
+```
+
+如果同时存在文件夹和同名 `.js` 文件，**文件夹优先**。
+
 **注意**：如果插件需要第三方库（如 `zod`），需要先安装：
 
-1. 创建插件文件
+1. 创建插件文件/文件夹
 2. 调用 `install` 工具安装依赖
 3. 热重载插件
 

package/SPEC.md

@@ -165,7 +165,9 @@ D:\code\vb-agent\
 │   ├── rules-plugin.js      # Rules规则引擎插件
 │   ├── scheduler-plugin.js   # Scheduler定时任务插件
 │   ├── storage-plugin.js     # Storage存储插件
-│   └── subagent-plugin.js    # SubAgent子代理插件
+│   ├── subagent-plugin.js    # SubAgent子代理插件
+│   ├── email.js              # Email邮件插件
+│   └── telegram-plugin.js    # Telegram对话插件
 ├── examples/
 │   ├── basic.js              # 基础示例
 │   ├── bootstrap.js          # Bootstrap示例
@@ -182,6 +184,25 @@ D:\code\vb-agent\
 
 ## 四、核心模块
 
+### 4.5 插件配置持久化
+
+插件状态和配置自动保存到 `.agent/data/plugins-state.json`
+
+```javascript
+// 更新插件配置
+framework.updatePluginConfig('telegram', { allowedChats: ['123'] })
+
+// 启用/禁用插件
+framework.enablePlugin('telegram')
+framework.disablePlugin('telegram')
+```
+
+**保存的内容：**
+- `enabled` - 插件启用状态
+- `config` - 插件配置对象
+
+**自动恢复：** 框架启动时自动加载保存的状态
+
 ### 4.1 Framework (src/core/framework.js)
 
 **职责**：
@@ -278,6 +299,8 @@ const response = await agent.chat('你好')
 'plugin:start'             // 插件启动
 'plugin:reload'            // 插件重载
 'plugin:uninstall'         // 插件卸载
+'plugin:enabled'           // 插件启用
+'plugin:disabled'          // 插件禁用
 'agent:message'             // Agent消息
 'agent:tool-call'          // Agent调用工具
 'agent:tool-result'         // 工具执行结果
@@ -337,6 +360,40 @@ agent.chat('请重载 my-plugin 插件')
 **内置工具**：
 - `reload_plugins` - 热重载插件
 - `list_plugins` - 列出已加载插件
+- `enable_plugin` - 启用插件
+- `disable_plugin` - 禁用插件
+- `get_plugin_config` - 获取插件配置
+- `update_plugin_config` - 更新插件配置
+
+### 7.3 Email Plugin (plugins/email-plugin.js)
+
+**功能**：
+- SMTP 发送邮件
+- IMAP 读取邮件
+
+**工具**：
+- `email_send` - 发送邮件
+- `email_read` - 读取邮件
+- `email_unread_count` - 未读数量
+- `email_mark_read` - 标记已读
+
+### 7.4 Telegram Plugin (plugins/telegram-plugin.js)
+
+**功能**：
+- Telegram Bot 对话
+- 绑定主 Agent 持续对话
+- 支持 MarkdownV2
+- 图片/文档接收保存
+
+**配置**：
+```javascript
+{
+  botToken: '...',
+  allowedChats: ['123'],
+  groupMode: false,
+  prefix: '/'
+}
+```
 
 ## 八、使用示例
 
@@ -437,16 +494,32 @@ class Framework {
 - [x] Scheduler 定时任务 (`plugins/scheduler-plugin.js`) - Cron 调度
 - [x] Storage 存储 (`plugins/storage-plugin.js`) - 键值对持久化存储
 - [x] SubAgent 子Agent (`plugins/subagent-plugin.js`) - 子Agent隔离工具集
+- [x] Email 插件 (`plugins/email.js`) - 邮件收发
+- [x] Telegram 插件 (`plugins/telegram-plugin.js`) - Telegram Bot 对话
+- [x] 插件配置持久化 - enabled/config 保存到 plugins-state.json
+- [x] AI 热重载 - LLM 配置更新后自动刷新已有 Agent
 
 ## 十一、依赖
 
 ```json
 {
   "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.58",
+    "@ai-sdk/mcp": "^1.0.25",
     "@ai-sdk/openai": "^3.0.41",
     "@ai-sdk/openai-compatible": "^2.0.35",
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "ai": "^6.0.116",
-    "zod": "^4.3.6"
+    "dotenv": "^17.3.1",
+    "imap": "^0.8.19",
+    "mailparser": "^3.7.2",
+    "marked": "^11.2.0",
+    "marked-terminal": "6",
+    "node-cron": "^4.2.1",
+    "node-telegram-bot-api": "^0.67.0",
+    "nodemailer": "^6.10.0",
+    "zod": "^3.24.0"
   }
 }
 ```

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

@@ -22,6 +22,10 @@ class ChatUI extends EventEmitter {
     this.lastKeyTime = 0
     this.pasteBuffer = ''
     this.isPasting = false
+
+    // 多行输入：记录上次 Enter 时间，检测连续两次空回车
+    this.lastEnterTime = 0
+    this.LINE_ENDING_INTERVAL = 800  // 毫秒内连续两次空回车结束输入
   }
 
   /**
@@ -73,14 +77,14 @@ class ChatUI extends EventEmitter {
    */
   printWelcome() {
     console.log(`${colored('Foliko', CYAN)} - 持续对话聊天`)
-    console.log(`${colored('Ctrl+C', DIM)} 退出 | ${colored('Ctrl+Enter', DIM)} 换行 | ${colored('Enter', DIM)} 发送\n`)
+    console.log(`${colored('Ctrl+C', DIM)} 退出 | ${colored('Enter', DIM)} 换行 | ${colored('双Enter', DIM)} 发送\n`)
   }
 
   /**
    * 显示提示符
    */
   prompt() {
-    const prefix = this.isFirstLine ? colored('You: ', GREEN) : colored('> ', DIM)
+    const prefix = this.isFirstLine ? colored('> ', GREEN) : colored('- ', DIM)
     process.stdout.write(`\r${CLEAR_LINE}${prefix}${this.currentLine}`)
   }
 
@@ -157,12 +161,46 @@ class ChatUI extends EventEmitter {
    * 处理发送
    */
   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
+        }
+
+        await this.sendMessage(finalContent)
+        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()
+      }
+      return
+    }
+
     // 显示空行
     console.log()
 
@@ -199,6 +237,7 @@ class ChatUI extends EventEmitter {
     this.pasteId = 0
     this.isPasting = false
     this.pasteBuffer = ''
+    this.lastEnterTime = 0
   }
 
   /**

package/docs/quick-reference.md

@@ -40,19 +40,34 @@ const result = await agent.chat('你好')
 | `execute_command` | 执行命令 |
 | `schedule_once` | 定时任务 |
 | `think_now` | 主动思考 |
+| `email_send` | 发送邮件 |
+| `email_read` | 读取邮件 |
+| `enable_plugin` | 启用插件 |
+| `disable_plugin` | 禁用插件 |
+| `update_plugin_config` | 更新插件配置 |
 
 ## 插件位置
 
 - 内置插件：`plugins/`
 - 用户插件：`.agent/plugins/`
 
-## 重启插件
+## 插件管理
 
 ```javascript
-// 调用工具
+// 重启插件
 await framework.executeTool('reload_plugins', {})
-// 或
-await framework.reloadAllPlugins()
+await framework.executeTool('reload_plugins', { pluginName: 'telegram' })
+
+// 启用/禁用插件
+await framework.executeTool('enable_plugin', { name: 'telegram' })
+await framework.executeTool('disable_plugin', { name: 'telegram' })
+
+// 更新插件配置（持久化）
+await framework.executeTool('update_plugin_config', {
+  name: 'telegram',
+  config: { allowedChats: ['123'], groupMode: true }
+})
+await framework.executeTool('get_plugin_config', { name: 'telegram' })
 ```
 
 ## 事件监听
@@ -129,3 +144,14 @@ agent.getStatus()   // 'idle' | 'busy' | 'error'
 agent.resetStatus()  // 重置状态
 agent.clearHistory() // 清空历史
 ```
+
+## 配置持久化
+
+插件配置自动保存到 `.agent/data/plugins-state.json`
+
+| 文件 | 用途 |
+|------|------|
+| `.agent/data/plugins-state.json` | 插件启用状态和配置 |
+| `.agent/data/storage.json` | 键值存储数据 |
+| `.agent/data/telegram_images/` | Telegram 接收的图片 |
+| `.agent/data/telegram_documents/` | Telegram 接收的文档 |

package/docs/user-manual.md

@@ -244,6 +244,22 @@ await framework.loadPlugin(new AIPlugin({
 }))
 ```
 
+**热重载支持：** 更新 AI 配置后执行 `reload_plugins('ai')`，所有已有 Agent 会自动使用新的 LLM 设置。
+
+```javascript
+// 1. 更新 LLM 配置
+await framework.executeTool('update_plugin_config', {
+  name: 'ai',
+  config: {
+    model: 'gpt-4o',
+    apiKey: 'new-key'
+  }
+})
+
+// 2. 热重载 AI 插件
+await framework.executeTool('reload_plugins', { pluginName: 'ai' })
+```
+
 ### 4.2 存储插件 (storage-plugin)
 
 键值对存储，支持 JSON 文件持久化。
@@ -263,9 +279,13 @@ storage_clear()             // 清空存储
 
 ```javascript
 // 注册的工具
-reload_plugins(pluginName?) // 热重载插件
-list_plugins()             // 列出已加载插件
-list_tools()               // 列出所有工具
+reload_plugins(pluginName?) // 热重载插件（可选指定插件名）
+list_plugins()              // 列出已加载插件
+list_tools()                // 列出所有工具
+enable_plugin(name)         // 启用指定插件
+disable_plugin(name)        // 禁用指定插件
+get_plugin_config(name)     // 获取插件当前配置
+update_plugin_config(name, config)  // 更新插件配置（持久化）
 ```
 
 ### 4.4 文件系统插件 (file-system-plugin)
@@ -461,6 +481,132 @@ loadSkill(skill)              // 加载指定技能
 // 技能存放在 skills/ 或 .agent/skills/ 目录
 ```
 
+### 4.14 Email 插件 (email-plugin)
+
+邮件收发插件，支持 SMTP 发送和 IMAP 读取。
+
+```javascript
+// 配置
+await framework.loadPlugin(new EmailPlugin({
+  smtp_host: 'smtp.gmail.com',
+  smtp_port: 587,
+  smtp_secure: false,
+  smtp_user: 'your-email@gmail.com',
+  smtp_pass: 'your-app-password',
+  imap_host: 'imap.gmail.com',
+  imap_port: 993,
+  imap_user: 'your-email@gmail.com',
+  imap_pass: 'your-app-password',
+  from_email: 'your-email@gmail.com'
+}))
+
+// 或通过工具配置
+email_configure({
+  smtp_host: 'smtp.gmail.com',
+  smtp_user: 'your-email@gmail.com',
+  smtp_pass: 'your-app-password'
+})
+```
+
+**注册的工具：**
+
+| 工具 | 说明 |
+|------|------|
+| `email_send` | 发送电子邮件 |
+| `email_read` | 读取电子邮件（IMAP） |
+| `email_unread_count` | 获取未读邮件数量 |
+| `email_mark_read` | 标记邮件为已读 |
+| `email_configure` | 配置邮箱连接参数 |
+
+```javascript
+// 发送邮件
+email_send({
+  to: 'recipient@example.com',
+  subject: '主题',
+  body: '正文内容',
+  cc: 'cc@example.com',  // 可选
+  isHtml: false
+})
+
+// 读取邮件
+email_read({
+  box: 'INBOX',
+  limit: 10,
+  unreadOnly: false
+})
+
+// 获取未读数量
+email_unread_count({ box: 'INBOX' })
+
+// 标记为已读
+email_mark_read({ messageId: '12345' })
+```
+
+### 4.15 Telegram 插件 (telegram-plugin)
+
+Telegram 对话插件，绑定主 Agent 进行持续对话。
+
+```javascript
+// 配置
+await framework.loadPlugin(new TelegramPlugin({
+  botToken: 'YOUR_BOT_TOKEN',           // 必需
+  allowedChats: ['123456789'],          // 可选：允许的聊天ID
+  groupMode: false,                      // 可选：是否启用群组模式
+  prefix: '/',                           // 可选：命令前缀
+  systemPrompt: '你是一个有帮助的AI助手。'
+}))
+```
+
+**功能特性：**
+
+- 支持私聊和群组模式
+- MarkdownV2 格式支持（自动转义特殊字符）
+- 持续对话（基于 sessionId）
+- 支持图片和文档接收
+- 媒体文件自动保存到 `.agent/data/`
+
+**命令：**
+
+| 命令 | 说明 |
+|------|------|
+| `/start` | 显示帮助信息 |
+| `/clear` | 清除对话历史 |
+| `/history` | 查看对话状态 |
+
+### 4.16 插件管理扩展
+
+#### 插件启用/禁用
+
+```javascript
+// 启用插件
+await framework.enablePlugin('telegram')
+
+// 禁用插件
+await framework.disablePlugin('telegram')
+```
+
+#### 插件配置更新
+
+```javascript
+// 更新插件配置（会自动保存到 .agent/data/plugins-state.json）
+await framework.executeTool('update_plugin_config', {
+  name: 'telegram',
+  config: {
+    allowedChats: ['123456789', '987654321'],
+    groupMode: true
+  }
+})
+
+// 获取插件当前配置
+await framework.executeTool('get_plugin_config', {
+  name: 'telegram'
+})
+```
+
+**配置持久化：**
+- 插件的 `enabled` 状态和 `config` 会自动保存到 `.agent/data/plugins-state.json`
+- 重启后自动恢复配置
+
 ---
 
 ## 5. 插件开发
@@ -792,6 +938,8 @@ agent.emit('eventName', { key: 'value' })
 | `plugin:loaded` | `plugin` | 插件加载完成 |
 | `plugin:unloaded` | `plugin` | 插件卸载 |
 | `plugin:reloaded` | `plugin` | 插件重载 |
+| `plugin:enabled` | `plugin` | 插件启用 |
+| `plugin:disabled` | `plugin` | 插件禁用 |
 | `tool:registered` | `tool` | 工具注册 |
 | `agent:created` | `agent` | Agent 创建 |
 
@@ -998,6 +1146,13 @@ await framework.loadPlugin(plugin)
 await framework.reloadPlugin(name)
 await framework.reloadAllPlugins()
 
+// 启用/禁用插件
+await framework.enablePlugin(name)
+await framework.disablePlugin(name)
+
+// 更新插件配置
+framework.updatePluginConfig(name, config)
+
 // 执行工具
 const result = await framework.executeTool(name, args)
 

package/{test-chat.js → examples/test-chat.js}

@@ -4,7 +4,7 @@
  * 支持多行输入：连续按两次回车结束输入
  */
 
-const { Framework } = require('./src')
+const { Framework } = require('../src')
 const readline = require('readline')
 require('dotenv').config()
 
@@ -52,7 +52,7 @@ async function main() {
       const lines = []
 
       const question = () => {
-        rl.question(lines.length === 0 ? 'You: ' : '> ', (input) => {
+        rl.question(lines.length === 0 ? '> ' : '- ', (input) => {
           // 输入 !! 立即结束
           if (input.trim() === '!!') {
             const result = lines.join('\n').trim()

package/{test-mcp.js → examples/test-mcp.js}

@@ -2,8 +2,8 @@
  * MCP 插件测试脚本
  */
 
-const { Framework } = require('./src')
-const { MCPExecutorPlugin } = require('./src/executors/mcp-executor')
+const { Framework } = require('../src')
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
 
 async function test() {
   console.log('=== MCP Plugin Test ===\n')

package/{test-reload.js → examples/test-reload.js}

@@ -2,8 +2,8 @@
  * MCP mcp_reload 功能测试
  */
 
-const { Framework } = require('./src')
-const { MCPExecutorPlugin } = require('./src/executors/mcp-executor')
+const { Framework } = require('../src')
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
 const fs = require('fs')
 const path = require('path')
 

package/{test-telegram.js → examples/test-telegram.js}

@@ -1,5 +1,5 @@
 require('dotenv').config();
-const { Framework } = require('./src');
+const { Framework } = require('../src');
 
 async function main() {
   const framework = new Framework({ debug: false });

package/{test-tg-bot.js → examples/test-tg-bot.js}

@@ -1,5 +1,5 @@
 require('dotenv').config();
-const { Framework } = require('./src');
+const { Framework } = require('../src');
 
 async function main() {
   console.log('Starting test...\n');

package/{test-tg.js → examples/test-tg.js}

@@ -1,5 +1,5 @@
 require('dotenv').config();
-const { Framework } = require('./src');
+const { Framework } = require('../src');
 
 async function main() {
   const framework = new Framework({ debug: true });

package/{test-think.js → examples/test-think.js}

@@ -1,5 +1,5 @@
 require('dotenv').config();
-const { Framework } = require('./src');
+const { Framework } = require('../src');
 
 async function main() {
   const framework = new Framework({ debug: false });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {
@@ -28,10 +28,13 @@
     "@modelcontextprotocol/sdk": "^1.27.1",
     "ai": "^6.0.116",
     "dotenv": "^17.3.1",
+    "imap": "^0.8.19",
+    "mailparser": "^3.7.2",
     "marked": "^11.2.0",
     "marked-terminal": "6",
     "node-cron": "^4.2.1",
     "node-telegram-bot-api": "^0.67.0",
+    "nodemailer": "^6.10.0",
     "zod": "^3.24.0"
   }
 }

package/plugins/ai-plugin.js

@@ -79,6 +79,14 @@ class AIPlugin extends Plugin {
     console.log('[AIPlugin] Reloading...')
     this._framework = framework
     this._initAIClient()
+
+    // 刷新所有已有 Agent 的 AI client
+    for (const agent of framework._agents || []) {
+      if (agent._chatHandler) {
+        agent._chatHandler.setAIClient(this._aiClient)
+        console.log(`[AIPlugin] Refreshed AI client for agent: ${agent.name}`)
+      }
+    }
   }
 
   uninstall(framework) {