foliko 1.1.68 → 1.1.69

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

@@ -6,7 +6,7 @@ const chalk = require('chalk').default;
 const figlet = require('figlet');
 const { CLEAR_LINE, CYAN, DIM, GREEN, RED, YELLOW, colored } = require('../utils/ansi');
 const { TUI, ProcessTerminal, Editor, Text, CombinedAutocompleteProvider, matchesKey, Container } = require('@earendil-works/pi-tui');
-const { cleanResponse } = require('../../../src/utils');
+const { cleanResponse, logger } = require('../../../src/utils');
 const { logEmitter } = require('../../../src/utils/logger');
 const { renderLine } = require('../utils/markdown');
 const { MessageBubble } = require('./message-bubble');
@@ -89,12 +89,24 @@ class ChatUI {
     // 会话管理
     this.sessionId = options.sessionId || 'cli_default';
     this.sessionPlugin = null;
+
+    // 获取 skill 命令列表
+    const skillCommands = [];
+    if (agent.framework) {
+      const extExecutor = agent.framework.pluginManager?.get('extension-executor');
+      if (extExecutor && typeof extExecutor.getSkillCommands === 'function') {
+        skillCommands.push(...extExecutor.getSkillCommands());
+      }
+    }
+
+    const baseCommands = [
+      { name: "compress", description: "压缩记录" },
+      { name: "clear", description: "清除记录" },
+      { name: "exit", description: "退出" },
+    ];
+
     const autocompleteProvider = new CombinedAutocompleteProvider(
-      [
-        { name: "compress", description: "压缩记录" },
-        { name: "clear", description: "清除记录" },
-        { name: "exit", description: "退出" },
-      ],
+      [...baseCommands, ...skillCommands],
       process.cwd(),
     );
     
@@ -176,18 +188,19 @@ class ChatUI {
       this._setupSessionListeners();
       const level_dict={
         DEBUG: 'cyan',
-        // INFO: 'dim',
+        INFO: 'dim',
+        LOG: 'dim',
         WARN: 'yellow',
         ERROR: 'red',
       }
       // 监听错误日志，显示到 tooler
-      // this._logHandler = (data) => {
-      //   if(!Object.keys(level_dict).includes(data.level))return;
-      //   const level=folikoTerracotta(`[${data.level}]`)
-      //   const level_key=level_dict[data.level]||'dim'
-      //   this.notifier.show(`${level} ${chalk[level_key](data.message)}`);
-      // };
-      // logEmitter.on('log', this._logHandler);
+      this._logHandler = (data) => {
+        if(!Object.keys(level_dict).includes(data.level))return;
+        const level=folikoTerracotta(`[${data.level}]`)
+        const level_key=level_dict[data.level]||'dim'
+        this.statusBar.notifier.show(`${level} ${chalk[level_key](data.message)}`)
+      };
+      logger.on('log', this._logHandler);
 
       // 监听通知事件，显示到通知区域
       this._notificationHandler = (data) => {
@@ -230,7 +243,7 @@ class ChatUI {
       this._streamBufferTimer = null;
     }
     if (this._logHandler && this.agent.framework) {
-      logEmitter.off('log', this._logHandler);
+      logger.off('log', this._logHandler);
       this._logHandler = null;
     }
     if (this._notificationHandler && this.agent.framework) {
@@ -270,6 +283,106 @@ class ChatUI {
     return
   }
 
+  /**
+   * 统一命令执行入口
+   */
+  async _executeCommand(trimmed) {
+    // 基础命令
+    const cmd = trimmed.toLowerCase();
+    if (cmd === '/clear') {
+      this._clearContext()
+      this.create_message(`${colored('[提示]', CYAN)} 对话上下文已清除\n`,chalk.dim('● '))
+      return true;
+    }
+    if (cmd === '/compress') {
+      this._compressContext()
+      return true;
+    }
+    if (cmd === '/exit') {
+      this.create_message(`${colored('[再见]', CYAN)} 感谢使用 Foliko！\n`,chalk.dim('● '))
+      this.tui.stop();
+      setTimeout(() => process.exit(0), 500);
+      return true;
+    }
+
+    // /help 命令显示所有注册的命令
+    if (cmd === '/help') {
+      const { getCommandRegistry } = require('../../../src/core/command-registry');
+      const registry = getCommandRegistry();
+      const commands = registry.getAllCommands();
+
+      let helpText = `${colored('[帮助]', CYAN)} 可用命令:\n`;
+      helpText += `  ${colored('/clear', CYAN)} - 清除对话上下文\n`;
+      helpText += `  ${colored('/compress', CYAN)} - 压缩上下文\n`;
+      helpText += `  ${colored('/exit', CYAN)} - 退出\n`;
+
+      // 添加 skill 命令
+      const extExecutor = this.agent.framework?.pluginManager?.get('extension-executor');
+      if (extExecutor && typeof extExecutor.getSkillCommandsHelp === 'function') {
+        const skillHelp = extExecutor.getSkillCommandsHelp();
+        if (skillHelp) {
+          helpText += `\n${colored('[技能命令]', CYAN)}\n`;
+          helpText += skillHelp.split('\n').map(line => `  ${line}`).join('\n') + '\n';
+        }
+      }
+
+      if (commands.length > 0) {
+        helpText += `\n${colored('[扩展命令]', CYAN)}\n`;
+        for (const cmd of commands) {
+          const pluginTag = cmd.registeredBy ? ` [${cmd.registeredBy}]` : '';
+          helpText += `  ${colored('/' + cmd.name, CYAN)}${pluginTag} - ${cmd.description || '无描述'}\n`;
+        }
+      }
+      this.create_message(helpText, chalk.dim('● '));
+      return true;
+    }
+
+    // 尝试通过 CommandRegistry 执行命令
+    const cmdName = trimmed.slice(1).split(' ')[0];
+    const cmdArgs = trimmed.slice(cmdName.length + 2);
+    if (trimmed.startsWith('/') && cmdName) {
+      // 检查 skill 命令 (格式: skillname:cmdname)
+      if (cmdName.includes(':')) {
+        try {
+          const result = await this.agent.framework.executeTool('ext_call', {
+            plugin: 'skill',
+            tool: cmdName,
+            args: { args: cmdArgs }
+          });
+          if (result.success !== false) {
+            this.create_message(`${colored('[结果]', CYAN)} ${result.data || result}\n`, chalk.dim('● '));
+            return true;
+          }
+        } catch (err) {
+          log.warn('Skill command failed:', err.message);
+        }
+      }
+
+      // 检查 CommandRegistry 中的命令
+      const { getCommandRegistry } = require('../../../src/core/command-registry');
+      const registry = getCommandRegistry();
+      const cmd = registry.getCommand(cmdName);
+      if (cmd) {
+        try {
+          const context = {
+            sessionId: this.sessionId,
+            agent: this.agent,
+            ui: this,
+            framework: this.agent.framework,
+          };
+          registry.execute(cmdName, cmdArgs, context).catch(err => {
+            this.create_message(`${colored('[命令错误]', 'red')} ${err.message}\n`, chalk.dim('● '));
+          });
+        } catch (err) {
+          this.create_message(`${colored('[命令错误]', 'red')} ${err.message}\n`, chalk.dim('● '));
+        }
+        return true;
+      }
+    }
+
+    return false;
+  }
+
   async handleOnSubmit(value){
     try{
       if (this.isResponding) {
@@ -280,21 +393,8 @@ class ChatUI {
         return;
       }
 
-      // 处理快捷命令
-      const cmd = trimmed.toLowerCase();
-      if (cmd === '/clear') {
-        this._clearContext()
-        this.create_message(`${colored('[提示]', CYAN)} 对话上下文已清除\n`,chalk.dim('● '))
-        return;
-      }
-      if (cmd === '/compress') {
-        this._compressContext()
-        return;
-      }
-      if (cmd === '/exit') {
-        this.create_message(`${colored('[再见]', CYAN)} 感谢使用 Foliko！\n`,chalk.dim('● '))
-        this.tui.stop();
-        setTimeout(() => process.exit(0), 500);
+      // 尝试执行命令
+      if (await this._executeCommand(trimmed)) {
         return;
       }
 
@@ -333,6 +433,11 @@ class ChatUI {
 
     const { sessionId } = this;
 
+    // Clear ChatSession message store (memory + file)
+    if (this.agent._chatSession) {
+      this.agent._chatSession.clearSessionMessages(sessionId, true);
+    }
+
     // 1. 清除 AgentChatHandler 的消息存储（需要传 sessionId）
     if (this.agent._chatHandler) {
       this.agent._chatHandler.clearHistory(sessionId);
@@ -343,21 +448,29 @@ class ChatUI {
       const sessionCtx = this.agent.framework.getSessionContext(sessionId);
       if (sessionCtx) {
         sessionCtx.clearMessages();
-        sessionCtx.compressionState.count = 0;
-        sessionCtx.metadata.compressionCount = 0;
+        if (sessionCtx.compressionState) {
+          sessionCtx.compressionState.count = 0;
+        }
+        if (sessionCtx.metadata) {
+          sessionCtx.metadata.compressionCount = 0;
+        }
       }
       // 同步清除 framework 缓存的 sessionContexts
       const cachedCtx = this.agent.framework._sessionContexts?.get(sessionId);
       if (cachedCtx) {
         cachedCtx.clearMessages();
-        cachedCtx.compressionState.count = 0;
-        cachedCtx.metadata.compressionCount = 0;
+        if (cachedCtx.compressionState) {
+          cachedCtx.compressionState.count = 0;
+        }
+        if (cachedCtx.metadata) {
+          cachedCtx.metadata.compressionCount = 0;
+        }
       }
       // 清除 SessionPlugin 中的消息
       if (this.sessionPlugin) {
-        const session = this.sessionPlugin.getSession(sessionId);
-        if (session) {
-          session.messages = [];
+        const manager = this.sessionPlugin._getSessionManager(sessionId);
+        if (manager) {
+          manager.clearMessages();
         }
       }
     }
@@ -511,7 +624,8 @@ class ChatUI {
           if (resultObj && resultObj.diff) {
             const diffContent = renderDiffWithHeader(resultObj.diff, resultObj.filePath);
             const bgColor = chalk.bgHex('#1a1a2e');
-            this.create_message(diffContent, chalk.yellow('▸ '), true, (line) => bgColor(line));
+            this._currentBotMessage.appendContent(['\n',diffContent,'\n\n'].join(''));
+            // this.create_message(diffContent, chalk.yellow('▸ '), true, (line) => bgColor(line));
             this.statusBar.tooler.show(`${chalk.green('[Diff]')} ${folikoGold(resultObj.filePath)}`);
           }
         }

package/cli/src/ui/footer-bar.js

@@ -117,7 +117,7 @@ class FooterBar {
 
   /**
    * 从 agent 刷新数据
-   * 从 messageStore 获取最新一次调用的用量，计算增量后累加
+   * 从 SessionManager 获取最新一次调用的用量，计算增量后累加
    */
   refreshFromAgent() {
     try {
@@ -126,14 +126,9 @@ class FooterBar {
 
       const sessionId = 'cli_default';
 
-      // 主动加载历史记录（确保从 SessionContext/文件加载历史消息）
-      chatHandler._chatSession.loadHistory(sessionId);
-
-      const messageStore = chatHandler._chatSession.getSessionMessageStore(sessionId);
-      if (!messageStore) return;
-
       // 1. Token 用量：计算与上次记录的增量
-      if (messageStore.usage) {
+      const messageStore = chatHandler._chatSession.getSessionMessageStore(sessionId);
+      if (messageStore && messageStore.usage) {
         const u = messageStore.usage;
         const inputTokens = u.promptTokens || u.prompt_tokens || 0;
         const outputTokens = u.completionTokens || u.completion_tokens || 0;
@@ -153,12 +148,16 @@ class FooterBar {
         this._lastUsage = { inputTokens, outputTokens };
       }
 
-      // 2. 上下文 token 估算（使用 TokenCounter）
-      if (messageStore.messages && messageStore.messages.length > 0) {
-        const msgTokens = this._tokenCounter.countMessages(messageStore.messages);
-        this._stats.contextTokens = msgTokens;
-        if (this._stats.maxContextTokens > 0) {
-          this._stats.contextPercent = Math.min(100, (msgTokens / this._stats.maxContextTokens) * 100);
+      // 2. 上下文 token 估算（使用 SessionManager）
+      const sessionCtx = this.agent.framework?.getSessionContext(sessionId);
+      if (sessionCtx && typeof sessionCtx.getMessages === 'function') {
+        const messages = sessionCtx.getMessages();
+        if (messages && messages.length > 0) {
+          const msgTokens = this._tokenCounter.countMessages(messages);
+          this._stats.contextTokens = msgTokens;
+          if (this._stats.maxContextTokens > 0) {
+            this._stats.contextPercent = Math.min(100, (msgTokens / this._stats.maxContextTokens) * 100);
+          }
         }
       }
 

package/cli/src/utils/config.js

@@ -0,0 +1,29 @@
+/**
+ * Foliko 公共配置
+ */
+
+// 配置目录名（统一管理，方便改名）
+const AGENT_DIR_NAME = '.foliko';
+
+// 其他配置目录
+const AGENT_SUBDIRS = {
+  AGENTS: 'agents',
+  PLUGINS: 'plugins',
+  SKILLS: 'skills',
+  DATA: 'data',
+  SESSIONS: 'sessions',
+  LOGS: 'logs',
+  MCP_CONFIG: 'mcp_config.json',
+  RULES: 'rules',
+};
+
+module.exports = {
+  AGENT_DIR_NAME,
+  AGENT_SUBDIRS,
+  getAgentDir: () => AGENT_DIR_NAME,
+  getAgentsDir: () => `${AGENT_DIR_NAME}/${AGENT_SUBDIRS.AGENTS}`,
+  getPluginsDir: () => `${AGENT_DIR_NAME}/${AGENT_SUBDIRS.PLUGINS}`,
+  getDataDir: () => `${AGENT_DIR_NAME}/${AGENT_SUBDIRS.DATA}`,
+  getSessionsDir: () => `${AGENT_DIR_NAME}/${AGENT_SUBDIRS.SESSIONS}`,
+  getLogsDir: () => `${AGENT_DIR_NAME}/${AGENT_SUBDIRS.LOGS}`,
+};

package/cli/src/utils/plugin-config.js

@@ -16,7 +16,7 @@ const IGNORE_PATTERNS = [
   '*.lock',
   '*.bak',
   '.claude',
-  '.agent',
+  '.foliko',
   'examples',
   'dist',
   'build',

package/docker-compose.yml

@@ -1,33 +1,33 @@
-# ========== Foliko Docker Compose ==========
-# 使用方式: docker-compose up -d
-
-services:
-  foliko:
-    build: .
-    container_name: foliko-agent
-    restart: unless-stopped
-    ports:
-      - '3000:3000'
-    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=3000
-      - 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:
+# ========== Foliko Docker Compose ==========
+# 使用方式: docker-compose up -d
+
+services:
+  foliko:
+    build: .
+    container_name: foliko-agent
+    restart: unless-stopped
+    ports:
+      - '3000:3000'
+    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=3000
+      - 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/.foliko/data
+    tty: true
+    stdin_open: true
+
+volumes:
+  foliko-data:

package/docs/features.md

@@ -1,120 +1,120 @@
-# Foliko 功能点清单
-
-## 1. AI 对话
-
-| 功能        | 说明                                    |
-| ----------- | --------------------------------------- |
-| 流式输出    | 实时流式响应                            |
-| 多 Provider | minimax / deepseek / openai / anthropic |
-| 模型配置    | 支持自定义 model、baseURL、apiKey       |
-| 系统提示词  | 支持 sharedPrompt 模板变量              |
-| 思考过程    | 可选的 think 插件显示推理               |
-
-## 2. 工具系统
-
-| 功能                     | 说明                        |
-| ------------------------ | --------------------------- |
-| `Bash`                   | 执行 Shell/Bash 命令        |
-| `Read`                   | 读取文件内容                |
-| `Write`                  | 写入文件                    |
-| `Edit`                   | 编辑文件（diff 替换）       |
-| `Glob`                   | 按模式搜索文件              |
-| `Grep`                   | 文件内容搜索                |
-| `python`                 | 执行 Python 代码            |
-| `execute_workflow`       | 执行工作流                  |
-| `loadSkill/reloadSkills` | 技能加载与重载              |
-| `reloadWorkflows`        | 工作流重载                  |
-| MCP 工具                 | Model Context Protocol 集成 |
-
-## 3. 插件系统
-
-| 功能         | 说明                                 |
-| ------------ | ------------------------------------ |
-| 插件目录     | `.agent/plugins/` 自动加载           |
-| 插件生命周期 | install / start / reload / uninstall |
-| 工具注册     | 插件可注册工具到 Agent               |
-| 事件系统     | 插件间通过事件通信                   |
-| 状态持久化   | 插件配置保存到 JSON                  |
-| 优先级控制   | priority 决定加载顺序                |
-
-## 4. 工作流引擎
-
-| 功能        | 说明                            |
-| ----------- | ------------------------------- |
-| `script`    | JavaScript 脚本执行             |
-| `loop`      | 循环（maxIterations）           |
-| `condition` | 条件分支                        |
-| `delay`     | 延时等待                        |
-| `parallel`  | 并行执行                        |
-| 上下文共享  | variables / input / stepResults |
-| 目录加载    | `.agent/workflows/` 自动注册    |
-
-## 5. 技能系统
-
-| 功能     | 说明                         |
-| -------- | ---------------------------- |
-| 技能目录 | `skills/` + `.agent/skills/` |
-| SKILL.md | frontmatter 元数据格式       |
-| 自动发现 | 递归扫描子目录               |
-| 工具过滤 | allowed-tools 限制可用工具   |
-| 重载支持 | reloadSkills 动态加载        |
-
-## 6. 会话管理
-
-| 功能          | 说明                      |
-| ------------- | ------------------------- |
-| SessionPlugin | 统一会话历史管理          |
-| 多会话        | 按 sessionId 隔离         |
-| 消息持久化    | JSON 文件存储             |
-| 元数据        | 支持 platform / userId 等 |
-| 会话事件      | session:created / deleted |
-
-## 7. 子 Agent
-
-| 功能        | 说明                        |
-| ----------- | --------------------------- |
-| 子Agent配置 | `.agent/agents/*.json/*.md` |
-| 角色定义    | role / description          |
-| 工具继承    | parentTools 指定可用工具    |
-| 工具路由    | 自动匹配最合适 Agent        |
-| 协作执行    | 支持多 Agent 分工           |
-
-## 8. 通讯插件
-
-| 功能     | 说明                             |
-| -------- | -------------------------------- |
-| Telegram | Bot Token / 群组模式 / 命令前缀  |
-| 微信     | WebSocket 登录 / 二维码          |
-| 飞书     | WS 长连接 / 事件订阅             |
-| 邮件     | IMAP 读取 / SMTP 发送 / 163 兼容 |
-
-## 9. 执行器
-
-| 功能           | 说明                   |
-| -------------- | ---------------------- |
-| ShellExecutor  | system 命令执行        |
-| PythonExecutor | Python 3 代码执行      |
-| 超时控制       | 可配置 maxDuration     |
-| 结果返回       | stdout/stderr/exitCode |
-
-## 10. Web 服务
-
-| 功能                   | 说明                              |
-| ---------------------- | --------------------------------- |
-| `web_start`            | 启动 HTTP 服务器                  |
-| `web_stop`             | 停止 HTTP 服务器                  |
-| `web_register_route`   | 注册 HTTP 路由                    |
-| `web_register_webhook` | 注册 Webhook（数据交给 LLM 处理） |
-| `web_list_routes`      | 列出所有路由和 Webhook            |
-| 路由参数               | 支持 `/user/:id` 路径参数         |
-| Webhook LLM            | 接收数据后转发给 LLM 处理         |
-
-## 11. 其他内置插件
-
-| 功能        | 说明                |
-| ----------- | ------------------- |
-| `scheduler` | 定时任务 / 循环调度 |
-| `rules`     | 规则引擎 / 条件触发 |
-| `storage`   | 键值存储            |
-| `audit`     | 操作审计日志        |
-| `install`   | 插件安装工具        |
+# Foliko 功能点清单
+
+## 1. AI 对话
+
+| 功能        | 说明                                    |
+| ----------- | --------------------------------------- |
+| 流式输出    | 实时流式响应                            |
+| 多 Provider | minimax / deepseek / openai / anthropic |
+| 模型配置    | 支持自定义 model、baseURL、apiKey       |
+| 系统提示词  | 支持 sharedPrompt 模板变量              |
+| 思考过程    | 可选的 think 插件显示推理               |
+
+## 2. 工具系统
+
+| 功能                     | 说明                        |
+| ------------------------ | --------------------------- |
+| `Bash`                   | 执行 Shell/Bash 命令        |
+| `Read`                   | 读取文件内容                |
+| `Write`                  | 写入文件                    |
+| `Edit`                   | 编辑文件（diff 替换）       |
+| `Glob`                   | 按模式搜索文件              |
+| `Grep`                   | 文件内容搜索                |
+| `python`                 | 执行 Python 代码            |
+| `execute_workflow`       | 执行工作流                  |
+| `loadSkill/reloadSkills` | 技能加载与重载              |
+| `reloadWorkflows`        | 工作流重载                  |
+| MCP 工具                 | Model Context Protocol 集成 |
+
+## 3. 插件系统
+
+| 功能         | 说明                                 |
+| ------------ | ------------------------------------ |
+| 插件目录     | `.foliko/plugins/` 自动加载           |
+| 插件生命周期 | install / start / reload / uninstall |
+| 工具注册     | 插件可注册工具到 Agent               |
+| 事件系统     | 插件间通过事件通信                   |
+| 状态持久化   | 插件配置保存到 JSON                  |
+| 优先级控制   | priority 决定加载顺序                |
+
+## 4. 工作流引擎
+
+| 功能        | 说明                            |
+| ----------- | ------------------------------- |
+| `script`    | JavaScript 脚本执行             |
+| `loop`      | 循环（maxIterations）           |
+| `condition` | 条件分支                        |
+| `delay`     | 延时等待                        |
+| `parallel`  | 并行执行                        |
+| 上下文共享  | variables / input / stepResults |
+| 目录加载    | `.foliko/workflows/` 自动注册    |
+
+## 5. 技能系统
+
+| 功能     | 说明                         |
+| -------- | ---------------------------- |
+| 技能目录 | `skills/` + `.foliko/skills/` |
+| SKILL.md | frontmatter 元数据格式       |
+| 自动发现 | 递归扫描子目录               |
+| 工具过滤 | allowed-tools 限制可用工具   |
+| 重载支持 | reloadSkills 动态加载        |
+
+## 6. 会话管理
+
+| 功能          | 说明                      |
+| ------------- | ------------------------- |
+| SessionPlugin | 统一会话历史管理          |
+| 多会话        | 按 sessionId 隔离         |
+| 消息持久化    | JSON 文件存储             |
+| 元数据        | 支持 platform / userId 等 |
+| 会话事件      | session:created / deleted |
+
+## 7. 子 Agent
+
+| 功能        | 说明                        |
+| ----------- | --------------------------- |
+| 子Agent配置 | `.foliko/agents/*.json/*.md` |
+| 角色定义    | role / description          |
+| 工具继承    | parentTools 指定可用工具    |
+| 工具路由    | 自动匹配最合适 Agent        |
+| 协作执行    | 支持多 Agent 分工           |
+
+## 8. 通讯插件
+
+| 功能     | 说明                             |
+| -------- | -------------------------------- |
+| Telegram | Bot Token / 群组模式 / 命令前缀  |
+| 微信     | WebSocket 登录 / 二维码          |
+| 飞书     | WS 长连接 / 事件订阅             |
+| 邮件     | IMAP 读取 / SMTP 发送 / 163 兼容 |
+
+## 9. 执行器
+
+| 功能           | 说明                   |
+| -------------- | ---------------------- |
+| ShellExecutor  | system 命令执行        |
+| PythonExecutor | Python 3 代码执行      |
+| 超时控制       | 可配置 maxDuration     |
+| 结果返回       | stdout/stderr/exitCode |
+
+## 10. Web 服务
+
+| 功能                   | 说明                              |
+| ---------------------- | --------------------------------- |
+| `web_start`            | 启动 HTTP 服务器                  |
+| `web_stop`             | 停止 HTTP 服务器                  |
+| `web_register_route`   | 注册 HTTP 路由                    |
+| `web_register_webhook` | 注册 Webhook（数据交给 LLM 处理） |
+| `web_list_routes`      | 列出所有路由和 Webhook            |
+| 路由参数               | 支持 `/user/:id` 路径参数         |
+| Webhook LLM            | 接收数据后转发给 LLM 处理         |
+
+## 11. 其他内置插件
+
+| 功能        | 说明                |
+| ----------- | ------------------- |
+| `scheduler` | 定时任务 / 循环调度 |
+| `rules`     | 规则引擎 / 条件触发 |
+| `storage`   | 键值存储            |
+| `audit`     | 操作审计日志        |
+| `install`   | 插件安装工具        |