myagent-ai 1.29.0 → 1.30.1

package/aiskills/browser_stealth.py

@@ -33,6 +33,7 @@ import asyncio
 import json
 import os
 import shutil
+import threading
 import time
 from pathlib import Path
 from typing import Any, Dict, List, Optional
@@ -89,7 +90,9 @@ class StealthBrowser:
         mgr = get_browser_profile_manager()
         profile = mgr.get_profile(self.profile_name)
         profile.ensure_dirs()
-        self._user_data_dir = str(profile.user_data_dir)
+        # DrissionPage 的 set_user_data_path 会自动在路径下创建 Default 目录
+        # 我们直接用 profile_dir 作为 user-data-dir，避免嵌套
+        self._user_data_dir = str(profile.profile_dir)
         return self._user_data_dir
 
     async def start(self) -> SkillResult:
@@ -107,8 +110,9 @@ class StealthBrowser:
             co = ChromiumOptions()
 
             # 设置用户数据目录（Profile 持久化）
+            # 注意：只用 set_argument，不用 set_user_data_path，因为后者会
+            # 在路径下再套一层 Default/ 子目录，导致路径混乱
             if user_data:
-                co.set_user_data_path(user_data)
                 co.set_argument(f"--user-data-dir={user_data}")
 
             # 反检测核心参数
@@ -120,20 +124,16 @@ class StealthBrowser:
             co.set_argument("--disable-infobars")
             co.set_argument("--disable-extensions")
 
-            # VNC/容器环境适配
-            if os.environ.get("DISPLAY"):
-                co.set_argument(f"--display={os.environ['DISPLAY']}")
+            # 容器环境（无论有无 DISPLAY 都加上，避免切换环境后出错）
+            co.set_argument("--no-sandbox")
+            co.set_argument("--disable-setuid-sandbox")
+            co.set_argument("--disable-dev-shm-usage")
+            co.set_argument("--disable-gpu")
 
             # 无头模式
             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:
@@ -146,17 +146,27 @@ class StealthBrowser:
             self._browser = Chromium(co)
             self._page = self._browser.latest_tab
 
+            # 如果浏览器已崩溃或无法获取 tab
+            if not self._page:
+                return SkillResult(
+                    success=False,
+                    error="启动浏览器后无法获取页面标签（Chrome 可能未正确启动）",
+                )
+
             # 隐藏 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: {}};
-                """)
+                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}")
 
+            # 等待浏览器完全就绪
+            time.sleep(1)
+
             self._started = True
             logger.info(
                 f"反检测浏览器已启动 (profile={self.profile_name}, "
@@ -177,17 +187,18 @@ class StealthBrowser:
 
     async def close(self) -> SkillResult:
         """关闭浏览器"""
+        self._started = False
         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
+            self._browser = None
+            self._page = None
         return SkillResult(success=True, message="浏览器已关闭")
 
     async def navigate(self, url: str, wait: float = 2.0) -> SkillResult:
@@ -198,7 +209,7 @@ class StealthBrowser:
         try:
             self._page.get(url)
             if wait > 0:
-                time.sleep(wait)
+                await asyncio.sleep(wait)
 
             title = self._page.title or ""
             current_url = self._page.url or ""
@@ -225,7 +236,7 @@ class StealthBrowser:
                 )
             ele.click()
             if wait > 0:
-                time.sleep(wait)
+                await asyncio.sleep(wait)
             return SkillResult(success=True, message=f"已点击: {selector}")
         except Exception as e:
             return SkillResult(success=False, error=f"点击失败: {e}")
@@ -248,7 +259,7 @@ class StealthBrowser:
                 ele.clear()
             ele.input(value)
             if wait > 0:
-                time.sleep(wait)
+                await asyncio.sleep(wait)
             return SkillResult(
                 success=True,
                 message=f"已填写 {selector}: {value[:50]}{'...' if len(value) > 50 else ''}",
@@ -303,7 +314,17 @@ class StealthBrowser:
             return SkillResult(success=False, error="浏览器未启动")
 
         try:
-            text = self._page.text or ""
+            # Bug Fix: DrissionPage 没有 page.text 属性
+            # 需要通过 page.ele('tag:html').text 获取页面文本
+            try:
+                text = self._page.ele('tag:html').text or ""
+            except Exception:
+                # 降级：用 BS4 从 html 提取文本
+                try:
+                    from bs4 import BeautifulSoup
+                    text = BeautifulSoup(self._page.html or "", "html.parser").get_text(strip=True, separator="\n")
+                except Exception:
+                    text = ""
             title = self._page.title or ""
             url = self._page.url or ""
 
@@ -375,16 +396,21 @@ class StealthBrowser:
             return SkillResult(success=False, error="浏览器未启动")
 
         try:
+            # DrissionPage cookies() 返回 CookiesList（list 子类），每项是 dict
             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", "/"),
-                    })
+                    # CookiesList 中的每项是 dict，但 key 可能不全
+                    if isinstance(c, dict):
+                        cookie_list.append({
+                            "name": c.get("name", ""),
+                            "value": c.get("value", ""),
+                            "domain": c.get("domain", ""),
+                            "path": c.get("path", "/"),
+                        })
+                    else:
+                        cookie_list.append(str(c))
 
             return SkillResult(
                 success=True,
@@ -404,10 +430,15 @@ class StealthBrowser:
             cookie_list = []
             if cookies:
                 for c in cookies:
-                    cookie_list.append(dict(c))
+                    # CookiesList 中每项是 dict，确保可序列化
+                    if isinstance(c, dict):
+                        cookie_list.append(dict(c))
+                    else:
+                        cookie_list.append(str(c))
 
             from core.browser_profile import get_browser_profile_manager
             mgr = get_browser_profile_manager()
+            # 保存时用 profile_name 对应的原始 BrowserProfile（不加 user_data 子路径）
             profile = mgr.get_profile(self.profile_name)
             profile.save_cookies(cookie_list)
 
@@ -430,6 +461,8 @@ class StealthBrowser:
             cookies = profile.load_cookies()
 
             if cookies:
+                # Bug Fix: page.set.cookies 是 CookiesSetter 对象（可调用）
+                # 直接调用 page.set.cookies(cookies_list) 即可
                 self._page.set.cookies(cookies)
                 return SkillResult(
                     success=True,
@@ -449,7 +482,13 @@ class StealthBrowser:
             return SkillResult(success=False, error="浏览器未启动")
 
         try:
-            self._page.clear_cookies()
+            # Bug Fix: DrissionPage 没有 page.clear_cookies() 方法
+            # 正确方式是 page.set.cookies.clear() 或 page.clear_cache()
+            try:
+                self._page.set.cookies.clear()
+            except Exception:
+                self._page.clear_cache(cookies=True)
+
             from core.browser_profile import get_browser_profile_manager
             mgr = get_browser_profile_manager()
             profile = mgr.get_profile(self.profile_name)
@@ -479,13 +518,17 @@ class StealthBrowser:
         )
         logger.info(f"[{self.profile_name}] 等待用户手动操作: {reason}")
 
-        # 简单的等待机制：轮询页面变化
+        # Bug Fix: 使用 asyncio.sleep 避免阻塞事件循环
         start = time.time()
         last_url = self._page.url if self._page else ""
+        poll_interval = 3
         while time.time() - start < timeout:
-            time.sleep(3)
+            await asyncio.sleep(poll_interval)
             if self._page:
-                current_url = self._page.url or ""
+                try:
+                    current_url = self._page.url or ""
+                except Exception:
+                    break  # 浏览器已关闭
                 # 如果 URL 发生变化，说明用户完成了操作
                 if current_url != last_url and current_url:
                     elapsed = int(time.time() - start)
@@ -506,11 +549,13 @@ class StealthBrowser:
         if not self._started or not self._page:
             return False
         try:
-            # 检查页面是否仍然有效
+            # 检查页面是否仍然有效（try 访问 url，如果浏览器已崩溃会抛异常）
             _ = self._page.url
             return True
         except Exception:
-            self._started = False
+            # 不要在这里重置 _started，由 close() 方法负责
+            # 避免在异步上下文中误判
+            logger.debug(f"页面检查失败 (profile={self.profile_name})，浏览器可能已关闭")
             return False
 
     @staticmethod
@@ -560,10 +605,10 @@ class StealthBrowser:
 # ── 全局浏览器实例管理 ──────────────────────────────────────
 
 _browsers: Dict[str, StealthBrowser] = {}
-_browser_lock = asyncio.Lock()
+_browser_lock = threading.Lock()
 
 
-async def get_stealth_browser(
+def get_stealth_browser(
     profile_name: str = "default",
     headless: bool = False,
 ) -> StealthBrowser:
@@ -571,8 +616,9 @@ async def get_stealth_browser(
     获取反检测浏览器实例（按 profile_name 复用）。
 
     同一 profile 名称返回相同实例，避免重复启动。
+    Bug Fix: 改用同步锁 + 同步返回，避免在非 async 上下文中死锁。
     """
-    async with _browser_lock:
+    with _browser_lock:
         if profile_name in _browsers:
             browser = _browsers[profile_name]
             if browser._started and browser._ensure_page():
@@ -583,21 +629,37 @@ async def get_stealth_browser(
         return browser
 
 
-async def close_stealth_browser(profile_name: str = "") -> None:
-    """关闭浏览器实例"""
-    async with _browser_lock:
+def close_stealth_browser(profile_name: str = "") -> None:
+    """关闭浏览器实例（同步版本）"""
+    with _browser_lock:
         if profile_name and profile_name in _browsers:
-            await _browsers[profile_name].close()
+            browser = _browsers[profile_name]
+            # 同步调用内部关闭逻辑
+            browser._started = False
+            try:
+                if browser._browser:
+                    browser._browser.quit()
+            except Exception:
+                pass
+            browser._browser = None
+            browser._page = None
             del _browsers[profile_name]
         elif not profile_name:
             for name, browser in _browsers.items():
                 try:
-                    await browser.close()
+                    browser._started = False
+                    if browser._browser:
+                        browser._browser.quit()
                 except Exception:
                     pass
             _browsers.clear()
 
 
+async def close_stealth_browser_async(profile_name: str = "") -> None:
+    """关闭浏览器实例（异步版本，供 async 上下文调用）"""
+    close_stealth_browser(profile_name)
+
+
 # ── 技能类（供 SkillRegistry 自动发现）─────────────────────
 
 
@@ -783,7 +845,8 @@ class StealthBrowserCloseSkill(Skill):
     ]
 
     async def execute(self, profile: str = "", **kw) -> SkillResult:
-        await close_stealth_browser(profile_name=profile)
+        # close_stealth_browser 现在是同步函数，直接调用
+        close_stealth_browser(profile_name=profile)
         return SkillResult(success=True, message="浏览器已关闭")
 
 

package/aiskills/site-douyin/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: site-douyin
+description: |
+  抖音操作指南 — 使用反检测浏览器操作抖音网页版，包括登录、浏览、发布视频、评论等。
+  依赖 stealth browser (DrissionPage)，使用独立 Profile: douyin
+metadata:
+  category: site_operation
+  version: "1.30.0"
+  requires: ["stealth-browser"]
+  profile: "douyin"
+---
+
+# 抖音操作
+
+## 概述
+
+使用反检测浏览器操作抖音网页版。Profile 名称: `douyin`。
+
+## 前置条件
+
+1. 首次使用需要用户登录抖音
+2. 抖音支持手机号登录、扫码登录、第三方登录
+3. 登录成功后保存 Cookie
+
+## 操作流程
+
+### 1. 首次登录设置
+
+```bash
+stealth-open douyin --no-headless
+stealth-navigate https://www.douyin.com/ -p douyin
+stealth-screenshot -p douyin
+
+# 抖音通常弹出登录提示
+# 手机号登录：
+stealth-click 'text=手机号登录' -p douyin
+stealth-wait 1 -p douyin
+stealth-fill 'input[type="tel"]' '手机号' -p douyin
+stealth-click 'button:contains("获取验证码")' -p douyin
+stealth-wait-manual "输入短信验证码" -t 300 -p douyin
+
+# 或者直接等待用户扫码
+stealth-wait-manual "抖音登录" -t 300 -p douyin
+
+stealth-cookies save -p douyin
+stealth-close douyin
+```
+
+### 2. 浏览首页推荐
+
+```bash
+stealth-open douyin --no-headless
+stealth-navigate https://www.douyin.com/ -p douyin
+stealth-wait 5 -p douyin
+stealth-screenshot -p douyin
+stealth-content -p douyin
+```
+
+### 3. 搜索视频
+
+```bash
+stealth-navigate 'https://www.douyin.com/search/关键词' -p douyin
+stealth-wait 5 -p douyin
+stealth-content -p douyin
+stealth-screenshot -p douyin
+```
+
+### 4. 发布视频
+
+```bash
+# 进入创作者中心
+stealth-navigate https://creator.douyin.com/ -p douyin
+stealth-wait 5 -p douyin
+stealth-screenshot -p douyin
+
+# 点击发布视频
+stealth-click 'text=发布视频' -p douyin
+stealth-wait 2 -p douyin
+
+# 抖音网页版上传视频需要通过文件选择器
+# 注意：网页版上传功能可能有限制
+stealth-screenshot -p douyin
+stealth-content -p douyin
+```
+
+### 5. 查看个人主页
+
+```bash
+stealth-navigate https://www.douyin.com/ -p douyin
+stealth-wait 3 -p douyin
+stealth-click 'div[data-e2e="user-info"]' -p douyin
+stealth-wait 3 -p douyin
+stealth-content -p douyin
+```
+
+### 6. 评论
+
+```bash
+# 打开视频页面后
+stealth-click 'div[data-e2e="feed-comment-icon"]' -p douyin
+stealth-wait 1 -p douyin
+stealth-fill 'input[data-e2e="comment-input"]' '评论内容...' -p douyin
+stealth-click 'button:contains("发送")' -p douyin
+stealth-wait 3 -p douyin
+```
+
+## 抖音常用 URL
+
+| 功能 | URL |
+|---|---|
+| 首页 | `https://www.douyin.com/` |
+| 搜索 | `https://www.douyin.com/search/关键词` |
+| 创作者中心 | `https://creator.douyin.com/` |
+| 数据中心 | `https://creator.douyin.com/data` |
+| 热榜 | `https://www.douyin.com/hot` |
+
+## 重要提示
+
+1. 抖音网页版功能有限，部分操作（如发布视频）可能需要创作者中心
+2. 抖音对自动化操作检测严格，反检测浏览器必不可少
+3. 上传视频需要处理文件选择器，可能需要使用 `stealth-eval` 执行 JS
+4. 抖音页面使用大量前端框架渲染，元素加载需要充分等待
+5. Cookie 过期较快，频繁操作时注意检查登录状态

package/aiskills/site-gmail/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: site-gmail
+description: |
+  Gmail 邮箱操作指南 — 使用反检测浏览器操作 Gmail，包括登录、收发邮件、搜索邮件、读取邮件内容等。
+  依赖 stealth browser (DrissionPage)，使用独立 Profile: gmail
+metadata:
+  category: site_operation
+  version: "1.30.0"
+  requires: ["stealth-browser"]
+  profile: "gmail"
+---
+
+# Gmail 邮箱操作
+
+## 概述
+
+使用反检测浏览器操作 Gmail 邮箱。Profile 名称: `gmail`。
+
+## 前置条件
+
+1. 首次使用前，需要用户通过 `stealth-wait-manual` 手动完成 Google 登录（含验证码/2FA）
+2. 登录成功后执行 `stealth-cookies save` 保存登录状态
+3. 后续访问自动恢复登录态
+
+## 操作流程
+
+### 1. 首次登录设置
+
+```bash
+stealth-open gmail --no-headless
+stealth-navigate https://accounts.google.com/signin -p gmail
+stealth-screenshot -p gmail
+
+# 填写账号密码（如果页面允许自动化填写）
+stealth-fill 'input[type="email"]' 'user@gmail.com' -p gmail
+stealth-click 'button:contains("下一步")' -p gmail
+stealth-wait 'input[type="password"]' -p gmail
+stealth-fill 'input[type="password"]' 'password' -p gmail
+stealth-click 'button:contains("下一步")' -p gmail
+
+# 如果出现验证码，等待用户手动操作
+stealth-wait-manual "Google验证码或2FA" -t 300 -p gmail
+
+# 登录成功后保存 Cookie
+stealth-cookies save -p gmail
+stealth-close gmail
+```
+
+### 2. 读取收件箱邮件
+
+```bash
+stealth-open gmail --no-headless
+stealth-navigate https://mail.google.com/mail/u/0/#inbox -p gmail
+stealth-wait 'table[class="F cf zt"]' -t 15 -p gmail
+stealth-screenshot -p gmail
+stealth-content -p gmail
+```
+
+### 3. 搜索邮件
+
+```bash
+stealth-navigate 'https://mail.google.com/mail/u/0/#search/关键词' -p gmail
+stealth-wait 3 -p gmail
+stealth-screenshot -p gmail
+stealth-content -p gmail
+```
+
+### 4. 读取邮件详情
+
+```bash
+# 点击邮件主题行打开邮件
+stealth-click 'tr.zE:contains("邮件主题关键词")' -p gmail
+stealth-wait 2 -p gmail
+stealth-content -p gmail
+stealth-screenshot -p gmail
+```
+
+### 5. 发送邮件
+
+```bash
+# 点击写邮件按钮
+stealth-click 'div.T-I.T-I-KE.L3' -p gmail
+stealth-wait 'textarea[name="to"]' -p gmail
+
+# 填写收件人
+stealth-fill 'textarea[name="to"]' 'recipient@example.com' -p gmail
+
+# 填写主题
+stealth-fill 'input[name="subjectbox"]' '邮件主题' -p gmail
+
+# 填写正文
+stealth-fill 'div[aria-label="邮件正文"]' '邮件正文内容' -p gmail
+
+# 点击发送
+stealth-click 'div.T-I.T-I-KE.L3:contains("发送")' -p gmail
+stealth-wait 3 -p gmail
+stealth-screenshot -p gmail
+```
+
+### 6. 查看附件
+
+```bash
+# 打开含附件的邮件后
+stealth-content -p gmail
+# 附件链接会出现在页面内容中
+```
+
+## Gmail 常用 URL
+
+| 功能 | URL |
+|---|---|
+| 收件箱 | `https://mail.google.com/mail/u/0/#inbox` |
+| 已发送 | `https://mail.google.com/mail/u/0/#sent` |
+| 草稿箱 | `https://mail.google.com/mail/u/0/#drafts` |
+| 垃圾邮件 | `https://mail.google.com/mail/u/0/#spam` |
+| 搜索 | `https://mail.google.com/mail/u/0/#search/关键词` |
+
+## 重要提示
+
+1. Google 登录安全严格，首次登录大概率需要人工处理验证码/手机验证
+2. 建议使用 `--no-headless` 有头模式，方便通过 VNC 观察和操作
+3. Gmail 页面使用大量动态渲染，导航后需要 `stealth-wait` 等待元素加载
+4. 如果 Cookie 失效，需要重新走登录流程
+5. Google 可能检测到新设备/IP 并要求安全验证

package/aiskills/site-mail139/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: site-mail139
+description: |
+  139邮箱操作指南 — 使用反检测浏览器操作中国移动139邮箱，包括登录、收发邮件、搜索邮件等。
+  依赖 stealth browser (DrissionPage)，使用独立 Profile: mail139
+metadata:
+  category: site_operation
+  version: "1.30.0"
+  requires: ["stealth-browser"]
+  profile: "mail139"
+---
+
+# 139邮箱操作
+
+## 概述
+
+使用反检测浏览器操作中国移动139邮箱。Profile 名称: `mail139`。
+
+## 前置条件
+
+1. 首次使用需要用户登录139邮箱
+2. 支持139手机号+密码、短信验证登录
+3. 登录成功后保存 Cookie
+
+## 操作流程
+
+### 1. 首次登录设置
+
+```bash
+stealth-open mail139 --no-headless
+stealth-navigate https://mail.10086.cn/ -p mail139
+stealth-screenshot -p mail139
+
+# 填写手机号和密码
+stealth-fill 'input[name="UserName"]' '139xxxxx' -p mail139
+stealth-fill 'input[name="Password"]' 'password' -p mail139
+stealth-click 'input[type="submit"]' -p mail139
+
+# 可能需要短信验证
+stealth-wait-manual "139邮箱短信验证" -t 300 -p mail139
+
+stealth-cookies save -p mail139
+stealth-close mail139
+```
+
+### 2. 读取收件箱
+
+```bash
+stealth-open mail139 --no-headless
+stealth-navigate https://mail.10086.cn/ -p mail139
+stealth-cookies load -p mail139
+stealth-wait 5 -p mail139
+stealth-screenshot -p mail139
+stealth-content -p mail139
+```
+
+### 3. 搜索邮件
+
+```bash
+stealth-navigate 'https://mail.10086.cn/rm/mailbox' -p mail139
+stealth-wait 3 -p mail139
+stealth-fill 'input[placeholder*="搜索"]' '搜索关键词' -p mail139
+stealth-click 'button:contains("搜索")' -p mail139
+stealth-wait 3 -p mail139
+stealth-content -p mail139
+```
+
+### 4. 发送邮件
+
+```bash
+# 点击写邮件
+stealth-click 'text=写邮件' -p mail139
+stealth-wait 2 -p mail139
+
+# 填写收件人
+stealth-fill 'input[name="to"]' 'recipient@example.com' -p mail139
+
+# 填写主题
+stealth-fill 'input[name="subject"]' '邮件主题' -p mail139
+
+# 填写正文
+stealth-fill 'body#ComposeBody' '邮件正文内容...' -p mail139
+
+# 发送
+stealth-click 'text=发送' -p mail139
+stealth-wait 3 -p mail139
+stealth-screenshot -p mail139
+```
+
+### 5. 读取邮件详情
+
+```bash
+# 点击邮件列表中的邮件
+stealth-click 'div.mailItem:contains("邮件主题")' -p mail139
+stealth-wait 2 -p mail139
+stealth-content -p mail139
+stealth-screenshot -p mail139
+```
+
+## 139邮箱常用 URL
+
+| 功能 | URL |
+|---|---|
+| 登录页 | `https://mail.10086.cn/` |
+| 收件箱 | `https://mail.10086.cn/rm/mailbox` |
+| 已发送 | `https://mail.10086.cn/rm/sent` |
+| 草稿箱 | `https://mail.10086.cn/rm/drafts` |
+| 通讯录 | `https://mail.10086.cn/rm/contacts` |
+
+## 重要提示
+
+1. 139邮箱登录时可能需要短信验证码，使用 `stealth-wait-manual` 等待用户输入
+2. 139邮箱页面结构相对传统，选择器较稳定
+3. Cookie 有效期通常较长（几天到几周）
+4. 139邮箱支持附件上传，可通过文件选择器操作

package/aiskills/site-wechat-mp/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: site-wechat-mp
+description: |
+  微信公众号平台操作指南 — 使用反检测浏览器操作微信公众号后台，包括登录、发布图文、查看数据等。
+  依赖 stealth browser (DrissionPage)，使用独立 Profile: wechat_mp
+metadata:
+  category: site_operation
+  version: "1.30.0"
+  requires: ["stealth-browser"]
+  profile: "wechat_mp"
+---
+
+# 微信公众号平台操作
+
+## 概述
+
+使用反检测浏览器操作微信公众号后台管理平台。Profile 名称: `wechat_mp`。
+
+## 前置条件
+
+1. 首次使用需要用户**扫码登录**微信公众号后台
+2. 微信公众号后台仅支持扫码登录，无法通过账号密码自动登录
+3. 登录成功后保存 Cookie
+4. Cookie 有效期通常为几小时到一天
+
+## 操作流程
+
+### 1. 首次登录设置（必须人工扫码）
+
+```bash
+stealth-open wechat_mp --no-headless
+stealth-navigate https://mp.weixin.qq.com/ -p wechat_mp
+stealth-screenshot -p wechat_mp
+
+# 等待用户扫码登录
+stealth-wait-manual "扫码登录微信公众号" -t 300 -p wechat_mp
+
+# 登录成功后保存 Cookie
+stealth-cookies save -p wechat_mp
+stealth-screenshot -p wechat_mp
+```
+
+### 2. 发布图文消息
+
+```bash
+stealth-open wechat_mp --no-headless
+stealth-navigate https://mp.weixin.qq.com/ -p wechat_mp
+stealth-cookies load -p wechat_mp
+stealth-wait 3 -p wechat_mp
+
+# 进入素材管理 -> 新建图文
+stealth-click 'text=素材管理' -p wechat_mp
+stealth-wait 2 -p wechat_mp
+stealth-click 'text=新建图文' -p wechat_mp
+stealth-wait 3 -p wechat_mp
+
+# 填写标题
+stealth-fill 'input#title' '文章标题' -p wechat_mp
+
+# 填写作者（可选）
+stealth-fill 'input#author' '作者名' -p wechat_mp
+
+# 填写正文
+# 微信编辑器使用 iframe 或 contenteditable div
+stealth-click 'div#edui1_body' -p wechat_mp
+stealth-fill 'div#edui1_body' '文章正文内容...' -p wechat_mp
+
+# 保存并群发
+stealth-screenshot -p wechat_mp
+```
+
+### 3. 查看消息
+
+```bash
+stealth-navigate https://mp.weixin.qq.com/cgi-bin/message?t=message/list -p wechat_mp
+stealth-wait 3 -p wechat_mp
+stealth-content -p wechat_mp
+stealth-screenshot -p wechat_mp
+```
+
+### 4. 查看用户管理
+
+```bash
+stealth-navigate https://mp.weixin.qq.com/cgi-bin/contactmanagepage?t=user/index -p wechat_mp
+stealth-wait 3 -p wechat_mp
+stealth-content -p wechat_mp
+```
+
+### 5. 查看数据统计
+
+```bash
+stealth-navigate https://mp.weixin.qq.com/cgi-bin/home?t=home/index -p wechat_mp
+stealth-wait 3 -p wechat_mp
+stealth-content -p wechat_mp
+stealth-screenshot -p wechat_mp
+```
+
+## 微信公众号常用 URL
+
+| 功能 | URL |
+|---|---|
+| 首页 | `https://mp.weixin.qq.com/cgi-bin/home?t=home/index` |
+| 消息管理 | `https://mp.weixin.qq.com/cgi-bin/message?t=message/list` |
+| 素材管理 | `https://mp.weixin.qq.com/cgi-bin/appmsg?t=media/appmsg_edit` |
+| 用户管理 | `https://mp.weixin.qq.com/cgi-bin/contactmanagepage?t=user/index` |
+| 数据统计 | `https://mp.weixin.qq.com/cgi-bin/stats` |
+| 设置 | `https://mp.weixin.qq.com/cgi-bin/settingpage?t=setting/index` |
+
+## 重要提示
+
+1. 微信公众号后台**仅支持扫码登录**，无法自动化输入账号密码
+2. Cookie 有效期较短（几小时），可能需要频繁重新登录
+3. 微信编辑器结构复杂，操作前务必截图确认
+4. 群发操作有频率限制，每日 1 次服务号、多次订阅号
+5. 敏感操作（群发/删除）可能需要管理员二次确认
+6. 建议配合 `--no-headless` 和 VNC 使用，方便观察扫码页面

package/aiskills/site-weibo/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: site-weibo
+description: |
+  微博 操作指南 — 使用反检测浏览器操作新浪微博，包括登录、浏览、发微博、转发、评论等。
+  依赖 stealth browser (DrissionPage)，使用独立 Profile: weibo
+metadata:
+  category: site_operation
+  version: "1.30.0"
+  requires: ["stealth-browser"]
+  profile: "weibo"
+---
+
+# 微博操作
+
+## 概述
+
+使用反检测浏览器操作新浪微博。Profile 名称: `weibo`。
+
+## 前置条件
+
+1. 首次使用需要用户手动完成微博登录
+2. 登录成功后保存 Cookie
+3. 后续访问自动恢复登录态
+
+## 操作流程
+
+### 1. 首次登录设置
+
+```bash
+stealth-open weibo --no-headless
+stealth-navigate https://passport.weibo.com/sso/signin -p weibo
+stealth-screenshot -p weibo
+
+# 微博支持多种登录方式（账号密码/手机/扫码）
+# 账号密码登录：
+stealth-fill 'input[name="username"]' 'username' -p weibo
+stealth-fill 'input[name="password"]' 'password' -p weibo
+stealth-click 'a[action-type="submit"]' -p weibo
+
+# 可能需要验证码
+stealth-wait-manual "微博验证码" -t 300 -p weibo
+
+stealth-cookies save -p weibo
+stealth-close weibo
+```
+
+### 2. 浏览首页
+
+```bash
+stealth-open weibo --no-headless
+stealth-navigate https://weibo.com/ -p weibo
+stealth-wait 5 -p weibo
+stealth-screenshot -p weibo
+stealth-content -p weibo
+```
+
+### 3. 发布微博
+
+```bash
+# 点击发微博按钮
+stealth-click 'textarea.WB_feed_editor' -p weibo
+stealth-wait 1 -p weibo
+
+# 输入微博内容
+stealth-fill 'textarea.WB_feed_editor' '微博内容...' -p weibo
+stealth-wait 1 -p weibo
+
+# 点击发布按钮
+stealth-click 'a[action-type="publish"]' -p weibo
+stealth-wait 3 -p weibo
+stealth-screenshot -p weibo
+```
+
+### 4. 转发微博
+
+```bash
+# 打开目标微博页面
+stealth-navigate 'https://weibo.com/detail/微博ID' -p weibo
+stealth-wait 3 -p weibo
+
+# 点击转发
+stealth-click 'a[action-type="fl_forward"]' -p weibo
+stealth-wait 1 -p weibo
+
+# 填写转发理由（可选）
+stealth-fill 'textarea.WB_feed_editor' '转发理由...' -p weibo
+
+# 确认转发
+stealth-click 'a[action-type="forward"]' -p weibo
+stealth-wait 3 -p weibo
+```
+
+### 5. 评论
+
+```bash
+stealth-click 'a[action-type="fl_comment"]' -p weibo
+stealth-wait 1 -p weibo
+stealth-fill 'textarea.WB_feed_editor' '评论内容...' -p weibo
+stealth-click 'a[action-type="comment"]' -p weibo
+stealth-wait 3 -p weibo
+```
+
+### 6. 搜索
+
+```bash
+stealth-navigate 'https://s.weibo.com/weibo?q=关键词' -p weibo
+stealth-wait 5 -p weibo
+stealth-content -p weibo
+```
+
+### 7. 查看用户主页
+
+```bash
+stealth-navigate https://weibo.com/u/用户ID -p weibo
+stealth-wait 3 -p weibo
+stealth-content -p weibo
+```
+
+## 微博常用 URL
+
+| 功能 | URL |
+|---|---|
+| 首页 | `https://weibo.com/` |
+| 热搜 | `https://s.weibo.com/top/summary` |
+| 搜索 | `https://s.weibo.com/weibo?q=关键词` |
+| 微博详情 | `https://weibo.com/detail/微博ID` |
+| 个人主页 | `https://weibo.com/u/用户ID` |
+| 超话 | `https://weibo.com/p/page/超话ID` |
+
+## 重要提示
+
+1. 微博有完善的反爬机制，建议使用 DrissionPage 反检测模式
+2. 操作频率不要过高，避免被系统判定为机器行为
+3. 微博页面元素经常变动，操作前务必截图确认当前页面结构
+4. 微博可能弹出各种验证，使用 `stealth-wait-manual` 处理

package/aiskills/site-x-com/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: site-x-com
+description: |
+  X.com (Twitter) 操作指南 — 使用反检测浏览器操作 X.com，包括登录、浏览时间线、发推文、回复、点赞等。
+  依赖 stealth browser (DrissionPage)，使用独立 Profile: x_com
+metadata:
+  category: site_operation
+  version: "1.30.0"
+  requires: ["stealth-browser"]
+  profile: "x_com"
+---
+
+# X.com (Twitter) 操作
+
+## 概述
+
+使用反检测浏览器操作 X.com (Twitter)。Profile 名称: `x_com`。
+
+## 前置条件
+
+1. 首次使用需要用户手动完成 X.com 登录
+2. 登录成功后保存 Cookie
+3. 后续访问自动恢复登录态
+
+## 操作流程
+
+### 1. 首次登录设置
+
+```bash
+stealth-open x_com --no-headless
+stealth-navigate https://x.com/i/flow/login -p x_com
+stealth-screenshot -p x_com
+
+# X.com 登录流程
+stealth-fill 'input[autocomplete="username"]' 'username' -p x_com
+stealth-click 'text=下一步' -p x_com
+stealth-wait 'input[autocomplete="current-password"]' -p x_com
+stealth-fill 'input[autocomplete="current-password"]' 'password' -p x_com
+stealth-click 'text=登录' -p x_com
+
+# 可能需要验证码
+stealth-wait-manual "X.com验证" -t 300 -p x_com
+
+stealth-cookies save -p x_com
+stealth-close x_com
+```
+
+### 2. 浏览首页时间线
+
+```bash
+stealth-open x_com --no-headless
+stealth-navigate https://x.com/home -p x_com
+stealth-wait 'article' -t 15 -p x_com
+stealth-screenshot -p x_com
+stealth-content -p x_com
+```
+
+### 3. 发布推文
+
+```bash
+stealth-navigate https://x.com/compose/post -p x_com
+
+# 点击发推文区域
+stealth-click 'div[data-testid="tweetTextarea_0"]' -p x_com
+stealth-wait 1 -p x_com
+
+# 输入推文内容
+stealth-fill 'div[data-testid="tweetTextarea_0"]' '推文内容...' -p x_com
+stealth-wait 1 -p x_com
+
+# 点击发送按钮
+stealth-click 'button[data-testid="tweetButton"]' -p x_com
+stealth-wait 3 -p x_com
+stealth-screenshot -p x_com
+```
+
+### 4. 回复推文
+
+```bash
+# 先导航到目标推文页面
+stealth-navigate 'https://x.com/用户名/status/推文ID' -p x_com
+stealth-wait 'article' -t 10 -p x_com
+
+# 点击回复框
+stealth-click 'div[data-testid="tweetTextarea_0"]' -p x_com
+stealth-fill 'div[data-testid="tweetTextarea_0"]' '回复内容...' -p x_com
+
+# 发送回复
+stealth-click 'button[data-testid="tweetButtonInline"]' -p x_com
+stealth-wait 3 -p x_com
+```
+
+### 5. 点赞/转推
+
+```bash
+# 点赞
+stealth-click 'button[data-testid="like"]' -p x_com
+
+# 转推
+stealth-click 'button[data-testid="retweet"]' -p x_com
+stealth-click 'div[role="menuitem"]:contains("转推")' -p x_com
+```
+
+### 6. 搜索
+
+```bash
+stealth-navigate 'https://x.com/search?q=关键词&src=typed_query&f=top' -p x_com
+stealth-wait 'article' -t 10 -p x_com
+stealth-content -p x_com
+```
+
+### 7. 查看用户资料
+
+```bash
+stealth-navigate https://x.com/用户名 -p x_com
+stealth-wait 3 -p x_com
+stealth-content -p x_com
+stealth-screenshot -p x_com
+```
+
+## X.com 常用 URL
+
+| 功能 | URL |
+|---|---|
+| 首页时间线 | `https://x.com/home` |
+| 发推文 | `https://x.com/compose/post` |
+| 通知 | `https://x.com/notifications` |
+| 消息 | `https://x.com/messages` |
+| 搜索 | `https://x.com/search?q=关键词` |
+| 用户资料 | `https://x.com/用户名` |
+| 个人设置 | `https://x.com/settings/account` |
+
+## 重要提示
+
+1. X.com 对自动化检测较为严格，DrissionPage 反检测模式可降低风险
+2. 发推文、点赞等操作不宜过于频繁，避免触发频率限制
+3. X.com 页面频繁更新，data-testid 选择器可能变化，操作前先截图确认
+4. 建议操作间隔 3-5 秒，模拟人类操作节奏

package/aiskills/stealth_browser/SKILL.md

@@ -6,7 +6,7 @@ description: |
   每个网站使用独立 Profile，登录一次后 Cookie 自动保持，无需重复登录。
 metadata:
   category: browser_stealth
-  version: "1.29.0"
+  version: "1.30.0"
 ---
 
 # 反检测浏览器 (Stealth Browser)

package/core/browser_profile.py

@@ -141,8 +141,14 @@ class BrowserProfile:
         self.profile_dir.mkdir(parents=True, exist_ok=True)
 
     def is_initialized(self) -> bool:
-        """检查 Profile 是否已初始化（有 user_data 目录）"""
-        return self.user_data_dir.is_dir()
+        """检查 Profile 是否已初始化（有 profile 目录且包含浏览器数据）"""
+        if not self.profile_dir.is_dir():
+            return False
+        # 检查目录下是否有实际内容（不空）
+        try:
+            return any(self.profile_dir.iterdir())
+        except OSError:
+            return False
 
     def get_size_mb(self) -> float:
         """获取 Profile 占用空间（MB）"""

package/main.py

@@ -426,6 +426,30 @@ class MyAgentApp:
         ]:
             self.skill_registry.register(skill_cls())
 
+        # ── 反检测浏览器技能 (DrissionPage — v1.30.0) ──
+        try:
+            from aiskills.browser_stealth import (
+                StealthBrowserStartSkill, StealthBrowserNavigateSkill,
+                StealthBrowserClickSkill, StealthBrowserFillSkill,
+                StealthBrowserScreenshotSkill, StealthBrowserEvalSkill,
+                StealthBrowserGetContentSkill, StealthBrowserCookieSkill,
+                StealthBrowserCloseSkill, StealthBrowserWaitManualSkill,
+                StealthBrowserWaitSkill,
+                BrowserProfileListSkill, BrowserProfileCreateSkill, BrowserProfileDeleteSkill,
+            )
+            for skill_cls in [
+                StealthBrowserStartSkill, StealthBrowserNavigateSkill,
+                StealthBrowserClickSkill, StealthBrowserFillSkill,
+                StealthBrowserScreenshotSkill, StealthBrowserEvalSkill,
+                StealthBrowserGetContentSkill, StealthBrowserCookieSkill,
+                StealthBrowserCloseSkill, StealthBrowserWaitManualSkill,
+                StealthBrowserWaitSkill,
+                BrowserProfileListSkill, BrowserProfileCreateSkill, BrowserProfileDeleteSkill,
+            ]:
+                self.skill_registry.register(skill_cls())
+        except ImportError as e:
+            self.logger.warning(f"反检测浏览器技能注册跳过（DrissionPage 未安装）: {e}")
+
         # ── [v1.22.0] 内置平台工具不再注册存根 ──
         # command, recall_memory, file_send, playaudio, playvideo, web_control
         # 由 ToolDispatcher 直接处理，其元数据通过 BUILTIN_TOOLS 常量

package/package.json

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

package/scripts/cli.py

@@ -859,7 +859,8 @@ async def cmd_stealth_close(args):
     a = p.parse_args(args)
 
     from aiskills.browser_stealth import close_stealth_browser
-    await close_stealth_browser(profile_name=a.profile)
+    # close_stealth_browser 现在是同步函数
+    close_stealth_browser(profile_name=a.profile)
     print("反检测浏览器已关闭")
 
 

package/worklog.md

@@ -1,4 +1,29 @@
 ---
+Task ID: [20260421-01]
+Agent: Main Agent
+Task: 反检测浏览器集成 - Phase 2 网站专用技能 (v1.30.0)
+
+Work Log:
+- 检查现有实现状态：browser_stealth.py + browser_profile.py + CLI + SKILL.md 已在之前的会话中完成
+- 修复 main.py _register_builtin_skills()：添加 13 个 stealth browser 技能类注册
+- 创建 6 个网站专用 SKILL.md 操作指南：
+  * aiskills/site-gmail/SKILL.md — Gmail 收发邮件、搜索、附件
+  * aiskills/site-x-com/SKILL.md — X.com 发推、回复、搜索、点赞
+  * aiskills/site-weibo/SKILL.md — 微博发帖、转发、评论、搜索
+  * aiskills/site-wechat-mp/SKILL.md — 微信公众号扫码登录、图文发布
+  * aiskills/site-douyin/SKILL.md — 抖音浏览、搜索、发布视频、评论
+  * aiskills/site-mail139/SKILL.md — 139邮箱收发邮件、搜索
+- 更新版本号 1.29.0 → 1.30.0
+- Git commit + push + npm publish
+
+Stage Summary:
+- 修复: stealth browser 技能类注册到 SkillRegistry
+- 新增: 6 个网站操作 SKILL.md 指南 (约 20KB 内容)
+- 发布: myagent-ai@1.30.0 (npm + GitHub)
+- 架构: LLM → command 工具 → stealth-* CLI → DrissionPage → 各网站
+
+---
+
 Task ID: [20260420-04]
 Agent: Main Agent
 Task: 发布 npm 包 myagent-ai v1.26.0