feat: Playwright根因分析+异常检测器误报修复

1. _extract_playwright_root_cause(): 从Playwright详细报错中提取关键根因
   - intercepts pointer events  CSS层级遮挡提示
   - element is not visible  元素不可见提示
   - strict mode violation  选择器匹配多个元素提示
   - 等7种常见Playwright根因模式

2. Bug描述附加根因分析
   - 引擎端：Bug.description追加根因分析
   - 插件端：_formatBugText显示根因分析和修复建议
   - 编程AI能看到真正原因（如navbar遮挡sidebar）

3. 异常检测器误报修复
   - AnomalyDetector新增suppress_error_text()方法
   - assert_text通过后标记验证文本为蓝本预期
   - _check_error_elements跳过蓝本故意验证的错误文本
   - 解决故意测试登录失败场景时误报.error的问题

Author: zcj220

extension/src/sidebarProvider.ts

@@ -352,14 +352,21 @@ export class SidebarProvider implements vscode.WebviewViewProvider {
         const step = bug.step_number ? ` (步骤#${bug.step_number})` : "";
         lines.push(`${i + 1}. [${(bug.severity as string || "medium").toUpperCase()}] ${cat ? cat + " " : ""}${bug.title}${step}`);
         if (bug.description) {
-          // 包含修复建议时多显示几行
           const desc = bug.description as string;
-          const firstLine = desc.split("\n")[0].substring(0, 150);
+          const firstLine = desc.split("\n")[0].substring(0, 200);
           lines.push(`   ${firstLine}`);
-          if (desc.includes("💡 修复建议")) {
+          // 显示根因分析（关键！编程AI需要看到Playwright的真正报错原因）
+          if (desc.includes("🔍 根因分析")) {
+            const rootCause = desc.split("� 根因分析: ")[1];
+            if (rootCause) {
+              lines.push(`   🔍 根因分析: ${rootCause.split("\n")[0].substring(0, 200)}`);
+            }
+          }
+          // 显示修复建议
+          if (desc.includes("�💡 修复建议")) {
             const suggestion = desc.split("💡 修复建议")[1];
             if (suggestion) {
-              lines.push(`   💡 修复建议${suggestion.split("\n")[0].substring(0, 150)}`);
+              lines.push(`   💡 修复建议${suggestion.split("\n")[0].substring(0, 200)}`);
             }
           }
         }

src/testing/anomaly_detector.py

@@ -98,6 +98,16 @@ def __init__(self, page: Page) -> None:
         self._network_errors: list[dict] = []
         self._monitoring = False
         self._reported_errors: set[str] = set()  # 已报告的异常指纹，避免重复
+        self._suppress_error_texts: set[str] = set()  # 蓝本故意验证的错误文本，检测时跳过
+
+    def suppress_error_text(self, text: str) -> None:
+        """标记某段文本为蓝本预期的错误提示，异常检测时跳过。
+
+        当assert_text步骤故意验证错误提示（如'用户名或密码错误'）并通过时，
+        调用此方法避免异常检测器误报。
+        """
+        if text:
+            self._suppress_error_texts.add(text.strip())
 
     def start_monitoring(self) -> None:
         """开始监控控制台错误和网络失败。在测试开始前调用一次。"""
@@ -265,6 +275,9 @@ async def _check_error_elements(self, report: AnomalyReport) -> None:
                     text = (await el.text_content() or "").strip()[:200]
                     if not text:
                         continue
+                    # 跳过蓝本故意验证的错误文本（如assert_text验证'用户名或密码错误'）
+                    if any(suppress in text for suppress in self._suppress_error_texts):
+                        continue
                     report.anomalies.append(Anomaly(
                         anomaly_type=AnomalyType.ERROR_ELEMENT,
                         severity=AnomalySeverity.MEDIUM,

src/testing/blueprint_runner.py

@@ -520,6 +520,11 @@ async def _execute_step(
                         duration_seconds=elapsed,
                         error_message=f"文本断言失败: 预期'{expected_value}'，实际'{text}'",
                     ), bug
+                else:
+                    # assert_text通过：告诉异常检测器这个文本是蓝本预期的，
+                    # 避免异常检测器看到.error元素就误报（如故意测试登录失败场景）
+                    if self._anomaly_detector and expected_value:
+                        self._anomaly_detector.suppress_error_text(expected_value)
 
             elif step_def.action == "assert_visible":
                 try:
@@ -608,15 +613,25 @@ async def _execute_step(
 
         except (BrowserActionError, BrowserNavigationError) as e:
             elapsed = time.time() - start
-            logger.info("  ⚠ 步骤{} error | {:.1f}秒 | {}", step_num, elapsed, str(e)[:80])
+            # 提取Playwright关键根因（如"intercepts pointer events"、"element is not visible"）
+            err_detail = str(e)
+            root_cause = self._extract_playwright_root_cause(err_detail)
+            if root_cause:
+                logger.info("  ⚠ 步骤{} error | {:.1f}秒 | {} | 根因: {}", step_num, elapsed, str(e)[:80], root_cause)
+            else:
+                logger.info("  ⚠ 步骤{} error | {:.1f}秒 | {}", step_num, elapsed, str(e)[:80])
             # 操作类步骤失败（选择器找不到/超时）生成Bug，让AI中枢有机会介入恢复
             err_bug = None
             if step_def.action in ("click", "fill", "select"):
+                # 构建完整描述：基本错误 + 根因（如果有）
+                bug_desc = err_detail
+                if root_cause:
+                    bug_desc += f"\n\n🔍 根因分析: {root_cause}"
                 err_bug = BugReport(
                     severity=BugSeverity.MEDIUM,
                     category="操作失败",
                     title=f"步骤{step_num}操作失败: {step_def.action} {target or ''}",
-                    description=str(e),
+                    description=bug_desc,
                     location=target or "",
                     reproduction=desc,
                     screenshot_path=None,
@@ -643,6 +658,33 @@ async def _execute_step(
                 error_message=str(e),
             ), None
 
+    @staticmethod
+    def _extract_playwright_root_cause(error_text: str) -> Optional[str]:
+        """从Playwright错误信息中提取关键根因，让编程AI能看到真正问题。
+
+        Playwright的错误信息很长（含Call log），关键线索藏在后面。
+        例如 "intercepts pointer events" 说明有元素遮挡了点击目标。
+        """
+        import re
+        # 已知的Playwright关键根因模式
+        patterns = [
+            (r"<([^>]+)>\s*intercepts pointer events", "CSS层级遮挡: <{0}>元素挡住了点击目标，检查z-index或position"),
+            (r"element is not visible", "目标元素不可见（display:none或visibility:hidden）"),
+            (r"element is outside of the viewport", "目标元素在视口外，需要先滚动到可见区域"),
+            (r"element is not enabled", "目标元素被禁用（disabled属性）"),
+            (r"waiting for selector.*did not resolve to any element", "选择器在页面中找不到任何匹配元素"),
+            (r"Element is not an <input>", "目标元素不是输入框，不能用fill操作（可能是<select>下拉框，应用select操作）"),
+            (r"strict mode violation.*resolved to (\d+) elements", "选择器匹配到多个元素（{0}个），需要更精确的选择器"),
+        ]
+        for pattern, template in patterns:
+            match = re.search(pattern, error_text, re.IGNORECASE)
+            if match:
+                try:
+                    return template.format(*match.groups()) if match.groups() else template
+                except (IndexError, KeyError):
+                    return template
+        return None
+
     async def _check_anomalies(self, step_num: int, page_url: str) -> list[BugReport]:
         """执行蓝本外异常检测，将发现的异常转为BugReport。"""
         if not self._anomaly_detector: