Initial commit

This commit is contained in:
Alex committed 2026-11-02 22:54:14 +08:00
commit 57fc3525eb
7311 files changed
+1291398

No files matched your search

+81
View File
@@ -0,0 +1,81 @@
"""R1-7:选择器韧性——静态脆弱度检查与修复建议(只提供机制,不自动改动任何已配置的选择器)。
- ``lint_selector``:给选择器打 0–100 分并列出问题。生成的哈希类名、很长的 nth-child 链、
绝对 XPath、过长的后代链和依赖界面语言的文本匹配都会扣分;aria-label、role、placeholder、
data-testid、name、type 等语义锚点会加分;
- ``fallback_suggestions``:当配置的必需元素找不到时,用运行时本来就会使用的
``ElementFinder.FALLBACK_SELECTORS`` 在页面上试一遍,报告哪些能命中。这些命中可以作为修复的起点,
同时说明运行时是否还能靠回退勉强工作。
"""
from __future__ import annotations
import re
from typing import Any, Dict, List
_CLASS_TOKEN = re.compile(r"\.(-?[_a-zA-Z][\w-]*)")
_GENERATED_CLASS_PATTERNS = (
re.compile(r"^(css|sc|jsx|emotion|styled|tw)-[0-9a-zA-Z_-]{4,}$"), # CSS-in-JS 生成类
re.compile(r"^[a-f0-9]{6,}$"), # 纯十六进制哈希(如 bf38813a)
re.compile(r"^_?[a-zA-Z]{1,4}[_-]?[0-9][0-9a-zA-Z]{4,}$"), # 字母+数字混合的短哈希
re.compile(r"^.+__[0-9a-zA-Z]{5,}$"), # CSS Modules:name__hash
re.compile(r"^.+_[0-9a-zA-Z]{5}$"), # CSS Modules:name_hash5
)
_SEMANTIC_ANCHORS = ("aria-label", "role=", "placeholder", "data-testid", "data-test", "name=", "type=", "contenteditable")
def _is_generated_class(token: str) -> bool:
has_digit = any(ch.isdigit() for ch in token)
return has_digit and any(pattern.match(token) for pattern in _GENERATED_CLASS_PATTERNS)
def lint_selector(selector: str) -> Dict[str, Any]:
raw = str(selector or "").strip()
body = raw[4:] if raw.startswith("css:") else raw
issues: List[Dict[str, str]] = []
score = 100
def issue(code: str, message: str, penalty: int) -> None:
nonlocal score
issues.append({"code": code, "message": message})
score -= penalty
is_xpath = body.startswith(("xpath:", "/", "("))
if is_xpath:
expr = body[6:] if body.startswith("xpath:") else body
if re.match(r"^/(html|body)\b", expr):
issue("absolute_xpath", "绝对 XPath 路径,页面结构一变就失效", 45)
if len(re.findall(r"\[\d+\]", expr)) >= 2:
issue("positional_xpath", "依赖多个位置下标 [n]", 20)
if "text()" in expr or "contains(." in expr:
issue("text_match", "依赖界面文字,切换语言或改文案会失效", 10)
else:
generated = [token for token in _CLASS_TOKEN.findall(body) if _is_generated_class(token)]
if generated:
issue("generated_class", f"疑似构建工具生成的类名:{', '.join(sorted(set(generated))[:3])}", min(40, 20 * len(set(generated))))
if body.count(":nth-child") + body.count(":nth-of-type") >= 2:
issue("nth_child_chain", "多个 nth-child/nth-of-type,依赖元素顺序", 20)
first_group = body.split(",")[0]
if len(re.findall(r"\s+(?![^\[]*\])|>", first_group)) >= 5:
issue("long_chain", "后代/子代链过长", 15)
if ":has-text(" in body or ":contains(" in body:
issue("text_match", "依赖界面文字", 10)
anchors = [anchor.rstrip("=") for anchor in _SEMANTIC_ANCHORS if anchor in body]
if anchors:
score += 10
return {"selector": raw, "score": max(0, min(100, score)), "issues": issues, "semantic_anchors": anchors}
def fallback_suggestions(key: str, probe: Any, limit: int = 5) -> List[Dict[str, Any]]:
"""用运行时回退选择器在页面上试探,返回能命中的候选(唯一命中优先)。"""
from app.core.elements import ElementFinder
suggestions = []
for selector in ElementFinder.FALLBACK_SELECTORS.get(key, []):
count = probe.count(selector)
if count > 0:
suggestions.append({"selector": selector, "count": count, "unique": count == 1,
"score": lint_selector(selector)["score"]})
suggestions.sort(key=lambda item: (not item["unique"], -item["score"], item["count"]))
return suggestions[:limit]