v8: 5平台模板加强选择器三步验证 + Web专项Tailwind/submit陷阱

Author: zcj220

extension/src/rulesInjector.ts

@@ -81,7 +81,7 @@ function detectAllIDEs(): string[] {
  * 模板版本号。每次更新模板内容时递增。
  * rulesInjector 会检测已注入文件的版本号，低于此版本则自动更新。
  */
-const TEMPLATE_VERSION = 7;
+const TEMPLATE_VERSION = 8;
 
 /** 从文件内容中提取版本号，找不到返回 0（旧版无版本标记） */
 function extractVersion(content: string): number {

extension/templates/platforms/android.md

@@ -1,189 +1,199 @@
-<!-- TestPilot-Template-Version: 7 -->
-# Windows 桌面应用平台蓝本规则（platform = "desktop"）
+<!-- TestPilot-Template-Version: 8 -->
+# Windows 獢摨撟喳�閫�嚗latform = "desktop"嚗?
 
-> 本文件定义 Windows 桌面应用（WPF/WinForms/Electron/Qt 等）蓝本的完整规则。
-> 桌面测试通过 pywinauto / UI Automation 驱动。
-> 生成蓝本前**必须**通读本文件，不得跳过任何章节。
+> �祆�隞嗅�銋?Windows 獢摨嚗PF/WinForms/Electron/Qt 蝑�����渲��€?
+> 獢瘚��� pywinauto / UI Automation 撽勗�?
+> ����?*敹◆**�粉�祆�隞塚�銝�頝唾�隞颱�蝡��?
 
 ---
 
-## 零、生成蓝本前必须先通读源代码（强制执行）
+## �嗚€����砍�敹◆�€粉皞誨��撘箏�扯�嚗?
 
-**蓝本的唯一依据是代码，不是猜测，不是常识，不是用户描述。**
+**��銝€靘�臭誨��銝��嚗��臬虜霂�銝�冽�膩�?*
 
-在写任何 JSON 之前，必须按顺序完成：
+�典�隞颱� JSON 銋�嚗�憿餅�憿箏�摰�嚗?
 
-0. **先读 `testpilot/CHANGELOG.md`（如果存在）** — 了解当前已覆盖的功能和尚未测试的模块，避免重复写或漏写；如果不存在则跳过
-1. **读主窗口/入口文件** — 了解应用结构（如 `MainWindow.xaml`、`main.py`、`app.py`）
-2. **读每个窗口的 UI 文件** — 找出所有控件，记录真实的 `Name`、`AutomationId`、`Content` 属性
-3. **记录元素的真实标识** — `automationid:xxx` 或 `name:控件显示文字`（选择器的唯一来源）
-4. **读事件处理逻辑** — 确认每个按钮点击的真实结果（弹出什么窗口、显示什么文字）
-5. **确认提示方式** — 成功/失败提示是 `MessageBox`（阻塞弹窗，需 click 关闭）还是标签文字（可断言）
-6. **列出已实现功能** — 代码里有什么就测什么，未实现的功能不写蓝本
+0. **�粉 `testpilot/CHANGELOG.md`嚗����剁�** �?鈭圾敶�撌脰�������芣�霂�璅∪�嚗��憭�����憒�銝��典�頝唾�
+1. **霂颱蜓蝒/�亙�辣** �?鈭圾摨蝏�嚗� `MainWindow.xaml`�main.py`�app.py`嚗?
+2. **霂餅�銝芰���� UI �辣** �?�曉�€�隞塚�霈啣����?`Name`�AutomationId`�Content` 撅€?
+3. **霈啣�����摰�霂?* �?`automationid:xxx` �?`name:�找辣�曄內��`嚗€�函��臭��交�嚗?
+4. **霂颱�隞嗅��€餉�** �?蝖株恕瘥葵��孵��摰���撘孵隞€銋���€蝷箔�銋�摮�
+5. **蝖株恕�內�孵�** �?��/憭梯揖�內�?`MessageBox`嚗憛撕蝒��€ click �喲嚗��舀�蝑暹�摮��舀閮€嚗?
+6. **�撌脣��啣��?* �?隞����隞€銋停瘚�銋��芸��啁��銝��
 
-**禁止跳过代码阅读直接生成蓝本。凭想象写的选择器和断言几乎必然失败。**
+**蝳迫頝唾�隞���粉�湔�����唾情����典��剛���敹憭梯揖�?*
 
 ---
 
-## 一、必填字段
+## 銝€��憛怠�畾?
 
 | 摮挾 | 霂湔� | 蝷箔� |
 |------|------|------|
 | `platform` | �箏� `"desktop"` | `"desktop"` |
-| `window_title` | 主窗口标题（精确匹配） | `"财务管理系统"` |
+| `window_title` | 銝餌����憸�蝎曄＆�寥�嚗?| `"韐Ｗ蝞∠�蝟餌�"` |
 | `base_url` | **�征** `""` | `""` |
 | `app_name` | 摨�妍 | `"韐Ｗ蝞∠�蝟餌�"` |
-| `description` | 50-200字功能描述 | |
+| `description` | 50-200摮��賣�餈?| |
 | `start_command` | �臬�賭誘嚗�� | `"MyApp.exe"` |
 | `start_cwd` | �臬�桀�嚗�� | `"./dist"` |
 
 ### �蝳迫
 
-- ❌ `base_url` 填了 HTTP URL → 桌面应用不是 Web，留空
-- ❌ 填了 `app_package` / `bundle_id`（移动端字段）
-- ❌ `window_title` 填错（必须与应用标题栏完全一致）
+- �?`base_url` 憛思� HTTP URL �?獢摨銝 Web嚗�蝛?
+- �?憛思� `app_package` / `bundle_id`嚗宏�函垢摮挾嚗?
+- �?`window_title` 憛恍�嚗�憿颱�摨�����其��湛�
 
 ---
 
 ## 鈭€��剖��其�銵剁��芸�霈訾誑銝雿�
 
 | �其� | 敹‵� | 霂湔� |
 |------|---------|------|
-| `navigate` | `value`(窗口标题或命令), `description` | 启动/重启应用 |
+| `navigate` | `value`(蝒���隞?, `description` | �臬/�摨 |
 | `click` | `target`, `description` | �孵�� |
 | `fill` | `target`, `value`, `description` | 颲� |
-| `wait` | `description` | 等待（`value` 指定毫秒） |
-| `assert_text` | `expected`, `description` | 断言窗口内包含文本 |
+| `wait` | `description` | 蝑�嚗value` ��瘥怎�嚗?|
+| `assert_text` | `expected`, `description` | �剛�蝒���急��?|
 | `screenshot` | `description` | �芸�� |
 
-### 绝对禁止的动作
+### 蝏笆蝳迫�雿?
 
-- ❌ `select`、`navigate_to`、`evaluate`、`call_method`（非桌面动作）
-- ❌ `reset_state`、`page_query`、`scroll`（非桌面动作）
+- �?`select`�navigate_to`�evaluate`�call_method`嚗�獢�其�嚗?
+- �?`reset_state`�page_query`�scroll`嚗�獢�其�嚗?
 
 ---
 
-## 三、选择器规则
+## 銝€€�刻��?
 
-### 桌面应用选择器格式
+### 獢摨��冽撘?
 
-桌面应用元素通过 **屏幕上可见的原文** 定位：
+獢摨���� **撅�銝閫���** 摰�嚗?
 
 ```
 name:撅�銝閫���
 ```
 
-| 界面元素 | 蓝本选择器 |
+### � ��其�甇仿�霂�撘箏�扯�嚗�銝?target �賢�憿餃�嚗?
+
+�遙雿�銝?`target` ��其���敹◆摰�隞乩�銝郊嚗?*蝻箔�銝**嚗?
+
+1. **摰�皞�**嚗�啗砲�找辣�€�函� `.xaml` / `.py` / `.js` �辣嚗�雿�瑚�銵?
+2. **憭��**嚗�隞��銝剖��嗆隞嗥� `Content`�Header`�Text` 蝑��批€潘�**蝳迫�剛扇敹���**嚗�憒�隞��銝剜� `AutomationId`嚗�� `automationid:xxx`
+3. **撖寧�**嚗＆霈文��嗥���銝��函��Ｖ�摰��曄內��摮��其��湛��蝛箸���嫘€之撠�嚗?
+
+**銝�銝郊撉�撠勗��€�?= 敹�粹����舫€�典仃韐亦�蝚砌�憭批��€?*
+
+| ��� | ���?|
 |---------|-----------|
 | ��� "Login" | `name:Login` |
 | ��� "蝖桀�" | `name:蝖桀�` |
-| 输入框旁标签 "用户名" | `name:用户名` |
-| 菜单项 "文件" | `name:文件` |
-| 标签页 "设置" | `name:设置` |
+| 颲獢��倌 "�冽�? | `name:�冽� |
+| ��憿?"�辣" | `name:�辣` |
+| �倌憿?"霈曄蔭" | `name:霈曄蔭` |
 
-### ⚠️ 绝对禁止的写法
+### �� 蝏笆蝳迫��瘜?
 
-- ❌ `name:Login按钮`（禁止在原文后加中文后缀）
-- ❌ `name:确定按钮`（屏幕上只显示"确定"，不是"确定按钮"）
-- ❌ `name:用户名输入框`（屏幕上只显示"用户名"，不是"用户名输入框"）
-- ❌ `#id`、`.class`（Web CSS 选择器，桌面不支持）
-- ❌ `accessibility_id:xxx`（移动端选择器，桌面不支持）
+- �?`name:Login�`嚗�甇Ｗ����銝剜���嚗?
+- �?`name:蝖桀��`嚗�撟��芣蝷?蝖桀�"嚗��?蝖桀��"嚗?
+- �?`name:�冽���交�`嚗�撟��芣蝷?�冽�?嚗��?�冽���交�"嚗?
+- �?`#id`�.class`嚗eb CSS ��剁�獢銝��
+- �?`accessibility_id:xxx`嚗宏�函垢��剁�獢銝��
 
-**核心原则：`name:` 后面跟的必须是屏幕上肉眼可见的原文，不多不少。**
+**�詨���嚗name:` �頝�敹◆�臬�撟���航�����銝�銝��?*
 
 ---
 
-## 四、瞬态 UI 不可断言清单
+## �€�?UI 銝�剛�皜�
 
 | 蝏辣 | 霂湔� |
 |------|------|
-| 系统托盘通知 | 气泡提示，短暂显示 |
+| 蝟餌���� | 瘞部�內嚗�蝷?|
 | Splash Screen | �臬�駁嚗�蝘�瘨仃 |
-| 状态栏瞬态提示 | 短暂显示后恢复原文 |
+| �嗆€��祆€�蝷?| �剜��曄內�憭��?|
 | ToolTip | 曌��砍��內嚗宏撘€瘨仃 |
 
-### 代码稽核—持久性验证
+### 隞��蝔賣��銋€折�霂?
 
 ```
-✅ 可以断言：
-   - 窗口标题栏文字
-   - 按钮/标签持久显示的文字
+�?�臭誑�剛�嚗?
+   - 蝒����摮?
+   - �/�倌���曄內��摮?
    - �”憿嫘€”�澆����
-   - 状态栏持久化文字
+   - �嗆€�����摮?
 
-❌ 不能断言：
+�?銝�剛�嚗?
    - 瘞部�
    - �臬�駁
-   - 工具提示（ToolTip）
+   - 撌亙�內嚗oolTip嚗?
 ```
 
 ---
 
-## 五、等待时间计算公式
+## 鈭€�敺�渲恣蝞撘?
 
 ```
-wait 时间 = 操作耗时 + 1500ms（预留窗口刷新 + UI Automation 响应）
+wait �園 = ��� + 1500ms嚗������?+ UI Automation ��嚗?
 ```
 
 | �箸 | wait �園 |
 |------|----------|
-| 应用冷启动 | wait 3000-5000（视应用大小） |
-| 弹出子窗口/对话框 | wait 1500 |
+| 摨�瑕�?| wait 3000-5000嚗�摨憭批�嚗?|
+| 撘孵摮��?撖寡�獢?| wait 1500 |
 | �辣霂餃��� | wait 2000 |
 | 蝵�霂瑟� | API�園 + 1500 |
-| 纯 UI 控件操作 | wait 1000 |
+| 蝥?UI �找辣�� | wait 1000 |
 
 ---
 
-## 六、场景自包含原则与连续流模式（flow 强制决策）
+## �准€�航���銝�蝏剜�璅∪�嚗low 撘箏�喟�嚗?
 
-### ⚠️ 生成蓝本时必须对每个 page 做 flow 决策
+### �� ����嗅�憿餃笆瘥葵 page �?flow �喟�
 
-**判断规则（按顺序检查）：**
-1. 该 page 下有 ≥2 个场景，且都需要先登录才能操作？→ **必须 `"flow": true`**
-2. 该 page 下有 ≥2 个场景是连续菜单操作或多标签页切换？→ **必须 `"flow": true`**
-3. 该 page 下场景需要互相独立的干净状态（如正确登录 vs 错误登录）？→ 不写 flow（默认 false）
+**�斗閫�嚗�憿箏�璉€�伐�嚗?*
+1. 霂?page 銝� �? 銝芸�荔�銝�€閬��餃����嚗� **敹◆ `"flow": true`**
+2. 霂?page 銝� �? 銝芸�舀餈賒�������倌憿萄��ｇ��?**敹◆ `"flow": true`**
+3. 霂?page 銝�舫�閬��貊蝡�撟脣��嗆€�憒迤蝖桃敶?vs �秤�餃�嚗��?銝� flow嚗�霈?false嚗?
 
-**简单总结：如果多个场景都要先登录再操作同一个窗口，那这个 page 必须设 `"flow": true`。不加 flow 导致每个场景都重启应用+重复登录 = 严重浪费。**
+**蝞€�€餌�嚗���銝芸�舫閬��餃���雿�銝€銝芰�������銝?page 敹◆霈?`"flow": true`���?flow 撖潸瘥葵�箸�賡��臬��?���餃� = 銝仿�瘚芾晶�?*
 
-### 默认模式（`flow: false`）
+### 暺恕璅∪�嚗flow: false`嚗?
 
 - 撘��冽�銝芸�舫�航�摨
-- 每个场景的第一步应是 `navigate`（启动应用）+ `wait`（等启动完成）
-- **禁止**场景间传递状态
-- 如果场景需要特定前置状态（如已登录），必须在该场景内重新执行操作
+- 瘥葵�箸�洵銝€甇亙��?`navigate`嚗�典��剁�+ `wait`嚗��臬摰�嚗?
+- **蝳迫**�箸�港���?
+- 憒��箸�€閬摰�蝵桃��憒歇�餃�嚗�敹◆�刻砲�箸���唳銵�雿?
 
-### 连续流模式（`flow: true`）
+### 餈賒瘚芋撘�`flow: true`嚗?
 
-在 `page` 级别设置 `"flow": true`，同一页面内的场景将连续执行：
-- 仅第1个场景执行 navigate 启动应用，后续场景的 navigate **自动跳过**
-- 场景间保持窗口状态
-- 连续3个场景失败 → 尝试重启恢复后继续
-- 每个场景仍需写 navigate（方便单独运行）
+�?`page` 蝥批霈曄蔭 `"flow": true`嚗�銝€憿菟���箸撠�蝏剜銵�
+- 隞洵1銝芸�舀銵?navigate �臬摨嚗�蝏剖�舐� navigate **�芸頝唾�**
+- �箸�港������?
+- 餈賒3銝芸�臬仃韐?�?撠���Ｗ��誧蝏?
+- 瘥葵�箸隞��?navigate嚗靘踹��祈�銵�
 
-**重要：** flow 场景仍需写 navigate（方便单独运行），引擎在 flow 模式下自动跳过。
+**��嚗?* flow �箸隞��?navigate嚗靘踹��祈�銵�嚗�� flow 璅∪�銝�刻歲餈€?
 
 ### � flow ���箸��嚗��園�閬�敹◆�萄�嚗�
 
-**flow 模式下，第2个及之后的场景只写 navigate + 该场景自己的操作步骤，绝对禁止重复写登录步骤！**
+**flow 璅∪�銝�蝚?銝芸�銋���臬�?navigate + 霂亙�航撌梁���甇仿炊嚗�撖寧�甇ａ�憭��餃�甇仿炊嚗?*
 
-引擎会跳过非首场景的 navigate，直接从第2步开始执行。如果第2步是 `fill 用户名`，但页面此时已经登录在主界面上 → 找不到输入框 → 超时失败 → 连续3步失败 → 整个场景被熔断跳过 → 后续场景全部同样失败。
+撘�隡歲餈�擐�舐� navigate嚗�乩�蝚?甇亙�憪銵€��洵2甇交 `fill �冽�嚗�憿菟甇斗撌脩��餃��其蜓�銝?�?�曆��啗��交� �?頞憭梯揖 �?餈賒3甇亙仃韐?�?�港葵�箸鋡怎��剛歲餈?�?�賒�箸�券�憭梯揖�?
 
-| ❌ 错误写法（非首场景重复登录） | ✅ 正确写法（非首场景直接操作） |
+| �?�秤��嚗�擐�舫�憭敶� | �?甇�＆��嚗�擐�舐�交�雿� |
 |---|---|
-| 场景2: navigate → wait → fill用户名 → fill密码 → click登录 → wait → 实际操作 | 场景2: navigate → 实际操作 → assert_text |
-| 场景3: navigate → wait → fill用户名 → fill密码 → click登录 → wait → 实际操作 | 场景3: navigate → 实际操作 → assert_text |
+| �箸2: navigate �?wait �?fill�冽�?�?fill撖� �?click�餃� �?wait �?摰��� | �箸2: navigate �?摰��� �?assert_text |
+| �箸3: navigate �?wait �?fill�冽�?�?fill撖� �?click�餃� �?wait �?摰��� | �箸3: navigate �?摰��� �?assert_text |
 
-**核心原则：flow 模式下，只有第1个场景做完整的启动+登录流程，后续场景的 navigate 后面直接写该场景自己的操作。**
+**�詨���嚗low 璅∪�銝��芣�蝚?銝芸�臬�摰��?�餃�瘚�嚗�蝏剖�舐� navigate ��湔�砲�箸�芸楛��雿€?*
 
 ---
 
-## 七、完整 JSON 模板
+## 銝€��?JSON 璅⊥
 
 ```json
 {
-  "app_name": "你的应用名",
-  "description": "50-200字功能描述",
+  "app_name": "雿�摨�?,
+  "description": "50-200摮��賣�餈?,
   "base_url": "",
   "platform": "desktop",
   "window_title": "摨蝒��",
@@ -192,19 +202,19 @@ wait 时间 = 操作耗时 + 1500ms（预留窗口刷新 + UI Automation 响应
   "pages": [
     {
       "url": "",
-      "name": "主窗口",
+      "name": "銝餌��?,
       "scenarios": [
         {
           "name": "甇�＆�餃�",
           "steps": [
             {"action": "navigate", "value": "摨蝒��", "description": "�臬摨"},
             {"action": "wait", "value": "3000", "description": "蝑�摨蝒摰�蝸"},
-            {"action": "fill", "target": "name:用户名", "value": "admin", "description": "在用户名输入框输入admin"},
+            {"action": "fill", "target": "name:�冽�?, "value": "admin", "description": "�函�瑕�颲獢��仟dmin"},
             {"action": "fill", "target": "name:撖�", "value": "admin123", "description": "�典����交�颲admin123"},
-            {"action": "click", "target": "name:登录", "description": "点击登录按钮，验证账号后进入主界面"},
-            {"action": "wait", "value": "2000", "description": "等待登录验证和界面切换"},
-            {"action": "assert_text", "expected": "欢迎", "description": "验证主界面显示欢迎信息"},
-            {"action": "screenshot", "description": "登录成功后的主界面"}
+            {"action": "click", "target": "name:�餃�", "description": "�孵�餃��嚗�霂揭�瑕�餈銝餌��?},
+            {"action": "wait", "value": "2000", "description": "蝑��餃�撉����Ｗ��?},
+            {"action": "assert_text", "expected": "甈Ｚ�", "description": "撉�銝餌��Ｘ蝷箸洽餈縑�?},
+            {"action": "screenshot", "description": "�餃�����銝餌��?}
           ]
         }
       ]
@@ -215,24 +225,24 @@ wait 时间 = 操作耗时 + 1500ms（预留窗口刷新 + UI Automation 响应
 
 ---
 
-## 八、代码稽核清单
+## �怒€誨�里�豢��?
 
-- [ ] 查看应用界面，确认 `name:` 后的文字与屏幕显示完全一致
-- [ ] `name:` 后没有添加"按钮"/"输入框"等中文后缀
+- [ ] �亦�摨�嚗＆霈?`name:` ����銝�撟蝷箏��其��?
+- [ ] `name:` �瓷�溶�?�"/"颲獢?蝑葉��蝻€
 - [ ] `window_title` 銝��冽�憸�摰�寥�
-- [ ] `base_url` 为空字符串 `""`
+- [ ] `base_url` 銝箇征摮泵銝?`""`
 - [ ] `expected` ���函��Ｖ����曄內
-- [ ] 启动后有足够的 wait 时间
+- [ ] �臬��頞喳��?wait �園
 
 ---
 
-## 九、踩坑清单
+## 銋€萱���?
 
 | �秤 | �� | 甇�＆�� |
 |------|------|---------|
-| `name:登录按钮` | 找不到（屏幕只显示"登录"） | `name:登录` |
-| `name:用户名输入框` | 找不到 | `name:用户名` |
-| 用 CSS 选择器 `#id` | 桌面不支持 | 用 `name:原文` |
-| 用 `accessibility_id:` | 桌面不支持 | 用 `name:原文` |
-| 应用启动后没 wait | 窗口未就绪 | wait 3000-5000 |
-| `window_title` 拼错 | 引擎找不到窗口 | 与标题栏完全一致 |
+| `name:�餃��` | �曆��堆�撅��芣蝷?�餃�"嚗?| `name:�餃�` |
+| `name:�冽���交�` | �曆��?| `name:�冽� |
+| �?CSS ��?`#id` | 獢銝�?| �?`name:��` |
+| �?`accessibility_id:` | 獢銝�?| �?`name:��` |
+| 摨�臬�瓷 wait | 蝒�芸停蝏?| wait 3000-5000 |
+| `window_title` �潮� | 撘��曆��啁��?| 銝�憸�摰銝€�?|