foliko 1.0.23 → 1.0.26

package/.claude/settings.local.json

@@ -40,23 +40,30 @@
       "Bash(node -c plugins/telegram-plugin.js && echo \"Syntax OK\")",
       "WebSearch",
       "Bash(npm ls:*)",
-      "Bash(cd node_modules/@pinixai/weixin-bot && npm run build 2>&1)",
-      "Bash(cd node_modules/@pinixai/weixin-bot && npx tsc 2>&1)",
+      "Bash(cd node_modules/@chnak/weixin-bot && npm run build 2>&1)",
+      "Bash(cd node_modules/@chnak/weixin-bot && npx tsc 2>&1)",
       "Bash(npm install:*)",
-      "Bash(cd node_modules/@pinixai/weixin-bot && npx typescript --version && npx tsc 2>&1)",
+      "Bash(cd node_modules/@chnak/weixin-bot && npx typescript --version && npx tsc 2>&1)",
       "Bash(npx tsc:*)",
       "Bash(node --check /d/Code/vb-agent/plugins/weixin-plugin.js 2>&1)",
       "Bash(node --check /d/Code/vb-agent/plugins/telegram-plugin.js && node --check /d/Code/vb-agent/plugins/weixin-plugin.js && echo \"OK\")",
       "Bash(node --check /d/Code/vb-agent/cli/src/ui/chat-ui.js && echo \"OK\")",
       "Bash(npm uninstall:*)",
       "Bash(rm -rf /tmp/weixin-bot && git clone https://github.com/chnak/weixin-bot.git /tmp/weixin-bot 2>&1)",
-      "Bash(mkdir -p node_modules/@pinixai/weixin-bot && cp -r /tmp/weixin-bot/nodejs/* node_modules/@pinixai/weixin-bot/ && cd node_modules/@pinixai/weixin-bot && npm install 2>&1)",
+      "Bash(mkdir -p node_modules/@chnak/weixin-bot && cp -r /tmp/weixin-bot/nodejs/* node_modules/@chnak/weixin-bot/ && cd node_modules/@chnak/weixin-bot && npm install 2>&1)",
       "Bash(node --check /d/Code/vb-agent/plugins/weixin-plugin.js && echo \"OK\")",
-      "Bash(node -e \"import\\('@pinixai/weixin-bot'\\).then\\(m => console.log\\('OK:', Object.keys\\(m\\)\\)\\).catch\\(e => console.error\\('Error:', e.message\\)\\)\")",
+      "Bash(node -e \"import\\('@chnak/weixin-bot'\\).then\\(m => console.log\\('OK:', Object.keys\\(m\\)\\)\\).catch\\(e => console.error\\('Error:', e.message\\)\\)\")",
       "Bash(npm run:*)",
-      "Bash(node -e \"const { WeixinBot } = require\\('@pinixai/weixin-bot'\\); console.log\\(typeof WeixinBot\\)\" 2>&1)",
-      "Bash(node -e \"import\\('@pinixai/weixin-bot'\\).then\\(m => console.log\\('OK:', typeof m.WeixinBot\\)\\).catch\\(e => console.error\\('Error:', e.message\\)\\)\" 2>&1)",
-      "Bash(ls -la D:/code/vb-agent/cli/bin/ && cat D:/code/vb-agent/cli/bin/*.js 2>/dev/null | head -50)"
+      "Bash(node -e \"const { WeixinBot } = require\\('@chnak/weixin-bot'\\); console.log\\(typeof WeixinBot\\)\" 2>&1)",
+      "Bash(node -e \"import\\('@chnak/weixin-bot'\\).then\\(m => console.log\\('OK:', typeof m.WeixinBot\\)\\).catch\\(e => console.error\\('Error:', e.message\\)\\)\" 2>&1)",
+      "Bash(ls -la D:/code/vb-agent/cli/bin/ && cat D:/code/vb-agent/cli/bin/*.js 2>/dev/null | head -50)",
+      "Bash(npm config:*)",
+      "Bash(node -c plugins/subagent-plugin.js 2>&1)",
+      "Bash(node -c plugins/default-plugins.js 2>&1)",
+      "Bash(node -c plugins/default-plugins.js && node -c src/core/plugin-manager.js && node -c plugins/tools-plugin.js 2>&1)",
+      "Bash(node -c src/core/plugin-base.js && node -c src/core/plugin-manager.js 2>&1)",
+      "Bash(node -c plugins/telegram-plugin.js && node -c plugins/weixin-plugin.js 2>&1)",
+      "Bash(node -c src/core/plugin-manager.js 2>&1)"
     ]
   }
 }

package/README.md

@@ -11,15 +11,42 @@
 - **技能系统** - 可扩展的 Skill 管理
 - **会话管理** - 支持多会话切换
 - **规则引擎** - 可配置的行为规则
+- **子 Agent** - 支持多子 Agent 分工协作
+
+## 安装
+
+```bash
+# 方式一：npm 安装
+npm install -g foliko
+
+# 方式二：Windows 一键脚本安装
+irm https://folikoai.com/install.ps1 | iex
+
+# 方式三：Mac/Linux 一键脚本安装
+curl -fsSL https://folikoai.com/install.sh | bash
+```
 
 ## 快速开始
 
 ```bash
-# 安装
-npm install
+# 全局安装后
+foliko chat
+```
+
+## CLI 命令
+
+```bash
+# 聊天模式（使用 .env 中的配置）
+foliko chat
+
+# 指定完整配置
+foliko chat --provider deepseek --model deepseek-chat --base-url https://api.deepseek.com/v1 --api-key sk-xxx
+
+# 只指定 provider（使用 provider 默认 model 和 baseURL）
+foliko chat --provider deepseek --api-key sk-xxx
 
-# 启动聊天
-npm run chat
+# 列出所有子Agent配置
+foliko list
 ```
 
 ## 项目结构
@@ -30,7 +57,7 @@ foliko/
 │   └── bin/foliko.js    # CLI 入口
 ├── src/                 # 核心框架
 │   ├── core/            # 核心组件
-│   ├── capabilities/    # 能力插件
+│   ├── capabilities/     # 能力插件
 │   └── executors/       # 执行器
 ├── plugins/             # 内置插件
 ├── skills/              # 技能目录
@@ -50,19 +77,19 @@ FOLIKO_PROVIDER=minimax
 # AI Model（可选，不填则使用 provider 默认值）
 # MiniMax: MiniMax-M2.7
 # DeepSeek: deepseek-chat, deepseek-coder 等
-FOLIKO_MODEL=
+FOLIKO_MODEL=MiniMax-M2.7
 
 # API Base URL（可选，不填则使用 provider 默认值）
 # MiniMax: https://api.minimaxi.com/v1
 # DeepSeek: https://api.deepseek.com/v1
-FOLIKO_BASE_URL=
+FOLIKO_BASE_URL=https://api.minimaxi.com/v1
 
 # API Key（通用，不填则使用 provider 专用 key）
-FOLIKO_API_KEY=
+FOLIKO_API_KEY=sk-your-minimax-api-key
 
 # Provider 专用 API Key（可选）
-DEEPSEEK_API_KEY=sk-your-deepseek-api-key
-MINIMAX_API_KEY=sk-your-minimax-api-key
+# DEEPSEEK_API_KEY=sk-your-deepseek-api-key
+# MINIMAX_API_KEY=sk-your-minimax-api-key
 ```
 
 **配置优先级**：命令行参数 > .env配置 > provider默认值
@@ -74,11 +101,49 @@ MINIMAX_API_KEY=sk-your-minimax-api-key
 ├── config              # 配置文件
 ├── ai.json            # AI 配置
 ├── mcp_config.json    # MCP 服务器配置
+├── agents/            # 子Agent配置目录
 ├── plugins/           # 用户插件目录
 ├── skills/            # 用户技能目录
 └── data/              # 数据目录
 ```
 
+### 子 Agent 配置 (.agent/agents/)
+
+在 `.agent/agents/` 目录下放置子 Agent 配置文件，支持 `.js`、`.json`、`.md` 格式：
+
+```
+.agent/agents/
+├── backend-specialist.md
+├── frontend-specialist.md
+└── database-architect.md
+```
+
+#### JSON 格式
+
+```json
+{
+  "name": "backend-specialist",
+  "role": "Backend Specialist",
+  "description": "Expert in backend development",
+  "parentTools": ["read_file", "run_command"]
+}
+```
+
+#### Markdown 格式
+
+```markdown
+# Backend Specialist
+
+```json
+{
+  "name": "backend-specialist",
+  "role": "Backend Specialist",
+  "description": "Expert in backend development",
+  "parentTools": ["read_file", "run_command"]
+}
+```
+```
+
 ### ai.json 格式
 
 ```json
@@ -191,37 +256,57 @@ allowed-tools: tool1,tool2
 技能内容...
 ```
 
-## CLI 命令
-
-```bash
-# 聊天模式（使用 .env 中的配置）
-npm run chat
-
-# 指定完整配置
-foliko chat --provider deepseek --model deepseek-chat --base-url https://api.deepseek.com/v1 --api-key sk-xxx
-
-# 只指定 provider（使用 provider 默认 model 和 baseURL）
-foliko chat --provider deepseek --api-key sk-xxx
-
-# 只指定 api-key（使用 FOLIKO_PROVIDER 设定的 provider）
-foliko chat --api-key sk-xxx
-```
-
 ## 内置工具
 
+### 通用工具
+
 | 工具 | 说明 |
 |------|------|
 | `loadSkill` | 加载技能 |
-| `mcp_execute` | 执行 MCP 工具 |
-| `shell_execute` | 执行 Shell 命令 |
-| `python_execute` | 执行 Python 代码 |
+| `list_plugins` | 列出所有插件 |
+| `list_tools` | 列出所有工具 |
+| `reload_plugins` | 重载插件 |
+| `shell` | 执行 Shell 命令 |
+| `powershell` | 执行 PowerShell 命令 |
+| `python-execute` | 执行 Python 代码 |
+| `python_script` | 执行 Python 脚本 |
+| `pip_install` | 安装 Python 包 |
 | `install` | 安装 npm 包 |
 | `mcp_reload` | 重载 MCP 服务器 |
 | `audit_query` | 查询审计日志 |
 
+### 子 Agent 管理工具
+
+| 工具 | 说明 |
+|------|------|
+| `subagent_list` | 列出所有子Agent |
+| `subagent_call` | 调用指定的子Agent处理任务 |
+| `subagent_reload` | 重新加载子Agent配置 |
+
+### 会话工具
+
+| 工具 | 说明 |
+|------|------|
+| `session_create` | 创建会话 |
+| `session_get` | 获取会话 |
+| `session_list` | 列出所有会话 |
+| `session_delete` | 删除会话 |
+| `session_history` | 获取会话历史 |
+
+### 定时任务工具
+
+| 工具 | 说明 |
+|------|------|
+| `schedule_task` | 创建定时任务 |
+| `schedule_list` | 列出定时任务 |
+| `schedule_cancel` | 取消定时任务 |
+| `cron_examples` | 显示 cron 示例 |
+
 ## 工作目录
 
 CLI 工作目录默认使用执行命令的目录。
+- `.agent/` 目录会创建在工作目录下
+- 配置文件、插件、技能等都放在工作目录的 `.agent/` 下
 
 ## 许可证
 

package/cli/src/commands/chat.js

@@ -37,11 +37,19 @@ function getEnvConfig() {
   const provider = process.env.FOLIKO_PROVIDER || DEFAULT_CONFIG.provider
   const providerDefaults = PROVIDER_DEFAULTS[provider] || PROVIDER_DEFAULTS.minimax
 
+  // 支持多种 API key 环境变量名
+  let apiKey = process.env.FOLIKO_API_KEY || null
+  if (!apiKey) {
+    // 根据 provider 查找对应的 API key
+    const upperProvider = provider.toUpperCase().replace(/-/g, '_')
+    apiKey = process.env[`${upperProvider}_API_KEY`] || null
+  }
+
   return {
     model: process.env.FOLIKO_MODEL || providerDefaults.model,
     provider: provider,
     baseURL: process.env.FOLIKO_BASE_URL || providerDefaults.baseURL,
-    apiKey: process.env.FOLIKO_API_KEY || null
+    apiKey: apiKey
   }
 }
 
@@ -73,8 +81,8 @@ function parseArgs(args) {
  * Chat 命令入口
  */
 async function chatCommand(args) {
-  const options = parseArgs(args)
 
+  const options = parseArgs(args)
   console.log('=== Foliko 持续对话 ===\n')
   console.log('输入 exit 或 quit 退出\n')
 

package/cli/src/commands/list.js

@@ -0,0 +1,90 @@
+/**
+ * List 命令实现
+ * 列出所有子Agent配置
+ */
+
+const fs = require('fs')
+const path = require('path')
+
+/**
+ * 列出 .agent/agents 目录下的所有 Agent 配置
+ */
+async function listCommand() {
+  const agentsDir = path.resolve(process.cwd(), '.agent', 'agents')
+
+  if (!fs.existsSync(agentsDir)) {
+    console.log('No .agent/agents directory found.')
+    console.log('Create agents by adding files to: .agent/agents/')
+    return
+  }
+
+  const entries = fs.readdirSync(agentsDir, { withFileTypes: true })
+  const agents = []
+
+  for (const entry of entries) {
+    if (entry.isFile() && (entry.name.endsWith('.js') || entry.name.endsWith('.json') || entry.name.endsWith('.md'))) {
+      const baseName = entry.name.replace(/\.(js|json|md)$/, '')
+      const filePath = path.join(agentsDir, entry.name)
+
+      try {
+        let config = { name: baseName }
+
+        if (entry.name.endsWith('.json')) {
+          const content = fs.readFileSync(filePath, 'utf-8')
+          config = { ...config, ...JSON.parse(content) }
+        } else if (entry.name.endsWith('.md')) {
+          // 尝试从 markdown 中提取配置
+          const content = fs.readFileSync(filePath, 'utf-8')
+          const jsonMatch = content.match(/```json\n([\s\S]*?)\n```/)
+          if (jsonMatch) {
+            config = { ...config, ...JSON.parse(jsonMatch[1]) }
+          }
+          // 提取 name 行
+          const nameMatch = content.match(/^name:\s*(.+)$/m)
+          if (nameMatch) {
+            config.name = nameMatch[1].trim()
+          }
+        } else {
+          // .js 文件，尝试加载
+          delete require.cache[require.resolve(filePath)]
+          const mod = require(filePath)
+          config = typeof mod === 'function' ? mod() : mod
+        }
+
+        agents.push({
+          name: config.name || baseName,
+          role: config.role || '-',
+          description: config.description || '-',
+          file: entry.name
+        })
+      } catch (err) {
+        agents.push({
+          name: baseName,
+          role: '-',
+          description: `Error loading: ${err.message}`,
+          file: entry.name
+        })
+      }
+    }
+  }
+
+  if (agents.length === 0) {
+    console.log('No agents found in .agent/agents/')
+    return
+  }
+
+  console.log(`\nFound ${agents.length} agent(s) in .agent/agents/:\n`)
+  console.log('Name              Role                Description')
+  console.log('----------------  ------------------  ------------------------------------------')
+
+  for (const agent of agents) {
+    const name = (agent.name || '').padEnd(16).slice(0, 16)
+    const role = (agent.role || '-').padEnd(18).slice(0, 18)
+    const desc = (agent.description || '-').slice(0, 40)
+    console.log(`${name}  ${role}  ${desc}`)
+  }
+
+  console.log('')
+}
+
+module.exports = { listCommand }

package/cli/src/index.js

@@ -3,6 +3,7 @@
  */
 
 const { chatCommand } = require('./commands/chat')
+const { listCommand } = require('./commands/list')
 
 /**
  * CLI 主入口
@@ -16,6 +17,11 @@ async function cli() {
       await chatCommand(args.slice(1))
       break
 
+    case 'list':
+    case 'ls':
+      await listCommand()
+      break
+
     case 'help':
     case '--help':
     case '-h':
@@ -46,6 +52,7 @@ Usage: foliko <command> [options]
 
 Commands:
   chat              启动持续对话聊天
+  list              列出所有子Agent配置
   help              显示帮助信息
   version           显示版本号
 
@@ -58,6 +65,7 @@ Examples:
   foliko chat
   foliko chat --model MiniMax-M2.7
   foliko chat --provider minimax --base-url https://api.minimaxi.com/v1
+  foliko list
 `)
 }
 

package/install.ps1

@@ -97,13 +97,33 @@ Write-Host "Cleaning npm cache..." -ForegroundColor Cyan
 npm cache clean --force 2>$null | Out-Null
 
 Write-Host "Installing Foliko..." -ForegroundColor Cyan
-npm install -g foliko --ignore-scripts
+npm install -g foliko --ignore-scripts 2>&1 | Out-Null
 
-if (Get-Command foliko -ErrorAction SilentlyContinue) {
+# Get npm global bin path
+$npmPrefix = npm config get prefix 2>$null
+$npmBinPath = $npmPrefix -replace "\\$", ""
+
+# Add to PATH permanently for current user
+$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
+if ($userPath -notlike "*$npmBinPath*") {
+    [Environment]::SetEnvironmentVariable("Path", "$userPath;$npmBinPath", "User")
+}
+
+# Also add to current session PATH
+$env:Path = "$npmBinPath;$env:Path"
+Start-Sleep -Seconds 2
+
+# Check if installation succeeded
+if (Test-Path "$npmBinPath\foliko.cmd") {
     Write-Host ""
     Write-Host "Installation complete!" -ForegroundColor Green
-    Write-Host "Run: foliko chat"
+    Write-Host ""
+    Write-Host "Please restart your terminal or run:" -ForegroundColor Cyan
+    Write-Host '  $env:Path = "C:\Users\Administrator\AppData\Roaming\npm;' + '$env:Path"' -ForegroundColor White
+    Write-Host ""
+    Write-Host "Then run: foliko chat" -ForegroundColor Yellow
 } else {
     Write-Host ""
-    Write-Host "Installation failed. Try manually: npm install -g foliko" -ForegroundColor Yellow
+    Write-Host "Installation may have failed." -ForegroundColor Yellow
+    Write-Host "Run: npm install -g foliko"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.23",
+  "version": "1.0.26",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {
@@ -25,8 +25,8 @@
     "@ai-sdk/openai": "^3.0.41",
     "@ai-sdk/openai-compatible": "^2.0.35",
     "@anthropic-ai/sdk": "^0.39.0",
-    "@modelcontextprotocol/sdk": "^1.27.1",
     "@chnak/weixin-bot": "^1.2.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "ai": "^6.0.116",
     "dotenv": "^17.3.1",
     "imap": "^0.8.19",

package/plugins/ai-plugin.js

@@ -38,6 +38,7 @@ class AIPlugin extends Plugin {
   }
 
   _initAIClient() {
+
     if (!this.config.apiKey) {
       console.warn('[AIPlugin] No API key provided, AI features disabled')
       return

package/plugins/default-plugins.js

@@ -17,7 +17,8 @@ function loadAgentConfig(agentDir = '.agent') {
     ai: {},
     mcpServers: {},
     plugins: [],
-    skillsDirs: []
+    skillsDirs: [],
+    agentsDir: null    // 子Agent配置目录
   }
 
   const resolvedDir = path.resolve(process.cwd(), agentDir)
@@ -29,6 +30,13 @@ function loadAgentConfig(agentDir = '.agent') {
 
   console.log(`[AgentConfig] Loading config from: ${resolvedDir}`)
 
+  // 添加 agents 目录（如果存在）
+  const agentsDir = path.join(resolvedDir, 'agents')
+  if (fs.existsSync(agentsDir)) {
+    config.agentsDir = agentsDir
+    console.log(`[AgentConfig] Found agents directory: ${agentsDir}`)
+  }
+
   // 加载 config 文件（key=value 格式）
   const configFile = path.join(resolvedDir, 'config')
   if (fs.existsSync(configFile)) {
@@ -242,10 +250,13 @@ async function bootstrapDefaults(framework, config = {}) {
     // 跳过或已禁用
   } else {
     const { AIPlugin } = require('./ai-plugin')
+    // 根据 provider 获取对应的 API key
+    const upperProvider = (aiConfig.provider || 'deepseek').toUpperCase().replace(/-/g, '_')
+    const envApiKey = process.env[`${upperProvider}_API_KEY`] || process.env.FOLIKO_API_KEY
     const aiPlugin = new AIPlugin({
       provider: aiConfig.provider || 'deepseek',
       model: aiConfig.model || 'deepseek-chat',
-      apiKey: aiConfig.apiKey || process.env.DEEPSEEK_API_KEY,
+      apiKey: aiConfig.apiKey || envApiKey,
       baseURL: aiConfig.baseURL
     })
     await framework.loadPlugin(aiPlugin)
@@ -382,19 +393,18 @@ async function bootstrapDefaults(framework, config = {}) {
     console.log('[Bootstrap] Python Plugin Loader loaded')
   }
 
-  // 12.6 Telegram 插件（如果配置了Token）
+  // 12.6 Telegram 插件（默认禁用，需要在 plugins.json 中设置 enabled: true）
   if (shouldLoad('telegram')) {
-    const telegramToken = process.env.TELEGRAM_BOT_TOKEN || agentConfig.telegram?.botToken
-    if (telegramToken) {
-      const { Plugin } = require('../src/core/plugin-base')
-      const createTelegramPlugin = require('./telegram-plugin')
-      const TelegramPlugin = createTelegramPlugin(Plugin)
-      await framework.loadPlugin(new TelegramPlugin({ botToken: telegramToken }))
-      console.log('[Bootstrap] Telegram Plugin loaded')
+    const { Plugin } = require('../src/core/plugin-base')
+    const createTelegramPlugin = require('./telegram-plugin')
+    const TelegramPlugin = createTelegramPlugin(Plugin)
+    const telegramConfig = {
+      botToken: process.env.TELEGRAM_BOT_TOKEN || agentConfig.telegram?.botToken
     }
+    await framework.loadPlugin(new TelegramPlugin(telegramConfig))
   }
 
-  // 12.7 WeChat 插件（始终加载，由配置控制是否扫码）
+  // 12.7 WeChat 插件（默认禁用，需要在 plugins.json 中设置 enabled: true）
   if (shouldLoad('weixin')) {
     try {
       const { Plugin } = require('../src/core/plugin-base')
@@ -406,7 +416,6 @@ async function bootstrapDefaults(framework, config = {}) {
         allowedUsers: agentConfig.weixin?.allowedUsers || []
       }
       await framework.loadPlugin(new WeixinPlugin(weixinConfig))
-      console.log('[Bootstrap] WeChat Plugin loaded')
     } catch (err) {
       console.warn('[Bootstrap] WeChat Plugin not available:', err.message)
     }

package/plugins/subagent-plugin.js

@@ -3,6 +3,8 @@
  * 创建具有独立工具集的子Agent，用于分工处理不同领域的任务
  */
 
+const fs = require('fs')
+const path = require('path')
 const { Plugin } = require('../src/core/plugin-base')
 const { z } = require('zod')
 const { Agent } = require('../src/core/agent')
@@ -38,7 +40,7 @@ class SubAgentPlugin extends Plugin {
   }
 
   start(framework) {
-    // 创建子Agent
+    // 创建子Agent（可能需要等待父agent准备好）
     this._createSubAgent()
 
     // 注册委托工具到主Agent（通过framework获取父agent）
@@ -54,7 +56,30 @@ class SubAgentPlugin extends Plugin {
     // 获取父Agent（主Agent）
     const parentAgent = this._getParentAgent()
     if (!parentAgent) {
-      console.warn(`[SubAgent:${this.config.name}] Parent agent not found`)
+      // 父agent还没创建，监听事件等其创建
+      if (this._framework) {
+        const framework = this._framework
+        framework.on('agent:created', (agent) => {
+          if (framework._mainAgent && agent === framework._mainAgent) {
+            // 父agent已创建，重新尝试创建子agent
+            this._doCreateSubAgent(agent)
+            // 注册委托工具
+            this._registerDelegateTool()
+          }
+        })
+      }
+      return
+    }
+
+    this._doCreateSubAgent(parentAgent)
+  }
+
+  /**
+   * 实际执行创建子Agent
+   */
+  _doCreateSubAgent(parentAgent) {
+    // 避免重复创建
+    if (this._agent) {
       return
     }
 
@@ -184,27 +209,32 @@ class SubAgentPlugin extends Plugin {
   }
 
   /**
-   * 注册委托工具到父Agent
+   * 注册委托工具到框架（会被同步到主Agent）
    */
   _registerDelegateTool() {
-    const parentAgent = this._getParentAgent()
-    if (!parentAgent) return
+    const framework = this._framework
+    if (!framework) return
 
     const agentName = this.config.name
     const role = this.config.role
 
-    // 注册工具到父Agent
-    parentAgent.registerTool({
+    // 注册工具到框架工具注册表
+    framework.registerTool({
       name: agentName,
       description: `${role}：当需要${role}时，调用此工具执行任务。如：编译代码、运行测试、代码重构等。`,
       inputSchema: z.object({
         task: z.string().describe('给子Agent的具体任务描述')
       }),
-      execute: async (args, framework) => {
+      execute: async (args, fw) => {
         if (!this._agent) {
           return { error: `SubAgent ${agentName} not initialized` }
         }
 
+        const parentAgent = fw._mainAgent
+        if (!parentAgent) {
+          return { error: `Parent agent not found` }
+        }
+
         // 发射子Agent开始处理事件
         parentAgent.emit('subagent:chat:start', {
           parentAgent,
@@ -294,11 +324,14 @@ class SubAgentManagerPlugin extends Plugin {
     this.priority = 10
 
     this.config = {
-      agents: config.agents || []  // 子Agent配置列表
+      agentsDir: config.agentsDir || null,  // 子Agent配置目录
+      agents: config.agents || []            // 子Agent配置列表
     }
 
     this._framework = null
     this._subAgents = new Map()
+    this._fileWatcher = null
+    this._lastFileStates = new Map()  // 记录文件状态用于检测变化
   }
 
   install(framework) {
@@ -307,6 +340,9 @@ class SubAgentManagerPlugin extends Plugin {
   }
 
   start(framework) {
+    // 从 agentsDir 加载子Agent配置
+    this._loadAgentsFromDir()
+
     // 创建所有配置的子Agent
     for (const agentConfig of this.config.agents) {
       const plugin = new SubAgentPlugin(agentConfig)
@@ -315,7 +351,20 @@ class SubAgentManagerPlugin extends Plugin {
       this._subAgents.set(agentConfig.name, plugin)
     }
 
-    // 注册管理工具
+    // 注册管理工具到框架工具注册表
+    // 这样当 agent 创建时会通过 _syncTools() 自动同步过来
+    this._registerTools(framework)
+
+    // 启动文件监控
+    this._startFileWatcher()
+
+    return this
+  }
+
+  /**
+   * 注册管理工具到框架工具注册表
+   */
+  _registerTools(framework) {
     framework.registerTool({
       name: 'subagent_list',
       description: '列出所有子Agent',
@@ -358,7 +407,251 @@ class SubAgentManagerPlugin extends Plugin {
       }
     })
 
-    return this
+    framework.registerTool({
+      name: 'subagent_reload',
+      description: '重新加载子Agent配置（当新增或删除.agent/agents下的文件后使用）',
+      inputSchema: z.object({}),
+      execute: async () => {
+        try {
+          this.reload(this._framework)
+          return { success: true, message: '子Agent配置已重新加载' }
+        } catch (err) {
+          return { success: false, error: err.message }
+        }
+      }
+    })
+
+    console.log('[SubAgentManager] Management tools registered to framework')
+  }
+
+  /**
+   * 从 agentsDir 目录加载子Agent配置
+   */
+  _loadAgentsFromDir() {
+    const agentsDir = this.config.agentsDir
+    console.log('[SubAgentManager] _loadAgentsFromDir called, agentsDir:', agentsDir)
+    if (!agentsDir || !fs.existsSync(agentsDir)) {
+      console.log('[SubAgentManager] agentsDir not found or does not exist')
+      return
+    }
+
+    const entries = fs.readdirSync(agentsDir, { withFileTypes: true })
+    console.log('[SubAgentManager] Found entries:', entries.length)
+
+    for (const entry of entries) {
+      if (entry.isFile() && (entry.name.endsWith('.js') || entry.name.endsWith('.json') || entry.name.endsWith('.md'))) {
+        const baseName = entry.name.replace(/\.(js|json|md)$/, '')
+        const filePath = path.join(agentsDir, entry.name)
+
+        // 跳过与已有配置同名的
+        if (this.config.agents.some(a => a.name === baseName)) {
+          continue
+        }
+
+        try {
+          let agentConfig
+          if (entry.name.endsWith('.json')) {
+            const content = fs.readFileSync(filePath, 'utf-8')
+            agentConfig = JSON.parse(content)
+          } else if (entry.name.endsWith('.md')) {
+            // 解析 markdown 文件，提取 JSON 配置
+            agentConfig = this._parseMarkdownConfig(filePath, baseName)
+            console.log('[SubAgentManager] Parsed md:', baseName, agentConfig)
+          } else {
+            // 清除缓存并加载
+            delete require.cache[require.resolve(filePath)]
+            const mod = require(filePath)
+            agentConfig = typeof mod === 'function' ? mod() : mod
+          }
+
+          if (agentConfig && agentConfig.name) {
+            agentConfig._fromDir = true
+            this.config.agents.push(agentConfig)
+            console.log('[SubAgentManager] Loaded agent:', agentConfig.name)
+          } else {
+            console.warn('[SubAgentManager] Agent config has no name:', baseName, agentConfig)
+          }
+        } catch (err) {
+          console.warn(`[SubAgentManager] Failed to load agent config from ${filePath}:`, err.message, err.stack)
+        }
+      }
+    }
+  }
+
+  /**
+   * 解析 markdown 文件中的配置
+   * 支持格式：
+   * ```json
+   * { "name": "xxx", "role": "xxx" }
+   * ```
+   * 或直接用 frontmatter 格式
+   */
+  _parseMarkdownConfig(filePath, defaultName) {
+    const content = fs.readFileSync(filePath, 'utf-8')
+    console.log('[SubAgentManager] _parseMarkdownConfig:', filePath)
+
+    // 尝试从 code block 中提取 JSON
+    const jsonMatch = content.match(/```(?:json)?\s*\n([\s\S]*?)\n\s*```/)
+    if (jsonMatch) {
+      try {
+        const config = JSON.parse(jsonMatch[1].trim())
+        console.log('[SubAgentManager] Found JSON in code block')
+        return config
+      } catch (err) {
+        // JSON 解析失败，继续
+      }
+    }
+
+    // 尝试从 frontmatter 格式中提取
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/)
+    if (frontmatterMatch) {
+      console.log('[SubAgentManager] Found frontmatter')
+      const frontmatterContent = frontmatterMatch[1]
+      const parsed = this._parseYamlLike(frontmatterContent)
+      if (parsed && parsed.name) {
+        console.log('[SubAgentManager] Parsed frontmatter:', parsed)
+        return { name: parsed.name || defaultName, ...parsed }
+      }
+    }
+
+    // 从 markdown 内容中提取配置（key: value 格式）
+    const config = { name: defaultName }
+    const yamlMatch = content.match(/^(name|role|description|parentTools|tools):\s*(.+)$/m)
+    if (yamlMatch) {
+      config[yamlMatch[1]] = yamlMatch[2].trim()
+    }
+
+    // 如果没有找到配置，使用文件名作为 name
+    return config
+  }
+
+  /**
+   * 解析类似 YAML 的配置
+   */
+  _parseYamlLike(content) {
+    const result = {}
+    const lines = content.split('\n')
+
+    for (const line of lines) {
+      const match = line.match(/^(\w+):\s*(.+)$/)
+      if (match) {
+        const key = match[1]
+        let value = match[2].trim()
+
+        // 处理数组格式 [a, b, c] 或 [a b c]
+        if (value.startsWith('[') && value.endsWith(']')) {
+          value = value.slice(1, -1).split(/[,\s]+/).filter(Boolean)
+        }
+
+        result[key] = value
+      }
+    }
+
+    return result
+  }
+
+  /**
+   * 启动文件监控
+   */
+  _startFileWatcher() {
+    const agentsDir = this.config.agentsDir
+    if (!agentsDir || !fs.existsSync(agentsDir)) {
+      return
+    }
+
+    // 记录初始文件状态
+    this._updateFileStates()
+
+    // 使用 fs.watch 监控目录变化
+    this._fileWatcher = fs.watch(agentsDir, { recursive: false }, (eventType, filename) => {
+      if (filename && (filename.endsWith('.js') || filename.endsWith('.json') || filename.endsWith('.md'))) {
+        console.log(`[SubAgentManager] Detected change in agents dir: ${eventType} - ${filename}`)
+
+        // 防抖：延迟处理，等文件操作完成
+        setTimeout(() => {
+          this._checkAndReload()
+        }, 500)
+      }
+    })
+
+    console.log(`[SubAgentManager] Watching agents dir for changes: ${agentsDir}`)
+  }
+
+  /**
+   * 更新文件状态
+   */
+  _updateFileStates() {
+    const agentsDir = this.config.agentsDir
+    if (!agentsDir || !fs.existsSync(agentsDir)) {
+      return
+    }
+
+    this._lastFileStates.clear()
+    const entries = fs.readdirSync(agentsDir, { withFileTypes: true })
+
+    for (const entry of entries) {
+      if (entry.isFile() && (entry.name.endsWith('.js') || entry.name.endsWith('.json') || entry.name.endsWith('.md'))) {
+        const filePath = path.join(agentsDir, entry.name)
+        try {
+          const stat = fs.statSync(filePath)
+          this._lastFileStates.set(entry.name, {
+            mtime: stat.mtime.getTime(),
+            size: stat.size
+          })
+        } catch (err) {
+          // 忽略
+        }
+      }
+    }
+  }
+
+  /**
+   * 检查并重载（如果有变化）
+   */
+  _checkAndReload() {
+    const agentsDir = this.config.agentsDir
+    if (!agentsDir || !fs.existsSync(agentsDir)) {
+      return
+    }
+
+    const currentStates = new Map()
+    const entries = fs.readdirSync(agentsDir, { withFileTypes: true })
+    let hasChanges = false
+
+    // 检查当前文件
+    for (const entry of entries) {
+      if (entry.isFile() && (entry.name.endsWith('.js') || entry.name.endsWith('.json') || entry.name.endsWith('.md'))) {
+        const filePath = path.join(agentsDir, entry.name)
+        try {
+          const stat = fs.statSync(filePath)
+          currentStates.set(entry.name, {
+            mtime: stat.mtime.getTime(),
+            size: stat.size
+          })
+
+          const lastState = this._lastFileStates.get(entry.name)
+          if (!lastState || lastState.mtime !== stat.mtime.getTime() || lastState.size !== stat.size) {
+            hasChanges = true
+          }
+        } catch (err) {
+          // 忽略
+        }
+      }
+    }
+
+    // 检查删除的文件
+    for (const [name] of this._lastFileStates) {
+      if (!currentStates.has(name)) {
+        hasChanges = true
+        break
+      }
+    }
+
+    if (hasChanges) {
+      console.log('[SubAgentManager] File changes detected, reloading...')
+      this._updateFileStates()
+      this.reload(this._framework)
+    }
   }
 
   /**
@@ -370,17 +663,32 @@ class SubAgentManagerPlugin extends Plugin {
   }
 
   reload(framework) {
+    // 停止文件监控
+    if (this._fileWatcher) {
+      this._fileWatcher.close()
+      this._fileWatcher = null
+    }
+
     // 销毁旧的子Agent
     for (const plugin of this._subAgents.values()) {
       plugin.uninstall(framework)
     }
     this._subAgents.clear()
 
+    // 清空从目录加载的配置，重新加载
+    this.config.agents = this.config.agents.filter(a => !a._fromDir)
+
     // 重新创建
     this.start(framework)
   }
 
   uninstall(framework) {
+    // 停止文件监控
+    if (this._fileWatcher) {
+      this._fileWatcher.close()
+      this._fileWatcher = null
+    }
+
     for (const plugin of this._subAgents.values()) {
       plugin.uninstall(framework)
     }

package/plugins/telegram-plugin.js

@@ -27,6 +27,8 @@ module.exports = function(Plugin) {
       this.version = '2.0.0'
       this.description = 'Telegram 对话插件，绑定主Agent进行持续对话'
       this.priority = 80
+      // 默认不启用，需要在 plugins.json 中设置 enabled: true
+      this.enabled = false
 
       this.config = {
         botToken: config.botToken || process.env.TELEGRAM_BOT_TOKEN,

package/plugins/tools-plugin.js

@@ -61,18 +61,20 @@ class ToolsPlugin extends Plugin {
       }
     })
 
-    // 列出已加载插件工具
+    // 列出所有插件工具（包括未加载的）
     framework.registerTool({
       name: 'list_plugins',
-      description: '列出所有已加载的插件',
+      description: '列出所有插件（包括未加载的）',
       inputSchema: z.object({}),
       execute: async () => {
-        const plugins = framework.pluginManager.getAll()
+        const plugins = framework.pluginManager.getAllKnown()
         return {
           success: true,
           plugins: plugins.map(p => ({
             name: p.name,
-            version: p.instance?.version
+            status: p.status,
+            enabled: p.enabled,
+            version: p.version
           }))
         }
       }

package/plugins/weixin-plugin.js

@@ -1,6 +1,6 @@
 /**
  * WeChat 插件
- * 使用 @pinixai/weixin-bot 实现微信对话
+ * 使用 @chnak/weixin-bot 实现微信对话
  *
  * 配置：
  * - forceLogin: 是否强制重新扫码登录
@@ -18,6 +18,8 @@ module.exports = function(Plugin) {
       this.version = '1.0.0'
       this.description = '微信对话插件，使用微信网页账号进行对话'
       this.priority = 80
+      // 默认不启用，需要在 plugins.json 中设置 enabled: true
+      this.enabled = false
 
       this.config = {
         forceLogin: config.forceLogin || process.env.WEIXIN_FORCE_LOGIN === 'true',
@@ -70,11 +72,11 @@ module.exports = function(Plugin) {
 
       let WeixinBot
       try {
-        const module = await import('@pinixai/weixin-bot')
+        const module = await import('@chnak/weixin-bot')
         WeixinBot = module.WeixinBot
       } catch (err) {
-        console.warn('[WeChat] Failed to load @pinixai/weixin-bot:', err.message)
-        console.warn('[WeChat] Make sure @pinixai/weixin-bot is installed: npm install @pinixai/weixin-bot qrcode-terminal')
+        console.warn('[WeChat] Failed to load @chnak/weixin-bot:', err.message)
+        console.warn('[WeChat] Make sure @chnak/weixin-bot is installed: npm install @chnak/weixin-bot qrcode-terminal')
         return
       }
 

package/src/core/plugin-base.js

@@ -35,6 +35,13 @@ class Plugin {
    */
   agents = []
 
+  /**
+   * 插件是否启用，默认为 true
+   * 设置为 false 时插件不会被加载，但在列表中仍可见
+   * @type {boolean}
+   */
+  enabled = true
+
   _framework = null
   _subAgents = []
 

package/src/core/plugin-manager.js

@@ -16,6 +16,7 @@ class PluginManager {
     this._plugins = new Map()
     this._loading = false
     this._stateFile = path.join(process.cwd(), '.agent', 'data', 'plugins-state.json')
+    this._knownPlugins = new Set()  // 已知插件列表（包括未加载的）
   }
 
   /**
@@ -89,10 +90,13 @@ class PluginManager {
       pluginInstance.config = { ...pluginInstance.config, ...savedConfig }
     }
 
+    // 使用保存的状态，否则使用插件实例的 enabled，默认 true
+    const finalEnabled = savedEnabled !== undefined ? savedEnabled : (pluginInstance.enabled !== undefined ? pluginInstance.enabled : true)
+
     this._plugins.set(pluginInstance.name, {
       instance: pluginInstance,
       status: 'registered',
-      enabled: savedEnabled !== undefined ? savedEnabled : true  // 使用保存的状态，默认启用
+      enabled: finalEnabled
     })
 
     this.framework.emit('plugin:registered', pluginInstance)
@@ -116,7 +120,7 @@ class PluginManager {
         pluginInstance = this._createFromObject(plugin)
       }
 
-      // 如果已注册，使用已注册的实例
+      // 如果已注册，使用已注册的实例和状态
       const existing = this._plugins.get(pluginInstance.name)
       if (existing) {
         pluginInstance = existing.instance
@@ -424,12 +428,59 @@ class PluginManager {
       .map(e => ({ name: e.instance.name, instance: e.instance }))
   }
 
+  /**
+   * 注册一个已知插件（但不加载）
+   * 用于显示所有可用插件列表
+   * @param {string} name - 插件名称
+   * @param {Object} info - 插件信息
+   */
+  registerKnownPlugin(name, info = {}) {
+    this._knownPlugins.add(name)
+    // 如果插件还没注册过，记录它的信息
+    if (!this._plugins.has(name)) {
+      this._plugins.set(name, {
+        instance: { name, ...info },
+        status: 'known',
+        enabled: info.enabled !== undefined ? info.enabled : false
+      })
+    }
+  }
+
+  /**
+   * 获取所有已知插件（包括未加载的）
+   * @returns {Array} 插件列表，包含 name, status, enabled
+   */
+  getAllKnown() {
+    const result = []
+    for (const name of this._knownPlugins) {
+      const entry = this._plugins.get(name)
+      result.push({
+        name,
+        status: entry?.status || 'unknown',
+        enabled: entry?.enabled || false,
+        version: entry?.instance?.version
+      })
+    }
+    // 也加入已加载但不在 knownPlugins 中的
+    for (const [name, entry] of this._plugins) {
+      if (!result.find(p => p.name === name)) {
+        result.push({
+          name,
+          status: entry.status,
+          enabled: entry.enabled,
+          version: entry.instance?.version
+        })
+      }
+    }
+    return result
+  }
+
   /**
    * 检查插件是否存在
    * @param {string} name - 插件名称
    */
   has(name) {
-    return this._plugins.has(name)
+    return this._plugins.has(name) || this._knownPlugins.has(name)
   }
 
   /**
@@ -464,8 +515,12 @@ class PluginManager {
     }
 
     entry.enabled = true
+    // 同步更新插件实例的 enabled 属性，避免 load() 时被跳过
+    if (entry.instance) {
+      entry.instance.enabled = true
+    }
 
-    // 如果插件已加载，尝试重新启动（reload 会调用 start）
+    // 如果插件已加载，尝试重新启动
     if (entry.status === 'loaded') {
       try {
         // 如果之前已经启动过，先调用 stop 停止旧实例
@@ -481,6 +536,13 @@ class PluginManager {
       } catch (err) {
         console.error(`[PluginManager] Enable/reload failed for '${name}':`, err.message)
       }
+    } else if (entry.status === 'registered' || entry.status === 'known') {
+      // 插件只注册过但未加载，现在加载它
+      try {
+        await this.load(entry.instance)
+      } catch (err) {
+        console.error(`[PluginManager] Enable/load failed for '${name}':`, err.message)
+      }
     }
 
     this.framework.emit('plugin:enabled', entry.instance)
@@ -504,6 +566,10 @@ class PluginManager {
     }
 
     entry.enabled = false
+    // 同步更新插件实例的 enabled 属性
+    if (entry.instance) {
+      entry.instance.enabled = false
+    }
 
     // 如果插件正在运行，停止它
     if (entry.instance._started) {