fix: v1.5.5 - 修复三大Bug：规则重复注入、stopEngine命令、Playwright浏览器环境变量注入

- 规则注入：平台模板版本 v10v16，修复重复注入死循环
- stopEngine 命令：改为调用 engineManager.dispose()
- 引擎浏览器修复：
  * engineManager 启动子进程时注入 PLAYWRIGHT_BROWSERS_PATH
  * 检测已运行引擎是否浏览器可用，不可用时重启
  * 健康检查新增 browser_available 字段
  * 启动超时 30s120s（首次需装浏览器）
  * main.py 设置环境变量，首次运行自动 playwright install
- 版本更新：1.5.41.5.5，版本检查接口已更新

Author: zcj220

build_log.txt

@@ -2,7 +2,7 @@
   "name": "testpilot-ai",
   "displayName": "TestPilot AI",
   "description": "AI-powered automated testing robot — operates UI like a human, finds bugs, and auto-fixes them. Supports Web, Android, iOS, Mini Program & Desktop.",
-  "version": "1.5.4",
+  "version": "1.5.5",
   "publisher": "wenzhouxinzao",
   "engines": {
     "vscode": "^1.85.0"

ci_win.log

@@ -111,11 +111,18 @@ export class EngineManager {
     // 0. 版本检查（异步，不阻塞启动，但强制更新会提示）
     this._checkVersion().catch(() => {});
 
-    // 1. 已有引擎在跑，直接复用
+    // 1. 已有引擎在跑
     if (await this.isEngineRunning()) {
-      this._outputChannel.appendLine("[引擎] 检测到引擎已运行，直接连接");
-      this._setStatus("ready");
-      return;
+      // 检查 Playwright 浏览器是否可用，如果不可用说明是旧版引擎（未设置PLAYWRIGHT_BROWSERS_PATH）
+      const browserOk = await this._checkBrowserAvailable();
+      if (browserOk) {
+        this._outputChannel.appendLine("[引擎] 检测到引擎已运行，直接连接");
+        this._setStatus("ready");
+        return;
+      }
+      // 浏览器不可用 → 停掉旧引擎，用新参数重新启动
+      this._outputChannel.appendLine("[引擎] 检测到引擎已运行但浏览器不可用，重新启动以修复...");
+      await this._killExistingEngine();
     }
 
     // 2. globalStorage 目录必须存在
@@ -135,6 +142,54 @@ export class EngineManager {
     this._setStatus("ready");
   }
 
+  /** 检查 Playwright 浏览器是否存在于系统缓存 */
+  private _checkBrowserAvailable(): Promise<boolean> {
+    return new Promise((resolve) => {
+      const url = getEngineUrl() + "/api/v1/health";
+      const mod = url.startsWith("https") ? https : http;
+      const req = mod.get(url, { timeout: 2000 }, (res) => {
+        let body = "";
+        res.on("data", (chunk: Buffer) => { body += chunk.toString(); });
+        res.on("end", () => {
+          try {
+            const data = JSON.parse(body);
+            resolve(data.browser_available !== false);
+          } catch {
+            resolve(true); // 旧版引擎无此字段，不强制重启
+          }
+        });
+        res.resume();
+      });
+      req.on("error", () => resolve(true));
+      req.on("timeout", () => { req.destroy(); resolve(true); });
+    });
+  }
+
+  /** 杀掉端口 8900 上正在运行的引擎进程 */
+  private _killExistingEngine(): Promise<void> {
+    return new Promise((resolve) => {
+      if (this._engineProc) {
+        this._engineProc.kill();
+        this._engineProc = null;
+        setTimeout(resolve, 1000);
+        return;
+      }
+      // 用 HTTP DELETE 或直接让它自然停止（引擎暂无 shutdown 接口）
+      // 通过端口找进程并杀掉（仅 Windows）
+      if (process.platform === "win32") {
+        child_process.exec(
+          `for /f "tokens=5" %a in ('netstat -ano ^| findstr :8900') do taskkill /F /PID %a`,
+          () => setTimeout(resolve, 1500),
+        );
+      } else {
+        child_process.exec(
+          `fuser -k 8900/tcp`,
+          () => setTimeout(resolve, 1500),
+        );
+      }
+    });
+  }
+
   /** 从 GitHub Release 下载二进制（带进度条通知） */
   private async _downloadBinary(): Promise<void> {
     const fileName = getPlatformBinaryName();
@@ -218,10 +273,21 @@ export class EngineManager {
     return new Promise((resolve, reject) => {
       this._outputChannel.appendLine(`[引擎] 启动: ${this.binaryPath}`);
 
+      // 注入 PLAYWRIGHT_BROWSERS_PATH，确保 PyInstaller 打包的引擎能找到已安装的浏览器
+      // 避免 Playwright 在 _MEIxxxxxx 临时目录中搜索浏览器
+      const browsersPath = process.platform === "win32"
+        ? path.join(process.env["LOCALAPPDATA"] || os.homedir(), "ms-playwright")
+        : path.join(os.homedir(), ".cache", "ms-playwright");
+      this._outputChannel.appendLine(`[引擎] PLAYWRIGHT_BROWSERS_PATH=${browsersPath}`);
+
       this._engineProc = child_process.spawn(this.binaryPath, [], {
         cwd: os.homedir(),        // 工作目录设为用户主目录，让 data/ logs/ 写到那里
         detached: false,
         stdio: ["ignore", "pipe", "pipe"],
+        env: {
+          ...process.env,
+          PLAYWRIGHT_BROWSERS_PATH: browsersPath,
+        },
       });
 
       const onData = (chunk: Buffer) => {
@@ -248,8 +314,8 @@ export class EngineManager {
         this._setStatus("offline");
       });
 
-      // 超时保护：30 秒内未就绪视为失败
-      setTimeout(() => reject(new Error("引擎启动超时（30s），请检查 Output 面板日志")), 30000);
+      // 超时保护：120 秒内未就绪视为失败（首次启动可能需要下载 Playwright 浏览器）
+      setTimeout(() => reject(new Error("引擎启动超时（120s），请检查 Output 面板日志")), 120000);
     });
   }
 

ci_win2.log

@@ -331,105 +331,41 @@ export function activate(context: vscode.ExtensionContext): void {
     }),
   );
 
-  // ── 一键启动引擎（v10.0）──
+  // ── 一键启动引擎（v15.0：自动下载+启动二进制，无需选择目录）──
   context.subscriptions.push(
     vscode.commands.registerCommand("testpilot-ai.launchEngine", async () => {
-      // 查找项目根目录（优先用工作区，否则用插件设置）
-      const folders = vscode.workspace.workspaceFolders;
-      let projectRoot = "";
-
-      // 尝试在工作区中找到 TestPilotAI 项目（有 cli.py 的目录）
-      if (folders) {
-        for (const f of folders) {
-          const cliPath = vscode.Uri.joinPath(f.uri, "cli.py");
-          // 使用 fs.stat 检测文件是否存在
-          try {
-            const fs = require("fs");
-            if (fs.existsSync(cliPath.fsPath)) {
-              projectRoot = f.uri.fsPath;
-              break;
-            }
-          } catch {
-            // 忽略
-          }
-        }
-      }
-
-      if (!projectRoot) {
-        // 兜底：从配置中读取
-        const config = vscode.workspace.getConfiguration("testpilotAI");
-        projectRoot = config.get<string>("projectRoot", "");
-      }
-
-      if (!projectRoot) {
-        // 弹出目录选择框让用户手动指定
-        const selected = await vscode.window.showOpenDialog({
-          canSelectFiles: false,
-          canSelectFolders: true,
-          canSelectMany: false,
-          title: "选择 TestPilot AI 项目根目录（包含 cli.py 的文件夹）",
-        });
-        if (!selected || selected.length === 0) {
-          vscode.window.showErrorMessage(
-            "⚠️ 未选择目录，引擎启动取消。也可在 设置 → testpilotAI.projectRoot 中填入项目路径。",
-          );
-          return;
-        }
-        projectRoot = selected[0].fsPath;
-        // 验证选中的目录包含 cli.py
-        const fs = require("fs");
-        if (!fs.existsSync(require("path").join(projectRoot, "cli.py"))) {
-          vscode.window.showErrorMessage(
-            `❌ 所选目录不含 cli.py，请选择正确的 TestPilot AI 项目根目录。\n当前选择：${projectRoot}`,
-          );
-          return;
-        }
-        // 保存到设置，下次直接用
-        await vscode.workspace.getConfiguration("testpilotAI").update(
-          "projectRoot",
-          projectRoot,
-          vscode.ConfigurationTarget.Global,
-        );
-        outputChannel.appendLine(`[TestPilot AI] 已保存项目路径: ${projectRoot}`);
+      // 先检查引擎是否已在运行
+      if (await engineManager.isEngineRunning()) {
+        vscode.window.showInformationMessage("✅ TestPilot AI 引擎已在运行中");
+        client.connectWs();
+        return;
       }
 
-      // 若旧终端存在，先关闭（避免复用失效终端）
-      const existingTerminal = vscode.window.terminals.find(
-        (t) => t.name === "TestPilot Engine",
-      );
-      if (existingTerminal) {
-        existingTerminal.dispose();
-        outputChannel.appendLine("[TestPilot AI] 关闭旧引擎终端，准备重启");
+      // 调用 ensureRunning：自动从服务器下载引擎二进制并启动
+      // 首次安装时会显示下载进度条；已下载过则直接启动
+      try {
+        await engineManager.ensureRunning();
+        outputChannel.appendLine("[TestPilot AI] 引擎就绪");
+        client.connectWs();
+        vscode.window.showInformationMessage("✅ TestPilot AI 引擎启动成功");
+      } catch (err: unknown) {
+        const message = err instanceof Error ? err.message : String(err);
+        vscode.window.showErrorMessage(`TestPilot AI 引擎启动失败: ${message}\n请检查网络连接后重试。`);
       }
-
-      const terminal = vscode.window.createTerminal({
-        name: "TestPilot Engine",
-        cwd: projectRoot,
-      });
-      terminal.show();
-      terminal.sendText("poetry run python cli.py serve --force");
-      outputChannel.appendLine(`[TestPilot AI] 引擎启动中... 目录: ${projectRoot}`);
-      vscode.window.showInformationMessage("🚀 TestPilot AI 引擎正在启动...");
     }),
   );
 
   // ── 一键关闭引擎（v10.1）──
   context.subscriptions.push(
     vscode.commands.registerCommand("testpilot-ai.stopEngine", async () => {
-      const engineTerminal = vscode.window.terminals.find(
-        (t) => t.name === "TestPilot Engine",
-      );
-      if (engineTerminal) {
-        engineTerminal.dispose();
-        outputChannel.appendLine("[TestPilot AI] 引擎终端已关闭");
-      } else {
-        outputChannel.appendLine("[TestPilot AI] 未找到 TestPilot Engine 终端");
-      }
+      // 通过 engineManager 杀掉引擎子进程
+      engineManager.dispose();
+      outputChannel.appendLine("[TestPilot AI] 引擎进程已停止");
       // 断开 WebSocket 连接
       client.disconnectWs();
       // 通知 Sidebar 更新状态
       sidebarProvider.postMessage({ command: "engineStatus", data: { connected: false } });
-      vscode.window.showInformationMessage("⏹ TestPilot AI 引擎已断开");
+      vscode.window.showInformationMessage("⏹ TestPilot AI 引擎已停止");
     }),
   );
 

extension/package.json

@@ -416,9 +416,10 @@ export function injectRules(
     // 强制注入所有IDE规则（手动触发时）
     filesToInject = ["AGENTS.md", ...Object.values(IDE_RULES_MAP)];
   } else {
-    // 智能注入：AGENTS.md + CLAUDE.md + 当前IDE + 已安装的AI扩展
+    // 智能注入：AGENTS.md + 当前IDE + 已安装的AI扩展
+    // （CLAUDE.md 只在检测到 Claude Code 扩展时才注入，不强制创建）
     const detectedIDEs = detectAllIDEs();
-    filesToInject = ["AGENTS.md", "CLAUDE.md"];
+    filesToInject = ["AGENTS.md"];
 
     for (const ide of detectedIDEs) {
       const ruleFile = IDE_RULES_MAP[ide];

extension/src/engineManager.ts

@@ -3247,6 +3247,9 @@ ${commonRules}`;
         if (!wasConnected) {
           wasConnected = true;
           addLog("引擎连接成功 | v" + data.version, "success");
+          if (data.browser_available === false) {
+            addLog("⚠️ 浏览器未就绪，首次运行测试前引擎将自动安装 Chromium", "warning");
+          }
           vscode.postMessage({ command: "scanBlueprints" });
         }
       } else {

extension/src/extension.ts

@@ -1,4 +1,4 @@
-<!-- TestPilot-Template-Version: 10 -->
+<!-- TestPilot-Template-Version: 16 -->
 # Platform Blueprint Rules (platform = "android")
 
 > This file defines all rules for Android/Flutter application blueprints.

extension/src/rulesInjector.ts

@@ -1,4 +1,4 @@
-<!-- TestPilot-Template-Version: 10 -->
+<!-- TestPilot-Template-Version: 16 -->
 # Platform Blueprint Rules (platform = "desktop")
 
 > This file defines all rules for Windows desktop application blueprints.