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

package/opencode-extension/skills/local-browser-test/lib/browser-engine.js

@@ -685,7 +685,18 @@ export class BrowserEngine {
 
         const ensureDrawerOpen = async () => {
             if (!drawerTriggerSelector) return { ensured: false, reason: "no drawer" };
-            const isOpen = await frame.evaluate((sel) => !!document.querySelector(sel), drawerOpenSelector).catch(() => false);
+            // 用可见性判断抽屉是否打开，而非单纯检查元素是否存在。
+            // 很多自定义抽屉（如 .page-left-menu）常驻 DOM，靠 CSS（width:0 / transform / display）
+            // 控制开关，querySelector 永远命中会误判 already open。
+            const isVisible = (sel) => {
+                const el = document.querySelector(sel);
+                if (!el) return false;
+                if (el.offsetParent === null && getComputedStyle(el).position !== "fixed") return false;
+                const rect = el.getBoundingClientRect();
+                const style = getComputedStyle(el);
+                return rect.width > 1 && rect.height > 1 && style.display !== "none" && style.visibility !== "hidden" && style.opacity !== "0";
+            };
+            const isOpen = await frame.evaluate(isVisible, drawerOpenSelector).catch(() => false);
             if (isOpen) return { ensured: true, reason: "already open" };
             const triggered = await frame.evaluate((sel) => {
                 const el = document.querySelector(sel);
@@ -696,7 +707,9 @@ export class BrowserEngine {
             }, drawerTriggerSelector).catch(() => false);
             if (!triggered) return { ensured: false, reason: "trigger not found" };
             await new Promise((r) => setTimeout(r, waitAfterEach));
-            return { ensured: true, reason: "clicked trigger" };
+            // 点击后再次用可见性确认抽屉真的打开了
+            const openedAfter = await frame.evaluate(isVisible, drawerOpenSelector).catch(() => false);
+            return { ensured: openedAfter, reason: openedAfter ? "clicked trigger" : "clicked but not visible" };
         };
 
         const scrollContainerOnce = async () => {
@@ -723,7 +736,7 @@ export class BrowserEngine {
                     return rect.width > 0 && rect.height > 0 && style.display !== "none" && style.visibility !== "hidden";
                 }
                 function menuCandidates() {
-                    return Array.from(document.querySelectorAll([
+                    const tagged = Array.from(document.querySelectorAll([
                         "[role='menuitem']",
                         ".ant-menu-item",
                         ".ant-menu-submenu-title",
@@ -732,7 +745,18 @@ export class BrowserEngine {
                         "button",
                         "[class*='menu-item']",
                         "[class*='submenu']",
-                    ].join(","))).filter(isVisible);
+                    ].join(",")));
+                    // 补充可见的叶子文本节点（裸 span/div，无 menu 类名）。
+                    // 某些自定义抽屉/导航把菜单项渲染成无类名的 <span>，上面的选择器命不中，
+                    // 导致只能退而命中带 .menu-item 类的父容器（文字是整块菜单），点错元素。
+                    const leaves = Array.from(document.querySelectorAll("span, div, li"))
+                        .filter((el) => {
+                            if (el.childElementCount > 0) return false;
+                            const t = (el.innerText || el.textContent || "").trim();
+                            return t.length > 0 && t.length <= 20;
+                        });
+                    const merged = new Set([...tagged, ...leaves]);
+                    return Array.from(merged).filter(isVisible);
                 }
                 function score(el) {
                     const actual = textOf(el);
@@ -748,6 +772,14 @@ export class BrowserEngine {
                     if (cls.includes("ant-menu-submenu-title")) s += lvl < totalLevels - 1 ? 20 : -5;
                     if (cls.includes("ant-menu-item")) s += lvl === totalLevels - 1 ? 20 : 0;
                     if (cls.includes("ant-menu-item-selected")) s += 5;
+                    // 文本越接近目标越优先：惩罚包含大量额外文字的父容器，避免命中整块菜单包裹元素。
+                    // 例如目标"数据探索"，父容器文字"语料资产中心 数据集目录 工程概览 数据探索 数据智搜"
+                    // 多出的字符越多，扣分越多，让最贴近目标的叶子节点胜出。
+                    const extraLen = actual.length - expectedText.length;
+                    if (extraLen > 0) s -= Math.min(extraLen * 2, 60);
+                    // 叶子节点（无子元素或仅含文本/图标）加分，优先于包裹容器
+                    const childElementCount = el.childElementCount || 0;
+                    if (childElementCount <= 1) s += 15;
                     return s;
                 }
                 const ranked = menuCandidates()
@@ -786,13 +818,49 @@ export class BrowserEngine {
         };
 
         const clickStep = async (isLast) => {
-            return frame.evaluate(async (waitMs, last) => {
+            // 记录点击前状态 + 滚动目标到可见区
+            const beforeState = await frame.evaluate(() => {
                 const el = document.querySelector("[data-szcd-menu-target='1']");
-                if (!el) return { performed: false, error: "marker lost" };
+                if (!el) return { ok: false };
                 el.scrollIntoView({ block: "center", inline: "center" });
-                const beforeUrl = location.href;
-                const beforeText = document.body?.innerText || "";
-                el.click();
+                return { ok: true, beforeUrl: location.href, beforeText: (document.body?.innerText || "").length };
+            });
+            if (!beforeState.ok) return { performed: false, error: "marker lost" };
+
+            // 优先用 puppeteer 原生鼠标点击（发出真实 mousedown/mouseup/click 序列）。
+            // 纯 el.click() 对 React 事件委托型菜单（如 .page-left-menu 抽屉里的无类名菜单项）无效，
+            // 不会触发路由切换；原生鼠标事件才能驱动 React 合成事件。
+            let nativeClicked = false;
+            try {
+                const handle = await frame.$("[data-szcd-menu-target='1']");
+                if (handle) {
+                    const box = await handle.boundingBox();
+                    if (box && box.width > 0 && box.height > 0) {
+                        const cx = box.x + box.width / 2;
+                        const cy = box.y + box.height / 2;
+                        await this.page.mouse.move(cx, cy);
+                        await new Promise((r) => setTimeout(r, 120));
+                        await this.page.mouse.click(cx, cy);
+                        nativeClicked = true;
+                    }
+                    await handle.dispose().catch(() => {});
+                }
+            } catch {
+                // 原生点击失败（跨 frame 坐标 / target detached），回退到 DOM click
+            }
+
+            // 回退：DOM el.click()
+            const result = await frame.evaluate(async (waitMs, last, didNative, beforeUrl, beforeTextLen) => {
+                const el = document.querySelector("[data-szcd-menu-target='1']");
+                if (!el) {
+                    // 原生点击后元素可能已被卸载（路由切换），视为成功
+                    return {
+                        performed: true,
+                        action: last ? "click" : "expand",
+                        after: { urlChanged: location.href !== beforeUrl, textChanged: (document.body?.innerText || "").length !== beforeTextLen, markerGone: true },
+                    };
+                }
+                if (!didNative) el.click();
                 el.removeAttribute("data-szcd-menu-target");
                 await new Promise((r) => setTimeout(r, waitMs));
                 const cls = typeof el.className === "string" ? el.className : "";
@@ -803,11 +871,13 @@ export class BrowserEngine {
                         className: cls,
                         ariaExpanded: el.getAttribute("aria-expanded"),
                         urlChanged: location.href !== beforeUrl,
-                        textChanged: (document.body?.innerText || "") !== beforeText,
+                        textChanged: (document.body?.innerText || "").length !== beforeTextLen,
                         selected: cls.includes("selected") || cls.includes("active"),
+                        nativeClicked: didNative,
                     },
                 };
-            }, waitAfterEach, isLast);
+            }, waitAfterEach, isLast, nativeClicked, beforeState.beforeUrl, beforeState.beforeText);
+            return result;
         };
 
         const steps = [];
@@ -2429,6 +2499,518 @@ export class BrowserEngine {
                 }
                 return { acted: true, passed: true, action: action, status: 'PASS' };
             },
+            // 抽屉式导航菜单完整链路：开抽屉 → 定位菜单项 → 原生点击 → 验证路由切换。
+            // 适用于"点左上角汉堡按钮弹出抽屉，再点菜单项导航"的模式（如语料平台 .operate + .page-left-menu）。
+            // 解决三个坑：(1) 抽屉常驻 DOM 靠 CSS 隐藏，需按可见性判断开关；
+            // (2) 菜单项常是无类名裸 span，需叶子文本精确匹配；
+            // (3) React 事件委托菜单必须用原生鼠标事件（mouse.click），el.click() 不触发路由。
+            'drawer-menu-nav': async (page, frame, params) => {
+                const triggerSelector = params.triggerSelector || params.drawerTriggerSelector || '.operate';
+                const openSelector = params.openSelector || params.drawerOpenSelector || '.page-left-menu';
+                const menuText = params.menuText || params.text;
+                const waitAfter = params.waitAfter || 1500;
+                if (!menuText) return { acted: false, passed: false, reason: 'missing menuText param', status: 'FAIL' };
+
+                // 可见性判断：元素存在且有尺寸、未被 CSS 隐藏
+                const isVisible = (sel) => {
+                    const el = document.querySelector(sel);
+                    if (!el) return false;
+                    if (el.offsetParent === null && getComputedStyle(el).position !== 'fixed') return false;
+                    const r = el.getBoundingClientRect();
+                    const s = getComputedStyle(el);
+                    return r.width > 1 && r.height > 1 && s.display !== 'none' && s.visibility !== 'hidden' && s.opacity !== '0';
+                };
+
+                // 1. 确保抽屉打开（用可见性判断，而非单纯存在性）
+                let drawerOpen = await frame.evaluate(isVisible, openSelector).catch(() => false);
+                if (!drawerOpen) {
+                    await frame.evaluate((sel) => { const el = document.querySelector(sel); if (el) { el.scrollIntoView({ block: 'center' }); el.click(); } }, triggerSelector).catch(() => {});
+                    await new Promise((r) => setTimeout(r, 600));
+                    drawerOpen = await frame.evaluate(isVisible, openSelector).catch(() => false);
+                }
+                if (!drawerOpen) return { acted: false, passed: false, reason: 'drawer did not open via ' + triggerSelector, status: 'FAIL' };
+
+                // 2. 定位菜单项叶子节点并打标记（精确文本匹配，优先无子元素的叶子）
+                const located = await frame.evaluate((scope, txt) => {
+                    const root = document.querySelector(scope) || document;
+                    const all = Array.from(root.querySelectorAll('*')).filter((e) => {
+                        if (e.childElementCount > 0) return false;
+                        const t = (e.innerText || e.textContent || '').trim();
+                        if (t !== txt) return false;
+                        const r = e.getBoundingClientRect();
+                        return r.width > 0 && r.height > 0;
+                    });
+                    if (all.length === 0) return { found: false };
+                    // 点击目标优先取带语义类名的可点击祖先（如 .item），否则用叶子本身
+                    let target = all[0];
+                    let cur = target;
+                    for (let i = 0; i < 5 && cur; i++) {
+                        if (cur.className && typeof cur.className === 'string' && /item|menu/i.test(cur.className)) { target = cur; break; }
+                        cur = cur.parentElement;
+                    }
+                    target.setAttribute('data-szcd-drawernav', '1');
+                    return { found: true };
+                }, openSelector, menuText).catch(() => ({ found: false }));
+                if (!located.found) return { acted: false, passed: false, reason: 'menu item "' + menuText + '" not found in drawer', status: 'FAIL' };
+
+                // 3. 原生鼠标点击（真实 mousedown/mouseup/click，驱动 React 路由）
+                const beforeUrl = page.url();
+                const handle = await frame.$('[data-szcd-drawernav="1"]');
+                if (!handle) return { acted: false, passed: false, reason: 'marker lost', status: 'FAIL' };
+                const box = await handle.boundingBox();
+                if (box && box.width > 0 && box.height > 0) {
+                    await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2);
+                    await new Promise((r) => setTimeout(r, 120));
+                    await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2);
+                } else {
+                    await frame.evaluate(() => { const el = document.querySelector('[data-szcd-drawernav="1"]'); el && el.click(); }).catch(() => {});
+                }
+                await handle.dispose().catch(() => {});
+                await new Promise((r) => setTimeout(r, waitAfter));
+
+                // 4. 验证路由是否切换
+                const afterUrl = page.url();
+                const routeChanged = afterUrl !== beforeUrl;
+                await frame.evaluate(() => { const el = document.querySelector('[data-szcd-drawernav="1"]'); el && el.removeAttribute('data-szcd-drawernav'); }).catch(() => {});
+                return {
+                    acted: true,
+                    passed: routeChanged,
+                    status: routeChanged ? 'PASS' : 'FAIL',
+                    menuText: menuText,
+                    routeChanged: routeChanged,
+                    beforeUrl: beforeUrl,
+                    afterUrl: afterUrl,
+                    reason: routeChanged ? undefined : 'clicked but route did not change (可能是 hash 路由检测时机或该项无导航)',
+                };
+            },
+            // 导航拓扑探测：报告当前导航控件结构，供 LLM 编排"切模块 → 读 sidebar → 逐项探索"的完整遍历。
+            // ⚠️ 抽屉是模块切换器/快捷入口，抽屉里的项不代表模块完整菜单；
+            //    每个模块的权威完整菜单是"切进该模块后的左侧 sidebar"。
+            'detect-menu': async (page, frame, params) => {
+                const triggerHints = params.triggerHints || ['.operate', '[class*=menu-toggle]', '[class*=menu-fold]', '[class*=hamburger]', '.anticon-menu', '.anticon-menu-fold', '.anticon-menu-unfold'];
+                const drawerHints = params.drawerHints || ['.page-left-menu', '.ant-drawer', '[class*=drawer]', '[class*=side-menu]', '[class*=nav-panel]'];
+                const detected = await frame.evaluate((triggers, drawers) => {
+                    const isVisible = (el) => {
+                        if (!el) return false;
+                        if (el.offsetParent === null && getComputedStyle(el).position !== 'fixed') return false;
+                        const r = el.getBoundingClientRect();
+                        const s = getComputedStyle(el);
+                        return r.width > 1 && r.height > 1 && s.display !== 'none' && s.visibility !== 'hidden' && s.opacity !== '0';
+                    };
+                    // 1. 当前模块的左侧 sidebar（权威完整菜单）
+                    const sidebarEls = Array.from(document.querySelectorAll('.ant-menu-item, .ant-menu-submenu-title')).filter(isVisible);
+                    const currentSidebar = sidebarEls.map((e) => (e.innerText || e.textContent || '').trim()).filter(Boolean);
+                    const hasSidebar = currentSidebar.length > 0;
+
+                    // 2. 抽屉触发器
+                    let triggerSelector = null;
+                    for (const sel of triggers) { const el = document.querySelector(sel); if (el && isVisible(el)) { triggerSelector = sel; break; } }
+                    // 3. 抽屉容器（存在即可，可能 CSS 隐藏）
+                    let drawerSelector = null, drawerCurrentlyOpen = false;
+                    for (const sel of drawers) { const el = document.querySelector(sel); if (el) { drawerSelector = sel; drawerCurrentlyOpen = isVisible(el); break; } }
+
+                    // 4. 抽屉里的模块入口名（仅作"切模块"用，非完整菜单）。
+                    //    抽屉常驻 DOM，即使当前关闭也能读到模块名。
+                    let drawerModules = [];
+                    if (drawerSelector) {
+                        const drawer = document.querySelector(drawerSelector);
+                        const mods = Array.from(drawer.querySelectorAll('.menu-item, [class*=menu-item]'));
+                        drawerModules = mods.map((m) => {
+                            const titleEl = m.querySelector('.title, [class*=title], h3, h4, strong');
+                            const active = /active|selected|current/i.test(m.className);
+                            // 模块下快捷项（仅供参考，非权威）
+                            const shortcuts = Array.from(m.querySelectorAll('span, .item')).map((e) => (e.innerText || e.textContent || '').trim()).filter((t) => t && t.length <= 16);
+                            return { moduleTitle: titleEl ? titleEl.textContent.trim() : (m.textContent || '').trim().slice(0, 20), active, shortcutSample: Array.from(new Set(shortcuts)).slice(0, 8) };
+                        }).filter((m) => m.moduleTitle);
+                    }
+                    return { hasSidebar, currentSidebar, triggerSelector, drawerSelector, drawerCurrentlyOpen, drawerModules };
+                }, triggerHints, drawerHints).catch(() => null);
+
+                if (!detected) return { acted: true, passed: false, reason: 'detect failed', status: 'FAIL' };
+
+                const hasDrawer = !!(detected.triggerSelector && detected.drawerSelector);
+                return {
+                    acted: true,
+                    passed: true,
+                    status: 'PASS',
+                    hasDrawer,
+                    hasSidebar: detected.hasSidebar,
+                    triggerSelector: detected.triggerSelector,
+                    drawerSelector: detected.drawerSelector,
+                    drawerCurrentlyOpen: detected.drawerCurrentlyOpen,
+                    currentSidebar: detected.currentSidebar,        // 当前模块完整菜单（权威）
+                    drawerModules: detected.drawerModules,          // 可切换的模块入口（非完整菜单）
+                    navModel: hasDrawer
+                        ? '抽屉=模块切换器；遍历全部菜单需逐个 switch-module 切模块后读 currentSidebar，再 act --menu-path 点二级项。抽屉里的 shortcutSample 仅供参考，不代表模块完整菜单。'
+                        : '仅 sidebar，直接 act --menu-path 遍历 currentSidebar。',
+                    recommend: hasDrawer
+                        ? { method: 'cdpScript switch-module（切模块）+ act --menu-path（点二级）', example: { type: 'cdpScript', script: 'switch-module', params: { moduleText: '<模块名或其下快捷项>', triggerSelector: detected.triggerSelector, drawerSelector: detected.drawerSelector } } }
+                        : { method: 'act --menu-path', example: { action: 'act', menuPath: '<一级/二级>' } },
+                };
+            },
+            // 切模块：开抽屉 → 点目标模块（或其下快捷项）→ 等左侧 sidebar 刷新 → 返回新 sidebar 项。
+            // 用于完整遍历：切到某模块后，用返回的 newSidebar 在该模块内 act --menu-path 逐项探索。
+            'switch-module': async (page, frame, params) => {
+                const triggerSelector = params.triggerSelector || '.operate';
+                const drawerSelector = params.drawerSelector || '.page-left-menu';
+                const moduleText = params.moduleText || params.text;
+                const waitAfter = params.waitAfter || 1800;
+                if (!moduleText) return { acted: false, passed: false, reason: 'missing moduleText param', status: 'FAIL' };
+
+                const isVisibleSel = (sel) => {
+                    const el = document.querySelector(sel);
+                    if (!el) return false;
+                    if (el.offsetParent === null && getComputedStyle(el).position !== 'fixed') return false;
+                    const r = el.getBoundingClientRect();
+                    const s = getComputedStyle(el);
+                    return r.width > 1 && r.height > 1 && s.display !== 'none' && s.visibility !== 'hidden' && s.opacity !== '0';
+                };
+                const readSidebar = () => frame.evaluate(() => Array.from(document.querySelectorAll('.ant-menu-item, .ant-menu-submenu-title')).filter((e) => e.offsetParent !== null).map((e) => (e.innerText || e.textContent || '').trim()).filter(Boolean));
+
+                const beforeSidebar = await readSidebar();
+                const beforeUrl = page.url();
+
+                // 1. 确保抽屉打开（可见性判断）
+                let open = await frame.evaluate(isVisibleSel, drawerSelector).catch(() => false);
+                if (!open) {
+                    await frame.evaluate((sel) => { const el = document.querySelector(sel); if (el) { el.scrollIntoView({ block: 'center' }); el.click(); } }, triggerSelector).catch(() => {});
+                    await new Promise((r) => setTimeout(r, 600));
+                    open = await frame.evaluate(isVisibleSel, drawerSelector).catch(() => false);
+                }
+                if (!open) return { acted: false, passed: false, reason: 'drawer did not open via ' + triggerSelector, status: 'FAIL' };
+
+                // 2. 在抽屉内按文本定位目标（模块标题或其下快捷项叶子），标记可点击祖先
+                const located = await frame.evaluate((scope, txt) => {
+                    const root = document.querySelector(scope) || document;
+                    const leaves = Array.from(root.querySelectorAll('*')).filter((e) => {
+                        if (e.childElementCount > 0) return false;
+                        const t = (e.innerText || e.textContent || '').trim();
+                        return t === txt && e.getBoundingClientRect().width > 0;
+                    });
+                    if (leaves.length === 0) return { found: false };
+                    let target = leaves[0], cur = target;
+                    for (let i = 0; i < 5 && cur; i++) { if (cur.className && typeof cur.className === 'string' && /item|menu/i.test(cur.className)) { target = cur; break; } cur = cur.parentElement; }
+                    target.setAttribute('data-szcd-switchmod', '1');
+                    return { found: true };
+                }, drawerSelector, moduleText).catch(() => ({ found: false }));
+                if (!located.found) return { acted: false, passed: false, reason: 'module/shortcut "' + moduleText + '" not found in drawer', status: 'FAIL' };
+
+                // 3. 原生鼠标点击
+                const handle = await frame.$('[data-szcd-switchmod="1"]');
+                if (!handle) return { acted: false, passed: false, reason: 'marker lost', status: 'FAIL' };
+                const box = await handle.boundingBox();
+                if (box && box.width > 0 && box.height > 0) {
+                    await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2);
+                    await new Promise((r) => setTimeout(r, 120));
+                    await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2);
+                } else {
+                    await frame.evaluate(() => { const el = document.querySelector('[data-szcd-switchmod="1"]'); el && el.click(); }).catch(() => {});
+                }
+                await handle.dispose().catch(() => {});
+                await new Promise((r) => setTimeout(r, waitAfter));
+                await frame.evaluate(() => { const el = document.querySelector('[data-szcd-switchmod="1"]'); el && el.removeAttribute('data-szcd-switchmod'); }).catch(() => {});
+
+                // 4. 读取刷新后的 sidebar（该模块完整菜单）
+                const afterSidebar = await readSidebar();
+                const afterUrl = page.url();
+                const sidebarChanged = JSON.stringify(beforeSidebar) !== JSON.stringify(afterSidebar);
+                const routeChanged = afterUrl !== beforeUrl;
+                return {
+                    acted: true,
+                    passed: sidebarChanged || routeChanged,
+                    status: (sidebarChanged || routeChanged) ? 'PASS' : 'FAIL',
+                    moduleText,
+                    sidebarChanged,
+                    routeChanged,
+                    beforeSidebar,
+                    newSidebar: afterSidebar,        // 切换后该模块的完整菜单，供后续 act --menu-path 遍历
+                    beforeUrl: beforeUrl.slice(-60),
+                    afterUrl: afterUrl.slice(-60),
+                    reason: (sidebarChanged || routeChanged) ? undefined : '点击后 sidebar/URL 未变（可能该项无导航或检测时机问题）',
+                };
+            },
+            // 阶段1·全量菜单路由遍历：自动逐个切模块，按 URL 去重，输出完整菜单树。
+            // 产出 modules[]，每项 { entryText, url, urlKey, sidebar[] }，供阶段2 explore-page 逐 URL 深度探索。
+            // ⚠️ 只做"导航广度"覆盖，不展开页面内部（tab/详情/接口）——那是 explore-page 的职责。
+            'traverse-all-menus': async (page, frame, params) => {
+                const triggerSelector = params.triggerSelector || '.operate';
+                const drawerSelector = params.drawerSelector || '.page-left-menu';
+                const maxModules = params.maxModules || 30;
+                const waitAfter = params.waitAfter || 1600;
+                const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+                const urlKey = () => { const h = (page.url().split('#/')[1] || ''); return h.split('?')[0].split('/').slice(0, 2).join('/'); };
+                const readSidebar = () => frame.evaluate(() => Array.from(document.querySelectorAll('.ant-menu-item, .ant-menu-submenu-title')).filter((e) => e.offsetParent !== null).map((e) => (e.innerText || e.textContent || '').trim()).filter(Boolean));
+                const isOpen = () => frame.evaluate((sel) => { const el = document.querySelector(sel); if (!el) return false; const r = el.getBoundingClientRect(); const s = getComputedStyle(el); return r.width > 1 && r.height > 1 && s.display !== 'none' && s.visibility !== 'hidden' && s.opacity !== '0'; }, drawerSelector).catch(() => false);
+                const openDrawer = async () => { if (!(await isOpen())) { await frame.evaluate((sel) => { const el = document.querySelector(sel); el && el.click(); }, triggerSelector).catch(() => {}); await sleep(700); } };
+                const closeDrawer = async () => { if (await isOpen()) { await frame.evaluate((sel) => { const el = document.querySelector(sel); el && el.click(); }, triggerSelector).catch(() => {}); await sleep(400); } };
+
+                // 1. 提取模块入口（每模块取首个二级快捷项叶子文本）
+                await openDrawer();
+                const entries = await frame.evaluate((scope) => {
+                    const drawer = document.querySelector(scope);
+                    if (!drawer) return [];
+                    return Array.from(drawer.querySelectorAll('.menu-item, [class*=menu-item]')).map((m) => {
+                        const titleEl = m.querySelector('.title, [class*=title]');
+                        const moduleTitle = titleEl ? titleEl.textContent.trim() : (m.textContent || '').trim().slice(0, 16);
+                        const firstLeaf = Array.from(m.querySelectorAll('span')).find((e) => e.children.length === 0 && e.textContent.trim() && e.textContent.trim().length <= 14);
+                        return { moduleTitle, entryText: firstLeaf ? firstLeaf.textContent.trim() : null };
+                    }).filter((m) => m.entryText);
+                }, drawerSelector).catch(() => []);
+                await closeDrawer();
+
+                if (entries.length === 0) return { acted: true, passed: false, reason: 'no drawer module entries found (检查 drawerSelector/triggerSelector)', status: 'FAIL' };
+
+                // 2. 逐个切模块 + 按 URL 去重 + 读 sidebar
+                const visited = new Set();
+                const modules = [];
+                let count = 0;
+                for (const ent of entries) {
+                    if (count >= maxModules) break;
+                    count += 1;
+                    // 切模块：开抽屉 → 原生点击入口叶子 → 等 sidebar 刷新
+                    await openDrawer();
+                    const marked = await frame.evaluate((scope, txt) => {
+                        const d = document.querySelector(scope);
+                        if (!d) return false;
+                        const s = Array.from(d.querySelectorAll('span')).find((e) => e.children.length === 0 && e.textContent.trim() === txt);
+                        if (!s) return false;
+                        let t = s;
+                        for (let i = 0; i < 4 && t; i++) { if (t.className && typeof t.className === 'string' && /item/i.test(t.className)) break; t = t.parentElement; }
+                        (t || s).setAttribute('data-szcd-trav', '1');
+                        return true;
+                    }, drawerSelector, ent.entryText).catch(() => false);
+                    if (!marked) { modules.push({ entryText: ent.entryText, moduleTitle: ent.moduleTitle, error: 'entry not found' }); continue; }
+                    const handle = await frame.$('[data-szcd-trav="1"]');
+                    if (handle) {
+                        const box = await handle.boundingBox();
+                        if (box && box.width > 0) { await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2); await sleep(120); await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2); }
+                        await handle.dispose().catch(() => {});
+                    }
+                    await sleep(waitAfter);
+                    await frame.evaluate(() => { const e = document.querySelector('[data-szcd-trav="1"]'); e && e.removeAttribute('data-szcd-trav'); }).catch(() => {});
+
+                    const key = urlKey();
+                    const url = page.url();
+                    if (visited.has(key)) {
+                        modules.push({ entryText: ent.entryText, moduleTitle: ent.moduleTitle, urlKey: key, skipped: true, reason: 'duplicate urlKey' });
+                        continue;
+                    }
+                    visited.add(key);
+                    const sidebar = await readSidebar();
+                    modules.push({ entryText: ent.entryText, moduleTitle: ent.moduleTitle, url, urlKey: key, sidebar });
+                }
+
+                const explored = modules.filter((m) => m.sidebar);
+                return {
+                    acted: true,
+                    passed: explored.length > 0,
+                    status: explored.length > 0 ? 'PASS' : 'FAIL',
+                    moduleEntriesFound: entries.length,
+                    exploredCount: explored.length,
+                    skippedCount: modules.filter((m) => m.skipped).length,
+                    modules,
+                    note: '导航广度遍历完成。每个 module.url + sidebar 可交给 explore-page 做页面内深度探索（tab/详情/接口/写操作）。',
+                };
+            },
+            // 阶段2·单页深度探索（只读 + 记录写入口，绝不触发写操作）。
+            // 捕获页面加载接口 → 遍历 tab（每个 tab 捕获接口）→ 识别详情入口（点进去捕获，只读）→ 识别写按钮（仅记录不点）。
+            // 安全：只点只读元素（tab/查看/详情/查询）；写按钮（新增/编辑/删除/提交/保存/上线/下线/禁用…）只记录文本与分类。
+            // 写操作的真正触发是独立下一步——LLM 拿 writeEntries 给用户确认后再单独执行。
+            'explore-page': async (page, frame, params) => {
+                const maxDepth = Math.min(params.maxDepth || 3, 3);
+                // apiPattern 默认空 = 捕获所有 XHR/Fetch；传了才作为收窄过滤器。
+                // 切忌默认过滤——不同模块接口前缀不同（实测 dp-corpus / dp-label），默认丢弃会漏抓。
+                const apiPattern = params.apiPattern || '';
+                const settleMs = params.settleMs || 1500;
+                const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+                // 写操作关键词（识别用，绝不点击）
+                const WRITE_RE = /新增|新建|创建|添加|编辑|修改|删除|移除|提交|保存|确定|确认|上线|下线|发布|禁用|启用|停用|注册|导入|上传|重置|审核|通过|驳回|撤销/;
+                // 只读动作关键词
+                const READ_RE = /查看|详情|预览|查询|搜索|筛选|展开|刷新/;
+
+                // 自动选「内容最多的 frame」：wujie 微前端常把业务内容放在主 frame 的 shadow DOM，
+                // 而 _getTargetFrame 默认可能选到空的子应用 frame。这里遍历所有 frame（含 shadow 穿透）
+                // 按可点元素数选最丰富的，覆盖传入 frame，避免 frame 选错导致全空。
+                if (!params.frameContentContains && !params.frameUrlContains && params.frameIndex === undefined) {
+                    try {
+                        let best = frame, bestScore = -1;
+                        for (const f of page.frames()) {
+                            const score = await f.evaluate(() => {
+                                const roots = [document];
+                                document.querySelectorAll('wujie-app, [class*=wujie]').forEach((w) => { if (w.shadowRoot) roots.push(w.shadowRoot); });
+                                let n = 0;
+                                roots.forEach((r) => { try { n += r.querySelectorAll('.ant-btn, button, .ant-tabs-tab, [class*=item], [class*=card]').length; } catch (e) {} });
+                                return n;
+                            }).catch(() => -1);
+                            if (score > bestScore) { bestScore = score; best = f; }
+                        }
+                        frame = best;
+                    } catch (e) { /* 选择失败保持原 frame */ }
+                }
+
+                // 轻量接口监听：自建 CDP Network 缓冲，按需读差量
+                let apiBuffer = [];
+                let cdp = null;
+                try {
+                    cdp = await page.target().createCDPSession();
+                    await cdp.send('Network.enable');
+                    cdp.on('Network.responseReceived', (e) => {
+                        const url = e.response && e.response.url || '';
+                        const type = e.type || '';
+                        if ((type === 'XHR' || type === 'Fetch') && (!apiPattern || url.includes(apiPattern))) {
+                            apiBuffer.push({ url: url.slice(0, 200), status: e.response.status, method: (e.response.requestHeaders && e.response.requestHeaders[':method']) || '' });
+                        }
+                    });
+                } catch (e) { /* 接口捕获不可用不影响其余探索 */ }
+                const drainApis = () => { const b = apiBuffer; apiBuffer = []; return b; };
+
+                const result = { url: page.url(), maxDepth, loadApis: [], tabs: [], detailEntries: [], writeEntries: [], errors: [] };
+
+                // 1. 页面加载接口（settle 一下收集首屏请求）
+                await sleep(settleMs);
+                result.loadApis = drainApis();
+
+                // 2. 识别交互元素（按钮/tab/链接），分类
+                const elements = await frame.evaluate((writeSrc, readSrc) => {
+                    const WRITE = new RegExp(writeSrc), READ = new RegExp(readSrc);
+                    // 穿透 wujie-app shadowRoot：业务内容常渲染在 shadow DOM 内，普通 querySelectorAll 探不到
+                    const roots = [document];
+                    document.querySelectorAll('wujie-app, [class*=wujie]').forEach((w) => { if (w.shadowRoot) roots.push(w.shadowRoot); });
+                    const queryAll = (sel) => { const out = []; roots.forEach((r) => { try { out.push(...Array.from(r.querySelectorAll(sel))); } catch (e) {} }); return out; };
+                    const isVisible = (el) => { const r = el.getBoundingClientRect(); const s = (el.ownerDocument.defaultView || window).getComputedStyle(el); return r.width > 1 && r.height > 1 && s.display !== 'none' && s.visibility !== 'hidden'; };
+                    const out = { tabs: [], readBtns: [], writeBtns: [], rawClickables: [], otherBtns: [] };
+                    queryAll('.ant-tabs-tab, [role=tab], [class*=tab-item]').filter(isVisible).forEach((el) => {
+                        const t = (el.innerText || el.textContent || '').trim();
+                        if (t && t.length <= 20 && !out.tabs.includes(t)) out.tabs.push(t);
+                    });
+                    queryAll('.ant-btn, button, [role=button], a, .ant-table-tbody .ant-space-item').filter(isVisible).forEach((el) => {
+                        const t = (el.innerText || el.textContent || '').replace(/\s+/g, '').trim();
+                        if (!t || t.length > 12) return;
+                        if (WRITE.test(t)) { if (!out.writeBtns.includes(t)) out.writeBtns.push(t); }
+                        else if (READ.test(t)) { if (!out.readBtns.includes(t)) out.readBtns.push(t); }
+                        else if (!out.otherBtns.includes(t)) out.otherBtns.push(t); // 未匹配读/写词表的按钮，供 LLM 推理归类
+                    });
+                    // 兜底现场快照：所有可点元素（cursor:pointer / onclick / 自定义可点类）文本采样，
+                    // 供 explore-page 标准识别为空时，LLM 直接据此推理非标准入口，无需重新 observe。
+                    const seen = new Set();
+                    queryAll('[class*=item], [class*=card], [class*=cell], [class*=link], [class*=btn], [onclick], a, li').forEach((el) => {
+                        if (!isVisible(el)) return;
+                        if (el.childElementCount > 2) return; // 偏叶子，避免大容器
+                        const s = (el.ownerDocument.defaultView || window).getComputedStyle(el);
+                        if (s.cursor !== 'pointer' && !el.onclick) return;
+                        const t = (el.innerText || el.textContent || '').replace(/\s+/g, ' ').trim();
+                        if (!t || t.length > 24 || seen.has(t)) return;
+                        seen.add(t);
+                        if (out.rawClickables.length < 40) out.rawClickables.push(t);
+                    });
+                    return out;
+                }, WRITE_RE.source, READ_RE.source).catch(() => ({ tabs: [], readBtns: [], writeBtns: [] }));
+
+                result.writeEntries = elements.writeBtns.map((text) => ({ text, category: 'write', note: '已记录，未点击；需用户确认后单独触发' }));
+
+                // 公共：穿透 shadow 按文本定位元素，返回其视口 rect，再用原生鼠标坐标点击。
+                // 解决 frame.$ 选不到 shadow DOM 内元素的问题（wujie WebComponent 模式）。
+                const clickByText = async (selectorCss, text, exactTrim) => {
+                    const rect = await frame.evaluate((sel, txt, exact) => {
+                        const roots = [document];
+                        document.querySelectorAll('wujie-app, [class*=wujie]').forEach((w) => { if (w.shadowRoot) roots.push(w.shadowRoot); });
+                        let target = null;
+                        for (const r of roots) {
+                            const els = Array.from(r.querySelectorAll(sel));
+                            target = els.find((e) => {
+                                const t = (e.innerText || e.textContent || '');
+                                const norm = exact ? t.replace(/\s+/g, '').trim() : t.trim();
+                                return norm === txt;
+                            });
+                            if (target) break;
+                        }
+                        if (!target) return null;
+                        target.scrollIntoView({ block: 'center', inline: 'center' });
+                        const b = target.getBoundingClientRect();
+                        return { x: b.x + b.width / 2, y: b.y + b.height / 2, w: b.width, h: b.height };
+                    }, selectorCss, text, !!exactTrim).catch(() => null);
+                    if (!rect || rect.w < 1) return false;
+                    await page.mouse.move(rect.x, rect.y);
+                    await sleep(80);
+                    await page.mouse.click(rect.x, rect.y);
+                    return true;
+                };
+
+                // 3. 遍历 tab（depth>=1），每个 tab 切换后捕获接口
+                if (maxDepth >= 1) {
+                    for (const tabText of elements.tabs.slice(0, 12)) {
+                        try {
+                            const clicked = await clickByText('.ant-tabs-tab, [role=tab], [class*=tab-item]', tabText, false);
+                            if (!clicked) continue;
+                            await sleep(settleMs);
+                            result.tabs.push({ tab: tabText, apis: drainApis() });
+                        } catch (e) { result.errors.push('tab "' + tabText + '": ' + e.message); }
+                    }
+                }
+
+                // 4. 详情入口（depth>=2）：行内"查看/详情/管理/明细/检测/进入"等只读管理入口，点进去捕获接口+URL。
+                //    从 readBtns + otherBtns 一起筛（"管理数据/检测"等不在读/写词表，落在 otherBtns）。
+                if (maxDepth >= 2) {
+                    const DETAIL_RE = /查看|详情|明细|管理|检测|进入|预览/;
+                    const candidates = [...elements.readBtns, ...elements.otherBtns].filter((t) => DETAIL_RE.test(t));
+                    const detailTexts = Array.from(new Set(candidates)).slice(0, 3);
+                    for (const dt of detailTexts) {
+                        try {
+                            const beforeUrl = page.url();
+                            const clicked = await clickByText('.ant-btn, button, a, [role=button], .ant-table-tbody span', dt, true);
+                            if (!clicked) continue;
+                            await sleep(settleMs);
+                            const afterUrl = page.url();
+                            const detailApis = drainApis();
+                            // 详情内的 tab（depth 3）——穿透 shadow
+                            let innerTabs = [];
+                            if (maxDepth >= 3) {
+                                innerTabs = await frame.evaluate(() => {
+                                    const roots = [document];
+                                    document.querySelectorAll('wujie-app, [class*=wujie]').forEach((w) => { if (w.shadowRoot) roots.push(w.shadowRoot); });
+                                    const out = [];
+                                    roots.forEach((r) => Array.from(r.querySelectorAll('.ant-tabs-tab, [role=tab]')).forEach((e) => { const b = e.getBoundingClientRect(); const t = (e.innerText || e.textContent || '').trim(); if (b.width > 1 && t && !out.includes(t)) out.push(t); }));
+                                    return out.slice(0, 8);
+                                }).catch(() => []);
+                            }
+                            result.detailEntries.push({ trigger: dt, urlChanged: afterUrl !== beforeUrl, afterUrl: afterUrl.slice(-60), apis: detailApis, innerTabs });
+                            // 关闭详情（抽屉/弹窗）回到列表——穿透 shadow
+                            await frame.evaluate(() => {
+                                const roots = [document];
+                                document.querySelectorAll('wujie-app, [class*=wujie]').forEach((w) => { if (w.shadowRoot) roots.push(w.shadowRoot); });
+                                for (const r of roots) {
+                                    const close = r.querySelector('.ant-drawer-close, .ant-modal-close');
+                                    if (close) { close.click(); return; }
+                                    const cancelBtn = Array.from(r.querySelectorAll('.ant-drawer button, .ant-modal button')).find((b) => /取消|关闭/.test(b.textContent || ''));
+                                    if (cancelBtn) { cancelBtn.click(); return; }
+                                }
+                            }).catch(() => {});
+                            await sleep(600);
+                        } catch (e) { result.errors.push('detail "' + dt + '": ' + e.message); }
+                    }
+                }
+
+                if (cdp) { try { await cdp.detach(); } catch (e) {} }
+
+                return {
+                    acted: true,
+                    passed: true,
+                    status: 'PASS',
+                    ...result,
+                    otherBtns: elements.otherBtns,          // 未匹配读/写词表的按钮，供 LLM 推理归类
+                    rawClickables: elements.rawClickables,  // 兜底现场快照：所有可点元素文本，标准识别为空时据此推理
+                    summary: {
+                        loadApiCount: result.loadApis.length,
+                        tabCount: result.tabs.length,
+                        detailCount: result.detailEntries.length,
+                        writeEntryCount: result.writeEntries.length,
+                        otherBtnCount: elements.otherBtns.length,
+                        rawClickableCount: elements.rawClickables.length,
+                    },
+                    note: 'writeEntries 仅记录未触发。要执行写操作请用户确认后，单独用 act/antInput/formFill + 原生点击触发。标准识别为空时看 rawClickables/otherBtns 推理非标准入口。',
+                };
+            },
             'modal-action': async (page, frame, params) => {
                 var action = params.action;
                 var pattern = params.buttonText || (action === 'confirm' ? '确定|OK|确认' : '取消|Cancel');