foliko 1.0.43 → 1.0.46

package/.dockerignore

@@ -0,0 +1,45 @@
+# 依赖
+node_modules
+.agent/node_modules
+
+# 日志
+*.log
+npm-debug.log*
+
+# 环境变量（包含敏感信息）
+.env
+.env.local
+
+# Git
+.git
+.gitignore
+
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
+
+# 文档（可选保留）
+*.md
+!README.md
+
+# 测试
+test
+tests
+coverage
+
+# 临时文件
+tmp
+temp
+*.tmp
+
+# Docker 相关（避免递归）
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# CI/CD
+.github
+.gitlab-ci.yml
+.travis.yml

package/.env.example

@@ -38,3 +38,13 @@ FROM_EMAIL=your-email@gmail.com
 
 # ========== Telegram Bot (optional) ==========
 TELEGRAM_BOT_TOKEN=your-telegram-bot-token
+
+# ========== Web Server (optional) ==========
+# Web 服务端口，默认 8088
+WEB_PORT=3000
+
+# Web 服务主机，默认 127.0.0.1
+WEB_HOST=127.0.0.1
+
+# 公网访问的 base URL（用于生成 webhook URL 等），不设置则使用 host:port
+WEB_BASE_URL=https://your-domain.com

package/Dockerfile

@@ -0,0 +1,35 @@
+# ========== Foliko - 插件化 Agent 框架 ==========
+# 基于 Node.js 20 LTS
+
+FROM node:25-slim
+
+# 安装 Python 和构建工具（部分 npm 包需要编译）
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    python3 \
+    python3-pip \
+    curl \
+    git \
+    && rm -rf /var/lib/apt/lists/* \
+    && ln -sf /usr/bin/python3 /usr/bin/python
+
+# 安装 uv（快速的 Python 包管理器）
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+ENV PATH="/root/.local/bin:$PATH"
+
+# 设置工作目录
+WORKDIR /app
+
+# 全局安装 foliko CLI
+RUN npm install -g foliko
+
+# 暴露端口
+# 8088: Web 服务端口
+EXPOSE 3000
+
+# 环境变量（可以在 docker-compose 或运行时覆盖）
+ENV NODE_ENV=production
+
+
+# 默认命令：运行聊天界面
+CMD ["foliko", "chat"]

package/docker-compose.yml

@@ -0,0 +1,33 @@
+# ========== Foliko Docker Compose ==========
+# 使用方式: docker-compose up -d
+
+services:
+  foliko:
+    build: .
+    container_name: foliko-agent
+    restart: unless-stopped
+    ports:
+      - "8088:8088"
+    environment:
+      # AI 配置
+      - FOLIKO_PROVIDER=${FOLIKO_PROVIDER:-minimax}
+      - FOLIKO_MODEL=${FOLIKO_MODEL:-}
+      - FOLIKO_BASE_URL=${FOLIKO_BASE_URL:-}
+      - FOLIKO_API_KEY=${FOLIKO_API_KEY:-}
+      # Web 服务配置
+      - WEB_PORT=8088
+      - WEB_HOST=0.0.0.0
+      - WEB_BASE_URL=${WEB_BASE_URL:-}
+      # Telegram 配置（可选）
+      - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN:-}
+      # 飞书配置（可选）
+      - FEISHU_APP_ID=${FEISHU_APP_ID:-}
+      - FEISHU_APP_SECRET=${FEISHU_APP_SECRET:-}
+    volumes:
+      # 持久化数据
+      - foliko-data:/app/.agent/data
+    tty: true
+    stdin_open: true
+
+volumes:
+  foliko-data:

package/package.json

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

package/plugins/feishu-plugin.js

@@ -105,6 +105,11 @@ class FeishuPlugin extends Plugin {
         this._framework.on('scheduler:reminder', async (data) => {
           await this._handleScheduledReminder(data)
         })
+
+        // 监听 webhook 事件
+        this._framework.on('webhook:received', async (data) => {
+          await this._handleWebhookNotification(data)
+        })
       }
 
       console.log('[Feishu] WebSocket client started')
@@ -245,6 +250,27 @@ class FeishuPlugin extends Plugin {
     }
   }
 
+  /**
+   * 处理 webhook 通知
+   */
+  async _handleWebhookNotification(data) {
+    const { data: webhookData, response, sessionId } = data
+
+    if (!sessionId || !sessionId.startsWith('feishu_')) {
+      return
+    }
+
+    const openId = sessionId.replace('feishu_', '')
+    const notificationText = `📥 [Webhook 接收]\n\n路径: ${webhookData.path}\n方法: ${webhookData.method}\n\n处理结果: ${response || '处理中...'}`
+
+    try {
+      await this._sendTextMessage(openId, notificationText)
+      console.log(`[Feishu] Webhook notification sent to ${openId}`)
+    } catch (err) {
+      console.error(`[Feishu] Failed to send webhook notification:`, err.message)
+    }
+  }
+
   async _processChat(openId, text, originalMsg) {
     const sessionInfo = this._getSessionAgent(openId)
     if (!sessionInfo) return

package/plugins/telegram-plugin.js

@@ -102,6 +102,11 @@ class TelegramPlugin extends Plugin {
         this._framework.on('scheduler:reminder', async (data) => {
           await this._handleScheduledReminder(data)
         })
+
+        // 监听 webhook 事件
+        this._framework.on('webhook:received', async (data) => {
+          await this._handleWebhookNotification(data)
+        })
       }
     } catch (err) {
       console.error('[Telegram] Failed to initialize bot:', err.message)
@@ -140,6 +145,27 @@ class TelegramPlugin extends Plugin {
     }
   }
 
+  /**
+   * 处理 webhook 通知
+   */
+  async _handleWebhookNotification(data) {
+    const { data: webhookData, response, sessionId } = data
+
+    if (!sessionId || !sessionId.startsWith('telegram_')) {
+      return
+    }
+
+    const chatId = sessionId.replace('telegram_', '')
+    const notificationText = `📥 [Webhook 接收]\n\n路径: ${webhookData.path}\n方法: ${webhookData.method}\n\n处理结果: ${response || '处理中...'}`
+
+    try {
+      await this._bot.sendMessage(chatId, notificationText)
+      console.log(`[Telegram] Webhook notification sent to chat ${chatId}`)
+    } catch (err) {
+      console.error(`[Telegram] Failed to send webhook notification:`, err.message)
+    }
+  }
+
   _getMainAgent() {
     if (this._framework._mainAgent) return this._framework._mainAgent
     const agents = this._framework._agents || []

package/plugins/web-plugin.js

@@ -19,9 +19,9 @@ class WebPlugin extends Plugin {
     this.priority = 50
 
     // 服务器配置
-    this._port = config.port || process.env.WEB_PORT || 8088
-    this._host = config.host || process.env.WEB_HOST || '127.0.0.1'
-    this._baseUrl = config.baseUrl || process.env.WEB_BASE_URL || null  // 公网可访问的域名
+    this._port = process.env.WEB_PORT || 3000
+    this._host = process.env.WEB_HOST || '127.0.0.1'
+    this._baseUrl = process.env.WEB_BASE_URL || null  // 公网可访问的域名
 
     // 运行时状态
     this._server = null
@@ -157,12 +157,14 @@ class WebPlugin extends Plugin {
         port: this._port,
         hostname: this._host
       })
-      console.log(`[Web] Server started on http://${this._host}:${this._port}`)
+      const serverUrl = this._getUrl()
+      console.log(`[Web] Server started on ${serverUrl}`)
       return {
         success: true,
-        message: `Server started on http://${this._host}:${this._port}`,
+        message: `Server started on ${serverUrl}`,
         port: this._port,
-        host: this._host
+        host: this._host,
+        url: serverUrl
       }
     } catch (err) {
       this._server = null
@@ -202,7 +204,22 @@ class WebPlugin extends Plugin {
 
       // 1. 静态文件
       const staticResult = this._serveStatic(pathname)
-      if (staticResult) return staticResult
+      if (staticResult) {
+        if (staticResult.type === 'file') {
+          return c.newResponse(staticResult.content, {
+            headers: { 'Content-Type': staticResult.contentType }
+          })
+        }
+        if (staticResult.type === 'notFound') {
+          return c.json({ error: 'Not Found' }, 404)
+        }
+        if (staticResult.type === 'forbidden') {
+          return c.json({ error: 'Forbidden' }, 403)
+        }
+        if (staticResult.type === 'error') {
+          return c.json({ error: staticResult.message }, 500)
+        }
+      }
 
       // 2. Webhook（精确匹配）
       const webhook = this._webhooks.get(pathname)
@@ -261,7 +278,7 @@ class WebPlugin extends Plugin {
     const finalSessionId = sessionId || `web_${Date.now()}`
 
     // 触发 webhook 接收事件
-    this._framework.emit('webhook:received', { webhook, data: webhookData })
+    this._framework.emit('webhook:received', { webhook, data: webhookData, sessionId: finalSessionId })
 
     if (!webhook.awaitResponse) {
       // 不等待，立即返回
@@ -281,7 +298,7 @@ class WebPlugin extends Plugin {
         }
 
         // 触发 webhook 处理完成事件
-        this._framework.emit('webhook:received', { webhook, data: webhookData, response: responseText })
+        this._framework.emit('webhook:received', { webhook, data: webhookData, response: responseText, sessionId: finalSessionId })
       }).catch(err => {
         console.error('[Web] Webhook error:', err.message)
       })
@@ -307,7 +324,7 @@ class WebPlugin extends Plugin {
       }
 
       // 触发 webhook 处理完成事件
-      this._framework.emit('webhook:received', { webhook, data: webhookData, response: responseText })
+      this._framework.emit('webhook:received', { webhook, data: webhookData, response: responseText, sessionId: finalSessionId })
 
       return { success: true, message: 'Webhook processed', response: responseText }
     } catch (err) {
@@ -391,7 +408,7 @@ class WebPlugin extends Plugin {
   }
 
   _listRoutes() {
-    const baseUrl = this._getUrl('')
+    const baseUrl = this._getUrl()
 
     return {
       success: true,
@@ -462,7 +479,7 @@ class WebPlugin extends Plugin {
     return query
   }
 
-  _getUrl(path) {
+  _getUrl(path='') {
     if (this._baseUrl) {
       return `${this._baseUrl}${path}`
     }

package/plugins/weixin-plugin.js

@@ -74,6 +74,12 @@ class WeixinPlugin extends Plugin {
         console.log('[WeChat] Received scheduler reminder:', data)
         await this._handleScheduledReminder(data)
       })
+
+      // 监听 webhook 事件
+      this._framework.on('webhook:received', async (data) => {
+        console.log('[WeChat] Received webhook event:', data)
+        await this._handleWebhookNotification(data)
+      })
     }
 
     // 异步初始化 Bot
@@ -334,6 +340,33 @@ class WeixinPlugin extends Plugin {
     }
   }
 
+  /**
+   * 处理 webhook 通知
+   */
+  async _handleWebhookNotification(data) {
+    const { data: webhookData, response, sessionId } = data
+
+    if (!this._bot) {
+      console.warn('[WeChat] Bot not ready, cannot send webhook notification')
+      return
+    }
+
+    // 只处理 weixin 相关的 session
+    if (!sessionId || !sessionId.startsWith('weixin_')) {
+      return
+    }
+
+    const userId = sessionId.replace('weixin_', '')
+    const notificationText = `📥 [Webhook 接收]\n\n路径: ${webhookData.path}\n方法: ${webhookData.method}\n\n处理结果: ${response || '处理中...'}`
+
+    try {
+      await this._bot.sendText(userId, notificationText)
+      console.log(`[WeChat] Webhook notification sent to user ${userId}`)
+    } catch (err) {
+      console.error(`[WeChat] Failed to send webhook notification:`, err.message)
+    }
+  }
+
   /**
    * 获取插件状态
    */

package/test.txt

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