foliko 1.0.43 → 1.0.44

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=8088
+
+# 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:20-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 pip3 install uv
+
+# 设置工作目录
+WORKDIR /app
+
+# 全局安装 foliko CLI
+RUN npm install -g foliko
+
+# 暴露端口
+# 8088: Web 服务端口
+EXPOSE 8088
+
+# 环境变量（可以在 docker-compose 或运行时覆盖）
+ENV NODE_ENV=production
+ENV WEB_PORT=8088
+ENV WEB_HOST=127.0.0.1
+
+# 默认命令：运行聊天界面
+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.44",
   "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

@@ -202,7 +202,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 +276,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 +296,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 +322,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) {

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