myagent-ai 1.1.0 → 1.2.0

package/install/install.ps1

@@ -8,6 +8,8 @@ param(
 )
 
 $ErrorActionPreference = "Stop"
+$PKG_NAME = "myagent-ai"
+$PKG_VERSION = "1.1.0"
 
 # Allow running scripts for the current process
 if ($PSVersionTable.PSVersion.Major -ge 5) {
@@ -15,11 +17,11 @@ if ($PSVersionTable.PSVersion.Major -ge 5) {
 }
 
 Write-Host ""
-Write-Host "  MyAgent Installer" -ForegroundColor Cyan
+Write-Host "  MyAgent Installer v$PKG_VERSION" -ForegroundColor Cyan
 Write-Host ""
 
 if ($PSVersionTable.PSVersion.Major -lt 5) {
-    Write-Host "[ERR] PowerShell 5+ required" -ForegroundColor Red
+    Write-Host "[x] PowerShell 5+ required" -ForegroundColor Red
     exit 1
 }
 
@@ -78,7 +80,8 @@ function Install-Python {
         if (Test-Path $pyExe) { Remove-Item -Force $pyExe -ErrorAction SilentlyContinue }
     }
 
-    Write-Host "[ERR] Failed to install Python. Please install Python 3.10+ manually from https://www.python.org/downloads/" -ForegroundColor Red
+    Write-Host "[x] Failed to install Python." -ForegroundColor Red
+    Write-Host "  Please install Python 3.10+ manually: https://www.python.org/downloads/" -ForegroundColor Gray
     exit 1
 }
 
@@ -133,46 +136,71 @@ function Install-Node {
         if (Test-Path $nodeMsi) { Remove-Item -Force $nodeMsi -ErrorAction SilentlyContinue }
     }
 
-    Write-Host "[ERR] Failed to install Node.js. Please install Node.js 18+ manually from https://nodejs.org/" -ForegroundColor Red
+    Write-Host "[x] Failed to install Node.js." -ForegroundColor Red
+    Write-Host "  Please install Node.js 18+ manually: https://nodejs.org/" -ForegroundColor Gray
     exit 1
 }
 
 # ── Install MyAgent via npm ──────────────────────────────
 function Install-MyAgent {
-    Write-Host "[*] Installing myagent-ai ..." -ForegroundColor Yellow
-    npm install -g myagent-ai
+    Write-Host "[*] Installing $PKG_NAME ..." -ForegroundColor Yellow
+    npm install -g $PKG_NAME
     if ($LASTEXITCODE -ne 0) {
-        Write-Host "[ERR] npm install failed" -ForegroundColor Red
-        exit 1
+        Write-Host "[!] npm install failed, trying with admin..." -ForegroundColor Yellow
+        Start-Process npm -ArgumentList "install", "-g", $PKG_NAME -Verb RunAs -Wait
+        if ($LASTEXITCODE -ne 0) {
+            Write-Host "[x] npm install failed" -ForegroundColor Red
+            exit 1
+        }
     }
-    Write-Host "[OK] myagent-ai installed" -ForegroundColor Green
+    Write-Host "[OK] $PKG_NAME installed" -ForegroundColor Green
 }
 
 # ── Install Python dependencies ─────────────────────────
 function Install-PythonDeps {
-    # Find where npm installed myagent-ai
     $npmRoot = (npm root -g 2>$null)
-    $pkgDir = Join-Path $npmRoot "myagent-ai"
+    $pkgDir = Join-Path $npmRoot $PKG_NAME
     $reqFile = Join-Path $pkgDir "requirements.txt"
 
     if (-not (Test-Path $reqFile)) {
-        Write-Host "[!] requirements.txt not found at $pkgDir, skipping pip install" -ForegroundColor Yellow
-        return
+        if (Test-Path ".\requirements.txt") {
+            $reqFile = ".\requirements.txt"
+        } else {
+            Write-Host "[!] requirements.txt not found, skipping pip install" -ForegroundColor Yellow
+            return
+        }
     }
 
     Write-Host "[*] Installing Python dependencies ..." -ForegroundColor Yellow
     pip install -r $reqFile
     if ($LASTEXITCODE -ne 0) {
-        Write-Host "[!] Some Python deps failed to install (non-critical, check above)" -ForegroundColor Yellow
+        Write-Host "[!] Some deps failed (non-critical). Try: pip install -r $reqFile" -ForegroundColor Yellow
     } else {
         Write-Host "[OK] Python dependencies installed" -ForegroundColor Green
     }
 }
 
+# ── Post-install guide ──────────────────────────────
+function Show-Guide {
+    Write-Host ""
+    Write-Host "  Installation complete!" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "  Quick start:" -ForegroundColor White
+    Write-Host "    myagent-ai          # Interactive mode selection" -ForegroundColor Cyan
+    Write-Host "    myagent-ai web      # Web dashboard (recommended)" -ForegroundColor Cyan
+    Write-Host "    myagent-ai cli      # CLI mode" -ForegroundColor Cyan
+    Write-Host ""
+    Write-Host "  First run:" -ForegroundColor White
+    Write-Host "    1. Configure LLM API Key (OpenAI / Anthropic / ModelScope / Ollama)" -ForegroundColor Gray
+    Write-Host "    2. Open http://localhost:8767" -ForegroundColor Gray
+    Write-Host ""
+    Write-Host "  Docs: https://github.com/ctz168/myagent" -ForegroundColor Gray
+    Write-Host ""
+}
+
 # ── Main ─────────────────────────────────────────────────
 if ($DryRun) {
     Write-Host "[OK] Dry run" -ForegroundColor Green
-    Write-Host "  Install deps: $(if ($NoDeps) { 'no' } else { 'yes' })" -ForegroundColor Gray
     exit 0
 }
 
@@ -190,6 +218,4 @@ if (-not $NoDeps) {
     Install-PythonDeps
 }
 
-Write-Host ""
-Write-Host "  Done! Run 'myagent-ai' to start." -ForegroundColor Green
-Write-Host ""
+Show-Guide

package/install/install.sh

@@ -2,8 +2,12 @@
 set -euo pipefail
 
 # MyAgent Installer for macOS and Linux
-# Usage: curl -fsSL https://raw.githubusercontent.com/ctz168/myagent/main/install/install.sh | bash
-#        curl -fsSL https://raw.githubusercontent.com/ctz168/myagent/main/install/install.sh | bash -s -- --no-deps
+# 一键安装脚本
+#
+# 用法:
+#   curl -fsSL https://raw.githubusercontent.com/ctz168/myagent/main/install/install.sh | bash
+#   curl -fsSL ... | bash -s -- --no-deps     # 跳过依赖检查
+#   curl -fsSL ... | bash -s -- --dry-run     # 预览模式
 
 BOLD='\033[1m'
 ACCENT='\033[36m'
@@ -16,19 +20,23 @@ NC='\033[0m'
 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.1.0"
 
 for arg in "$@"; do
   case "$arg" in
     --no-deps) NO_DEPS=true ;;
     --dry-run) DRY_RUN=true ;;
     --help|-h)
-      echo "MyAgent Installer"
+      echo "MyAgent Installer v$PKG_VERSION"
       echo ""
       echo "Usage: curl -fsSL $SCRIPT_URL | bash [-s -- OPTIONS]"
       echo ""
       echo "Options:"
-      echo "  --no-deps    Skip Python/Node.js dependency check"
-      echo "  --dry-run    Show what would be done"
+      echo "  --no-deps    跳过 Python/Node.js 依赖检查"
+      echo "  --dry-run    预览安装过程，不实际执行"
+      echo ""
+      echo "安装完成后运行 myagent-ai 启动"
       exit 0
       ;;
     *) echo "Unknown option: $arg (use --help)"; exit 2 ;;
@@ -36,9 +44,9 @@ for arg in "$@"; do
 done
 
 info()    { echo -e "${INFO}[i]${NC} $*"; }
-success() { echo -e "${SUCCESS}[OK]${NC} $*"; }
+success() { echo -e "${SUCCESS}[✓]${NC} $*"; }
 warn()    { echo -e "${WARN}[!]${NC} $*"; }
-err()     { echo -e "${ERROR}[ERR]${NC} $*" >&2; }
+err()     { echo -e "${ERROR}[✗]${NC} $*" >&2; }
 step()    { echo -e "${ACCENT}[*]${NC} $*"; }
 
 # ── detect OS ─────────────────────────────────────────────
@@ -53,11 +61,14 @@ detect_os() {
 }
 
 OS="$(detect_os)"
-echo -e "\n  ${BOLD}MyAgent Installer${NC}\n"
+echo ""
+echo -e "  ${BOLD}${ACCENT}MyAgent${NC} Installer v$PKG_VERSION"
+echo ""
 success "$OS detected"
 
 if $DRY_RUN; then
-  success "Dry run"
+  success "Dry run mode"
+  info "Will: check deps -> npm install -g $PKG_NAME -> pip install requirements"
   exit 0
 fi
 
@@ -76,7 +87,7 @@ check_python() {
   major="$(echo "$ver" | cut -d. -f1)"
   minor="$(echo "$ver" | cut -d. -f2)"
   if [ "$major" -ge 3 ] && [ "$minor" -ge 10 ]; then
-    success "Python $ver found"
+    success "Python $ver"
     return 0
   fi
   warn "Python $ver found, but 3.10+ required"
@@ -93,7 +104,6 @@ install_python() {
       export PATH="$(brew --prefix python@3.12)/bin:$PATH"
       if check_python; then return 0; fi
     fi
-    # Fallback: official installer
     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"
     sudo installer -pkg /tmp/python.pkg -target /
@@ -128,6 +138,8 @@ install_python() {
   fi
 
   err "Failed to install Python. Please install Python 3.10+ manually."
+  info "  macOS:  https://www.python.org/downloads/"
+  info "  Linux:   https://wiki.python.org/moin/BeginnersGuide/Download"
   exit 1
 }
 
@@ -137,7 +149,7 @@ check_node() {
   local major
   major="$(node -v | sed 's/v\([0-9]\+\).*/\1/')"
   if [ "$major" -ge 18 ] 2>/dev/null; then
-    success "Node.js $(node -v) found"
+    success "Node.js $(node -v)"
     return 0
   fi
   warn "Node.js $(node -v) found, but v18+ required"
@@ -156,7 +168,7 @@ install_node() {
     fi
   fi
 
-  # Try fnm (Fast Node Manager)
+  # Try fnm
   if command -v fnm &>/dev/null; then
     info "Using fnm ..."
     fnm install 20
@@ -172,7 +184,7 @@ install_node() {
     if check_node; then return 0; fi
   fi
 
-  # Fallback: official NodeSource
+  # Fallback: NodeSource
   if [ "$OS" = "linux" ]; then
     if command -v apt-get &>/dev/null; then
       info "Using NodeSource ..."
@@ -187,7 +199,7 @@ install_node() {
     fi
   fi
 
-  # Final fallback: install fnm + node
+  # Final fallback: install fnm
   if ! command -v fnm &>/dev/null; then
     info "Installing fnm ..."
     curl -fsSL https://fnm.vercel.app/install | bash
@@ -197,37 +209,90 @@ install_node() {
   fnm install 20
   if check_node; then return 0; fi
 
-  err "Failed to install Node.js. Please install Node.js 18+ manually from https://nodejs.org/"
+  err "Failed to install Node.js. Please install Node.js 18+ manually."
+  info "  https://nodejs.org/"
   exit 1
 }
 
+# ── pip install (处理 PEP668) ──────────────────────
+pip_install() {
+  local req_file="$1"
+  # 尝试多种方式安装，兼容 PEP668 限制
+  pip3 install -r "$req_file" --break-system-packages 2>/dev/null || \
+  pip3 install -r "$req_file" 2>/dev/null || \
+  pip install -r "$req_file" --break-system-packages 2>/dev/null || \
+  pip install -r "$req_file" 2>/dev/null || \
+  {
+    warn "pip install 失败 (可能受 PEP668 限制)"
+    info "尝试使用 venv 安装..."
+    local venv_dir="$HOME/.myagent/venv"
+    python3 -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
+  }
+}
+
 # ── Install MyAgent via npm ──────────────────────────────
 install_myagent() {
-  step "Installing myagent-ai ..."
-  npm install -g myagent-ai
-  success "myagent-ai installed"
+  step "Installing $PKG_NAME ..."
+  npm install -g "$PKG_NAME"
+  if [ $? -ne 0 ]; then
+    err "npm install failed"
+    info "可能需要 sudo: sudo npm install -g $PKG_NAME"
+    exit 1
+  fi
+  success "$PKG_NAME installed"
 }
 
 # ── Install Python dependencies ─────────────────────────
 install_python_deps() {
   local pkg_dir
-  pkg_dir="$(npm root -g)/myagent-ai"
+  pkg_dir="$(npm root -g)/$PKG_NAME"
   local req_file="$pkg_dir/requirements.txt"
 
   if [ ! -f "$req_file" ]; then
-    warn "requirements.txt not found at $pkg_dir, skipping pip install"
-    return
+    # 尝试从项目目录查找
+    if [ -f "./requirements.txt" ]; then
+      req_file="./requirements.txt"
+    else
+      warn "requirements.txt not found, skipping pip install"
+      return
+    fi
   fi
 
   step "Installing Python dependencies ..."
-  local py_cmd="pip3"
-  if ! command -v pip3 &>/dev/null; then
-    py_cmd="pip"
-  fi
-  $py_cmd install -r "$req_file" || warn "Some Python deps failed to install (non-critical)"
+  pip_install "$req_file"
   success "Python dependencies installed"
 }
 
+# ── 首次配置引导 ───────────────────────────────────
+post_install() {
+  echo ""
+  echo -e "  ${BOLD}${SUCCESS}安装完成！${NC}"
+  echo ""
+  echo "  快速开始："
+  echo -e "    ${ACCENT}myagent-ai${NC}         # 交互式选择运行模式"
+  echo -e "    ${ACCENT}myagent-ai web${NC}     # 直接启动 Web 管理后台 (推荐)"
+  echo -e "    ${ACCENT}myagent-ai cli${NC}     # CLI 交互模式"
+  echo -e "    ${ACCENT}myagent-ai tray${NC}    # 系统托盘模式"
+  echo ""
+  echo "  首次运行需要配置："
+  echo "    1. LLM API Key (支持 OpenAI / Anthropic / ModelScope / Ollama 等)"
+  echo "    2. 访问 http://localhost:8767 进入 Web 管理界面"
+  echo ""
+  echo "  文档: https://github.com/ctz168/myagent#readme"
+  echo "  问题: https://github.com/ctz168/myagent/issues"
+  echo ""
+}
+
 # ── Main ─────────────────────────────────────────────────
 if ! $NO_DEPS; then
   check_python || install_python
@@ -240,6 +305,4 @@ if ! $NO_DEPS; then
   install_python_deps
 fi
 
-echo ""
-success "Done! Run 'myagent-ai' to start."
-echo ""
+post_install

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "myagent-ai",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
+  "bin": {
+    "myagent-ai": "start.sh"
+  },
   "scripts": {
     "start": "python main.py",
+    "start:web": "python main.py --web",
     "start:tray": "python main.py --tray",
     "start:server": "python main.py --server",
     "install:deps": "pip install -r requirements.txt",
@@ -19,9 +23,11 @@
     "chatbot",
     "telegram",
     "discord",
+    "feishu",
     "multi-agent",
     "memory",
-    "code-execution"
+    "code-execution",
+    "mcp"
   ],
   "author": "ctz168",
   "license": "MIT",
@@ -34,7 +40,8 @@
   },
   "homepage": "https://github.com/ctz168/myagent#readme",
   "engines": {
-    "python": ">=3.10"
+    "python": ">=3.10",
+    "node": ">=18"
   },
   "files": [
     "main.py",

package/requirements.txt

@@ -4,8 +4,15 @@
 # ============================================================
 # 核心依赖 (必需)
 # ============================================================
-openai>=1.12.0                  # OpenAI GPT 系列
-aiohttp>=3.9.0                  # 异步 HTTP 客户端 (聊天平台接入)
+openai>=1.12.0                  # OpenAI GPT 系列 + 兼容API
+aiohttp>=3.9.0                  # 异步 HTTP (聊天平台接入 + Web服务器)
+requests>=2.31.0                # HTTP 请求 (LLM备用、更新检查)
+
+# ============================================================
+# Web 管理后台
+# ============================================================
+# Web 服务器使用 aiohttp，无额外依赖
+# aiohttp 已在核心依赖中
 
 # ============================================================
 # 记忆系统
@@ -22,10 +29,11 @@ aiohttp>=3.9.0                  # 异步 HTTP 客户端 (聊天平台接入)
 # ============================================================
 duckduckgo-search>=6.0.0        # 网络搜索 (无需 API Key)
 beautifulsoup4>=4.12.0          # HTML 解析
+lxml>=5.0.0                     # HTML/XML 高性能解析
 psutil>=5.9.0                   # 系统信息
 
 # ============================================================
-# 系统托盘
+# 系统托盘 (可选, --tray 模式)
 # ============================================================
 pystray>=0.19.5                 # 系统托盘图标
 Pillow>=10.0.0                  # 图标生成
@@ -33,8 +41,8 @@ Pillow>=10.0.0                  # 图标生成
 # ============================================================
 # 聊天平台 (按需安装)
 # ============================================================
-python-telegram-bot>=21.0       # Telegram
-discord.py>=2.3.0               # Discord
+python-telegram-bot>=21.0       # Telegram Bot
+discord.py>=2.3.0               # Discord Bot
 # 飞书/QQ/微信 通过 aiohttp 实现，无需额外安装
 
 # ============================================================
@@ -53,12 +61,12 @@ playwright>=1.41.0              # 浏览器自动化
 anthropic>=0.18.0               # Claude 系列
 
 # ============================================================
-# 打包 (可选)
+# 打包 (可选, 仅开发用)
 # ============================================================
-pyinstaller>=6.0.0              # 打包为 exe
+pyinstaller>=6.0.0              # 打包为 exe/app
 
 # ============================================================
 # Agent 间通信 (可选)
 # ============================================================
 cryptography>=41.0.0            # Ed25519, X25519, AES-256-GCM
-websockets>=12.0                # 异步 WebSocket 客户端 (远程通信)
+websockets>=12.0                # 异步 WebSocket (远程通信)

package/setup.py

@@ -9,23 +9,27 @@ 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.0.0")
+__version__ = _version_vars.get("BASE_VERSION", "1.1.0")
 
 setup(
     name="myagent",
     version=__version__,
     description="本地桌面端执行型AI助手 - Open Interpreter 风格",
-    author="MyAgent",
+    author="ctz168",
+    url="https://github.com/ctz168/myagent",
     python_requires=">=3.10",
-    packages=find_packages(exclude=["logs", "data", "*.pyc"]),
+    packages=find_packages(exclude=["logs", "data", "*.pyc", "tests", "docs", "download"]),
     install_requires=[
         "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",
         "pystray>=0.19.5",
         "Pillow>=10.0.0",
+        "edge-tts>=6.1.0",
     ],
     extras_require={
         "telegram": ["python-telegram-bot>=21.0"],

package/start.sh

@@ -1,36 +1,172 @@
 #!/bin/bash
 # MyAgent Unix/macOS 启动脚本
+# 用法: ./start.sh [cli|web|tray|server|setup]
 
-echo "========================================"
-echo "  MyAgent - 本地桌面端执行型 AI 助手"
-echo "========================================"
+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; }
+
+echo ""
+echo -e "  ${BOLD}MyAgent${NC} - 本地桌面端执行型 AI 助手"
 echo ""
 
-# 检查 Python
-if ! command -v python3 &> /dev/null; then
-    echo "[错误] 未找到 Python3，请先安装 Python 3.8+"
+# ── 获取 Python 命令 ───────────────────────────────
+get_python() {
+    if command -v python3 &>/dev/null; then
+        echo "python3"
+    elif command -v python &>/dev/null; then
+        echo "python"
+    else
+        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/"
     exit 1
 fi
 
-# 检查依赖
-if ! python3 -c "import openai" &> /dev/null; then
-    echo "[提示] 正在安装依赖..."
-    pip3 install -r requirements.txt
+# ── 检查 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"
+        exit 1
+    fi
+    success "Python $ver"
+}
+check_python_version
+
+# ── 检查核心依赖 ─────────────────────────────────
+check_deps() {
+    local missing=0
+
+    # 必需依赖
+    for mod in openai aiohttp requests; do
+        if $PY -c "import $mod" 2>/dev/null; then
+            success "$mod"
+        else
+            warn "$mod 未安装"
+            missing=1
+        fi
+    done
+
+    # 可选依赖（不阻断启动）
+    for mod in duckduckgo_search bs4 psutil PIL edge_tts pystray; do
+        if $PY -c "import $mod" 2>/dev/null; then
+            success "$mod"
+        else
+            info "$mod 未安装（可选）"
+        fi
+    done
+
+    if [ "$missing" -eq 1 ]; then
+        echo ""
+        warn "部分核心依赖缺失，正在自动安装..."
+        local req_file=""
+        # 优先查找同目录 requirements.txt
+        if [ -f "$(dirname "$0")/requirements.txt" ]; then
+            req_file="$(dirname "$0")/requirements.txt"
+        elif [ -f "requirements.txt" ]; then
+            req_file="requirements.txt"
+        fi
+        if [ -n "$req_file" ]; then
+            pip3 install -r "$req_file" --break-system-packages 2>/dev/null || \
+            pip3 install -r "$req_file" 2>/dev/null || \
+            pip install -r "$req_file" --break-system-packages 2>/dev/null || \
+            pip install -r "$req_file" 2>/dev/null || \
+            warn "自动安装失败，请手动运行: pip3 install -r requirements.txt"
+        else
+            warn "未找到 requirements.txt，请手动安装依赖"
+        fi
+        echo ""
+    fi
+}
+
+# ── 首次运行检测 ─────────────────────────────────
+check_first_run() {
+    if [ ! -f "$HOME/.myagent/config.json" ]; then
+        echo ""
+        info "检测到首次运行，MyAgent 将在启动后引导你完成配置。"
+        echo "  1. 配置 LLM API Key（支持 OpenAI/Anthropic/ModelScope 等）"
+        echo "  2. 选择默认运行模式"
+        echo ""
+    fi
+}
+
+# ── 确定运行模式 ─────────────────────────────────
+MODE="${1:-}"
+
+if [ -z "$MODE" ]; then
+    echo "选择运行模式:"
+    echo "  1) CLI 交互模式"
+    echo "  2) Web 管理后台 (推荐, 端口 8767)"
+    echo "  3) 系统托盘模式"
+    echo "  4) 纯 API 服务模式"
+    echo "  5) 首次配置向导"
+    echo ""
+    read -rp "请输入 (1-5) [2]: " MODE
+    case "$MODE" in
+        1) MODE="cli" ;;
+        2|'') MODE="web" ;;
+        3) MODE="tray" ;;
+        4) MODE="server" ;;
+        5) MODE="setup" ;;
+        *) MODE="web" ;;
+    esac
 fi
 
-echo ""
-echo "选择运行模式:"
-echo "  1. CLI 交互模式"
-echo "  2. 系统托盘模式 (推荐)"
-echo "  3. Web 管理后台模式"
-echo "  4. 设置开机自启"
-echo ""
-read -p "请输入 (1/2/3/4): " mode
-
-case $mode in
-    1) python3 main.py ;;
-    2) python3 main.py --tray ;;
-    3) python3 main.py --web ;;
-    4) python3 main.py --autostart ;;
-    *) echo "无效选择" ;;
+case "$MODE" in
+    cli)
+        check_deps
+        check_first_run
+        echo -e "${ACCENT}启动 CLI 模式...${NC}"
+        exec $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
+        ;;
+    tray)
+        check_deps
+        check_first_run
+        echo -e "${ACCENT}启动系统托盘模式...${NC}"
+        exec $PY main.py --tray
+        ;;
+    server)
+        check_deps
+        echo -e "${ACCENT}启动纯 API 服务...${NC}"
+        exec $PY main.py --server
+        ;;
+    setup)
+        echo -e "${ACCENT}启动配置向导...${NC}"
+        exec $PY main.py --setup
+        ;;
+    *)
+        err "未知模式: $MODE"
+        echo "可用模式: cli | web | tray | server | setup"
+        exit 1
+        ;;
 esac