foliko 2.0.7 → 2.0.9

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.7",
+  "version": "2.0.9",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",
@@ -67,6 +67,7 @@
     "ai": "^6.0.146",
     "chalk": "^5.6.2",
     "cli-highlight": "^2.1.11",
+    "croner": "^9.1.0",
     "crypto": "^1.0.1",
     "diff": "^9.0.0",
     "dotenv": "^17.3.1",
@@ -79,9 +80,7 @@
     "mailparser": "^3.7.2",
     "marked": "^11.2.0",
     "marked-terminal": "6",
-    "node-cron": "^4.2.1",
     "node-html-markdown": "^1.3.0",
-    "node-schedule": "^2.1.1",
     "node-telegram-bot-api": "^0.67.0",
     "nodemailer": "^6.10.0",
     "pino": "7",

package/plugins/core/scheduler/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+## 2.0.2
+
+### 修复 (bug fixes)
+
+- **B1 [安全] shell 命令注入** — 移除 `child_process.exec` 兜底路径。shell 任务必须通过 `shell_exec` / `shell` 工具执行，工具不可用时返回错误而非 fallback 到任意命令执行
+- **B2 [功能] enable: true 重新启用后调度失效** — 新增 `task.stopped` 字段显式跟踪 `stop()` 状态（croner 的 `stop()` 不清 handle 引用）。enable 路径检查 `stopped` 强制重建
+- **B3 [功能] `_updateTask` 改坏 cron 表达式后任务半残化** — 改为二阶段提交：先 `new Cron(...)` 验证表达式合法，验证通过才 commit 到 `task`。避免半残状态
+- **B4 [功能] cancel 取消不掉 catchup 触发** — catchup 路径从 `setTimeout` 改为 `new Cron(pastDate, ...)`，croner 的 `stop()` 能真正取消未来触发
+- **B5 [功能] catchup + update 双触发** — 同上修复，统一走 croner handle；update 走 `stop()+new Cron()` 自然替换
+- **B6 [并发] 共享 subagent 并发不安全** — LLM 任务改用 promise-chain 互斥（`_llmMutex`），不同任务排队执行，保护 subagent 内部状态
+
+### 改进
+
+- **M1 DRY** — `_createTask` 复用 `isCronString` helper，消除内联正则重复
+- **M3** — `reload` 清掉未触发的 `_persistTimer` 和重置 `_llmMutex`，避免旧 timer 用空 `_tasks` 写盘
+
+### 行为变更
+
+- `_updateTask` 失败时不再修改 `task` 任何字段（包括 `task.cronExpression`），失败语义更安全
+- `updated` 字段现在返回 `message` / `shell` 的真实值（之前是 `'[updated]'` 误导）
+- `updated.task` 返回包含 `stopped` 字段
+
+## 2.0.1
+
+### 新增
+
+- `schedule_get` 工具：按 ID 获取单个任务的完整详情（与 `schedule_list` 不同，会返回所有内部字段含 `running` / `createdAt` / `runAt` 等）
+- `schedule_update` 工具：修改已存在的任务，可改 `name` / `message` / `scheduleTime` / `cronExpression` / `sessionId` / `llm` / `notify` / `shell` / `enabled`
+  - 改 `scheduleTime` / `cronExpression` 会自动 `stop()` 旧 croner handle 并重建
+  - 改 `shell` 会自动把 `llm` 置为 false（互斥）
+  - 跨类型切换（once → cron / cron → once）会被拒绝，提示先 cancel 再 create
+  - `runCount` / `lastRun` / `createdAt` / `id` 始终保留
+  - `enabled: false` 只停止调度不删除任务；`enabled: true` 会在必要时重建 handle
+
+## 2.0.0
+
+### Breaking Changes
+
+- **依赖替换**：移除 `node-schedule` 和未使用的 `node-cron`；改用 [`croner`](https://github.com/Hexagon/croner) 作为唯一调度引擎
+  - 用户配置（`schedule_task` 工具入参）完全兼容，无需改动
+- **持久化文件 schema 微调**：`tasks.json` 新增 `timezone` 字段；旧的 `cronTask` / `timer` 字段不再写盘（之前存的是非序列化对象，无意义）
+  - 旧版 `tasks.json` 可被新代码读取（多余字段被忽略），无需手动迁移
+- **删除内部 API**：`_taskStats`、`_checkTasks`、`_startScheduler` 整段不再存在（之前是 no-op 或死代码）
+
+### 行为变更
+
+- **事件循环阻塞自愈**：`croner` 用绝对时间戳校验触发时间。即使主线程被 LLM 流式响应 / 磁盘 IO 阻塞几十秒，进程恢复后**会自动 catch-up 错过的触发**（`catch: true`）
+- **过期一次性任务补触发**：进程重启后，若一次性任务本应触发的时间点已过但在 24h 容忍期内，**立即补触发一次**；超过 24h 则丢弃并 warn
+- **cron 任务重叠保护**：若上次任务尚未执行完（`protect: true`），下一次触发被跳过，避免并发
+- **持久化原子化**：`saveTasks` 改为先写 `.tmp` 再 `rename`，崩溃中途不会留下半残 JSON
+- **持久化 debounce**：500ms 内的多次 mutation 合并成一次写盘，减少 IO
+
+### 新增
+
+- `timezone` 配置项（默认 `Asia/Shanghai`，可通过 `config.timezone` 或环境变量 `TZ` 覆盖）
+- `unref: true` 调度器不阻塞进程退出（避免 CLI 关闭后定时任务不退出）
+- `schedule_list` 工具输出新增 `nextRun`（croner 的 `nextRun()` getter）和 `timezone` 字段
+
+### 修复
+
+- 每次 LLM 模式 cron tick 都会 `createSubAgent`，长期运行会漏内存。现在 `_schedulerSubAgent` 单例复用
+- shell / 普通 任务的重复代码路径已合并，统一通过 `_executeTask` 分发
+- 调度失败时不再静默 warn（`croner` 是硬依赖，启动时 require 失败直接抛）