@szc-ft/mcp-szcd-client 0.27.2 → 0.27.4

package/qwen-extension/skills/local-browser-test/local-browser-executor.cjs

@@ -38,6 +38,21 @@
  *   --max-rounds <n>        最大轮数（默认 60）
  */
 
+// 共享缓存自愈：6/17 反馈中 NODE_PATH 未注入会导致 puppeteer-core MODULE_NOT_FOUND。
+// 把 ~/.szcd-mcp/deps/node_modules 注入 module 解析路径，再 require puppeteer-core。
+(function ensureSharedDeps() {
+  try {
+    const os = require('os');
+    const Module = require('module');
+    const sharedDeps = require('path').join(os.homedir(), '.szcd-mcp', 'deps', 'node_modules');
+    if (require('fs').existsSync(sharedDeps) && !Module.globalPaths.includes(sharedDeps)) {
+      Module.globalPaths.push(sharedDeps);
+    }
+  } catch {
+    // ignore — 没有共享缓存时退回项目本地 node_modules
+  }
+})();
+
 const puppeteer = require('puppeteer-core');
 const fs = require('fs');
 const path = require('path');

package/standard-skill/local-browser-test/SKILL.md

@@ -79,8 +79,10 @@ AI 直接构造测试计划 JSON：
 | type | 功能 | 参数 | 返回 |
 |------|------|------|------|
 | observe | 结构化观察 | `selector`, `depth`, `frameContentContains`, `maxInteractiveElements` | `{ frames, tree, interactiveElements[] }` |
-| act | 按 index/selector 交互 | `index` 或 `selector/click/hover`, `typeText`, `clear`, `frameContentContains` | `{ acted, action, element }` |
+| act | 按 index/selector/menuPath 交互 | `index` 或 `selector/click/hover` 或 `menuPath`, `typeText`, `clear`, `frameContentContains` | `{ acted, action, element/steps }` |
 | assert | 轻量断言 | `selector`, `expect`, `urlContains`, `textContains` | `{ passed, checks }` |
+| apiCapture | API 请求/响应捕获 | `wait`, `urlPattern`, `method`, `includeResponseBody`, `frameContentContains` | `{ targets, requests, summary }` |
+| assertApi | API 捕获结果断言 | `maxFailed`, `requiredUrls`, `forbidStatusGte`, `minTotal` | `{ passed, checks, summary }` |
 | navigate | 导航到 URL | `url`, `waitUntil` | `{ url, title, loadTime }` |
 | screenshot | 页面截图 | `fullPage`, `clip`, `filename` | `{ filepath, width, height }` |
 | compare | 设计稿对比 | `designImagePath`, `threshold`, `regions[]` | `{ fidelity, diffPixels, diffImagePath, regions[] }` |
@@ -93,6 +95,7 @@ AI 直接构造测试计划 JSON：
 | findFrame | 查找微前端 iframe | `urlIncludes` 或 `urlRegex` 或 `titleIncludes` 或 `contentIncludes` 或 `frameIndex` | `{ found, frameUrl, matchedBy, totalFrames }` |
 | loginWait | 等待 SSO 登录完成 | `loginSelector`, `timeout`, `interval` | `{ loggedIn, elapsed, currentUrl }` |
 | aiAssert | 语义断言（截图+审查） | `assertion`, `filename` | `{ screenshotPath, assertion, needsVisualReview }` |
+| runTask | 高层任务 runner（批量动态菜单扫描） | `task: "menu-api-scan"`, `menuApiPattern`, `menuLimit`, `menuPathPrefix[]`, `menuFilter[]`, `drawerTriggerSelector`, `useNativeHover`, `apiCaptureOptions`, `continueOnFail` | `{ task, discovered, attempted, byOutcome, results[] }` |
 
 ### 场景选择策略
 
@@ -236,6 +239,18 @@ node {client_path}/local-browser-executor.js \
   --output /tmp/browser-act-observe.json
 ```
 
+### 左侧菜单路径稳定点击
+```bash
+node {client_path}/local-browser-executor.js \
+  --action act \
+  --url-contains "platform.aicityos.com" \
+  --menu-path "目录管理/数据集目录" \
+  --observe-after \
+  --output /tmp/browser-menu-act.json
+```
+
+`--menu-path` 会按路径逐级匹配菜单项，非末级优先执行展开，末级执行点击；匹配优先考虑 `role=menuitem`、`.ant-menu-item`、`.ant-menu-submenu-title` 和文本精确/包含匹配。
+
 ### 轻量 DOM 断言
 ```bash
 node {client_path}/local-browser-executor.js \
@@ -247,6 +262,34 @@ node {client_path}/local-browser-executor.js \
   --output /tmp/browser-assert.json
 ```
 
+### API 请求/响应捕获（真实浏览器 + 微前端）
+```bash
+node {client_path}/local-browser-executor.js \
+  --action api-capture \
+  --url-contains "platform.aicityos.com" \
+  --frame-content-contains "数据集目录" \
+  --url-pattern "/api/" \
+  --wait 15000 \
+  --include-response-body \
+  --reload \
+  --output /tmp/browser-api-capture.json
+```
+
+`api-capture` 使用 CDP `Network.*` 事件监听主页面和可 attach 的 page/iframe target，不使用 `setRequestInterception`，避免阻断真实请求。wujie/qiankun 场景优先传 `--frame-content-contains` 锁定业务 iframe；如需监听全部 target，追加 `--include-all-targets`。
+
+### API 捕获结果断言
+```bash
+node {client_path}/local-browser-executor.js \
+  --action assert-api \
+  --capture-file /tmp/browser-api-capture.json \
+  --max-failed 0 \
+  --forbid-status-gte 400 \
+  --required-url "/list" \
+  --output /tmp/browser-api-assert.json
+```
+
+计划内可直接在 `apiCapture` 后追加 `{ "type": "assertApi", "maxFailed": 0, "forbidStatusGte": 400 }`，会自动读取上一步捕获结果。
+
 ### 快速诊断（过渡兼容）
 ```bash
 NODE_PATH=~/.szcd-mcp/deps/node_modules node {skill_path}/local-browser-executor.cjs \
@@ -446,3 +489,71 @@ cd ~/.szcd-mcp/deps && npm install --registry=https://registry.npmmirror.com --@
     "outputDir": "/tmp/browser-test-xxx"
 }
 ```
+
+## 批量动态菜单扫描（runTask）
+
+适用场景：测试系统有 N 条动态路由（来自后端菜单接口），要逐条点击触发并验证接口是否返回 200。6/18 反馈中，AI 最终用 130 余条 `act --menu-path` + `api-capture` 手工组合走完 129 条菜单——`runTask` 把这套流水固化为单步骤。
+
+工作流：
+
+1. **第一步：先抓菜单接口**（一次即可，作为整张菜单树的来源）
+   ```bash
+   node local-browser-executor.js --action api-capture \
+       --url-pattern "listUserViewMenus" \
+       --include-response-body \
+       --include-all-targets \
+       --reload --wait 8000 \
+       --output /tmp/menu-tree.json
+   ```
+
+2. **第二步：把菜单树喂给 runTask**
+   ```bash
+   node local-browser-executor.js --action run-task \
+       --task menu-api-scan \
+       --capture-input-file /tmp/menu-tree.json \
+       --menu-path-prefix /catalog \
+       --menu-limit 20 \
+       --drawer-trigger-selector "[data-test=menu-toggle]" \
+       --use-native-hover true \
+       --max-retry-per-step 2 \
+       --wait 4000 \
+       --output /tmp/menu-scan-report.json
+   ```
+
+3. **结果解读**：`byOutcome` 给出四档统计：
+   - `apiOk`：菜单点开 + 接口 200 ✅
+   - `apiFailed`：菜单点开 + 接口 ≥400（看 `results[i].api.requests` 找具体 URL）
+   - `noApi`：菜单点开但没产生任何 XHR（可能是纯静态页或路由没触发请求）
+   - `clickFailed`：菜单点不开（看 `results[i].menuResult.failedAt` + `candidates`）
+
+4. **plan JSON 形式**（也可作为 `--plan-file` 一步：先 apiCapture 再 runTask）：
+   ```json
+   {
+     "steps": [
+       { "type": "apiCapture", "urlPattern": "listUserViewMenus", "includeResponseBody": true, "reload": true, "wait": 8000, "includeAllTargets": true },
+       { "type": "runTask", "task": "menu-api-scan", "menuLimit": 30, "drawerTriggerSelector": "[data-test=menu-toggle]" }
+     ]
+   }
+   ```
+   `runTask` 会自动从 `context.lastApiCapture` 拿菜单树，不需要再传文件。
+
+## 反模式备忘（来自 6/17 + 6/18 实战反馈）
+
+| 错误做法 | 正确做法 | 原因 |
+|---------|---------|------|
+| `setRequestInterception(true)` 抓接口 | 仅 CDP `Network.responseReceived` + `getResponseBody` | request interception 会拦下 wujie iframe 的 RPC 帧造成挂起 |
+| `page.click("text=保存")` 不加可见性过滤 | 默认走 `act` 的 `text=`，已自动只匹配 `visible+enabled` 的元素 | 隐藏在收起菜单/未渲染抽屉里的同名文本会被错误命中 |
+| 多级菜单只用一次 `dispatchEvent("mouseover")` | `useNativeHover: true`（默认） + `drawerTriggerSelector` 每级前重开 | Vue 的 v-on:mouseenter 对 dispatchEvent 不触发；抽屉式菜单点完一次会自动收起 |
+| `setTimeout(awaitPage.bringToFront(), 30000)` 之外不做兜底 | 调用前自查"目标页是否还活着"（`findPage` / `_findFrame`），失败立刻退而求其次操作主帧 | bringToFront 在 OS 抢焦点失败时会无限挂起，没超时 |
+| iframe attach 失败就报错退出 | `attachRetries` 默认 3 次、间隔 1.5s 重抓 `browser.targets()` | wujie 的 blob iframe target 在主页面 ready 后才注册，时序敏感 |
+| 大批量探索每条都 throw | `_actMenuPath` 失败时返回 `acted:false + candidates`，配合 `runTask --continue-on-fail` | 探索性扫描遇到一条点不开就全部中断，没法发现整体面 |
+
+## 非目标声明
+
+`local-browser-test` **不**承担以下职责，遇到时显式拒绝并指给正确工具：
+
+- ❌ 接口压力测试 / 并发性能验证 → 用 k6、wrk、jmeter
+- ❌ 跨浏览器兼容性矩阵（Safari/Firefox 多版本）→ BrowserStack / SauceLabs
+- ❌ 单元测试 / 组件级测试 → Vitest / Jest / RTL
+- ❌ 视觉回归全量对比（无 baseline 设计稿）→ Percy / Chromatic
+- ✅ 真实浏览器内的功能验证、API 时序捕获、设计稿单图对比、动态菜单批量扫描

package/standard-skill/local-browser-test/local-browser-executor.cjs

@@ -38,6 +38,21 @@
  *   --max-rounds <n>        最大轮数（默认 60）
  */
 
+// 共享缓存自愈：6/17 反馈中 NODE_PATH 未注入会导致 puppeteer-core MODULE_NOT_FOUND。
+// 把 ~/.szcd-mcp/deps/node_modules 注入 module 解析路径，再 require puppeteer-core。
+(function ensureSharedDeps() {
+  try {
+    const os = require('os');
+    const Module = require('module');
+    const sharedDeps = require('path').join(os.homedir(), '.szcd-mcp', 'deps', 'node_modules');
+    if (require('fs').existsSync(sharedDeps) && !Module.globalPaths.includes(sharedDeps)) {
+      Module.globalPaths.push(sharedDeps);
+    }
+  } catch {
+    // ignore — 没有共享缓存时退回项目本地 node_modules
+  }
+})();
+
 const puppeteer = require('puppeteer-core');
 const fs = require('fs');
 const path = require('path');

package/opencode-extension/skills/local-browser-test/local-browser-executor-old.cjs

@@ -1,395 +0,0 @@
-#!/usr/bin/env node
-/**
- * local-browser-executor.js - 本地浏览器自动化执行器
- *
- * 功能：
- *   --action diagnose    全面诊断（JS错误、网络请求、API检查、资源加载）
- *   --action list-pages  列出所有标签页
- *   --action screenshot  截图
- *   --action api-check   检查 API 请求状态
- *   --action plan        执行测试计划 JSON
- *
- * 连接方式：
- *   --cdp-url http://localhost:9222  (默认自动检测 9222)
- *   --auto-detect                    自动检测 Chrome/Edge 进程
- *
- * 通用参数：
- *   --url <url>          目标页面 URL
- *   --url-contains <s>   按关键词查找已打开的页面
- *   --wait <ms>          额外等待时间（默认 5000）
- *   --output <path>      结果输出文件
- *   --output-dir <dir>   截图/产物输出目录
- */
-
-const puppeteer = require('puppeteer-core');
-const fs = require('fs');
-const path = require('path');
-const http = require('http');
-
-// ===== 参数解析 =====
-const args = process.argv.slice(2);
-function getArg(name, defaultVal) {
-  const idx = args.indexOf(`--${name}`);
-  if (idx === -1) return defaultVal;
-  return args[idx + 1] || defaultVal;
-}
-function hasFlag(name) {
-  return args.includes(`--${name}`);
-}
-
-const ACTION = getArg('action', 'diagnose');
-const CDP_URL = getArg('cdp-url', 'http://localhost:9222');
-const TARGET_URL = getArg('url', null);
-const URL_CONTAINS = getArg('url-contains', null);
-const WAIT_MS = parseInt(getArg('wait', '5000'), 10);
-const OUTPUT = getArg('output', null);
-const OUTPUT_DIR = getArg('output-dir', '/tmp/browser-test');
-const PLAN_FILE = getArg('plan-file', null);
-
-// ===== 工具函数 =====
-function log(msg) { console.log(msg); }
-function ensureDir(dir) { fs.mkdirSync(dir, { recursive: true }); }
-
-function checkCDP(url) {
-  return new Promise((resolve) => {
-    const req = http.get(url + '/json/version', { timeout: 2000 }, (res) => {
-      let data = '';
-      res.on('data', c => data += c);
-      res.on('end', () => {
-        try { resolve(JSON.parse(data)); } catch { resolve(null); }
-      });
-    });
-    req.on('error', () => resolve(null));
-    req.on('timeout', () => { req.destroy(); resolve(null); });
-  });
-}
-
-async function findPage(browser) {
-  const pages = await browser.pages();
-  if (TARGET_URL) {
-    for (const p of pages) {
-      if (p.url().includes(TARGET_URL) || p.url() === TARGET_URL) return p;
-    }
-    // 导航到目标 URL
-    const p = pages[0] || await browser.newPage();
-    await p.goto(TARGET_URL, { waitUntil: 'domcontentloaded', timeout: 30000 });
-    return p;
-  }
-  if (URL_CONTAINS) {
-    for (const p of pages) {
-      if (p.url().includes(URL_CONTAINS)) return p;
-    }
-    log(`[WARN] 未找到包含 "${URL_CONTAINS}" 的页面，使用第一个页面`);
-  }
-  // 找到非 about:blank 的页面
-  for (const p of pages) {
-    if (!p.url().startsWith('about:') && !p.url().startsWith('devtools:')) return p;
-  }
-  return pages[0];
-}
-
-// ===== Action: list-pages =====
-async function listPages(browser) {
-  const pages = await browser.pages();
-  const result = [];
-  for (let i = 0; i < pages.length; i++) {
-    const p = pages[i];
-    let title = '';
-    try { title = await p.title(); } catch {}
-    result.push({ index: i, url: p.url(), title });
-    log(`[${i}] ${p.url()}`);
-    if (title) log(`    title: ${title}`);
-  }
-  return { pages: result, total: result.length };
-}
-
-// ===== Action: diagnose =====
-async function diagnose(browser) {
-  ensureDir(OUTPUT_DIR);
-  const page = await findPage(browser);
-  log(`[PAGE] ${page.url()}`);
-
-  // 收集数据
-  const pageErrors = [];
-  const consoleMessages = [];
-  const failedRequests = [];
-  const apiRequests = [];
-  const resourceRequests = [];
-
-  page.on('pageerror', err => {
-    pageErrors.push({ message: err.message, stack: err.stack?.split('\n').slice(0, 5).join('\n') });
-  });
-  page.on('console', msg => {
-    const type = msg.type();
-    const text = msg.text().substring(0, 500);
-    consoleMessages.push({ type, text });
-  });
-  page.on('response', resp => {
-    const url = resp.url();
-    const status = resp.status();
-    const type = resp.request().resourceType();
-    if (type === 'xhr' || type === 'fetch') {
-      apiRequests.push({ status, url, method: resp.request().method() });
-    }
-    if (type === 'stylesheet' || type === 'script') {
-      resourceRequests.push({ status, url, type });
-    }
-    if (status >= 400) {
-      failedRequests.push({ status, url, type });
-    }
-  });
-  page.on('requestfailed', req => {
-    failedRequests.push({ status: 'ABORTED', url: req.url(), error: req.failure()?.errorText });
-  });
-
-  // 刷新页面收集
-  log('[INFO] 刷新页面收集诊断数据...');
-  try {
-    await page.reload({ waitUntil: 'load', timeout: 30000 });
-  } catch (e) {
-    log(`[WARN] 刷新超时: ${e.message.substring(0, 100)}`);
-  }
-  await new Promise(r => setTimeout(r, WAIT_MS));
-
-  // 截图
-  const screenshotPath = path.join(OUTPUT_DIR, 'diagnose-screenshot.png');
-  await page.screenshot({ path: screenshotPath, fullPage: false });
-  log(`[OK] 截图: ${screenshotPath}`);
-
-  // 检查 iframe
-  const frames = page.frames();
-  const iframeInfo = [];
-  for (const frame of frames) {
-    const url = frame.url();
-    if (url === page.url() || url === 'about:blank') continue;
-    let bodyText = '';
-    let rootContent = '';
-    try {
-      const info = await frame.evaluate(() => ({
-        bodyText: document.body?.innerText?.substring(0, 200) || '',
-        rootHTML: document.getElementById('root')?.innerHTML?.substring(0, 200) || 'no root',
-        hasReactRoot: !document.getElementById('root')?.innerHTML?.includes('loading-spinner'),
-        antdElements: document.querySelectorAll('[class*="ant-"]').length,
-      }));
-      bodyText = info.bodyText;
-      rootContent = info.rootHTML;
-      iframeInfo.push({ url, ...info });
-    } catch (e) {
-      iframeInfo.push({ url, error: e.message.substring(0, 100) });
-    }
-  }
-
-  // 输出结果
-  const errors = consoleMessages.filter(m => m.type === 'error');
-  const warnings = consoleMessages.filter(m => m.type === 'warning');
-
-  const result = {
-    url: page.url(),
-    timestamp: new Date().toISOString(),
-    screenshot: screenshotPath,
-    pageErrors,
-    consoleErrors: errors,
-    consoleWarnings: warnings,
-    consoleTotal: consoleMessages.length,
-    failedRequests,
-    apiRequests,
-    resourceStatus: resourceRequests.map(r => ({
-      status: r.status, type: r.type, name: r.url.split('/').pop()
-    })),
-    iframes: iframeInfo,
-    summary: {
-      jsErrors: pageErrors.length,
-      consoleErrors: consoleMessages.filter(m => m.type === 'error').length,
-      failedNetwork: failedRequests.length,
-      totalAPI: apiRequests.length,
-      failedAPI: apiRequests.filter(r => r.status >= 400).length,
-      totalResources: resourceRequests.length,
-      failedResources: resourceRequests.filter(r => r.status >= 400).length,
-    }
-  };
-
-  // 打印摘要
-  log('\n========== 诊断结果 ==========');
-  log(`JS 异常: ${result.summary.jsErrors}`);
-  pageErrors.forEach(e => log(`  [PAGEERROR] ${e.message}`));
-  log(`Console 错误: ${errors.length}`);
-  errors.forEach(e => log(`  [ERROR] ${e.text}`));
-  log(`Console 警告: ${warnings.length}`);
-  warnings.forEach(e => log(`  [WARN] ${e.text}`));
-  log(`Console 消息总数: ${consoleMessages.length}`);
-  log(`失败网络请求: ${result.summary.failedNetwork}`);
-  failedRequests.forEach(r => log(`  [${r.status}] ${r.url}`));
-  log(`API 请求: ${result.summary.totalAPI} (失败: ${result.summary.failedAPI})`);
-  apiRequests.forEach(r => {
-    const marker = r.status >= 400 ? '❌' : '✅';
-    log(`  ${marker} [${r.status}] ${r.method} ${r.url}`);
-  });
-  log(`CSS/JS 资源: ${result.summary.totalResources} (失败: ${result.summary.failedResources})`);
-  resourceRequests.filter(r => r.status >= 400).forEach(r => log(`  ❌ [${r.status}] ${r.url}`));
-  if (iframeInfo.length > 0) {
-    log(`\niframe 信息:`);
-    iframeInfo.forEach(f => log(`  ${f.url} → ${f.error || (f.hasReactRoot ? 'React已挂载' : '未挂载')}`));
-  }
-
-  // 保存结果
-  if (OUTPUT) {
-    fs.writeFileSync(OUTPUT, JSON.stringify(result, null, 2));
-    log(`\n[OK] 结果已保存: ${OUTPUT}`);
-  }
-
-  return result;
-}
-
-// ===== Action: screenshot =====
-async function screenshot(browser) {
-  ensureDir(OUTPUT_DIR);
-  const page = await findPage(browser);
-  const filename = getArg('filename', 'screenshot.png');
-  const fullPath = path.join(OUTPUT_DIR, filename);
-  const fullPage = hasFlag('full-page');
-  await page.screenshot({ path: fullPath, fullPage });
-  log(`[OK] 截图已保存: ${fullPath}`);
-  return { filepath: fullPath };
-}
-
-// ===== Action: api-check =====
-async function apiCheck(browser) {
-  const page = await findPage(browser);
-  log(`[PAGE] ${page.url()}`);
-
-  const requests = [];
-  const failed = [];
-
-  page.on('response', resp => {
-    const type = resp.request().resourceType();
-    if (type === 'xhr' || type === 'fetch') {
-      requests.push({
-        status: resp.status(),
-        url: resp.url(),
-        method: resp.request().method(),
-        frameUrl: resp.request().frame()?.url?.() || '',
-      });
-    }
-  });
-  page.on('requestfailed', req => {
-    failed.push({ url: req.url(), error: req.failure()?.errorText });
-  });
-
-  log('[INFO] 刷新页面收集 API 请求...');
-  try { await page.reload({ waitUntil: 'load', timeout: 30000 }); } catch {}
-  await new Promise(r => setTimeout(r, WAIT_MS));
-
-  log('\n========== API 请求 ==========');
-  requests.forEach(r => {
-    const marker = r.status >= 400 ? '❌' : '✅';
-    const isIframe = r.frameUrl && r.frameUrl !== page.url() ? ' [iframe]' : '';
-    log(`${marker} [${r.status}] ${r.method} ${r.url}${isIframe}`);
-  });
-  if (failed.length > 0) {
-    log('\n========== 失败请求 ==========');
-    failed.forEach(r => log(`[FAILED] ${r.url} → ${r.error}`));
-  }
-  log(`\n总计: ${requests.length} 请求, 失败: ${requests.filter(r => r.status >= 400).length + failed.length}`);
-
-  return { requests, failed };
-}
-
-// ===== Action: plan =====
-async function executePlan(browser) {
-  const planPath = PLAN_FILE;
-  if (!planPath) { log('[ERROR] --plan-file 未指定'); return; }
-  const plan = JSON.parse(fs.readFileSync(planPath, 'utf-8'));
-  ensureDir(plan.options?.outputDir || OUTPUT_DIR);
-
-  log(`[PLAN] ${plan.description || plan.planId}`);
-  log(`[STEPS] ${plan.steps.length} 个步骤`);
-
-  const results = [];
-  let currentPage = await findPage(browser);
-
-  for (let i = 0; i < plan.steps.length; i++) {
-    const step = plan.steps[i];
-    const start = Date.now();
-    try {
-      let result = {};
-      switch (step.type) {
-        case 'navigate':
-          await currentPage.goto(step.url, { waitUntil: step.waitUntil || 'domcontentloaded', timeout: 30000 });
-          result = { url: currentPage.url() };
-          break;
-        case 'screenshot':
-          const fp = path.join(plan.options?.outputDir || OUTPUT_DIR, step.filename || `step-${i}.png`);
-          await currentPage.screenshot({ path: fp, fullPage: step.fullPage });
-          result = { filepath: fp };
-          break;
-        case 'waitFor':
-          if (step.selector) await currentPage.waitForSelector(step.selector, { timeout: step.timeout || 10000 });
-          result = { matched: true };
-          break;
-        case 'evaluate':
-          const evalResult = await currentPage.evaluate(step.expression);
-          result = { result: evalResult };
-          break;
-        case 'click':
-          await currentPage.click(step.selector);
-          result = { clicked: true };
-          break;
-        case 'checkElement':
-          const count = await currentPage.$$eval(step.selector, els => els.length).catch(() => 0);
-          const passed = step.expect?.minCount ? count >= step.expect.minCount : count > 0;
-          result = { passed, elementCount: count };
-          break;
-        default:
-          result = { skipped: true, reason: `unknown step type: ${step.type}` };
-      }
-      const duration = Date.now() - start;
-      results.push({ index: i, step: step.type, status: 'PASS', duration, ...result });
-      log(`  [${i + 1}/${plan.steps.length}] ✅ ${step.type} (${duration}ms)`);
-    } catch (e) {
-      const duration = Date.now() - start;
-      results.push({ index: i, step: step.type, status: 'FAIL', duration, error: e.message });
-      log(`  [${i + 1}/${plan.steps.length}] ❌ ${step.type} (${duration}ms) → ${e.message.substring(0, 100)}`);
-    }
-  }
-
-  const summary = {
-    total: results.length,
-    passed: results.filter(r => r.status === 'PASS').length,
-    failed: results.filter(r => r.status === 'FAIL').length,
-  };
-  log(`\n[RESULT] ${summary.passed}/${summary.total} 通过`);
-
-  if (OUTPUT) {
-    fs.writeFileSync(OUTPUT, JSON.stringify({ steps: results, summary }, null, 2));
-  }
-  return { steps: results, summary };
-}
-
-// ===== 主入口 =====
-(async () => {
-  // 检测 CDP
-  const cdpInfo = await checkCDP(CDP_URL);
-  if (!cdpInfo) {
-    log(`[ERROR] 无法连接到 CDP: ${CDP_URL}`);
-    log('请确保浏览器已启动调试端口:');
-    log('  Windows Edge: "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe" --remote-debugging-port=9222');
-    log('  Windows Chrome: "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe" --remote-debugging-port=9222');
-    process.exit(1);
-  }
-  log(`[CDP] ${cdpInfo.Browser || 'connected'} (${CDP_URL})`);
-
-  const browser = await puppeteer.connect({ browserURL: CDP_URL, defaultViewport: null });
-
-  let result;
-  switch (ACTION) {
-    case 'list-pages': result = await listPages(browser); break;
-    case 'diagnose': result = await diagnose(browser); break;
-    case 'screenshot': result = await screenshot(browser); break;
-    case 'api-check': result = await apiCheck(browser); break;
-    case 'plan': result = await executePlan(browser); break;
-    default: log(`[ERROR] 未知 action: ${ACTION}`);
-  }
-
-  browser.disconnect();
-  log('\n[DONE]');
-})();