foliko 2.0.5 → 2.0.6

package/install.ps1

@@ -1,129 +1,129 @@
-# Foliko Installer
-
-# Fix execution policy first
-Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force -ErrorAction SilentlyContinue
-
-Write-Host "Foliko Installer"
-Write-Host "================="
-Write-Host ""
-
-# Refresh PATH
-$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
-
-# ============ Check/Install Node.js ============
-Write-Host "Checking Node.js..."
-if (Get-Command node -ErrorAction SilentlyContinue) {
-    Write-Host "Node.js installed: $(node --version)" -ForegroundColor Green
-} else {
-    Write-Host "Node.js not found, installing..." -ForegroundColor Yellow
-
-    $nodeUrl = "https://nodejs.org/dist/v20.11.0/node-v20.11.0-x64.msi"
-    $nodeInstaller = "$env:TEMP\node-installer.msi"
-
-    Write-Host "Downloading Node.js..." -ForegroundColor Cyan
-    Invoke-WebRequest -Uri $nodeUrl -OutFile $nodeInstaller -UseBasicParsing
-
-    Write-Host "Installing Node.js (may require admin)..." -ForegroundColor Cyan
-    Start-Process msiexec.exe -ArgumentList "/i", $nodeInstaller, "/quiet", "/norestart" -Wait
-
-    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
-    Start-Sleep -Seconds 3
-
-    if (Get-Command node -ErrorAction SilentlyContinue) {
-        Write-Host "Node.js installed: $(node --version)" -ForegroundColor Green
-        Remove-Item $nodeInstaller -Force -ErrorAction SilentlyContinue
-    } else {
-        Write-Host "Node.js installation failed" -ForegroundColor Red
-        Write-Host "Download manually: https://nodejs.org/" -ForegroundColor Yellow
-    }
-}
-Write-Host ""
-
-# ============ Check/Install Python ============
-Write-Host "Checking Python..."
-if (Get-Command python -ErrorAction SilentlyContinue) {
-    Write-Host "Python installed: $(python --version)" -ForegroundColor Green
-} else {
-    Write-Host "Python not found, installing..." -ForegroundColor Yellow
-
-    $pythonUrl = "https://www.python.org/ftp/python/3.12.1/python-3.12.1-amd64.exe"
-    $pythonInstaller = "$env:TEMP\python-installer.exe"
-
-    Write-Host "Downloading Python..." -ForegroundColor Cyan
-    Invoke-WebRequest -Uri $pythonUrl -OutFile $pythonInstaller -UseBasicParsing
-
-    Write-Host "Installing Python (may require admin)..." -ForegroundColor Cyan
-    Start-Process $pythonInstaller -ArgumentList "/quiet", "InstallAllUsers=1", "PrependPath=1", "Include_pip=1" -Wait
-
-    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
-    Start-Sleep -Seconds 3
-
-    if (Get-Command python -ErrorAction SilentlyContinue) {
-        Write-Host "Python installed: $(python --version)" -ForegroundColor Green
-        Remove-Item $pythonInstaller -Force -ErrorAction SilentlyContinue
-    } else {
-        Write-Host "Python installation failed" -ForegroundColor Red
-        Write-Host "Download manually: https://www.python.org/downloads/" -ForegroundColor Yellow
-    }
-}
-Write-Host ""
-
-# ============ Check/Install uv ============
-Write-Host "Checking uv..."
-if (Get-Command uv -ErrorAction SilentlyContinue) {
-    Write-Host "uv installed: $(uv --version)" -ForegroundColor Green
-} else {
-    Write-Host "uv not found, installing..." -ForegroundColor Yellow
-
-    try {
-        Write-Host "Downloading uv..." -ForegroundColor Cyan
-        Invoke-WebRequest -Uri "https://astral.sh/uv/install.ps1" -OutFile "$env:TEMP\install-uv.ps1" -UseBasicParsing
-        powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-uv.ps1" -Version "0.4.0" -PowerShell -Admin
-        Remove-Item "$env:TEMP\install-uv.ps1" -Force -ErrorAction SilentlyContinue
-
-        $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
-
-        if (Get-Command uv -ErrorAction SilentlyContinue) {
-            Write-Host "uv installed: $(uv --version)" -ForegroundColor Green
-        }
-    } catch {
-        Write-Host "uv installation failed (optional, can be skipped)" -ForegroundColor Yellow
-    }
-}
-Write-Host ""
-
-# ============ Clean npm cache and install Foliko ============
-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 2>&1 | Out-Null
-
-# 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 ""
-    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 may have failed." -ForegroundColor Yellow
-    Write-Host "Run: npm install -g foliko"
-}
+# Foliko Installer
+
+# Fix execution policy first
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force -ErrorAction SilentlyContinue
+
+Write-Host "Foliko Installer"
+Write-Host "================="
+Write-Host ""
+
+# Refresh PATH
+$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+
+# ============ Check/Install Node.js ============
+Write-Host "Checking Node.js..."
+if (Get-Command node -ErrorAction SilentlyContinue) {
+    Write-Host "Node.js installed: $(node --version)" -ForegroundColor Green
+} else {
+    Write-Host "Node.js not found, installing..." -ForegroundColor Yellow
+
+    $nodeUrl = "https://nodejs.org/dist/v20.11.0/node-v20.11.0-x64.msi"
+    $nodeInstaller = "$env:TEMP\node-installer.msi"
+
+    Write-Host "Downloading Node.js..." -ForegroundColor Cyan
+    Invoke-WebRequest -Uri $nodeUrl -OutFile $nodeInstaller -UseBasicParsing
+
+    Write-Host "Installing Node.js (may require admin)..." -ForegroundColor Cyan
+    Start-Process msiexec.exe -ArgumentList "/i", $nodeInstaller, "/quiet", "/norestart" -Wait
+
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+    Start-Sleep -Seconds 3
+
+    if (Get-Command node -ErrorAction SilentlyContinue) {
+        Write-Host "Node.js installed: $(node --version)" -ForegroundColor Green
+        Remove-Item $nodeInstaller -Force -ErrorAction SilentlyContinue
+    } else {
+        Write-Host "Node.js installation failed" -ForegroundColor Red
+        Write-Host "Download manually: https://nodejs.org/" -ForegroundColor Yellow
+    }
+}
+Write-Host ""
+
+# ============ Check/Install Python ============
+Write-Host "Checking Python..."
+if (Get-Command python -ErrorAction SilentlyContinue) {
+    Write-Host "Python installed: $(python --version)" -ForegroundColor Green
+} else {
+    Write-Host "Python not found, installing..." -ForegroundColor Yellow
+
+    $pythonUrl = "https://www.python.org/ftp/python/3.12.1/python-3.12.1-amd64.exe"
+    $pythonInstaller = "$env:TEMP\python-installer.exe"
+
+    Write-Host "Downloading Python..." -ForegroundColor Cyan
+    Invoke-WebRequest -Uri $pythonUrl -OutFile $pythonInstaller -UseBasicParsing
+
+    Write-Host "Installing Python (may require admin)..." -ForegroundColor Cyan
+    Start-Process $pythonInstaller -ArgumentList "/quiet", "InstallAllUsers=1", "PrependPath=1", "Include_pip=1" -Wait
+
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+    Start-Sleep -Seconds 3
+
+    if (Get-Command python -ErrorAction SilentlyContinue) {
+        Write-Host "Python installed: $(python --version)" -ForegroundColor Green
+        Remove-Item $pythonInstaller -Force -ErrorAction SilentlyContinue
+    } else {
+        Write-Host "Python installation failed" -ForegroundColor Red
+        Write-Host "Download manually: https://www.python.org/downloads/" -ForegroundColor Yellow
+    }
+}
+Write-Host ""
+
+# ============ Check/Install uv ============
+Write-Host "Checking uv..."
+if (Get-Command uv -ErrorAction SilentlyContinue) {
+    Write-Host "uv installed: $(uv --version)" -ForegroundColor Green
+} else {
+    Write-Host "uv not found, installing..." -ForegroundColor Yellow
+
+    try {
+        Write-Host "Downloading uv..." -ForegroundColor Cyan
+        Invoke-WebRequest -Uri "https://astral.sh/uv/install.ps1" -OutFile "$env:TEMP\install-uv.ps1" -UseBasicParsing
+        powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-uv.ps1" -Version "0.4.0" -PowerShell -Admin
+        Remove-Item "$env:TEMP\install-uv.ps1" -Force -ErrorAction SilentlyContinue
+
+        $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+
+        if (Get-Command uv -ErrorAction SilentlyContinue) {
+            Write-Host "uv installed: $(uv --version)" -ForegroundColor Green
+        }
+    } catch {
+        Write-Host "uv installation failed (optional, can be skipped)" -ForegroundColor Yellow
+    }
+}
+Write-Host ""
+
+# ============ Clean npm cache and install Foliko ============
+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 2>&1 | Out-Null
+
+# 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 ""
+    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 may have failed." -ForegroundColor Yellow
+    Write-Host "Run: npm install -g foliko"
+}

package/install.sh

@@ -1,121 +1,121 @@
-#!/bin/bash
-# Foliko Installer
-
-set -e
-
-echo -e "\033[36mFoliko Installer\033[0m"
-echo -e "\033[36m=================\033[0m"
-echo ""
-
-# Detect OS
-detect_os() {
-    if [[ "$OSTYPE" == "darwin"* ]]; then
-        echo "macOS"
-    elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
-        echo "Linux"
-    else
-        echo "unknown"
-    fi
-}
-
-OS=$(detect_os)
-
-# ============ Check/Install Node.js ============
-echo -e "\033[36mChecking Node.js...\033[0m"
-if command -v node &> /dev/null; then
-    echo -e "\033[32mNode.js installed: $(node --version)\033[0m"
-else
-    echo -e "\033[33mNode.js not found, installing...\033[0m"
-
-    if [[ "$OS" == "macOS" ]]; then
-        if command -v brew &> /dev/null; then
-            brew install node
-        else
-            echo -e "\033[31mHomebrew not found. Install it first:\033[0m"
-            echo "/bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
-            exit 1
-        fi
-    elif [[ "$OS" == "Linux" ]]; then
-        if command -v apt-get &> /dev/null; then
-            sudo apt-get update && sudo apt-get install -y nodejs npm
-        elif command -v yum &> /dev/null; then
-            sudo yum install -y nodejs npm
-        elif command -v pacman &> /dev/null; then
-            sudo pacman -S nodejs npm
-        else
-            echo -e "\033[31mNo package manager found. Install Node.js manually: https://nodejs.org/\033[0m"
-            exit 1
-        fi
-    fi
-
-    if command -v node &> /dev/null; then
-        echo -e "\033[32mNode.js installed: $(node --version)\033[0m"
-    else
-        echo -e "\033[31mNode.js installation failed\033[0m"
-        exit 1
-    fi
-fi
-echo ""
-
-# ============ Check/Install Python ============
-echo -e "\033[36mChecking Python...\033[0m"
-if command -v python3 &> /dev/null; then
-    echo -e "\033[32mPython installed: $(python3 --version)\033[0m"
-else
-    echo -e "\033[33mPython not found, installing...\033[0m"
-
-    if [[ "$OS" == "macOS" ]]; then
-        if command -v brew &> /dev/null; then
-            brew install python3
-        fi
-    elif [[ "$OS" == "Linux" ]]; then
-        if command -v apt-get &> /dev/null; then
-            sudo apt-get update && sudo apt-get install -y python3 python3-venv python3-pip
-        elif command -v yum &> /dev/null; then
-            sudo yum install -y python3
-        elif command -v pacman &> /dev/null; then
-            sudo pacman -S python python-pip
-        fi
-    fi
-
-    if command -v python3 &> /dev/null; then
-        echo -e "\033[32mPython installed: $(python3 --version)\033[0m"
-    else
-        echo -e "\033[33mPython installation failed (optional)\033[0m"
-    fi
-fi
-echo ""
-
-# ============ Check/Install uv ============
-echo -e "\033[36mChecking uv...\033[0m"
-if command -v uv &> /dev/null; then
-    echo -e "\033[32muv installed: $(uv --version)\033[0m"
-else
-    echo -e "\033[33muv not found, installing...\033[0m"
-
-    if [[ "$OS" == "macOS" ]] || [[ "$OS" == "Linux" ]]; then
-        curl -LsSf https://astral.sh/uv/install.sh | sh
-        source $HOME/.local/bin/env 2>/dev/null || true
-
-        if command -v uv &> /dev/null; then
-            echo -e "\033[32muv installed: $(uv --version)\033[0m"
-        else
-            echo -e "\033[33muv installation failed (optional)\033[0m"
-        fi
-    fi
-fi
-echo ""
-
-# ============ Install Foliko ============
-echo -e "\033[36mInstalling Foliko...\033[0m"
-npm install -g foliko
-
-if command -v foliko &> /dev/null; then
-    echo ""
-    echo -e "\033[32mInstallation complete!\033[0m"
-    echo "Run: foliko chat"
-else
-    echo ""
-    echo -e "\033[31mInstallation failed. Try manually: npm install -g foliko\033[0m"
-    exit 1
-fi
+#!/bin/bash
+# Foliko Installer
+
+set -e
+
+echo -e "\033[36mFoliko Installer\033[0m"
+echo -e "\033[36m=================\033[0m"
+echo ""
+
+# Detect OS
+detect_os() {
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        echo "macOS"
+    elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+        echo "Linux"
+    else
+        echo "unknown"
+    fi
+}
+
+OS=$(detect_os)
+
+# ============ Check/Install Node.js ============
+echo -e "\033[36mChecking Node.js...\033[0m"
+if command -v node &> /dev/null; then
+    echo -e "\033[32mNode.js installed: $(node --version)\033[0m"
+else
+    echo -e "\033[33mNode.js not found, installing...\033[0m"
+
+    if [[ "$OS" == "macOS" ]]; then
+        if command -v brew &> /dev/null; then
+            brew install node
+        else
+            echo -e "\033[31mHomebrew not found. Install it first:\033[0m"
+            echo "/bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+            exit 1
+        fi
+    elif [[ "$OS" == "Linux" ]]; then
+        if command -v apt-get &> /dev/null; then
+            sudo apt-get update && sudo apt-get install -y nodejs npm
+        elif command -v yum &> /dev/null; then
+            sudo yum install -y nodejs npm
+        elif command -v pacman &> /dev/null; then
+            sudo pacman -S nodejs npm
+        else
+            echo -e "\033[31mNo package manager found. Install Node.js manually: https://nodejs.org/\033[0m"
+            exit 1
+        fi
+    fi
+
+    if command -v node &> /dev/null; then
+        echo -e "\033[32mNode.js installed: $(node --version)\033[0m"
+    else
+        echo -e "\033[31mNode.js installation failed\033[0m"
+        exit 1
+    fi
+fi
+echo ""
+
+# ============ Check/Install Python ============
+echo -e "\033[36mChecking Python...\033[0m"
+if command -v python3 &> /dev/null; then
+    echo -e "\033[32mPython installed: $(python3 --version)\033[0m"
+else
+    echo -e "\033[33mPython not found, installing...\033[0m"
+
+    if [[ "$OS" == "macOS" ]]; then
+        if command -v brew &> /dev/null; then
+            brew install python3
+        fi
+    elif [[ "$OS" == "Linux" ]]; then
+        if command -v apt-get &> /dev/null; then
+            sudo apt-get update && sudo apt-get install -y python3 python3-venv python3-pip
+        elif command -v yum &> /dev/null; then
+            sudo yum install -y python3
+        elif command -v pacman &> /dev/null; then
+            sudo pacman -S python python-pip
+        fi
+    fi
+
+    if command -v python3 &> /dev/null; then
+        echo -e "\033[32mPython installed: $(python3 --version)\033[0m"
+    else
+        echo -e "\033[33mPython installation failed (optional)\033[0m"
+    fi
+fi
+echo ""
+
+# ============ Check/Install uv ============
+echo -e "\033[36mChecking uv...\033[0m"
+if command -v uv &> /dev/null; then
+    echo -e "\033[32muv installed: $(uv --version)\033[0m"
+else
+    echo -e "\033[33muv not found, installing...\033[0m"
+
+    if [[ "$OS" == "macOS" ]] || [[ "$OS" == "Linux" ]]; then
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        source $HOME/.local/bin/env 2>/dev/null || true
+
+        if command -v uv &> /dev/null; then
+            echo -e "\033[32muv installed: $(uv --version)\033[0m"
+        else
+            echo -e "\033[33muv installation failed (optional)\033[0m"
+        fi
+    fi
+fi
+echo ""
+
+# ============ Install Foliko ============
+echo -e "\033[36mInstalling Foliko...\033[0m"
+npm install -g foliko
+
+if command -v foliko &> /dev/null; then
+    echo ""
+    echo -e "\033[32mInstallation complete!\033[0m"
+    echo "Run: foliko chat"
+else
+    echo ""
+    echo -e "\033[31mInstallation failed. Try manually: npm install -g foliko\033[0m"
+    exit 1
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",

package/plugins/core/audit/index.js

@@ -23,7 +23,7 @@ class AuditPlugin extends Plugin {
     this.config = {
       maxLogs: config.maxLogs || 1000,
       retentionDays: config.retentionDays || 30,
-      logDir: config.logDir || path.join(os.homedir(), '.vb-agent', 'logs', 'audit')
+      logDir: config.logDir || path.join(os.homedir(), '.foliko', 'logs', 'audit')
     }
 
     this._framework = null

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);
 }