"""R1-6:站点适配器健康巡检——只查询页面 DOM,绝不输入、点击或发送消息。 对站点当前预设里配置的每个选择器,在该站点已打开的空闲标签页上统计命中数量,给出: - ``broken``:输入框找不到(常见原因:未登录、页面改版),或存在语法无效的选择器; - ``degraded``:其他必需元素找不到。发送按钮通常要输入内容后才出现,回复容器要有对话后才出现, 所以这里只作提示,不算坏; - ``healthy``:输入框能找到,且没有无效选择器; - ``unreachable``:浏览器里没有该站点的空闲标签页(巡检不会自行打开页面)。 ``evaluate_preset`` 是与浏览器无关的纯函数(便于单测);``DrissionProbe`` 把 DrissionPage 标签页适配成探针。 """ from __future__ import annotations import time from typing import Any, Dict, Iterable, List, Optional, Protocol from app.core.config import get_logger from app.core.driver.locators import to_locator as _driver_to_locator from app.services.selector_quality import fallback_suggestions, lint_selector logger = get_logger("ADAPTER_HEALTH") ALWAYS_PRESENT_KEYS = ("input_box",) _HINTS = { "send_btn": "发送按钮通常在输入内容后才出现或可点击", "result_container": "回复容器通常在已有对话时才出现", } class Probe(Protocol): url: str def count(self, selector: str) -> int: """返回命中数量;选择器语法无效时返回 -1。""" # R2-1:定位规则统一到驱动层,这里保留旧名以兼容已有调用与测试 to_locator = _driver_to_locator class DrissionProbe: """把标签页适配成探针。R2-1 起经由统一驱动查询元素(参数既可以是 DrissionPage 标签页,也可以是驱动对象)。""" def __init__(self, tab: Any, url: str = "", timeout: float = 0.3): from app.core.driver import driver_for_tab self.driver = driver_for_tab(tab) self.tab = self.driver.raw self.url = url or self.driver.url self.timeout = timeout def count(self, selector: str) -> int: from app.core.driver import DriverError try: # 配置里的选择器默认是 CSS:先规范化,再交给驱动(驱动按 DrissionPage 原生语法原样传递) return len(self.driver.find_all(to_locator(selector), timeout=self.timeout)) except DriverError as exc: logger.debug(f"选择器无效或查询失败: {selector!r}: {exc}") return -1 def evaluate_preset(probe: Probe, preset: Dict[str, Any], definitions: Iterable[Dict[str, Any]]) -> Dict[str, Any]: required = {str(d.get("key")) for d in definitions or [] if isinstance(d, dict) and d.get("required")} rows: List[Dict[str, Any]] = [] for key, selector in (preset.get("selectors") or {}).items(): if not isinstance(selector, str) or not selector.strip(): continue count = probe.count(selector) status = "invalid" if count < 0 else ("missing" if count == 0 else "ok") row = {"key": key, "selector": selector, "count": max(count, 0), "status": status, "required": key in required, "quality": lint_selector(selector)} if status == "missing" and key in _HINTS: row["hint"] = _HINTS[key] if status != "ok" and key in required: # R1-7:运行时找不到配置的元素时会尝试这些回退选择器;命中的可作为修复起点 row["suggestions"] = fallback_suggestions(key, probe) rows.append(row) by_key = {row["key"]: row for row in rows} problems = [] if any(row["status"] == "invalid" for row in rows): problems.append("存在语法无效的选择器") for key in ALWAYS_PRESENT_KEYS: if key not in by_key: problems.append(f"预设没有配置 {key}") elif by_key[key]["status"] != "ok": problems.append(f"找不到 {key}(可能未登录或页面已改版)") if problems: overall = "broken" elif any(row["required"] and row["status"] != "ok" for row in rows): overall = "degraded" else: overall = "healthy" return {"status": overall, "url": probe.url, "problems": problems, "selectors": rows} def check_site_health(domain: str, preset_name: Optional[str] = None, *, timeout: float = 0.3) -> Dict[str, Any]: """在浏览器里该站点的空闲标签页上巡检(与 /api/debug/test-selector 相同的借用/归还方式)。""" from app.core.browser import get_browser from app.services.config_engine import config_engine from app.utils.site_url import extract_remote_site_domain, route_domain_matches site = config_engine.sites.get(domain) if not isinstance(site, dict): raise KeyError(f"未知站点: {domain}") presets = site.get("presets") or {} name = preset_name or site.get("default_preset") or next(iter(presets), "") if name not in presets: raise KeyError(f"站点 {domain} 没有预设 {name!r}") definitions = config_engine.global_config.to_dict().get("selector_definitions") or [] browser = get_browser() pool = browser.tab_pool pool.refresh_tabs() reports, busy = [], 0 for session in pool.get_sessions_snapshot(): cached = str(getattr(session, "current_domain", "") or "") if cached and not route_domain_matches(domain, cached): continue if str(getattr(getattr(session, "status", None), "value", "")) != "idle": busy += 1 if cached else 0 continue raw_tab_id = str(getattr(getattr(session, "tab", None), "tab_id", "") or "") if not raw_tab_id: continue task_id = f"adapter_health_{time.time_ns()}" acquired = pool.acquire_by_raw_tab_id(raw_tab_id, task_id, timeout=1.0, count_request=False, activate=False) if acquired is None: continue try: url = str(getattr(acquired.tab, "url", "") or "") if not route_domain_matches(domain, extract_remote_site_domain(url) or ""): continue reports.append(evaluate_preset(DrissionProbe(acquired.tab, url, timeout), presets[name], definitions)) finally: pool.release(acquired.id, check_triggers=False, expected_task_id=task_id) if not reports: return {"site": domain, "preset": name, "status": "unreachable", "busy_tabs": busy, "problems": [f"浏览器里没有 {domain} 的空闲标签页;巡检不会自行打开页面"], "tabs": []} order = {"healthy": 0, "degraded": 1, "broken": 2} best = min(reports, key=lambda report: order[report["status"]]) return {"site": domain, "preset": name, "status": best["status"], "busy_tabs": busy, "problems": best["problems"], "tabs": reports}