myagent-ai 1.3.3 → 1.4.0

package/core/version.py

@@ -11,7 +11,7 @@ import subprocess
 from pathlib import Path
 
 # ── 基线版本（与 setup.py / package.json 保持一致） ──
-BASE_VERSION = "1.3.3"
+BASE_VERSION = "1.4.0"
 
 
 def _version_from_git() -> str:

package/install/install.ps1

@@ -9,7 +9,7 @@ param(
 
 $ErrorActionPreference = "Stop"
 $PKG_NAME = "myagent-ai"
-$PKG_VERSION = "1.3.3"
+$PKG_VERSION = "1.4.0"
 
 # Allow running scripts for the current process
 if ($PSVersionTable.PSVersion.Major -ge 5) {
@@ -57,13 +57,13 @@ function Check-Python {
     }
     # 尝试在常见安装路径查找
     $commonPaths = @(
+        "$env:LOCALAPPDATA\Programs\Python\Python314\python.exe",
+        "$env:LOCALAPPDATA\Programs\Python\Python313\python.exe",
         "$env:LOCALAPPDATA\Programs\Python\Python312\python.exe",
-        "$env:LOCALAPPDATA\Programs\Python\Python311\python.exe",
-        "$env:LOCALAPPDATA\Programs\Python\Python310\python.exe",
-        "C:\Python312\python.exe",
-        "C:\Python311\python.exe",
-        "C:\Program Files\Python312\python.exe",
-        "C:\Program Files\Python311\python.exe"
+        "C:\Python314\python.exe",
+        "C:\Python313\python.exe",
+        "C:\Program Files\Python314\python.exe",
+        "C:\Program Files\Python313\python.exe"
     )
     foreach ($pyPath in $commonPaths) {
         if (Test-Path $pyPath) {
@@ -79,14 +79,14 @@ function Check-Python {
 }
 
 function Install-Python {
-    Write-Host "[*] Installing Python 3.12 ..." -ForegroundColor Yellow
+    Write-Host "[*] Installing Python 3.14 ..." -ForegroundColor Yellow
     $installAttempted = $false
 
     # Try winget first
     try {
         $null = (winget --version 2>$null)
         Write-Host "  Using winget ..." -ForegroundColor Gray
-        winget install Python.Python.3.12 --accept-package-agreements --accept-source-agreements
+        winget install Python.Python.3.14 --accept-package-agreements --accept-source-agreements
         $installAttempted = $true
         # 等待安装完成后刷新 PATH（重试多次）
         for ($i = 1; $i -le 5; $i++) {
@@ -96,9 +96,9 @@ function Install-Python {
         # winget 已完成安装，即使 Check-Python 失败也不再重复安装
         Refresh-Path
         $pyPaths = @(
-            "$env:LOCALAPPDATA\Programs\Python\Python312\python.exe",
-            "C:\Python312\python.exe",
-            "C:\Program Files\Python312\python.exe"
+            "$env:LOCALAPPDATA\Programs\Python\Python314\python.exe",
+            "C:\Python314\python.exe",
+            "C:\Program Files\Python314\python.exe"
         )
         foreach ($pyPath in $pyPaths) {
             if (Test-Path $pyPath) {
@@ -121,11 +121,11 @@ function Install-Python {
     # 仅在 winget 未尝试时才从 python.org 下载（避免双重安装）
     if (-not $installAttempted) {
         # Fallback: download from python.org
-        $pyUrl = "https://www.python.org/ftp/python/3.12.8/python-3.12.8-amd64.exe"
+        $pyUrl = "https://www.python.org/ftp/python/3.14.0/python-3.14.0-amd64.exe"
         $pyExe = Join-Path $env:TEMP "python-installer.exe"
 
         try {
-            Write-Host "  Downloading Python 3.12.8 ..." -ForegroundColor Gray
+            Write-Host "  Downloading Python 3.14.0 ..." -ForegroundColor Gray
             Invoke-WebRequest -Uri $pyUrl -OutFile $pyExe -UseBasicParsing
 
             Write-Host "  Installing (Add to PATH) ..." -ForegroundColor Gray
@@ -216,11 +216,9 @@ function Install-MyAgent {
     Write-Host "[OK] $PKG_NAME installed" -ForegroundColor Green
 }
 
-# ── Install Python dependencies ─────────────────────────
+# ── Install Python dependencies (使用独立虚拟环境) ──
 function Install-PythonDeps {
-    # 获取 Python 命令（使用已检测到的路径或默认）
     $pyCmd = if ($Script:PythonCmd) { $Script:PythonCmd } else { "python" }
-
     $npmRoot = (npm root -g 2>$null)
     $pkgDir = Join-Path $npmRoot $PKG_NAME
     $reqFile = Join-Path $pkgDir "requirements.txt"
@@ -234,14 +232,20 @@ function Install-PythonDeps {
         }
     }
 
-    Write-Host "[*] Installing Python dependencies ..." -ForegroundColor Yellow
-    Write-Host "  Using: $pyCmd" -ForegroundColor Gray
-    & $pyCmd -m pip install -r $reqFile
-    if ($LASTEXITCODE -ne 0) {
-        Write-Host "[!] Some deps failed (non-critical). Try: $pyCmd -m pip install -r $reqFile" -ForegroundColor Yellow
-    } else {
-        Write-Host "[OK] Python dependencies installed" -ForegroundColor Green
-    }
+    $venvDir = "$env:USERPROFILE\.myagent\venv"
+    $venvPython = Join-Path $venvDir "Scripts\python.exe"
+
+    Write-Host "[*] Creating virtual environment at $venvDir ..." -ForegroundColor Yellow
+    New-Item -ItemType Directory -Path "$env:USERPROFILE\.myagent" -Force | Out-Null
+    & $pyCmd -m venv $venvDir
+    Write-Host "[OK] Virtual environment created" -ForegroundColor Green
+
+    Write-Host "[*] Installing Python dependencies into venv ..." -ForegroundColor Yellow
+    & $venvPython -m pip install --upgrade pip --quiet 2>$null
+    & $venvPython -m pip install -r $reqFile --disable-pip-version-check
+    Write-Host "[OK] Dependencies installed into venv" -ForegroundColor Green
+    Write-Host "[i] Virtual env: $venvDir" -ForegroundColor Gray
+    Write-Host "[i] venv will be used automatically on startup" -ForegroundColor Gray
 }
 
 # ── Post-install guide ──────────────────────────────

package/install/install.sh

@@ -21,7 +21,7 @@ NO_DEPS=false
 DRY_RUN=false
 SCRIPT_URL="https://raw.githubusercontent.com/ctz168/myagent/main/install/install.sh"
 PKG_NAME="myagent-ai"
-PKG_VERSION="1.3.3"
+PKG_VERSION="1.4.0"
 
 for arg in "$@"; do
   case "$arg" in
@@ -82,7 +82,7 @@ check_python() {
 
   # 按优先级尝试多个 Python 命令（包括版本号后缀的）
   local py_cmd=""
-  for cmd in python3 python3.12 python3.11 python3.10 python; do
+  for cmd in python3 python3.14 python3.13 python3.12 python; do
     if command -v "$cmd" &>/dev/null; then
       py_cmd="$cmd"
       break
@@ -115,7 +115,7 @@ get_python_cmd() {
     return 0
   fi
   hash -r 2>/dev/null || true
-  for cmd in python3 python3.12 python3.11 python3.10 python; do
+  for cmd in python3 python3.14 python3.13 python3.12 python; do
     if command -v "$cmd" &>/dev/null; then
       _PYTHON_CMD="$cmd"
       echo "$cmd"
@@ -127,30 +127,30 @@ get_python_cmd() {
 }
 
 install_python() {
-  step "Installing Python 3.12 ..."
+  step "Installing Python 3.14 ..."
   local installed=false
 
   if [ "$OS" = "macos" ]; then
     if command -v brew &>/dev/null; then
       info "Using Homebrew ..."
-      brew install python@3.12 && installed=true
+      brew install python@3.14 && installed=true
       # brew 安装后更新 PATH 并刷新缓存
-      export PATH="$(brew --prefix python@3.12)/bin:$PATH"
+      export PATH="$(brew --prefix python@3.14)/bin:$PATH"
       hash -r
       # 等待文件系统同步（某些情况下 brew 完成后二进制文件不会立即可见）
       sleep 1
       if check_python; then return 0; fi
       # brew 已安装但 python3 软链接可能不存在，尝试手动查找
       local brew_py
-      brew_py="$(brew --prefix python@3.12)/bin/python3"
+      brew_py="$(brew --prefix python@3.14)/bin/python3"
       if [ -x "$brew_py" ]; then
         _PYTHON_CMD="$brew_py"
         success "Python found at $brew_py"
         return 0
       fi
       # 尝试查找版本化的 python 二进制
-      for ver in 3.12 3.11 3.10; do
-        brew_py="$(brew --prefix python@3.12)/bin/python${ver}"
+      for ver in 3.14 3.13 3.12; do
+        brew_py="$(brew --prefix python@3.14)/bin/python${ver}"
         if [ -x "$brew_py" ]; then
           _PYTHON_CMD="$brew_py"
           success "Python found at $brew_py"
@@ -160,20 +160,20 @@ install_python() {
       # brew 已成功安装，即使 check_python 失败也不再重复安装
       if $installed; then
         warn "Python 已通过 Homebrew 安装，但 python3 命令暂不可用"
-        info "请重启终端或运行: export PATH=\"$(brew --prefix python@3.12)/bin:\$PATH\""
-        info "或直接使用: $(brew --prefix python@3.12)/bin/python3"
+        info "请重启终端或运行: export PATH=\"$(brew --prefix python@3.14)/bin:\$PATH\""
+        info "或直接使用: $(brew --prefix python@3.14)/bin/python3"
         # 将 brew python 路径设为 _PYTHON_CMD 供后续使用
-        _PYTHON_CMD="$(brew --prefix python@3.12)/bin/python3"
+        _PYTHON_CMD="$(brew --prefix python@3.14)/bin/python3"
         return 0
       fi
     fi
     # 仅在 brew 未安装时才从 python.org 下载
     if ! $installed; then
-      info "Downloading Python 3.12 ..."
-      curl -fsSL -o /tmp/python.pkg "https://www.python.org/ftp/python/3.12.8/python-3.12.8-macos11.pkg"
+      info "Downloading Python 3.14 ..."
+      curl -fsSL -o /tmp/python.pkg "https://www.python.org/ftp/python/3.14.0/python-3.14.0-macos11.pkg"
       sudo installer -pkg /tmp/python.pkg -target /
       rm -f /tmp/python.pkg
-      export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"
+      export PATH="/Library/Frameworks/Python.framework/Versions/3.14/bin:$PATH"
       hash -r
       if check_python; then return 0; fi
     fi
@@ -184,12 +184,12 @@ install_python() {
     if command -v apt-get &>/dev/null; then
       info "Using apt ..."
       sudo apt-get update -qq
-      sudo apt-get install -y python3.12 python3.12-venv python3-pip 2>/dev/null || \
+      sudo apt-get install -y python3.14 python3.14-venv python3-pip 2>/dev/null || \
       sudo apt-get install -y python3 python3-venv python3-pip
       hash -r
       if check_python; then return 0; fi
       # apt 已安装但可能需要版本化命令
-      for ver in 3.12 3.11 3.10; do
+      for ver in 3.14 3.13 3.12; do
         if command -v "python${ver}" &>/dev/null; then
           _PYTHON_CMD="python${ver}"
           success "Python found as python${ver}"
@@ -200,7 +200,7 @@ install_python() {
     fi
     if command -v dnf &>/dev/null; then
       info "Using dnf ..."
-      sudo dnf install -y python3.12 2>/dev/null || sudo dnf install -y python3
+      sudo dnf install -y python3.14 2>/dev/null || sudo dnf install -y python3
       hash -r
       if check_python; then return 0; fi
       return 1
@@ -345,14 +345,13 @@ install_myagent() {
   success "$PKG_NAME installed"
 }
 
-# ── Install Python dependencies ─────────────────────────
+# ── Install Python dependencies (使用独立虚拟环境) ──
 install_python_deps() {
   local pkg_dir
   pkg_dir="$(npm root -g)/$PKG_NAME"
   local req_file="$pkg_dir/requirements.txt"
 
   if [ ! -f "$req_file" ]; then
-    # 尝试从项目目录查找
     if [ -f "./requirements.txt" ]; then
       req_file="./requirements.txt"
     else
@@ -361,7 +360,6 @@ install_python_deps() {
     fi
   fi
 
-  # 获取已安装的 Python 命令
   local py_cmd
   py_cmd="$(get_python_cmd)"
   if [ -z "$py_cmd" ]; then
@@ -369,26 +367,19 @@ install_python_deps() {
     return 1
   fi
 
-  step "Installing Python dependencies ..."
-  # 使用已检测到的 Python 命令安装依赖
-  "$py_cmd" -m pip install -r "$req_file" --break-system-packages 2>/dev/null || \
-  "$py_cmd" -m pip install -r "$req_file" 2>/dev/null || \
-  {
-    warn "pip install 失败 (可能受 PEP668 限制)"
-    info "尝试使用 venv 安装..."
-    local venv_dir="$HOME/.myagent/venv"
-    "$py_cmd" -m venv "$venv_dir" 2>/dev/null
-    if [ -f "$venv_dir/bin/pip" ]; then
-      "$venv_dir/bin/pip" install -r "$req_file"
-      success "已安装到虚拟环境 $venv_dir"
-      info "启动时请使用: $venv_dir/bin/python main.py --web"
-      return 0
-    fi
-    err "所有安装方式均失败"
-    info "请手动安装: $py_cmd -m pip install -r $req_file --break-system-packages"
-    return 1
-  }
-  success "Python dependencies installed"
+  local venv_dir="$HOME/.myagent/venv"
+
+  step "Creating virtual environment at $venv_dir ..."
+  mkdir -p "$HOME/.myagent"
+  "$py_cmd" -m venv "$venv_dir"
+  success "Virtual environment created"
+
+  step "Installing Python dependencies into venv ..."
+  "$venv_dir/bin/pip" install --upgrade pip --quiet 2>/dev/null || true
+  "$venv_dir/bin/pip" install -r "$req_file" --disable-pip-version-check
+  success "Dependencies installed into venv"
+  info "虚拟环境: $venv_dir"
+  info "启动时自动使用 venv，无需手动激活"
 }
 
 # ── 首次配置引导 ───────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
   "bin": {

package/setup.py

@@ -9,7 +9,7 @@ from pathlib import Path
 _version_path = Path(__file__).parent / "core" / "version.py"
 _version_vars = {}
 exec(_version_path.read_text(), _version_vars)
-__version__ = _version_vars.get("BASE_VERSION", "1.3.3")
+__version__ = _version_vars.get("BASE_VERSION", "1.4.0")
 
 setup(
     name="myagent",

package/start.js

@@ -2,68 +2,83 @@
 /**
  * start.js - 跨平台入口脚本 (Windows/macOS/Linux)
  * ================================================
- * npm bin 入口，自动检测平台:
- *   - Windows: 直接调用 python main.py [args]（不依赖 bash）
- *   - macOS/Linux: 委托给 start.sh [args]（保留完整的环境检测逻辑）
+ * npm bin 入口，自动管理独立虚拟环境:
+ *   - 虚拟环境位置: ~/.myagent/venv (与其他项目完全隔离)
+ *   - 首次运行自动创建 venv 并安装所有依赖
+ *   - 后续运行直接使用 venv，无需重复安装
+ *   - pip 升级/重装: myagent-ai reinstall
  *
  * 用法:
- *   myagent-ai          # 交互式选择运行模式
- *   myagent-ai web      # Web 管理后台
- *   myagent-ai cli      # CLI 模式
- *   myagent-ai tray     # 系统托盘模式
- *   myagent-ai server   # API 服务模式
- *   myagent-ai setup    # 配置向导
+ *   myagent-ai            # 交互式选择运行模式
+ *   myagent-ai web        # Web 管理后台
+ *   myagent-ai cli        # CLI 模式
+ *   myagent-ai tray       # 系统托盘模式
+ *   myagent-ai server     # API 服务模式
+ *   myagent-ai setup      # 配置向导
+ *   myagent-ai reinstall  # 重新安装依赖到 venv
  */
 "use strict";
 
 const { spawn, execSync, execFileSync } = require("child_process");
 const path = require("path");
 const fs = require("fs");
+const os = require("os");
 
 // ── 常量 ──────────────────────────────────────────────────
 const IS_WIN = process.platform === "win32";
 
-// 解析包目录（兼容 symlink / npm link / 全局安装）
+// 虚拟环境目录
+function getVenvDir() {
+  const homeDir = os.homedir();
+  return path.join(homeDir, ".myagent", "venv");
+}
+
+// venv 中 Python 可执行文件的路径
+function getVenvPython(venvDir) {
+  return IS_WIN
+    ? path.join(venvDir, "Scripts", "python.exe")
+    : path.join(venvDir, "bin", "python");
+}
+
+// venv 中 pip 可执行文件的路径
+function getVenvPip(venvDir) {
+  return IS_WIN
+    ? path.join(venvDir, "Scripts", "pip.exe")
+    : path.join(venvDir, "bin", "pip");
+}
+
+// MyAgent 数据目录
+function getDataDir() {
+  return path.join(os.homedir(), ".myagent");
+}
+
+// ── 解析包目录 ────────────────────────────────────────────
 function resolvePackageDir() {
-  // 1. 当前文件所在目录
   let dir = __dirname;
-
-  // 2. 如果 main.py 不在这里，尝试 npm global prefix
   if (!fs.existsSync(path.join(dir, "main.py"))) {
     try {
       const npmRoot = execSync("npm root -g", {
-        encoding: "utf8",
-        stdio: ["pipe", "pipe", "pipe"],
+        encoding: "utf8", stdio: ["pipe", "pipe", "pipe"],
       }).trim();
       const candidate = path.join(npmRoot, "myagent-ai");
-      if (fs.existsSync(path.join(candidate, "main.py"))) {
-        dir = candidate;
-      }
-    } catch (_) {
-      // ignore
-    }
+      if (fs.existsSync(path.join(candidate, "main.py"))) dir = candidate;
+    } catch (_) {}
   }
-
-  // 3. 向上查找
   if (!fs.existsSync(path.join(dir, "main.py"))) {
     let up = dir;
     for (let i = 0; i < 5; i++) {
       up = path.dirname(up);
-      if (fs.existsSync(path.join(up, "main.py"))) {
-        dir = up;
-        break;
-      }
+      if (fs.existsSync(path.join(up, "main.py"))) { dir = up; break; }
     }
   }
-
   return dir;
 }
 
-// ── 查找 Python ────────────────────────────────────────────
-function findPython() {
+// ── 查找系统 Python（用于创建 venv） ─────────────────────
+function findSystemPython() {
   const candidates = IS_WIN
-    ? ["python", "python3", "python3.12", "python3.11", "python3.10"]
-    : ["python3", "python3.12", "python3.11", "python3.10", "python"];
+    ? ["python", "python3", "python3.14", "python3.13", "python3.12", "python3.11"]
+    : ["python3", "python3.14", "python3.13", "python3.12", "python"];
 
   for (const cmd of candidates) {
     try {
@@ -72,87 +87,109 @@ function findPython() {
         ["--version"],
         { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 5000 }
       );
-      // 解析版本号
       const match = result.match(/Python (\d+)\.(\d+)/);
       if (match) {
         const major = parseInt(match[1], 10);
         const minor = parseInt(match[2], 10);
-        if (major >= 3 && minor >= 10) {
-          return cmd;
-        }
+        if (major >= 3 && minor >= 10) return cmd;
       }
-    } catch (_) {
-      // 继续尝试下一个
+    } catch (_) {}
+  }
+
+  // Windows: 搜索常见安装路径
+  if (IS_WIN) {
+    const localAppData = process.env.LOCALAPPDATA || "";
+    const programFiles = process.env.ProgramFiles || "";
+    const programFilesX86 = process.env["ProgramFiles(x86)"] || "";
+    const searchPaths = [
+      path.join(localAppData, "Programs", "Python", "Python314", "python.exe"),
+      path.join(localAppData, "Programs", "Python", "Python313", "python.exe"),
+      path.join(localAppData, "Programs", "Python", "Python312", "python.exe"),
+      path.join(programFiles, "Python314", "python.exe"),
+      path.join(programFiles, "Python313", "python.exe"),
+      "C:\\Python314\\python.exe", "C:\\Python313\\python.exe",
+    ];
+    for (const pyPath of searchPaths) {
+      if (fs.existsSync(pyPath)) return pyPath;
     }
   }
 
   return null;
 }
 
-// ── Windows: 常见 Python 安装路径 ──────────────────────────
-function findPythonOnWindows() {
-  const localAppData = process.env.LOCALAPPDATA || "";
-  const programFiles = process.env.ProgramFiles || "";
-  const programFilesX86 = process.env["ProgramFiles(x86)"] || "";
-
-  const searchPaths = [
-    path.join(localAppData, "Programs", "Python", "Python312", "python.exe"),
-    path.join(localAppData, "Programs", "Python", "Python311", "python.exe"),
-    path.join(localAppData, "Programs", "Python", "Python310", "python.exe"),
-    path.join(programFiles, "Python312", "python.exe"),
-    path.join(programFiles, "Python311", "python.exe"),
-    path.join(programFiles, "Python310", "python.exe"),
-    path.join(programFilesX86, "Python312", "python.exe"),
-    path.join(programFilesX86, "Python311", "python.exe"),
-    "C:\\Python312\\python.exe",
-    "C:\\Python311\\python.exe",
-  ];
-
-  for (const pyPath of searchPaths) {
-    if (fs.existsSync(pyPath)) {
-      try {
-        const result = execFileSync(pyPath, ["--version"], {
-          encoding: "utf8",
-          stdio: ["pipe", "pipe", "pipe"],
-          timeout: 5000,
-        });
-        if (result.includes("Python")) {
-          return pyPath;
-        }
-      } catch (_) {
-        // continue
-      }
+// ── 虚拟环境管理 ─────────────────────────────────────────
+
+/**
+ * 确保 venv 存在且可用
+ * Returns: { venvDir, venvPython, venvPip }
+ */
+function ensureVenv() {
+  const venvDir = getVenvDir();
+  const venvPython = getVenvPython(venvDir);
+  const venvPip = getVenvPip(venvDir);
+
+  // 检查现有 venv 是否完整
+  if (fs.existsSync(venvPython)) {
+    try {
+      execFileSync(venvPython, ["--version"], {
+        encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 5000,
+      });
+      return { venvDir, venvPython, venvPip, isNew: false };
+    } catch (_) {
+      // venv 损坏，需要重建
+      console.log("  \x1b[33m[!]\x1b[0m 虚拟环境已损坏，正在重建...");
+      fs.rmSync(venvDir, { recursive: true, force: true });
     }
   }
 
-  return null;
-}
+  // 创建 venv
+  const systemPython = findSystemPython();
+  if (!systemPython) {
+    console.error("\x1b[31m[✗]\x1b[0m 未找到 Python 3.10+");
+    console.error("  请先安装 Python: https://www.python.org/downloads/");
+    console.error("  安装时请勾选 'Add Python to PATH'");
+    console.error("");
+    console.error("  或一键安装:");
+    if (IS_WIN) {
+      console.error("    powershell -c \"irm https://raw.githubusercontent.com/ctz168/myagent/main/install/install.ps1 | iex\"");
+    } else {
+      console.error("    curl -fsSL https://raw.githubusercontent.com/ctz168/myagent/main/install/install.sh | bash");
+    }
+    process.exit(1);
+  }
 
-// ── 构建 Python 参数 ───────────────────────────────────────
-function buildArgs(userArgs) {
-  const mode = userArgs[0] || "";
-  switch (mode) {
-    case "cli":
-      return ["main.py"];
-    case "web":
-      return ["main.py", "--web"];
-    case "tray":
-      return ["main.py", "--tray"];
-    case "server":
-      return ["main.py", "--server"];
-    case "setup":
-      return ["main.py", "--setup"];
-    case "":
-      // 无参数：不传任何 flag，让 Python 程序进入交互式选择
-      return ["main.py"];
-    default:
-      // 透传未知参数
-      return ["main.py", ...userArgs];
+  // 确保 ~/.myagent 目录存在
+  const dataDir = getDataDir();
+  if (!fs.existsSync(dataDir)) {
+    fs.mkdirSync(dataDir, { recursive: true });
+  }
+
+  console.log("  \x1b[36m[*]\x1b[0m 创建独立虚拟环境...");
+  console.log(`  \x1b[90m[i]\x1b[0m 位置: ${venvDir}`);
+  console.log(`  \x1b[90m[i]\x1b[0m 系统Python: ${systemPython}`);
+
+  try {
+    execFileSync(systemPython, ["-m", "venv", venvDir], {
+      encoding: "utf8", stdio: "inherit", timeout: 60000,
+    });
+  } catch (err) {
+    console.error(`\x1b[31m[✗]\x1b[0m 创建虚拟环境失败: ${err.message}`);
+    process.exit(1);
+  }
+
+  // 验证创建成功
+  if (!fs.existsSync(venvPython)) {
+    console.error("\x1b[31m[✗]\x1b[0m 虚拟环境创建后未找到 Python，请检查系统 Python 安装");
+    process.exit(1);
   }
+
+  console.log("  \x1b[32m[✓]\x1b[0m 虚拟环境已创建");
+  return { venvDir, venvPython, venvPip, isNew: true };
 }
 
-// ── Windows: pip 安装依赖（带升级和 fallback） ──────────────
-// 核心依赖包名列表（直接安装，不依赖 requirements.txt 解析）
+// ── 依赖安装 ─────────────────────────────────────────────
+
+// 核心依赖包（fallback 用，不依赖文件解析）
 const CORE_PACKAGES = [
   "openai>=1.12.0",
   "aiohttp>=3.9.0",
@@ -163,61 +200,17 @@ const CORE_PACKAGES = [
   "psutil>=5.9.0",
 ];
 
-function pipInstall(pythonCmd, packages, cwd) {
-  const args = ["-m", "pip", "install", "--quiet", "--disable-pip-version-check", ...packages];
-  return execFileSync(pythonCmd, args, {
-    encoding: "utf8",
-    stdio: "inherit",
-    timeout: 180000,
-    cwd,
-  });
-}
-
-function pipInstallReqFile(pythonCmd, reqFile, cwd) {
-  return execFileSync(pythonCmd, ["-m", "pip", "install", "-r", reqFile, "--disable-pip-version-check"], {
-    encoding: "utf8",
-    stdio: "inherit",
-    timeout: 300000,
-    cwd,
-  });
-}
-
-function upgradePip(pythonCmd) {
-  try {
-    console.log("  \x1b[90m[i]\x1b[0m 升级 pip...");
-    execFileSync(pythonCmd, ["-m", "pip", "install", "--upgrade", "pip", "--quiet"], {
-      encoding: "utf8",
-      stdio: ["pipe", "pipe", "pipe"],
-      timeout: 120000,
-    });
-  } catch (_) {
-    // 升级失败不阻断，继续尝试安装
-  }
-}
-
-// ── Windows 快速依赖检查 ───────────────────────────────────
-function checkDepsWin(pkgDir) {
+function installDeps(venvPython, venvPip, pkgDir) {
   const required = ["openai", "aiohttp", "requests"];
-  let pythonCmd = findPython() || findPythonOnWindows();
+  let missing = [];
 
-  if (!pythonCmd) {
-    console.error("\x1b[31m[✗]\x1b[0m 未找到 Python 3.10+");
-    console.error("  请先安装 Python: https://www.python.org/downloads/");
-    console.error("  安装时请勾选 'Add Python to PATH'");
-    console.error("");
-    console.error("  或一键安装: powershell -c \"irm https://raw.githubusercontent.com/ctz168/myagent/main/install/install.ps1 | iex\"");
-    process.exit(1);
-  }
+  console.log("  \x1b[36m[*]\x1b[0m 检查依赖...");
 
-  // 检查核心依赖
-  let missing = [];
   for (const mod of required) {
     try {
-      execFileSync(
-        pythonCmd,
-        ["-c", `import ${mod}`],
-        { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 5000, cwd: pkgDir }
-      );
+      execFileSync(venvPython, ["-c", `import ${mod}`], {
+        encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 5000,
+      });
       console.log(`  \x1b[32m[✓]\x1b[0m ${mod}`);
     } catch (_) {
       console.log(`  \x1b[33m[!]\x1b[0m ${mod}`);
@@ -225,44 +218,62 @@ function checkDepsWin(pkgDir) {
     }
   }
 
-  if (missing.length > 0) {
-    console.log(`\x1b[33m[!]\x1b[0m 正在安装 ${missing.length} 个缺失依赖...`);
-    const reqFile = path.join(pkgDir, "requirements.txt");
-
-    // 策略1: 先升级 pip（旧版 pip 无法解析 requirements.txt）
-    upgradePip(pythonCmd);
-
-    // 策略2: 尝试 pip install -r requirements.txt
-    let installed = false;
-    if (fs.existsSync(reqFile)) {
-      try {
-        pipInstallReqFile(pythonCmd, reqFile, pkgDir);
-        console.log(`  \x1b[32m[✓]\x1b[0m 依赖安装完成`);
-        installed = true;
-      } catch (_) {
-        // requirements.txt 安装失败，进入 fallback
-        console.log(`  \x1b[33m[!]\x1b[0m requirements.txt 安装失败，尝试直接安装核心依赖...`);
-      }
+  if (missing.length === 0) return;
+
+  const reqFile = path.join(pkgDir, "requirements.txt");
+
+  // 策略1: 升级 pip
+  try {
+    console.log("  \x1b[90m[i]\x1b[0m 升级 pip...");
+    execFileSync(venvPython, ["-m", "pip", "install", "--upgrade", "pip", "--quiet"], {
+      encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], timeout: 120000,
+    });
+  } catch (_) {}
+
+  // 策略2: pip install -r requirements.txt（venv 内无 PEP668 限制）
+  let installed = false;
+  if (fs.existsSync(reqFile)) {
+    console.log(`\x1b[33m[!]\x1b[0m 正在安装 ${missing.length} 个缺失依赖到虚拟环境...`);
+    try {
+      execFileSync(venvPython, ["-m", "pip", "install", "-r", reqFile, "--disable-pip-version-check"], {
+        encoding: "utf8", stdio: "inherit", timeout: 300000,
+      });
+      console.log("  \x1b[32m[✓]\x1b[0m 依赖安装完成");
+      installed = true;
+    } catch (_) {
+      console.log("  \x1b[33m[!]\x1b[0m requirements.txt 安装失败，尝试直接安装核心依赖...");
     }
+  }
 
-    // 策略3: 直接按包名安装核心依赖（不依赖 requirements.txt 解析）
-    if (!installed) {
-      try {
-        pipInstall(pythonCmd, CORE_PACKAGES, pkgDir);
-        console.log(`  \x1b[32m[✓]\x1b[0m 核心依赖安装完成`);
-        console.log(`  \x1b[90m[i]\x1b[0m 其他依赖将在 MyAgent 启动时自动安装`);
-      } catch (_) {
-        console.error(`  \x1b[31m[✗]\x1b[0m 依赖安装失败，请手动运行:`);
-        console.error(`    ${pythonCmd} -m pip install -r "${reqFile}"`);
-        console.error(`  或逐个安装:`);
-        for (const pkg of CORE_PACKAGES) {
-          console.error(`    ${pythonCmd} -m pip install ${pkg}`);
-        }
-      }
+  // 策略3: 直接按包名安装
+  if (!installed) {
+    try {
+      execFileSync(venvPython, ["-m", "pip", "install", "--quiet", "--disable-pip-version-check", ...CORE_PACKAGES], {
+        encoding: "utf8", stdio: "inherit", timeout: 180000,
+      });
+      console.log("  \x1b[32m[✓]\x1b[0m 核心依赖安装完成");
+      console.log("  \x1b[90m[i]\x1b[0m 其他依赖将在启动时自动安装");
+    } catch (_) {
+      console.error("  \x1b[31m[✗]\x1b[0m 依赖安装失败，请手动运行:");
+      console.error(`    ${venvPython} -m pip install -r "${reqFile}"`);
     }
   }
+}
 
-  return pythonCmd;
+// ── 构建 main.py 参数 ────────────────────────────────────
+function buildArgs(userArgs) {
+  const mode = userArgs[0] || "";
+  switch (mode) {
+    case "cli":     return ["main.py"];
+    case "web":     return ["main.py", "--web"];
+    case "tray":    return ["main.py", "--tray"];
+    case "server":  return ["main.py", "--server"];
+    case "setup":   return ["main.py", "--setup"];
+    case "reinstall":
+      return []; // 特殊处理
+    default:
+      return ["main.py", ...userArgs];
+  }
 }
 
 // ── 主入口 ─────────────────────────────────────────────────
@@ -277,85 +288,93 @@ function main() {
     process.exit(1);
   }
 
+  // 特殊命令: reinstall
+  if (userArgs[0] === "reinstall") {
+    const venvDir = getVenvDir();
+    if (fs.existsSync(venvDir)) {
+      console.log("  \x1b[36m[*]\x1b[0m 删除旧虚拟环境...");
+      fs.rmSync(venvDir, { recursive: true, force: true });
+    }
+    const { venvPython, venvPip } = ensureVenv();
+    installDeps(venvPython, venvPip, pkgDir);
+    console.log("");
+    console.log("  \x1b[32m[✓]\x1b[0m 依赖已全部重新安装到虚拟环境");
+    console.log(`  \x1b[90m[i]\x1b[0m 虚拟环境: ${venvDir}`);
+    console.log("");
+    return;
+  }
+
   // 打印 Banner
   console.log("");
   console.log("  \x1b[1m\x1b[36mMyAgent\x1b[0m - 本地桌面端执行型 AI 助手");
   console.log("");
 
-  if (IS_WIN) {
-    // ── Windows 路径 ──
-    const pythonCmd = checkDepsWin(pkgDir);
-
-    // 首次运行检测
-    const homeDir = process.env.USERPROFILE || process.env.HOME || "";
-    const configFile = path.join(homeDir, ".myagent", "config.json");
-    if (!fs.existsSync(configFile)) {
-      console.log("");
-      console.log("  \x1b[90m[i]\x1b[0m 检测到首次运行，MyAgent 将在启动后引导你完成配置。");
-      console.log("  1. 配置 LLM API Key（支持 OpenAI/Anthropic/ModelScope 等）");
-      console.log("  2. 选择默认运行模式");
-      console.log("");
-    }
+  // 确保 venv 存在
+  const { venvDir, venvPython, isNew } = ensureVenv();
 
-    // 构建 Python 参数
-    const mode = userArgs[0] || "";
-    const pyArgs = buildArgs(userArgs);
-
-    if (mode) {
-      const modeNames = {
-        web: "Web 管理后台 (http://localhost:8767)",
-        cli: "CLI 交互模式",
-        tray: "系统托盘模式",
-        server: "API 服务模式",
-        setup: "配置向导",
-      };
-      console.log(`\x1b[36m启动 ${modeNames[mode] || mode}...\x1b[0m`);
-    } else {
-      console.log(`\x1b[36m启动...\x1b[0m`);
-    }
+  // 检查并安装依赖
+  if (isNew) {
+    installDeps(venvPython, getVenvPip(venvDir), pkgDir);
+  } else {
+    // 即使 venv 已存在，也快速检查核心依赖
+    const venvPip = getVenvPip(venvDir);
+    installDeps(venvPython, venvPip, pkgDir);
+  }
 
-    // 使用 spawn 以交互模式运行 Python
-    const child = spawn(pythonCmd, pyArgs, {
-      cwd: pkgDir,
-      stdio: "inherit",
-      env: { ...process.env },
-    });
+  // 首次运行检测
+  const configFile = path.join(getDataDir(), "config.json");
+  if (!fs.existsSync(configFile)) {
+    console.log("");
+    console.log("  \x1b[90m[i]\x1b[0m 检测到首次运行，MyAgent 将在启动后引导你完成配置。");
+    console.log("  1. 配置 LLM API Key（支持 OpenAI/Anthropic/ModelScope 等）");
+    console.log("  2. 选择默认运行模式");
+    console.log("");
+  }
 
-    child.on("error", (err) => {
-      console.error(`\x1b[31m[✗]\x1b[0m 启动失败: ${err.message}`);
-      process.exit(1);
-    });
+  // 显示环境信息
+  console.log(`  \x1b[90m[i]\x1b[0m 虚拟环境: ${venvDir}`);
+  console.log(`  \x1b[90m[i]\x1b[0m Python: ${venvPython}`);
+  console.log("");
 
-    child.on("exit", (code) => {
-      process.exit(code || 0);
-    });
+  // 构建 Python 参数
+  const mode = userArgs[0] || "";
+  const pyArgs = buildArgs(userArgs);
+
+  if (mode) {
+    const modeNames = {
+      web: "Web 管理后台 (http://localhost:8767)",
+      cli: "CLI 交互模式",
+      tray: "系统托盘模式",
+      server: "API 服务模式",
+      setup: "配置向导",
+    };
+    console.log(`\x1b[36m启动 ${modeNames[mode] || mode}...\x1b[0m`);
   } else {
-    // ── macOS / Linux 路径：委托给 start.sh ──
-    const bashPath = process.env.SHELL || "/bin/bash";
-    const shell = path.basename(bashPath);
-    const shellArgs = shell === "bash" ? [] : ["-l"]; // zsh 需要 -l 加载 profile
-
-    const startSh = path.join(pkgDir, "start.sh");
-    if (!fs.existsSync(startSh)) {
-      console.error("\x1b[31m[✗]\x1b[0m 找不到 start.sh");
-      process.exit(1);
-    }
+    console.log(`\x1b[36m启动...\x1b[0m`);
+  }
 
-    const child = spawn(bashPath, [...shellArgs, startSh, ...userArgs], {
-      cwd: pkgDir,
-      stdio: "inherit",
-      env: { ...process.env },
-    });
+  // 使用 venv 的 Python 启动
+  const child = spawn(venvPython, pyArgs, {
+    cwd: pkgDir,
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      // 设置 VIRTUAL_ENV 环境变量，让 Python 程序知道自己运行在 venv 中
+      VIRTUAL_ENV: venvDir,
+      PATH: IS_WIN
+        ? `${path.join(venvDir, "Scripts")};${process.env.PATH}`
+        : `${path.join(venvDir, "bin")}:${process.env.PATH}`,
+    },
+  });
 
-    child.on("error", (err) => {
-      console.error(`\x1b[31m[✗]\x1b[0m 启动失败: ${err.message}`);
-      process.exit(1);
-    });
+  child.on("error", (err) => {
+    console.error(`\x1b[31m[✗]\x1b[0m 启动失败: ${err.message}`);
+    process.exit(1);
+  });
 
-    child.on("exit", (code) => {
-      process.exit(code || 0);
-    });
-  }
+  child.on("exit", (code) => {
+    process.exit(code || 0);
+  });
 }
 
 main();

package/start.sh

@@ -1,20 +1,32 @@
 #!/bin/bash
 # MyAgent Unix/macOS 启动脚本
-# 用法: ./start.sh [cli|web|tray|server|setup]
+# 用法: ./start.sh [cli|web|tray|server|setup|reinstall]
 # 支持 npm 全局安装后从任意目录运行
+#
+# 所有依赖安装到独立虚拟环境 ~/.myagent/venv
 
 set -euo pipefail
 
+# ── 颜色 ────────────────────────────────────────────
+BOLD='\033[1m'
+ACCENT='\033[36m'
+INFO='\033[90m'
+SUCCESS='\033[32m'
+WARN='\033[33m'
+ERROR='\033[31m'
+NC='\033[0m'
+
+info()    { echo -e "${INFO}[i]${NC} $*"; }
+success() { echo -e "${SUCCESS}[✓]${NC} $*"; }
+warn()    { echo -e "${WARN}[!]${NC} $*"; }
+err()     { echo -e "${ERROR}[✗]${NC} $*" >&2; }
+
 # ── 解析脚本真实路径（兼容 symlink） ─────────
-# npm 全局安装时 start.sh 会被 symlink 到 /usr/local/bin/myagent-ai
-# 需要解析 symlink 找到实际的包目录
 resolve_script_dir() {
     local src="${BASH_SOURCE[0]}"
-    # 循环解析所有 symlink
     while [ -L "$src" ]; do
         local dir="$(cd -P "$(dirname "$src")" && pwd)"
         src="$(readlink "$src")"
-        # 如果是相对路径，拼接上目录
         [[ "$src" != /* ]] && src="$dir/$src"
     done
     cd -P "$(dirname "$src")" && pwd
@@ -23,148 +35,111 @@ resolve_script_dir() {
 SCRIPT_DIR="$(resolve_script_dir)"
 PROJECT_DIR="$SCRIPT_DIR"
 
-# 如果 main.py 不在脚本目录（npm link 等场景），向上查找
 if [ ! -f "$PROJECT_DIR/main.py" ]; then
-    # 尝试 npm global prefix 方式
     NPM_PKG_DIR="$(npm root -g 2>/dev/null)/myagent-ai"
     if [ -f "$NPM_PKG_DIR/main.py" ]; then
         PROJECT_DIR="$NPM_PKG_DIR"
     else
-        echo -e "\033[31m[✗]\033[0m 错误: 找不到 main.py"
+        err "错误: 找不到 main.py"
         echo "  脚本目录: $SCRIPT_DIR"
         echo "  请确保从正确位置运行，或重新安装: npm install -g myagent-ai"
         exit 1
     fi
 fi
 
-BOLD='\033[1m'
-ACCENT='\033[36m'
-INFO='\033[90m'
-SUCCESS='\033[32m'
-WARN='\033[33m'
-ERROR='\033[31m'
-NC='\033[0m'
+# ── 虚拟环境 ────────────────────────────────────────
+VENV_DIR="$HOME/.myagent/venv"
+VENV_PY="$VENV_DIR/bin/python"
+VENV_PIP="$VENV_DIR/bin/pip"
+MYAGENT_DIR="$HOME/.myagent"
 
-info()    { echo -e "${INFO}[i]${NC} $*"; }
-success() { echo -e "${SUCCESS}[✓]${NC} $*"; }
-warn()    { echo -e "${WARN}[!]${NC} $*"; }
-err()     { echo -e "${ERROR}[✗]${NC} $*" >&2; }
-
-echo ""
-echo -e "  ${BOLD}MyAgent${NC} - 本地桌面端执行型 AI 助手"
-echo ""
-
-# ── 获取 Python 命令 ───────────────────────────────
-get_python() {
-  hash -r 2>/dev/null || true
-  if command -v python3 &>/dev/null; then
-    echo "python3"
-  elif command -v python &>/dev/null; then
-    echo "python"
-  else
+# 查找系统 Python
+find_system_python() {
+    hash -r 2>/dev/null || true
+    for cmd in python3 python3.14 python3.13 python3.12 python; do
+        if command -v "$cmd" &>/dev/null; then
+            local ver
+            ver="$($cmd -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")' 2>/dev/null)" || continue
+            local major minor
+            major="$(echo "$ver" | cut -d. -f1)"
+            minor="$(echo "$ver" | cut -d. -f2)"
+            if [ "$major" -ge 3 ] && [ "$minor" -ge 10 ]; then
+                echo "$cmd"
+                return 0
+            fi
+        fi
+    done
     echo ""
-  fi
 }
 
-PY="$(get_python)"
-if [ -z "$PY" ]; then
-    err "未找到 Python，请先安装 Python 3.10+"
-    echo "  macOS:  brew install python@3.12"
-    echo "  Linux:  sudo apt install python3.12 python3-pip"
-    echo "  Windows: https://www.python.org/downloads/"
-    echo ""
-    echo "  一键安装: curl -fsSL https://raw.githubusercontent.com/ctz168/myagent/main/install/install.sh | bash"
-    exit 1
-fi
+# 确保虚拟环境存在
+ensure_venv() {
+    # 检查现有 venv
+    if [ -f "$VENV_PY" ]; then
+        if "$VENV_PY" --version &>/dev/null; then
+            return 0
+        fi
+        # venv 损坏，重建
+        warn "虚拟环境已损坏，正在重建..."
+        rm -rf "$VENV_DIR"
+    fi
 
-# ── 检查 Python 版本 ─────────────────────────────
-check_python_version() {
-    local ver major minor
-    ver="$($PY -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")')"
-    major="$(echo "$ver" | cut -d. -f1)"
-    minor="$(echo "$ver" | cut -d. -f2)"
-    if [ "$major" -lt 3 ] || { [ "$major" -eq 3 ] && [ "$minor" -lt 10 ]; }; then
-        err "Python $ver detected, but 3.10+ is required"
+    # 需要创建
+    local sys_py
+    sys_py="$(find_system_python)"
+    if [ -z "$sys_py" ]; then
+        err "未找到 Python 3.10+"
+        echo "  macOS:  brew install python@3.14"
+        echo "  Linux:  sudo apt install python3.14 python3-pip"
+        echo ""
+        echo "  一键安装: curl -fsSL https://raw.githubusercontent.com/ctz168/myagent/main/install/install.sh | bash"
         exit 1
     fi
-    success "Python $ver"
-}
-check_python_version
-
-# ── pip install (处理 PEP668) ──────────────────────
-pip_install() {
-    local req_file="$1"
-    $PY -m pip install -r "$req_file" --break-system-packages 2>/dev/null || \
-    $PY -m pip install -r "$req_file" 2>/dev/null || \
-    {
-        warn "pip install 失败 (可能受 PEP668 限制)"
-        info "尝试使用 venv 安装..."
-        local venv_dir="$HOME/.myagent/venv"
-        $PY -m venv "$venv_dir" 2>/dev/null
-        if [ -f "$venv_dir/bin/pip" ]; then
-            "$venv_dir/bin/pip" install -r "$req_file"
-            success "已安装到虚拟环境 $venv_dir"
-            info "启动时请使用: $venv_dir/bin/python main.py --web"
-            return 0
-        fi
-        err "所有安装方式均失败"
-        info "请手动安装: pip3 install -r $req_file --break-system-packages"
-        info "或使用虚拟环境: python3 -m venv venv && source venv/bin/activate && pip install -r $req_file"
-        return 1
-    }
+
+    mkdir -p "$MYAGENT_DIR"
+    echo -e "  ${ACCENT}[*]${NC} 创建独立虚拟环境..."
+    info "位置: $VENV_DIR"
+    info "系统Python: $sys_py"
+    "$sys_py" -m venv "$VENV_DIR"
+    success "虚拟环境已创建"
 }
 
-# ── 检查核心依赖 ─────────────────────────────────
-check_deps() {
-    # 刷新命令缓存
-    hash -r 2>/dev/null || true
+# 检查并安装依赖
+install_deps() {
     local missing=0
+    local req_file="$PROJECT_DIR/requirements.txt"
+
+    echo -e "  ${ACCENT}[*]${NC} 检查依赖..."
 
-    # 必需依赖
     for mod in openai aiohttp requests; do
-        if $PY -c "import $mod" 2>/dev/null; then
-            success "$mod"
+        if "$VENV_PY" -c "import $mod" 2>/dev/null; then
+            success "  $mod"
         else
-            warn "$mod 未安装"
+            warn "  $mod"
             missing=1
         fi
     done
 
-    # 内置技能依赖（缺一不可，启动时自动安装）
-    for mod in duckduckgo_search bs4 psutil playwright mss pynput; do
-        if $PY -c "import $mod" 2>/dev/null; then
-            success "$mod"
-        else
-            warn "$mod 未安装"
-            missing=1
-        fi
-    done
+    if [ "$missing" -eq 0 ]; then
+        return 0
+    fi
 
-    # 可选依赖（不阻断启动）
-    for mod in pygetwindow PIL edge_tts pystray; do
-        if $PY -c "import $mod" 2>/dev/null; then
-            success "$mod"
-        else
-            info "$mod 未安装（可选，不影响核心功能）"
-        fi
-    done
+    # 升级 pip
+    echo -e "  ${INFO}[i]${NC} 升级 pip..."
+    "$VENV_PY" -m pip install --upgrade pip --quiet 2>/dev/null || true
 
-    if [ "$missing" -eq 1 ]; then
-        echo ""
-        warn "部分核心依赖缺失，正在自动安装..."
-        local req_file=""
-        # 优先查找项目目录 requirements.txt
-        if [ -f "$PROJECT_DIR/requirements.txt" ]; then
-            req_file="$PROJECT_DIR/requirements.txt"
-        elif [ -f "requirements.txt" ]; then
-            req_file="requirements.txt"
-        fi
-        if [ -n "$req_file" ]; then
-            pip_install "$req_file" || warn "依赖安装失败，请手动处理"
-        else
-            warn "未找到 requirements.txt，请手动安装依赖"
-        fi
-        echo ""
+    if [ -f "$req_file" ]; then
+        echo -e "  ${WARN}[!]${NC} 正在安装缺失依赖到虚拟环境..."
+        "$VENV_PY" -m pip install -r "$req_file" --disable-pip-version-check
+        success "依赖安装完成"
+    else
+        warn "未找到 requirements.txt"
+        # fallback: 直接安装核心包
+        "$VENV_PY" -m pip install --quiet \
+            "openai>=1.12.0" "aiohttp>=3.9.0" "requests>=2.31.0" \
+            "duckduckgo-search>=6.0.0" "beautifulsoup4>=4.12.0" \
+            "lxml>=5.0.0" "psutil>=5.9.0" --disable-pip-version-check 2>/dev/null || true
+        success "核心依赖安装完成"
     fi
 }
 
@@ -183,6 +158,9 @@ check_first_run() {
 MODE="${1:-}"
 
 if [ -z "$MODE" ]; then
+    echo ""
+    echo -e "  ${BOLD}MyAgent${NC} - 本地桌面端执行型 AI 助手"
+    echo ""
     echo "选择运行模式:"
     echo "  1) CLI 交互模式"
     echo "  2) Web 管理后台 (推荐, 端口 8767)"
@@ -201,42 +179,62 @@ if [ -z "$MODE" ]; then
     esac
 fi
 
-# 切换到项目目录（确保 main.py 的相对路径正确）
 cd "$PROJECT_DIR"
 
+# 特殊命令: reinstall
+if [ "$MODE" = "reinstall" ]; then
+    if [ -d "$VENV_DIR" ]; then
+        echo -e "  ${ACCENT}[*]${NC} 删除旧虚拟环境..."
+        rm -rf "$VENV_DIR"
+    fi
+    ensure_venv
+    install_deps
+    echo ""
+    success "依赖已全部重新安装到虚拟环境"
+    info "虚拟环境: $VENV_DIR"
+    echo ""
+    exit 0
+fi
+
+# ── 主流程 ─────────────────────────────────────────
+echo ""
+echo -e "  ${BOLD}${ACCENT}MyAgent${NC} - 本地桌面端执行型 AI 助手"
+echo ""
+
+ensure_venv
+install_deps
+check_first_run
+
+info "虚拟环境: $VENV_DIR"
+info "Python: $VENV_PY"
+echo ""
+
 case "$MODE" in
     cli)
-        check_deps
-        check_first_run
         echo -e "${ACCENT}启动 CLI 模式...${NC}"
-        exec $PY main.py
+        exec "$VENV_PY" main.py
         ;;
     web)
-        check_deps
-        check_first_run
         echo -e "${ACCENT}启动 Web 管理后台 (http://localhost:8767)...${NC}"
         echo -e "${INFO}按 Ctrl+C 停止${NC}"
         echo ""
-        exec $PY main.py --web
+        exec "$VENV_PY" main.py --web
         ;;
     tray)
-        check_deps
-        check_first_run
         echo -e "${ACCENT}启动系统托盘模式...${NC}"
-        exec $PY main.py --tray
+        exec "$VENV_PY" main.py --tray
         ;;
     server)
-        check_deps
         echo -e "${ACCENT}启动纯 API 服务...${NC}"
-        exec $PY main.py --server
+        exec "$VENV_PY" main.py --server
         ;;
     setup)
         echo -e "${ACCENT}启动配置向导...${NC}"
-        exec $PY main.py --setup
+        exec "$VENV_PY" main.py --setup
         ;;
     *)
         err "未知模式: $MODE"
-        echo "可用模式: cli | web | tray | server | setup"
+        echo "可用模式: cli | web | tray | server | setup | reinstall"
         exit 1
         ;;
 esac