myagent-ai 1.33.1 → 1.33.2

package/aiskills/browser_stealth.py

@@ -178,6 +178,67 @@ def _stop_xvfb() -> None:
             logger.info("Xvfb 虚拟显示已停止")
 
 
+def _ensure_display() -> Optional[Dict[str, Any]]:
+    """
+    确保有可用的 X11 显示，供浏览器有头模式使用。
+
+    优先级:
+      1. 复用 VNC 远程桌面的 Xvfb 显示（用户可在 VNC 中看到浏览器操作）
+      2. 自动启动 VNC（含 Xvfb + x11vnc + websockify）
+      3. VNC 不可用时独立启动 Xvfb
+
+    Returns:
+        {"display": ":99", "vnc": True/False, "xvfb_standalone": True/False}
+        失败返回 None
+    """
+    # 1. 尝试复用 VNC 远程桌面
+    try:
+        from core.vnc_manager import get_vnc_manager
+        vnc = get_vnc_manager()
+
+        # VNC 已在运行 → 直接复用其 DISPLAY
+        if vnc.is_running:
+            display = vnc.display  # 默认 :99
+            os.environ["DISPLAY"] = display
+            logger.info(f"VNC 远程桌面已在运行，复用显示: {display}")
+            return {"display": display, "vnc": True, "xvfb_standalone": False}
+
+        # VNC 未运行 → 尝试自动启动
+        try:
+            import asyncio
+            loop = asyncio.get_event_loop()
+            if loop.is_running():
+                # 在已有事件循环中，用 run_until_complete 不行，
+                # 创建 task 等待完成
+                import concurrent.futures
+                with concurrent.futures.ThreadPoolExecutor() as pool:
+                    result = pool.submit(asyncio.run, vnc.start()).result(timeout=30)
+            else:
+                result = asyncio.run(vnc.start())
+
+            if result.get("success"):
+                display = vnc.display
+                os.environ["DISPLAY"] = display
+                logger.info(f"VNC 远程桌面已自动启动，显示: {display}，可在 VNC 中查看浏览器操作")
+                return {"display": display, "vnc": True, "xvfb_standalone": False}
+            else:
+                logger.warning(f"VNC 自动启动失败: {result.get('message', '')}")
+        except Exception as e:
+            logger.warning(f"VNC 自动启动异常: {e}")
+
+    except ImportError:
+        logger.debug("VNC 管理器不可用，跳过 VNC 集成")
+    except Exception as e:
+        logger.warning(f"VNC 检测异常: {e}")
+
+    # 2. VNC 不可用 → 独立启动 Xvfb
+    xvfb_display = _start_xvfb()
+    if xvfb_display:
+        return {"display": xvfb_display, "vnc": False, "xvfb_standalone": True}
+
+    return None
+
+
 # ── 反检测浏览器管理器 ──────────────────────────────────────
 
 
@@ -214,7 +275,8 @@ class StealthBrowser:
         self._browser = None  # DrissionPage Chromium 实例
         self._started = False
         self._user_data_dir = ""
-        self._xvfb_started_by_us = False  # 是否由本实例启动的 Xvfb
+        self._xvfb_started_by_us = False  # 是否由本实例独立启动的 Xvfb
+        self._vnc_used = False  # 是否使用了 VNC 远程桌面的显示
 
     def _get_user_data_dir(self) -> str:
         """获取用户数据目录路径"""
@@ -266,17 +328,23 @@ class StealthBrowser:
             co.set_argument("--disable-gpu")
 
             # ── 无 DISPLAY 环境处理 ──
-            # 当 headless=False 但没有可用显示时，尝试启动 Xvfb 虚拟显示；
-            # 如果 Xvfb 不可用则自动降级为 headless 模式
+            # 优先级: VNC远程桌面 > 自启动Xvfb > 降级headless
+            # 当 headless=False 但没有可用显示时：
+            #   1. 优先复用 VNC 远程桌面的 Xvfb 显示（用户可在 VNC 中看到浏览器操作）
+            #   2. VNC 未运行时自动启动 VNC（含 Xvfb + x11vnc + websockify）
+            #   3. VNC 启动失败则尝试独立启动 Xvfb
+            #   4. 都不可用则降级为 headless 模式
             if not self._headless and not _has_display():
-                xvfb_display = _start_xvfb()
-                if xvfb_display:
-                    self._xvfb_started_by_us = True
-                    logger.info(f"无 DISPLAY 环境，已启动 Xvfb 虚拟显示 ({xvfb_display})")
+                display = _ensure_display()
+                if display:
+                    self._vnc_used = display.get("vnc", False)
+                    self._xvfb_started_by_us = display.get("xvfb_standalone", False)
+                    if self._vnc_used:
+                        logger.info(f"复用 VNC 远程桌面显示 ({display['display']})，可在 VNC 中查看浏览器操作")
                 else:
                     self._headless = True
                     logger.warning(
-                        "无 DISPLAY 环境且 Xvfb 不可用，自动降级为 headless 模式"
+                        "无 DISPLAY 环境且 VNC/Xvfb 均不可用，自动降级为 headless 模式"
                     )
 
             # 无头模式（co.headless() 内部设置 --headless=new）
@@ -369,7 +437,8 @@ class StealthBrowser:
             self._browser = None
             self._page = None
 
-        # 如果由本实例启动了 Xvfb，关闭浏览器后停止虚拟显示
+        # 如果由本实例独立启动了 Xvfb（非 VNC），关闭浏览器后停止虚拟显示
+        # 注意：VNC 管理自己的 Xvfb 生命周期，不在此停止
         if self._xvfb_started_by_us:
             self._xvfb_started_by_us = False
             # 检查是否还有其他浏览器实例在使用 Xvfb
@@ -381,6 +450,9 @@ class StealthBrowser:
             if not other_active:
                 _stop_xvfb()
 
+        # VNC 显示不由浏览器管理，无需停止
+        self._vnc_used = False
+
         return SkillResult(success=True, message="浏览器已关闭")
 
     async def navigate(self, url: str, wait: float = 2.0) -> SkillResult:
@@ -902,8 +974,11 @@ def close_stealth_browser(profile_name: str = "") -> None:
                     pass
             _browsers.clear()
 
-    # 所有浏览器关闭后，停止 Xvfb（如果有）
-    _stop_xvfb()
+    # 所有浏览器关闭后，仅在独立 Xvfb（非 VNC）时才停止
+    # VNC 管理自己的 Xvfb 生命周期
+    any_vnc = any(b._vnc_used for b in _browsers.values()) if _browsers else False
+    if not any_vnc:
+        _stop_xvfb()
 
 
 async def close_stealth_browser_async(profile_name: str = "") -> None:

package/aiskills/chromedev_mcp.py

@@ -165,6 +165,63 @@ def _stop_xvfb() -> None:
         logger.info("Xvfb 虚拟显示已停止 (chromedev_mcp)")
 
 
+def _ensure_display() -> Optional[str]:
+    """
+    确保有可用的 X11 显示，供浏览器有头模式使用。
+
+    优先级:
+      1. 复用 VNC 远程桌面的 Xvfb 显示（用户可在 VNC 中看到浏览器操作）
+      2. 自动启动 VNC（含 Xvfb + x11vnc + websockify）
+      3. VNC 不可用时独立启动 Xvfb
+
+    Returns:
+        DISPLAY 值（如 ":99"），失败返回 None
+    """
+    # 1. 尝试复用 VNC 远程桌面
+    try:
+        from core.vnc_manager import get_vnc_manager
+        vnc = get_vnc_manager()
+
+        # VNC 已在运行 → 直接复用其 DISPLAY
+        if vnc.is_running:
+            display = vnc.display  # 默认 :99
+            os.environ["DISPLAY"] = display
+            logger.info(f"VNC 远程桌面已在运行，复用显示: {display}")
+            return display
+
+        # VNC 未运行 → 尝试自动启动
+        try:
+            import asyncio
+            try:
+                loop = asyncio.get_event_loop()
+                if loop.is_running():
+                    import concurrent.futures
+                    with concurrent.futures.ThreadPoolExecutor() as pool:
+                        result = pool.submit(asyncio.run, vnc.start()).result(timeout=30)
+                else:
+                    result = asyncio.run(vnc.start())
+            except RuntimeError:
+                result = asyncio.run(vnc.start())
+
+            if result.get("success"):
+                display = vnc.display
+                os.environ["DISPLAY"] = display
+                logger.info(f"VNC 远程桌面已自动启动，显示: {display}")
+                return display
+            else:
+                logger.warning(f"VNC 自动启动失败: {result.get('message', '')}")
+        except Exception as e:
+            logger.warning(f"VNC 自动启动异常: {e}")
+
+    except ImportError:
+        logger.debug("VNC 管理器不可用，跳过 VNC 集成")
+    except Exception as e:
+        logger.warning(f"VNC 检测异常: {e}")
+
+    # 2. VNC 不可用 → 独立启动 Xvfb
+    return _start_xvfb()
+
+
 # ── MCP 通信常量 ──────────────────────────────────────────────
 
 # chrome-devtools-mcp 支持的完整工具列表 (v0.21.0)
@@ -280,22 +337,23 @@ class MCPClient:
         args.extend(["--chromeArg", "--no-sandbox", "--chromeArg", "--disable-setuid-sandbox"])
 
         # [v1.17.0] 有头模式: 设置 DISPLAY 环境变量
+        # 优先级: 用户指定 DISPLAY > VNC 远程桌面 > 独立 Xvfb > 降级 headless
         if not self._headless:
             # 优先使用用户指定的 DISPLAY
             if self._display_override:
                 env["DISPLAY"] = self._display_override
                 logger.info(f"有头模式: DISPLAY={self._display_override}")
-            # 无可用显示时自动启动 Xvfb
+            # 无可用显示时，优先尝试 VNC 远程桌面，再尝试独立 Xvfb
             elif not _has_display():
-                xvfb_display = _start_xvfb()
-                if xvfb_display:
-                    env["DISPLAY"] = xvfb_display
-                    logger.info(f"无 DISPLAY 环境，已启动 Xvfb: {xvfb_display}")
+                display = _ensure_display()
+                if display:
+                    env["DISPLAY"] = display
+                    logger.info(f"有头模式: DISPLAY={display}（通过 VNC/Xvfb 提供）")
                 else:
-                    # Xvfb 不可用，降级为 headless 模式
+                    # 都不可用，降级为 headless 模式
                     self._headless = True
                     args.append("--headless")
-                    logger.warning("无 DISPLAY 环境且 Xvfb 不可用，自动降级为 headless 模式")
+                    logger.warning("无 DISPLAY 环境且 VNC/Xvfb 均不可用，自动降级为 headless 模式")
 
         logger.info(f"启动 chrome-devtools-mcp: {' '.join(args)}")
 

package/package.json

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