myagent-ai 1.30.1 → 1.31.0

package/aiskills/browser_stealth.py

@@ -669,15 +669,15 @@ class StealthBrowserStartSkill(Skill):
     name = "stealth_browser_start"
     description = (
         "启动反检测浏览器 — 使用 DrissionPage 启动带有反检测能力的 Chromium 浏览器，"
-        "适合需要登录的网站操作（Google/X.com/微博/抖音等）。"
-        "每个网站使用独立 Profile，登录状态自动保持。"
+        "适合需要登录的网站操作。每个网站使用独立 Profile，登录状态自动保持。"
+        "使用 site-manage list 查看所有可用网站。"
     )
     category = "browser_stealth"
     parameters = [
         SkillParameter(
             name="profile",
             type="string",
-            description="Profile 名称（预置: google/gmail/x_com/weibo/wechat_mp/douyin/mail139/bilibili/github）",
+            description="Profile 名称（使用 site-manage list 查看可用网站）",
             required=False,
             default="default",
         ),
@@ -692,7 +692,8 @@ class StealthBrowserStartSkill(Skill):
     dangerous = False
 
     async def execute(self, profile: str = "default", headless: bool = False, **kw) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile, headless=headless)
+        # Bug Fix: get_stealth_browser 是同步函数，不能用 await
+        browser = get_stealth_browser(profile_name=profile, headless=headless)
         return await browser.start()
 
 
@@ -708,7 +709,7 @@ class StealthBrowserNavigateSkill(Skill):
     ]
 
     async def execute(self, url: str, profile: str = "default", **kw) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         if not browser._started:
             r = await browser.start()
             if not r.success:
@@ -728,7 +729,7 @@ class StealthBrowserClickSkill(Skill):
     ]
 
     async def execute(self, selector: str, profile: str = "default", **kw) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         return await browser.click(selector)
 
 
@@ -748,7 +749,7 @@ class StealthBrowserFillSkill(Skill):
     async def execute(
         self, selector: str, value: str, clear: bool = True, profile: str = "default", **kw
     ) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         return await browser.fill(selector, value, clear=clear)
 
 
@@ -764,7 +765,7 @@ class StealthBrowserScreenshotSkill(Skill):
     ]
 
     async def execute(self, save_path: str = "", profile: str = "default", **kw) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         return await browser.screenshot(save_path=save_path)
 
 
@@ -780,7 +781,7 @@ class StealthBrowserEvalSkill(Skill):
     ]
 
     async def execute(self, script: str, profile: str = "default", **kw) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         return await browser.evaluate(script)
 
 
@@ -795,7 +796,7 @@ class StealthBrowserGetContentSkill(Skill):
     ]
 
     async def execute(self, profile: str = "default", **kw) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         return await browser.get_content()
 
 
@@ -821,7 +822,7 @@ class StealthBrowserCookieSkill(Skill):
     ]
 
     async def execute(self, action: str, profile: str = "default", **kw) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         if action == "save":
             return await browser.save_cookies()
         elif action == "load":
@@ -881,7 +882,7 @@ class StealthBrowserWaitManualSkill(Skill):
     async def execute(
         self, reason: str = "验证码", timeout: int = 300, profile: str = "default", **kw
     ) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         return await browser.wait_for_manual(reason=reason, timeout=float(timeout))
 
 
@@ -900,10 +901,149 @@ class StealthBrowserWaitSkill(Skill):
     async def execute(
         self, selector: str, timeout: int = 10, profile: str = "default", **kw
     ) -> SkillResult:
-        browser = await get_stealth_browser(profile_name=profile)
+        browser = get_stealth_browser(profile_name=profile)
         return await browser.wait_for(selector, timeout=float(timeout))
 
 
+# ── Site Registry 管理技能 (v1.31.0) ────────────────────
+
+
+class SiteManageListSkill(Skill):
+    """列出所有已注册网站"""
+
+    name = "site_manage_list"
+    description = "列出所有已注册网站 — 显示网站名称、分类、登录 URL 和 Profile 状态"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(
+            name="category",
+            type="string",
+            description="按分类筛选（空=全部）",
+            required=False,
+            default="",
+        ),
+    ]
+
+    async def execute(self, category: str = "", **kw) -> SkillResult:
+        from core.site_registry import get_site_registry
+        reg = get_site_registry()
+        sites = reg.list_sites(category=category)
+        summary = reg.to_summary()
+
+        return SkillResult(
+            success=True,
+            message=f"共 {len(sites)} 个网站" + (f" (分类: {category})" if category else ""),
+            data={"sites": sites, "summary": {k: v for k, v in summary.items() if k != "sites"}},
+            output=json.dumps(sites, ensure_ascii=False, indent=2),
+        )
+
+
+class SiteManageShowSkill(Skill):
+    """显示网站详细配置"""
+
+    name = "site_manage_show"
+    description = "显示网站详细配置 — 查看网站的登录 URL、可用页面和操作提示"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="name", type="string", description="网站名称", required=True),
+    ]
+
+    async def execute(self, name: str, **kw) -> SkillResult:
+        from core.site_registry import get_site_registry
+        reg = get_site_registry()
+        site = reg.get_site(name)
+        if not site:
+            return SkillResult(success=False, error=f"网站不存在: {name}")
+
+        return SkillResult(
+            success=True,
+            message=f"网站: {site.get('display_name', name)}",
+            data=site,
+            output=json.dumps(site, ensure_ascii=False, indent=2),
+        )
+
+
+class SiteManageAddSkill(Skill):
+    """添加自定义网站"""
+
+    name = "site_manage_add"
+    description = (
+        "添加自定义网站 — 为新网站创建配置，后续可用 stealth-open 登录。"
+        "需提供 name（英文标识）、login_url（登录页）和 display_name（显示名称）。"
+    )
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="name", type="string", description="网站名称（英文，如 my_site）", required=True),
+        SkillParameter(name="display_name", type="string", description="显示名称", required=False, default=""),
+        SkillParameter(name="login_url", type="string", description="登录页 URL", required=False, default=""),
+        SkillParameter(name="home_url", type="string", description="首页 URL", required=False, default=""),
+        SkillParameter(name="category", type="string", description="分类", required=False, default="custom"),
+    ]
+
+    async def execute(
+        self, name: str, display_name: str = "", login_url: str = "",
+        home_url: str = "", category: str = "custom", **kw
+    ) -> SkillResult:
+        from core.site_registry import get_site_registry
+        reg = get_site_registry()
+        try:
+            site = reg.add_site({
+                "name": name,
+                "display_name": display_name or name,
+                "login_url": login_url,
+                "home_url": home_url,
+                "category": category,
+            })
+            return SkillResult(
+                success=True,
+                message=f"已添加网站: {name}",
+                data=site,
+            )
+        except ValueError as e:
+            return SkillResult(success=False, error=str(e))
+
+
+class SiteManageRemoveSkill(Skill):
+    """删除自定义网站"""
+
+    name = "site_manage_remove"
+    description = "删除自定义网站（内置网站不可删除）"
+    category = "browser_stealth"
+    parameters = [
+        SkillParameter(name="name", type="string", description="网站名称", required=True),
+    ]
+
+    async def execute(self, name: str, **kw) -> SkillResult:
+        from core.site_registry import get_site_registry
+        reg = get_site_registry()
+        ok = reg.remove_site(name)
+        if ok:
+            return SkillResult(success=True, message=f"已删除网站: {name}")
+        return SkillResult(
+            success=False,
+            error=f"删除失败: {name}（内置网站不可删除，或网站不存在）",
+        )
+
+
+class SiteManageInitSkill(Skill):
+    """批量初始化网站 Profile"""
+
+    name = "site_manage_init"
+    description = "批量初始化所有网站的浏览器 Profile（仅创建目录，不自动登录）"
+    category = "browser_stealth"
+    parameters = []
+
+    async def execute(self, **kw) -> SkillResult:
+        from core.site_registry import get_site_registry
+        reg = get_site_registry()
+        initialized = reg.init_profiles()
+        return SkillResult(
+            success=True,
+            message=f"已初始化 {len(initialized)} 个网站的 Profile",
+            data={"initialized": initialized, "count": len(initialized)},
+        )
+
+
 # ── Profile 管理技能 ──────────────────────────────────────
 
 

package/aiskills/registry.py

@@ -206,6 +206,9 @@ CLI_COMMANDS: List[Dict[str, Any]] = [
      "description": "创建浏览器 Profile"},
     {"name": "profile-delete", "category": "stealth", "cli": "myagent-ai profile-delete <name>",
      "description": "删除浏览器 Profile"},
+    # ── Site 管理 (v1.31.0) ──
+    {"name": "site-manage", "category": "stealth", "cli": "myagent-ai site-manage <list|show|add|remove|init> [args]",
+     "description": "网站注册管理 — 列出/查看/添加/删除/初始化网站配置（支持 20+ 内置网站和动态扩展）"},
     # ── GUI 桌面 ──
     {"name": "screenshot", "category": "gui", "cli": "myagent-ai screenshot [region] [-m monitor]",
      "description": "屏幕截图（仅 Windows/macOS）"},

package/aiskills/site-operations/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: site-operations
+description: |
+  统一网站操作指南 — 使用反检测浏览器（DrissionPage）登录和操作任何网站。
+  覆盖邮箱、社交媒体、云服务、AI 对话平台等 20+ 网站，支持动态扩展。
+metadata:
+  category: site_operation
+  version: "1.31.0"
+  requires: ["stealth-browser"]
+---
+
+# 统一网站操作指南
+
+## 概述
+
+本指南使用反检测浏览器（stealth browser）登录和操作各种网站。
+所有网站共享同一套命令接口（stealth-*），只是 Profile 名称和 URL 不同。
+
+## 支持的网站
+
+使用 `myagent-ai site-manage list` 查看所有可用网站。
+
+### 分类一览
+
+| 分类 | 网站 | Profile 名称 |
+|------|------|-------------|
+| 邮箱 | Gmail, QQ邮箱, 139邮箱 | gmail, qq_mail, mail139 |
+| 社交 | X.com, 微博, 微信网页版, 微信公众号 | x_com, weibo, wechat_web, wechat_mp |
+| 云服务 | 百度网盘 | baidu_netdisk |
+| AI 对话 | Gemini, DeepSeek, z.ai, 智谱清言, 豆包, Kimi, 腾讯元宝, 通义千问 | gemini, deepseek, z_ai, zhipu, doubao, kimi, tencent_yuanbao, qianwen |
+| 开发 | GitHub, Google 账号 | github, google |
+| 内容 | 抖音, 哔哩哔哩 | douyin, bilibili |
+
+## 通用操作流程
+
+### 1. 首次登录（通用模板）
+
+任何网站的首次登录流程都遵循以下模板：
+
+```bash
+# 第1步：查看网站配置
+myagent-ai site-manage show <profile_name>
+
+# 第2步：启动浏览器（有头模式，方便观察和手动操作）
+myagent-ai stealth-open <profile_name> --no-headless
+
+# 第3步：导航到登录页
+myagent-ai stealth-navigate <login_url> -p <profile_name>
+
+# 第4步：尝试自动填写（如果页面允许）
+myagent-ai stealth-screenshot -p <profile_name>
+myagent-ai stealth-fill '<用户名选择器>' '用户名' -p <profile_name>
+myagent-ai stealth-click '<下一步按钮选择器>' -p <profile_name>
+myagent-ai stealth-wait '<密码输入框选择器>' -p <profile_name>
+myagent-ai stealth-fill '<密码选择器>' '密码' -p <profile_name>
+myagent-ai stealth-click '<登录按钮选择器>' -p <profile_name>
+
+# 第5步：如果出现验证码/2FA，等待用户手动操作
+myagent-ai stealth-wait-manual "验证码或安全验证" -t 300 -p <profile_name>
+
+# 第6步：确认登录成功并保存 Cookie
+myagent-ai stealth-cookies save -p <profile_name>
+myagent-ai stealth-close <profile_name>
+```
+
+### 2. 后续操作（已登录）
+
+```bash
+# 启动浏览器（自动恢复登录状态）
+myagent-ai stealth-open <profile_name> --no-headless
+
+# 导航到目标页面
+myagent-ai stealth-navigate <目标URL> -p <profile_name>
+
+# 等待页面加载
+myagent-ai stealth-wait '<关键元素选择器>' -t 15 -p <profile_name>
+
+# 截图确认
+myagent-ai stealth-screenshot -p <profile_name>
+
+# 获取页面内容
+myagent-ai stealth-content -p <profile_name>
+
+# 点击操作
+myagent-ai stealth-click '<选择器>' -p <profile_name>
+
+# 填写输入
+myagent-ai stealth-fill '<选择器>' '内容' -p <profile_name>
+
+# 执行 JavaScript（高级操作）
+myagent-ai stealth-eval 'document.title' -p <profile_name>
+
+# 完成后关闭
+myagent-ai stealth-close <profile_name>
+```
+
+## 查看网站详情
+
+使用 `site-manage show` 查看具体网站的登录 URL、可用页面和操作提示：
+
+```bash
+# 查看 Gmail 的配置
+myagent-ai site-manage show gmail
+
+# 查看 DeepSeek 的配置
+myagent-ai site-manage show deepseek
+```
+
+## 动态管理网站
+
+```bash
+# 列出所有网站
+myagent-ai site-manage list
+
+# 按分类查看
+myagent-ai site-manage list --category ai_chat
+
+# 添加自定义网站
+myagent-ai site-manage add my_site --display "我的网站" --login-url "https://example.com/login" --home-url "https://example.com/dashboard"
+
+# 更新网站配置
+myagent-ai site-manage update my_site --display "新名称"
+
+# 删除自定义网站（内置网站不可删除）
+myagent-ai site-manage remove my_site
+
+# 批量初始化所有网站的 Profile
+myagent-ai site-manage init
+```
+
+## 选择器技巧
+
+- CSS 选择器: `input[type="email"]`, `button.submit`, `div#main`
+- 文本匹配: `button:contains("登录")`, `a:contains("下一步")`
+- 属性匹配: `input[name="password"]`, `[data-testid="login-btn"]`
+- XPath: `//div[@class="login-form"]//input`
+
+不确定选择器时，先用 `stealth-screenshot` 截图查看页面结构，再用 `stealth-eval` 测试选择器：
+```bash
+myagent-ai stealth-eval "document.querySelectorAll('button').forEach((b,i) => console.log(i, b.textContent))" -p <profile>
+```
+
+## 重要提示
+
+1. **反检测模式**：stealth browser 使用 DrissionPage，自动隐藏 webdriver 标志
+2. **Profile 隔离**：每个网站独立 Profile，Cookie/Session 互不干扰
+3. **验证码处理**：遇到验证码时使用 `stealth-wait-manual`，通过 VNC/Web 手动处理
+4. **操作间隔**：建议操作间等待 2-3 秒，避免被网站检测为自动化
+5. **Cookie 持久化**：登录后执行 `stealth-cookies save`，下次自动恢复
+6. **有头模式**：登录场景建议用 `--no-headless`，方便观察和手动干预

package/core/browser_profile.py

@@ -41,54 +41,48 @@ from core.logger import get_logger
 
 logger = get_logger("myagent.core.browser_profile")
 
-# 预置网站 Profile 名称（用于快速创建）
-PRESET_PROFILES: Dict[str, Dict[str, str]] = {
-    "google": {
-        "display_name": "Google",
-        "login_url": "https://accounts.google.com/",
-        "detect_url": "https://myaccount.google.com/",
-    },
-    "gmail": {
-        "display_name": "Gmail",
-        "login_url": "https://accounts.google.com/signin",
-        "detect_url": "https://mail.google.com/mail/u/0/",
-    },
-    "x_com": {
-        "display_name": "X.com (Twitter)",
-        "login_url": "https://x.com/i/flow/login",
-        "detect_url": "https://x.com/home",
-    },
-    "weibo": {
-        "display_name": "微博",
-        "login_url": "https://passport.weibo.com/sso/signin",
-        "detect_url": "https://weibo.com/",
-    },
-    "wechat_mp": {
-        "display_name": "微信公众号",
-        "login_url": "https://mp.weixin.qq.com/",
-        "detect_url": "https://mp.weixin.qq.com/cgi-bin/home?t=home/index",
-    },
-    "douyin": {
-        "display_name": "抖音",
-        "login_url": "https://www.douyin.com/",
-        "detect_url": "https://www.douyin.com/",
-    },
-    "mail139": {
-        "display_name": "139邮箱",
-        "login_url": "https://mail.10086.cn/",
-        "detect_url": "https://mail.10086.cn/",
-    },
-    "bilibili": {
-        "display_name": "哔哩哔哩",
-        "login_url": "https://passport.bilibili.com/login",
-        "detect_url": "https://www.bilibili.com/",
-    },
-    "github": {
-        "display_name": "GitHub",
-        "login_url": "https://github.com/login",
-        "detect_url": "https://github.com/",
-    },
-}
+
+# ════════════════════════════════════════════════════════════
+# 预置 Profile（兼容性保留 — 优先从 site_registry 加载）
+# ════════════════════════════════════════════════════════════
+# v1.31.0: PRESET_PROFILES 不再硬编码，改为从 core.site_registry 动态获取。
+# 此处保留为空 dict，由 get_preset_profiles() 延迟加载。
+
+_PRESET_PROFILES_CACHE: Optional[Dict[str, Dict[str, str]]] = None
+
+
+def get_preset_profiles() -> Dict[str, Dict[str, str]]:
+    """获取预置 Profile 配置（从 SiteRegistry 延迟加载）。
+
+    返回 {name: {display_name, login_url, detect_url}} 格式，
+    保持与旧 PRESET_PROFILES 完全兼容。
+    """
+    global _PRESET_PROFILES_CACHE
+    if _PRESET_PROFILES_CACHE is not None:
+        return _PRESET_PROFILES_CACHE
+
+    try:
+        from core.site_registry import get_site_registry
+        reg = get_site_registry()
+        sites = reg.list_sites()
+        _PRESET_PROFILES_CACHE = {}
+        for s in sites:
+            _PRESET_PROFILES_CACHE[s["name"]] = {
+                "display_name": s["display_name"],
+                "login_url": s.get("login_url", ""),
+                "detect_url": s.get("detect_url", s.get("home_url", "")),
+            }
+        logger.debug(f"从 SiteRegistry 加载了 {len(_PRESET_PROFILES_CACHE)} 个预置 Profile")
+        return _PRESET_PROFILES_CACHE
+    except Exception as e:
+        logger.warning(f"从 SiteRegistry 加载失败，使用空预置: {e}")
+        _PRESET_PROFILES_CACHE = {}
+        return _PRESET_PROFILES_CACHE
+
+
+# 向后兼容别名
+PRESET_PROFILES = {}  # 由 get_preset_profiles() 延迟填充，直接引用会得到空 dict
+# 注意：BrowserProfile.__init__ 已改用 get_preset_profiles()，不再直接读 PRESET_PROFILES
 
 
 class BrowserProfile:
@@ -112,8 +106,9 @@ class BrowserProfile:
         self.cookies_file = self.profile_dir / "cookies.json"
         self.config_file = self.profile_dir / "config.json"
 
-        # 预置配置
-        preset = PRESET_PROFILES.get(name, {})
+        # 预置配置（从 SiteRegistry 延迟加载）
+        _presets = get_preset_profiles()
+        preset = _presets.get(name, {})
         self.display_name = (config or preset).get("display_name", name)
         self.login_url = (config or preset).get("login_url", "")
         self.detect_url = (config or preset).get("detect_url", "")
@@ -394,18 +389,20 @@ class BrowserProfileManager:
         return profile.delete_profile()
 
     def get_preset_names(self) -> List[str]:
-        """获取所有预置 Profile 名称列表"""
-        return list(PRESET_PROFILES.keys())
+        """获取所有预置 Profile 名称列表（从 SiteRegistry 动态获取）"""
+        return list(get_preset_profiles().keys())
 
     def init_presets(self) -> List[str]:
         """
         初始化所有预置 Profile（仅创建目录结构，不自动登录）。
+        预置列表从 SiteRegistry 动态获取。
 
         Returns:
             已初始化的 Profile 名称列表
         """
+        _presets = get_preset_profiles()
         initialized = []
-        for name, config in PRESET_PROFILES.items():
+        for name, config in _presets.items():
             profile = self.get_profile(name)
             if not profile.is_initialized():
                 profile.ensure_dirs()