foliko 2.0.5 → 2.0.7

package/plugins/core/default/bootstrap.js

@@ -77,10 +77,21 @@ async function loadCustomPlugins(framework, agentConfig) {
             // 类式：new PluginClass()
             instance = new pluginClass(pluginConfig);
           } else {
-            // function(foliko) 格式：直接调用，传入 framework
-            pluginClass(framework);
-            // function(foliko) 不需要 return，插件内部自己注册
-            instance = null; // 不再作为插件实例加载
+            // function(Plugin) 或 function(foliko) 格式：尝试调用
+            try {
+              // 优先尝试 function(Plugin) 格式
+              const Result = pluginClass(Plugin);
+              if (Result && Result.prototype instanceof Plugin) {
+                instance = new Result(pluginConfig);
+              } else {
+                // function(foliko) 格式：传入 framework
+                pluginClass(framework);
+                instance = null;
+              }
+            } catch (err) {
+              log.error(`Failed to call plugin factory ${pluginName}:`, err.message);
+              continue;
+            }
           }
         } else {
           instance = pluginClass;
@@ -148,21 +159,6 @@ async function bootstrapDefaults(framework, config = {}) {
     }));
   }
 
-  // 1.5 Main Agent
-  if (!framework._mainAgent) {
-    const { Agent } = require('../../../src/agent/main');
-    const aiPlugin = framework.pluginManager.get('ai');
-    framework._mainAgent = framework.createAgent({
-      name: 'MainAgent',
-      systemPrompt: '你是一个智能助手。当用户提出问题或任务时，你会主动分析需求，选择合适的工具来获取信息或执行操作。你善于将复杂任务拆解为多个步骤，通过工具协作完成。',
-      model: aiConfig.model || 'deepseek-chat',
-      provider: aiConfig.provider || 'deepseek',
-      apiKey: aiPlugin ? aiPlugin.config.apiKey : (aiConfig.apiKey || envApiKey),
-      baseURL: aiConfig.baseURL,
-    });
-    framework._agents.push(framework._mainAgent);
-  }
-
   // 1.875 Extension executor (needed by skill-manager for slash commands)
   if (shouldLoad('extension-executor')) {
     const ExtensionExecutorPlugin = require('../../executors/extension');
@@ -251,6 +247,35 @@ async function bootstrapDefaults(framework, config = {}) {
   // 统一启动所有插件
   await framework.pluginManager.startAll();
 
+  // 等待 skill-manager 完成首次异步加载 (`_loadAllSkills` 包含动态 import ESM 的 index.js)
+  // 否则 MainAgent 首次 _buildSystemPrompt() 会错过 skill 命令
+  const skillManagerEntry = framework.pluginManager.get('skill-manager');
+  if (skillManagerEntry && typeof skillManagerEntry._loadReady?.then === 'function') {
+    try {
+      await skillManagerEntry._loadReady;
+    } catch (_) { /* 加载失败已在 skill-manager 内 log */ }
+  }
+
+  // ============= Main Agent (在所有 plugins 加载并 start 之后) =============
+  // 修复: 必须放到所有 plugins 加载并 start 之后再创建,并且 await skill-manager 的
+  // _loadReady。
+  // 原顺序下 MainAgent.constructor 会立即 _buildSystemPrompt(),此时 extension-executor
+  // 和 skill-manager 还没注册工具到 prompt registry,导致系统提示词里看不到 skill 命令
+  // —— 之前用户必须 reload 一次才看到就是这个 race。
+  if (!framework._mainAgent) {
+    const { Agent } = require('../../../src/agent/main');
+    const aiPlugin = framework.pluginManager.get('ai');
+    framework._mainAgent = framework.createAgent({
+      name: 'MainAgent',
+      systemPrompt: '你是一个智能助手。当用户提出问题或任务时,你会主动分析需求,选择合适的工具来获取信息或执行操作。你善于将复杂任务拆解为多个步骤,通过工具协作完成。',
+      model: aiConfig.model || 'deepseek-chat',
+      provider: aiConfig.provider || 'deepseek',
+      apiKey: aiPlugin ? aiPlugin.config.apiKey : (aiConfig.apiKey || envApiKey),
+      baseURL: aiConfig.baseURL,
+    });
+    framework._agents.push(framework._mainAgent);
+  }
+
   // 退出 bootstrap 模式
   framework.pluginManager.setBootstrapping(false);
 }

package/plugins/core/python-loader/index.js

@@ -53,15 +53,14 @@ class PythonPluginLoader extends Plugin {
     }
 
     let desc = '## 【Python 插件】\n\n'
-    desc += 'Python 插件工具通过 `ext_call` 调用：\n\n'
+    desc += '每个 Python 插件自动注册为 `python:<插件名>` 扩展，通过 `ext_skill` + `ext_call` 统一调用：\n\n'
 
     for (const [name, plugin] of this._pythonPlugins) {
-      desc += `### ${plugin.info.name}\n`
+      desc += `### python:${plugin.info.name}\n`
       desc += `${plugin.info.description || ''}\n\n`
       if (plugin.info.tools && Array.isArray(plugin.info.tools)) {
         for (const tool of plugin.info.tools) {
-          const fullName = `${name}_${tool.name}`
-          desc += `- **${fullName}**: ${tool.description || '无描述'}\n`
+          desc += `- **${tool.name}**: ${tool.description || '无描述'}\n`
           // 使用 zodSchemaToMarkdown 生成参数描述
           const params = tool.params || {}
           if (Object.keys(params).length > 0) {
@@ -82,7 +81,9 @@ class PythonPluginLoader extends Plugin {
     }
 
     desc += '**调用格式:**\n'
-    desc += '```\next_call({ plugin: "python", tool: "插件名_工具名", args: {...} })\n'
+    desc += '```\n'
+    desc += '// 1. 查询参数\next_skill({ plugin: "python:<插件名>" })\n'
+    desc += '// 2. 调用\next_call({ plugin: "python:<插件名>", tool: "<工具名>", args: {...} })\n'
     desc += '```\n'
     return desc.trim()
   }
@@ -151,7 +152,7 @@ class PythonPluginLoader extends Plugin {
           // 注册插件的每个工具
           if (pluginInfo.tools && Array.isArray(pluginInfo.tools)) {
             for (const tool of pluginInfo.tools) {
-              this._registerPythonTool(pluginName, tool)
+              this._registerPythonTool(pluginName, tool, pluginInfo);
             }
           }
         }
@@ -160,22 +161,32 @@ class PythonPluginLoader extends Plugin {
       }
     }
 
+    // 所有 Python 插件注册完毕后，强制失效 prompt 缓存，让 LLM 看到新的扩展
+    this._extensionExecutor?._invalidatePromptCaches?.(this._framework);
+
     //log.info(` Total Python plugins: ${this._pythonPlugins.size}`)
   }
 
   /**
-   * 注册 Python 插件的工具
-   * 工具名格式：插件名_工具名（如 stock_get_price）
-   * 直接注册到 ExtensionExecutor，使用 ext_call({ plugin: "python", tool: "插件名_工具名", args: {...} }) 调用
+   * 注册 Python 插件的单个工具到 ExtensionExecutor
+   *
+   * 每个 Python 插件注册为独立扩展 `python:<插件名>`，工具名是原始名（不带前缀）。
+   * LLM 通过以下方式调用：
+   *   1. 查询参数：ext_skill({ plugin: "python:<插件名>" })
+   *   2. 调用：ext_call({ plugin: "python:<插件名>", tool: "<工具名>", args: {...} })
+   *
+   * @param {string} pluginName Python 插件名（PLUGIN.name，例如 'stock'）
+   * @param {Object} tool 工具定义对象
+   * @param {string} tool.name 工具名（PLUGIN.TOOLS[].name，例如 'get_price'）
+   * @param {string} [tool.description] 工具描述（用于提示词）
+   * @param {Object} [tool.params] 工具参数定义（key → 类型占位符或 JSON Schema）
+   * @param {Object} [pluginMeta] 插件元信息（含 description），用于丰富扩展描述
    */
-  _registerPythonTool(pluginName, tool) {
+  _registerPythonTool(pluginName, tool, pluginMeta = null) {
     if (!tool.name) return
 
-    // 格式：pluginname_toolname
-    const fullToolName = `${pluginName}_${tool.name}`
-
     const toolDef = {
-      name: fullToolName,
+      name: tool.name,  // 工具原始名（如 get_price），不带 pluginName_ 前缀
       description: tool.description || `${pluginName} 的 ${tool.name} 工具`,
       inputSchema: this._parseToolParams(tool.params || {}),
       execute: async (args) => {
@@ -183,26 +194,33 @@ class PythonPluginLoader extends Plugin {
       }
     }
 
+    // 每个 Python 插件注册为独立扩展 `python:<pluginName>`
+    // 优先用 PLUGIN.description，fallback 到默认描述
+    const extName = `python:${pluginName}`;
+    const extDescription = pluginMeta?.description
+      ? pluginMeta.description
+      : `Python 插件 ${pluginName}`;
+    const pluginInfo = {
+      name: extName,
+      description: extDescription,
+      version: pluginMeta?.version || '1.0.0',
+    };
+
     try {
-      // 直接注册到 ExtensionExecutor（如果可用）
       if (this._extensionExecutor) {
-        this._extensionExecutor.registerTool(
-          'python',  // 插件名，用于 ext_call 的 plugin 参数
-          { name: 'python', description: 'Python 插件工具', version: '1.0.0' },
-          toolDef
-        )
+        this._extensionExecutor.registerTool(extName, pluginInfo, toolDef);
       } else {
-        // 回退到基类的 registerTool
+        // 回退到基类的 registerTool（带 pluginName 前缀以避免冲突）
         this.registerTool({
-          name: fullToolName,
-          description: `[${pluginName}] ${tool.description || ''}`,
+          name: `${pluginName}_${tool.name}`,
+          description: tool.description || `${pluginName} 的 ${tool.name} 工具`,
           pluginName: pluginName,
           inputSchema: this._parseToolParams(tool.params || {}),
           execute: toolDef.execute
-        })
+        });
       }
     } catch (err) {
-      log.error(` Failed to register tool ${fullToolName}:`, err.message)
+      log.error(` Failed to register tool ${tool.name} for ${extName}:`, err.message)
     }
   }
 

package/plugins/core/scheduler/index.js

@@ -773,6 +773,7 @@ class SchedulerPlugin extends Plugin {
   }
 
   reload(framework) {
+    this._tasks.clear()
     this._framework = framework
     this._agent = this._getAgent()
     this._startScheduler()

package/plugins/core/skill-manager/PROMPT.md

@@ -0,0 +1,6 @@
+## 可用技能
+
+> 命令详情（参数、调用方式）请查看上方【Extensions】扩展插件段落。
+> 详细使用指南用 `skill_load("技能名")` 加载。
+
+{{skills}}