foliko 2.0.5 → 2.0.6

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/skill-manager/PROMPT.md

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