foliko 1.1.72 → 1.1.75

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.75",
   "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,
       }));
   }