@epoint-testtech/ep-stage-skill 0.0.10 → 0.5.0-alpha.2

package/codex-skill/ep-stage/page-element-scan/scripts/scan-page.mjs

@@ -1,749 +0,0 @@
-#!/usr/bin/env node
-/**
- * scan-page.mjs — 用 Playwright 实时渲染页面，提取页面中的可操作元素。
- *
- * 输出 JSON（可选 Markdown）：每个元素带 type / label / locator / visible / enabled /
- * evidence（both | runtime-only | source-only）/ frame。
- *
- * 用法：
- *   node scan-page.mjs --url <页面URL> --out elements.json [--md elements.md]
- *                      [--source 源html路径] [--storage-state 登录态json]
- *                      [--login-url URL --login-user 账号 --login-pass 密码]
- *                      [--project-dir 含playwright依赖的目录] [--wait 毫秒]
- *                      [--include-hidden] [--headed]
- *
- * 该脚本是 page-element-scan 技能的验证版实现；验证通过后逻辑将迁入
- * packages/ep-stage-skill 的 CLI 子命令。
- */
-import { createRequire } from 'node:module';
-import fs from 'node:fs';
-import path from 'node:path';
-
-// 共享 DOM 扫描内核（也供 playwright-cli eval 直接注入使用）
-
-// ---------------------------------------------------------------------------
-// 参数解析
-// ---------------------------------------------------------------------------
-function parseArgs(argv) {
-  const args = { wait: 1500, includeHidden: false, headed: false, projectDir: process.cwd() };
-  for (let i = 2; i < argv.length; i += 1) {
-    const key = argv[i];
-    const next = () => argv[++i];
-    switch (key) {
-      case '--url': args.url = next(); break;
-      case '--out': args.out = next(); break;
-      case '--md': args.md = next(); break;
-      case '--source': args.source = next(); break;
-      case '--storage-state': args.storageState = next(); break;
-      case '--login-url': args.loginUrl = next(); break;
-      case '--login-user': args.loginUser = next(); break;
-      case '--login-pass': args.loginPass = next(); break;
-      case '--login-user-selector': args.loginUserSelector = next(); break;
-      case '--login-pass-selector': args.loginPassSelector = next(); break;
-      case '--login-submit-selector': args.loginSubmitSelector = next(); break;
-      case '--project-dir': args.projectDir = next(); break;
-      case '--wait': args.wait = Number(next()); break;
-      case '--include-hidden': args.includeHidden = true; break;
-      case '--headed': args.headed = true; break;
-      case '--contract-gaps': args.contractGaps = next(); break;
-      case '--contract-ref': args.contractRef = next(); break;
-      default:
-        if (key.startsWith('--')) throw new Error(`未知参数: ${key}`);
-    }
-  }
-  if (!args.url) throw new Error('缺少必填参数 --url');
-  if (!args.out) throw new Error('缺少必填参数 --out');
-  return args;
-}
-
-// ---------------------------------------------------------------------------
-// 页内提取器（在浏览器上下文执行，必须是自包含函数，不能引用外层变量）
-// ---------------------------------------------------------------------------
-function extractElementsInPage() {
-  const norm = (s) => (s || '').replace(/\s+/g, ' ').trim();
-
-  function isVisible(el) {
-    const style = window.getComputedStyle(el);
-    if (style.display === 'none' || style.visibility === 'hidden') return false;
-    const rect = el.getBoundingClientRect();
-    return rect.width > 0 && rect.height > 0;
-  }
-
-  function isEnabled(el) {
-    const cls = el.className || '';
-    return !el.disabled
-      && el.getAttribute('aria-disabled') !== 'true'
-      && !String(cls).includes('mini-disabled')
-      && !String(cls).includes('disabled');
-  }
-
-  function fieldLabel(el) {
-    // 分页控件（页码输入框、页面尺寸下拉框）：不在表单字段采集范围内
-    if (el.classList.contains('pagination-number')) return '';
-    if (el.closest('.mini-pagination, .pagination-pagerchange')) return '';
-    const wrapper = el.closest('[label]');
-    if (wrapper) return norm(wrapper.getAttribute('label'));
-    if (el.getAttribute('aria-label')) return norm(el.getAttribute('aria-label'));
-    if (el.id) {
-      const lab = document.querySelector(`label[for="${el.id}"]`);
-      if (lab) return norm(lab.innerText);
-    }
-    // 同容器内的 label 元素（epoint 查询区常见结构）
-    const containerLabel = el.closest('div, td')?.querySelector('label');
-    if (containerLabel) return norm(containerLabel.innerText).replace(/[:：]$/, '');
-    const prev = el.closest('td, div')?.previousElementSibling;
-    if (prev && /label|td/.test(prev.tagName.toLowerCase())) return norm(prev.innerText).replace(/[:：]$/, '');
-    return norm(el.placeholder || el.getAttribute('bind') || el.name || el.id || '').replace(/^[　 ]+|[　 ]+$/g, '') || '';
-  }
-
-  function controlType(el) {
-    const cls = String(el.className || '');
-    const mini = cls.match(/mini-[a-z]+/);
-    if (mini) return mini[0];
-    if (el.tagName === 'SELECT') return 'html-select';
-    if (el.tagName === 'TEXTAREA') return 'html-textarea';
-    return `html-${el.type || 'input'}`;
-  }
-
-  /**
-   * 为隐藏的 radio/checkbox input（MiniUI 框架渲染产物）生成可用的定位符。
-   * 框架结构：<div class="mini-radiobuttonlist-item" id="mini-8$0">
-   *              <input style="display:none" id="mini-8$ck$0" type="radio">
-   *              <label for="mini-8$ck$0">文本</label>
-   *            </div>
-   * 直接用 #mini-8$ck$0 会因 $ 在 CSS 选择器中是特殊字符而失败。
-   * 改用父 div 的 id 或 xpath=//div[contains(@class,'mini-radiobuttonlist-item')][normalize-space()='文本']
-   */
-  function hiddenInputLocator(el, label) {
-    const tag = el.tagName.toLowerCase();
-    // 尝试找 .mini-radiobuttonlist-item 或 .mini-checkbox 父元素
-    const itemDiv = el.closest('.mini-radiobuttonlist-item, .mini-checkbox');
-    if (itemDiv && itemDiv.id) {
-      return `#${CSS.escape(itemDiv.id)}`;
-    }
-    if (label) {
-      const type = el.type === 'radio' ? 'mini-radiobuttonlist-item' : 'mini-checkbox';
-      return `xpath=//div[contains(@class,'${type}')][normalize-space()='${label}']`;
-    }
-    return null;
-  }
-
-  function fieldLocator(el, label) {
-    const type = controlType(el);
-    const tag = el.tagName.toLowerCase();
-    if (label && type.startsWith('mini-')) {
-      // 先尝试精确匹配 div[@label]，找不到时用 contains 宽匹
-      const exact = `xpath=//div[@label='${label}']//${tag}[contains(@class,'${type}') or contains(@class,'${type}-input')]`;
-      if (document.querySelector(`div[label='${label}']`)) return exact;
-      // 宽匹：label 含动态数字（如"从第页导出到第页"）时用 contains
-      const bareLabel = label.replace(/\d+/g, '').replace(/\s+/g, ' ').trim();
-      return `xpath=//div[@label and contains(@label,'${bareLabel.replace(/[^一-龥a-zA-Z]/g, '')}')]//${tag}[contains(@class,'${type}') or contains(@class,'${type}-input')]`;
-    }
-    if (el.id) {
-      // CSS 选择器中 $ 是特殊字符，直接用会解析失败
-      if (el.id.includes('$')) {
-        const prev = hiddenInputLocator(el, label);
-        if (prev) return prev;
-      }
-      return `#${CSS.escape(el.id)}`;
-    }
-    if (el.name) return `${tag}[name="${el.name}"]`;
-    if (label) return `xpath=//div[@label='${label}']//${tag}`;
-    return tag;
-  }
-
-  function buttonLocator(el, label) {
-    const tag = el.tagName.toLowerCase();
-    const cls = String(el.className || '');
-    if (cls.includes('mini-button')) {
-      return `xpath=//${tag}[contains(@class,'mini-button')][normalize-space()='${label}']`;
-    }
-    if (cls.includes('cond-srh-btn')) {
-      return `xpath=//a[contains(@class,'cond-srh-btn')][normalize-space()='${label}']`;
-    }
-    if (el.id) return `#${el.id}`;
-    return `role=button[name="${label}"]`;
-  }
-
-  const elements = [];
-  const seen = new Set();
-  function push(el) {
-    const key = `${el.type}|${el.label}|${el.locator}`;
-    if (seen.has(key)) return;
-    seen.add(key);
-    elements.push(el);
-  }
-
-  // 按钮（含 MiniUI 按钮、epoint cond-srh-btn 查询按钮、带 tooltip 的图标按钮）
-  document.querySelectorAll(
-    'a.mini-button, button, input[type=button], input[type=submit], input[type=reset], [role=button], a.cond-srh-btn, a.mini-tools, span.mini-tools',
-  ).forEach((el) => {
-    const label = norm(el.innerText || el.value || el.getAttribute('data-tooltip') || el.title || '');
-    if (!label) return;
-    push({
-      type: 'button',
-      label,
-      locator: buttonLocator(el, label),
-      visible: isVisible(el),
-      enabled: isEnabled(el),
-    });
-  });
-
-  // 表单字段
-  document.querySelectorAll(
-    'input:not([type=button]):not([type=submit]):not([type=reset]):not([type=hidden]), textarea, select',
-  ).forEach((el) => {
-    // MiniUI 渲染后真实 input 常藏在控件内部；隐藏的占位 input 跳过（由可视输入代表）
-    if (!isVisible(el) && el.closest('.mini-textbox, .mini-combobox, .mini-datepicker, .mini-spinner')) return;
-    // MiniUI RadioButtonList/CheckBox 的隐藏 radio/checkbox input 跳过，由父 div 代表
-    if ((el.type === 'radio' || el.type === 'checkbox') && !isVisible(el)) return;
-    const label = fieldLabel(el);
-    if (!label) return; // 过滤分页跳页等无业务意义的噪音输入
-    push({
-      type: 'field',
-      label,
-      controlType: controlType(el),
-      locator: fieldLocator(el, label),
-      visible: isVisible(el),
-      enabled: isEnabled(el),
-      required: el.required || el.getAttribute('required') === 'true' || !!el.closest('.starred, [starred]'),
-    });
-  });
-
-  // MiniUI RadioButtonList / CheckBox 独立控件（父 div 可点击）
-  document.querySelectorAll('.mini-radiobuttonlist-item, .mini-checkbox').forEach((el) => {
-    const input = el.querySelector('input[type=radio], input[type=checkbox]');
-    if (!input) return;
-    // 取纯净文本：label 内嵌的 mini-export-num input 的 value 不应混入文本
-    let label = norm(input.labels?.[0]?.innerText || el.innerText || '').replace(/[:：]$/, '');
-    if (!label) return;
-    // 去掉内嵌 input 的 value 数字（如 "从第1页导出到第2页" → "从第页导出到第页"）
-    const numInput = el.querySelector('.mini-export-num');
-    if (numInput) {
-      label = label.replace(/\d+/g, '');
-    }
-    const isRadio = input.type === 'radio';
-    const type = isRadio ? 'field' : 'field';
-    const controlType2 = isRadio ? 'mini-radiobuttonlist' : 'mini-checkbox';
-    // 用父 div id（已含 $，需 CSS.escape）或文本定位
-    const itemId = el.id;
-    const locator = itemId ? `#${CSS.escape(itemId)}`
-      : `xpath=//div[contains(@class,'${isRadio ? 'mini-radiobuttonlist-item' : 'mini-checkbox'})][contains(normalize-space(),'${label}')]`;
-    push({
-      type,
-      label,
-      controlType: controlType2,
-      locator,
-      visible: isVisible(el),
-      enabled: isEnabled(el),
-    });
-  });
-
-  // 列表（MiniUI datagrid）：表头、行操作图标
-  document.querySelectorAll('.mini-datagrid').forEach((grid) => {
-    const gridId = grid.id || 'datagrid';
-    const headers = [...grid.querySelectorAll('.mini-grid-headertxt, .mini-grid-headerText, th')]
-      .map((h) => norm(h.innerText)).filter(Boolean);
-    const rowActions = [...grid.querySelectorAll('[data-tooltip]')]
-      .map((a) => norm(a.getAttribute('data-tooltip'))).filter(Boolean);
-    push({
-      type: 'grid',
-      label: gridId,
-      locator: `#${gridId}`,
-      visible: isVisible(grid),
-      enabled: true,
-      columns: headers,
-      rowActions: [...new Set(rowActions)],
-    });
-  });
-
-  // 标签页
-  document.querySelectorAll('.mini-tabs li, [role=tab]').forEach((el) => {
-    const label = norm(el.innerText);
-    if (!label) return;
-    push({
-      type: 'tab',
-      label,
-      locator: `role=tab[name="${label}"]`,
-      visible: isVisible(el),
-      enabled: isEnabled(el),
-    });
-  });
-
-  // 普通链接（排除已按按钮收录的）
-  document.querySelectorAll('a[href]:not(.mini-button)').forEach((el) => {
-    const label = norm(el.innerText);
-    if (!label || !isVisible(el)) return;
-    push({
-      type: 'link',
-      label,
-      locator: `role=link[name="${label}"]`,
-      visible: true,
-      enabled: isEnabled(el),
-      href: el.getAttribute('href'),
-    });
-  });
-
-  // MiniUI 分页控件
-  document.querySelectorAll('.mini-grid-pager').forEach((pager) => {
-    const parentGrid = pager.closest('.mini-datagrid');
-    const gridId = parentGrid?.id || 'datagrid';
-    const prefix = parentGrid ? `#${CSS.escape(gridId)}` : '';
-
-    // 总条数文本
-    const pagerInfo = pager.querySelector('.pagination-pagerinfo');
-    if (pagerInfo) {
-      push({ type: 'pagination', label: norm(pagerInfo.innerText), locator: `${prefix} .pagination-pagerinfo`, visible: true, enabled: true });
-    }
-
-    // 分页按钮
-    pager.querySelectorAll('.pagination-buttons a').forEach((btn) => {
-      const action = btn.getAttribute('action');
-      const isEllipsis = btn.classList.contains('pagination-button-ellipsis');
-      let label = norm(btn.innerText) || '';
-      let subType = '';
-      let suffix = '';
-      if (action === 'prev') { subType = 'pagination-prev'; label = '上一页'; suffix = '.pagination-buttons a[action=prev]'; }
-      else if (action === 'next') { subType = 'pagination-next'; label = '下一页'; suffix = '.pagination-buttons a[action=next]'; }
-      else if (isEllipsis || action === 'none') { subType = 'pagination-ellipsis'; label = '...'; suffix = '.pagination-button-ellipsis'; }
-      else { subType = 'pagination-page'; label = norm(btn.innerText); suffix = '.pagination-buttons a.pagination-button:not(.pagination-button-ellipsis)'; }
-      push({ type: 'pagination', subType, label, locator: `${prefix} ${suffix}`, visible: isVisible(btn), enabled: !btn.classList.contains('disabled') });
-    });
-
-    // 页面尺寸下拉
-    const pageSizeBtn = pager.querySelector('.mini-pagination > span.mini-buttonedit');
-    if (pageSizeBtn && isVisible(pageSizeBtn)) {
-      const hiddenVal = pageSizeBtn.querySelector('input[type=hidden]');
-      push({ type: 'pagination', subType: 'pagination-size', label: '页面尺寸', locator: `${prefix} .mini-pagination > span.mini-buttonedit`, value: hiddenVal?.value || '', visible: true, enabled: true });
-    }
-
-    // 页码跳转输入框
-    const jumpInput = pager.querySelector('.pagination-pagerchange input.pagination-number');
-    if (jumpInput && isVisible(jumpInput)) {
-      push({ type: 'pagination', subType: 'pagination-jump', label: '跳至页', locator: `${prefix} .pagination-pagerchange input.pagination-number`, visible: true, enabled: isEnabled(jumpInput) });
-    }
-  });
-
-  return { title: document.title, elements };
-}
-
-// 源代码侧额外提取：script 中的弹窗触发器（epoint.openTopDialog）
-function extractDialogsFromSource() {
-  const dialogs = [];
-  const scripts = [...document.querySelectorAll('script')].map((s) => s.textContent || '').join('\n');
-  const pattern = /function\s+([A-Za-z0-9_]+)\s*\([^)]*\)\s*\{[\s\S]*?openTopDialog\('([^']+)'\s*,\s*'([^']+)'/g;
-  for (const m of scripts.matchAll(pattern)) {
-    dialogs.push({ trigger: m[1], title: m[2], pagePath: m[3] });
-  }
-  return dialogs;
-}
-
-// ---------------------------------------------------------------------------
-// 合并：按 type+label 匹配，产出证据标记
-// ---------------------------------------------------------------------------
-function mergeEvidence(runtimeElements, sourceElements) {
-  const key = (e) => `${e.type}|${e.label}`;
-  const sourceMap = new Map(sourceElements.map((e) => [key(e), e]));
-  const runtimeKeys = new Set(runtimeElements.map(key));
-
-  const merged = runtimeElements.map((e) => ({
-    ...e,
-    evidence: sourceMap.has(key(e)) ? 'both' : 'runtime-only',
-  }));
-  for (const e of sourceElements) {
-    if (!runtimeKeys.has(key(e))) {
-      merged.push({ ...e, visible: false, enabled: false, evidence: 'source-only' });
-    }
-  }
-  return merged;
-}
-
-function summarize(elements) {
-  const byType = {};
-  for (const e of elements) byType[e.type] = (byType[e.type] || 0) + 1;
-  return {
-    total: elements.length,
-    byType,
-    actionable: elements.filter((e) => e.visible && e.enabled).length,
-    hiddenAtRuntime: elements.filter((e) => e.evidence === 'both' && !e.visible).length,
-    runtimeOnly: elements.filter((e) => e.evidence === 'runtime-only').length,
-    sourceOnly: elements.filter((e) => e.evidence === 'source-only').length,
-  };
-}
-
-function toMarkdown(result) {
-  const lines = [
-    `# 页面可操作元素清单：${result.title || result.url}`,
-    '',
-    `- URL: ${result.url}`,
-    `- 元素总数: ${result.summary.total}（可操作 ${result.summary.actionable}）`,
-    `- 分类: ${Object.entries(result.summary.byType).map(([t, n]) => `${t}=${n}`).join(', ')}`,
-    `- 证据: both=${result.summary.total - result.summary.runtimeOnly - result.summary.sourceOnly}, runtime-only=${result.summary.runtimeOnly}, source-only=${result.summary.sourceOnly}`,
-    '',
-    '| 类型 | 标签 | 可见 | 可用 | 证据 | 定位符 |',
-    '| --- | --- | --- | --- | --- | --- |',
-  ];
-  for (const e of result.elements) {
-    lines.push(`| ${e.type} | ${e.label} | ${e.visible ? '✓' : '✗'} | ${e.enabled ? '✓' : '✗'} | ${e.evidence || 'runtime'} | \`${e.locator}\` |`);
-  }
-  lines.push('');
-  return lines.join('\n');
-}
-
-// ---------------------------------------------------------------------------
-// 读取 contract.json5，提取所有已有槽位路径（用于去重）
-// ---------------------------------------------------------------------------
-
-/**
- * 读取 contract JSON5，返回所有已知槽位路径的 Set。
- * 覆盖：frames、locators、searchConditions、childGrids[].gridId。
- */
-function loadContractSlots(contractPath) {
-  // 直接用正则从 contract.json5 文本提取关键槽位路径，不依赖 JSON5 解析
-  const raw = fs.readFileSync(contractPath, 'utf8');
-  const known = new Set();
-  // 额外：收集所有已存在的 locator 值（用于去重 locator-candidate）
-  const knownLocators = new Set();
-
-  // frames.*
-  for (const m of raw.matchAll(/frames:\s*\{([^}]+)\}/g)) {
-    for (const key of m[1].matchAll(/(\w+):\s*"([^"]+)"/g)) known.add(`frames.${key[1]}`);
-  }
-
-  // locators.*（同时收集 locator 值）
-  // 用行级解析：逐行找 key: "value" 模式，不受跨行结构影响
-  const inLocators = { v: false };
-  for (const line of raw.split('\n')) {
-    if (/^\s*locators:\s*\{/.test(line)) { inLocators.v = true; continue; }
-    if (inLocators.v && /^\s*\}/.test(line)) { inLocators.v = false; break; }
-    if (inLocators.v) {
-      const m = line.match(/^\s+(\w+):\s*"([^"]+)"/);
-      if (m) { known.add(`locators.${m[1]}`); knownLocators.add(m[2]); }
-    }
-  }
-
-  // searchConditions[].label / field
-  for (const m of raw.matchAll(/label:\s*'([^']+)'/g)) known.add(`searchConditions.${m[1].replace(/\s+/g, '')}`);
-  for (const m of raw.matchAll(/field:\s*'([^']+)'/g)) known.add(`searchConditions.${m[1]}`);
-
-  // childGrids[].gridId
-  for (const m of raw.matchAll(/gridId:\s*'([^']+)'/g)) known.add(`childGrids.${m[1]}.gridId`);
-
-  // childGrids[].columns[].field（按行扫描，避免跨行结构）
-  let inChildGrid = false, gridId = '';
-  for (const line of raw.split('\n')) {
-    const gm = line.match(/gridId:\s*'([^']+)'/);
-    if (gm) { inChildGrid = true; gridId = gm[1]; }
-    if (inChildGrid) {
-      const cm = line.match(/field:\s*'([^']+)'/);
-      if (cm) known.add(`childGrids.${gridId}.columns.${cm[1]}`);
-    }
-    if (line.trim() === ']' && inChildGrid) inChildGrid = false;
-  }
-
-  // gapCandidates[].gapId
-  for (const m of raw.matchAll(/gapId:\s*'([^']+)'/g)) known.add(`gapCandidates.${m[1]}`);
-
-  return { known, knownLocators };
-}
-
-// ---------------------------------------------------------------------------
-// 方案 B：将运行时发现的控件转为 contract 槽位补全建议（与 contract diff）
-// ---------------------------------------------------------------------------
-
-/**
- * 从扫描结果中提炼 contract 缺失槽位，输出 candidateSlots 格式。
- *
- * 推断规则：
- * - frames.iframeSrcKeyword：非 main frame 的 url path 稳定部分
- * - locators.*：工具栏按钮（button.visible && button.enabled）且 label 唯一
- * - childGrids[].gridId：type=grid 的 label（非 main frame）
- * - childGrids[].columns：grid 的 columns 数组
- */
-function toContractGaps(result, { known = new Set(), knownLocators = new Set() } = {}) {
-  // 只取 main frame 的元素；子 frame 单独处理（避免登录帧残留污染主清单）
-  const nonMain = result.elements.filter(e => e.frame !== 'main');
-  const main    = result.elements.filter(e => e.frame === 'main');
-  const gaps    = [];
-
-  // 1. 发现新 iframe（frames 下尚无的 src 关键字）
-  const seenFrames = new Set(nonMain.map(e => e.frame).filter(Boolean));
-  for (const frame of seenFrames) {
-    const slotKey = `frames.${frame.replace('.html', '')}IframeSrcKeyword`;
-    if (known.has(slotKey)) continue;
-    gaps.push({
-      gapType:   'runtime-only-frame',
-      slotKey,
-      slotValue: frame,
-      evidence:  '运行时发现子 frame 文件名，contract 中不存在',
-      priority:  'high',
-    });
-  }
-
-  // 2. 发现新按钮（locators 中尚无的可见可用按钮）
-  const visibleBtns = main.filter(e => e.type === 'button' && e.visible && e.enabled);
-  for (const btn of visibleBtns) {
-    const skipLabels = ['搜索', '查询', '重置', '清空', '登录', '登录信息', '忘记密码'];
-    if (skipLabels.some(s => btn.label.includes(s))) continue;
-    // 如果 locator 值已存在于 contract 任何槽位，不算新 gap
-    if (knownLocators.has(btn.locator)) continue;
-    const slotKey = `locators.${btn.label.replace(/\s+/g, '')}`;
-    if (known.has(slotKey)) continue;
-    gaps.push({
-      gapType:   'locator-candidate',
-      slotKey,
-      slotValue: btn.locator,
-      evidence:  '运行时渲染后可见可用，定位符已验证',
-      priority:  'medium',
-    });
-  }
-
-  // 3. 发现子表（type=grid 且非 main frame）
-  const grids = nonMain.filter(e => e.type === 'grid' && e.visible);
-  for (const g of grids) {
-    const gridIdKey = `childGrids.${g.label}.gridId`;
-    if (!known.has(gridIdKey)) {
-      gaps.push({
-        gapType:   'child-grid',
-        slotKey:   gridIdKey,
-        slotValue: g.label,
-        evidence:  `子表 grid id=${g.label}，列：${(g.columns || []).join(', ')}`,
-        priority:  'high',
-      });
-    }
-    if (g.columns?.length) {
-      const colsKey = `childGrids.${g.label}.columns`;
-      if (!known.has(colsKey)) {
-        gaps.push({
-          gapType:   'child-grid-columns',
-          slotKey:   colsKey,
-          slotValue: g.columns,
-          evidence:  '运行时渲染 DOM 提取，精确到字段级',
-          priority:  'medium',
-        });
-      }
-    }
-  }
-
-  // 4. 发现新的可见查询字段（main frame 的 field，不含登录残留）
-  const visibleFields = main.filter(e => e.type === 'field' && e.visible && e.enabled);
-  for (const f of visibleFields) {
-    const skipPatterns = [/^仅导出/, /^导出/, /^从第页/, /^请/, /密码/, /用户名/, /账号/];
-    if (skipPatterns.some(p => p.test(f.label))) continue;
-    const slotKey = `searchConditions.${f.label.replace(/\s+/g, '')}`;
-    if (known.has(slotKey)) continue;
-    gaps.push({
-      gapType:   'field-candidate',
-      slotKey,
-      slotValue: { label: f.label, component: f.controlType || 'input', locator: f.locator },
-      evidence:  '运行时渲染后可见，定位符已验证',
-      priority:  'low',
-    });
-  }
-
-  return {
-    url:        result.url,
-    scannedAt:  result.scannedAt,
-    totalGaps:  gaps.length,
-    gaps,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// 主流程
-// ---------------------------------------------------------------------------
-async function main() {
-  const args = parseArgs(process.argv);
-  const require = createRequire(path.join(args.projectDir, 'noop.js'));
-  let chromium;
-  for (const pkg of ['playwright', '@playwright/test', 'playwright-core']) {
-    try { ({ chromium } = require(pkg)); break; } catch { /* 尝试下一个 */ }
-  }
-  if (!chromium) throw new Error(`在 ${args.projectDir} 下找不到 playwright，请检查 --project-dir`);
-
-  const browser = await chromium.launch({ headless: !args.headed });
-  const context = await browser.newContext(
-    args.storageState ? { storageState: args.storageState } : {},
-  );
-  const page = await context.newPage();
-
-  try {
-    // 登录（先点提交，等 URL 离开登录页即表示登录完成）
-    if (args.loginUser) {
-      await page.goto(args.loginUrl || args.url, { waitUntil: 'domcontentloaded' });
-      const userSel = args.loginUserSelector || 'input[type=text]:visible, input:not([type]):visible';
-      const passSel = args.loginPassSelector || 'input[type=password]:visible';
-      const submitSel = args.loginSubmitSelector
-        || 'input[type=submit], button[type=submit], a:has-text("登录"), button:has-text("登录")';
-      await page.locator(userSel).first().fill(args.loginUser);
-      await page.locator(passSel).first().fill(args.loginPass || '');
-      await page.locator(submitSel).first().click();
-      // 等待 URL 离开登录页（登录完成后的第一个目标系统页面）
-      await page.waitForFunction(
-        () => !window.location.href.includes('/login/') && !window.location.href.includes('/login.html'),
-        { timeout: 30000 },
-      );
-      await page.waitForTimeout(1500); // 等目标页面框架渲染完成
-    }
-
-    await page.goto(args.url, { waitUntil: 'domcontentloaded' });
-    await page.waitForLoadState('networkidle', { timeout: 30000 }).catch(() => {});
-    await page.waitForTimeout(args.wait); // 等 MiniUI 等框架渲染
-
-    // 运行时提取：主 frame + 所有子 frame
-    const runtime = [];
-    let title = '';
-    for (const frame of page.frames()) {
-      try {
-        const r = await frame.evaluate(extractElementsInPage);
-        if (frame === page.mainFrame()) title = r.title;
-        const frameTag = frame === page.mainFrame()
-          ? 'main'
-          : new URL(frame.url()).pathname.split('/').pop() || 'sub';
-        for (const e of r.elements) runtime.push({ ...e, frame: frameTag });
-      } catch { /* 跨域 frame 跳过 */ }
-    }
-
-    // 源代码提取（可选）：用 DOMParser 解析原始 HTML（不执行脚本），
-    // 得到纯标记态元素；运行时渲染后得到运行时态元素。
-    // 两者按 type+label 比对，标注 evidence：both / runtime-only / source-only。
-    let sourceElements = [];
-    let dialogs = [];
-    if (args.source) {
-      const html = fs.readFileSync(args.source, 'utf8');
-
-      // 用 DOMParser 解析（不执行脚本，得到纯声明式 DOM）
-      const sr = await page.evaluate((srcHtml) => {
-        const parser = new DOMParser();
-        const doc = parser.parseFromString(srcHtml, 'text/html');
-        const scripts = [...doc.querySelectorAll('script')].map((s) => s.textContent || '').join('\n');
-        // 复用提取逻辑中的选择器+可见性判断（直接用 doc 查询，不用 page context）
-        function queryAll(sel) { return [...doc.querySelectorAll(sel)]; }
-        const norm = (s) => (s || '').replace(/\s+/g, ' ').trim();
-        function fieldLabel(el) {
-          // 分页控件（页码输入框、页面尺寸下拉框）：不在表单字段采集范围内
-          if (el.classList.contains('pagination-number')) return '';
-          if (el.closest('.mini-pagination, .pagination-pagerchange')) return '';
-          const wrapper = el.closest('[label]');
-          if (wrapper) return norm(wrapper.getAttribute('label'));
-          if (el.getAttribute('aria-label')) return norm(el.getAttribute('aria-label'));
-          const containerLabel = el.closest('div, td')?.querySelector('label');
-          if (containerLabel) return norm(containerLabel.innerText).replace(/[:：]$/, '');
-          return norm(el.placeholder || el.getAttribute('bind') || el.name || el.id || '').replace(/^[　 ]+|[　 ]+$/g, '') || '';
-        }
-        function controlType(el) {
-          const cls = String(el.className || '');
-          const mini = cls.match(/mini-[a-z]+/);
-          if (mini) return mini[0];
-          if (el.tagName === 'SELECT') return 'html-select';
-          if (el.tagName === 'TEXTAREA') return 'html-textarea';
-          return `html-${el.type || 'input'}`;
-        }
-        function fieldLocator(el, label) {
-          const type = controlType(el);
-          const tag = el.tagName.toLowerCase();
-          if (label && type.startsWith('mini-')) {
-            return `xpath=//div[@label='${label}']//${tag}[contains(@class,'${type}') or contains(@class,'${type}-input')]`;
-          }
-          if (el.id) {
-            if (el.id.includes('$')) return null; // 源码侧这类 id 不会存在，跳过
-            return `#${el.id}`;
-          }
-          if (el.name) return `${tag}[name="${el.name}"]`;
-          if (label) return `xpath=//div[@label='${label}']//${tag}`;
-          return tag;
-        }
-        function buttonLocator(el, label) {
-          const tag = el.tagName.toLowerCase();
-          const cls = String(el.className || '');
-          if (cls.includes('mini-button')) return `xpath=//${tag}[contains(@class,'mini-button')][normalize-space()='${label}']`;
-          if (cls.includes('cond-srh-btn')) return `xpath=//a[contains(@class,'cond-srh-btn')][normalize-space()='${label}']`;
-          if (el.id) return `#${el.id}`;
-          return `role=button[name="${label}"]`;
-        }
-        const seen = new Set();
-        function push(els, el) {
-          const key = `${el.type}|${el.label}|${el.locator}`;
-          if (seen.has(key)) return;
-          seen.add(key); els.push(el);
-        }
-        const elements = [];
-        // 按钮
-        doc.querySelectorAll('a.mini-button, button, input[type=button], input[type=submit], input[type=reset], [role=button], a.cond-srh-btn, a.mini-tools, span.mini-tools')
-          .forEach((el) => {
-            const label = norm(el.innerText || el.value || el.getAttribute('data-tooltip') || el.title || '');
-            if (!label) return;
-            push(elements, { type: 'button', label, locator: buttonLocator(el, label), visible: true, enabled: true });
-          });
-        // 字段
-        doc.querySelectorAll('input:not([type=button]):not([type=submit]):not([type=reset]):not([type=hidden]), textarea, select')
-          .forEach((el) => {
-            // MiniUI RadioButtonList/CheckBox 的隐藏 radio/checkbox input 跳过，由父 div 代表
-            if ((el.type === 'radio' || el.type === 'checkbox')) return;
-            const label = fieldLabel(el);
-            push(elements, { type: 'field', label, controlType: controlType(el), locator: fieldLocator(el, label), visible: true, enabled: true, required: false });
-          });
-        // grid
-        doc.querySelectorAll('.mini-datagrid').forEach((grid) => {
-          const gridId = grid.id || 'datagrid';
-          const headers = [...grid.querySelectorAll('.mini-grid-headertxt, .mini-grid-headerText, th')].map((h) => norm(h.innerText)).filter(Boolean);
-          const rowActions = [...grid.querySelectorAll('[data-tooltip]')].map((a) => norm(a.getAttribute('data-tooltip'))).filter(Boolean);
-          elements.push({ type: 'grid', label: gridId, locator: `#${gridId}`, visible: true, enabled: true, columns: headers, rowActions: [...new Set(rowActions)] });
-        });
-        // tabs
-        doc.querySelectorAll('.mini-tabs li, [role=tab]').forEach((el) => {
-          const label = norm(el.innerText);
-          if (!label) return;
-          push(elements, { type: 'tab', label, locator: `role=tab[name="${label}"]`, visible: true, enabled: true });
-        });
-        // 弹窗
-        const pattern = /function\s+([A-Za-z0-9_]+)\s*\([^)]*\)\s*\{[\s\S]*?openTopDialog\('([^']+)'\s*,\s*'([^']+)'/g;
-        const dialogs2 = [];
-        for (const m of scripts.matchAll(pattern)) dialogs2.push({ trigger: m[1], title: m[2], pagePath: m[3] });
-        return { elements, dialogs: dialogs2 };
-      }, html);
-      sourceElements = sr.elements;
-      dialogs = sr.dialogs;
-    }
-
-    const elements = args.source
-      ? mergeEvidence(runtime, sourceElements)
-      : runtime.map((e) => ({ ...e, evidence: 'runtime' }));
-    const filtered = args.includeHidden
-      ? elements
-      : elements.filter((e) => e.visible || e.evidence === 'source-only' || e.evidence === 'both');
-
-    const result = {
-      url: args.url,
-      title,
-      scannedAt: new Date().toISOString(),
-      summary: summarize(filtered),
-      dialogs,
-      elements: filtered,
-    };
-
-    fs.mkdirSync(path.dirname(path.resolve(args.out)), { recursive: true });
-    fs.writeFileSync(args.out, JSON.stringify(result, null, 2), 'utf8');
-    if (args.md) fs.writeFileSync(args.md, toMarkdown(result), 'utf8');
-
-    // 方案 B：输出 contract 槽位补全建议
-    if (args.contractGaps) {
-      const knownSlots = args.contractRef ? loadContractSlots(args.contractRef) : { known: new Set(), knownLocators: new Set() };
-      const gapsResult = toContractGaps(result, knownSlots);
-      fs.writeFileSync(args.contractGaps, JSON.stringify(gapsResult, null, 2), 'utf8');
-      const kept = args.contractRef ? `（已比对 ${knownSlots.known.size} 个已知槽位）` : '（无 contract-ref，仅做启发式过滤）';
-      console.log(`方案B输出: ${args.contractGaps}（${gapsResult.totalGaps} 条待补槽位）${kept}`);
-    }
-
-    console.log(`扫描完成: ${result.summary.total} 个元素（可操作 ${result.summary.actionable}）`);
-    console.log(`分类: ${JSON.stringify(result.summary.byType)}`);
-    console.log(`输出: ${args.out}${args.md ? `, ${args.md}` : ''}`);
-  } finally {
-    await browser.close();
-  }
-}
-
-main().catch((err) => {
-  console.error(`扫描失败: ${err.message}`);
-  process.exit(1);
-});