foliko 2.0.2 → 2.0.3

package/plugins/core/think/index.js

@@ -116,6 +116,7 @@ class ThinkPlugin extends Plugin {
 - 思考要深入、全面
 - 直接给出结论和见解`,
       disableTools: false,
+      hidden: true, // 隐藏子Agent，不在指令系统中显示
     })
   }
 

package/plugins/core/workflow/index.js

@@ -173,7 +173,7 @@ class StepExecutor {
     // 解析工具参数，支持变量引用
     let resolvedArgs = this._resolveArgs(step.args || {}, context);
     // 兼容旧格式：处理 step.input 字段（${stepId.output} 引用）
-    // 将 input 注入到 args.input_data，供 python-execute 使用
+    // 将 input 注入到 args.input_data，供 py_execute 使用
     if (step.input) {
       const resolvedInput = this._resolveArgs(step.input, context);
       resolvedArgs.input_data = resolvedInput;
@@ -344,6 +344,7 @@ class StepExecutor {
     const messageAgent = this.framework.createSubAgent({
       name: 'workflow_message',
       role: '工作流任务执行助手，专注于处理工作流中的消息任务',
+      hidden: true
     });
     let content = step.content || '';
     // 支持变量引用
@@ -863,9 +864,9 @@ class WorkflowPlugin extends Plugin {
   start(framework) {
     this._loadWorkflows();
     this._registerWorkflowTools();
-    // 注册 reloadWorkflows 工具
+    // 注册 workflow_reload 工具
     framework.registerTool({
-      name: 'reloadWorkflows',
+      name: 'workflow_reload',
       description: '重载所有工作流，当用户添加或修改工作流后调用此工具',
       inputSchema: z.object({}),
       execute: async () => {
@@ -880,7 +881,7 @@ class WorkflowPlugin extends Plugin {
 
     // 注册列出工作流的工具
     framework.registerTool({
-      name: 'listWorkflows',
+      name: 'workflow_list',
       description: '列出所有已加载的工作流及其描述信息',
       inputSchema: z.object({}),
       execute: async () => {

package/plugins/executors/data-splitter/index.js

@@ -39,9 +39,22 @@ class DataSplitterPlugin extends Plugin {
     return this;
   }
 
+  // 声明式 prompt part
+  prompts = [
+    {
+      name: 'data-splitter-rules',
+      slot: 'BEHAVIOR',
+      description: '大工具结果自动分拆规则',
+      provider: function () {
+        return this._getPromptRules();
+      },
+    },
+  ];
+
   start(framework) {
+    super.start(framework);
     this._registerSplitTools();
-    this.registerPromptPart('data-splitter-rules', 85, () => this._getPromptRules());
+    // prompt part 由基类 _autoRegisterPrompts 自动处理
     this._registerAutoSplitHook();
   }
 

package/plugins/executors/extension/index.js

@@ -12,6 +12,18 @@ const { zodSchemaToMarkdown, zodSchemaToTable } = require('@chnak/zod-to-markdow
 const log = logger.child('ExtensionExecutor');
 
 class ExtensionExecutorPlugin extends Plugin {
+  // 声明式 prompt parts
+  prompts = [
+    {
+      name: 'extension-tools',
+      slot: 'CAPABILITY',
+      description: '所有扩展工具的说明和使用方式',
+      provider: function () {
+        return this._buildExtensionsDescription();
+      },
+    },
+  ];
+
   constructor(config = {}) {
     super();
     this.name = 'extension-executor';
@@ -35,6 +47,8 @@ class ExtensionExecutorPlugin extends Plugin {
       this._rescanPluginTools(plugin);
     });
 
+    // 不监听 tool:registered — 直接 registerTool 注册的工具通过 AI SDK 暴露给 LLM，无需出现在 Extensions 中
+
     framework.on('framework:ready', () => {
       log.debug('Framework ready, rescanning all plugin tools...');
       const plugins = framework.pluginManager.getAll();
@@ -44,7 +58,7 @@ class ExtensionExecutorPlugin extends Plugin {
         }
         this._scanPluginTools(plugin);
       }
-      this._refreshAllAgentsExtPrompt(framework);
+      this._invalidatePromptCaches(framework);
     });
 
     return this;
@@ -80,7 +94,7 @@ class ExtensionExecutorPlugin extends Plugin {
     log.debug(` Scanned ${Object.keys(plugin.tools).length} tools from plugin '${pluginName}' (as '${useExtName}')`);
 
     if (this._framework && this._framework._ready) {
-      this._refreshAllAgentsExtPrompt(this._framework);
+      this._invalidatePromptCaches(this._framework);
     }
   }
 
@@ -111,6 +125,7 @@ class ExtensionExecutorPlugin extends Plugin {
   }
 
   async start(framework) {
+    super.start(framework);
     const plugins = framework.pluginManager.getAll();
     for (const { instance: plugin } of plugins) {
       if (plugin.name === 'skill-manager') {
@@ -236,25 +251,21 @@ class ExtensionExecutorPlugin extends Plugin {
       execute: async (args) => {
         const { plugin } = args;
         if (plugin === 'skill') {
-          return "请使用 `loadSkill` 获取skill的使用详情"
+          return "请使用 `skill_load` 获取skill的使用详情"
         }
         return this.bindAllToolSkill(plugin)
       },
     });
 
     framework.on('agent:created', (agent) => {
-      this._refreshAgentExtPrompt(agent);
+      // Extension tool 描述已通过 prompts 声明式注册到 framework.prompts，
+      // 并由 _syncPromptParts 同步到子 Agent，无需再注入 _originalPrompt
     });
 
-    if (framework._ready) {
-      this._refreshAllAgentsExtPrompt(framework);
-    } else {
-      framework.once('framework:ready', () => {
-        this._refreshAllAgentsExtPrompt(framework);
-      });
-    }
+    // Extension tool 描述已通过 prompts 声明式注册到 framework.prompts，
+    // 不再需要 _refreshAllAgentsExtPrompt 注入 _originalPrompt
 
-    this.registerPromptPart('extension-tools', PROMPT_PRIORITY.EXTENSION_TOOLS, () => this._buildExtensionsDescription());
+    // prompt part 由基类 _autoRegisterPrompts 自动处理
 
     return this;
   }
@@ -294,7 +305,7 @@ class ExtensionExecutorPlugin extends Plugin {
     log.debug(` Registered tool '${toolDef.name}' for extension '${pluginName}'`);
 
     if (this._framework && this._framework._ready) {
-      this._refreshAllAgentsExtPrompt(this._framework);
+      this._invalidatePromptCaches(this._framework);
     }
   }
 
@@ -339,32 +350,17 @@ class ExtensionExecutorPlugin extends Plugin {
     return sections.join('\n')
   }
 
-  _refreshAllAgentsExtPrompt(framework) {
-    const visited = new Set();
-    const traverse = (agent) => {
-      if (!agent || visited.has(agent)) return;
-      visited.add(agent);
-      this._refreshAgentExtPrompt(agent);
-      const subAgents = agent.getSubAgents?.() || agent._subAgents || new Map();
-      for (const [, subAgentInfo] of subAgents) {
-        traverse(subAgentInfo.agent);
-      }
-    };
-    for (const agent of framework._agents || []) {
-      traverse(agent);
+  /**
+   * 失效所有 Agent 的延展工具 prompt 缓存
+   * 不再注入 _originalPrompt，仅失效缓存让下次 build 时自动读取最新 _buildExtensionsDescription()
+   */
+  _invalidatePromptCaches(framework) {
+    framework?.prompts?.invalidate(this.name, 'extension-tools');
+    for (const agent of framework?._agents || []) {
+      agent._invalidateSystemPromptCache?.();
     }
   }
 
-  _refreshAgentExtPrompt(agent) {
-    const extDesc = this._buildExtensionsDescription();
-    if (!extDesc) return;
-
-    let existingPrompt = agent._originalPrompt || '';
-
-    const extRegex = /## 【Extensions】[\s\S]*?(?=\n## 【|$)/;
-    existingPrompt = existingPrompt.replace(extRegex, '').trim();
-  }
-
   _buildExtensionsDescription() {
     let desc = '';
 
@@ -497,6 +493,24 @@ class ExtensionExecutorPlugin extends Plugin {
     }));
   }
 
+  // 获取指定插件的所有工具
+  getExtensionTools(pluginName) {
+    const ext = this._extensions.get(pluginName);
+    return ext ? ext.tools : [];
+  }
+
+  // 获取指定插件的指定工具
+  getExtensionTool(pluginName, toolName) {
+    const ext = this._extensions.get(pluginName);
+    if (!ext) return null;
+    return ext.tools.find(t => t.name === toolName) || null;
+  }
+
+  // 获取所有插件名称
+  getExtensionNames() {
+    return Array.from(this._extensions.keys());
+  }
+
   getSkillCommands() {
     const ext = this._extensions.get('skill');
     if (!ext) return [];
@@ -547,7 +561,7 @@ class ExtensionExecutorPlugin extends Plugin {
       this._rescanPluginTools(plugin);
     }
     this._mcpExecutor = framework.pluginManager?.get('mcp') || null;
-    this._refreshAllAgentsExtPrompt(framework);
+    this._invalidatePromptCaches(framework);
 
     await this._reloadMCPConfig(framework);
   }

package/plugins/executors/python/index.js

@@ -46,7 +46,7 @@ class PythonExecutorPlugin extends Plugin {
 
   start(framework) {
     framework.registerTool({
-      name: 'python-execute',
+      name: 'py_execute',
       description: '执行 Python 代码，禁止传入无用的emoji',
       inputSchema: z.object({
         code: z.string().describe('Python 代码'),
@@ -59,7 +59,7 @@ class PythonExecutorPlugin extends Plugin {
     })
 
     framework.registerTool({
-      name: 'python_script',
+      name: 'py_script',
       description: '执行 Python 脚本文件',
       inputSchema: z.object({
         scriptPath: z.string().describe('Python 脚本文件路径'),
@@ -72,7 +72,7 @@ class PythonExecutorPlugin extends Plugin {
     })
 
     framework.registerTool({
-      name: 'pip_install',
+      name: 'py_pip_install',
       description: '安装 Python 包',
       inputSchema: z.object({
         package: z.string().describe('包名 (例如: numpy, pandas>=1.0)'),

package/plugins/executors/shell/index.js

@@ -34,9 +34,8 @@ class ShellExecutorPlugin extends Plugin {
   }
 
   start(framework) {
-    // 注册 shell 工具
-    framework.registerTool({
-      name: 'shell',
+    // 注册 shell 工具（同时注册新旧两个名字以兼容旧代码）
+    const shellExecHandler = {
       description: '执行 Shell 命令',
       inputSchema: z.object({
         command: z.string().describe('要执行的命令'),
@@ -108,7 +107,10 @@ class ShellExecutorPlugin extends Plugin {
           }, timeout)
         })
       }
-    })
+    };
+
+    framework.registerTool({ name: 'shell_exec', ...shellExecHandler });
+    framework.registerTool({ name: 'shell', ...shellExecHandler });
 
     if (process.platform === 'win32') {
       framework.registerTool({

package/plugins/io/web/index.js

@@ -455,7 +455,8 @@ class WebPlugin extends Plugin {
 
     const webhookAgent = this._framework.createSubAgent({
       name: 'webhook_handler',
-      role: 'Webhook处理助手，专注于处理webhook数据并生成适当响应'
+      role: 'Webhook处理助手，专注于处理webhook数据并生成适当响应',
+      hidden: true
     })
 
     if (!webhook.awaitResponse) {

package/plugins/memory/index.js

@@ -10,7 +10,7 @@ const { z } = require('zod')
 const fs = require('fs')
 const path = require('path')
 const { EventEmitter } = require('events')
-const {cleanResponse} =require('../../src/utils')
+const {cleanResponse, parseFrontmatter} =require('../../src/utils')
 /**
  * 记忆类型常量
  */
@@ -26,64 +26,6 @@ const MEMORY_TYPES = {
  */
 const MEMORY_BASE_DIR = '.foliko/memory'
 
-/**
- * 解析 YAML frontmatter（从 skill-manager 复用）
- */
-function parseFrontmatter(content) {
-  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)
-  if (!match) return null
-
-  const frontmatter = {}
-  const lines = match[1].split('\n')
-  let currentKey = null
-
-  for (const line of lines) {
-    if (currentKey === 'metadata') {
-      if (line.match(/^ {2}[a-zA-Z]/)) {
-        const colonIndex = line.indexOf(':')
-        if (colonIndex > 0) {
-          const key = line.substring(2, colonIndex).trim()
-          const value = line.substring(colonIndex + 1).trim().replace(/^["']|["']$/g, '')
-          frontmatter[currentKey][key] = value
-          continue
-        }
-      } else if (line.match(/^[a-zA-Z]/)) {
-        currentKey = null
-        continue
-      }
-    }
-
-    const colonIndex = line.indexOf(':')
-    if (colonIndex === -1) continue
-
-    const key = line.substring(0, colonIndex).trim()
-    let value = line.substring(colonIndex + 1).trim()
-
-    if (
-      (value.startsWith('"') && value.endsWith('"')) ||
-      (value.startsWith("'") && value.endsWith("'"))
-    ) {
-      value = value.slice(1, -1)
-    }
-
-    if (key === 'metadata') {
-      currentKey = 'metadata'
-      frontmatter.metadata = {}
-    } else if (key === 'tags') {
-      // 去除首尾空白和方括号
-      value = value.trim().replace(/^\[|\]$/g, '')
-      frontmatter[key] = value
-        .split(',')
-        .map(t => t.trim().replace(/^["']|["']$/g, ''))
-        .filter(t => t)
-    } else {
-      frontmatter[key] = value
-    }
-  }
-
-  return frontmatter
-}
-
 /**
  * 序列化 frontmatter
  */
@@ -575,13 +517,14 @@ class MemoryPlugin extends Plugin {
     // 初始化存储
     this._store = new MemoryStore(this.config.memoryDir, this._framework?.getCwd?.())
 
-    // 创建复用的记忆提取子 Agent
+    // 创建复用的记忆提取子 Agent（隐藏，不在指令系统中显示）
     this._memoryAgent = framework.createSubAgent({
       name: 'memory-extractor',
       role: '记忆提取专家',
       description: '专门负责从对话和错误中提取记忆的子 Agent',
       tools: {}, // 不需要额外工具，隔离主 Agent 工具
-      parentTools: [] // 不继承任何工具，纯粹做提取
+      parentTools: [], // 不继承任何工具，纯粹做提取
+      hidden: true, // 隐藏子Agent，不在指令系统中显示
     })
 
     // 注册工具
@@ -1166,25 +1109,28 @@ ${prompt}`
 
   /**
    * 注册 memory-context 到系统提示
+   * 使用 framework.prompts 新 API，slot=CONTEXT
    */
   _registerMemoryContext(framework) {
-    const mainAgent = framework._mainAgent
-    if (mainAgent) {
-      mainAgent.registerPromptPart('memory-context', 350, () => {
-        return this._buildMemoryContext()
+    const reg = framework?.prompts
+    const doRegister = () => {
+      if (!reg) return
+      reg.register(this.name, 'memory-context', () => this._buildMemoryContext(), {
+        slot: 'CONTEXT',
+        description: '长期记忆上下文摘要',
       })
-      mainAgent._refreshContext()
-    }
-
-    framework.on('framework:ready', () => {
       const agent = framework._mainAgent
-      if (agent) {
-        agent.registerPromptPart('memory-context', 350, () => {
-          return this._buildMemoryContext()
-        })
+      if (agent && typeof agent._invalidateSystemPromptCache === 'function') {
+        agent._invalidateSystemPromptCache()
         agent._refreshContext()
       }
-    })
+    }
+
+    if (framework._ready) {
+      doRegister()
+    } else {
+      framework.on('framework:ready', doRegister)
+    }
   }
 
   /**
@@ -1225,14 +1171,23 @@ ${prompt}`
 
       if (userMemories.length > 0) {
         parts.push('### 【用户偏好】')
+        const seen = new Set()
         for (const m of userMemories) {
+          // 去重：跳过前 30 字相似的内容
+          const key = (m.body || '').trim().slice(0, 30)
+          if (seen.has(key)) continue
+          seen.add(key)
           parts.push(`- ${m.name}: ${m.body.substring(0, 150)}${m.body.length > 150 ? '...' : ''}`)
         }
       }
 
       if (projectMemories.length > 0) {
         parts.push('### 【项目上下文】')
+        const seen = new Set()
         for (const m of projectMemories) {
+          const key = (m.body || '').trim().slice(0, 30)
+          if (seen.has(key)) continue
+          seen.add(key)
           const projectTag = m.project ? `[${m.project}] ` : ''
           parts.push(`- ${projectTag}${m.name}: ${m.body.substring(0, 100)}${m.body.length > 100 ? '...' : ''}`)
         }

package/plugins/messaging/email/handlers.js

@@ -4,25 +4,7 @@
 
 const Imap = require('imap-mkl')
 const { simpleParser } = require('mailparser')
-const { getConfig, processAttachment } = require('./utils')
-const { DEFAULT_IMAP, IMAP_CLIENT_INFO } = require('./constants')
-
-/**
- * 创建 IMAP 配置
- * @param {Object} config - 用户配置
- * @returns {Object} IMAP 配置
- */
-function createImapConfig(config = {}) {
-  const cfg = getConfig(config)
-  return {
-    ...DEFAULT_IMAP,
-    user: cfg.user,
-    password: cfg.password,
-    host: cfg.host,
-    port: cfg.port,
-    id: IMAP_CLIENT_INFO
-  }
-}
+const { getConfig, processAttachment, createImapConfig } = require('./utils')
 
 /**
  * 发送邮件

package/plugins/messaging/email/monitor.js

@@ -4,23 +4,8 @@
 
 const Imap = require('imap-mkl')
 const { simpleParser } = require('mailparser')
-const { DEFAULT_IMAP, IMAP_CLIENT_INFO, EMAIL_DEFAULTS } = require('./constants')
-const { getConfig, generateCallId } = require('./utils')
-
-/**
- * 创建 IMAP 配置
- */
-function createImapConfig(config = {}) {
-  const cfg = getConfig(config)
-  return {
-    ...DEFAULT_IMAP,
-    user: cfg.user,
-    password: cfg.password,
-    host: cfg.host,
-    port: cfg.port,
-    id: IMAP_CLIENT_INFO
-  }
-}
+const { EMAIL_DEFAULTS } = require('./constants')
+const { getConfig, generateCallId, createImapConfig } = require('./utils')
 
 /**
  * 标记所有现有未读邮件为已读（启动监控前调用）

package/plugins/messaging/email/reply.js

@@ -39,7 +39,8 @@ async function handleAutoReply(emailPlugin, args) {
     const replyAgent = emailPlugin._framework.createSubAgent({
       name: 'email_replier',
       role: '邮件自动回复助手，专注于生成专业、礼貌、简洁的邮件回复',
-      parentTools: []
+      parentTools: [],
+      hidden: true
     })
 
     // 构建提示让 LLM 生成回复

package/plugins/messaging/email/utils.js

@@ -114,11 +114,30 @@ function generateCallId() {
   return `${Date.now()}_${Math.random().toString(36).substr(2, 5)}`
 }
 
+/**
+ * 创建 IMAP 配置
+ * @param {Object} config - 配置对象
+ * @returns {Object} IMAP 配置
+ */
+function createImapConfig(config = {}) {
+  const cfg = getConfig(config)
+  const { DEFAULT_IMAP, IMAP_CLIENT_INFO } = require('./constants')
+  return {
+    ...DEFAULT_IMAP,
+    user: cfg.user,
+    password: cfg.password,
+    host: cfg.host,
+    port: cfg.port,
+    id: IMAP_CLIENT_INFO
+  }
+}
+
 module.exports = {
   isValidEmail,
   parseEmailAddress,
   getConfig,
   fetchUrl,
   processAttachment,
-  generateCallId
+  generateCallId,
+  createImapConfig
 }

package/plugins/messaging/feishu/index.js

@@ -212,7 +212,7 @@ class FeishuPlugin extends Plugin {
         break
       case 'reload':
         try {
-          await this._framework.executeTool('reloadSkills', {})
+          await this._framework.executeTool('skill_reload', {})
           await this._sendMessage(openId, '✅ 技能已重载', originalMsg)
         } catch (err) {
           await this._sendMessage(openId, '❌ 重载失败: ' + err.message, originalMsg)

package/plugins/messaging/qq/index.js

@@ -695,7 +695,7 @@ class QQPlugin extends Plugin {
         break
       case 'reload':
         try {
-          await this._framework.executeTool('reloadSkills', {})
+          await this._framework.executeTool('skill_reload', {})
           await this._sendMessage(openid, '✅ 技能已重载')
         } catch (err) {
           await this._sendMessage(openid, '❌ 重载失败: ' + err.message)

package/plugins/messaging/telegram/index.js

@@ -328,7 +328,7 @@ class TelegramPlugin extends Plugin {
         break
       case 'reload':
         try {
-          await this._framework.executeTool('reloadSkills', {})
+          await this._framework.executeTool('skill_reload', {})
           await this._sendMessage(chatId, '✅ 技能已重载', msg.message_id)
         } catch (err) {
           await this._sendMessage(chatId, '❌ 重载失败: ' + err.message, msg.message_id)

package/plugins/messaging/weixin/index.js

@@ -641,7 +641,7 @@ class WeixinPlugin extends Plugin {
         break
       case 'reload':
         try {
-          await this._framework.executeTool('reloadSkills', {})
+          await this._framework.executeTool('skill_reload', {})
           await this._sendMessageBatch(originalMsg, userId, '✅ 技能已重载', true)
         } catch (err) {
           await this._sendMessageBatch(originalMsg, userId, '❌ 重载失败: ' + err.message, true)

package/plugins/plugin-manager/index.js

@@ -5,45 +5,13 @@
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
 const { Plugin } = require('../../src/plugin/base');
 const { logger } = require('../../src/common/logger');
 const { z } = require('zod');
-const { DEFAULT_REPO, shouldIgnore } = require('../../src/cli/utils/plugin-config');
+const { DEFAULT_REPO, shouldIgnore, copyDirRecursive, parseGitUrl, gitCommand } = require('../../src/utils');
 
 const log = logger.child('PluginManagerPlugin');
 
-function copyDirRecursive(src, dest) {
-  if (!fs.existsSync(src)) return;
-  fs.mkdirSync(dest, { recursive: true });
-
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (shouldIgnore(entry.name)) { log.debug(`Ignoring: ${entry.name}`); continue; }
-    if (entry.isDirectory()) { copyDirRecursive(srcPath, destPath); }
-    else { fs.copyFileSync(srcPath, destPath); }
-  }
-}
-
-function gitCommand(args, cwd) {
-  try { return execSync(`git ${args}`, { cwd, encoding: 'utf-8', stdio: 'pipe' }); }
-  catch (err) { return err.stdout || err.stderr || ''; }
-}
-
-function parseGitUrl(url) {
-  const patterns = [
-    /^https:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/,
-    /^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/,
-  ];
-  for (const pattern of patterns) {
-    const match = url.match(pattern);
-    if (match) return { owner: match[1], repo: match[2] };
-  }
-  return null;
-}
-
 class PluginManagerPlugin extends Plugin {
   constructor(config = {}) {
     super();

package/plugins/tools/index.js

@@ -19,6 +19,18 @@ class ToolsPlugin extends Plugin {
     this._framework = null;
   }
 
+  // 声明式 prompt parts（替代原 start() 中的 registerPromptPart 调用）
+  prompts = [
+    {
+      name: 'tool-core-rules',
+      slot: 'BEHAVIOR',
+      description: '工具调用核心规则 + 响应规范 + 禁止事项',
+      provider: function () {
+        return this._getToolCoreRules();
+      },
+    },
+  ];
+
   install(framework) {
     this._framework = framework;
     this._registerBuiltinTools();
@@ -26,7 +38,8 @@ class ToolsPlugin extends Plugin {
   }
 
   start(framework) {
-    this.registerPromptPart('tool-core-rules', 95, () => this._getToolCoreRules());
+    super.start(framework);
+    // prompt parts 由基类 _autoRegisterPrompts 自动处理
   }
 
   _getToolCoreRules() {