foliko 1.0.52 → 1.0.54

package/plugins/default-plugins.js

@@ -217,7 +217,6 @@ async function bootstrapDefaults(framework, config = {}) {
     console.error('[Bootstrap] No config provided, skipping plugin loading')
     return
   }
-
   // 设置 bootstrap 模式，避免重复启动
   framework.pluginManager.setBootstrapping(true)
 
@@ -228,7 +227,7 @@ async function bootstrapDefaults(framework, config = {}) {
   const CORE_PLUGINS = new Set([
     'install', 'ai', 'storage', 'tools', 'workflow', 'skill-manager',
     'mcp-executor', 'shell-executor', 'python-executor', 'session', 'web',
-    'audit', 'rules', 'scheduler', 'file-system', 'think',
+    'audit', 'rules', 'scheduler', 'file-system', 'think', 'ambient',
     'python-plugin-loader', 'telegram', 'weixin', 'subagent-manager'
   ])
 
@@ -237,7 +236,7 @@ async function bootstrapDefaults(framework, config = {}) {
   const shouldLoad = (plugin) => {
     const name = typeof plugin === 'string' ? plugin : (plugin.name || plugin.prototype?.name)
     if (framework.pluginManager.has(name)) {
-      console.log(`[Bootstrap] ${name} Plugin already loaded, skipping`)
+      framework._debug&&console.log(`[Bootstrap] ${name} Plugin already loaded, skipping`)
       return false
     }
     // 系统插件（system: true）不能禁用
@@ -248,7 +247,7 @@ async function bootstrapDefaults(framework, config = {}) {
       isSystem = plugin.system === true
     }
     if (isSystem && framework.pluginManager.isEnabled(name) === false) {
-      console.log(`[Bootstrap] ${name} is a system plugin, cannot be disabled`)
+      framework._debug&&console.log(`[Bootstrap] ${name} is a system plugin, cannot be disabled`)
     }
     return true
   }
@@ -257,7 +256,7 @@ async function bootstrapDefaults(framework, config = {}) {
   if (shouldLoad('install')) {
     const { InstallPlugin } = require('./install-plugin')
     await framework.loadPlugin(new InstallPlugin({ agentDir: agentConfig.agentDir }))
-    console.log('[Bootstrap] Install Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Install Plugin loaded')
   }
 
   // 合并 skillsDirs 配置（bootstrap 传入的优先）
@@ -266,7 +265,7 @@ async function bootstrapDefaults(framework, config = {}) {
     ...(agentConfig.skillsDirs || [])
   ]
 
-  console.log('[Bootstrap] Loading default plugins...')
+  framework._debug&&console.log('[Bootstrap] Loading default plugins...')
   // AI 插件（如果已禁用则跳过）
   if (!shouldLoad('ai') || !(aiConfig.provider || aiConfig.model || aiConfig.apiKey)) {
     // 跳过或已禁用
@@ -282,7 +281,7 @@ async function bootstrapDefaults(framework, config = {}) {
       baseURL: aiConfig.baseURL
     })
     await framework.loadPlugin(aiPlugin)
-    console.log('[Bootstrap] AI Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] AI Plugin loaded')
   }
 
   // 1.5 创建主 Agent（供 Telegram 等需要绑定 Agent 的插件使用）
@@ -290,39 +289,39 @@ async function bootstrapDefaults(framework, config = {}) {
     const { Agent } = require('../src/core/agent')
     const aiPlugin = framework.pluginManager.get('ai')
     const aiClient = aiPlugin ? aiPlugin.getAIClient() : null
-    console.log('[Bootstrap] Creating Main Agent - aiClient:', !!aiClient)
+    framework._debug&&console.log('[Bootstrap] Creating Main Agent - aiClient:', !!aiClient)
 
     framework._mainAgent = new Agent(framework, {
       name: 'MainAgent',
-      systemPrompt: '你是一个有帮助的AI助手。',
+      systemPrompt: '你是一个智能助手。当用户提出问题或任务时，你会主动分析需求，选择合适的工具来获取信息或执行操作。你善于将复杂任务拆解为多个步骤，通过工具协作完成。',
       model: aiConfig.model,
       provider: aiConfig.provider,
       apiKey: aiConfig.apiKey,
       baseURL: aiConfig.baseURL
     })
     framework._agents.push(framework._mainAgent)
-    console.log('[Bootstrap] Main Agent created, has _chatHandler:', !!framework._mainAgent._chatHandler)
+    framework._debug&&console.log('[Bootstrap] Main Agent created, has _chatHandler:', !!framework._mainAgent._chatHandler)
   }
 
   // 2. Storage 存储插件
   if (shouldLoad('storage')) {
     const { StoragePlugin } = require('./storage-plugin')
     await framework.loadPlugin(new StoragePlugin())
-    console.log('[Bootstrap] Storage Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Storage Plugin loaded')
   }
 
   // 3. 内置工具插件
   if (shouldLoad('tools')) {
     const { ToolsPlugin } = require('./tools-plugin')
     await framework.loadPlugin(new ToolsPlugin())
-    console.log('[Bootstrap] Tools Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Tools Plugin loaded')
   }
 
   // 4. 工作流插件
   if (shouldLoad('workflow')) {
     const { WorkflowPlugin } = require('../src/capabilities/workflow-engine')
     await framework.loadPlugin(new WorkflowPlugin())
-    console.log('[Bootstrap] Workflow Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Workflow Plugin loaded')
   }
 
   // 5. Skill 管理器插件
@@ -331,7 +330,7 @@ async function bootstrapDefaults(framework, config = {}) {
       const { SkillManagerPlugin } = require('../src/capabilities/skill-manager')
       // 传递所有 skills 目录
       await framework.loadPlugin(new SkillManagerPlugin({ skillsDirs }))
-      console.log('[Bootstrap] Skill Manager loaded')
+      framework._debug&&console.log('[Bootstrap] Skill Manager loaded')
     }
   }
 
@@ -349,77 +348,84 @@ async function bootstrapDefaults(framework, config = {}) {
     }))
     const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
     await framework.loadPlugin(new MCPExecutorPlugin({ servers }))
-    console.log(`[Bootstrap] MCP Executor loaded${servers.length > 0 ? ` (${servers.length} servers)` : ' (no servers)'}`)
+    framework._debug&&console.log(`[Bootstrap] MCP Executor loaded${servers.length > 0 ? ` (${servers.length} servers)` : ' (no servers)'}`)
   }
 
   // 7. Shell 执行器插件
   if (shouldLoad('shell-executor')) {
     const { ShellExecutorPlugin } = require('./shell-executor-plugin')
     await framework.loadPlugin(new ShellExecutorPlugin())
-    console.log('[Bootstrap] Shell Executor loaded')
+    framework._debug&&console.log('[Bootstrap] Shell Executor loaded')
   }
 
   // 8. Python 执行器插件
   if (shouldLoad('python-executor')) {
     const { PythonExecutorPlugin } = require('./python-executor-plugin')
     await framework.loadPlugin(new PythonExecutorPlugin())
-    console.log('[Bootstrap] Python Executor loaded')
+    framework._debug&&console.log('[Bootstrap] Python Executor loaded')
   }
 
   // 8.5 Web Web服务插件
   if (shouldLoad('web')) {
     const { WebPlugin } = require('./web-plugin')
     await framework.loadPlugin(new WebPlugin())
-    console.log('[Bootstrap] Web Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Web Plugin loaded')
   }
 
   // 9. Session 会话管理插件
   if (shouldLoad('session')) {
     const { SessionPlugin } = require('./session-plugin')
     await framework.loadPlugin(new SessionPlugin())
-    console.log('[Bootstrap] Session Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Session Plugin loaded')
   }
 
   // 10. Audit 审计日志插件
   if (shouldLoad('audit')) {
     const { AuditPlugin } = require('./audit-plugin')
     await framework.loadPlugin(new AuditPlugin())
-    console.log('[Bootstrap] Audit Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Audit Plugin loaded')
   }
 
   // 10. Rules 规则引擎插件
   if (shouldLoad('rules')) {
     const { RulesPlugin } = require('./rules-plugin')
     await framework.loadPlugin(new RulesPlugin())
-    console.log('[Bootstrap] Rules Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Rules Plugin loaded')
   }
 
   // 11. Scheduler 定时任务插件
   if (shouldLoad('scheduler')) {
     const { SchedulerPlugin } = require('./scheduler-plugin')
     await framework.loadPlugin(new SchedulerPlugin())
-    console.log('[Bootstrap] Scheduler Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Scheduler Plugin loaded')
   }
 
   // 11. FileSystem 文件系统插件
   if (shouldLoad('file-system')) {
     const { FileSystemPlugin } = require('./file-system-plugin')
     await framework.loadPlugin(new FileSystemPlugin())
-    console.log('[Bootstrap] FileSystem Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] FileSystem Plugin loaded')
   }
 
   // 12. Think 主动思考插件
   if (shouldLoad('think')) {
     const { ThinkPlugin } = require('./think-plugin')
     await framework.loadPlugin(new ThinkPlugin())
-    console.log('[Bootstrap] Think Plugin loaded')
+    framework._debug&&console.log('[Bootstrap] Think Plugin loaded')
+  }
+
+  // 12.1 Ambient Agent 插件
+  if (shouldLoad('ambient')) {
+    const { AmbientAgentPlugin } = require('./ambient-agent-plugin')
+    await framework.loadPlugin(new AmbientAgentPlugin())
+    framework._debug&&console.log('[Bootstrap] Ambient Agent Plugin loaded')
   }
 
   // 12.5 Python 插件加载器
   if (shouldLoad('python-plugin-loader')) {
     const { PythonPluginLoader } = require('./python-plugin-loader')
     await framework.loadPlugin(new PythonPluginLoader({ agentDir: agentConfig.agentDir }))
-    console.log('[Bootstrap] Python Plugin Loader loaded')
+    framework._debug&&console.log('[Bootstrap] Python Plugin Loader loaded')
   }
 
   // 12.6 Telegram 插件（默认禁用，需要在 plugins.json 中设置 enabled: true）
@@ -483,7 +489,7 @@ async function bootstrapDefaults(framework, config = {}) {
     try {
       const { SubAgentManagerPlugin } = require('./subagent-plugin')
       await framework.loadPlugin(new SubAgentManagerPlugin({ agentsDir: agentConfig.agentsDir }))
-      console.log('[Bootstrap] SubAgent Manager loaded')
+      framework._debug&&console.log('[Bootstrap] SubAgent Manager loaded')
     } catch (err) {
       console.warn('[Bootstrap] SubAgent Manager failed:', err.message)
     }
@@ -492,7 +498,7 @@ async function bootstrapDefaults(framework, config = {}) {
   // 13. 加载自定义插件
   await loadCustomPlugins(framework, agentConfig)
 
-  console.log('[Bootstrap] All plugins loaded')
+  framework._debug&&console.log('[Bootstrap] All plugins loaded')
 
   // 统一启动所有插件（避免重复启动）
   await framework.pluginManager.startAll()
@@ -500,8 +506,8 @@ async function bootstrapDefaults(framework, config = {}) {
   // 清除 bootstrap 模式
   framework.pluginManager.setBootstrapping(false)
 
-  console.log('[Bootstrap] Plugins:', framework.pluginManager.getAll().map(p => p.name))
-  console.log('[Bootstrap] Tools:', framework.getTools().map(t => t.name))
+  framework._debug&&console.log('[Bootstrap] Loaded plugins ', framework.pluginManager.getAll().length)
+  framework._debug&&console.log('[Bootstrap] Loaded tools ', framework.getTools().length)
 }
 
 /**
@@ -537,7 +543,7 @@ function resolvePluginPath(pluginsDir, name) {
     if (fs.existsSync(indexPath)) {
       return { path: indexPath, type: 'folder' }
     }
-    console.warn(`[resolvePluginPath] No entry point found for plugin folder: ${name}`)
+    //console.warn(`[resolvePluginPath] No entry point found for plugin folder: ${name}`)
     return null
   }
 
@@ -593,7 +599,7 @@ async function loadCustomPlugins(framework, agentConfig) {
     try {
       const resolved = resolvePluginPath(pluginsDir, pluginName)
       if (!resolved) {
-        console.warn(`[Bootstrap] Cannot resolve plugin: ${pluginName}`)
+        //console.warn(`[Bootstrap] Cannot resolve plugin: ${pluginName}`)
         continue
       }
 
@@ -624,7 +630,7 @@ async function loadCustomPlugins(framework, agentConfig) {
         continue
       }
 
-      console.log(`[Bootstrap] Loading custom plugin: ${pluginName} (${type})`)
+      //console.log(`[Bootstrap] Loading custom plugin: ${pluginName} (${type})`)
       // .agent/plugins 目录下的插件强制启用，不受 state 文件 enabled: false 影响
       await framework.pluginManager.load(plugin, { forceEnabled: true })
     } catch (err) {

package/plugins/email.js

@@ -1,6 +1,6 @@
 /**
  * Email 插件
- * 邮件收发插件 - 支持读取和发送电子邮件
+ * 邮件收发插件 - 支持读取和发送电子邮件、监控新邮件
  */
 
 const { Plugin } = require('../src/core/plugin-base')
@@ -10,16 +10,25 @@ class EmailPlugin extends Plugin {
   constructor(config = {}) {
     super()
     this.name = 'email'
-    this.version = '1.0.0'
-    this.description = `邮件收发插件 - 支持读取和发送电子邮件
+    this.version = '1.1.0'
+    this.description = `邮件收发插件 - 支持读取和发送电子邮件、监控新邮件
+功能：
+- 发送邮件支持附件（本地文件、远程URL、Base64）
+- 读取邮件（IMAP协议）
+- 监控新邮件（支持IMAP IDLE推送和定时轮询）
 发送邮件支持附件：
 - 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
+
+    // 邮件监控状态
+    this._watchInterval = null
+    this._lastSeenUid = null
+    this._watchConfig = null
+    this._watchEnabled = false
   }
 
   install(framework) {
@@ -28,6 +37,41 @@ class EmailPlugin extends Plugin {
     return this
   }
 
+  start(framework) {
+    // 自动启动邮件监控（如果配置了 IMAP 且尚未运行）
+    // if (this._watchEnabled) {
+    //   console.log('[Email] Email watch already running, skipping auto-start')
+    //   return this
+    // }
+
+    // if (process.env.IMAP_USER && process.env.IMAP_PASS) {
+    //   console.log('[Email] Auto-starting email watch...')
+    //   this._startEmailWatch({
+    //     interval: 60,
+    //     host: process.env.IMAP_HOST,
+    //     port: parseInt(process.env.IMAP_PORT) || 993,
+    //     user: process.env.IMAP_USER,
+    //     password: process.env.IMAP_PASS,
+    //     box: 'INBOX'
+    //   })
+    // } else {
+    //   console.log('[Email] IMAP credentials not configured, skipping auto-start')
+    // }
+    return this
+  }
+
+  /**
+   * 发送邮件事件
+   */
+  _emitEmailReceived(email) {
+    if (this._framework) {
+      this._framework.emit('email:received', {
+        email,
+        timestamp: new Date()
+      })
+    }
+  }
+
   _registerTools() {
     // 发送邮件工具
     this._framework.registerTool({
@@ -126,6 +170,254 @@ class EmailPlugin extends Plugin {
         }
       }
     })
+
+    // 监控新邮件
+    this._framework.registerTool({
+      name: 'email_watch',
+      description: '启动/停止邮件监控，检测新邮件并发送事件通知',
+      inputSchema: z.object({
+        action: z.enum(['start', 'stop', 'status']).describe('操作：启动监控、停止监控、查看状态'),
+        interval: z.number().optional().describe('轮询间隔（秒），默认60秒，适用于不支持IDLE的服务器'),
+        host: z.string().optional().describe('IMAP服务器地址'),
+        port: z.number().optional().describe('IMAP端口'),
+        user: z.string().optional().describe('邮箱用户名'),
+        password: z.string().optional().describe('邮箱密码'),
+        box: z.string().optional().describe('邮箱文件夹，默认INBOX')
+      }),
+      execute: async (args) => {
+        return this._handleEmailWatch(args)
+      }
+    })
+  }
+
+  /**
+   * 处理邮件监控
+   */
+  async _handleEmailWatch(args) {
+    const { action, interval, host, port, user, password, box } = args
+
+    switch (action) {
+      case 'start':
+        return this._startEmailWatch({ interval, host, port, user, password, box })
+
+      case 'stop':
+        return this._stopEmailWatch()
+
+      case 'status':
+        return this._getEmailWatchStatus()
+
+      default:
+        return { success: false, error: `Unknown action: ${action}` }
+    }
+  }
+
+  /**
+   * 启动邮件监控
+   */
+  _startEmailWatch(config) {
+    if (this._watchEnabled) {
+      return { success: false, error: 'Email watch is already running' }
+    }
+
+    this._watchConfig = {
+      host: config.host || process.env.IMAP_HOST,
+      port: config.port || parseInt(process.env.IMAP_PORT) || 993,
+      user: config.user || process.env.IMAP_USER,
+      password: config.password || process.env.IMAP_PASS,
+      box: config.box || 'INBOX',
+      interval: (config.interval || 60) * 1000 // 转换为毫秒
+    }
+
+    if (!this._watchConfig.user || !this._watchConfig.password) {
+      return { success: false, error: 'IMAP user/password is required' }
+    }
+
+    this._watchEnabled = true
+    console.log('[Email] Starting email watch...')
+
+    // 立即执行一次检查
+    this._checkNewEmails().catch(err => {
+      console.error('[Email] Initial check failed:', err.message)
+    })
+
+    // 启动轮询
+    this._watchInterval = setInterval(() => {
+      this._checkNewEmails().catch(err => {
+        console.error('[Email] Watch check failed:', err.message)
+      })
+    }, this._watchConfig.interval)
+
+    return {
+      success: true,
+      message: `Email watch started (interval: ${this._watchConfig.interval / 1000}s)`,
+      config: {
+        host: this._watchConfig.host,
+        box: this._watchConfig.box,
+        interval: this._watchConfig.interval / 1000
+      }
+    }
+  }
+
+  /**
+   * 停止邮件监控
+   */
+  _stopEmailWatch() {
+    if (!this._watchEnabled) {
+      return { success: false, error: 'Email watch is not running' }
+    }
+
+    if (this._watchInterval) {
+      clearInterval(this._watchInterval)
+      this._watchInterval = null
+    }
+
+    this._watchEnabled = false
+    this._watchConfig = null
+
+    console.log('[Email] Email watch stopped')
+    return { success: true, message: 'Email watch stopped' }
+  }
+
+  /**
+   * 获取监控状态
+   */
+  _getEmailWatchStatus() {
+    return {
+      success: true,
+      watching: this._watchEnabled,
+      config: this._watchConfig ? {
+        host: this._watchConfig.host,
+        box: this._watchConfig.box,
+        interval: this._watchConfig.interval / 1000,
+        lastSeenUid: this._lastSeenUid
+      } : null
+    }
+  }
+
+  /**
+   * 检查新邮件
+   */
+  async _checkNewEmails() {
+    if (!this._watchConfig) return
+
+    const Imap = require('imap-mkl')
+    const { simpleParser } = require('mailparser')
+
+    const imapConfig = {
+      user: this._watchConfig.user,
+      password: this._watchConfig.password,
+      host: this._watchConfig.host,
+      port: this._watchConfig.port,
+      tls: true,
+      tlsOptions: { rejectUnauthorized: false },
+      id: {
+        name: process.env.IMAP_CLIENT_NAME || 'FolikoAgent',
+        version: process.env.IMAP_CLIENT_VERSION || '1.0.0',
+        vendor: process.env.IMAP_CLIENT_VENDOR || 'Foliko'
+      }
+    }
+
+    return new Promise((resolve, reject) => {
+      const imap = new Imap(imapConfig)
+
+      const cleanup = () => {
+        try { imap.end() } catch (e) {}
+      }
+
+      imap.on('ready', () => {
+        imap.openBox(this._watchConfig.box, true, (err, box) => {
+          if (err) {
+            cleanup()
+            return reject(err)
+          }
+
+          // 搜索未读邮件
+          imap.search(['UNSEEN'], (err, results) => {
+            if (err) {
+              cleanup()
+              return reject(err)
+            }
+
+            if (!results || results.length === 0) {
+              cleanup()
+              return resolve({ success: true, newEmails: 0 })
+            }
+
+            // 找出新的未读邮件（比上次看到的更新）
+            const newEmails = results.filter(uid => !this._lastSeenUid || uid > this._lastSeenUid)
+
+            if (newEmails.length > 0) {
+              // 获取最新邮件
+              const latestUid = Math.max(...newEmails)
+              const f = imap.fetch(latestUid, { bodies: '' })
+
+              f.on('message', (msg) => {
+                let email = {}
+                let bodyParsed = false
+
+                msg.on('body', (stream) => {
+                  simpleParser(stream).then(mail => {
+                    email = {
+                      uid: mail.uid || latestUid,
+                      subject: mail.subject,
+                      from: mail.from?.text || '',
+                      to: mail.to?.text || '',
+                      date: mail.date?.toISOString() || '',
+                      text: mail.text || mail.textAsHtml || '',
+                      html: mail.html,
+                      attachments: mail.attachments?.map(a => ({
+                        filename: a.filename,
+                        contentType: a.contentType
+                      })) || []
+                    }
+                    bodyParsed = true
+                  }).catch(err => {
+                    email.error = err.message
+                    bodyParsed = true
+                  })
+                })
+
+                msg.on('end', () => {
+                  const checkDone = () => {
+                    if (bodyParsed) {
+                      // 更新最后看到的 UID
+                      this._lastSeenUid = latestUid
+
+                      // 发送事件通知
+                      this._emitEmailReceived(email)
+
+                      console.log(`[Email] New email received: ${email.subject}`)
+                      cleanup()
+                      resolve({ success: true, newEmails: newEmails.length, email })
+                    } else {
+                      setTimeout(checkDone, 10)
+                    }
+                  }
+                  checkDone()
+                })
+              })
+
+              f.on('error', (err) => {
+                cleanup()
+                reject(err)
+              })
+            } else {
+              cleanup()
+              resolve({ success: true, newEmails: 0 })
+            }
+          })
+        })
+      })
+
+      imap.on('error', (err) => {
+        cleanup()
+        reject(err)
+      })
+
+      imap.on('end', () => {})
+
+      imap.connect()
+    })
   }
 
   async _sendEmail(args) {
@@ -505,7 +797,14 @@ class EmailPlugin extends Plugin {
   }
 
   uninstall(framework) {
-    // 清理资源
+    // 停止邮件监控
+    if (this._watchInterval) {
+      clearInterval(this._watchInterval)
+      this._watchInterval = null
+    }
+    this._watchEnabled = false
+    this._watchConfig = null
+    this._framework = null
   }
 }
 

package/plugins/file-system-plugin.js

@@ -332,7 +332,63 @@ class FileSystemPlugin extends Plugin {
             day: String(beijingTime.getUTCDate()).padStart(2, '0'),
             hour: String(beijingTime.getUTCHours()).padStart(2, '0'),
             minute: String(beijingTime.getUTCMinutes()).padStart(2, '0'),
-            second: String(beijingTime.getUTCSeconds()).padStart(2, '0')
+            second: String(beijingTime.getUTCMinutes()).padStart(2, '0')
+          }
+        }
+      }
+    })
+
+    // HTTP 请求
+    framework.registerTool({
+      name: 'fetch',
+      description: '发送 HTTP 请求获取远程数据。如果访问失败或超时，LLM 应自动使用 proxy: true 重试（代理会绕过网络限制）。',
+      inputSchema: z.object({
+        url: z.string().describe('请求 URL'),
+        method: z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH']).optional().describe('请求方法，默认 GET'),
+        headers: z.record(z.string()).optional().describe('请求头'),
+        body: z.string().optional().describe('请求体（POST/PUT/PATCH 时使用）'),
+        timeout: z.number().optional().describe('超时时间(ms)，默认 30000'),
+        proxy: z.boolean().optional().describe('是否使用代理，默认 false。访问失败时可自动设为 true 重试')
+      }),
+      execute: async (args, framework) => {
+        const { url, method = 'GET', headers = {}, body, timeout = 30000, proxy = false } = args
+        try {
+          const controller = new AbortController()
+          const timeoutId = setTimeout(() => controller.abort(), timeout)
+          const fetchUrl = proxy ? `https://fcdn.foliko.com?url=${encodeURIComponent(url)}` : url
+
+          const response = await fetch(fetchUrl, {
+            method,
+            headers,
+            body: body || undefined,
+            signal: controller.signal
+          })
+
+          clearTimeout(timeoutId)
+
+          const text = await response.text()
+          let data
+          try {
+            data = JSON.parse(text)
+          } catch {
+            data = text
+          }
+
+          return {
+            success: true,
+            status: response.status,
+            statusText: response.statusText,
+            headers: Object.fromEntries(response.headers.entries()),
+            body: data,
+            usedProxy: proxy
+          }
+        } catch (error) {
+          return {
+            success: false,
+            error: error.message,
+            url,
+            method,
+            hint: '如果访问失败，可尝试设置 proxy: true'
           }
         }
       }

package/plugins/python-executor-plugin.js

@@ -15,7 +15,7 @@ class PythonExecutorPlugin extends Plugin {
     super()
     this.name = 'python-executor'
     this.version = '1.0.0'
-    this.description = 'Python 执行器，用于运行 Python 代码和脚本'
+    this.description = 'Python 执行器，用于运行 Python 代码和脚本，禁止传入无用的emoji'
     this.priority = 15
 
     this.config = {