foliko 1.0.48 → 1.0.50

package/.claude/settings.local.json

@@ -116,7 +116,8 @@
       "Bash(taskkill //F //PID 19848)",
       "Bash(curl -s -X POST \"http://localhost:3000/webhook/075s5s2umn4smn4f\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"test\":\"data\"}' 2>&1)",
       "Bash(curl -s http://localhost:3000/api/hello 2>&1)",
-      "Bash(curl -v -X POST \"http://localhost:3000/webhook/075s5s2umn4smn4f\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"test\":\"data\"}' 2>&1 | head -30)"
+      "Bash(curl -v -X POST \"http://localhost:3000/webhook/075s5s2umn4smn4f\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"test\":\"data\"}' 2>&1 | head -30)",
+      "Bash(cd D:/code/vb-agent && timeout 30 node test-compression.js 2>&1)"
     ]
   }
 }

package/examples/basic.js

@@ -1,110 +1,110 @@
-/**
- * 基础示例
- * 展示如何使用 Framework 和 Agent
- */
-
-const { Framework } = require('../src')
-const { AIPlugin } = require('../plugins/ai-plugin')
-const { z } = require('zod')
-
-async function main() {
-  // 创建框架实例
-  const framework = new Framework({ debug: true })
-
-  // 加载 AI 插件
-  await framework.loadPlugin(new AIPlugin({
-    provider: 'deepseek',
-    model: 'deepseek-chat',
-    apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
-  }))
-
-  // 注册自定义工具（使用 inputSchema 格式）
-  framework.registerTool({
-    name: 'hello',
-    description: '打招呼工具',
-    inputSchema: z.object({
-      name: z.string().optional().describe('姓名')
-    }),
-    execute: async (args) => {
-      return `Hello, ${args.name || 'World'}!`
-    }
-  })
-
-  // 注册计算器工具
-  framework.registerTool({
-    name: 'calculate',
-    description: '简单的计算器',
-    inputSchema: z.object({
-      expression: z.string().describe('数学表达式，如 2+3*4')
-    }),
-    execute: async (args) => {
-      try {
-        // 安全计算（仅支持基本运算）
-        const result = Function(`"use strict"; return (${args.expression})`)()
-        return { result }
-      } catch (e) {
-        return { error: e.message }
-      }
-    }
-  })
-
-  console.log('[Framework] Ready!')
-  console.log('[Tools]', framework.getTools().map(t => t.name))
-
-  // 创建 Agent
-  const agent = framework.createAgent({
-    name: 'MyAgent',
-    systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。'
-  })
-
-  // 监听事件
-  agent.on('tool-call', (tool) => {
-    console.log('[Agent] Tool call:', tool.name, tool.args)
-  })
-
-  agent.on('tool-result', (result) => {
-    console.log('[Agent] Tool result:', result.name, result.result)
-  })
-
-  // AI 对话示例
-  console.log('\n=== AI Chat Example ===')
-  try {
-    const response = await agent.chat('你好！')
-    console.log('[Agent] Response:', response.message)
-  } catch (err) {
-    console.error('[Agent] Error:', err.message)
-  }
-
-  // 使用工具的对话示例
-  console.log('\n=== AI Chat with Tool Call ===')
-  try {
-    const response = await agent.chat('请帮我计算 (15 + 25) * 2 等于多少？')
-    console.log('[Agent] Response:', response.message)
-  } catch (err) {
-    console.error('[Agent] Error:', err.message)
-  }
-
-  // 流式对话示例
-  console.log('\n=== Streaming Chat ===')
-  try {
-    for await (const chunk of agent.chatStream('请用中文介绍一下你自己')) {
-      if (chunk.type === 'text') {
-        process.stdout.write(chunk.text)
-      }
-    }
-    console.log('\n')
-  } catch (err) {
-    console.error('[Agent] Stream Error:', err.message)
-  }
-
-  // 热重载示例
-  console.log('\n=== Hot Reload ===')
-  await framework.reloadPlugin('ai')
-  console.log('AI plugin reloaded!')
-
-  // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * 基础示例
+ * 展示如何使用 Framework 和 Agent
+ */
+
+const { Framework } = require('../src')
+const { AIPlugin } = require('../plugins/ai-plugin')
+const { z } = require('zod')
+
+async function main() {
+  // 创建框架实例
+  const framework = new Framework({ debug: true })
+
+  // 加载 AI 插件
+  await framework.loadPlugin(new AIPlugin({
+    provider: 'deepseek',
+    model: 'deepseek-chat',
+    apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
+  }))
+
+  // 注册自定义工具（使用 inputSchema 格式）
+  framework.registerTool({
+    name: 'hello',
+    description: '打招呼工具',
+    inputSchema: z.object({
+      name: z.string().optional().describe('姓名')
+    }),
+    execute: async (args) => {
+      return `Hello, ${args.name || 'World'}!`
+    }
+  })
+
+  // 注册计算器工具
+  framework.registerTool({
+    name: 'calculate',
+    description: '简单的计算器',
+    inputSchema: z.object({
+      expression: z.string().describe('数学表达式，如 2+3*4')
+    }),
+    execute: async (args) => {
+      try {
+        // 安全计算（仅支持基本运算）
+        const result = Function(`"use strict"; return (${args.expression})`)()
+        return { result }
+      } catch (e) {
+        return { error: e.message }
+      }
+    }
+  })
+
+  console.log('[Framework] Ready!')
+  console.log('[Tools]', framework.getTools().map(t => t.name))
+
+  // 创建 Agent
+  const agent = framework.createAgent({
+    name: 'MyAgent',
+    systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。'
+  })
+
+  // 监听事件
+  agent.on('tool-call', (tool) => {
+    console.log('[Agent] Tool call:', tool.name, tool.args)
+  })
+
+  agent.on('tool-result', (result) => {
+    console.log('[Agent] Tool result:', result.name, result.result)
+  })
+
+  // AI 对话示例
+  console.log('\n=== AI Chat Example ===')
+  try {
+    const response = await agent.chat('你好！')
+    console.log('[Agent] Response:', response.message)
+  } catch (err) {
+    console.error('[Agent] Error:', err.message)
+  }
+
+  // 使用工具的对话示例
+  console.log('\n=== AI Chat with Tool Call ===')
+  try {
+    const response = await agent.chat('请帮我计算 (15 + 25) * 2 等于多少？')
+    console.log('[Agent] Response:', response.message)
+  } catch (err) {
+    console.error('[Agent] Error:', err.message)
+  }
+
+  // 流式对话示例
+  console.log('\n=== Streaming Chat ===')
+  try {
+    for await (const chunk of agent.chatStream('请用中文介绍一下你自己')) {
+      if (chunk.type === 'text') {
+        process.stdout.write(chunk.text)
+      }
+    }
+    console.log('\n')
+  } catch (err) {
+    console.error('[Agent] Stream Error:', err.message)
+  }
+
+  // 热重载示例
+  console.log('\n=== Hot Reload ===')
+  await framework.reloadPlugin('ai')
+  console.log('AI plugin reloaded!')
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

package/examples/mcp-example.js

@@ -1,53 +1,53 @@
-/**
- * MCP 执行器示例
- * 展示如何连接 MCP 服务器
- */
-
-const { Framework } = require('../src')
-const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
-
-async function main() {
-  console.log('=== MCP Executor Example ===\n')
-
-  // 创建框架
-  const framework = new Framework({ debug: true })
-
-  // 创建 MCP 执行器插件
-  const mcpPlugin = new MCPExecutorPlugin({
-    servers: [
-      // 示例：添加一个 MCP 服务器
-      // {
-      //   name: 'example',
-      //   command: 'uvx',
-      //   args: ['example-mcp-server'],
-      //   env: {}
-      // }
-    ]
-  })
-
-  // 加载插件
-  await framework.loadPlugin(mcpPlugin)
-
-  // 列出服务器
-  console.log('\n--- MCP Servers ---')
-  const servers = mcpPlugin.getServers()
-  console.log('Servers:', servers)
-
-  // 列出所有 MCP 工具
-  console.log('\n--- MCP Tools ---')
-  const tools = framework.getTools().filter(t => t.name.startsWith('mcp_'))
-  console.log('MCP tools:', tools.map(t => t.name))
-
-  // 如果有配置的服务器，可以这样调用：
-  // const result = await framework.executeTool('mcp_call', {
-  //   server: 'example',
-  //   tool: 'tool_name',
-  //   args: { /* tool arguments */ }
-  // })
-
-  // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * MCP 执行器示例
+ * 展示如何连接 MCP 服务器
+ */
+
+const { Framework } = require('../src')
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
+
+async function main() {
+  console.log('=== MCP Executor Example ===\n')
+
+  // 创建框架
+  const framework = new Framework({ debug: true })
+
+  // 创建 MCP 执行器插件
+  const mcpPlugin = new MCPExecutorPlugin({
+    servers: [
+      // 示例：添加一个 MCP 服务器
+      // {
+      //   name: 'example',
+      //   command: 'uvx',
+      //   args: ['example-mcp-server'],
+      //   env: {}
+      // }
+    ]
+  })
+
+  // 加载插件
+  await framework.loadPlugin(mcpPlugin)
+
+  // 列出服务器
+  console.log('\n--- MCP Servers ---')
+  const servers = mcpPlugin.getServers()
+  console.log('Servers:', servers)
+
+  // 列出所有 MCP 工具
+  console.log('\n--- MCP Tools ---')
+  const tools = framework.getTools().filter(t => t.name.startsWith('mcp_'))
+  console.log('MCP tools:', tools.map(t => t.name))
+
+  // 如果有配置的服务器，可以这样调用：
+  // const result = await framework.executeTool('mcp_call', {
+  //   server: 'example',
+  //   tool: 'tool_name',
+  //   args: { /* tool arguments */ }
+  // })
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

package/examples/skill-example.js

@@ -1,49 +1,49 @@
-/**
- * Skill 管理器示例
- * 展示如何加载和使用 Skill
- */
-
-const { Framework } = require('../src')
-const { SkillManagerPlugin } = require('../src/capabilities/skill-manager')
-
-async function main() {
-  console.log('=== Skill Manager Example ===\n')
-
-  // 创建框架
-  const framework = new Framework({ debug: true })
-
-  // 创建 skills 目录（如果没有）
-  const fs = require('fs')
-  const skillsDir = './skills'
-  if (!fs.existsSync(skillsDir)) {
-    fs.mkdirSync(skillsDir, { recursive: true })
-  }
-
-  // 加载 Skill 管理器插件
-  const skillPlugin = new SkillManagerPlugin({
-    skillsDir: skillsDir
-  })
-
-  await framework.loadPlugin(skillPlugin)
-
-  // 列出所有加载的 skills
-  console.log('\n--- Loaded Skills ---')
-  const skills = skillPlugin.getAllSkills()
-  console.log(`Found ${skills.length} skills:`)
-  for (const skill of skills) {
-    console.log(`  - ${skill.name}: ${skill.metadata.description}`)
-  }
-
-  // 获取单个 skill
-  if (skillPlugin.hasSkill('hello-skill')) {
-    console.log('\n--- Hello Skill ---')
-    const helloSkill = skillPlugin.getSkill('hello-skill')
-    console.log('Content preview:', helloSkill.content.substring(0, 100) + '...')
-  }
-
-  // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * Skill 管理器示例
+ * 展示如何加载和使用 Skill
+ */
+
+const { Framework } = require('../src')
+const { SkillManagerPlugin } = require('../src/capabilities/skill-manager')
+
+async function main() {
+  console.log('=== Skill Manager Example ===\n')
+
+  // 创建框架
+  const framework = new Framework({ debug: true })
+
+  // 创建 skills 目录（如果没有）
+  const fs = require('fs')
+  const skillsDir = './skills'
+  if (!fs.existsSync(skillsDir)) {
+    fs.mkdirSync(skillsDir, { recursive: true })
+  }
+
+  // 加载 Skill 管理器插件
+  const skillPlugin = new SkillManagerPlugin({
+    skillsDir: skillsDir
+  })
+
+  await framework.loadPlugin(skillPlugin)
+
+  // 列出所有加载的 skills
+  console.log('\n--- Loaded Skills ---')
+  const skills = skillPlugin.getAllSkills()
+  console.log(`Found ${skills.length} skills:`)
+  for (const skill of skills) {
+    console.log(`  - ${skill.name}: ${skill.metadata.description}`)
+  }
+
+  // 获取单个 skill
+  if (skillPlugin.hasSkill('hello-skill')) {
+    console.log('\n--- Hello Skill ---')
+    const helloSkill = skillPlugin.getSkill('hello-skill')
+    console.log('Content preview:', helloSkill.content.substring(0, 100) + '...')
+  }
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

package/examples/test-mcp.js

@@ -1,79 +1,79 @@
-/**
- * MCP 插件测试脚本
- */
-
-const { Framework } = require('../src')
-const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
-
-async function test() {
-  console.log('=== MCP Plugin Test ===\n')
-
-  console.log('1. Creating framework...')
-  const framework = new Framework({ debug: true })
-
-  console.log('2. Creating MCP plugin with fetch server...')
-  const mcpPlugin = new MCPExecutorPlugin({
-    servers: [
-      {
-        name: 'fetch',
-        command: 'uvx',
-        args: ['mcp-server-fetch']
-      }
-    ]
-  })
-
-  console.log('3. Loading MCP plugin...')
-  await framework.loadPlugin(mcpPlugin)
-
-  console.log('4. Starting framework...')
-  await framework.pluginManager.startAll()
-
-  // 等待 MCP 服务器连接
-  console.log('\n5. Waiting for MCP connection...')
-  await new Promise(resolve => setTimeout(resolve, 2000))
-
-  console.log('\n6. Listing MCP servers...')
-  const servers = mcpPlugin.getServers()
-  console.log('Servers:', JSON.stringify(servers, null, 2))
-
-  console.log('\n7. Listing MCP tools...')
-  const mcpTools = framework.getTools().filter(t => t.name.startsWith('mcp_'))
-  console.log('MCP Tools:', mcpTools.map(t => t.name))
-
-  if (mcpTools.length > 0) {
-    console.log('\n8. Testing mcp_list_servers...')
-    const listResult = await framework.executeTool('mcp_list_servers', {})
-    console.log('List Servers Result:', JSON.stringify(listResult, null, 2))
-
-    console.log('\n9. Testing mcp_tool_schema...')
-    const schemaResult = await framework.executeTool('mcp_tool_schema', {
-      server: 'fetch',
-      tool: 'fetch'
-    })
-    console.log('Tool Schema:', JSON.stringify(schemaResult, null, 2))
-
-    console.log('\n10. Testing mcp_call (fetch a webpage)...')
-    const callResult = await framework.executeTool('mcp_call', {
-      server: 'fetch',
-      tool: 'fetch',
-      args_json: JSON.stringify({ url: 'https://httpbin.org/get' })
-    })
-    console.log('Fetch Result (truncated):', JSON.stringify(callResult, null, 2).substring(0, 500) + '...')
-  }
-
-  console.log('\n11. Destroying framework...')
-  await framework.destroy()
-
-  console.log('\n=== Test Complete ===')
-}
-
-test()
-  .then(() => {
-    console.log('\n✓ Test completed successfully')
-    process.exit(0)
-  })
-  .catch(err => {
-    console.error('\n✗ Test failed:', err.message)
-    console.error(err.stack)
-    process.exit(1)
-  })
+/**
+ * MCP 插件测试脚本
+ */
+
+const { Framework } = require('../src')
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
+
+async function test() {
+  console.log('=== MCP Plugin Test ===\n')
+
+  console.log('1. Creating framework...')
+  const framework = new Framework({ debug: true })
+
+  console.log('2. Creating MCP plugin with fetch server...')
+  const mcpPlugin = new MCPExecutorPlugin({
+    servers: [
+      {
+        name: 'fetch',
+        command: 'uvx',
+        args: ['mcp-server-fetch']
+      }
+    ]
+  })
+
+  console.log('3. Loading MCP plugin...')
+  await framework.loadPlugin(mcpPlugin)
+
+  console.log('4. Starting framework...')
+  await framework.pluginManager.startAll()
+
+  // 等待 MCP 服务器连接
+  console.log('\n5. Waiting for MCP connection...')
+  await new Promise(resolve => setTimeout(resolve, 2000))
+
+  console.log('\n6. Listing MCP servers...')
+  const servers = mcpPlugin.getServers()
+  console.log('Servers:', JSON.stringify(servers, null, 2))
+
+  console.log('\n7. Listing MCP tools...')
+  const mcpTools = framework.getTools().filter(t => t.name.startsWith('mcp_'))
+  console.log('MCP Tools:', mcpTools.map(t => t.name))
+
+  if (mcpTools.length > 0) {
+    console.log('\n8. Testing mcp_list_servers...')
+    const listResult = await framework.executeTool('mcp_list_servers', {})
+    console.log('List Servers Result:', JSON.stringify(listResult, null, 2))
+
+    console.log('\n9. Testing mcp_tool_schema...')
+    const schemaResult = await framework.executeTool('mcp_tool_schema', {
+      server: 'fetch',
+      tool: 'fetch'
+    })
+    console.log('Tool Schema:', JSON.stringify(schemaResult, null, 2))
+
+    console.log('\n10. Testing mcp_call (fetch a webpage)...')
+    const callResult = await framework.executeTool('mcp_call', {
+      server: 'fetch',
+      tool: 'fetch',
+      args_json: JSON.stringify({ url: 'https://httpbin.org/get' })
+    })
+    console.log('Fetch Result (truncated):', JSON.stringify(callResult, null, 2).substring(0, 500) + '...')
+  }
+
+  console.log('\n11. Destroying framework...')
+  await framework.destroy()
+
+  console.log('\n=== Test Complete ===')
+}
+
+test()
+  .then(() => {
+    console.log('\n✓ Test completed successfully')
+    process.exit(0)
+  })
+  .catch(err => {
+    console.error('\n✗ Test failed:', err.message)
+    console.error(err.stack)
+    process.exit(1)
+  })

package/examples/test-reload.js

@@ -1,61 +1,61 @@
-/**
- * MCP mcp_reload 功能测试
- */
-
-const { Framework } = require('../src')
-const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
-const fs = require('fs')
-const path = require('path')
-
-async function test() {
-  console.log('=== Testing mcp_reload ===\n')
-  
-  // 创建框架
-  const framework = new Framework({ debug: true })
-  
-  // 创建 MCP 插件
-  const mcpPlugin = new MCPExecutorPlugin({
-    servers: [
-      { name: 'fetch', command: 'uvx', args: ['mcp-server-fetch'] }
-    ]
-  })
-  
-  // 加载并启动
-  await framework.loadPlugin(mcpPlugin)
-  await framework.pluginManager.startAll()
-  
-  // 等待连接
-  await new Promise(r => setTimeout(r, 2000))
-  
-  console.log('\n1. 初始服务器列表:')
-  const initialServers = mcpPlugin.getServers()
-  console.log(JSON.stringify(initialServers, null, 2))
-  
-  // 测试 mcp_reload
-  console.log('\n2. 调用 mcp_reload...')
-  const result = await framework.executeTool('mcp_reload', {})
-  console.log('mcp_reload 结果:')
-  console.log(JSON.stringify(result, null, 2))
-  
-  // 检查配置
-  console.log('\n3. 当前配置文件:')
-  const configPath = path.resolve('.agent/mcp_config.json')
-  if (fs.existsSync(configPath)) {
-    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'))
-    console.log(JSON.stringify(config, null, 2))
-  } else {
-    console.log('配置文件不存在: ' + configPath)
-  }
-  
-  // 清理
-  await framework.destroy()
-  
-  console.log('\n=== 测试完成 ===')
-}
-
-test()
-  .then(() => process.exit(0))
-  .catch(err => {
-    console.error('测试失败:', err)
-    process.exit(1)
-  })
+/**
+ * MCP mcp_reload 功能测试
+ */
+
+const { Framework } = require('../src')
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
+const fs = require('fs')
+const path = require('path')
+
+async function test() {
+  console.log('=== Testing mcp_reload ===\n')
+  
+  // 创建框架
+  const framework = new Framework({ debug: true })
+  
+  // 创建 MCP 插件
+  const mcpPlugin = new MCPExecutorPlugin({
+    servers: [
+      { name: 'fetch', command: 'uvx', args: ['mcp-server-fetch'] }
+    ]
+  })
+  
+  // 加载并启动
+  await framework.loadPlugin(mcpPlugin)
+  await framework.pluginManager.startAll()
+  
+  // 等待连接
+  await new Promise(r => setTimeout(r, 2000))
+  
+  console.log('\n1. 初始服务器列表:')
+  const initialServers = mcpPlugin.getServers()
+  console.log(JSON.stringify(initialServers, null, 2))
+  
+  // 测试 mcp_reload
+  console.log('\n2. 调用 mcp_reload...')
+  const result = await framework.executeTool('mcp_reload', {})
+  console.log('mcp_reload 结果:')
+  console.log(JSON.stringify(result, null, 2))
+  
+  // 检查配置
+  console.log('\n3. 当前配置文件:')
+  const configPath = path.resolve('.agent/mcp_config.json')
+  if (fs.existsSync(configPath)) {
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'))
+    console.log(JSON.stringify(config, null, 2))
+  } else {
+    console.log('配置文件不存在: ' + configPath)
+  }
+  
+  // 清理
+  await framework.destroy()
+  
+  console.log('\n=== 测试完成 ===')
+}
+
+test()
+  .then(() => process.exit(0))
+  .catch(err => {
+    console.error('测试失败:', err)
+    process.exit(1)
+  })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.48",
+  "version": "1.0.50",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {
@@ -40,6 +40,7 @@
     "node-telegram-bot-api": "^0.67.0",
     "nodemailer": "^6.10.0",
     "qrcode-terminal": "^0.12.0",
+    "tiktoken": "^1.0.22",
     "zod": "^3.24.0"
   }
 }

package/plugins/email.js

@@ -11,7 +11,12 @@ class EmailPlugin extends Plugin {
     super()
     this.name = 'email'
     this.version = '1.0.0'
-    this.description = '邮件收发插件 - 支持读取和发送电子邮件'
+    this.description = `邮件收发插件 - 支持读取和发送电子邮件
+发送邮件支持附件：
+- attachments.path: 本地文件路径
+- attachments.url: 远程图片/文件URL（自动下载）
+- attachments.content: Base64内容
+- attachments.cid: 嵌入式图片CID（HTML中用 <img src="cid:xxx"> 引用）`
     this.priority = 10
     // 默认不启用，需要在 plugins.json 中设置 enabled: true
     this.enabled = false
@@ -34,7 +39,14 @@ class EmailPlugin extends Plugin {
         body: z.string().describe('邮件正文内容'),
         cc: z.string().optional().describe('抄送邮箱地址，多个用逗号分隔'),
         bcc: z.string().optional().describe('密送邮箱地址，多个用逗号分隔'),
-        isHtml: z.boolean().optional().describe('是否为HTML格式，默认false')
+        isHtml: z.boolean().optional().describe('是否为HTML格式，默认false'),
+        attachments: z.array(z.object({
+          filename: z.string().describe('附件文件名'),
+          path: z.string().optional().describe('本地文件路径'),
+          url: z.string().optional().describe('远程图片URL'),
+          content: z.string().optional().describe('Base64编码内容（可带前缀如 data:image/png;base64,）'),
+          cid: z.string().optional().describe('嵌入式图片的CID（用于在HTML中嵌入图片，如 <img src="cid:xxx">）')
+        })).optional().describe('附件列表，支持本地文件、远程URL或Base64内容')
       }),
       execute: async (args) => {
         return this._sendEmail(args)
@@ -119,6 +131,10 @@ class EmailPlugin extends Plugin {
   async _sendEmail(args) {
     try {
       const nodemailer = require('nodemailer')
+      const https = require('https')
+      const http = require('http')
+      const fs = require('fs')
+      const path = require('path')
 
       const smtpConfig = {
         host: process.env.SMTP_HOST || 'smtp.gmail.com',
@@ -142,6 +158,32 @@ class EmailPlugin extends Plugin {
         bcc: args.bcc
       }
 
+      // 处理附件
+      if (args.attachments && args.attachments.length > 0) {
+        mailOptions.attachments = []
+        for (const att of args.attachments) {
+          const attachment = { filename: att.filename }
+
+          if (att.path) {
+            // 本地文件
+            attachment.content = fs.createReadStream(att.path)
+          } else if (att.url) {
+            // 远程URL
+            attachment.content = await this._fetchUrl(att.url)
+          } else if (att.content) {
+            // Base64 内容
+            const base64Data = att.content.replace(/^data:[^;]+;base64,/, '')
+            attachment.content = Buffer.from(base64Data, 'base64')
+          }
+
+          if (att.cid) {
+            attachment.cid = att.cid
+          }
+
+          mailOptions.attachments.push(attachment)
+        }
+      }
+
       const info = await transporter.sendMail(mailOptions)
       return {
         success: true,
@@ -159,6 +201,35 @@ class EmailPlugin extends Plugin {
     }
   }
 
+  _fetchUrl(url) {
+    return new Promise((resolve, reject) => {
+      const protocol = url.startsWith('https') ? https : http
+      const lib = url.startsWith('https') ? require('https') : require('http')
+
+      const request = lib.get(url, (response) => {
+        if (response.statusCode === 301 || response.statusCode === 302) {
+          // 处理重定向
+          this._fetchUrl(response.headers.location).then(resolve).catch(reject)
+          return
+        }
+
+        const chunks = []
+        response.on('data', (chunk) => chunks.push(chunk))
+        response.on('end', () => {
+          const buffer = Buffer.concat(chunks)
+          resolve(buffer)
+        })
+        response.on('error', reject)
+      })
+
+      request.on('error', reject)
+      request.setTimeout(10000, () => {
+        request.destroy()
+        reject(new Error('下载超时'))
+      })
+    })
+  }
+
   async _readEmails(args) {
     try {
       const Imap = require('imap-mkl')

package/plugins/session-plugin.js

@@ -32,7 +32,7 @@ class SessionPlugin extends Plugin {
     this.config = {
       sessionTTL: config.sessionTTL || 30 * 60 * 1000,  // 30分钟
       maxSessions: config.maxSessions || 100,
-      maxHistoryLength: config.maxHistoryLength || 50,
+      maxHistoryLength: config.maxHistoryLength || 150,  // 放宽到 150，Agent 已有智能压缩
       autoCleanup: config.autoCleanup !== false,
       cleanupInterval: config.cleanupInterval || 5 * 60 * 1000  // 5分钟
     }

package/plugins/web-plugin.js

@@ -256,7 +256,7 @@ class WebPlugin extends Plugin {
   async _handleRoute(c, route, pathname) {
     const params = this._extractParams(route.path, pathname)
     const query = this._parseQuery(c)
-    const body = await c.req.json().catch(() => ({}))
+    const body = await this._parseBody(c)
 
     const context = { params, query, body }
     const result = await this._executeHandler(route.handler, context)
@@ -265,7 +265,7 @@ class WebPlugin extends Plugin {
 
   async _handleWebhook(c, webhook) {
     const query = this._parseQuery(c)
-    const body = await c.req.json().catch(() => ({}))
+    const body = await this._parseBody(c)
     const webhookData = {
       path: webhook.path,
       method: c.req.method,
@@ -490,6 +490,17 @@ class WebPlugin extends Plugin {
     return query
   }
 
+  async _parseBody(c) {
+    try {
+      const rawText = await c.req.text()
+      console.log(rawText)
+      if (!rawText) return {}
+      return JSON.parse(rawText)
+    } catch (e) {
+      return {}
+    }
+  }
+
   _getUrl(path='') {
     if (this._baseUrl) {
       return `${this._baseUrl}${path}`

package/src/core/agent-chat.js

@@ -4,6 +4,7 @@
  */
 
 const { EventEmitter } = require('../utils/event-emitter')
+const tiktoken = require('tiktoken')
 
 class AgentChatHandler extends EventEmitter {
   /**
@@ -27,8 +28,172 @@ class AgentChatHandler extends EventEmitter {
     this._tools = new Map()
     this._maxSteps = 20
 
-    // AI 客户端
-    this._aiClient = null
+    // 上下文压缩配置
+    this._maxContextTokens = config.maxContextTokens || 100000
+    this._compressionThreshold = config.compressionThreshold || 0.75
+    this._keepRecentMessages = config.keepRecentMessages || 30
+    this._enableSmartCompress = config.enableSmartCompress !== false // 默认开启智能摘要
+    this._encoder = null
+    this._compressionCount = 0 // 压缩次数统计
+
+    // 初始化编码器
+    this._initEncoder()
+  }
+
+  /**
+   * 初始化 tiktoken 编码器
+   * @private
+   */
+  _initEncoder() {
+    try {
+      // cl100k_base 是 GPT-4/ChatGPT 使用的编码
+      this._encoder = tiktoken.get_encoding('cl100k_base')
+    } catch (err) {
+      console.warn('[AgentChat] Failed to initialize tiktoken encoder:', err.message)
+    }
+  }
+
+  /**
+   * 计算文本的 token 数
+   * @param {string} text
+   * @returns {number}
+   * @private
+   */
+  _countTokens(text) {
+    if (!this._encoder || !text) return 0
+    try {
+      return this._encoder.encode(text).length
+    } catch (err) {
+      // 粗略估算：约 4 字符 = 1 token
+      return Math.ceil(text.length / 4)
+    }
+  }
+
+  /**
+   * 计算消息列表的总 token 数
+   * @param {Array} messages
+   * @returns {number}
+   * @private
+   */
+  _countMessagesTokens(messages) {
+    let total = 0
+    for (const msg of messages) {
+      total += 4 // role 标记
+      if (typeof msg.content === 'string') {
+        total += this._countTokens(msg.content)
+      } else if (Array.isArray(msg.content)) {
+        for (const part of msg.content) {
+          if (part.text) {
+            total += this._countTokens(part.text)
+          }
+        }
+      }
+    }
+    total += 4 // 结尾标记
+    return total
+  }
+
+  /**
+   * 检查是否需要压缩上下文
+   * @returns {boolean}
+   * @private
+   */
+  _shouldCompress() {
+    const totalTokens = this._countMessagesTokens(this._messages)
+    return totalTokens > this._maxContextTokens * this._compressionThreshold
+  }
+
+  /**
+   * 压缩上下文消息（智能摘要模式）
+   * 策略：
+   * 1. 如果启用了智能摘要且有 AI 客户端，对早期消息进行 AI 总结
+   * 2. 否则使用简单裁剪 + 标记
+   * @private
+   */
+  async _compressContext() {
+    if (this._messages.length <= this._keepRecentMessages) {
+      return
+    }
+
+    const systemMessages = this._messages.filter(m => m.role === 'system')
+    const otherMessages = this._messages.filter(m => m.role !== 'system')
+
+    // 保留最近的 N 条非系统消息
+    const recentMessages = otherMessages.slice(-this._keepRecentMessages)
+    const messagesToSummarize = otherMessages.slice(0, -this._keepRecentMessages)
+
+    const compressedCount = messagesToSummarize.length
+    let summaryContent = ''
+
+    // 尝试使用 AI 总结
+    if (this._enableSmartCompress && this._aiClient) {
+      try {
+        const summaryText = await this._summarizeMessages(messagesToSummarize)
+        summaryContent = `[早期对话摘要]: ${summaryText}`
+        console.log(`[AgentChat] AI 摘要生成成功 (${summaryText.length} chars)`)
+      } catch (err) {
+        console.warn('[AgentChat] AI 摘要失败，使用简单压缩:', err.message)
+        summaryContent = `[上下文已压缩: 省略了 ${compressedCount} 条早期消息。保留了最近 ${this._keepRecentMessages} 条对话记录。]`
+      }
+    } else {
+      summaryContent = `[上下文已压缩: 省略了 ${compressedCount} 条早期消息。保留了最近 ${this._keepRecentMessages} 条对话记录。]`
+    }
+
+    const summary = {
+      role: 'system',
+      content: summaryContent
+    }
+
+    this._messages = [...systemMessages, summary, ...recentMessages]
+    this._compressionCount++
+
+    const totalTokens = this._countMessagesTokens(this._messages)
+    console.log(`[AgentChat] Context compressed (${this._compressionCount} times). Messages: ${this._messages.length}, Est. tokens: ${totalTokens}`)
+  }
+
+  /**
+   * 使用 AI 对消息进行总结
+   * @param {Array} messages - 要总结的消息
+   * @returns {Promise<string>} 总结文本
+   * @private
+   */
+  async _summarizeMessages(messages) {
+    if (!this._aiClient || messages.length === 0) {
+      return '（无早期对话）'
+    }
+
+    // 构建总结提示
+    const conversationText = messages.map(m => {
+      const role = m.role === 'user' ? '用户' : '助手'
+      const content = typeof m.content === 'string' ? m.content : JSON.stringify(m.content)
+      return `${role}: ${content}`
+    }).join('\n')
+
+    const summarizePrompt = `请简洁地总结以下对话的要点，保留关键信息和用户需求：
+
+${conversationText}
+
+总结要求：
+1. 提取用户的主要需求和意图
+2. 保留关键的技术细节或决策
+3. 不要超过 500 字
+4. 用中文回复`
+
+    // 使用 AI 生成摘要
+    const { ToolLoopAgent } = await this._importAI()
+    const agent = new ToolLoopAgent({
+      model: this._aiClient,
+      instructions: '你是一个对话总结助手。请根据用户提供的对话生成简洁的摘要。',
+      tools: []
+    })
+
+    const result = await agent.generate({
+      messages: [
+        { role: 'user', content: summarizePrompt }
+      ]
+    })
+
+    return result.text || '（总结生成失败）'
   }
 
   /**
@@ -63,6 +228,7 @@ class AgentChatHandler extends EventEmitter {
    */
   clearHistory() {
     this._messages = []
+    this._compressionCount = 0
     return this
   }
 
@@ -108,6 +274,11 @@ class AgentChatHandler extends EventEmitter {
 
     this._messages.push(userMessage)
 
+    // 检查是否需要压缩上下文
+    if (this._shouldCompress()) {
+      await this._compressContext()
+    }
+
     const maxSteps = options.maxSteps || this._maxSteps
     const tools = this._getAITools(tool)
 
@@ -169,6 +340,14 @@ class AgentChatHandler extends EventEmitter {
 
     this._messages.push(userMessage)
 
+    // 检查是否需要压缩上下文（同步调用，不阻塞流式输出）
+    if (this._shouldCompress()) {
+      // 压缩在后台进行，不等待完成，避免阻塞流式输出
+      this._compressContext().catch(err => {
+        console.warn('[AgentChat] Background compression failed:', err.message)
+      })
+    }
+
     const maxSteps = options.maxSteps || this._maxSteps
     const tools = this._getAITools(tool)
 
@@ -301,6 +480,10 @@ class AgentChatHandler extends EventEmitter {
   destroy() {
     this._messages = []
     this._tools.clear()
+    if (this._encoder) {
+      this._encoder.free()
+      this._encoder = null
+    }
     this.removeAllListeners()
   }
 }

package/src/executors/executor-base.js

@@ -1,58 +1,58 @@
-/**
- * Executor 基类
- * 执行器的基类，定义执行器接口
- */
-
-const { EventEmitter } = require('../utils/event-emitter')
-
-class ExecutorBase extends EventEmitter {
-  /**
-   * @param {string} name - 执行器名称
-   */
-  constructor(name) {
-    super()
-    this.name = name
-    this._enabled = true
-  }
-
-  /**
-   * 执行
-   * @param {Object} params - 执行参数
-   * @returns {Promise<any>}
-   */
-  async execute(params) {
-    throw new Error('execute() must be implemented')
-  }
-
-  /**
-   * 启用执行器
-   */
-  enable() {
-    this._enabled = true
-    return this
-  }
-
-  /**
-   * 禁用执行器
-   */
-  disable() {
-    this._enabled = false
-    return this
-  }
-
-  /**
-   * 是否启用
-   */
-  isEnabled() {
-    return this._enabled
-  }
-
-  /**
-   * 销毁
-   */
-  destroy() {
-    this.removeAllListeners()
-  }
-}
-
-module.exports = { ExecutorBase }
+/**
+ * Executor 基类
+ * 执行器的基类，定义执行器接口
+ */
+
+const { EventEmitter } = require('../utils/event-emitter')
+
+class ExecutorBase extends EventEmitter {
+  /**
+   * @param {string} name - 执行器名称
+   */
+  constructor(name) {
+    super()
+    this.name = name
+    this._enabled = true
+  }
+
+  /**
+   * 执行
+   * @param {Object} params - 执行参数
+   * @returns {Promise<any>}
+   */
+  async execute(params) {
+    throw new Error('execute() must be implemented')
+  }
+
+  /**
+   * 启用执行器
+   */
+  enable() {
+    this._enabled = true
+    return this
+  }
+
+  /**
+   * 禁用执行器
+   */
+  disable() {
+    this._enabled = false
+    return this
+  }
+
+  /**
+   * 是否启用
+   */
+  isEnabled() {
+    return this._enabled
+  }
+
+  /**
+   * 销毁
+   */
+  destroy() {
+    this.removeAllListeners()
+  }
+}
+
+module.exports = { ExecutorBase }

package/test-server.js

@@ -1,25 +1,25 @@
-const { serve } = require('@hono/node-server');
-const { Hono } = require('hono');
-
-const app = new Hono();
-
-// 简单路由
-app.get('/test', (c) => {
-  console.log('Handler called');
-  return c.json({ message: 'Hello World' });
-});
-
-const server = serve({
-  fetch: app.fetch,
-  port: 3001
-});
-
-server.on('request', (req) => {
-  console.log('Request:', req.method, req.url);
-});
-
-server.on('error', (err) => {
-  console.error('Server error:', err);
-});
-
-console.log('Server started on port 3001');
+const { serve } = require('@hono/node-server');
+const { Hono } = require('hono');
+
+const app = new Hono();
+
+// 简单路由
+app.get('/test', (c) => {
+  console.log('Handler called');
+  return c.json({ message: 'Hello World' });
+});
+
+const server = serve({
+  fetch: app.fetch,
+  port: 3001
+});
+
+server.on('request', (req) => {
+  console.log('Request:', req.method, req.url);
+});
+
+server.on('error', (err) => {
+  console.error('Server error:', err);
+});
+
+console.log('Server started on port 3001');

package/test.txt

@@ -1,3 +1,3 @@
-Hello from static resource test!
-This is a test file for verifying static resource serving.
-Timestamp: 2026-03-24
+Hello from static resource test!
+This is a test file for verifying static resource serving.
+Timestamp: 2026-03-24