@szc-ft/mcp-szcd-client 0.35.0 → 0.38.0

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

@@ -1,742 +0,0 @@
-#!/usr/bin/env node
-/**
- * local-browser-executor.cjs - 本地浏览器自动化执行器
- *
- * 功能：
- *   --action diagnose       全面诊断（JS错误、网络请求、API检查、资源加载）
- *   --action list-pages     列出所有标签页
- *   --action screenshot     截图（支持 --full-page 滚动截图）
- *   --action api-check      检查 API 请求状态
- *   --action snapshot       结构化 DOM 快照（类似 browser-use take_snapshot）
- *   --action interact       智能交互（支持 text=/role= 选择器，类似 Playwright）
- *   --action perf           性能指标采集（FCP/LCP/CLS/TBT）
- *   --action watch          持续监控模式（定时截图+错误检测）
- *   --action plan           执行测试计划 JSON
- *
- * 连接方式：
- *   --cdp-url http://localhost:9222  (默认 9222)
- *
- * 通用参数：
- *   --url <url>             目标页面 URL
- *   --url-contains <s>      按关键词查找已打开的页面
- *   --wait <ms>             额外等待时间（默认 5000）
- *   --output <path>         结果输出文件
- *   --output-dir <dir>      截图/产物输出目录
- *
- * snapshot 参数：
- *   --selector <css>        快照根元素（默认 body）
- *   --depth <n>             DOM 深度（默认 5）
- *
- * interact 参数：
- *   --click <selector>      点击元素（支持 text=、role=、CSS）
- *   --type <text>           输入文本（配合 --click 定位输入框）
- *   --hover <selector>      悬停元素
- *   --scroll <direction>    滚动（up/down/left/right，配合 --scroll-amount）
- *
- * watch 参数：
- *   --interval <ms>         监控间隔（默认 5000）
- *   --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');
-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) {
-  let pages;
-  try {
-    pages = await Promise.race([
-      browser.pages(),
-      new Promise((_, reject) => setTimeout(() => reject(new Error('pages() timeout')), 8000)),
-    ]);
-  } catch {
-    // browser.pages() 超时，尝试用 targets() 找到目标再 .page()
-    try {
-      const targets = browser.targets();
-      let matchTarget = null;
-      if (URL_CONTAINS) {
-        matchTarget = targets.find(t => t.type() === 'page' && t.url().includes(URL_CONTAINS));
-      }
-      if (TARGET_URL && !matchTarget) {
-        matchTarget = targets.find(t => t.type() === 'page' && t.url().includes(TARGET_URL));
-      }
-      if (!matchTarget) {
-        matchTarget = targets.find(t => t.type() === 'page' && !t.url().startsWith('about:') && !t.url().startsWith('devtools:'));
-      }
-      if (matchTarget) {
-        const page = await matchTarget.page();
-        if (page) return page;
-      }
-    } catch (e) {
-      log(`[WARN] targets() 回退失败: ${e.message}`);
-    }
-    // 最终回退
-    if (TARGET_URL) {
-      const page = await browser.newPage();
-      await page.goto(TARGET_URL, { waitUntil: 'domcontentloaded', timeout: 30000 });
-      return page;
-    }
-    return await browser.newPage();
-  }
-  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) {
-  log('[INFO] 获取标签页列表...');
-  // browser.pages() 在大量标签页时可能卡住，用 CDP 直接获取
-  let pages;
-  try {
-    pages = await Promise.race([
-      browser.pages(),
-      new Promise((_, reject) => setTimeout(() => reject(new Error('pages() timeout')), 5000)),
-    ]);
-  } catch {
-    // 回退：通过 CDP Target API 获取
-    const client = await browser.target().createCDPSession();
-    const { targetInfos } = await client.send('Target.getTargets');
-    log(`[INFO] CDP 回退: 共 ${targetInfos.filter(t => t.type === 'page').length} 个标签页`);
-    for (const t of targetInfos.filter(t => t.type === 'page')) {
-      log(`  ${t.url}`);
-      if (t.title) log(`    title: ${t.title}`);
-    }
-    try { await client.detach(); } catch {}
-    return { total: targetInfos.filter(t => t.type === 'page').length };
-  }
-  log(`[INFO] 共 ${pages.length} 个标签页`);
-  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 };
-}
-
-// ===== 智能选择器解析（融合 Playwright 风格） =====
-async function smartResolve(pageOrFrame, selector) {
-  if (!selector) return null;
-  if (selector.startsWith('text=')) {
-    const text = selector.slice(5).replace(/^["']|["']$/g, '');
-    return pageOrFrame.evaluateHandle(t => {
-      const all = document.querySelectorAll('a, button, [role="button"], input, [class*="btn"], span, div, p');
-      return Array.from(all).find(el => el.textContent?.includes(t) && el.offsetHeight > 0) || null;
-    }, text);
-  }
-  if (selector.startsWith('role=')) {
-    return pageOrFrame.$(`[role="${selector.slice(5)}"]`);
-  }
-  if (selector.startsWith('~')) {
-    return pageOrFrame.$(`[class*="${selector.slice(1).replace(/^\./, '')}"]`);
-  }
-  return pageOrFrame.$(selector);
-}
-
-// ===== Action: snapshot (结构化 DOM 快照) =====
-async function snapshot(browser) {
-  const page = await findPage(browser);
-  const selector = getArg('selector', 'body');
-  const maxDepth = parseInt(getArg('depth', '5'), 10);
-  log(`[PAGE] ${page.url()}`);
-
-  const tree = await page.evaluate((rootSel, depth) => {
-    function buildTree(el, d) {
-      if (d > depth || !el) return null;
-      const tag = el.tagName?.toLowerCase();
-      if (!tag || ['script','style','svg','path'].includes(tag)) return null;
-      const attrs = {};
-      for (const a of (el.attributes || [])) {
-        if (['id','class','href','src','role','aria-label','data-testid'].includes(a.name)) {
-          attrs[a.name] = a.value.substring(0, 100);
-        }
-      }
-      // 直接文本内容
-      let text = '';
-      for (const node of el.childNodes) {
-        if (node.nodeType === 3) text += node.textContent.trim();
-      }
-      // 子元素
-      const children = [];
-      for (const child of el.children) {
-        const childTree = buildTree(child, d + 1);
-        if (childTree) children.push(childTree);
-      }
-      // 可交互性
-      const interactive = ['a','button','input','select','textarea'].includes(tag) ||
-        el.getAttribute('role') === 'button' || el.onclick || el.style.cursor === 'pointer';
-      // 可见性
-      const rect = el.getBoundingClientRect();
-      const visible = rect.width > 0 && rect.height > 0;
-      return { tag, attrs, text: text.substring(0, 80), children, interactive, visible, depth: d };
-    }
-    const root = document.querySelector(rootSel) || document.body;
-    return buildTree(root, 0);
-  }, selector, maxDepth);
-
-  // 打印树形结构
-  function printTree(node, indent = '') {
-    if (!node) return;
-    const cls = node.attrs.class ? `.${node.attrs.class.split(' ')[0].substring(0, 30)}` : '';
-    const id = node.attrs.id ? `#${node.attrs.id}` : '';
-    const role = node.attrs.role ? `[role=${node.attrs.role}]` : '';
-    const interactive = node.interactive ? ' \u{1F517}' : '';
-    const vis = node.visible ? '' : ' [hidden]';
-    const txt = node.text ? ` "${node.text.substring(0, 40)}"` : '';
-    log(`${indent}<${node.tag}${id}${cls}${role}>${txt}${interactive}${vis}`);
-    for (const child of (node.children || [])) {
-      printTree(child, indent + '  ');
-    }
-  }
-  log('\n========== DOM 快照 ==========');
-  printTree(tree);
-
-  if (OUTPUT) {
-    fs.writeFileSync(OUTPUT, JSON.stringify(tree, null, 2));
-    log(`\n[OK] 结果已保存: ${OUTPUT}`);
-  }
-  return tree;
-}
-
-// ===== Action: interact (智能交互) =====
-async function interact(browser) {
-  const page = await findPage(browser);
-  log(`[PAGE] ${page.url()}`);
-
-  const clickSel = getArg('click', null);
-  const typeText = getArg('type', null);
-  const hoverSel = getArg('hover', null);
-  const scrollDir = getArg('scroll', null);
-  const scrollAmt = parseInt(getArg('scroll-amount', '300'), 10);
-
-  if (clickSel) {
-    const el = await smartResolve(page, clickSel);
-    if (el) {
-      await el.click();
-      log(`[OK] 点击: ${clickSel}`);
-      await new Promise(r => setTimeout(r, 1000));
-    } else {
-      log(`[FAIL] 未找到元素: ${clickSel}`);
-    }
-  }
-  if (typeText) {
-    const target = clickSel ? await smartResolve(page, clickSel) : await page.$('input:focus, textarea:focus');
-    if (target) {
-      await target.type(typeText, { delay: 50 });
-      log(`[OK] 输入: "${typeText}"`);
-    } else {
-      log(`[FAIL] 未找到输入目标`);
-    }
-  }
-  if (hoverSel) {
-    const el = await smartResolve(page, hoverSel);
-    if (el) {
-      await el.hover();
-      log(`[OK] 悬停: ${hoverSel}`);
-    }
-  }
-  if (scrollDir) {
-    const dx = scrollDir === 'left' ? -scrollAmt : scrollDir === 'right' ? scrollAmt : 0;
-    const dy = scrollDir === 'up' ? -scrollAmt : scrollDir === 'down' ? scrollAmt : 0;
-    await page.evaluate(({ dx, dy }) => window.scrollBy(dx, dy), { dx, dy });
-    log(`[OK] 滚动: ${scrollDir} ${scrollAmt}px`);
-  }
-
-  // 交互后截图
-  if (hasFlag('screenshot-after')) {
-    ensureDir(OUTPUT_DIR);
-    const fp = path.join(OUTPUT_DIR, 'after-interact.png');
-    await page.screenshot({ path: fp });
-    log(`[OK] 截图: ${fp}`);
-  }
-}
-
-// ===== Action: perf (性能指标) =====
-async function perf(browser) {
-  const page = await findPage(browser);
-  log(`[PAGE] ${page.url()}`);
-
-  // 收集性能指标
-  const perfMetrics = await page.evaluate(() => {
-    const perf = performance.getEntriesByType('navigation')[0];
-    const paint = performance.getEntriesByType('paint');
-    const fcp = paint.find(p => p.name === 'first-contentful-paint');
-    // LCP 通过 PerformanceObserver 获取
-    const resources = performance.getEntriesByType('resource');
-    return {
-      // 导航时间
-      dns: perf?.domainEnd - perf?.domainStart || 0,
-      tcp: perf?.connectEnd - perf?.connectStart || 0,
-      ttfb: perf?.responseStart - perf?.requestStart || 0,
-      domReady: perf?.domContentLoadedEventEnd - perf?.startTime || 0,
-      loadComplete: perf?.loadEventEnd - perf?.startTime || 0,
-      // 绘制
-      fcp: fcp?.startTime || null,
-      // 资源统计
-      totalResources: resources.length,
-      totalTransferSize: resources.reduce((sum, r) => sum + (r.transferSize || 0), 0),
-      slowResources: resources.filter(r => r.duration > 1000).map(r => ({
-        name: r.name.split('/').pop(), duration: Math.round(r.duration), size: r.transferSize
-      })),
-    };
-  });
-
-  // Web Vitals (通过 CDP)
-  let webVitals = {};
-  try {
-    const client = await page.target().createCDPSession();
-    await client.send('Performance.enable');
-    const metrics = await client.send('Performance.getMetrics');
-    const m = {};
-    metrics.metrics.forEach(item => { m[item.name] = item.value; });
-    webVitals = {
-      layoutCount: m.LayoutCount || 0,
-      recalcCount: m.RecalcLayoutCount || 0,
-      jsHeapUsed: Math.round((m.JSHeapUsedSize || 0) / 1024 / 1024) + 'MB',
-      jsHeapTotal: Math.round((m.JSHeapTotalSize || 0) / 1024 / 1024) + 'MB',
-      taskDuration: (m.TaskDuration || 0).toFixed(2) + 's',
-    };
-    await client.send('Performance.disable');
-    client.detach();
-  } catch {}
-
-  log('\n========== 性能指标 ==========');
-  log(`DNS: ${Math.round(perfMetrics.dns)}ms`);
-  log(`TCP: ${Math.round(perfMetrics.tcp)}ms`);
-  log(`TTFB: ${Math.round(perfMetrics.ttfb)}ms`);
-  log(`DOM Ready: ${Math.round(perfMetrics.domReady)}ms`);
-  log(`Load Complete: ${Math.round(perfMetrics.loadComplete)}ms`);
-  log(`FCP: ${perfMetrics.fcp ? Math.round(perfMetrics.fcp) + 'ms' : 'N/A'}`);
-  log(`\n资源总数: ${perfMetrics.totalResources}`);
-  log(`传输总量: ${Math.round(perfMetrics.totalTransferSize / 1024)}KB`);
-  if (perfMetrics.slowResources.length > 0) {
-    log(`\n慢资源 (>1s):`);
-    perfMetrics.slowResources.forEach(r => log(`  ${r.duration}ms ${r.name} (${Math.round((r.size||0)/1024)}KB)`));
-  }
-  if (Object.keys(webVitals).length > 0) {
-    log('\n========== Chrome 内部指标 ==========');
-    Object.entries(webVitals).forEach(([k, v]) => log(`  ${k}: ${v}`));
-  }
-
-  return { perfMetrics, webVitals };
-}
-
-// ===== Action: watch (持续监控) =====
-async function watch(browser) {
-  const page = await findPage(browser);
-  const interval = parseInt(getArg('interval', '5000'), 10);
-  const maxRounds = parseInt(getArg('max-rounds', '60'), 10);
-  ensureDir(OUTPUT_DIR);
-  log(`[PAGE] ${page.url()}`);
-  log(`[WATCH] 间隔=${interval}ms, 最大轮数=${maxRounds}`);
-
-  const errors = [];
-  page.on('pageerror', err => errors.push({ time: new Date().toISOString(), error: err.message }));
-  page.on('console', msg => {
-    if (msg.type() === 'error') errors.push({ time: new Date().toISOString(), type: 'console', text: msg.text() });
-  });
-
-  for (let i = 1; i <= maxRounds; i++) {
-    const ts = new Date().toISOString().replace(/[:.]/g, '-');
-    const fp = path.join(OUTPUT_DIR, `watch-${String(i).padStart(3, '0')}-${ts}.png`);
-    await page.screenshot({ path: fp });
-    const errCount = errors.length;
-    log(`[${i}/${maxRounds}] 截图 | 累计错误: ${errCount}`);
-    if (errCount > 0 && i === 1) {
-      errors.forEach(e => log(`  [ERROR] ${e.error || e.text}`));
-    }
-    await new Promise(r => setTimeout(r, interval));
-  }
-
-  log(`\n========== 监控结束 ==========`);
-  log(`总轮数: ${maxRounds}, 累计错误: ${errors.length}`);
-  errors.forEach(e => log(`  [${e.time}] ${e.error || e.text}`));
-  return { rounds: maxRounds, errors };
-}
-
-// ===== 主入口 =====
-(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})`);
-
-  // 获取 WebSocket URL
-  let wsUrl;
-  try {
-    const versionData = await new Promise((resolve, reject) => {
-      const req = http.get(CDP_URL + '/json/version', { timeout: 3000 }, res => {
-        let d = ''; res.on('data', c => d += c); res.on('end', () => resolve(JSON.parse(d)));
-      });
-      req.on('error', reject);
-    });
-    wsUrl = versionData.webSocketDebuggerUrl;
-  } catch {}
-
-  const browser = await Promise.race([
-    puppeteer.connect({ browserWSEndpoint: wsUrl || CDP_URL, defaultViewport: null }),
-    new Promise((_, reject) => setTimeout(() => reject(new Error('CDP WebSocket 连接超时 (10s)')), 10000)),
-  ]);
-  log('[OK] 浏览器已连接');
-
-  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 'snapshot': result = await snapshot(browser); break;
-    case 'interact': result = await interact(browser); break;
-    case 'perf': result = await perf(browser); break;
-    case 'watch': result = await watch(browser); break;
-    case 'plan': result = await executePlan(browser); break;
-    default: log(`[ERROR] 未知 action: ${ACTION}`);
-  }
-
-  browser.disconnect();
-  log('\n[DONE]');
-  process.exit(0);
-})();