v14.1: 蓝本规则架构重构 - 单一来源化，模板精简v7，按钮提示词提炼为4行口令

Author: zcj220

_fix_memo.py

@@ -0,0 +1,63 @@
+
+with open(r'd:\projects\TestPilotAI\开发备忘录.md', 'r', encoding='utf-8') as f:
+    content = f.read()
+
+idx = content.find('\n## 30. v14.2')
+before = content[:idx]
+
+new_section = """
+
+---
+
+## 30. v14.2 上架准备（2026-03-24）
+
+### 30.1 今日完成内容
+
+| 事项 | 状态 |
+|------|------|
+| 插件侧边栏"引擎未连接"日志去重 | ✅ 完成（`hasLoggedDisconnected` 标志位）|
+| `extension/package.json` 完善（英文描述/关键词/分类/repository字段）| ✅ 完成 |
+| 官网语言切换按钮移除（Navbar.jsx）| ✅ 完成 |
+| 语言改为域名自动判定（LocaleContext.jsx）| ✅ 完成（修复了 `.com` 误判 Bug）|
+| Publisher ID 确认为 `wenzhouxinzao` | ✅ 写入 package.json |
+
+### 30.2 域名语言判断规则（已修复）
+
+**正确逻辑**（以 `LocaleContext.jsx` 为准）：
+- `testpilotai.pages.dev` → 英文（国际站，Cloudflare Pages 托管）
+- `xinzaoai.com` / 其他所有域名 → 中文（国内站）
+
+**修复的 Bug**：之前用 `host.endsWith('.com')` 会把 `xinzaoai.com` 也误判为英文版，现已改为只检测 `host.includes('pages.dev')`。
+
+### 30.3 VS Code Marketplace 关键账号
+
+| 项目 | 值 |
+|------|---|
+| Publisher ID | `wenzhouxinzao`（永久，账号级别，不会因插件不同而改变）|
+| 注册邮箱 | `375612929@qq.com` |
+| 国际官网 | https://testpilotai.pages.dev |
+| 国内官网 | https://xinzaoai.com |
+| PAT 令牌 | 待生成（dev.azure.com → Personal Access Tokens → Marketplace Manage 权限）|
+
+### 30.4 待完成（明日继续）
+
+- [ ] 生成 PAT 令牌并执行 `vsce publish` 正式上架 VS Code Marketplace
+- [ ] 确认 `/privacy` 页面在 pages.dev 上是否正确展示
+- [ ] 一键安装脚本（Windows .ps1 + macOS .sh）
+- [ ] Open VSX Registry 上架（覆盖 Cursor/Windsurf）
+
+### 30.5 commit 记录
+
+| commit | 内容 |
+|--------|------|
+| `af24e7a` | 日志去重 + 插件重打包 v1.3.0 |
+| `b408a2c` | v14.0-E 安全增强（完整实现）|
+| `44b2497` | 去掉语言切换按钮 + package.json 完善 |
+| `6f7451f` | 修复域名判断 Bug + Publisher ID 改为 wenzhouxinzao |
+| `d313005` | 更新上架行动清单（记录账号信息）|
+"""
+
+with open(r'd:\projects\TestPilotAI\开发备忘录.md', 'w', encoding='utf-8') as f:
+    f.write(before + new_section)
+
+print('Done')

extension/esbuild.js

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

extension/src/rulesInjector.ts

@@ -81,7 +81,7 @@ function detectAllIDEs(): string[] {
  * 模板版本号。每次更新模板内容时递增。
  * rulesInjector 会检测已注入文件的版本号，低于此版本则自动更新。
  */
-const TEMPLATE_VERSION = 6;
+const TEMPLATE_VERSION = 7;
 
 /** 从文件内容中提取版本号，找不到返回 0（旧版无版本标记） */
 function extractVersion(content: string): number {
@@ -210,131 +210,13 @@ function getTemplateContent(): string {
 
 ---
 
-## 三点五、连续流模式（flow）— 强制决策
-
-### ⚠️ 必须执行的决策步骤
-
-生成蓝本时，你**必须**对每个 \`page\` 做出 flow 决策，不允许跳过：
-
-**判断规则（按顺序检查）：**
-1. 该 page 下有 ≥2 个场景，且这些场景都需要先登录才能操作？→ **\`"flow": true\`**
-2. 该 page 下有 ≥2 个场景是同一页面内的 Tab 切换或连续操作？→ **\`"flow": true\`**
-3. 该 page 下的场景需要互相独立的干净状态（如：正确登录 vs 错误登录 vs 空字段）？→ **\`"flow": false\`**（可省略，默认就是 false）
-
-**常见错误（你必须避免）：**
-- ❌ 记账台有8个场景（添加交易、删除交易、切换类型…），每个都独立冷启动+登录 → **严重浪费！必须 flow: true**
-- ❌ 报表页有6个场景（看利润表、看费用表、下载报表…），每个都冷启动+登录+跳转到报表页 → **严重浪费！必须 flow: true**
-- ✅ 登录页有4个场景（正确登录、空用户名、错密码、注册），每个需要干净状态 → flow: false，正确
-
-**简单总结：如果多个场景都要先登录再操作同一个页面，那这个 page 必须设 \`"flow": true\`。**
-
-### 启用方式
-
-在 \`page\` 对象中添加 \`"flow": true\`：
-
-\`\`\`json
-{
-  "pages": [
-    {
-      "url": "",
-      "title": "记账台",
-      "flow": true,
-      "scenarios": [
-        {
-          "name": "登录进入记账台",
-          "steps": [
-            {"action": "navigate", "value": "com.example.app/.MainActivity", "description": "冷启动应用"},
-            {"action": "wait", "value": "3000"},
-            {"action": "fill", "target": "...", "value": "admin"},
-            {"action": "click", "target": "...", "description": "登录"},
-            {"action": "wait", "value": "3000"},
-            {"action": "assert_text", "expected": "记账台"}
-          ]
-        },
-        {
-          "name": "添加一笔交易",
-          "steps": [
-            {"action": "navigate", "value": "com.example.app/.MainActivity", "description": "（flow模式下自动跳过）"},
-            {"action": "fill", "target": "...", "value": "50.00", "description": "输入金额"},
-            {"action": "click", "target": "...", "description": "提交"},
-            {"action": "assert_text", "expected": "50.00"}
-          ]
-        },
-        {
-          "name": "删除交易",
-          "steps": [
-            {"action": "navigate", "value": "com.example.app/.MainActivity", "description": "（flow模式下自动跳过）"},
-            {"action": "click", "target": "...", "description": "删除"},
-            {"action": "assert_text", "expected": "已删除"}
-          ]
-        }
-      ]
-    }
-  ]
-}
-\`\`\`
-
-**注意看：** 只有第1个场景做了完整的登录流程，后续场景直接在当前页面操作。navigate 步骤仍然保留（方便单独运行），但 flow 模式下引擎会自动跳过。
-
-**🚨 flow 非首场景禁止冗余步骤（必须遵守！）：**
-- flow 第2个及之后的场景，navigate 后面**直接写该场景自己的操作步骤**
-- **绝对禁止**在非首场景中重复写 wait→fill用户名→fill密码→click登录 等登录步骤
-- 引擎跳过 navigate 后从第2步开始执行，如果第2步是 \`fill 用户名\` 但页面已登录 → 找不到输入框 → 连续超时失败 → 场景被熔断
-
-### flow 模式的行为
-
-| 行为 | \`flow: false\`（默认） | \`flow: true\` |
-|------|----------------------|---------------|
-| 场景首步 navigate | 执行（冷启动） | **仅第1个场景执行**，后续场景的 navigate 自动跳过 |
-| 场景间状态 | 清除（应用重启） | **保持**（前一场景的页面状态） |
-| 连续失败止损 | 3个场景连续失败 → 终止 | 3个场景连续失败 → **冷启动恢复**后继续 |
-
----
-
-## 四、蓝本通用自检清单
-
-生成或修改蓝本后，**按顺序**逐项检查：
-
-- [ ] **【最重要】每个 page 都做了 flow 决策**：多场景共享登录状态 → \`"flow": true\`；需要干净状态的独立测试 → 不写 flow
-- [ ] **flow 非首场景没有冗余步骤**：只写 navigate + 该场景自己的操作，不重复登录流程
-- [ ] 所有用户可交互功能都有对应场景
-- [ ] 每个场景的第一步是 navigate（flow 模式下引擎自动跳过非首场景的 navigate）
-- [ ] \`platform\` 字段正确
-- [ ] **已阅读对应平台规则文件**，选择器/动作/模板符合平台要求
-- [ ] \`target\` 选择器在源码中确实存在（已搜索验证）
-- [ ] \`expected\` 是界面上实际渲染的持久化文字（不是瞬态提示、不是变量名、不是注释）
-- [ ] 异步操作后有足够的 \`wait\` 时间（已检查代码中的延迟/API调用）
-- [ ] 页面跳转后有 \`wait\` + \`assert_text\` 验证到达目标页
-- [ ] 每个操作后有断言验证结果（不能只操作不验证）
+## 四、所有详细规则 → 参见平台规则文件（必须阅读！）
 
----
-
-## 五、description 最佳实践
-
-每个步骤的 \`description\` 应包含位置和预期变化：
-
-\`\`\`
-✅ "点击提交按钮，点击后表单数据提交到后端，页面显示'提交成功'提示"
-✅ "在页面中部的用户名输入框输入admin，输入后输入框显示admin"
-❌ "点击按钮"
-❌ "输入用户名"
-\`\`\`
-
----
+**蓝本的选择器、动作表、完整模板、连续流模式（flow）写法、自检清单、描述规范、踩坑清单等全部详细规则，都在平台专属规则文件中定义。**
 
-## 六、选择器、动作表、模板、注意事项 → 参见平台规则
+确定 \`platform\` 后，**立即打开并通读** \`.testpilot/platforms/{platform}.md\`，严格遵守该文件中的所有规则。
 
-**禁止在不阅读平台规则的情况下编写蓝本。** 以下内容在各平台规则文件中定义，不在本文件重复：
-
-- 该平台的封闭式动作表（只允许列出的动作）
-- 该平台的选择器格式、优先级、禁止列表
-- 该平台的完整 JSON 模板
-- 该平台的瞬态 UI 不可断言清单
-- 该平台的等待时间计算公式
-- 该平台的踩坑清单和常见错误
-- 该平台的代码稽核要求
-
-请在确定 \`platform\` 后，立即打开 \`.testpilot/platforms/{platform}.md\` 阅读完整规则。
+**禁止在不阅读平台规则文件的情况下编写蓝本。**
 `;
 }
 
@@ -478,6 +360,16 @@ export function injectRules(
       }
     }
 
+    // 额外：扫描所有已存在的规则文件，如果版本过旧也一并更新（防止跨IDE版本漂移）
+    for (const [, ruleFile] of Object.entries(IDE_RULES_MAP)) {
+      if (!filesToInject.includes(ruleFile)) {
+        const ruleFullPath = path.join(workspaceRoot, ruleFile);
+        if (fs.existsSync(ruleFullPath)) {
+          filesToInject.push(ruleFile);
+        }
+      }
+    }
+
     outputChannel?.appendLine(`[TestPilot AI] 检测到IDE: ${detectedIDEs.join(", ")}`);
   }
 

extension/src/sidebarProvider.ts

@@ -298,6 +298,11 @@ export class SidebarProvider implements vscode.WebviewViewProvider {
     autoRepair: boolean;
     projectPath: string;
   }): Promise<void> {
+    const token = await this._context.secrets.get("testpilot.token");
+    if (!token) {
+      this._postMessage({ command: "testError", data: { error: "请先登录账号后再运行测试" } });
+      return;
+    }
     try {
       this._client.ensureWsConnected();
       this._postMessage({ command: "testStarted" });
@@ -327,6 +332,11 @@ export class SidebarProvider implements vscode.WebviewViewProvider {
     platform?: string;
     mobile_session_id?: string;
   }): Promise<void> {
+    const token = await this._context.secrets.get("testpilot.token");
+    if (!token) {
+      this._postMessage({ command: "testError", data: { error: "请先登录账号后再运行测试" } });
+      return;
+    }
     try {
       // 测试前确保 WebSocket 已连接，保证步骤进度能实时推送到 WebView
       this._client.ensureWsConnected();
@@ -392,6 +402,11 @@ export class SidebarProvider implements vscode.WebviewViewProvider {
     platform?: string;
     mobile_session_id?: string;
   }): Promise<void> {
+    const token = await this._context.secrets.get("testpilot.token");
+    if (!token) {
+      this._postMessage({ command: "testError", data: { error: "请先登录账号后再运行测试" } });
+      return;
+    }
     try {
       this._client.ensureWsConnected();
       this._postMessage({ command: "testStarted" });
@@ -778,37 +793,15 @@ export class SidebarProvider implements vscode.WebviewViewProvider {
     const lines: string[] = [];
     if (projectDir) {
       lines.push(`当前项目路径：${projectDir.replace(/\\/g, "/")}`);
-      lines.push(`请直接读取该目录下的源代码生成蓝本，无需再次询问项目路径。`);
       lines.push(``);
     }
     lines.push(`请为当前【${pName}】项目生成或更新测试蓝本。`);
     lines.push(``);
-    lines.push(`⚠️ 生成前请先按顺序完成以下步骤（缺一不可）：`);
-    lines.push(`1. 阅读 AGENTS.md（蓝本通用规则）`);
-    lines.push(`2. 阅读 .testpilot/platforms/${platform}.md（${pName}平台专属规则、选择器规范和完整模板）`);
-    lines.push(`3. 通读项目源代码，确认已实现的功能列表`);
-    lines.push(`4. 检查 testpilot/ 目录是否已有蓝本文件：`);
-    lines.push(`   - 若【没有蓝本】：按规则从零生成完整蓝本，保存到 testpilot/ 目录`);
-    lines.push(`     ⚠️ 生成时 start_cwd 必须填当前项目的绝对路径，禁止填 "." 或相对路径`);
-    lines.push(`   - 若【已有蓝本】：必须按以下步骤做增量更新（禁止跳过任意一步）：`);
-    lines.push(`     a. 校验配置字段（必须逐项检查）：`);
-    lines.push(`        - start_cwd：必须是绝对路径（如 D:\\projects\\my-app 或 /home/user/my-app），禁止是 "." 或相对路径`);
-    lines.push(`        - base_url：必须非空且格式正确（如 http://localhost:5173）`);
-    lines.push(`        - platform：必须与项目类型匹配`);
-    lines.push(`        - start_command：必须能在 start_cwd 目录下独立运行`);
-    lines.push(`     b. 读取现有蓝本，列出其中所有 target 选择器`);
-    lines.push(`     c. 对每个 target，打开对应的源文件（HTML/JSX/TSX/Vue），验证该选择器真实存在：`);
-    lines.push(`        - 找到对应 DOM 元素：保留`);
-    lines.push(`        - 搜不到或已失效：更正为源码中实际存在的选择器`);
-    lines.push(`        ⚠️【选择器陷阱】React/Vue/Angular 中 <Select>、<Modal>、<Dropdown> 等自定义组件名`);
-    lines.push(`           不会出现在渲染后的 DOM class 中！必须打开该组件的源文件查看其根元素实际渲染的 class/id。`);
-    lines.push(`           例如：JSX 里 <CategorySelect /> 渲染后根节点可能是 <div class="relative"> 而不是 <div class="CategorySelect">`);
-    lines.push(`     d. 检查每个页面下的场景数量：若某个 page 有 ≥2 个场景且都需要先登录后操作同一页面，`);
-    lines.push(`        必须给该 page 设置 "flow": true，避免每个场景都重复冷启动+登录（极大浪费时间）`);
-    lines.push(`     e. 检查源码中是否有新增功能未被现有蓝本覆盖，若有则补充对应场景`);
-    lines.push(`     f. 检查已删除的功能，删除对应场景`);
-    lines.push(`     g. 将更新后的完整蓝本覆盖写回原文件（禁止新建额外文件）`);
-    lines.push(`     ⚠️ 禁止仅凭印象或整体扫描就宣布"无需更新"——必须逐个搜索验证每个 target`);
+    lines.push(`请按顺序完成以下步骤：`);
+    lines.push(`1. 阅读本项目的 AGENTS.md`);
+    lines.push(`2. 阅读 .testpilot/platforms/${platform}.md`);
+    lines.push(`3. 扫描项目源码，确认已实现的功能`);
+    lines.push(`4. 按两个文件中的规则，生成或更新 testpilot/ 目录下的蓝本`);
 
     const prompt = lines.join("\n");
     await vscode.env.clipboard.writeText(prompt);
@@ -1412,22 +1405,22 @@ ${commonRules}`;
     content="default-src 'none'; style-src 'unsafe-inline'; script-src 'nonce-${nonce}'; img-src data:;">
   <title>TestPilot AI</title>
   <style>
-    body { position: relative; }
+    body { position: relative; background: var(--bg); }
     :root {
-      --bg: var(--vscode-sideBar-background, #1e1e1e);
-      --fg: var(--vscode-sideBar-foreground, #cccccc);
-      --input-bg: var(--vscode-input-background, #3c3c3c);
-      --input-border: var(--vscode-input-border, rgba(255,255,255,0.35));
-      --input-fg: var(--vscode-input-foreground, #cccccc);
-      --btn-bg: var(--vscode-button-background, #0e639c);
-      --btn-fg: var(--vscode-button-foreground, #ffffff);
-      --btn-hover: var(--vscode-button-hoverBackground, #1177bb);
-      --muted: var(--vscode-descriptionForeground, rgba(204,204,204,0.55));
+      --bg: #1e1e1e;
+      --fg: #cccccc;
+      --input-bg: #3c3c3c;
+      --input-border: rgba(255,255,255,0.35);
+      --input-fg: #cccccc;
+      --btn-bg: #0e639c;
+      --btn-fg: #ffffff;
+      --btn-hover: #1177bb;
+      --muted: rgba(204,204,204,0.55);
       --success: #4ec9b0;
       --error: #f44747;
       --warn: #cca700;
-      --info: var(--vscode-descriptionForeground, #9d9d9d);
-      --editor-bg: var(--vscode-editor-background, #252526);
+      --info: #9d9d9d;
+      --editor-bg: #252526;
     }
     body.light-mode {
       --bg: #e8e8e8;
@@ -1525,7 +1518,7 @@ ${commonRules}`;
       padding:0 12px 6px; text-align:right;
     }
     * { margin: 0; padding: 0; box-sizing: border-box; }
-    body { font-family: var(--vscode-font-family); font-size: 13px; color: var(--fg); padding: 12px; }
+    body { font-family: "Segoe UI", system-ui, -apple-system, sans-serif; font-size: 13px; color: var(--fg); padding: 12px; }
     h2 { font-size: 14px; margin-bottom: 8px; display: flex; align-items: center; gap: 6px; }
     .section { margin-bottom: 16px; }
     .status-dot { width: 8px; height: 8px; border-radius: 50%; display: inline-block; }
@@ -1571,7 +1564,7 @@ ${commonRules}`;
       padding: 8px;
       max-height: 200px;
       overflow-y: auto;
-      font-family: var(--vscode-editor-font-family);
+      font-family: "Cascadia Code", "Consolas", "Courier New", monospace;
       font-size: 12px;
       line-height: 1.5;
     }

extension/templates/platforms/android.md

@@ -1,4 +1,4 @@
-<!-- TestPilot-Template-Version: 3 -->
+<!-- TestPilot-Template-Version: 7 -->
 # Android/Flutter 平台蓝本规则（platform = "android"）
 
 > 本文件定义 Android 原生应用和 Flutter 应用蓝本的完整规则。
@@ -226,6 +226,19 @@ wait 时间 = 代码中的异步延迟 + 2000ms（预留 Flutter 渲染 + Appium
 
 **重要：** flow 场景仍需写 navigate 步骤（方便单独运行），引擎在 flow 模式下自动跳过非首场景的 navigate。
 
+### 🚨 flow 非首场景写法（极其重要，必须遵守！）
+
+**flow 模式下，第2个及之后的场景只写 navigate + 该场景自己的操作步骤，绝对禁止重复写登录步骤！**
+
+引擎会跳过非首场景的 navigate，直接从第2步开始执行。如果第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 |
+
+**核心原则：flow 模式下，只有第1个场景做完整的冷启动+登录流程，后续场景的 navigate 后面直接写该场景自己的操作。**
+
 ---
 
 ## 七、完整 JSON 模板