执行器策略3改为quitopenauto+BOM修复+备忘录更新

Author: zcj220

src/controller/miniprogram_runner.js

@@ -34,7 +34,8 @@ if (!stepsFile || !fs.existsSync(stepsFile)) {
   process.exit(1);
 }
 
-const input = JSON.parse(fs.readFileSync(stepsFile, 'utf8'));
+const rawContent = fs.readFileSync(stepsFile, 'utf8').replace(/^\uFEFF/, '');
+const input = JSON.parse(rawContent);
 const PROJECT_PATH = input.project_path || '';
 const WS_PORT = input.ws_port || 9420;
 const steps = input.steps || [];
@@ -100,22 +101,27 @@ async function initConnect() {
     }
   }
 
-  // 策略3: open+auto（不做close！close会破坏模拟器状态）
-  console.log('[策略3] 执行 open + auto（不close）...');
-  runCli(`open --project "${PROJECT_PATH}"`);
+  // 策略3: quit彻底杀进程 → open → auto（跟手动修复流程一致）
+  console.log('[策略3] cli quit 彻底杀进程后重启...');
+  runCli('quit');
   await sleep(5000);
+  console.log('[策略3] cli open...');
+  runCli(`open --project "${PROJECT_PATH}"`);
+  await sleep(8000);
+  console.log('[策略3] cli auto...');
   runCli(`auto --project "${PROJECT_PATH}" --auto-port ${WS_PORT}`);
   await sleep(3000);
   for (let i = 0; i < 5; i++) {
     try {
       const p = await tryConnect();
-      console.log('[策略3] open+auto后连接成功，页面: ' + p);
+      console.log('[策略3] 重启后连接成功，页面: ' + p);
       return p;
     } catch (e) {
+      console.log('[策略3] 重试 ' + (i+1) + '/5: ' + e.message);
       if (i < 4) await sleep(3000);
     }
   }
-  throw new Error('所有策略均失败。请手动在开发者工具中点编译(Ctrl+B)后重试');
+  throw new Error('所有策略均失败。请确认: 1)微信开发者工具已安装 2)设置→安全设置→已开启服务端口');
 }
 
 // ── 执行单个步骤 ──

test_steps.json

@@ -0,0 +1 @@
+{"project_path":"D:/projects/TestPilotAI/miniprogram-demo","ws_port":9420,"steps":[{"action":"screenshot","description":"首页截图"}]}

开发备忘录.md

@@ -981,6 +981,50 @@ HTTP服务器已就绪（0.5秒）
 
 ---
 
+### v10.4 砍掉桥接服务器+执行器模式（2026-03-08 下午）
+
+**架构变更**：砍掉桥接服务器（`miniprogram_bridge_server.js`），改用一次性Node.js执行器（`miniprogram_runner.js`）。
+
+**新架构**：
+```
+插件 → Python API → 写JSON步骤文件 → node miniprogram_runner.js → 执行步骤 → 输出JSON → Python解析返回
+```
+跟`run_blind_test.js`一模一样的模式：Node.js脚本自己做所有事情，跑完就退出。没有长连接、没有桥接服务器、没有端口占用问题。
+
+**三级连接策略**（`miniprogram_runner.js`）：
+```
+策略1: 直接connect（模拟器已正常+auto已启动时，0.1秒秒连）
+策略2: 只执行cli auto → connect（不close不open）
+策略3: cli open + cli auto → connect（不做close！）
+```
+
+**关键发现和铁律**：
+
+1. **绝对不能cli close**：`cli close`会破坏模拟器状态，之后open回来的模拟器永远是"启动失败: TypeError: Failed to fetch"，连`cli cache --clean compile`都救不回来
+2. **开发者工具进程残留问题**：`cli quit`不能杀干净所有进程，必须用`Get-Process wechatdevtools | Stop-Process -Force`彻底杀掉后才能干净重启
+3. **模拟器"启动失败"的修复流程**：
+   ```
+   ① Get-Process wechatdevtools, "微信开发者工具" | Stop-Process -Force
+   ② 等5秒
+   ③ cli open --project "项目路径"
+   ④ 等8秒
+   ⑤ cli auto --project "项目路径" --auto-port 9420
+   ⑥ 确认输出 √ auto
+   ```
+4. **run_blind_test.js会断开auto**：该脚本做了`close→open→auto`重连，跑完后`mp.disconnect()`会断开automator连接，后续其他脚本策略1直连会失败
+5. **SDK方法全部超时**：`mp.navigateTo()`, `mp.reLaunch()`等SDK封装方法会10秒超时，必须用`evaluate(() => wx.navigateTo({url:...}))`原生API调用
+6. **PowerShell Out-File会加BOM头**：导致Node.js的`JSON.parse`失败，需要`replace(/^\uFEFF/, '')`去BOM
+7. **项目列表重复**：扫描蓝本时可能存在重复加载，需要去重
+
+**修改文件**：
+- `src/controller/miniprogram_runner.js`（新增）：一次性Node.js执行器，三级连接策略
+- `src/api/routes.py`：小程序蓝本测试改用执行器模式，不再依赖MiniProgramController
+- `src/controller/miniprogram_bridge_server.js`（保留但不再使用）
+
+**Git提交**：e857d4f
+
+---
+
 ### 下一步目标（v10.4）
 
 #### 优先级1：端到端验证