v14.14: browser auto-rebuild + checkpoint navigation recovery + web.md Rule 6

Author: zcj220

extension/templates/platforms/web.md

@@ -422,8 +422,7 @@ The engine resolves the chain: `enter_dashboard` extends `login` → executes lo
 2. **`extends` chains** — a setup can extend another setup (max 3 levels deep to keep it simple)
 3. **No circular references** — `A extends B extends A` is invalid (engine will reject it)
 4. **setup + flow interaction** — in flow mode, setup steps are included in scenario 1 but skipped (along with navigate) in subsequent scenarios
-5. **Each setup MUST end with a verification step** (`assert_text` or `screenshot`) to confirm the path succeeded
-
+5. **Each setup MUST end with a verification step** (`assert_text` or `screenshot`) to confirm the path succeeded6.   **Checkpoint recovery (v14.14)**: When a step fails and the engine needs to recover, it automatically re-executes the scenario's `setup` steps to restore the app to the correct page, then retries the failed step. This means: **a scenario with a well-defined `setup` is self-healing**. A scenario WITHOUT a setup cannot recover — the engine can only use AI screenshot coordinates as a fallback. MANDATORY: any scenario that navigates through 2+ steps (login → click module → reach target page) MUST use `setup` to define that path.
 ---
 
 ## NINE: Complete JSON Template

src/testing/blueprint_runner.py

@@ -315,14 +315,48 @@ async def run(
                         decision = await self._hub.on_step_failed(ctx)
 
                         if decision.action == HubAction.RETRY:
-                            # L2恢复：如果AI中枢返回了恢复选择器，先执行恢复动作
-                            if decision.recover_selector:
-                                logger.info("  🔧 AI中枢L2恢复：先点击[{}]", decision.recover_selector)
-                                try:
-                                    await self._browser.click(decision.recover_selector)
-                                    await asyncio.sleep(1)  # 等待恢复动作生效
-                                except Exception as recover_err:
-                                    logger.warning("  L2恢复点击失败: {}", str(recover_err)[:80])
+                            # v14.14 浏览器崩溃检测：先尝试重建浏览器
+                            if result and result.error_message and result.error_message.startswith("[BROWSER_CRASH]"):
+                                rebuilt = await self._rebuild_browser_if_crashed(blueprint)
+                                if rebuilt and setup_step_count > 0:
+                                    logger.info("  💥→✅ 浏览器重建成功，重跑setup（{}步）恢复场景状态", setup_step_count)
+                                    for s_step in effective_steps[:setup_step_count]:
+                                        try:
+                                            await self._execute_step(step_num, s_step, page, blueprint)
+                                        except Exception:
+                                            pass
+                                elif rebuilt and is_flow and page.scenarios:
+                                    logger.info("  💥→✅ 浏览器重建成功，重跑首场景恢复flow状态")
+                                    for s_step in page.scenarios[0].steps:
+                                        try:
+                                            await self._execute_step(step_num, s_step, page, blueprint)
+                                        except Exception:
+                                            pass
+                            else:
+                                # v14.14 checkpoint恢复：优先重跑setup（导航路径），比坐标点击更可靠
+                                if setup_step_count > 0 and not decision.recover_selector:
+                                    logger.info("  🗺️ AI中枢：步骤失败，checkpoint恢复 — 重跑setup（{}步）回到正确页面", setup_step_count)
+                                    setup_ok = True
+                                    for s_step in effective_steps[:setup_step_count]:
+                                        try:
+                                            s_r, _ = await self._execute_step(step_num, s_step, page, blueprint)
+                                            if s_r.status != StepStatus.PASSED:
+                                                setup_ok = False
+                                                break
+                                        except Exception:
+                                            setup_ok = False
+                                            break
+                                    if not setup_ok:
+                                        logger.warning("  🗺️ checkpoint恢复失败，改用AI坐标回退")
+
+                                # L2恢复：如果AI中枢返回了恢复选择器，先执行恢复动作（坐标已由_hub_click执行）
+                                if decision.recover_selector:
+                                    logger.info("  🔧 AI中枢L2恢复：先点击[{}]", decision.recover_selector)
+                                    try:
+                                        await self._browser.click(decision.recover_selector)
+                                        await asyncio.sleep(1)  # 等待恢复动作生效
+                                    except Exception as recover_err:
+                                        logger.warning("  L2恢复点击失败: {}", str(recover_err)[:80])
 
                             # 动作替换：AI中枢建议用不同动作重试（如 fill→select）
                             retry_step = step_def
@@ -626,6 +660,56 @@ async def _hub_click(self, nx: float, ny: float):
         except Exception as e:
             logger.warning("AI中枢Web点击失败: {}", str(e)[:80])
 
+    async def _rebuild_browser_if_crashed(self, blueprint: Blueprint) -> bool:
+        """v14.14：浏览器崩溃/断连后自动重建浏览器实例。
+
+        重建步骤：
+        1. 尝试关闭旧的 context/browser（容错）
+        2. 用原配置重新 launch 浏览器
+        3. 重新监听控制台日志
+
+        Returns:
+            True = 重建成功；False = 重建失败（引擎无法继续）
+        """
+        logger.warning("  💥 → 🔧 检测到浏览器崩溃，开始自动重建...")
+        try:
+            # 先尝试关闭旧的资源（忽略所有错误）
+            try:
+                await self._browser._context.close()
+            except Exception:
+                pass
+            try:
+                await self._browser._browser.close()
+            except Exception:
+                pass
+            try:
+                await self._browser._playwright.stop()
+            except Exception:
+                pass
+
+            # 重新启动浏览器
+            await self._browser.launch()
+
+            # 重新挂载控制台和网络监听
+            try:
+                browser_page = self._browser.page
+                browser_page.on("console", lambda msg: self._log_slicer.add_console_log(
+                    msg.type, msg.text,
+                ))
+                browser_page.on("response", lambda resp: (
+                    self._log_slicer.add_network_error(resp.url, resp.status, resp.request.method)
+                    if resp.status >= 400 else None
+                ))
+            except Exception:
+                pass
+
+            logger.info("  🔧 → ✅ 浏览器重建成功，准备恢复测试")
+            return True
+
+        except Exception as e:
+            logger.error("  🔧 → ❌ 浏览器重建失败: {}，无法继续", str(e)[:100])
+            return False
+
     async def _cancellable_sleep(self, seconds: float) -> bool:
         """可中断的等待，每 100ms 检查一次取消标志。
 
@@ -893,14 +977,32 @@ async def _execute_step(
 
         except Exception as e:
             elapsed = time.time() - start
-            logger.error("  ✗ 步骤{} 异常 | {:.1f}秒 | {}", step_num, elapsed, str(e)[:100])
+            err_str = str(e)
+            # v14.14：检测浏览器进程崩溃/断连异常，标记以触发上层自动重建
+            browser_crash_keywords = (
+                "Target closed", "Browser was disconnected",
+                "Connection closed", "Target page, context or browser has been closed",
+                "net::ERR_ABORTED", "Page closed",
+            )
+            is_browser_crash = any(kw.lower() in err_str.lower() for kw in browser_crash_keywords)
+            if is_browser_crash:
+                logger.warning("  💥 步骤{} 浏览器崩溃/断连: {}", step_num, err_str[:100])
+                return StepResult(
+                    step=step_num,
+                    action=action_type,
+                    description=desc,
+                    status=StepStatus.ERROR,
+                    duration_seconds=elapsed,
+                    error_message=f"[BROWSER_CRASH] {err_str}",
+                ), None
+            logger.error("  ✗ 步骤{} 异常 | {:.1f}秒 | {}", step_num, elapsed, err_str[:100])
             return StepResult(
                 step=step_num,
                 action=action_type,
                 description=desc,
                 status=StepStatus.ERROR,
                 duration_seconds=elapsed,
-                error_message=str(e),
+                error_message=err_str,
             ), None
 
     @staticmethod

开发备忘录.md

@@ -1,10 +1,53 @@
 # TestPilot AI 开发备忘录
 
-> 最后更新：2026-03-28（✅ v14.13 web.md 选择器规则模板 +3 Pitfall）
+> 最后更新：2026-03-28（✅ v14.14 浏览器崩溃自动重建 + Checkpoint 导航路径恢复）
 > 项目结构详见 README.md，此处不重复。
 
 ---
 
+## ✅ v14.14 浏览器崩溃自动重建 + Checkpoint 导航路径恢复（2026-03-28）
+
+### 背景
+
+测试过程中发现两个引擎缺陷：
+1. 浏览器进程崩溃后引擎仍在运行但页面已失效，用户必须手动重启引擎
+2. 步骤失败时 L2 诊断降级到 AI 坐标点击，坐标不准导致继续雪崩；若当前场景有 setup（导航路径），重走 setup 更可靠
+
+### 修改文件
+- `src/testing/blueprint_runner.py`：三处修改，语法验证通过
+
+### 功能 1 — 浏览器崩溃自动重建（`_rebuild_browser_if_crashed()`）
+
+**触发条件**：`_execute_step()` 捕获到以下任意关键词异常时，错误前缀标记为 `[BROWSER_CRASH]`：
+```
+"Target closed" / "Browser was disconnected" / "Connection closed" /
+"Target page, context or browser has been closed" / "net::ERR_ABORTED" / "Page closed"
+```
+
+**修复流程**：
+1. `[BROWSER_CRASH]` 前缀被 `HubAction.RETRY` 分支识别
+2. 调用 `_rebuild_browser_if_crashed(blueprint)`：关闭旧 context/browser/playwright（忽略异常）→ 调 `self._browser.launch()` 重建 → 重新挂载控制台/网络监听
+3. 若有 setup 步骤：重跑 setup 恢复页面状态，再重试失败步骤
+4. 若是 flow 模式无 setup：重跑首场景，再重试
+
+### 功能 2 — Checkpoint 导航路径恢复（RETRY 分支增强）
+
+**触发条件**：步骤失败 + L2 建议 RETRY + 无 `recover_selector`（坐标）+ 场景有 setup 步骤
+
+**修复流程**：
+1. 重跑 setup 步骤（确定性 CSS/点击，比 AI 坐标可靠）→ 回到已知正确页面状态
+2. 若 setup 重跑失败→ 降级到 L2 提供的坐标点击（`recover_selector`）
+3. 最后重试原本失败的步骤
+
+**设计意图**：setup = 页面标签 + 导航路径。凡是通过 2+ 步导航才能到达的场景，必须定义 setup。引擎会自动用 setup 恢复页面状态，让场景具备自愈能力。
+
+### 蓝本写作规则同步更新
+
+`extension/templates/platforms/web.md` (v16→v17 规则补充)：
+- EIGHT: Setup — Rule 6：多步导航场景强制定义 setup，引擎自动用其做 checkpoint 恢复
+
+---
+
 ## ✅ v14.13 蓝本选择器规则模板升级（2026-03-28）
 
 **目标**：从 v14.12 测试日志的 29 个 Bug 中总结出 3 类高频选择器错误，写入 `web.md` 模板（Template v15→v16），让 AI 生成蓝本时自动规避。