foliko 1.1.72 → 1.1.73

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. 插件系统
-
-| 功能         | 说明                                 |
-| ------------ | ------------------------------------ |
-| 插件目录     | `.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`   | 插件安装工具        |
+# 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`   | 插件安装工具        |

package/docs/quick-reference.md

@@ -1,160 +1,160 @@
-# Foliko 快速参考
-
-## 启动框架
-
-```javascript
-const framework = new Framework({ debug: false });
-await framework.bootstrap({
-  agentDir: './.foliko',
-  aiConfig: { provider: 'deepseek', model: 'deepseek-chat', apiKey: '...' },
-});
-```
-
-## 创建 Agent
-
-```javascript
-const agent = framework.createAgent({
-  name: 'MyAgent',
-  systemPrompt: '你是一个有帮助的助手。',
-});
-```
-
-## 发送消息
-
-```javascript
-// 流式
-for await (const chunk of agent.chatStream('你好')) {
-  if (chunk.type === 'text') process.stdout.write(chunk.text);
-}
-
-// 非流式
-const result = await agent.chat('你好');
-```
-
-## 常用工具
-
-| 工具                   | 用途         |
-| ---------------------- | ------------ |
-| `list_tools`           | 列出所有工具 |
-| `loadSkill`            | 加载技能     |
-| `reload_plugins`       | 重载插件     |
-| `read_file`            | 读取文件     |
-| `write_file`           | 写入文件     |
-| `execute_command`      | 执行命令     |
-| `schedule_once`        | 定时任务     |
-| `think_now`            | 主动思考     |
-| `email_send`           | 发送邮件     |
-| `email_read`           | 读取邮件     |
-| `enable_plugin`        | 启用插件     |
-| `disable_plugin`       | 禁用插件     |
-| `update_plugin_config` | 更新插件配置 |
-
-## 插件位置
-
-- 内置插件：`plugins/`
-- 用户插件：`.foliko/plugins/`
-
-## 插件管理
-
-```javascript
-// 重启插件
-await framework.executeTool('reload_plugins', {});
-await framework.executeTool('reload_plugins', { pluginName: 'telegram' });
-
-// 启用/禁用插件
-await framework.executeTool('enable_plugin', { name: 'telegram' });
-await framework.executeTool('disable_plugin', { name: 'telegram' });
-
-// 更新插件配置（持久化）
-await framework.executeTool('update_plugin_config', {
-  name: 'telegram',
-  config: { allowedChats: ['123'], groupMode: true },
-});
-await framework.executeTool('get_plugin_config', { name: 'telegram' });
-```
-
-## 事件监听
-
-```javascript
-// Framework 事件
-framework.on('framework:ready', (fw) => {});
-framework.on('plugin:loaded', (plugin) => {});
-framework.on('tool:registered', (tool) => {});
-
-// Agent 事件
-agent.on('status', ({ status }) => {}); // idle/busy/error
-agent.on('chunk', (chunk) => {}); // 流式输出
-agent.on('tool-call', ({ name, args }) => {});
-agent.on('tool-result', ({ name, result }) => {});
-
-// 子 Agent 事件
-agent.on('subagent:chat:start', (data) => {});
-agent.on('subagent:chat:end', (data) => {});
-agent.on('subagent:error', (data) => {});
-```
-
-## 子 Agent 注册
-
-```javascript
-const { tool } = require('ai')
-const { z } = require('zod')
-
-// 方式1：配置 agents 数组自动注册
-class MyPlugin extends Plugin {
-  agents = [
-    {
-      name: 'code-agent',
-      role: '代码专家',
-      tools: {
-        compile: tool({
-          description: '编译',
-          parameters: z.object({ language: z.string(), code: z.string() }),
-          execute: async (args) => ({ success: true })
-        })
-      },
-      parentTools: ['read_file', 'write_file']
-    }
-  ]
-}
-
-// 方式2：手动调用
-this.registerSubAgent({ name: 'code-agent', role: '代码专家', tools: {...}, parentTools: [...] })
-```
-
-## 系统提示中的部分
-
-```
-【可用工具】
-- tool1: 描述
-- tool2: 描述
-
-【可用技能】
-- skill1: 描述
-- skill2: 描述
-
-【子 Agent 分配规则】
-- code-agent: 代码专家
-
-【系统能力】
-- ai: AI 对话能力
-- storage: 存储
-```
-
-## 状态管理
-
-```javascript
-agent.getStatus(); // 'idle' | 'busy' | 'error'
-agent.resetStatus(); // 重置状态
-agent.clearHistory(); // 清空历史
-```
-
-## 配置持久化
-
-插件配置自动保存到 `.foliko/data/plugins-state.json`
-
-| 文件                              | 用途                |
-| --------------------------------- | ------------------- |
-| `.foliko/data/plugins-state.json`  | 插件启用状态和配置  |
-| `.foliko/data/storage.json`        | 键值存储数据        |
-| `.foliko/data/telegram_images/`    | Telegram 接收的图片 |
-| `.foliko/data/telegram_documents/` | Telegram 接收的文档 |
+# Foliko 快速参考
+
+## 启动框架
+
+```javascript
+const framework = new Framework({ debug: false });
+await framework.bootstrap({
+  agentDir: './.foliko',
+  aiConfig: { provider: 'deepseek', model: 'deepseek-chat', apiKey: '...' },
+});
+```
+
+## 创建 Agent
+
+```javascript
+const agent = framework.createAgent({
+  name: 'MyAgent',
+  systemPrompt: '你是一个有帮助的助手。',
+});
+```
+
+## 发送消息
+
+```javascript
+// 流式
+for await (const chunk of agent.chatStream('你好')) {
+  if (chunk.type === 'text') process.stdout.write(chunk.text);
+}
+
+// 非流式
+const result = await agent.chat('你好');
+```
+
+## 常用工具
+
+| 工具                   | 用途         |
+| ---------------------- | ------------ |
+| `list_tools`           | 列出所有工具 |
+| `loadSkill`            | 加载技能     |
+| `reload_plugins`       | 重载插件     |
+| `read_file`            | 读取文件     |
+| `write_file`           | 写入文件     |
+| `execute_command`      | 执行命令     |
+| `schedule_once`        | 定时任务     |
+| `think_now`            | 主动思考     |
+| `email_send`           | 发送邮件     |
+| `email_read`           | 读取邮件     |
+| `enable_plugin`        | 启用插件     |
+| `disable_plugin`       | 禁用插件     |
+| `update_plugin_config` | 更新插件配置 |
+
+## 插件位置
+
+- 内置插件：`plugins/`
+- 用户插件：`.foliko/plugins/`
+
+## 插件管理
+
+```javascript
+// 重启插件
+await framework.executeTool('reload_plugins', {});
+await framework.executeTool('reload_plugins', { pluginName: 'telegram' });
+
+// 启用/禁用插件
+await framework.executeTool('enable_plugin', { name: 'telegram' });
+await framework.executeTool('disable_plugin', { name: 'telegram' });
+
+// 更新插件配置（持久化）
+await framework.executeTool('update_plugin_config', {
+  name: 'telegram',
+  config: { allowedChats: ['123'], groupMode: true },
+});
+await framework.executeTool('get_plugin_config', { name: 'telegram' });
+```
+
+## 事件监听
+
+```javascript
+// Framework 事件
+framework.on('framework:ready', (fw) => {});
+framework.on('plugin:loaded', (plugin) => {});
+framework.on('tool:registered', (tool) => {});
+
+// Agent 事件
+agent.on('status', ({ status }) => {}); // idle/busy/error
+agent.on('chunk', (chunk) => {}); // 流式输出
+agent.on('tool-call', ({ name, args }) => {});
+agent.on('tool-result', ({ name, result }) => {});
+
+// 子 Agent 事件
+agent.on('subagent:chat:start', (data) => {});
+agent.on('subagent:chat:end', (data) => {});
+agent.on('subagent:error', (data) => {});
+```
+
+## 子 Agent 注册
+
+```javascript
+const { tool } = require('ai')
+const { z } = require('zod')
+
+// 方式1：配置 agents 数组自动注册
+class MyPlugin extends Plugin {
+  agents = [
+    {
+      name: 'code-agent',
+      role: '代码专家',
+      tools: {
+        compile: tool({
+          description: '编译',
+          parameters: z.object({ language: z.string(), code: z.string() }),
+          execute: async (args) => ({ success: true })
+        })
+      },
+      parentTools: ['read_file', 'write_file']
+    }
+  ]
+}
+
+// 方式2：手动调用
+this.registerSubAgent({ name: 'code-agent', role: '代码专家', tools: {...}, parentTools: [...] })
+```
+
+## 系统提示中的部分
+
+```
+【可用工具】
+- tool1: 描述
+- tool2: 描述
+
+【可用技能】
+- skill1: 描述
+- skill2: 描述
+
+【子 Agent 分配规则】
+- code-agent: 代码专家
+
+【系统能力】
+- ai: AI 对话能力
+- storage: 存储
+```
+
+## 状态管理
+
+```javascript
+agent.getStatus(); // 'idle' | 'busy' | 'error'
+agent.resetStatus(); // 重置状态
+agent.clearHistory(); // 清空历史
+```
+
+## 配置持久化
+
+插件配置自动保存到 `.foliko/data/plugins-state.json`
+
+| 文件                              | 用途                |
+| --------------------------------- | ------------------- |
+| `.foliko/data/plugins-state.json`  | 插件启用状态和配置  |
+| `.foliko/data/storage.json`        | 键值存储数据        |
+| `.foliko/data/telegram_images/`    | Telegram 接收的图片 |
+| `.foliko/data/telegram_documents/` | Telegram 接收的文档 |

package/package.json

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

package/plugins/extension-executor-plugin.js

@@ -307,22 +307,22 @@ class ExtensionExecutorPlugin extends Plugin {
 
     const ext = this._extensions.get(pluginName);
     const existingIdx = ext.tools.findIndex((t) => t.name === toolDef.name);
+    const toolEntry = {
+      name: toolDef.name,
+      description: toolDef.description || '',
+      inputSchema: toolDef.inputSchema,
+      execute: toolDef.execute,
+    };
+    // 保留额外属性（如 _options）
+    if (toolDef._options) {
+      toolEntry._options = toolDef._options;
+    }
     if (existingIdx >= 0) {
       // 更新已存在的工具
-      ext.tools[existingIdx] = {
-        name: toolDef.name,
-        description: toolDef.description || '',
-        inputSchema: toolDef.inputSchema,
-        execute: toolDef.execute,
-      };
+      ext.tools[existingIdx] = toolEntry;
     } else {
       // 添加新工具
-      ext.tools.push({
-        name: toolDef.name,
-        description: toolDef.description || '',
-        inputSchema: toolDef.inputSchema,
-        execute: toolDef.execute,
-      });
+      ext.tools.push(toolEntry);
     }
 
     log.debug(` Registered tool '${toolDef.name}' for extension '${pluginName}'`);
@@ -413,44 +413,17 @@ class ExtensionExecutorPlugin extends Plugin {
     if (this._extensions.size > 0 || (this._mcpExecutor && Object.keys(this._mcpExecutor.tools || {}).length > 0)) {
       desc += '## 【Extensions】扩展插件\n\n';
       desc += '**使用流程（必须按顺序执行）：**\n';
-      desc += '1. 调用 `ext_skill({ plugin: "<plugin_name>" })` 或 `loadSkill({ skill: "<skill_name>" })` 获取技能命令的详细参数\n';
-      desc += '2. 根据返回的参数定义，使用 `ext_call({ plugin: "skill", tool: "技能名:命令名", args: {...} })` 调用\n\n';
+      desc += '1. 调用 `ext_skill({ plugin: "<plugin_name>" })` 获取技能命令的详细参数\n';
+      desc += '2. 根据返回的参数定义，使用 `ext_call({ plugin: "<plugin_name>", tool: "<tool_name>", args: {...} })` 调用\n\n';
       desc += '> **警告**：禁止在未执行第1步获取参数的情况下直接调用 `ext_call`！\n\n';
 
       for (const [name, ext] of this._extensions) {
-        if (name === 'skill') {
-          // Skill 命令按技能名分组显示
-          const toolsBySkill = {};
-          for (const tool of ext.tools) {
-            // 跳过无效工具
-            if (!tool || !tool.name) continue;
-            // 命令格式: skillname:cmdname
-            const parts = tool.name.split(':');
-            const skillName = parts[0];
-            const cmdName = parts.slice(1).join(':');
-            if (!toolsBySkill[skillName]) {
-              toolsBySkill[skillName] = [];
-            }
-            toolsBySkill[skillName].push({ name: cmdName, description: tool.description });
-          }
-
-          for (const [skillName, cmds] of Object.entries(toolsBySkill)) {
-            desc += `### skill.${skillName}\n`;
-            desc += `**调用方式:**\n`;
-            desc += `1. 先调用 \`loadSkill({ skill: "${skillName}" })\` 获取 \`${skillName}\` 技能的详细参数\n`;
-            desc += `2. 调用 \`ext_call({ plugin: "skill", tool: "${skillName}:<命令名>", args: { args: "参数" } })\`\n\n`;
-            desc += `**可用命令:**\n`;
-            for (const c of cmds) {
-              desc += `- \`${c.name}\`: ${c.description}\n`;
-            }
-            desc += '\n';
-          }
-        } else {
+          if (name === 'mcp'|| name === 'skill') continue; // MCP 和 Skill 工具单独列出
           desc += `### ${ext.name || name}\n`;
           desc += `${ext.description || '无描述'}\n`;
           const validTools = ext.tools.filter(t => t && t.name);
           desc += `**工具:** ${validTools.map(t => `\`${t.name}\``).join(', ')}\n\n`;
-        }
+  
       }
 
       // MCP 服务器工具
@@ -461,7 +434,7 @@ class ExtensionExecutorPlugin extends Plugin {
       }
 
       desc += '\n## 禁止事项\n';
-      desc += '- 不先调用 `ext_skill/loadSkill` 获取参数就直接使用 `ext_call`\n';
+      desc += '- 不先调用 `ext_skill` 获取参数就直接使用 `ext_call`\n';
     }
 
     if (!desc) {
@@ -597,6 +570,7 @@ class ExtensionExecutorPlugin extends Plugin {
       .map(t => ({
         name: t.name.replace(/^([^:]+):(.*)$/, '$1:$2'),
         description: t.description || t.name,
+        options: t._options || null,
       }));
   }