myagent-ai 1.32.9 → 1.33.0

package/core/vnc_manager.py

@@ -228,6 +228,12 @@ class VNCManager:
                 "port": self.novnc_port,
                 "pid": self._websockify_process.pid if ws_alive else None,
             },
+            # [v1.33.0] 浏览器和窗口管理器信息
+            "browser": {
+                "available": bool(shutil.which("google-chrome") or shutil.which("chromium-browser") or shutil.which("chromium")),
+                "path": shutil.which("google-chrome") or shutil.which("chromium-browser") or shutil.which("chromium") or None,
+            },
+            "window_manager": self._wm_name,
             "novnc_url": f"/vnc/vnc.html?autoconnect=true&resize=scale" if running else None,
         }
 
@@ -246,6 +252,8 @@ class VNCManager:
     def ensure_dependencies(self) -> tuple:
         """检测并安装 VNC 所需依赖。
         
+        [v1.33.0] 增加 Chrome/Chromium 浏览器检测和窗口管理器依赖。
+        
         Returns:
             (success: bool, message: str)
         """
@@ -267,6 +275,22 @@ class VNCManager:
             missing.append("websockify")
             install_commands.append("websockify")
 
+        # [v1.33.0] 4. Chrome/Chromium 浏览器检测
+        _has_browser = (
+            shutil.which("google-chrome") or
+            shutil.which("chromium-browser") or
+            shutil.which("chromium")
+        )
+        if not _has_browser:
+            missing.append("Chrome/Chromium")
+            # 不加入 apt 自动安装列表（Chrome 安装较复杂，由安装脚本处理）
+
+        # [v1.33.0] 5. 窗口管理器检测
+        _has_wm = any(shutil.which(wm) for wm in ["fluxbox", "openbox", "xfce4-session", "icewm", "jwm", "twm"])
+        if not _has_wm:
+            missing.append("窗口管理器(fluxbox)")
+            install_commands.append("fluxbox")
+
         if not missing:
             return True, "所有 VNC 依赖已就绪"
 
@@ -276,7 +300,7 @@ class VNCManager:
         sudo = ["sudo"] if os.getuid() != 0 else []
 
         # 安装 apt 包
-        apt_packages = [p for p in install_commands if p in ("xvfb", "x11vnc")]
+        apt_packages = [p for p in install_commands if p in ("xvfb", "x11vnc", "fluxbox")]
         if apt_packages:
             try:
                 logger.info(f"apt install: {apt_packages}")
@@ -327,8 +351,21 @@ class VNCManager:
             if not shutil.which(cmd_name):
                 all_ok = False
 
+        # [v1.33.0] 检查浏览器和窗口管理器
+        _has_browser = shutil.which("google-chrome") or shutil.which("chromium-browser") or shutil.which("chromium")
+        _has_wm = any(shutil.which(wm) for wm in ["fluxbox", "openbox", "xfce4-session", "icewm", "jwm", "twm"])
+
+        warnings = []
+        if not _has_browser:
+            warnings.append("Chrome/Chromium 未安装（请运行 install/setup-termux-vnc.sh 安装）")
+        if not _has_wm:
+            warnings.append("窗口管理器未安装（VNC 将显示黑屏）")
+
         if all_ok:
-            return True, "VNC 依赖安装完成"
+            msg = "VNC 依赖安装完成"
+            if warnings:
+                msg += f"（警告: {'; '.join(warnings)}）"
+            return True, msg
         else:
             still_missing = [c for c in ["Xvfb", "x11vnc", "websockify"] if not shutil.which(c)]
             return False, f"部分依赖安装失败: {still_missing}"

package/install/setup-termux-vnc.sh

@@ -0,0 +1,516 @@
+#!/bin/bash
+set -euo pipefail
+
+# ══════════════════════════════════════════════════════════════════
+# MyAgent — Termux + Ubuntu 远程桌面一键安装脚本
+# ══════════════════════════════════════════════════════════════════
+#
+# 功能:
+#   1. 在 Termux proot-distro Ubuntu 中安装完整 GUI 桌面环境
+#   2. 安装 Chrome/Chromium 浏览器（ARM64 / AMD64 自动适配）
+#   3. 安装 VNC 远程桌面所需全部依赖 (Xvfb + x11vnc + websockify)
+#   4. 安装窗口管理器 (fluxbox) + 终端 (xterm)
+#   5. 安装中文字体和输入法支持
+#
+# 使用方法:
+#   在 Termux 中:
+#     proot-distro login ubuntu
+#     bash /path/to/setup-termux-vnc.sh
+#
+#   或一行命令:
+#     curl -fsSL https://raw.githubusercontent.com/ctz168/myagent/main/install/setup-termux-vnc.sh | bash
+#
+# 架构:
+#   Android Termux → proot-distro Ubuntu → Xvfb(:99) + x11vnc(5900)
+#                                            + websockify(6080) → noVNC
+#                                            + fluxbox + Chrome
+#
+# ══════════════════════════════════════════════════════════════════
+
+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; }
+step()    { echo -e "${ACCENT}[*]${NC} $*"; }
+banner()  { echo -e "\n${BOLD}${ACCENT}$*${NC}\n"; }
+
+# ── 检测是否在 Termux/proot 环境中 ──────────────────────────
+detect_environment() {
+  banner "检测运行环境..."
+
+  # 检测是否在 proot 环境中
+  IS_PROOT=false
+  if grep -qi 'proot' /proc/self/maps 2>/dev/null || \
+     grep -qi 'proot' /proc/version 2>/dev/null || \
+     [ -n "${PROOT_SERVICE:-}" ]; then
+    IS_PROOT=true
+    info "检测到 proot 环境 (Termux proot-distro)"
+  fi
+
+  # 检测架构
+  ARCH=$(dpkg --print-architecture 2>/dev/null || uname -m)
+  info "系统架构: $ARCH"
+
+  # 检测是否为 root
+  IS_ROOT=false
+  if [ "$(id -u)" -eq 0 ]; then
+    IS_ROOT=true
+    info "当前用户: root"
+  else
+    info "当前用户: $(whoami) (非 root，将使用 sudo)"
+  fi
+
+  # 检测 OS
+  if [ ! -f /etc/os-release ]; then
+    err "无法检测操作系统版本，此脚本仅支持 Ubuntu/Debian"
+    exit 1
+  fi
+  source /etc/os-release
+  info "操作系统: $PRETTY_NAME"
+
+  if [[ "$ID" != "ubuntu" && "$ID" != "debian" ]]; then
+    warn "此脚本主要针对 Ubuntu/Debian，当前系统 $ID 可能不兼容"
+  fi
+}
+
+# ── apt 封装 ────────────────────────────────────────────────
+apt_install() {
+  if $IS_ROOT; then
+    apt-get install -y --no-install-recommends "$@"
+  else
+    sudo apt-get install -y --no-install-recommends "$@"
+  fi
+}
+
+apt_update() {
+  if $IS_ROOT; then
+    apt-get update -qq 2>/dev/null || true
+  else
+    sudo apt-get update -qq 2>/dev/null || true
+  fi
+}
+
+# ── Step 1: 更新系统并安装基础依赖 ──────────────────────────
+install_base_deps() {
+  banner "Step 1/6: 安装基础依赖..."
+
+  step "更新 apt 源..."
+  apt_update
+
+  step "安装基础工具..."
+  apt_install \
+    wget curl gnupg2 ca-certificates \
+    software-properties-common \
+    apt-transport-https \
+    procps psmisc \
+    2>/dev/null || true
+
+  success "基础依赖安装完成"
+}
+
+# ── Step 2: 安装 X11 / VNC 远程桌面依赖 ────────────────────
+install_vnc_deps() {
+  banner "Step 2/6: 安装 X11 / VNC 远程桌面依赖..."
+
+  step "安装 Xvfb (虚拟显示服务器)..."
+  apt_install xvfb
+
+  step "安装 x11vnc (VNC 服务器)..."
+  apt_install x11vnc
+
+  step "安装 x11vnc 依赖库..."
+  apt_install \
+    python3-numpy libxtst6 libxext6 libxfixes3 \
+    libxrandr2 libxrender1 libxinerama1 libfontconfig1 \
+    2>/dev/null || true
+
+  step "安装 X11 工具..."
+  apt_install \
+    x11-xserver-utils xdotool xsetroot \
+    2>/dev/null || true
+
+  step "安装窗口管理器 (fluxbox) + 终端 (xterm)..."
+  apt_install fluxbox xterm 2>/dev/null || {
+    warn "fluxbox 安装失败，尝试 openbox..."
+    apt_install openbox 2>/dev/null || true
+  }
+
+  step "安装截图工具 (ffmpeg)..."
+  apt_install ffmpeg 2>/dev/null || {
+    warn "ffmpeg 安装失败，尝试 ImageMagick..."
+    apt_install imagemagick 2>/dev/null || true
+  }
+
+  step "安装 websockify (Python WebSocket 代理)..."
+  pip3 install websockify 2>/dev/null || pip install websockify 2>/dev/null || {
+    warn "pip 安装 websockify 失败，尝试 apt..."
+    apt_install websockify 2>/dev/null || true
+  }
+
+  # 验证关键组件
+  local missing=()
+  for cmd in Xvfb x11vnc; do
+    if ! command -v "$cmd" &>/dev/null; then
+      missing+=("$cmd")
+    fi
+  done
+  if ! command -v websockify &>/dev/null && ! python3 -c "import websockify" 2>/dev/null; then
+    missing+=("websockify")
+  fi
+
+  if [ ${#missing[@]} -gt 0 ]; then
+    err "VNC 关键组件安装失败: ${missing[*]}"
+    return 1
+  fi
+
+  success "VNC 依赖安装完成"
+}
+
+# ── Step 3: 安装 Chrome/Chromium 浏览器 ────────────────────
+install_chrome() {
+  banner "Step 3/6: 安装 Chrome/Chromium 浏览器..."
+
+  # 检查是否已安装
+  if command -v google-chrome &>/dev/null; then
+    success "Google Chrome 已安装: $(google-chrome --version 2>/dev/null)"
+    return 0
+  fi
+  if command -v chromium-browser &>/dev/null; then
+    success "Chromium 已安装: $(chromium-browser --version 2>/dev/null)"
+    return 0
+  fi
+  if command -v chromium &>/dev/null; then
+    success "Chromium 已安装: $(chromium --version 2>/dev/null)"
+    return 0
+  fi
+
+  # 安装 Chrome/Chromium 共享库依赖
+  step "安装 Chrome/Chromium 共享库依赖..."
+  apt_install \
+    libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 \
+    libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 \
+    libgbm1 libpango-1.0-0 libcairo2 libasound2 libatspi2.0-0 \
+    libxshmfence1 libx11-xcb1 libxcb-dri3-0 \
+    fonts-liberation xdg-utils \
+    2>/dev/null || true
+
+  # 根据架构选择安装方式
+  case "$ARCH" in
+    amd64|x86_64)
+      step "AMD64 架构: 尝试安装 Google Chrome..."
+      install_chrome_amd64
+      ;;
+    arm64|aarch64)
+      step "ARM64 架构: 安装 Chromium (Google Chrome 不支持 ARM64)..."
+      install_chrome_arm64
+      ;;
+    *)
+      warn "未知架构 $ARCH，尝试通用方式安装 Chromium..."
+      install_chromium_apt
+      ;;
+  esac
+
+  # 验证安装
+  if command -v google-chrome &>/dev/null; then
+    success "Google Chrome 安装成功: $(google-chrome --version 2>/dev/null)"
+  elif command -v chromium-browser &>/dev/null; then
+    success "Chromium 安装成功: $(chromium-browser --version 2>/dev/null)"
+  elif command -v chromium &>/dev/null; then
+    success "Chromium 安装成功: $(chromium --version 2>/dev/null)"
+  else
+    warn "Chrome/Chromium 标准安装失败，尝试 Puppeteer 内置 Chrome..."
+    install_chrome_puppeteer
+  fi
+}
+
+install_chrome_amd64() {
+  # 尝试 Google Chrome 官方源
+  step "添加 Google Chrome 官方 APT 源..."
+  if ! grep -q 'dl.google.com/linux/chrome' /etc/apt/sources.list 2>/dev/null && \
+     [ ! -f /etc/apt/sources.list.d/google-chrome.list ]; then
+    (
+      if $IS_ROOT; then
+        wget -qO- https://dl.google.com/linux/linux_signing_key.pub | apt-key add - 2>/dev/null || true
+        echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" \
+          > /etc/apt/sources.list.d/google-chrome.list
+      else
+        wget -qO- https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add - 2>/dev/null || true
+        echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" \
+          | sudo tee /etc/apt/sources.list.d/google-chrome.list > /dev/null
+      fi
+      apt_update
+    ) || warn "添加 Chrome 源失败"
+  fi
+
+  step "安装 google-chrome-stable..."
+  apt_install google-chrome-stable 2>/dev/null && return 0
+
+  # Chrome 安装失败，回退到 Chromium
+  warn "Google Chrome 安装失败，回退到 Chromium..."
+  install_chromium_apt
+}
+
+install_chrome_arm64() {
+  # ARM64 上 Google Chrome 不支持，使用 Chromium
+  step "ARM64: 安装 Chromium 浏览器..."
+
+  # Ubuntu 22.04+ 使用 snap 安装的 chromium，在 proot 下不工作
+  # 尝试使用 PPA 或直接安装 deb 包
+  apt_install chromium-browser 2>/dev/null && return 0
+  apt_install chromium 2>/dev/null && return 0
+
+  # 尝试从 Ubuntu ports 安装
+  step "尝试通过 apt 直接安装 chromium..."
+  apt_update
+  apt_install chromium-browser 2>/dev/null && return 0
+
+  # 尝试下载预编译的 Chromium (chromium-bsu 不行，要浏览器)
+  warn "apt 安装 Chromium 失败，尝试下载预编译版本..."
+
+  # 使用 snap 的 chromium 在 proot 下不工作
+  # 最佳方案: 使用 npx puppeteer 下载的 Chrome for Testing
+  step "通过 Puppeteer 下载 Chrome for Testing (ARM64)..."
+  if command -v npx &>/dev/null; then
+    npx puppeteer browsers install chrome@stable 2>/dev/null || true
+  fi
+
+  # 如果还是失败，尝试安装 firefox 作为备选
+  if ! command -v chromium &>/dev/null && ! command -v chromium-browser &>/dev/null; then
+    warn "Chromium 安装失败，安装 Firefox 作为备选浏览器..."
+    apt_install firefox 2>/dev/null || {
+      warn "Firefox 也安装失败"
+    }
+  fi
+}
+
+install_chromium_apt() {
+  step "通过 apt 安装 Chromium..."
+  apt_install chromium-browser 2>/dev/null && return 0
+  apt_install chromium 2>/dev/null && return 0
+  return 1
+}
+
+install_chrome_puppeteer() {
+  step "通过 Puppeteer 安装 Chrome for Testing..."
+  if command -v npx &>/dev/null; then
+    npx puppeteer browsers install chrome@stable 2>/dev/null || true
+    # Puppeteer 安装的 Chrome 通常在 ~/.cache/puppeteer/ 下
+    # 创建符号链接使其可被发现
+    CHROME_PATH=$(find ~/.cache/puppeteer -name "chrome" -type f 2>/dev/null | head -1)
+    if [ -n "$CHROME_PATH" ]; then
+      ln -sf "$CHROME_PATH" /usr/local/bin/google-chrome 2>/dev/null || \
+      ln -sf "$CHROME_PATH" /usr/bin/google-chrome 2>/dev/null || true
+      success "Puppeteer Chrome 已链接: $CHROME_PATH"
+      return 0
+    fi
+  fi
+  warn "Puppeteer Chrome 安装也失败"
+  return 1
+}
+
+# ── Step 4: 安装中文字体和输入法 ────────────────────────────
+install_fonts_and_locale() {
+  banner "Step 4/6: 安装中文字体和本地化支持..."
+
+  step "安装中文字体..."
+  apt_install \
+    fonts-noto-cjk \
+    fonts-noto-cjk-extra \
+    fonts-wqy-zenhei \
+    fonts-wqy-microhei \
+    2>/dev/null || true
+
+  step "安装额外字体..."
+  apt_install \
+    fonts-liberation \
+    fonts-dejavu \
+    fonts-freefont-ttf \
+    2>/dev/null || true
+
+  step "配置 locale..."
+  apt_install locales 2>/dev/null || true
+  if $IS_ROOT; then
+    locale-gen zh_CN.UTF-8 2>/dev/null || true
+    locale-gen en_US.UTF-8 2>/dev/null || true
+    update-locale LANG=zh_CN.UTF-8 2>/dev/null || true
+  else
+    sudo locale-gen zh_CN.UTF-8 2>/dev/null || true
+    sudo locale-gen en_US.UTF-8 2>/dev/null || true
+    sudo update-locale LANG=zh_CN.UTF-8 2>/dev/null || true
+  fi
+
+  # 刷新字体缓存
+  fc-cache -fv 2>/dev/null || true
+
+  success "字体和本地化安装完成"
+}
+
+# ── Step 5: 修复 Termux/proot 特有问题 ─────────────────────
+fix_termux_issues() {
+  banner "Step 5/6: 修复 Termux/proot 兼容性问题..."
+
+  # 1. /dev/shm — Android 限制 SysV IPC
+  step "检查 /dev/shm..."
+  if [ ! -d /dev/shm ]; then
+    mkdir -p /dev/shm 2>/dev/null || warn "无法创建 /dev/shm (proot 限制)"
+  fi
+  chmod 1777 /dev/shm 2>/dev/null || warn "无法修改 /dev/shm 权限"
+
+  # 2. /tmp/.X11-unix — X11 socket 目录
+  step "确保 X11 socket 目录存在..."
+  mkdir -p /tmp/.X11-unix
+  chmod 1777 /tmp/.X11-unix 2>/dev/null || true
+
+  # 3. Chrome 沙箱 — proot 下无法使用 Chrome sandbox
+  step "配置 Chrome/Chromium 无沙箱模式 (proot 兼容)..."
+  # 创建包装脚本，自动添加 --no-sandbox --disable-gpu
+  for browser_name in google-chrome chromium-browser chromium; do
+    browser_path=$(command -v "$browser_name" 2>/dev/null || true)
+    if [ -n "$browser_path" ] && [ "$browser_path" != "/usr/local/bin/$browser_name" ]; then
+      real_path=$(readlink -f "$browser_path" 2>/dev/null || echo "$browser_path")
+      cat > "/usr/local/bin/$browser_name" <<SCRIPT
+#!/bin/bash
+exec $real_path --no-sandbox --disable-gpu --disable-dev-shm-usage "\$@"
+SCRIPT
+      chmod +x "/usr/local/bin/$browser_name"
+      info "已为 $browser_name 添加 --no-sandbox 包装 (实际: $real_path)"
+    fi
+  done
+
+  # 4. 创建 Chrome 启动桌面快捷方式
+  step "创建桌面快捷方式..."
+  mkdir -p /usr/share/applications
+  cat > /usr/share/applications/chromium-browser.desktop <<'DESKTOP'
+[Desktop Entry]
+Version=1.0
+Name=Chromium Web Browser
+GenericName=Web Browser
+Comment=Access the Internet
+Exec=chromium-browser --no-sandbox --disable-gpu --disable-dev-shm-usage %U
+Terminal=false
+Type=Application
+Icon=chromium
+Categories=Network;WebBrowser;
+DESKTOP
+
+  # 5. 确保用户 chrome 配置目录存在
+  step "确保 Chrome 配置目录..."
+  mkdir -p ~/.config/chromium 2>/dev/null || true
+  mkdir -p ~/.config/google-chrome 2>/dev/null || true
+
+  success "Termux/proot 兼容性修复完成"
+}
+
+# ── Step 6: 验证安装并输出信息 ─────────────────────────────
+verify_and_summary() {
+  banner "Step 6/6: 验证安装..."
+
+  local all_ok=true
+
+  # 验证 VNC 组件
+  echo ""
+  echo -e "  ${BOLD}VNC 远程桌面组件:${NC}"
+  for cmd in Xvfb x11vnc; do
+    if command -v "$cmd" &>/dev/null; then
+      success "  $cmd: $(command -v "$cmd")"
+    else
+      err "  $cmd: 未安装"
+      all_ok=false
+    fi
+  done
+  if command -v websockify &>/dev/null || python3 -c "import websockify" 2>/dev/null; then
+    success "  websockify: 已安装"
+  else
+    err "  websockify: 未安装"
+    all_ok=false
+  fi
+
+  # 验证窗口管理器
+  echo ""
+  echo -e "  ${BOLD}窗口管理器:${NC}"
+  for wm in fluxbox openbox xfce4-session icewm jwm twm; do
+    if command -v "$wm" &>/dev/null; then
+      success "  $wm: 已安装"
+      break
+    fi
+  done
+
+  # 验证浏览器
+  echo ""
+  echo -e "  ${BOLD}浏览器:${NC}"
+  for browser in google-chrome chromium-browser chromium; do
+    if command -v "$browser" &>/dev/null; then
+      success "  $browser: $(command -v "$browser")"
+      break
+    fi
+  done
+  if ! command -v google-chrome &>/dev/null && \
+     ! command -v chromium-browser &>/dev/null && \
+     ! command -v chromium &>/dev/null; then
+    err "  浏览器: 未安装"
+    all_ok=false
+  fi
+
+  # 验证字体
+  echo ""
+  echo -e "  ${BOLD}中文字体:${NC}"
+  if fc-list :lang=zh 2>/dev/null | head -1 | grep -q .; then
+    success "  中文字体已安装"
+  else
+    warn "  中文字体未检测到"
+  fi
+
+  # 输出使用说明
+  echo ""
+  echo "═══════════════════════════════════════════════════════════"
+  if $all_ok; then
+    echo -e "  ${SUCCESS}${BOLD}所有组件安装成功！${NC}"
+  else
+    echo -e "  ${WARN}${BOLD}部分组件安装失败，请查看上方日志${NC}"
+  fi
+  echo "═══════════════════════════════════════════════════════════"
+  echo ""
+  echo -e "  ${BOLD}使用方法:${NC}"
+  echo ""
+  echo "  1. 启动 MyAgent Web 服务:"
+  echo -e "     ${ACCENT}myagent-ai web${NC}"
+  echo ""
+  echo "  2. 在聊天页面点击 🖥️ 远程桌面按钮启动 VNC"
+  echo "     或通过 API: POST /api/vnc/start"
+  echo ""
+  echo "  3. 在管理页面 → 网站管理 → 点击"登录"按钮"
+  echo "     系统会自动启动 VNC 并在远程桌面中打开浏览器"
+  echo ""
+  echo "  4. VNC 连接信息:"
+  echo "     noVNC Web: http://<服务器IP>:<服务端口>/vnc/vnc.html"
+  echo "     VNC 直连:  <服务器IP>:5900"
+  echo ""
+  echo -e "  ${WARN}注意:${NC} 在 Termux proot 环境下，Chrome/Chromium"
+  echo "  已自动配置 --no-sandbox 模式以兼容 proot 限制。"
+  echo ""
+}
+
+# ── Main ────────────────────────────────────────────────────
+main() {
+  echo ""
+  echo -e "  ${BOLD}${ACCENT}MyAgent${NC} ${BOLD}— Termux + Ubuntu 远程桌面安装${NC}"
+  echo ""
+
+  detect_environment
+  install_base_deps
+  install_vnc_deps
+  install_chrome
+  install_fonts_and_locale
+  fix_termux_issues
+  verify_and_summary
+}
+
+main "$@"

package/package.json

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

package/web/api_server.py

@@ -554,16 +554,16 @@ class ApiServer:
         # ── 工作流 ──
         r.add_get("/api/workflows", self.handle_list_workflows)
         r.add_get("/api/workflows/stats", self.handle_workflow_stats)
-        r.add_get("/api/workflows/{agent:[\d]+}", self.handle_list_agent_workflows)
-        r.add_post("/api/workflows/{agent:[\d]+}", self.handle_create_workflow)
-        r.add_get("/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}", self.handle_get_workflow)
-        r.add_put("/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}", self.handle_update_workflow)
-        r.add_delete("/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}", self.handle_delete_workflow)
-        r.add_post("/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}/run", self.handle_run_workflow)
-        r.add_post("/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}/toggle", self.handle_toggle_workflow)
-        r.add_post("/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}/duplicate", self.handle_duplicate_workflow)
-        r.add_get("/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}/runs", self.handle_list_workflow_runs)
-        r.add_get("/api/workflows/{agent:[\d]+}/runs/{rid:[\w\-]+}", self.handle_get_workflow_run)
+        r.add_get(r"/api/workflows/{agent:[\d]+}", self.handle_list_agent_workflows)
+        r.add_post(r"/api/workflows/{agent:[\d]+}", self.handle_create_workflow)
+        r.add_get(r"/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}", self.handle_get_workflow)
+        r.add_put(r"/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}", self.handle_update_workflow)
+        r.add_delete(r"/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}", self.handle_delete_workflow)
+        r.add_post(r"/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}/run", self.handle_run_workflow)
+        r.add_post(r"/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}/toggle", self.handle_toggle_workflow)
+        r.add_post(r"/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}/duplicate", self.handle_duplicate_workflow)
+        r.add_get(r"/api/workflows/{agent:[\d]+}/{wid:[\w\-]+}/runs", self.handle_list_workflow_runs)
+        r.add_get(r"/api/workflows/{agent:[\d]+}/runs/{rid:[\w\-]+}", self.handle_get_workflow_run)
         # ── 任务持久化 ──
         r.add_get("/api/tasks", self.handle_list_tasks)
         r.add_post("/api/tasks/{task_id}/retry", self.handle_retry_task)
@@ -3258,9 +3258,44 @@ window.addEventListener('beforeunload', function() {{
             if self._agents_initialized:
                 return
             self._ensure_default_agent()
+            # [v1.33.0] 同步 agent ID 序列号：确保 .agent_id_seq 不小于已有 agent 目录的最大 ID
+            self._sync_agent_id_seq()
             self._agents_initialized = True
             logger.info("系统 Agent 初始化完成（全权Agent + 配置助手）")
 
+    def _sync_agent_id_seq(self):
+        """[v1.33.0] 同步 agent ID 序列号，确保 .agent_id_seq >= 已有 agent 目录的最大数字 ID。
+        
+        问题：_ensure_default_agent() 用硬编码 aid=1/2 创建目录但不更新序列号，
+        导致 next_agent_id() 从 0 开始计数，新建 agent 时 ID 1/2 冲突。
+        修复：扫描 agents/ 目录中所有数字子目录，取最大值与 .agent_id_seq 对比，
+        取较大者写入 .agent_id_seq，保证后续 next_agent_id() 不会返回已用 ID。
+        """
+        from core.utils import _AGENT_ID_SEQ
+        try:
+            # 扫描 agents/ 目录中的数字子目录
+            agents_dir = self._agents_dir()
+            max_id = 0
+            if agents_dir.exists():
+                for d in agents_dir.iterdir():
+                    if d.is_dir() and d.name.isdigit():
+                        max_id = max(max_id, int(d.name))
+
+            # 读取当前序列号
+            try:
+                cur_seq = int(_AGENT_ID_SEQ.read_text().strip())
+            except (FileNotFoundError, ValueError):
+                cur_seq = 0
+
+            # 取较大者
+            new_seq = max(max_id, cur_seq)
+            if new_seq > cur_seq:
+                _AGENT_ID_SEQ.parent.mkdir(parents=True, exist_ok=True)
+                _AGENT_ID_SEQ.write_text(str(new_seq))
+                logger.info(f"Agent ID 序列号已同步: {cur_seq} → {new_seq} (最大目录 ID={max_id})")
+        except Exception as e:
+            logger.warning(f"同步 Agent ID 序列号失败: {e}")
+
     def _ensure_default_agent(self):
         """确保默认 agent 存在（ID=1，名为「全权Agent」，目录名=1）
         
@@ -3569,8 +3604,15 @@ window.addEventListener('beforeunload', function() {{
 
         aid = str(next_agent_id())
         ad = self._agent_dir(aid)
+        # [v1.33.0] ID 碰撞时自动重试，而非直接报错（防御序列号不同步的极端情况）
+        _retries = 0
+        while (ad / "config.json").exists() and _retries < 20:
+            logger.warning(f"Agent ID={aid} 目录已存在，跳过并重试 (retry={_retries})")
+            aid = str(next_agent_id())
+            ad = self._agent_dir(aid)
+            _retries += 1
         if (ad / "config.json").exists():
-            return web.json_response({"error": f"Agent '{name}' already exists"}, status=409)
+            return web.json_response({"error": f"Agent '{name}' already exists (ID conflict)"}, status=409)
 
         now = _now_iso()
         cfg = {
@@ -5265,17 +5307,36 @@ window.addEventListener('beforeunload', function() {{
         return web.json_response({"ok": True})
 
     async def handle_open_site_browser(self, request):
-        """POST /api/sites/{name}/open-browser - 打开浏览器登录网站"""
+        """POST /api/sites/{name}/open-browser - 打开浏览器登录网站
+        
+        [v1.33.0] 自动启动 VNC 远程桌面（如果尚未运行），确保用户可通过 VNC 看到浏览器界面。
+        在 Termux/proot 环境下，有头浏览器需要 Xvfb 虚拟显示才能运行。
+        """
         name = request.match_info["name"]
         reg = self._get_site_registry()
         site = reg.get_site(name)
         if not site:
             return web.json_response({"error": f"网站 '{name}' 不存在"}, status=404)
 
+        # [v1.33.0] 自动启动 VNC 远程桌面（有头浏览器需要虚拟显示）
+        vnc_mgr = self._get_vnc_manager()
+        vnc_was_started = vnc_mgr.is_running
+        if not vnc_was_started:
+            logger.info(f"网站登录需要 VNC 远程桌面，正在自动启动...")
+            vnc_result = await vnc_mgr.start()
+            if not vnc_result["success"]:
+                return web.json_response({"error": f"启动远程桌面失败（登录浏览器需要远程桌面）: {vnc_result['message']}"}, status=500)
+            # VNC 启动后，重建 MCP 客户端以使用有头浏览器
+            try:
+                from aiskills.chromedev_mcp import rebuild_mcp_client
+                await rebuild_mcp_client()
+            except Exception as e:
+                logger.warning(f"VNC 启动后重建 MCP 客户端失败: {e}")
+
         # Ensure profile is initialized
         from core.browser_profile import get_browser_profile_manager
-        mgr = get_browser_profile_manager()
-        profile = mgr.get_profile(name)
+        bprofile_mgr = get_browser_profile_manager()
+        profile = bprofile_mgr.get_profile(name)
         if not profile.is_initialized():
             profile.ensure_dirs()
 
@@ -5298,7 +5359,11 @@ window.addEventListener('beforeunload', function() {{
                 "ok": True,
                 "site": name,
                 "login_url": login_url,
-                "message": f"浏览器已打开，请在浏览器中完成 {site.get('display_name', name)} 的登录",
+                "vnc_started": not vnc_was_started,  # [v1.33.0] 是否自动启动了 VNC
+                "vnc_running": True,                   # VNC 现在肯定是运行中
+                "novnc_url": "/vnc/vnc.html?autoconnect=true&resize=scale",
+                "message": f"浏览器已打开，请通过远程桌面完成 {site.get('display_name', name)} 的登录"
+                          + ("（已自动启动远程桌面）" if not vnc_was_started else ""),
             })
         except Exception as e:
             logger.error(f"打开浏览器失败 ({name}): {e}")

package/web/ui/admin/admin-sites.js

@@ -329,15 +329,46 @@ async function deleteSiteProfile(name) {
 }
 
 // ── Browser Login ──
+// [v1.33.0] 登录按钮自动关联 VNC 远程桌面：后端会自动启动 VNC，前端在登录后引导用户打开远程桌面
 async function openSiteBrowser(name) {
-  showToast('正在启动浏览器...', 'info');
+  showToast('正在启动浏览器和远程桌面...', 'info', 30000);
   var r = await api('/api/sites/' + encodeURIComponent(name) + '/open-browser', { method: 'POST' });
   if (r.error) { showToast(r.error, 'danger'); return; }
-  showToast(r.message || '浏览器已打开', 'success', 5000);
+  
+  var msg = r.message || '浏览器已打开';
+  showToast(msg, 'success', 8000);
+  
+  // [v1.33.0] 如果 VNC 是自动启动的，提示用户打开远程桌面查看浏览器
+  if (r.vnc_started || r.vnc_running) {
+    // 提供"查看远程桌面"按钮让用户可以跳转到 VNC
+    var vncHint = document.createElement('div');
+    vncHint.id = 'vncLoginHint';
+    vncHint.style.cssText = 'position:fixed;bottom:80px;right:20px;z-index:10000;background:var(--card);border:1px solid var(--accent);border-radius:8px;padding:12px 16px;box-shadow:0 4px 12px rgba(0,0,0,0.3);max-width:320px;font-size:13px';
+    vncHint.innerHTML = '<div style="display:flex;align-items:center;gap:8px;margin-bottom:8px">' +
+      '<span style="font-size:16px">🖥️</span>' +
+      '<strong style="color:var(--text)">远程桌面已就绪</strong></div>' +
+      '<div style="color:var(--text2);margin-bottom:10px">浏览器已在远程桌面中打开，请通过远程桌面完成登录操作</div>' +
+      '<div style="display:flex;gap:8px">' +
+      '<button onclick="openAdminVNC()" style="padding:4px 12px;border-radius:4px;border:1px solid var(--accent);background:var(--accent);color:#fff;cursor:pointer;font-size:12px">打开远程桌面</button>' +
+      '<button onclick="this.closest(\'#vncLoginHint\').remove()" style="padding:4px 12px;border-radius:4px;border:1px solid var(--border);background:transparent;color:var(--text2);cursor:pointer;font-size:12px">关闭</button>' +
+      '</div>';
+    document.body.appendChild(vncHint);
+    // 15 秒后自动消失
+    setTimeout(function() { var h = document.getElementById('vncLoginHint'); if (h) h.remove(); }, 15000);
+  }
+  
   // Refresh to update profile status
   setTimeout(function() { renderSites(); }, 2000);
 }
 
+// [v1.33.0] 在管理页面打开 VNC 远程桌面（跳转到聊天页面的 VNC 界面，或直接打开新标签）
+function openAdminVNC() {
+  var vncHint = document.getElementById('vncLoginHint');
+  if (vncHint) vncHint.remove();
+  // 打开 VNC 在新标签页
+  window.open('/vnc/vnc.html?autoconnect=true&resize=scale', '_blank');
+}
+
 async function closeSiteBrowser(name) {
   var r = await api('/api/sites/' + encodeURIComponent(name) + '/close-browser', { method: 'POST' });
   if (r.error) { showToast(r.error, 'danger'); return; }

package/web/ui/chat/chat_main.js

@@ -3526,6 +3526,8 @@ function groupHistoryMessages(messages) {
 // ── [v1.23.20] 统一消息渲染函数：历史消息和流式消息共享 ──
 // 生成单条消息的完整 HTML（message-row 外壳 + 所有内部内容）
 // 流式结束后也用此函数重建 DOM，确保历史/流式样式完全一致
+// [v1.32.9] 流式结束后 _normalizeMessageAfterStreaming() 将 parts 转为 groupHistoryMessages() 格式，
+// 所以无论数据来源如何，此函数都走同一渲染分支
 window.buildMessageHtml = function(msg, idx, agent) {
   const isUser = msg.role === 'user';
   if (msg.role === 'tool') return '';

package/web/ui/chat/flow_engine.js

@@ -1373,11 +1373,13 @@ function showToolResultModal(msgIndex, eventId) {
   if (msg.exec_events) {
     evt = msg.exec_events.find(e => String(e.id) === String(eventId));
   }
-  // 再从 parts 查找（V2 格式：{type:'v2_tool', data:{id, tool_name, ...}}）
+  // 再从 parts 查找（V2 格式或规范化后的 exec 格式）
   if (!evt && msg.parts) {
     for (const part of msg.parts) {
-      if (part.type === 'v2_tool' && part.data && String(part.data.id) === String(eventId)) {
-        evt = part.data;
+      // [v1.32.9] 同时支持 v2_tool 和规范化后的 exec 格式
+      const inner = (part.type === 'v2_tool') ? part.data : (part.type === 'exec') ? part.data : null;
+      if (inner && String(inner.id) === String(eventId)) {
+        evt = inner;
         break;
       }
     }
@@ -1532,6 +1534,112 @@ function _assembleV2Content(msg, msgParts) {
   return '(无回复)';
 }
 
+// ══════════════════════════════════════════════════════
+// ── [v1.32.9] Post-Streaming Normalization ──
+// ══════════════════════════════════════════════════════
+
+/**
+ * 流式结束后，将 msg.parts 规范化为与 groupHistoryMessages() 一致的格式。
+ * 这确保 buildMessageHtml() 在流式和历史两条路径上走同一个渲染分支，
+ * 避免视觉差异。
+ *
+ * 主要处理：
+ * 1. v2_tool (tool_start + tool_result) → exec (合并卡片，与历史格式对齐)
+ * 2. 仅含1个文本部分且无工具调用时 → 删除 parts（走简单气泡路径，与历史对齐）
+ * 3. v2_ask → 保留原样
+ */
+function _normalizeMessageAfterStreaming(msg) {
+  if (!msg || !Array.isArray(msg.parts) || msg.parts.length === 0) return;
+
+  // ── Step 1: 转换 v2_tool 为 exec 格式，并合并 tool_start + tool_result ──
+  var normalizedParts = [];
+  var evtIdCounter = 0;
+
+  for (var i = 0; i < msg.parts.length; i++) {
+    var part = msg.parts[i];
+
+    if (part.type === 'v2_tool') {
+      var inner = part.data || {};
+      // tool_start: 创建 exec 卡片
+      if (inner.type === 'tool_start' || inner.status === 'running') {
+        var execPart = {
+          type: 'exec',
+          data: {
+            id: evtIdCounter,
+            type: 'tool_call',
+            title: inner.title || inner.tool_name || '工具调用',
+            tool_name: inner.tool_name || '',
+            params: inner.params,
+            status: 'done',
+            has_result: false,
+            result_data: null,
+          }
+        };
+        // 向后搜索同一 tool_name 的 tool_result 进行合并
+        for (var ri = i + 1; ri < msg.parts.length; ri++) {
+          var rp = msg.parts[ri];
+          if (rp.type === 'v2_tool' && rp.data && rp.data.type === 'tool_result') {
+            var rInner = rp.data;
+            if (rInner.tool_name === inner.tool_name || rInner.id === inner.id) {
+              execPart.data.has_result = true;
+              execPart.data.success = rInner.success;
+              execPart.data.summary = rInner.summary ? rInner.summary.substring(0, 500).trim() : undefined;
+              execPart.data.result = rInner.result || { output: rInner.summary || '' };
+              if (rInner.title) execPart.data.title = rInner.title;
+              // 标记已消费
+              rp._consumed = true;
+              break;
+            }
+          }
+          // 遇到下一个 tool_start 就停止搜索
+          if (rp.type === 'v2_tool' && rp.data && (rp.data.type === 'tool_start' || rp.data.status === 'running')) break;
+        }
+        evtIdCounter++;
+        normalizedParts.push(execPart);
+      } else if (inner.type === 'tool_result' && !part._consumed) {
+        // 孤立的 tool_result（没有匹配的 tool_start）
+        evtIdCounter++;
+        normalizedParts.push({
+          type: 'exec',
+          data: {
+            id: evtIdCounter,
+            type: 'tool_result',
+            title: inner.title || inner.tool_name || '工具结果',
+            tool_name: inner.tool_name || '',
+            success: inner.success,
+            summary: inner.summary ? inner.summary.substring(0, 500).trim() : undefined,
+            result: inner.result || { output: inner.summary || '' },
+            has_result: true,
+          }
+        });
+      }
+      // 其他 v2_tool 类型（如已完成但非 start/result 的），也转为 exec
+      else if (inner.type !== 'tool_start' && inner.type !== 'tool_result') {
+        evtIdCounter++;
+        normalizedParts.push({
+          type: 'exec',
+          data: Object.assign({}, inner, { id: evtIdCounter })
+        });
+      }
+    } else {
+      // text / exec / v2_ask 等类型保持不变
+      normalizedParts.push(part);
+    }
+  }
+
+  // ── Step 2: 与 groupHistoryMessages() 对齐——决定是否保留 parts ──
+  // groupHistoryMessages 逻辑: 仅当 hasExecParts || textParts.length > 1 时设置 parts
+  var textParts = normalizedParts.filter(function(p) { return p.type === 'text'; });
+  var hasExecParts = normalizedParts.some(function(p) { return p.type === 'exec'; });
+
+  if (hasExecParts || textParts.length > 1) {
+    msg.parts = normalizedParts;
+  } else {
+    // 仅1段文本且无工具调用 → 删除 parts，走简单气泡渲染路径
+    delete msg.parts;
+  }
+}
+
 // ══════════════════════════════════════════════════════
 // ── Voice Input: User Bubble Replacement ──
 // ══════════════════════════════════════════════════════
@@ -1899,6 +2007,8 @@ async function sendMessage(opts) {
               state.messages[msgIdx].content = _assembleV2Content(state.messages[msgIdx], msgParts);
               state.messages[msgIdx]._streamingText = '';
               if (allExecEvents.length > 0) state.messages[msgIdx].exec_events = [...allExecEvents];
+              // [v1.32.9] 规范化 parts 为 groupHistoryMessages() 格式
+              _normalizeMessageAfterStreaming(state.messages[msgIdx]);
             }
             // Start new message
             state.messages.push({ role: 'user', content: evt.message, time: new Date().toISOString() });
@@ -2308,6 +2418,8 @@ async function sendMessage(opts) {
       state.messages[msgIdx].exec_events = allExecEvents;
       // Assemble final content: prefer V2 reasoning/ask text over raw XML
       state.messages[msgIdx].content = _assembleV2Content(state.messages[msgIdx], msgParts);
+      // [v1.32.9] 规范化 parts 为 groupHistoryMessages() 格式，确保 buildMessageHtml() 渲染一致
+      _normalizeMessageAfterStreaming(state.messages[msgIdx]);
     }
     
     // ── 流式传输完成，清除恢复数据 ──
@@ -2416,7 +2528,13 @@ async function sendMessage(opts) {
     state.isGenerating = false;
     state.abortController = null;
     // 重置所有消息的流式标志
-    state.messages.forEach(m => { if(m.streaming) m.streaming = false; });
+    state.messages.forEach(m => {
+      if(m.streaming) {
+        m.streaming = false;
+        // [v1.32.9] 规范化 parts，确保异常结束时也和历史格式一致
+        _normalizeMessageAfterStreaming(m);
+      }
+    });
     hideTypingIndicator();
     stopExecTimerPolling();
     document.getElementById('sendBtn').style.display = '';

package/worklog.md

@@ -19,3 +19,24 @@ Stage Summary:
 - [XSS] admin-core.js - esc() 函数增加单引号转义，与 escHtml 统一
 - [Content-Type] admin-core.js - api() 函数不再自动设置 Content-Type，支持 FormData multipart 上传
 - 注意: GitHub token 已失效，推送失败，代码仅本地提交
+
+---
+Task ID: 2
+Agent: main
+Task: 统一聊天页面流式渲染与历史记录渲染格式 (v1.32.10)
+
+Work Log:
+- 深入分析 buildMessageHtml()、groupHistoryMessages()、updateStreamingMessage() 三大函数
+- 发现核心差异：流式结束后 msg.parts 格式与 groupHistoryMessages() 输出不一致
+- 流式总是设置 parts（走 timeline 布局），历史仅在有 exec/multiple text 时设置 parts（走简单气泡布局）
+- v2_tool 类型的 parts 与 exec 类型数据结构不同，renderInlineExecEvent() 渲染逻辑不同
+- 添加 _normalizeMessageAfterStreaming() 函数，在流式结束后规范化 msg.parts
+- v2_tool parts 转为 exec 格式，合并 tool_start + tool_result 为单个卡片
+- 仅1段文本且无工具调用时删除 parts，走简单气泡渲染路径
+- 在3处流式结束点调用规范化：正常结束、queue_start、异常 finally
+- 修复 showToolResultModal() 搜索 parts 时同时支持 v2_tool 和 exec 格式
+
+Stage Summary:
+- 核心修复：流式结束后规范化消息数据格式，确保 buildMessageHtml() 走同一渲染分支
+- 版本：v1.32.10 已发布到 npm
+- 文件变更：flow_engine.js (+120行), chat_main.js (+2行注释)