mooncat-browser 0.1.0

package/browser-op/py/image.py

@@ -0,0 +1,186 @@
+"""web/image — 图片捕获 (多策略, 路由无关, 全走 operate).
+
+忠实复刻 lib/web/image.js。
+四个策略 + 保存:
+  - img_from_screenshot: 用 operate screenshot (**仅视觉确认, 不取资源**)
+  - img_from_element: evaluate 提取 src, 再 fetch_as_base64
+  - fetch_as_base64: evaluate 内 fetch (共享 cookie jar)
+  - capture_images: 扫描页面所有 img + background-image, 逐个 fetch
+
+依赖: browser (operate), os (file save)
+"""
+from __future__ import annotations
+import base64
+import json
+import os
+from typing import Any
+
+import sys
+sys.path.insert(0, __file__.rsplit("\\", 1)[0] if "\\" in __file__ else __file__.rsplit("/", 1)[0])
+from browser import operate  # noqa: E402
+
+
+def img_from_screenshot(page_handle: dict, options: dict | None = None) -> dict:
+    """截图取图 (可视区域或元素).
+
+    options:
+      selector: 元素截图 selector, 不传则整页可视区
+    返回: {data(str base64), mimeType}
+    """
+    if not page_handle:
+        raise ValueError("img_from_screenshot: page_handle required")
+    r = operate(page_handle, {"action": "screenshot"})
+    data_url = ""
+    if isinstance(r, dict):
+        data_url = r.get("dataUrl", "") or (r.get("result") or {}).get("dataUrl", "")
+    if not data_url:
+        raise ValueError("img_from_screenshot: no dataUrl")
+    m = data_url.split(";base64,")
+    if len(m) < 2:
+        raise ValueError("img_from_screenshot: invalid dataUrl")
+    mime_type = m[0].replace("data:", "")
+    return {"data": m[1], "mimeType": mime_type}
+
+
+def fetch_as_base64(page_handle: dict, url: str) -> dict:
+    """通过页面 fetch 重新请求图片为 base64 (共享 cookie).
+
+    先 fetch; fetch 报错 (CORS/防盗链) 才 fallback 到 crossOrigin 重载.
+    返回: {data(str base64), mimeType}
+    """
+    if not page_handle:
+        raise ValueError("fetch_as_base64: page_handle required")
+    if not url:
+        raise ValueError("fetch_as_base64: url required")
+
+    FETCH_SOURCE = f"""async (u) => {{
+      try {{
+        const res = await fetch(u, {{ credentials: "include" }});
+        const ct = res.headers.get("content-type") || "application/octet-stream";
+        const buf = await res.arrayBuffer();
+        const bytes = new Uint8Array(buf);
+        let bin = "";
+        for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
+        return {{ data: btoa(bin), mimeType: ct }};
+      }} catch (e) {{
+        return {{ error: String((e && e.message) || e) }};
+      }}
+    }}"""
+
+    CROSS_ORIGIN_EXPORT = """async (u) => {
+      return await new Promise(resolve => {
+        const im = new Image();
+        im.crossOrigin = "anonymous";
+        im.onload = () => {
+          try {
+            const c = document.createElement("canvas");
+            c.width = im.naturalWidth; c.height = im.naturalHeight;
+            c.getContext("2d").drawImage(im, 0, 0);
+            const url = c.toDataURL("image/png");
+            if (url.length < 100) return resolve({ error: "toDataURL empty (tainted)" });
+            resolve({ data: url.split(",")[1], mimeType: "image/png" });
+          } catch (e) { resolve({ error: "canvas: " + String((e && e.message) || e) }); }
+        };
+        im.onerror = () => resolve({ error: "reload failed (CDN denied CORS)" });
+        im.src = u;
+      });
+    }"""
+
+    r = operate(page_handle, {"action": "evaluate", "source": FETCH_SOURCE, "args": url})
+    d = r
+    if isinstance(d, dict) and "value" in d:
+        d = d["value"]
+
+    if d and d.get("data") and "error" not in d:
+        return {"data": d["data"], "mimeType": d["mimeType"]}
+
+    if d and d.get("error"):
+        r2 = operate(page_handle, {"action": "evaluate", "source": CROSS_ORIGIN_EXPORT, "args": url})
+        d2 = r2
+        if isinstance(d2, dict) and "value" in d2:
+            d2 = d2["value"]
+        if d2 and d2.get("data") and "error" not in d2:
+            return {"data": d2["data"], "mimeType": d2["mimeType"]}
+        err_msg = d["error"]
+        d2_err = d2.get("error", "") if d2 else ""
+        raise RuntimeError(f"fetch_as_base64: {err_msg}" + (f" (crossOrigin fallback also failed: {d2_err})" if d2_err else ""))
+
+    raise RuntimeError(f"fetch_as_base64: empty response from {url}")
+
+
+def img_from_element(page_handle: dict, selector: str, captured: list | None = None) -> dict:
+    """从 img 元素取图: 先提取 src, 再 fetch_as_base64.
+
+    captured: capture_images 的缓存 (优先用)
+    """
+    if not page_handle:
+        raise ValueError("img_from_element: page_handle required")
+    if not selector:
+        raise ValueError("img_from_element: selector required")
+
+    SRC_SOURCE = f"""(s) => {{
+      const el = document.querySelector(s);
+      if (!el) return null;
+      return el.src || el.getAttribute("src") || el.getAttribute("data-src") || el.getAttribute("href") || null;
+    }}"""
+
+    src_r = operate(page_handle, {"action": "evaluate", "source": SRC_SOURCE, "args": selector})
+    src = None
+    if isinstance(src_r, str):
+        src = src_r
+    elif isinstance(src_r, dict):
+        src = src_r.get("value") or src_r.get("result") or None
+    if not src:
+        raise ValueError(f"img_from_element: no src for {selector}")
+
+    return fetch_as_base64(page_handle, src)
+
+
+def capture_images(page_handle: dict, match_fn: Any = None) -> list[dict]:
+    """扫描页面所有图片, 返回 [{url,data,mimeType}].
+
+    match_fn: URL 过滤函数 (url -> bool)
+    """
+    if not page_handle:
+        raise ValueError("capture_images: page_handle required")
+
+    SCAN_SRC = """(() => {
+      const urls = new Set();
+      document.querySelectorAll("img[src]").forEach((el) => { try { if (el.src) urls.add(el.src) } catch {} });
+      document.querySelectorAll("[data-src]").forEach((el) => { try { const s = el.getAttribute("data-src"); if (s) urls.add(new URL(s, location.href).href) } catch {} });
+      document.querySelectorAll("*").forEach((el) => {
+        const bg = getComputedStyle(el).backgroundImage;
+        if (bg && bg !== "none") {
+          const m = bg.matchAll(/url\\(["']?([^"')]+)["']?\\)/g);
+          for (const x of m) { try { urls.add(new URL(x[1], location.href).href) } catch {} }
+        }
+      });
+      return [...urls];
+    })()"""
+
+    urls_r = operate(page_handle, {"action": "evaluate", "source": SCAN_SRC})
+    urls = []
+    if isinstance(urls_r, list):
+        urls = urls_r
+    elif isinstance(urls_r, dict):
+        urls = urls_r.get("value") or urls_r.get("result") or []
+
+    out = []
+    for u in urls:
+        if match_fn and not match_fn(u):
+            continue
+        try:
+            img = fetch_as_base64(page_handle, u)
+            if img and img.get("data"):
+                out.append({"url": u, "data": img["data"], "mimeType": img["mimeType"]})
+        except Exception:
+            pass
+    return out
+
+
+def save_image(data: str, mime_type: str, save_path: str) -> dict:
+    """保存 base64 到文件."""
+    buf = base64.b64decode(data)
+    with open(save_path, "wb") as f:
+        f.write(buf)
+    return {"savePath": save_path, "bytes": len(buf), "mimeType": mime_type}

package/browser-op/py/interact.py

@@ -0,0 +1,193 @@
+"""web/interact — 页面可视化 overlay (路由无关, 纯 fixed div, 不碰业务 DOM).
+
+忠实复刻 lib/web/interact.js。
+highlight/toast/status —— 注入页面 overlay, 仅 headed 可见。
+visualMark —— eval 内部调用的全局标记函数 (数据源统一: eval 内的元素直接标记)。
+
+依赖: browser (operate)
+"""
+from __future__ import annotations
+import json
+from typing import Any
+
+import sys
+sys.path.insert(0, __file__.rsplit("\\", 1)[0] if "\\" in __file__ else __file__.rsplit("/", 1)[0])
+from browser import operate  # noqa: E402
+
+OVERLAY_ID = "bee-interact-overlay"
+STYLE_ID = "bee-interact-style"
+
+STYLE_CSS = """
+    .bee-tk{position:fixed;z-index:2147483647;font-family:system-ui,Arial,sans-serif;font-size:13px;color:#fff;background:rgba(30,30,30,.92);padding:8px 12px;border-radius:6px;box-shadow:0 2px 12px rgba(0,0,0,.3);max-width:60vw}
+    .bee-tk.b-success{background:rgba(22,101,52,.95)} .bee-tk.b-warn{background:rgba(180,83,9,.95)} .bee-tk.b-error{background:rgba(153,27,27,.95)}
+    .bee-status{top:12px;right:12px}
+    .bee-toast{bottom:16px;right:16px;transition:opacity .3s}
+    .bee-hl-box{position:fixed;outline:4px solid #ff0000;outline-offset:3px;box-shadow:0 0 0 7px rgba(255,0,0,.45);z-index:2147483647;pointer-events:none;border-radius:2px}
+"""
+
+# ─── eval 内部调用的 visualMark (页面侧, 复用 highlight overlay 逻辑) ───
+# 必须在 ENSURE_STYLE_SOURCE 之前定义 (后者引用 .toString())
+# 支持输入: element / {x,y} / {x,y,w,h} / [el1, el2]
+# 和 highlight 同一套 overlay (fixed div, 3秒后自动消失, 不碰业务 DOM)
+VISUAL_MARK_FN = """function (target, label) {
+  document.querySelectorAll('.bee-hl-box').forEach(function (e) { e.remove() })
+  function drawRect (x, y, w, h) {
+    if (w <= 0 || h <= 0) return
+    var box = document.createElement('div')
+    box.className = 'bee-hl-box'
+    box.style.cssText = 'left:' + x + 'px;top:' + y + 'px;width:' + w + 'px;height:' + h + 'px'
+    document.body.appendChild(box)
+    setTimeout(function () { box.style.transition = 'opacity 0.3s'; box.style.opacity = '0'; setTimeout(function () { box.remove() }, 300) }, 3000)
+  }
+  function markOne (t) {
+    if (!t) return
+    if (t instanceof Element) {
+      var r = t.getBoundingClientRect()
+      drawRect(r.left, r.top, r.width, r.height)
+    } else if (typeof t === 'object' && t.x != null) {
+      if (t.w != null) drawRect(t.x, t.y, t.w, t.h)
+      else drawRect(t.x - 15, t.y - 8, 30, 16)
+    }
+  }
+  if (Array.isArray(target)) target.forEach(markOne)
+  else markOne(target)
+}"""
+
+# 注入样式 + visualMark 全局函数 (幂等)
+ENSURE_STYLE_SOURCE = """(() => {
+  if (window.visualMark) return null
+  if (!document.getElementById('""" + STYLE_ID + """')) {
+    var s = document.createElement('style')
+    s.id = '""" + STYLE_ID + """'
+    s.textContent = """ + json.dumps(STYLE_CSS) + """
+    document.head.appendChild(s)
+  }
+  window.visualMark = """ + VISUAL_MARK_FN + """
+  return null
+})()"""
+
+
+async def ensure_style(page_handle: dict) -> None:
+    await operate(page_handle, {"action": "evaluate", "source": ENSURE_STYLE_SOURCE, "_skipVisualize": True, "_skipHumanize": True})
+
+
+# ─── highlight: 外部解析目标 (内置操作用) ───
+
+# 页面侧 overlay 逻辑 (纯 fixed div, 不碰业务 DOM)
+HIGHLIGHT_OVERLAY = """function (target) {
+  document.querySelectorAll('.bee-hl-box').forEach(function (e) { e.remove() })
+  var rects = []
+  function drawRect (x, y, w, h) {
+    if (w <= 0 || h <= 0) return false
+    var box = document.createElement('div')
+    box.className = 'bee-hl-box'
+    box.style.cssText = 'left:' + x + 'px;top:' + y + 'px;width:' + w + 'px;height:' + h + 'px'
+    document.body.appendChild(box)
+    setTimeout(function () { box.style.transition = 'opacity 0.3s'; box.style.opacity = '0'; setTimeout(function () { box.remove() }, 300) }, 3000)
+    rects.push({ x: x, y: y, w: w, h: h })
+    return true
+  }
+  function resolveSelector (sel) {
+    try { var el = document.querySelector(sel); if (!el) return null; var r = el.getBoundingClientRect(); return { x: r.left, y: r.top, w: r.width, h: r.height } } catch (e) { return null }
+  }
+  function resolveText (text) {
+    var walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, null)
+    var node
+    while ((node = walker.nextNode())) {
+      if (node.textContent && node.textContent.indexOf(text) >= 0) {
+        var range = document.createRange(); range.selectNodeContents(node)
+        var cr = range.getClientRects()
+        for (var i = 0; i < cr.length; i++) { if (cr[i].width > 0 && cr[i].height > 0) return { x: cr[i].left, y: cr[i].top, w: cr[i].width, h: cr[i].height } }
+      }
+    }
+    var all = [].slice.call(document.querySelectorAll('*'))
+    var hit = all.find(function (e) { return e.children.length === 0 && (e.innerText || '').trim() === text })
+    if (!hit) hit = all.find(function (e) { return (e.innerText || '').indexOf(text) >= 0 })
+    if (!hit) return null
+    var r = hit.getBoundingClientRect()
+    return { x: r.left, y: r.top, w: r.width, h: r.height }
+  }
+  try {
+    if (target.kind === 'selector') { var rect = resolveSelector(target.selector); if (rect && drawRect(rect.x, rect.y, rect.w, rect.h)) return { ok: true, rects: rects }; return { ok: false, reason: 'selector not found: ' + target.selector } }
+    if (target.kind === 'text') { var rect2 = resolveText(target.text); if (rect2 && drawRect(rect2.x, rect2.y, rect2.w, rect2.h)) return { ok: true, rects: rects }; return { ok: false, reason: 'text not found: ' + target.text } }
+    if (target.kind === 'point') { drawRect(target.x - 15, target.y - 8, 30, 16); return { ok: true, rects: rects } }
+    if (target.kind === 'rect') { drawRect(target.x, target.y, target.w, target.h); return { ok: true, rects: rects } }
+    if (target.kind === 'pair') { var ok1 = false, ok2 = false; var r1 = resolveSelector(target.source); if (r1) { drawRect(r1.x, r1.y, r1.w, r1.h); ok1 = true } var r2 = resolveSelector(target.target); if (r2) { drawRect(r2.x, r2.y, r2.w, r2.h); ok2 = true } return { ok: ok1 && ok2, rects: rects, reason: (!ok1 ? 'source ' : '') + (!ok2 ? 'target' : '') } }
+    return { ok: false, reason: 'unknown kind: ' + target.kind }
+  } catch (e) { return { ok: false, reason: e.message } }
+}"""
+
+
+async def highlight(page_handle: dict, visual_target: dict | None, options: dict | None = None) -> dict:
+    """高亮目标 (纯 overlay, 不改业务 DOM class)."""
+    if not page_handle:
+        raise ValueError("highlight: page_handle required")
+    if not visual_target:
+        return {"ok": False, "reason": "no target"}
+    await ensure_style(page_handle)
+    result = await operate(page_handle, {
+        "action": "evaluate",
+        "source": HIGHLIGHT_OVERLAY,
+        "args": visual_target,
+        "_skipVisualize": True,
+        "_skipHumanize": True,
+    })
+    r = result if isinstance(result, dict) else {"ok": False, "reason": "no result"}
+    ms = (options or {}).get("ms", 1000)
+    if r.get("ok") and ms and ms > 0:
+        import asyncio
+        await asyncio.sleep(ms / 1000)
+    return r
+
+
+async def clear(page_handle: dict) -> None:
+    """清除所有 overlay."""
+    if not page_handle:
+        raise ValueError("clear: page_handle required")
+    await operate(page_handle, {
+        "action": "evaluate",
+        "source": '(() => { document.querySelectorAll(".bee-tk,.bee-hl-box").forEach(function(e){e.remove()}); return null })()',
+        "_skipVisualize": True, "_skipHumanize": True,
+    })
+    return None
+
+
+async def toast(page_handle: dict, message: str, level_or_opts: str | dict = "info") -> None:
+    """底部右下角 toast."""
+    if not page_handle:
+        raise ValueError("toast: page_handle required")
+    level = level_or_opts.get("level", "info") if isinstance(level_or_opts, dict) else level_or_opts
+    ms = level_or_opts.get("ms", 2500) if isinstance(level_or_opts, dict) else 2500
+    await ensure_style(page_handle)
+    cls = {"success": "b-success", "warn": "b-warn", "error": "b-error"}.get(level, "")
+    src = """(() => {
+      const e = document.createElement("div")
+      e.className = "bee-tk bee-toast """ + cls + """"
+      e.textContent = """ + json.dumps(message) + """
+      document.body.appendChild(e)
+      setTimeout(() => { e.style.opacity = "0"; setTimeout(() => e.remove(), 300) }, """ + str(ms) + """)
+      return null
+    })()"""
+    await operate(page_handle, {"action": "evaluate", "source": src, "_skipVisualize": True, "_skipHumanize": True})
+    return None
+
+
+async def status(page_handle: dict, text: str, step: str | None = None) -> None:
+    """右上角状态栏."""
+    if not page_handle:
+        raise ValueError("status: page_handle required")
+    await ensure_style(page_handle)
+    content = f"{step}: {text}" if step else str(text)
+    src = """(() => {
+      let e = document.getElementById('""" + OVERLAY_ID + """')
+      if (!e) { e = document.createElement("div"); e.id = '""" + OVERLAY_ID + """'; e.className = "bee-tk bee-status"; document.body.appendChild(e) }
+      e.textContent = """ + json.dumps(content) + """
+      return null
+    })()"""
+    await operate(page_handle, {"action": "evaluate", "source": src, "_skipVisualize": True, "_skipHumanize": True})
+    return None
+
+
+def visual_mark_fn_source() -> str:
+    """返回 visualMark 函数源码 (供其他模块 eval 注入用)."""
+    return VISUAL_MARK_FN

package/browser-op/py/markdown.py

@@ -0,0 +1,38 @@
+"""web/markdown — HTML 转 Markdown (纯函数, 路由无关).
+
+忠实复刻 lib/web/markdown.js。
+不依赖任何浏览器通道。HTML 字符串进来, Markdown 出去。
+在 Python 中用 html2text 或 markdownify 替代 turndown + cheerio。
+
+依赖: markdownify (pip install markdownify)
+"""
+from __future__ import annotations
+import re
+from typing import Any
+
+
+def html_to_markdown(html: str) -> dict:
+    """将 HTML 字符串转换为 Markdown.
+
+    返回: {markdown: str, title: str | None}
+    """
+    title = None
+
+    # 提取 title
+    m = re.search(r"<title[^>]*>(.*?)</title>", html, re.IGNORECASE | re.DOTALL)
+    if m:
+        title = m.group(1).strip()
+
+    # 删除 script/style 标签
+    cleaned = re.sub(r"<(script|style)[^>]*>.*?</\1>", "", html, flags=re.IGNORECASE | re.DOTALL)
+
+    try:
+        import markdownify
+        md = markdownify.markdownify(cleaned, heading_style="ATX", strip=["script", "style"])
+    except ImportError:
+        raise RuntimeError("web/markdown 需要 markdownify, 请先安装: pip install markdownify")
+
+    # 截断 data URI
+    md = re.sub(r'!\[([^\]]*)\]\(data:image/[^;]+;base64,[^\)]+\)', r'![\1](data:data:image/...)', md)
+
+    return {"markdown": md.strip(), "title": title}

package/browser-op/py/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "mooncat-browser-client"
+version = "0.1.0"
+description = "Python client for the local browser daemon"
+requires-python = ">=3.11"
+dependencies = [
+  "requests>=2.32.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+py-modules = [
+  "behavior",
+  "browser",
+  "captcha",
+  "crawler",
+  "find",
+  "honeypot",
+  "humanize",
+  "image",
+  "interact",
+  "markdown",
+  "ready",
+  "scroll",
+  "upload",
+  "visualize",
+  "visual_target",
+]
+

package/browser-op/py/ready.py

@@ -0,0 +1,208 @@
+"""web/ready — 页面就绪等待 + 网页内弹窗清理 (路由无关).
+
+忠实复刻 lib/web/ready.js。
+wait_for_ready()  等待采集前提
+dismiss_popups()  关闭网页内 DOM 弹窗
+
+依赖: browser (operate), find
+"""
+from __future__ import annotations
+import json
+import time
+import random
+
+import sys
+sys.path.insert(0, __file__.rsplit("\\", 1)[0] if "\\" in __file__ else __file__.rsplit("/", 1)[0])
+from browser import operate
+from find import find_element
+
+POPUP_CLOSE_SELECTORS = [
+    '[class*="close"][aria-label]', '[class*="Close"]',
+    'button[class*="close"]', 'a[class*="close"]',
+    '.modal-close', '.dialog-close', '.popup-close',
+    '[class*="modal"] [class*="close"]', '[class*="dialog"] [class*="close"]',
+    '[class*="icon-close"]', '[class*="iconClose"]', '.icon-close',
+]
+
+CONFIRM_TEXTS = ["我知道了", "知道了", "确定", "关闭", "不再提示", "下次再说", "残忍拒绝", "暂不", "取消"]
+
+
+def wait_for_ready(page_handle, opts=None):
+    # (same as before - uses snapshot/evaluate, no f-string issue)
+    opts = opts or {}
+    ready_text = opts.get("readyText", [])
+    ready_selector = opts.get("readySelector")
+    timeout_ms = opts.get("timeoutMs", 30000)
+    poll_ms = opts.get("pollMs", 2000)
+    reload_max = opts.get("reloadMax", 1)
+    settle_ms = opts.get("settleMs", 2000)
+
+    def check():
+        if ready_text:
+            snap = operate(page_handle, {"action": "snapshot", "_skipVisualize": True})
+            yaml = ""
+            if isinstance(snap, dict):
+                yaml = snap.get("yaml", "")
+            for t in ready_text:
+                if t in yaml:
+                    return {"ready": True, "via": "snapshot:" + t}
+            body = operate(page_handle, {"action": "evaluate", "source": "() => (document.body && document.body.innerText) || \"\"", "_skipVisualize": True})
+            body_text = ""
+            if isinstance(body, str):
+                body_text = body
+            elif isinstance(body, dict):
+                body_text = body.get("value", "")
+            for t in ready_text:
+                if t in body_text:
+                    return {"ready": True, "via": "text:" + t}
+        if ready_selector:
+            c = operate(page_handle, {"action": "count", "selector": ready_selector, "_skipVisualize": True})
+            count = 0
+            if isinstance(c, dict):
+                count = c.get("count", 0)
+            elif isinstance(c, (int, float)):
+                count = int(c)
+            if count > 0:
+                return {"ready": True, "via": "selector:" + ready_selector}
+        return {"ready": False}
+
+    attempts = 0
+    for reload_cnt in range(reload_max + 1):
+        deadline = time.time() + timeout_ms / 1000
+        while time.time() < deadline:
+            attempts += 1
+            r = check()
+            if r.get("ready"):
+                if settle_ms > 0:
+                    time.sleep(settle_ms / 1000)
+                return {"ready": True, "via": r["via"], "attempts": attempts}
+            time.sleep(poll_ms / 1000)
+        if reload_cnt < reload_max:
+            operate(page_handle, {"action": "reload", "_skipVisualize": True})
+            time.sleep(3)
+
+    raise RuntimeError(
+        "waitForReady \u8d85\u65f6: \u672a\u7b49\u5230\u5c31\u7eea\u6761\u4ef6 text="
+        + json.dumps(ready_text) + " sel=" + (ready_selector or "\u65e0")
+        + " (\u5c1d\u8bd5 " + str(attempts) + " \u6b21, \u5237\u65b0 " + str(reload_max) + " \u6b21)"
+    )
+
+
+_JS_DISMISS = (
+    "(() => {"
+    "const t=%s;"
+    "const s=%s;"
+    "const m=[];let d=0;"
+    "const v=e=>{if(!e)return 0;const r=e.getBoundingClientRect();const c=getComputedStyle(e);return r.w>0&&r.h>0&&c.v!='hidden'&&c.d!='none'&&c.o!='0'};"
+    "const c=(e,mm)=>{if(v(e)){try{e.click();d++;m.push(mm)}catch(e){}return 1}return 0};"
+    "for(const x of s){let el;try{el=Array.from(document.querySelectorAll(x))}catch(e){continue}for(const e of el){if(c(e,'s:'+x))return{d,m}}}"
+    "const b=Array.from(document.querySelectorAll('button,a,span,div'));"
+    "for(const e of b){const t=(e.innerText||e.textContent||'').trim();if(t&&t.length<=6&&t.indexOf(t)>=0){if(c(e,'t:'+t))return{d,m}}}"
+    "const k=Array.from(document.querySelectorAll('[class*=\"modal\"],[class*=\"popup\"],[class*=\"dialog\"],[class*=\"Mask\"],[class*=\"overlay\"]'));"
+    "for(const e of k){if(v(e)&&!e.querySelector('button,a')){try{e.style.display='none';d++;m.push('h')}catch(e){}}}"
+    "return{d,m}"
+    "})()"
+)
+
+
+def dismiss_popups(page_handle, opts=None):
+    opts = opts or {}
+    texts = CONFIRM_TEXTS + opts.get("extraCloseTexts", [])
+    sels = POPUP_CLOSE_SELECTORS + opts.get("extraSelectors", [])
+    source = _JS_DISMISS % (json.dumps(texts), json.dumps(sels))
+    result = operate(page_handle, {"action": "evaluate", "source": source, "_skipVisualize": True})
+    if isinstance(result, dict):
+        return {"dismissed": result.get("d", 0), "methods": result.get("m", [])}
+    return {"dismissed": 0, "methods": []}
+
+
+# ─── scroll: 滚动封装 (SPA 页面数据常需滚动才渲染) ───
+# 模拟人类: 分步 scrollBy + 随机停顿 (不是原生 smooth, 原生平滑无停顿不触发懒加载)
+
+
+def human_scroll_to_y(page_handle, target_y, max_steps=200):
+    """分步滚动到目标 scrollY (人类化: 每步 30~60px, 30~60ms 停顿)."""
+    source = """(targetY) => new Promise((resolve) => {
+      const start = window.scrollY || window.pageYOffset || 0
+      const dir = targetY > start ? 1 : -1
+      let steps = 0
+      const tick = () => {
+        const cur = window.scrollY || window.pageYOffset || 0
+        steps++
+        if (steps > """ + str(max_steps) + """ || (dir > 0 ? cur >= targetY - 5 : cur <= targetY + 5)) { resolve(); return }
+        const step = 30 + Math.floor(Math.random() * 30)
+        window.scrollBy(0, dir * step)
+        setTimeout(tick, 30 + Math.random() * 30)
+      }
+      tick()
+    })"""
+    operate(page_handle, {"action": "evaluate", "source": source, "args": target_y, "_skipVisualize": True})
+
+
+def scroll_to_text(page_handle, text, opts=None):
+    """滚动到指定文本所在的元素 (SPA 最稳定位). 先拿到目标元素 Y, 再人类化分步滚过去."""
+    opts = opts or {}
+    exact = bool(opts.get("exact"))
+    block = opts.get("block", "center")
+
+    def find_pos():
+        el = find_element(page_handle, {"text": text, "exact": exact})
+        if not el.get("found"):
+            return {"found": False}
+        vh = operate(page_handle, {"action": "evaluate", "source": "()=>window.innerHeight", "_skipVisualize": True})
+        vh = vh if isinstance(vh, (int, float)) else 800
+        offset = vh / 2
+        if block == "start":
+            offset = 50
+        elif block == "end":
+            offset = vh - 50
+        return {"found": True, "targetY": max(0, el.get("y", 0) + el.get("height", 0) / 2 - offset)}
+
+    pos = find_pos()
+    if not pos.get("found"):
+        for _ in range(60):
+            operate(page_handle, {"action": "evaluate", "source": "() => { window.scrollBy(0, 40 + Math.floor(Math.random()*30)); return null }", "_skipVisualize": True})
+            time.sleep(0.06 + random.random() * 0.06)
+            pos = find_pos()
+            if pos.get("found"):
+                break
+            at_bottom = False
+            try:
+                at_bottom = operate(page_handle, {"action": "evaluate", "source": "()=>(window.innerHeight + (window.scrollY||0) + 5) >= document.body.scrollHeight", "_skipVisualize": True})
+            except Exception:
+                pass
+            if at_bottom:
+                break
+    if not pos.get("found"):
+        return {"found": False, "scrolled": False}
+    human_scroll_to_y(page_handle, pos["targetY"])
+    time.sleep(0.6)
+    return {"found": True, "scrolled": True}
+
+
+def scroll_to(page_handle, selector, opts=None):
+    """滚动到 selector 元素 (人类化分步)."""
+    opts = opts or {}
+    block = opts.get("block", "center")
+    el = find_element(page_handle, {"selector": selector})
+    if not el.get("found"):
+        return {"found": False, "scrolled": False}
+    vh = operate(page_handle, {"action": "evaluate", "source": "()=>window.innerHeight", "_skipVisualize": True})
+    vh = vh if isinstance(vh, (int, float)) else 800
+    offset = vh / 2
+    if block == "start":
+        offset = 50
+    elif block == "end":
+        offset = vh - 50
+    target_y = max(0, el.get("y", 0) + el.get("height", 0) / 2 - offset)
+    human_scroll_to_y(page_handle, target_y)
+    return {"found": True, "scrolled": True}
+
+
+def scroll_to_end(page_handle, to="top"):
+    """滚动到页顶/页底 (人类化分步)."""
+    if to == "bottom":
+        operate(page_handle, {"action": "evaluate", "source": "() => new Promise((resolve) => { let last=-1; const t=setInterval(()=>{ window.scrollBy(0,80+Math.random()*60); const h=document.body.scrollHeight; if(h===last){clearInterval(t);resolve()} last=h }, 80+Math.random()*60) })", "_skipVisualize": True})
+    else:
+        human_scroll_to_y(page_handle, 0)
+    return True