foliko 2.0.11 → 2.0.13

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.11",
+  "version": "2.0.13",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",

package/plugins/core/scheduler/index.js

@@ -340,6 +340,7 @@ class SchedulerPlugin extends Plugin {
       }),
     });
 
+    log.info(` [start] Scheduler 插件启动，当前时间: ${new Date().toISOString()} timezone=${this.config.timezone}`);
     this._loadPersistedTasks();
     return this;
   }
@@ -432,7 +433,11 @@ class SchedulerPlugin extends Plugin {
           // once：startAt 限定未来触发
           task.scheduleHandle = new Cron(runAt, this._cronOptions(task), () => this._onFire(task));
         }
+        // 打印下次执行时间便于调试
+        const nextRun = task.scheduleHandle.nextRun();
+        log.info(` [_createTask] 创建任务成功: ${task.name} cron="${cron || ''}" 下次执行: ${nextRun ? nextRun.toISOString() : 'once-立即?'} timezone=${task.timezone}`);
       } catch (err) {
+        log.error(` [_createTask] 创建调度失败: ${err.message}`);
         return { success: false, error: `调度创建失败: ${err.message}` };
       }
 
@@ -465,30 +470,39 @@ class SchedulerPlugin extends Plugin {
   }
 
   _cronOptions(task) {
-    return {
+    const opts = {
       timezone: this.config.timezone,
       protect: true, // 防重叠：上一次还没跑完，跳过本次
       catch: true,   // catch-up：进程恢复后补触发错过的触发
       name: `scheduler:${task.id}`,
       unref: true,   // 不阻止进程退出
     };
+    log.debug(` [_cronOptions] task=${task.name} cron=${task.cronExpression || 'once'} timezone=${opts.timezone}`);
+    return opts;
   }
 
   // ============================================================
   // 触发回调
   // ============================================================
   async _onFire(task) {
-    if (!task.enabled) return;
+    log.info(` [_onFire] >>> 任务触发: ${task.name} (id=${task.id}) cron=${task.cronExpression || 'once'} timezone=${task.timezone}`);
+
+    if (!task.enabled) {
+      log.warn(` [_onFire] 任务 ${task.name} 已禁用，跳过`);
+      return;
+    }
     if (task.running) {
       // 理论上 protect:true 已经处理过；这里再保险一次
-      log.warn(` 任务 ${task.name} 仍在执行中，跳过本次触发`);
+      log.warn(` [_onFire] 任务 ${task.name} 仍在执行中，跳过本次触发`);
       return;
     }
     task.running = true;
     task.lastRun = new Date();
     task.runCount++;
+    log.info(` [_onFire] 开始执行任务: ${task.name} (第${task.runCount}次)`);
     try {
       await this._executeTask(task);
+      log.info(` [_onFire] <<< 任务执行完成: ${task.name}`);
     } finally {
       task.running = false;
     }
@@ -890,12 +904,20 @@ class SchedulerPlugin extends Plugin {
   // ============================================================
   _loadPersistedTasks() {
     const savedTasks = this._taskStore.loadTasks();
-    if (!savedTasks || savedTasks.length === 0) return;
+    log.info(` [_loadPersistedTasks] 开始加载任务，当前时间: ${new Date().toISOString()}`);
+    if (!savedTasks || savedTasks.length === 0) {
+      log.info(` [_loadPersistedTasks] 没有已保存的任务`);
+      return;
+    }
+    log.info(` [_loadPersistedTasks] 从磁盘加载了 ${savedTasks.length} 个任务`);
     const now = Date.now();
 
     for (const saved of savedTasks) {
       // 已完成的 once 任务不再恢复
-      if (saved.type === 'once' && (saved.runCount || 0) > 0) continue;
+      if (saved.type === 'once' && (saved.runCount || 0) > 0) {
+        log.debug(` [_loadPersistedTasks] 跳过已完成的 once 任务: ${saved.name}`);
+        continue;
+      }
 
       const task = {
         ...saved,
@@ -910,19 +932,25 @@ class SchedulerPlugin extends Plugin {
       try {
         if (task.type === 'cron' && task.enabled && task.cronExpression) {
           task.scheduleHandle = new Cron(task.cronExpression, this._cronOptions(task), () => this._onFire(task));
+          const nextRun = task.scheduleHandle.nextRun();
+          log.info(` [_loadPersistedTasks] 恢复 cron 任务: ${task.name} cron="${task.cronExpression}" 下次执行: ${nextRun ? nextRun.toISOString() : 'N/A'}`);
           this._tasks.set(task.id, task);
         } else if (task.type === 'once' && task.enabled) {
-          if (!task.runAt) continue;
+          if (!task.runAt) {
+            log.warn(` [_loadPersistedTasks] 跳过没有 runAt 的 once 任务: ${task.name}`);
+            continue;
+          }
           const fireAt = task.runAt.getTime();
           if (fireAt <= now) {
             // 已过期：超过 grace period 就丢弃
             if (now - fireAt > ONCE_EXPIRY_GRACE_MS) {
-              log.warn(` 丢弃过期任务 ${task.name}（已过期 ${Math.round((now - fireAt) / 1000)}s，超出 24h 容忍期）`);
+              log.warn(` [_loadPersistedTasks] 丢弃过期任务 ${task.name}（已过期 ${Math.round((now - fireAt) / 1000)}s，超出 24h 容忍期）`);
               continue;
             }
             // B4/B5 修复：catchup 也用 croner 调度过去时间，croner 会立即触发；
             // stop() 能真正取消，update 走 stop()+new Cron() 不会双触发
             // protect:false 是因为"补触发"不应被 startup 期间的并发阻塞
+            log.info(` [_loadPersistedTasks] 恢复过期的 once 任务（立即触发）: ${task.name} 原定执行: ${task.runAt.toISOString()}`);
             task.scheduleHandle = new Cron(task.runAt, {
               ...this._cronOptions(task),
               protect: false,
@@ -930,15 +958,18 @@ class SchedulerPlugin extends Plugin {
             this._tasks.set(task.id, task);
           } else {
             // 未来触发
+            log.info(` [_loadPersistedTasks] 恢复 future once 任务: ${task.name} 执行时间: ${task.runAt.toISOString()}`);
             task.scheduleHandle = new Cron(task.runAt, this._cronOptions(task), () => this._onFire(task));
             this._tasks.set(task.id, task);
           }
+        } else {
+          log.debug(` [_loadPersistedTasks] 跳过任务: ${task.name} type=${task.type} enabled=${task.enabled}`);
         }
       } catch (err) {
-        log.error(` 恢复任务失败: ${task.name}`, err.message);
+        log.error(` [_loadPersistedTasks] 恢复任务失败: ${task.name}`, err.message);
       }
     }
-    log.info(` 已恢复 ${this._tasks.size} 个定时任务`);
+    log.info(` [_loadPersistedTasks] 完成，共恢复 ${this._tasks.size} 个定时任务`);
   }
 
   // ============================================================