foliko 2.0.2 → 2.0.3

package/plugins/core/skill-manager/index.js

@@ -5,11 +5,13 @@
 
 const fs = require('fs');
 const path = require('path');
+const { pathToFileURL } = require('url');
 const { Plugin } = require('../../../src/plugin/base');
 const { logger } = require('../../../src/common/logger');
 const log = logger.child('SkillManager');
 const { z } = require('zod');
 const { Command } = require('commander');
+const { parseFrontmatter, stripFrontmatter } = require('../../../src/utils');
 
 /**
  * 简单的 shell 参数解析器（处理带引号的参数）
@@ -44,85 +46,74 @@ function parseShellArgs(str) {
 }
 
 /**
- * 验证 skill 名称
- * 1-64字符，字母数字、下划线和连字符，不能以连字符或下划线开头或结尾
+ * 格式化选项为人类可读的描述
+ * @param {Object} o - 选项对象 { flags, description, defaultValue, required }（required 未设置或为 false 时不标必填）
+ * @returns {string} 格式化后的描述
  */
-function isValidSkillName(name) {
-  if (!name || name.length < 1 || name.length > 64) return false;
-  if (!/^[a-zA-Z0-9_-]+$/.test(name)) return false;
-  if (name.startsWith('-') || name.startsWith('_') || name.endsWith('-') || name.endsWith('_'))
-    return false;
-  if (/--/.test(name) || /__/.test(name)) return false;
-  return true;
+function formatOptionForHelp(o) {
+  const flags = o.flags || '';
+  const hasValue = flags.includes('<');
+  const defaultVal = o.defaultValue !== undefined ? ` (默认: ${o.defaultValue})` : '';
+  const required = o.required === true && hasValue;
+
+  const parts = flags.split(/\s+/).filter(p => p && !p.includes('<')).map(p => p.replace(/,$/, ''));
+  if (parts.length === 0) return `${flags}${defaultVal}`;
+
+  const firstPart = parts[0];
+  const isShort = /^-[a-zA-Z]$/.test(firstPart);
+  const isLong = firstPart.startsWith('--');
+
+  if (isShort && parts.length > 1) {
+    // 短+长选项: -i, --video-id -> -i/--video-id
+    const longOpt = parts[1].replace(/^--+/, '');
+    return `-${parts[0].slice(1)}/--${longOpt}${hasValue ? ' <值>' : ''}: ${o.description || ''}${required ? ' [必填]' : ''}${defaultVal}`;
+  } else if (isLong) {
+    return `--${parts[0].slice(2)}${hasValue ? ' <值>' : ''}: ${o.description || ''}${required ? ' [必填]' : ''}${defaultVal}`;
+  } else if (isShort) {
+    return `-${firstPart.slice(1)}${hasValue ? ' <值>' : ''}: ${o.description || ''}${required ? ' [必填]' : ''}${defaultVal}`;
+  }
+  return `${flags}${defaultVal}`;
 }
 
 /**
- * 解析 YAML frontmatter
+ * 格式化选项为示例参数
+ * @param {Object} o - 选项对象
+ * @returns {string} 格式化后的示例
  */
-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) {
-    // 处理 metadata 嵌套
-    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 === 'allowed-tools') {
-      frontmatter[key] = value
-        .split(',')
-        .map((t) => t.trim().replace(/^["']|["']$/g, ''))
-        .filter((t) => t);
-    } else {
-      frontmatter[key] = value;
-    }
+function formatOptionForExample(o) {
+  const flags = o.flags || '';
+  const hasValue = flags.includes('<');
+  const def = o.defaultValue !== undefined ? String(o.defaultValue) : '';
+
+  const parts = flags.split(/\s+/).filter(p => p && !p.includes('<')).map(p => p.replace(/,$/, ''));
+  if (parts.length === 0) return '';
+
+  const firstPart = parts[0];
+  const isShort = /^-[a-zA-Z]$/.test(firstPart);
+  const isLong = firstPart.startsWith('--');
+
+  if (isShort && parts.length > 1) {
+    const longOpt = parts[1].replace(/^--+/, '');
+    return `-${parts[0].slice(1)} ${def || '<值>'}`;
+  } else if (isLong) {
+    return `--${parts[0].slice(2)} ${def || '<值>'}`;
+  } else if (isShort) {
+    return `-${firstPart.slice(1)} ${def || '<值>'}`;
   }
-
-  return frontmatter;
+  return firstPart;
 }
 
 /**
- * 移除 frontmatter，获取正文
+ * 验证 skill 名称
+ * 1-64字符，字母数字、下划线和连字符，不能以连字符或下划线开头或结尾
  */
-function stripFrontmatter(content) {
-  const match = content.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
-  return match ? content.slice(match[0].length).trim() : content.trim();
+function isValidSkillName(name) {
+  if (!name || name.length < 1 || name.length > 64) return false;
+  if (!/^[a-zA-Z0-9_-]+$/.test(name)) return false;
+  if (name.startsWith('-') || name.startsWith('_') || name.endsWith('-') || name.endsWith('_'))
+    return false;
+  if (/--/.test(name) || /__/.test(name)) return false;
+  return true;
 }
 
 /**
@@ -168,12 +159,18 @@ class Skill {
 
   /**
    * 注册 skill 的命令到 extension 系统
+   * 异步版本：用动态 import() 替代 require()，支持 ESM 包
+   * （Node 22+ 不允许 require ESM-only 包，比如 puppeteer、nanoid）
    */
-  registerCommands() {
-    if (!this._framework || !this._skillPath) return;
+  async registerCommands() {
+    if (!this._framework || !this._skillPath) {
+      return;
+    }
 
     const indexPath = path.join(this._skillPath, 'index.js');
-    if (!fs.existsSync(indexPath)) return;
+    if (!fs.existsSync(indexPath)) {
+      return;
+    }
 
     const skillName = this.metadata?.name || this.name || path.basename(this._skillPath);
 
@@ -191,16 +188,21 @@ class Skill {
     };
 
     try {
-      // 清除缓存，确保重新加载
-      delete require.cache[require.resolve(indexPath)];
-      const mod = require(indexPath);
-
-      // 检查导出格式
-      const commands = mod.exports || mod;
+      // 用动态 import 同时支持 CJS 和 ESM
+      // （Node 22+ 默认开启 require(ESM)，Node 20 需 --experimental-require-module 标志）
+      const mod = await import(pathToFileURL(indexPath).href);
+      const commands = mod.default || mod.exports || mod;
       if (!commands) return;
 
-      // 支持多种导出格式
-      const cmds = Array.isArray(commands) ? commands : [commands];
+      // 支持多种导出格式：数组 / 单个对象 / { commands: [...] }
+      let cmds;
+      if (Array.isArray(commands)) {
+        cmds = commands;
+      } else if (Array.isArray(commands.commands)) {
+        cmds = commands.commands;
+      } else {
+        cmds = [commands];
+      }
 
       for (const cmd of cmds) {
         if (!cmd || !cmd.name) continue;
@@ -235,21 +237,42 @@ class Skill {
           };
         }
 
+        // 构建详细的命令描述，帮助 LLM 正确调用
+        let commandHint = '';
+        if (cmd.options && cmd.options.length > 0) {
+          const optDescs = cmd.options.map(formatOptionForHelp);
+          commandHint = `\n  可用选项:\n  ${optDescs.join('\n  ')}`;
+        }
+
+        // 生成示例命令
+        const exampleCmd = cmd.options && cmd.options.length > 0
+          ? cmd.options.map(o => {
+              const flag = (o.flags || '').split(/[,\s]+/).filter(p => p && !p.includes('<') && !p.includes(','))[0]?.replace(/^-*/, '') || '';
+              const hasValue = (o.flags || '').includes('<');
+              const def = o.defaultValue !== undefined && o.defaultValue !== '' ? String(o.defaultValue) : '';
+              const val = def || '<值>';
+              return hasValue ? `-${flag} ${val}` : `-${flag}`;
+            }).join(' ')
+          : '';
+
         const toolDef = {
           name: fullName,
-          description: cmd.description || `Skill command: ${fullName}`,
+          description: `${cmd.description || 'Skill command'}\n\n**重要**: args.command 是**字符串**，不是对象！\n例: args: { command: "${exampleCmd}" }\n\n${commandHint}`,
           inputSchema: z.object({
-            command: z.string().optional().describe('命令行'),
+            command: z.string().optional().describe(
+              cmd.options && cmd.options.length > 0
+                ? `**字符串**，空格分隔，如: ${cmd.options.map(formatOptionForExample).join(' ')}`
+                : `**字符串**，命令行参数`
+            ),
           }),
-          _options: cmd.options || null,  // 保存 options 信息用于提示词生成
+          _options: cmd.options || null,
           execute: async (toolArgs, framework) => {
             const ctx = {
               sessionId: framework?._currentSessionId || 'unknown',
               agent: null,
               framework: framework,
-              cwd: framework?.getCwd?.() ?? process.cwd(), // 工作目录，用于路径解析
+              cwd: framework?.getCwd?.() ?? process.cwd(),
             };
-            // 支持 argumentParser 先解析参数
             let parsedArgs = toolArgs.command || '';
             if (typeof argumentParser === 'function') {
               parsedArgs = argumentParser(toolArgs.command || '');
@@ -258,7 +281,7 @@ class Skill {
           },
         };
 
-        // 注册到 extension 系统，通过 ext_call 调用
+        // 注册到 extension 系统
         extExecutor.registerTool('skill', skillInfo, toolDef);
 
         // 同时添加到 this.tools，供 extension-executor 的 _scanPluginTools 扫描
@@ -266,10 +289,6 @@ class Skill {
 
         this._commands.push(fullName);
       }
-
-      if (this._commands.length > 0) {
-        // log.info(`[${skillName}] Registered ${this._commands.length} commands: ${this._commands.join(', ')}`);
-      }
     } catch (err) {
       log.warn(`Failed to load commands from ${indexPath}:`, err.message);
     }
@@ -280,6 +299,18 @@ class Skill {
  * SkillManager 插件
  */
 class SkillManagerPlugin extends Plugin {
+  // 声明式 prompt parts
+  prompts = [
+    {
+      name: 'skills',
+      slot: 'CAPABILITY',
+      description: '可用技能列表',
+      provider: function () {
+        return this._buildSkillsDescription();
+      },
+    },
+  ];
+
   constructor(config = {}) {
     super();
     this.name = 'skill-manager';
@@ -303,11 +334,12 @@ class SkillManagerPlugin extends Plugin {
   }
 
   start(framework) {
-    this._loadAllSkills();
+    super.start(framework);
+    this._loadAllSkills().catch(err => log.error('_loadAllSkills failed:', err.message));
 
-    // 注册 loadSkill 工具
+    // 注册 skill_load 工具
     framework.registerTool({
-      name: 'loadSkill',
+      name: 'skill_load',
       description: '加载指定技能，获取技能的使用指南和内容',
       inputSchema: z.object({
         skill: z.string().describe('技能名称'),
@@ -318,9 +350,34 @@ class SkillManagerPlugin extends Plugin {
         if (!skill) {
           return { success: false, error: `Skill '${skillName}' not found` };
         }
+
+        // 附加该技能注册的命令文档（含参数说明）
+        let commandDocs = '';
+        const extExecutor = this._framework?.pluginManager?.get('extension-executor');
+        const skillCommands = extExecutor?.getSkillCommands?.() || [];
+        const cmds = skillCommands.filter(t => t.name && t.name.startsWith(skillName + ':'));
+        if (cmds.length > 0) {
+          const cmdLines = ['', '---', '### 命令参考', ''];
+          for (const cmd of cmds) {
+            const cmdName = cmd.name.split(':').slice(1).join(':');
+            cmdLines.push(`**${cmdName}**：${cmd.description || '无描述'}`);
+            if (cmd.options && cmd.options.length > 0) {
+              cmdLines.push('', '参数：');
+              for (const opt of cmd.options) {
+                const defaultStr = opt.defaultValue !== undefined ? `（默认: ${opt.defaultValue}）` : '';
+                const requiredStr = opt.required === true ? ' [必填]' : '';
+                cmdLines.push(`  \`${opt.flags}\`${requiredStr}${defaultStr}`);
+                if (opt.description) cmdLines.push(`    ${opt.description}`);
+              }
+            }
+            cmdLines.push('');
+          }
+          cmdLines.push('调用：`ext_call({ plugin: "skill", tool: "' + skillName + ':<命令>", args: { command: "参数" } })`');
+          commandDocs = cmdLines.join('\n');
+        }
         return {
           success: true,
-          data: skill.content,
+          data: [skill.content,commandDocs].join('\n'),
           metadata: {
             name: skill.name,
             description: skill.metadata?.description || '',
@@ -329,9 +386,9 @@ class SkillManagerPlugin extends Plugin {
       },
     });
 
-    // 注册 reloadSkills 工具
+    // 注册 skill_reload 工具
     framework.registerTool({
-      name: 'reloadSkills',
+      name: 'skill_reload',
       description: '重载所有技能，当用户添加新技能或修改技能后调用此工具',
       inputSchema: z.object({}),
       execute: async () => {
@@ -346,9 +403,9 @@ class SkillManagerPlugin extends Plugin {
       },
     });
 
-    // 注册 loadReference 工具（按需加载 skill 的附加文档）
+    // 注册 skill_load_reference 工具（按需加载 skill 的附加文档）
     framework.registerTool({
-      name: 'loadReference',
+      name: 'skill_load_reference',
       description: '加载指定技能的附加参考文档（references 目录下的文件）',
       inputSchema: z.object({
         skill: z.string().describe('技能名称'),
@@ -384,9 +441,9 @@ class SkillManagerPlugin extends Plugin {
       },
     });
 
-    // 注册 listScripts 工具（列出 skill 的脚本）
+    // 注册 skill_list_scripts 工具（列出 skill 的脚本）
     framework.registerTool({
-      name: 'listScripts',
+      name: 'skill_list_scripts',
       description: '列出指定技能下的所有可执行脚本',
       inputSchema: z.object({
         skill: z.string().describe('技能名称'),
@@ -401,9 +458,9 @@ class SkillManagerPlugin extends Plugin {
       },
     });
 
-    // 注册 loadScript 工具（读取脚本内容）
+    // 注册 skill_load_script 工具（读取脚本内容）
     framework.registerTool({
-      name: 'loadScript',
+      name: 'skill_load_script',
       description: '读取指定技能下脚本文件的内容',
       inputSchema: z.object({
         skill: z.string().describe('技能名称'),
@@ -428,9 +485,7 @@ class SkillManagerPlugin extends Plugin {
       },
     });
 
-    // 注册技能列表提示词
-    this.registerPromptPart('skills', 90, () => this._buildSkillsDescription());
-
+    // prompt part 由基类 _autoRegisterPrompts 自动处理
     return this;
   }
 
@@ -443,13 +498,16 @@ class SkillManagerPlugin extends Plugin {
       return '';
     }
 
-    const lines = ['## 可用技能', ''];
+    const lines = [
+      '## 可用技能',
+      '命令调用（仅对上方标注了「命令:」的技能有效）：`ext_call({ plugin: "skill", tool: "<技能名>:<命令>", args: { command: "参数" } })`',
+      '',
+    ];
 
-    // 获取 skill 的命令（通过 extension-executor 插件获取已注册的工具）
     const extExecutor = this._framework?.pluginManager?.get('extension-executor');
     const skillCommands = extExecutor?.getSkillCommands?.() || [];
 
-    // 按技能名分组
+    // 按技能名分组命令（保留完整信息以渲染选项）
     const toolsBySkill = {};
     for (const tool of skillCommands) {
       if (!tool || !tool.name) continue;
@@ -457,55 +515,43 @@ class SkillManagerPlugin extends Plugin {
       if (parts.length < 2) continue;
       const skillName = parts[0];
       const cmdName = parts.slice(1).join(':');
-      if (!toolsBySkill[skillName]) {
-        toolsBySkill[skillName] = [];
-      }
+      if (!toolsBySkill[skillName]) toolsBySkill[skillName] = [];
       toolsBySkill[skillName].push({ name: cmdName, description: tool.description || '', options: tool.options || null });
     }
 
+    // 一列一技能，命令含选项时显示参数
     for (const skill of skills) {
       const name = skill.metadata?.name || skill.name || 'unknown';
       const descText = skill.metadata?.description || '';
+      if (!descText && !toolsBySkill[name]) continue;
 
-      lines.push(`### ${name}`);
-      lines.push(`**描述**: ${descText}`);
+      const parts = [];
+      if (descText) parts.push(descText);
 
-      // 如果该技能有命令，添加调用方式
       if (toolsBySkill[name]) {
-        lines.push('');
-        lines.push('**调用方式:**');
-        lines.push('```');
-        lines.push(`ext_call({`);
-        lines.push(`  plugin: "skill",`);
-        lines.push(`  tool: "${name}:<命令名>",`);
-        lines.push(`  args: { command: "<命令行>" }`);
-        lines.push(`})`);
-        lines.push('```');
-        lines.push('');
-        lines.push('**可用命令:**');
-        for (const c of toolsBySkill[name]) {
-          lines.push(`- \`${c.name}\`: ${c.description}`);
-          // 如果有 options，显示参数格式
-          if (c.options && c.options.length > 0) {
-            const optStr = c.options.map(o => {
-              const flag = o.flags?.split(' ')[0] || o.flags || '';
-              const def = o.defaultValue !== undefined ? ` (默认: ${JSON.stringify(o.defaultValue)})` : '';
-              return `${flag}${def}`;
-            }).join(' ');
-            lines.push(`  - 选项: ${optStr}`);
+        const cmdStrs = toolsBySkill[name].map(cmd => {
+          if (cmd.options && cmd.options.length > 0) {
+            const optStrs = cmd.options.map(o => {
+              // 提取长选项名（--xxx）作为参数名，形如 "--tokens <值>"
+              const flag = o.flags || '';
+              const longOpt = flag.split(/\s+/).filter(f => f.startsWith('--'))[0];
+              const valPart = flag.includes('<') ? flag.match(/<[^>]+>/)?.[0] || '' : '';
+              if (longOpt && valPart) return `${longOpt} ${valPart}`;
+              if (longOpt) return longOpt;
+              return flag.split(/\s+/).filter(f => f && !f.includes('<')).map(f => f.replace(/,$/, ''))[0] || flag;
+            });
+            return `${cmd.name}(${optStrs.join(', ')})`;
           }
-        }
-        lines.push('');
-        lines.push('**示例:**');
-        for (const c of toolsBySkill[name]) {
-          lines.push(`- 调用 \`ext_call({ plugin: "skill", tool: "${name}:${c.name}", args: { command: "<命令行>" } })\``);
-        }
+          return cmd.name;
+        });
+        parts.push(`命令: ${cmdStrs.join(', ')}`);
       }
-      lines.push('');
+      lines.push(`- **${name}**: ${parts.join(' | ')}`);
     }
 
     lines.push(
-      '> **重要提示**：当需要开发插件、执行专业任务时，必须先使用 `loadSkill` 工具加载对应技能，获取专业指导。'
+      '',
+      '> **提示**：使用 `skill_load("${skill名}")` 加载技能获取详细使用指南。'
     );
 
     return lines.join('\n');
@@ -514,7 +560,7 @@ class SkillManagerPlugin extends Plugin {
   /**
    * 加载所有 skills
    */
-  _loadAllSkills() {
+  async _loadAllSkills() {
     if (this._loaded) return;
 
     let totalLoaded = 0;
@@ -554,7 +600,7 @@ class SkillManagerPlugin extends Plugin {
             if (!isValidSkillName(entry.name)) continue;
             if (this._skills.has(entry.name)) continue;
             try {
-              this._loadSkill(entry.name, skillPath);
+              await this._loadSkill(entry.name, skillPath);
               totalLoaded++;
             } catch (err) {
               log.error(` Failed to load skill '${entry.name}':`, err.message);
@@ -744,7 +790,7 @@ class SkillManagerPlugin extends Plugin {
   /**
    * 加载单个 skill
    */
-  _loadSkill(name, skillPath) {
+  async _loadSkill(name, skillPath) {
     // 查找 markdown 文件，优先加载 SKILL.md 或 AGENTS.md（支持多层嵌套）
     const skillMdPath = this._findSkillMarkdown(skillPath);
     if (!skillMdPath) {
@@ -771,7 +817,7 @@ class SkillManagerPlugin extends Plugin {
     const skill = new Skill(metadata, stripFrontmatter(content));
     skill._skillPath = skillPath; // 保存路径用于加载 index.js
     skill.install(this._framework);
-    skill.registerCommands(); // 注册 skill 的命令
+    await skill.registerCommands(); // 异步注册（支持 ESM 包）
 
     // 将 skill 的命令添加到 SkillManagerPlugin.tools，供 extension-executor 扫描
     Object.assign(this.tools, skill.tools);
@@ -782,8 +828,9 @@ class SkillManagerPlugin extends Plugin {
     // 扫描 scripts 子目录（可执行脚本）
     const scripts = this._scanScripts(skillPath);
 
-    this._skills.set(name, {
-      name,
+    const skillName = metadata.name || name;
+    this._skills.set(skillName, {
+      name: skillName,
       metadata,
       content: skill.content,
       instance: skill,
@@ -966,7 +1013,7 @@ class SkillManagerPlugin extends Plugin {
     return this._skills.size;
   }
 
-  reload(framework) {
+  async reload(framework) {
     this._skills.clear();
     this.tools = {};
     this._loaded = false;
@@ -978,7 +1025,7 @@ class SkillManagerPlugin extends Plugin {
       extExecutor._extensions.delete('skill');
     }
 
-    this._loadAllSkills();
+    await this._loadAllSkills();
 
     // 通知 UI 刷新 skill 命令（用于 autocomplete 热重载）
     framework.emit('skill:reloaded', { skills: Array.from(this._skills.keys()) });

package/plugins/core/sub-agent/index.js

@@ -24,6 +24,7 @@ class SubAgentPlugin extends Plugin {
     this.tools = config.tools || {}
     this.parentTools = config.parentTools || []
     this.llmConfig = config.llmConfig || null
+    this.hidden = config.hidden || false  // 隐藏子Agent，不在指令系统中显示
 
     this.config = {}
 
@@ -83,7 +84,8 @@ class SubAgentPlugin extends Plugin {
       apiKey: llmConfig.apiKey,
       baseURL: llmConfig.baseURL,
       tools:{},
-      parentTools: all_tools
+      parentTools: all_tools,
+      hidden: this.hidden
     })
 
     this._parentAgent = parentAgent
@@ -155,7 +157,7 @@ class SubAgentPlugin extends Plugin {
 - 处理本职外的任务
 - 代替其他子Agent执行操作
 - 在回复中透露你的内部实现细节
-- 不先调用 ext_skill/loadSkill 就直接使用 ext_call`
+- 不先调用 ext_skill/skill_load 就直接使用 ext_call`
   }
 
   _registerDelegateTool() {
@@ -300,6 +302,18 @@ class SubAgentPlugin extends Plugin {
 }
 
 class SubAgentManagerPlugin extends Plugin {
+  // 声明式 prompt parts
+  prompts = [
+    {
+      name: 'subagents',
+      slot: 'CAPABILITY',
+      description: '子Agent描述与分配规则',
+      provider: function () {
+        return this._buildDescription();
+      },
+    },
+  ];
+
   constructor(config = {}) {
     super()
     this.name = 'subagent-manager'
@@ -324,6 +338,7 @@ class SubAgentManagerPlugin extends Plugin {
   }
 
   start(framework) {
+    super.start(framework);
     this._loadAgentsFromDir()
 
     for (const agentConfig of this.agents) {
@@ -344,7 +359,7 @@ class SubAgentManagerPlugin extends Plugin {
       }
     })
 
-    this.registerPromptPart('subagents', 85, () => this._buildDescription());
+    // prompt part 由基类 _autoRegisterPrompts 自动处理
 
     return this
   }
@@ -355,12 +370,14 @@ class SubAgentManagerPlugin extends Plugin {
       description: '列出所有子Agent',
       inputSchema: z.object({}),
       execute: async () => {
-        const agents = Array.from(this._subAgents.values()).map(p => ({
-          name: p.name,
-          role: p.role,
-          description: p.description,
-          toolCount: p._agent ? p._agent.getTools().length : 0
-        }))
+        const agents = Array.from(this._subAgents.values())
+          .filter(p => !p.hidden)  // 过滤隐藏的子Agent
+          .map(p => ({
+            name: p.name,
+            role: p.role,
+            description: p.description,
+            toolCount: p._agent ? p._agent.getTools().length : 0
+          }))
         return { success: true, data: agents }
       }
     })
@@ -419,12 +436,14 @@ class SubAgentManagerPlugin extends Plugin {
       description: '列出所有子Agent',
       inputSchema: z.object({}),
       execute: async () => {
-        const agents = Array.from(this._subAgents.values()).map(p => ({
-          name: p.name,
-          role: p.role,
-          description: p.description,
-          toolCount: p._agent ? p._agent.getTools().length : 0
-        }))
+        const agents = Array.from(this._subAgents.values())
+          .filter(p => !p.hidden)  // 过滤隐藏的子Agent
+          .map(p => ({
+            name: p.name,
+            role: p.role,
+            description: p.description,
+            toolCount: p._agent ? p._agent.getTools().length : 0
+          }))
         return { success: true, data: agents }
       }
     })