fix: flow模式引擎修复+提示词强化 (v1.2.8)

- 引擎: flow非首场景navigate自动跳过,标记passed
- web.md: 新增React组件名选择器陷阱警告
- web.md: 新增flow非首场景禁止冗余登录步骤规则
- rulesInjector: 通用规则追加flow冗余步骤禁令+自检项
- 模板版本56, 插件版本1.2.71.2.8

Author: zcj220

extension/esbuild.js

@@ -15,7 +15,7 @@ esbuild.build({
 }).then(() => {
   // 自动同步到所有已安装的 IDE 扩展目录（开发便利）
   const home = process.env.USERPROFILE || "";
-  const extName = "testpilot-ai.testpilot-ai-1.2.7";
+  const extName = "testpilot-ai.testpilot-ai-1.2.8";
   const ideDirs = [
     path.join(home, ".vscode", "extensions", extName),
     path.join(home, ".trae", "extensions", extName),

extension/package.json

@@ -2,7 +2,7 @@
   "name": "testpilot-ai",
   "displayName": "TestPilot AI",
   "description": "AI驱动的自动化测试机器人 — 像人类一样操作UI、发现Bug、自动修复",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "publisher": "testpilot-ai",
   "engines": {
     "vscode": "^1.85.0"

extension/src/rulesInjector.ts

@@ -81,7 +81,7 @@ function detectAllIDEs(): string[] {
  * 模板版本号。每次更新模板内容时递增。
  * rulesInjector 会检测已注入文件的版本号，低于此版本则自动更新。
  */
-const TEMPLATE_VERSION = 5;
+const TEMPLATE_VERSION = 6;
 
 /** 从文件内容中提取版本号，找不到返回 0（旧版无版本标记） */
 function extractVersion(content: string): number {
@@ -276,6 +276,11 @@ function getTemplateContent(): string {
 
 **注意看：** 只有第1个场景做了完整的登录流程，后续场景直接在当前页面操作。navigate 步骤仍然保留（方便单独运行），但 flow 模式下引擎会自动跳过。
 
+**🚨 flow 非首场景禁止冗余步骤（必须遵守！）：**
+- flow 第2个及之后的场景，navigate 后面**直接写该场景自己的操作步骤**
+- **绝对禁止**在非首场景中重复写 wait→fill用户名→fill密码→click登录 等登录步骤
+- 引擎跳过 navigate 后从第2步开始执行，如果第2步是 \`fill 用户名\` 但页面已登录 → 找不到输入框 → 连续超时失败 → 场景被熔断
+
 ### flow 模式的行为
 
 | 行为 | \`flow: false\`（默认） | \`flow: true\` |
@@ -291,6 +296,7 @@ function getTemplateContent(): string {
 生成或修改蓝本后，**按顺序**逐项检查：
 
 - [ ] **【最重要】每个 page 都做了 flow 决策**：多场景共享登录状态 → \`"flow": true\`；需要干净状态的独立测试 → 不写 flow
+- [ ] **flow 非首场景没有冗余步骤**：只写 navigate + 该场景自己的操作，不重复登录流程
 - [ ] 所有用户可交互功能都有对应场景
 - [ ] 每个场景的第一步是 navigate（flow 模式下引擎自动跳过非首场景的 navigate）
 - [ ] \`platform\` 字段正确

extension/templates/platforms/web.md

@@ -1,4 +1,4 @@
-<!-- TestPilot-Template-Version: 5 -->
+<!-- TestPilot-Template-Version: 6 -->
 # Web 平台蓝本规则（platform = "web"）
 
 > 本文件定义 Web 应用（React/Vue/Angular/纯HTML）蓝本的完整规则。
@@ -95,8 +95,23 @@
 3. **`.class`** — 稳定 class，如 `.submit-btn`、`.nav-link`
 4. **组合选择器** — 缩小范围，如 `.form-login #username`
 
+### 🚨 React/Vue/Angular 组件名陷阱（必读！）
+
+**JSX/模板中的自定义组件名（如 `<Select>`、`<Modal>`、`<Dropdown>`、`<DatePicker>`）不会出现在渲染后的 DOM class 中！**
+
+AI 常犯的错误：看到代码里 `<Select>` 组件就写 `div[class*='Select'] button`，但实际渲染后根节点可能是 `<div class="relative">`，DOM 中根本没有 "Select" 这个 class，选择器必然超时失败。
+
+| ❌ 错误（基于组件名猜测） | ✅ 正确（基于实际渲染 DOM） |
+|---|---|
+| `div[class*='Select'] button` | 打开 Select.tsx 源码，发现根节点是 `<div class="relative">`，trigger 是 `<button type="button">` → 用 `div.relative > button[type='button']` |
+| `div[class*='Modal']` | 打开 Modal.tsx，发现渲染 `<div class="fixed inset-0">` → 用 `.fixed.inset-0` |
+| `div[class*='DatePicker']` | 打开 DatePicker.tsx，发现渲染 `<div class="date-picker">` → 用 `.date-picker` |
+
+**强制要求**：对每个 `target`，必须打开该组件的源文件，查看其 `return (...)` 中根元素实际渲染的 class/id，然后用实际的 class 写选择器。**绝对禁止用组件名猜测 CSS class。**
+
 ### 绝对禁止的选择器
 
+- ❌ `div[class*='ComponentName']` — 组件名不等于 CSS class，见上方陷阱说明
 - ❌ `div:nth-child(N)` — 脆弱，DOM 结构变化即失效
 - ❌ `body > div > div > form > input` — 层级太深，随改随断
 - ❌ `accessibility_id:xxx` — 这是手机平台选择器，Web 不支持
@@ -255,6 +270,56 @@ Web 应用通常把登录 token 存在 localStorage/sessionStorage，**即使刷
 
 **重要：** flow 场景仍需写 navigate（方便单独运行），引擎在 flow 模式下自动跳过。
 
+### 🚨 flow 非首场景写法（极其重要，必须遵守！）
+
+**flow 模式下，第2个及之后的场景只写 navigate + 该场景自己的操作步骤，绝对禁止重复写登录步骤！**
+
+引擎会跳过非首场景的 navigate，直接从第2步开始执行。如果第2步是 `fill 用户名`，但页面此时已经登录在功能页上 → 找不到输入框 → 超时失败 → 连续3步失败 → 整个场景被熔断跳过 → 后续场景全部同样失败。
+
+| ❌ 错误写法（非首场景重复登录） | ✅ 正确写法（非首场景直接操作） |
+|---|---|
+| 场景2: navigate → wait → fill用户名 → fill密码 → click登录 → wait → click选择生活账本 | 场景2: navigate → click选择生活账本 → wait → assert_text |
+| 场景3: navigate → wait → fill用户名 → fill密码 → click登录 → wait → click选择公司账本 | 场景3: navigate → click选择公司账本 → wait → assert_text |
+
+**正确的 flow 蓝本示例：**
+```json
+{
+  "flow": true,
+  "scenarios": [
+    {
+      "name": "登录进入功能页",
+      "steps": [
+        {"action": "navigate", "value": "http://localhost:5173"},
+        {"action": "wait", "value": "2000"},
+        {"action": "fill", "target": "#username", "value": "admin"},
+        {"action": "fill", "target": "#password", "value": "123456"},
+        {"action": "click", "target": "#loginBtn"},
+        {"action": "wait", "value": "2000"},
+        {"action": "assert_text", "expected": "功能页标题"}
+      ]
+    },
+    {
+      "name": "操作A",
+      "steps": [
+        {"action": "navigate", "value": "http://localhost:5173", "description": "flow模式下自动跳过"},
+        {"action": "click", "target": ".action-a-btn"},
+        {"action": "assert_text", "expected": "操作A结果"}
+      ]
+    },
+    {
+      "name": "操作B",
+      "steps": [
+        {"action": "navigate", "value": "http://localhost:5173", "description": "flow模式下自动跳过"},
+        {"action": "click", "target": ".action-b-btn"},
+        {"action": "assert_text", "expected": "操作B结果"}
+      ]
+    }
+  ]
+}
+```
+
+**核心原则：flow 模式下，只有第1个场景做完整的导航+登录流程，后续场景的 navigate 后面直接写该场景自己的操作。**
+
 ---
 
 ## 七、完整 JSON 模板
@@ -316,3 +381,5 @@ Web 应用通常把登录 token 存在 localStorage/sessionStorage，**即使刷
 | 场景间依赖登录状态 | 后续场景全部失败 | 每个场景独立登录 |
 | 没有 wait 就断言异步结果 | 断言时数据还没到 | 按公式计算 wait |
 | 选择器用了 `div:nth-child(3)` | 页面改版就断 | 用 id 或稳定 class |
+| **flow 非首场景重复写登录步骤** | navigate 被跳过后第2步是 fill 用户名，但页面已登录，找不到输入框，连续失败熔断 | flow 非首场景只写 navigate + 自己的操作 |
+| **用组件名猜 CSS class** | `div[class*='Select']` 永远不匹配，组件实际渲染 `<div class="relative">` | 打开组件源码看实际渲染的 class |

src/testing/blueprint_runner.py

@@ -185,10 +185,35 @@ async def run(
                         if s.action == "assert_text" and s.expected:
                             self._anomaly_detector.suppress_error_text(s.expected)
 
+                flow_first_nav_done = False  # 标记本场景是否已执行过navigate
                 for step_def in scenario.steps:
                     step_num += 1
                     desc = step_def.description or step_def.action
 
+                    # flow模式：非首场景的navigate自动跳过（保持前一场景页面状态）
+                    if is_flow and sc_idx > 0 and step_def.action == "navigate":
+                        if not flow_first_nav_done:
+                            flow_first_nav_done = True
+                            logger.info("  [步骤{}/{}] navigate | ⏭️ flow模式跳过（沿用上一场景页面状态）", step_num, blueprint.total_steps)
+                            try:
+                                step_action = ActionType(step_def.action)
+                            except ValueError:
+                                step_action = ActionType.SCREENSHOT
+                            result = StepResult(
+                                step=step_num, action=step_action,
+                                description=f"[flow跳过] {desc}",
+                                status=StepStatus.PASSED, duration_seconds=0,
+                            )
+                            self._hub.on_step_passed()
+                            self._hub.record_step(
+                                step_num, step_def.action, step_def.target, step_def.value,
+                                passed=True, error=None,
+                            )
+                            all_results.append(result)
+                            if self._on_step:
+                                await self._on_step(step_num, "done", desc)
+                            continue
+
                     # v2.0：控制器检查（暂停/停止/单步）
                     if self._controller:
                         await self._controller.wait_if_paused()

开发备忘录.md

@@ -3038,3 +3038,31 @@ saveBugRetryMap();
 
 插件版本 `1.2.6 → 1.2.7`，重新打包 `testpilot-ai-1.2.7.vsix`。
 
+## 24. flow模式引擎修复 + 提示词强化（2026-03-23）
+
+### 24.1 问题
+
+account_book 蓝本中 app-selector/life/business 三个 page 都设了 `flow: true`，但：
+1. **引擎未实现 flow 跳过 navigate**：文档说"后续场景的 navigate 自动跳过"，但引擎代码中没有这个逻辑，每个场景都执行了 navigate 导航回首页
+2. **蓝本非首场景写了冗余登录步骤**：flow 场景2/3/4 都写了完整的 navigate→wait→fill用户名→fill密码→click登录→wait，引擎跳过 navigate 后直接执行 fill 用户名，但页面已登录在 app-selector 页 → 找不到输入框 → 连续超时 → 熔断
+3. **Select 组件选择器基于组件名猜测**：`div[class*='Select'] button` 永远不匹配，实际渲染 `<div class="relative">`
+
+### 24.2 修复
+
+**引擎修复**（`src/testing/blueprint_runner.py`）：
+- flow 模式 + 非首场景（sc_idx > 0）+ navigate 动作 → 自动跳过，标记 passed，日志输出"flow模式跳过"
+
+**提示词修复**（`extension/templates/platforms/web.md`）：
+- 新增"React/Vue/Angular 组件名陷阱"章节，明确禁止用组件名猜测 CSS class
+- 新增"flow 非首场景写法"章节，明确规定非首场景只写 navigate + 该场景自己的操作，禁止重复登录
+- 踩坑清单增加两条：flow 冗余登录、组件名猜 class
+
+**通用规则修复**（`extension/src/rulesInjector.ts`）：
+- flow 示例后追加"🚨 flow 非首场景禁止冗余步骤"警告
+- 自检清单追加"flow 非首场景没有冗余步骤"检查项
+- TEMPLATE_VERSION 5 → 6（触发已注入项目自动更新）
+
+### 24.3 版本
+
+插件版本 `1.2.7 → 1.2.8`，模板版本 `5 → 6`，打包 `testpilot-ai-1.2.8.vsix`。
+