myagent-ai 1.28.3 → 1.29.0

package/aiskills/browser_stealth.py

@@ -0,0 +1,924 @@
+"""
+aiskills/browser_stealth.py - DrissionPage 反检测浏览器技能
+==========================================================
+基于 DrissionPage 的反检测浏览器自动化，专用于需要登录的网站操作。
+
+核心能力:
+  - 反自动化检测: 自动隐藏 webdriver 标志、CDP 痕迹等
+  - Profile 持久化: 每个网站独立 Profile，登录一次永久保持
+  - Cookie 管理: 保存/恢复/清除 Cookie
+  - 人机协作: 遇到验证码/2FA 时暂停，等待用户手动操作
+  - 完整操作: 导航、点击、填写、截图、执行 JS、等待元素等
+
+与 chromedev_mcp.py 的区别:
+  - chromedev_mcp: 标准 CDP 协议，功能全面，但会被网站检测为自动化
+  - browser_stealth: 反检测优先，适合登录敏感网站（Google/X/微博/抖音等）
+
+架构:
+  DrissionPage (Python) ──CDP(隐藏)──> Chromium/Chrome
+                                   ↑
+                          User Data Directory (Profile)
+                          Cookie 持久化
+
+依赖:
+  - DrissionPage >= 4.1.0
+  - Chromium/Chrome (系统已有，或自动检测)
+
+参考:
+  https://drissionpage.cn/
+"""
+from __future__ import annotations
+
+import asyncio
+import json
+import os
+import shutil
+import time
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from core.logger import get_logger
+from aiskills.base import Skill, SkillResult, SkillParameter
+
+logger = get_logger("myagent.skills.browser_stealth")
+
+
+# ── 反检测浏览器管理器 ──────────────────────────────────────
+
+
+class StealthBrowser:
+    """
+    基于 DrissionPage 的反检测浏览器实例。
+
+    用法:
+        browser = StealthBrowser(profile_name="google")
+        await browser.start()
+        await browser.navigate("https://accounts.google.com/")
+        await browser.fill('input[type="email"]', "user@gmail.com")
+        await browser.click('button:contains("下一步")')
+        screenshot = await browser.screenshot()
+        await browser.close()
+    """
+
+    def __init__(
+        self,
+        profile_name: str = "default",
+        headless: bool = False,
+        user_data_dir: Optional[str] = None,
+    ):
+        """
+        Args:
+            profile_name: Profile 名称（对应 BrowserProfileManager 中的 profile）
+            headless: 是否无头模式（登录场景建议 False）
+            user_data_dir: 自定义用户数据目录（覆盖 Profile 管理）
+        """
+        self.profile_name = profile_name
+        self._headless = headless
+        self._custom_user_data_dir = user_data_dir
+        self._page = None  # DrissionPage ChromiumPage 实例
+        self._browser = None  # DrissionPage Chromium 实例
+        self._started = False
+        self._user_data_dir = ""
+
+    def _get_user_data_dir(self) -> str:
+        """获取用户数据目录路径"""
+        if self._custom_user_data_dir:
+            return self._custom_user_data_dir
+
+        from core.browser_profile import get_browser_profile_manager
+        mgr = get_browser_profile_manager()
+        profile = mgr.get_profile(self.profile_name)
+        profile.ensure_dirs()
+        self._user_data_dir = str(profile.user_data_dir)
+        return self._user_data_dir
+
+    async def start(self) -> SkillResult:
+        """启动反检测浏览器"""
+        try:
+            from DrissionPage import Chromium, ChromiumOptions
+        except ImportError:
+            return SkillResult(
+                success=False,
+                error="DrissionPage 未安装。请运行: pip install DrissionPage",
+            )
+
+        try:
+            user_data = self._get_user_data_dir()
+            co = ChromiumOptions()
+
+            # 设置用户数据目录（Profile 持久化）
+            if user_data:
+                co.set_user_data_path(user_data)
+                co.set_argument(f"--user-data-dir={user_data}")
+
+            # 反检测核心参数
+            co.set_argument("--no-first-run")
+            co.set_argument("--no-default-browser-check")
+            co.set_argument("--disable-blink-features=AutomationControlled")
+
+            # 禁用自动化相关标志
+            co.set_argument("--disable-infobars")
+            co.set_argument("--disable-extensions")
+
+            # VNC/容器环境适配
+            if os.environ.get("DISPLAY"):
+                co.set_argument(f"--display={os.environ['DISPLAY']}")
+
+            # 无头模式
+            if self._headless:
+                co.headless()
+
+            # 容器环境
+            if not os.environ.get("DISPLAY"):
+                co.set_argument("--no-sandbox")
+                co.set_argument("--disable-setuid-sandbox")
+                co.set_argument("--disable-gpu")
+
+            # 自动检测浏览器路径
+            browser_path = self._detect_browser()
+            if browser_path:
+                co.set_browser_path(browser_path)
+
+            # 设置窗口大小
+            co.set_argument("--window-size=1920,1080")
+
+            # 创建浏览器实例
+            self._browser = Chromium(co)
+            self._page = self._browser.latest_tab
+
+            # 隐藏 webdriver 标志（额外注入）
+            try:
+                self._page.run_js("""
+                    Object.defineProperty(navigator, 'webdriver', {get: () => undefined});
+                    Object.defineProperty(navigator, 'plugins', {get: () => [1, 2, 3, 4, 5]});
+                    Object.defineProperty(navigator, 'languages', {get: () => ['zh-CN', 'zh', 'en']});
+                    window.chrome = {runtime: {}};
+                """)
+            except Exception as e:
+                logger.debug(f"反检测 JS 注入提示: {e}")
+
+            self._started = True
+            logger.info(
+                f"反检测浏览器已启动 (profile={self.profile_name}, "
+                f"headless={self._headless})"
+            )
+            return SkillResult(
+                success=True,
+                message=f"反检测浏览器已启动 (Profile: {self.profile_name})",
+                data={"profile": self.profile_name, "headless": self._headless},
+            )
+
+        except Exception as e:
+            logger.error(f"启动反检测浏览器失败: {e}")
+            return SkillResult(
+                success=False,
+                error=f"启动反检测浏览器失败: {e}",
+            )
+
+    async def close(self) -> SkillResult:
+        """关闭浏览器"""
+        try:
+            if self._browser:
+                self._browser.quit()
+                self._browser = None
+                self._page = None
+                self._started = False
+                logger.info("反检测浏览器已关闭")
+                return SkillResult(success=True, message="浏览器已关闭")
+        except Exception as e:
+            logger.error(f"关闭浏览器异常: {e}")
+        self._started = False
+        return SkillResult(success=True, message="浏览器已关闭")
+
+    async def navigate(self, url: str, wait: float = 2.0) -> SkillResult:
+        """导航到指定 URL"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            self._page.get(url)
+            if wait > 0:
+                time.sleep(wait)
+
+            title = self._page.title or ""
+            current_url = self._page.url or ""
+
+            return SkillResult(
+                success=True,
+                message=f"已导航到: {url}",
+                data={"title": title, "url": current_url},
+            )
+        except Exception as e:
+            return SkillResult(success=False, error=f"导航失败: {e}")
+
+    async def click(self, selector: str, wait: float = 1.0) -> SkillResult:
+        """点击页面元素"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            ele = self._page.ele(selector, timeout=10)
+            if not ele:
+                return SkillResult(
+                    success=False,
+                    error=f"未找到元素: {selector}",
+                )
+            ele.click()
+            if wait > 0:
+                time.sleep(wait)
+            return SkillResult(success=True, message=f"已点击: {selector}")
+        except Exception as e:
+            return SkillResult(success=False, error=f"点击失败: {e}")
+
+    async def fill(
+        self, selector: str, value: str, clear: bool = True, wait: float = 0.5
+    ) -> SkillResult:
+        """填写输入框"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            ele = self._page.ele(selector, timeout=10)
+            if not ele:
+                return SkillResult(
+                    success=False,
+                    error=f"未找到元素: {selector}",
+                )
+            if clear:
+                ele.clear()
+            ele.input(value)
+            if wait > 0:
+                time.sleep(wait)
+            return SkillResult(
+                success=True,
+                message=f"已填写 {selector}: {value[:50]}{'...' if len(value) > 50 else ''}",
+            )
+        except Exception as e:
+            return SkillResult(success=False, error=f"填写失败: {e}")
+
+    async def screenshot(self, save_path: str = "") -> SkillResult:
+        """页面截图"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            if not save_path:
+                # 自动生成路径
+                from core.browser_profile import get_browser_profile_manager
+                save_dir = get_browser_profile_manager().base_dir / "screenshots"
+                save_dir.mkdir(parents=True, exist_ok=True)
+                save_path = str(
+                    save_dir
+                    / f"{self.profile_name}_{int(time.time())}.png"
+                )
+
+            self._page.get_screenshot(path=save_path, full_page=False)
+
+            return SkillResult(
+                success=True,
+                message=f"截图已保存: {save_path}",
+                files=[save_path],
+            )
+        except Exception as e:
+            return SkillResult(success=False, error=f"截图失败: {e}")
+
+    async def evaluate(self, script: str) -> SkillResult:
+        """执行 JavaScript"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            result = self._page.run_js(script)
+            return SkillResult(
+                success=True,
+                message="JS 执行完成",
+                data={"result": str(result) if result is not None else ""},
+            )
+        except Exception as e:
+            return SkillResult(success=False, error=f"JS 执行失败: {e}")
+
+    async def get_content(self) -> SkillResult:
+        """获取页面文本内容"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            text = self._page.text or ""
+            title = self._page.title or ""
+            url = self._page.url or ""
+
+            # 限制长度避免返回过多数据
+            output_text = text[:10000] if len(text) > 10000 else text
+
+            return SkillResult(
+                success=True,
+                message=f"页面内容: {title}",
+                data={
+                    "title": title,
+                    "url": url,
+                    "text": output_text,
+                    "text_length": len(text),
+                    "truncated": len(text) > 10000,
+                },
+                output=output_text,
+            )
+        except Exception as e:
+            return SkillResult(success=False, error=f"获取页面内容失败: {e}")
+
+    async def get_html(self) -> SkillResult:
+        """获取页面 HTML"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            html = self._page.html or ""
+            output_html = html[:50000] if len(html) > 50000 else html
+
+            return SkillResult(
+                success=True,
+                message=f"HTML 获取完成 ({len(html)} 字符)",
+                data={
+                    "url": self._page.url or "",
+                    "html_length": len(html),
+                    "html": output_html,
+                },
+                output=output_html,
+            )
+        except Exception as e:
+            return SkillResult(success=False, error=f"获取 HTML 失败: {e}")
+
+    async def wait_for(
+        self, selector: str, timeout: float = 10.0
+    ) -> SkillResult:
+        """等待元素出现"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            ele = self._page.ele(selector, timeout=timeout)
+            if ele:
+                return SkillResult(
+                    success=True,
+                    message=f"元素已出现: {selector}",
+                )
+            else:
+                return SkillResult(
+                    success=False,
+                    error=f"等待超时: {selector} ({timeout}s)",
+                )
+        except Exception as e:
+            return SkillResult(success=False, error=f"等待元素失败: {e}")
+
+    async def get_cookies(self) -> SkillResult:
+        """获取当前页面的 Cookie"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            cookies = self._page.cookies()
+            cookie_list = []
+            if cookies:
+                for c in cookies:
+                    cookie_list.append({
+                        "name": c.get("name", ""),
+                        "value": c.get("value", ""),
+                        "domain": c.get("domain", ""),
+                        "path": c.get("path", "/"),
+                    })
+
+            return SkillResult(
+                success=True,
+                message=f"获取到 {len(cookie_list)} 个 Cookie",
+                data={"cookies": cookie_list, "count": len(cookie_list)},
+            )
+        except Exception as e:
+            return SkillResult(success=False, error=f"获取 Cookie 失败: {e}")
+
+    async def save_cookies(self) -> SkillResult:
+        """保存当前 Cookie 到 Profile"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            cookies = self._page.cookies()
+            cookie_list = []
+            if cookies:
+                for c in cookies:
+                    cookie_list.append(dict(c))
+
+            from core.browser_profile import get_browser_profile_manager
+            mgr = get_browser_profile_manager()
+            profile = mgr.get_profile(self.profile_name)
+            profile.save_cookies(cookie_list)
+
+            return SkillResult(
+                success=True,
+                message=f"已保存 {len(cookie_list)} 个 Cookie 到 Profile: {self.profile_name}",
+            )
+        except Exception as e:
+            return SkillResult(success=False, error=f"保存 Cookie 失败: {e}")
+
+    async def load_cookies(self) -> SkillResult:
+        """从 Profile 加载 Cookie"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            from core.browser_profile import get_browser_profile_manager
+            mgr = get_browser_profile_manager()
+            profile = mgr.get_profile(self.profile_name)
+            cookies = profile.load_cookies()
+
+            if cookies:
+                self._page.set.cookies(cookies)
+                return SkillResult(
+                    success=True,
+                    message=f"已加载 {len(cookies)} 个 Cookie",
+                )
+            else:
+                return SkillResult(
+                    success=True,
+                    message="Profile 中没有保存的 Cookie",
+                )
+        except Exception as e:
+            return SkillResult(success=False, error=f"加载 Cookie 失败: {e}")
+
+    async def clear_cookies(self) -> SkillResult:
+        """清除当前页面和 Profile 中的 Cookie"""
+        if not self._ensure_page():
+            return SkillResult(success=False, error="浏览器未启动")
+
+        try:
+            self._page.clear_cookies()
+            from core.browser_profile import get_browser_profile_manager
+            mgr = get_browser_profile_manager()
+            profile = mgr.get_profile(self.profile_name)
+            profile.clear_cookies()
+
+            return SkillResult(success=True, message="Cookie 已清除")
+        except Exception as e:
+            return SkillResult(success=False, error=f"清除 Cookie 失败: {e}")
+
+    async def wait_for_manual(
+        self, reason: str = "验证码", timeout: float = 300.0
+    ) -> SkillResult:
+        """
+        等待用户手动操作（验证码/2FA 等）。
+
+        暂停自动化流程，等待指定时间让用户通过 VNC 或 Web Control
+        手动完成验证码、短信验证等操作。
+
+        Args:
+            reason: 等待原因
+            timeout: 最长等待时间（秒），默认 5 分钟
+        """
+        message = (
+            f"⏸ 需要用户手动操作: {reason}\n"
+            f"请通过 VNC 远程桌面或 Web Control 面板手动完成操作。\n"
+            f"最多等待 {int(timeout)} 秒..."
+        )
+        logger.info(f"[{self.profile_name}] 等待用户手动操作: {reason}")
+
+        # 简单的等待机制：轮询页面变化
+        start = time.time()
+        last_url = self._page.url if self._page else ""
+        while time.time() - start < timeout:
+            time.sleep(3)
+            if self._page:
+                current_url = self._page.url or ""
+                # 如果 URL 发生变化，说明用户完成了操作
+                if current_url != last_url and current_url:
+                    elapsed = int(time.time() - start)
+                    return SkillResult(
+                        success=True,
+                        message=f"用户已完成手动操作 ({reason})，耗时 {elapsed} 秒",
+                        data={"elapsed": elapsed, "new_url": current_url},
+                    )
+                last_url = current_url
+
+        return SkillResult(
+            success=False,
+            error=f"等待用户操作超时 ({int(timeout)} 秒): {reason}",
+        )
+
+    def _ensure_page(self) -> bool:
+        """确保浏览器和页面可用"""
+        if not self._started or not self._page:
+            return False
+        try:
+            # 检查页面是否仍然有效
+            _ = self._page.url
+            return True
+        except Exception:
+            self._started = False
+            return False
+
+    @staticmethod
+    def _detect_browser() -> Optional[str]:
+        """自动检测 Chromium/Chrome 浏览器路径"""
+        # 1. 环境变量
+        for key in ("CHROME_PATH", "BROWSER_PATH", "CHROMIUM_PATH"):
+            val = os.environ.get(key, "").strip()
+            if val and os.path.isfile(val):
+                return val
+
+        # 2. PATH 中的浏览器命令
+        for cmd in (
+            "google-chrome", "google-chrome-stable", "chromium-browser",
+            "chromium", "brave-browser", "microsoft-edge",
+        ):
+            found = shutil.which(cmd)
+            if found:
+                return found
+
+        # 3. Linux 常见路径
+        for p in (
+            "/usr/bin/google-chrome", "/usr/bin/google-chrome-stable",
+            "/usr/bin/chromium-browser", "/usr/bin/chromium",
+            "/snap/bin/chromium",
+        ):
+            if os.path.isfile(p) and os.access(p, os.X_OK):
+                return p
+
+        # 4. Puppeteer 缓存
+        home = os.path.expanduser("~")
+        for cache in (
+            os.path.join(home, ".cache", "puppeteer", "chrome"),
+            os.path.join(home, ".cache", "ms-playwright"),
+        ):
+            if os.path.isdir(cache):
+                for root, _, files in os.walk(cache):
+                    for fname in files:
+                        if fname in ("chrome", "chromium", "headless_shell"):
+                            full = os.path.join(root, fname)
+                            if os.access(full, os.X_OK):
+                                return full
+
+        return None
+
+
+# ── 全局浏览器实例管理 ──────────────────────────────────────
+
+_browsers: Dict[str, StealthBrowser] = {}
+_browser_lock = asyncio.Lock()
+
+
+async def get_stealth_browser(
+    profile_name: str = "default",
+    headless: bool = False,
+) -> StealthBrowser:
+    """
+    获取反检测浏览器实例（按 profile_name 复用）。
+
+    同一 profile 名称返回相同实例，避免重复启动。
+    """
+    async with _browser_lock:
+        if profile_name in _browsers:
+            browser = _browsers[profile_name]
+            if browser._started and browser._ensure_page():
+                return browser
+
+        browser = StealthBrowser(profile_name=profile_name, headless=headless)
+        _browsers[profile_name] = browser
+        return browser
+
+
+async def close_stealth_browser(profile_name: str = "") -> None:
+    """关闭浏览器实例"""
+    async with _browser_lock:
+        if profile_name and profile_name in _browsers:
+            await _browsers[profile_name].close()
+            del _browsers[profile_name]
+        elif not profile_name:
+            for name, browser in _browsers.items():
+                try:
+                    await browser.close()
+                except Exception:
+                    pass
+            _browsers.clear()
+
+
+# ── 技能类（供 SkillRegistry 自动发现）─────────────────────
+
+
+class StealthBrowserStartSkill(Skill):
+    """启动反检测浏览器"""
+
+    name = "stealth_browser_start"
+    description = (
+        "启动反检测浏览器 — 使用 DrissionPage 启动带有反检测能力的 Chromium 浏览器，"
+        "适合需要登录的网站操作（Google/X.com/微博/抖音等）。"
+        "每个网站使用独立 Profile，登录状态自动保持。"
+    )
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(
+            name="profile",
+            type="string",
+            description="Profile 名称（预置: google/gmail/x_com/weibo/wechat_mp/douyin/mail139/bilibili/github）",
+            required=False,
+            default="default",
+        ),
+        SkillParameter(
+            name="headless",
+            type="boolean",
+            description="是否无头模式（登录场景建议 false，默认 false）",
+            required=False,
+            default=False,
+        ),
+    ]
+    dangerous = False
+
+    async def execute(self, profile: str = "default", headless: bool = False, **kw) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile, headless=headless)
+        return await browser.start()
+
+
+class StealthBrowserNavigateSkill(Skill):
+    """反检测浏览器导航"""
+
+    name = "stealth_browser_navigate"
+    description = "反检测浏览器导航 — 导航到指定 URL"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="url", type="string", description="目标 URL", required=True),
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(self, url: str, profile: str = "default", **kw) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        if not browser._started:
+            r = await browser.start()
+            if not r.success:
+                return r
+        return await browser.navigate(url)
+
+
+class StealthBrowserClickSkill(Skill):
+    """反检测浏览器点击"""
+
+    name = "stealth_browser_click"
+    description = "反检测浏览器点击 — 点击页面元素（支持 CSS 选择器、文本匹配等）"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="selector", type="string", description="元素选择器 (CSS/文本/XPath)", required=True),
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(self, selector: str, profile: str = "default", **kw) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        return await browser.click(selector)
+
+
+class StealthBrowserFillSkill(Skill):
+    """反检测浏览器填写"""
+
+    name = "stealth_browser_fill"
+    description = "反检测浏览器填写 — 填写输入框（支持 CSS 选择器定位）"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="selector", type="string", description="输入框选择器", required=True),
+        SkillParameter(name="value", type="string", description="要输入的文本", required=True),
+        SkillParameter(name="clear", type="boolean", description="是否先清空", required=False, default=True),
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(
+        self, selector: str, value: str, clear: bool = True, profile: str = "default", **kw
+    ) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        return await browser.fill(selector, value, clear=clear)
+
+
+class StealthBrowserScreenshotSkill(Skill):
+    """反检测浏览器截图"""
+
+    name = "stealth_browser_screenshot"
+    description = "反检测浏览器截图 — 截取当前页面截图并返回文件路径"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="save_path", type="string", description="保存路径（空=自动）", required=False, default=""),
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(self, save_path: str = "", profile: str = "default", **kw) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        return await browser.screenshot(save_path=save_path)
+
+
+class StealthBrowserEvalSkill(Skill):
+    """反检测浏览器执行 JS"""
+
+    name = "stealth_browser_eval"
+    description = "反检测浏览器执行 JavaScript — 在页面中执行自定义 JS 代码"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="script", type="string", description="JavaScript 代码", required=True),
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(self, script: str, profile: str = "default", **kw) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        return await browser.evaluate(script)
+
+
+class StealthBrowserGetContentSkill(Skill):
+    """反检测浏览器获取内容"""
+
+    name = "stealth_browser_content"
+    description = "反检测浏览器获取页面内容 — 获取当前页面的文本内容（用于读取邮件/帖子等）"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(self, profile: str = "default", **kw) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        return await browser.get_content()
+
+
+class StealthBrowserCookieSkill(Skill):
+    """反检测浏览器 Cookie 管理"""
+
+    name = "stealth_browser_cookies"
+    description = (
+        "反检测浏览器 Cookie 管理 — 保存/加载/获取/清除 Cookie。"
+        "save=保存当前Cookie到Profile, load=从Profile加载Cookie, "
+        "get=获取当前Cookie列表, clear=清除Cookie"
+    )
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(
+            name="action",
+            type="string",
+            description="操作: save/load/get/clear",
+            required=True,
+            enum=["save", "load", "get", "clear"],
+        ),
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(self, action: str, profile: str = "default", **kw) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        if action == "save":
+            return await browser.save_cookies()
+        elif action == "load":
+            return await browser.load_cookies()
+        elif action == "get":
+            return await browser.get_cookies()
+        elif action == "clear":
+            return await browser.clear_cookies()
+        else:
+            return SkillResult(success=False, error=f"未知操作: {action}")
+
+
+class StealthBrowserCloseSkill(Skill):
+    """关闭反检测浏览器"""
+
+    name = "stealth_browser_close"
+    description = "关闭反检测浏览器 — 关闭指定 Profile 的浏览器实例"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="profile", type="string", description="Profile 名称（空=关闭所有）", required=False, default=""),
+    ]
+
+    async def execute(self, profile: str = "", **kw) -> SkillResult:
+        await close_stealth_browser(profile_name=profile)
+        return SkillResult(success=True, message="浏览器已关闭")
+
+
+class StealthBrowserWaitManualSkill(Skill):
+    """等待用户手动操作（验证码/2FA）"""
+
+    name = "stealth_browser_wait_manual"
+    description = (
+        "等待用户手动操作 — 遇到验证码/短信验证/2FA 等需要人工干预的场景时调用。"
+        "暂停自动化流程，等待用户通过 VNC 或 Web Control 面板手动完成操作。"
+        "检测到 URL 变化后自动恢复。"
+    )
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(
+            name="reason",
+            type="string",
+            description="等待原因（如: 验证码/短信验证/2FA）",
+            required=False,
+            default="验证码",
+        ),
+        SkillParameter(
+            name="timeout",
+            type="integer",
+            description="最长等待秒数（默认 300）",
+            required=False,
+            default=300,
+        ),
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(
+        self, reason: str = "验证码", timeout: int = 300, profile: str = "default", **kw
+    ) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        return await browser.wait_for_manual(reason=reason, timeout=float(timeout))
+
+
+class StealthBrowserWaitSkill(Skill):
+    """等待元素出现"""
+
+    name = "stealth_browser_wait"
+    description = "反检测浏览器等待 — 等待页面元素出现"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="selector", type="string", description="元素选择器", required=True),
+        SkillParameter(name="timeout", type="integer", description="超时秒数（默认 10）", required=False, default=10),
+        SkillParameter(name="profile", type="string", description="Profile 名称", required=False, default="default"),
+    ]
+
+    async def execute(
+        self, selector: str, timeout: int = 10, profile: str = "default", **kw
+    ) -> SkillResult:
+        browser = await get_stealth_browser(profile_name=profile)
+        return await browser.wait_for(selector, timeout=float(timeout))
+
+
+# ── Profile 管理技能 ──────────────────────────────────────
+
+
+class BrowserProfileListSkill(Skill):
+    """列出所有浏览器 Profile"""
+
+    name = "browser_profile_list"
+    description = "列出所有浏览器 Profile — 显示已创建的网站 Profile 及其状态"
+    category = "browser_stealth"
+    parameters = []
+
+    async def execute(self, **kw) -> SkillResult:
+        from core.browser_profile import get_browser_profile_manager
+        mgr = get_browser_profile_manager()
+        profiles = mgr.list_profiles()
+        presets = mgr.get_preset_names()
+        uninitialized = [p for p in presets if not any(x["name"] == p for x in profiles)]
+
+        info = {
+            "profiles": profiles,
+            "available_presets": presets,
+            "uninitialized_presets": uninitialized,
+            "total_size_mb": round(mgr.get_total_size_mb(), 2),
+        }
+        return SkillResult(
+            success=True,
+            message=f"共 {len(profiles)} 个 Profile",
+            data=info,
+            output=json.dumps(info, ensure_ascii=False, indent=2),
+        )
+
+
+class BrowserProfileCreateSkill(Skill):
+    """创建浏览器 Profile"""
+
+    name = "browser_profile_create"
+    description = (
+        "创建浏览器 Profile — 为网站创建独立的浏览器 Profile，"
+        "每个 Profile 有独立的 Cookie 和登录状态。"
+    )
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="name", type="string", description="Profile 名称", required=True),
+        SkillParameter(name="display_name", type="string", description="显示名称", required=False, default=""),
+        SkillParameter(name="login_url", type="string", description="登录页 URL", required=False, default=""),
+    ]
+
+    async def execute(
+        self, name: str, display_name: str = "", login_url: str = "", **kw
+    ) -> SkillResult:
+        from core.browser_profile import get_browser_profile_manager
+        mgr = get_browser_profile_manager()
+        profile = mgr.create_profile(
+            name=name,
+            display_name=display_name,
+            login_url=login_url,
+        )
+        return SkillResult(
+            success=True,
+            message=f"Profile 已创建: {name}",
+            data=profile.to_dict(),
+        )
+
+
+class BrowserProfileDeleteSkill(Skill):
+    """删除浏览器 Profile"""
+
+    name = "browser_profile_delete"
+    description = "删除浏览器 Profile — 删除指定网站的 Profile（包括 Cookie 和用户数据）"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="name", type="string", description="Profile 名称", required=True),
+    ]
+
+    async def execute(self, name: str, **kw) -> SkillResult:
+        from core.browser_profile import get_browser_profile_manager
+        mgr = get_browser_profile_manager()
+        ok = mgr.delete_profile(name)
+        if ok:
+            return SkillResult(success=True, message=f"Profile 已删除: {name}")
+        return SkillResult(success=False, error=f"删除失败: {name}")