@szc-ft/mcp-szcd-client 0.28.2 → 0.29.0

package/qwen-extension/skills/local-browser-test/lib/ant-adapter.js

@@ -49,6 +49,28 @@ export class AntAdapter {
         this.componentMeta = options.componentMeta || {};
     }
 
+    /**
+     * 统一的表单项查找 helper（浏览器端执行）
+     * 弹窗/抽屉打开时优先在其中搜索，避免页面搜索栏的同名 label 被错误命中
+     * 用法：在 frame.evaluate 内调用 _findFormItem(label)
+     */
+    static get FORM_ITEM_HELPER() {
+        return `
+function _findFormItem(label) {
+    var modalOrDrawer = document.querySelector('.ant-modal:not(.ant-modal-hidden), .ant-drawer:not(.ant-drawer-hidden), .ant-drawer-open .ant-drawer-content-wrapper');
+    var scope = modalOrDrawer || document;
+    var items = Array.from(scope.querySelectorAll('.ant-form-item'));
+    if (items.length === 0 && scope !== document) {
+        items = items.concat(Array.from(document.querySelectorAll('.ant-form-item')));
+    }
+    return items.find(function(el) {
+        var lbl = el.querySelector('.ant-form-item-label label, .ant-form-item-label');
+        return lbl && (lbl.innerText || lbl.textContent || '').trim().includes(label);
+    }) || null;
+}
+`;
+    }
+
     /**
      * 关闭所有打开的下拉浮层 / 抽屉 / 弹窗
      * 反馈第 2 条：每次 Select 操作后必须调用，否则下次操作会命中残留选项
@@ -61,9 +83,9 @@ export class AntAdapter {
             });
             // 2) 隐藏所有未隐藏的下拉浮层
             const dropdowns = document.querySelectorAll(
-                "body > .ant-select-dropdown:not(.ant-select-dropdown-hidden), " +
-                "body > .ant-cascader-dropdown:not(.ant-cascader-dropdown-hidden), " +
-                "body > .ant-picker-dropdown:not(.ant-picker-dropdown-hidden)"
+                ".ant-select-dropdown:not(.ant-select-dropdown-hidden), " +
+                ".ant-cascader-dropdown:not(.ant-cascader-dropdown-hidden), " +
+                ".ant-picker-dropdown:not(.ant-picker-dropdown-hidden)"
             );
             const count = dropdowns.length;
             dropdowns.forEach((el) => {
@@ -79,39 +101,45 @@ export class AntAdapter {
         }).catch(() => ({ closed: 0 }));
     }
 
+    /**
+     * 在 frame 上执行 evaluate，自动注入 _findFormItem helper
+     * 后续所有新方法只需调用本方法，无需手动处理弹窗/抽屉优先逻辑
+     */
+    async _evalWithFormHelper(frame, fnBody) {
+        const wrapped = "(function() {" + AntAdapter.FORM_ITEM_HELPER + "return (" + fnBody + ")();\n})()";
+        return frame.evaluate(wrapped);
+    }
+
     /**
      * 定位包含指定 label 的 .ant-form-item，返回其内 control 元素的 selector 信息
      * 不直接返回 ElementHandle（跨 evaluate 边界丢失），而是返回一个临时标记 id
      */
     async _markFormItemControl(frame, labelText, controlHint) {
-        return frame.evaluate(({ label, hint }) => {
-            const items = Array.from(document.querySelectorAll(".ant-form-item"));
-            const item = items.find((el) => {
-                const lbl = el.querySelector(".ant-form-item-label label, .ant-form-item-label");
-                if (!lbl) return false;
-                return (lbl.innerText || lbl.textContent || "").trim().includes(label);
-            });
+        const label = labelText.replace(/'/g, "\\'");
+        const hint = controlHint;
+        return this._evalWithFormHelper(frame, `() => {
+            const item = _findFormItem('${label}');
             if (!item) return { found: false };
 
             // 找控件：根据 hint 决定优先匹配何种节点
             let control;
-            if (hint === "select") {
+            if (${JSON.stringify(hint)} === "select") {
                 control = item.querySelector(".ant-select:not(.ant-select-disabled)");
-            } else if (hint === "treeSelect") {
+            } else if (${JSON.stringify(hint)} === "treeSelect") {
                 control = item.querySelector(".ant-select.ant-tree-select, .ant-tree-select");
-            } else if (hint === "cascader") {
+            } else if (${JSON.stringify(hint)} === "cascader") {
                 control = item.querySelector(".ant-cascader, .ant-cascader-picker");
-            } else if (hint === "datePicker") {
+            } else if (${JSON.stringify(hint)} === "datePicker") {
                 control = item.querySelector(".ant-picker");
-            } else if (hint === "input") {
+            } else if (${JSON.stringify(hint)} === "input") {
                 control = item.querySelector("input.ant-input, textarea.ant-input, .ant-input-affix-wrapper input");
-            } else if (hint === "radio") {
+            } else if (${JSON.stringify(hint)} === "radio") {
                 control = item.querySelector(".ant-radio-group");
-            } else if (hint === "checkbox") {
+            } else if (${JSON.stringify(hint)} === "checkbox") {
                 control = item.querySelector(".ant-checkbox-group, .ant-checkbox-wrapper");
-            } else if (hint === "switch") {
+            } else if (${JSON.stringify(hint)} === "switch") {
                 control = item.querySelector(".ant-switch");
-            } else if (hint === "upload") {
+            } else if (${JSON.stringify(hint)} === "upload") {
                 control = item.querySelector(".ant-upload input[type='file'], input[type='file']");
             } else {
                 control = item.querySelector("input, .ant-select, .ant-picker, .ant-cascader");
@@ -120,7 +148,7 @@ export class AntAdapter {
             if (!control) return { found: true, hasControl: false };
 
             // 用临时 data 属性标记，避免重复 traversal
-            const marker = `__sz_marker_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
+            const marker = '__sz_marker_' + Date.now() + '_' + Math.random().toString(36).slice(2, 6);
             control.setAttribute("data-sz-marker", marker);
             item.setAttribute("data-sz-form-item-marker", marker);
             const rect = control.getBoundingClientRect();
@@ -131,7 +159,7 @@ export class AntAdapter {
                 tagName: control.tagName,
                 visible: rect.width > 0 && rect.height > 0,
             };
-        }, { label: labelText, hint: controlHint });
+        }`);
     }
 
     async _clearMarkers(frame) {
@@ -189,12 +217,12 @@ export class AntAdapter {
         }
 
         const selectedSummary = [];
+        let popupResolved = popupFrame;
         for (const opt of options) {
             // 3) 浮层探测：先在触发器 frame 找，没找到再在 popupFrame 找（兜底）
-            let popupResolved = popupFrame;
             let optionFound = await pollEval(popupResolved, (text) => {
                 const items = Array.from(document.querySelectorAll(
-                    "body > .ant-select-dropdown:not(.ant-select-dropdown-hidden) .ant-select-item-option"
+                    ".ant-select-dropdown:not(.ant-select-dropdown-hidden) .ant-select-item-option"
                 ));
                 const visibleItems = items.filter((el) => {
                     const rect = el.getBoundingClientRect();
@@ -220,7 +248,7 @@ export class AntAdapter {
                 if (parentFrame && parentFrame !== frame) {
                     const retryFound = await pollEval(parentFrame, (text) => {
                         const items = Array.from(document.querySelectorAll(
-                            "body > .ant-select-dropdown:not(.ant-select-dropdown-hidden) .ant-select-item-option"
+                            ".ant-select-dropdown:not(.ant-select-dropdown-hidden) .ant-select-item-option"
                         ));
                         const visibleItems = items.filter((el) => {
                             const rect = el.getBoundingClientRect();
@@ -257,12 +285,13 @@ export class AntAdapter {
                 };
             }
 
-            // 4) mousedown 选项（在 popupResolved frame 内）
+            // 4) 点击选项（在 popupResolved frame 内），需同时触发 mousedown+click 才可驱动 React onChange
             await popupResolved.evaluate((tag) => {
                 const el = document.querySelector(`[data-sz-option-marker="${tag}"]`);
                 if (!el) return false;
                 el.dispatchEvent(new MouseEvent("mousedown", { bubbles: true, cancelable: true, button: 0 }));
                 el.dispatchEvent(new MouseEvent("mouseup", { bubbles: true, cancelable: true, button: 0 }));
+                el.dispatchEvent(new MouseEvent("click", { bubbles: true, cancelable: true, button: 0 }));
                 el.removeAttribute("data-sz-option-marker");
                 return true;
             }, optionFound.value.tag);
@@ -338,8 +367,8 @@ export class AntAdapter {
 
             const found = await pollEval(frame, ({ text, isLeaf }) => {
                 const titles = Array.from(document.querySelectorAll(
-                    "body > .ant-select-dropdown:not(.ant-select-dropdown-hidden) .ant-select-tree-title, " +
-                    "body > .ant-tree-select-dropdown:not(.ant-select-dropdown-hidden) .ant-select-tree-title"
+                    ".ant-select-dropdown:not(.ant-select-dropdown-hidden) .ant-select-tree-title, " +
+                    ".ant-tree-select-dropdown:not(.ant-select-dropdown-hidden) .ant-select-tree-title"
                 ));
                 const visible = titles.filter((el) => {
                     const rect = el.getBoundingClientRect();
@@ -408,29 +437,33 @@ export class AntAdapter {
      */
     async input(frame, target, value, opts = {}) {
         const clear = opts.clear !== false;
-        const result = await frame.evaluate(({ target, value, clear }) => {
-            let el = null;
-
-            if (target.label) {
-                const items = Array.from(document.querySelectorAll(".ant-form-item"));
-                const item = items.find((x) => {
-                    const lbl = x.querySelector(".ant-form-item-label");
-                    return lbl && (lbl.innerText || lbl.textContent || "").trim().includes(target.label);
-                });
-                el = item?.querySelector("input.ant-input, textarea.ant-input, .ant-input-affix-wrapper input, input[type='text'], input[type='number'], input[type='password'], input:not([type])");
-            } else if (target.placeholder) {
-                el = document.querySelector(`input[placeholder*="${target.placeholder}"], textarea[placeholder*="${target.placeholder}"]`);
-            } else if (target.selector) {
-                try { el = document.querySelector(target.selector); } catch { el = null; }
+        const label = (target.label || '').replace(/'/g, "\\'");
+        const placeholder = (target.placeholder || '').replace(/'/g, "\\'");
+        const selector = (target.selector || '').replace(/'/g, "\\'");
+
+        const result = await this._evalWithFormHelper(frame, `() => {
+            var el = null;
+            var val = ${JSON.stringify(value)};
+            var shouldClear = ${clear};
+
+            var item = _findFormItem('${label}');
+            if (item) {
+                el = item.querySelector("input.ant-input, textarea.ant-input, .ant-input-affix-wrapper input, input[type='text'], input[type='number'], input[type='password'], input:not([type])");
+            }
+            if (!el && '${placeholder}') {
+                el = document.querySelector('input[placeholder*="${placeholder}"], textarea[placeholder*="${placeholder}"]');
+            }
+            if (!el && '${selector}') {
+                try { el = document.querySelector('${selector}'); } catch(e) { el = null; }
             }
 
             if (!el) return { found: false };
             el.scrollIntoView({ block: "center" });
-            const proto = Object.getPrototypeOf(el);
-            const valueSetter = Object.getOwnPropertyDescriptor(proto, "value")?.set;
+            var proto = Object.getPrototypeOf(el);
+            var valueSetter = Object.getOwnPropertyDescriptor(proto, "value") && Object.getOwnPropertyDescriptor(proto, "value").set;
 
             el.focus();
-            const newValue = clear ? value : (el.value || "") + value;
+            var newValue = shouldClear ? val : (el.value || "") + val;
             if (valueSetter) {
                 valueSetter.call(el, newValue);
             } else {
@@ -444,7 +477,7 @@ export class AntAdapter {
                 placeholder: el.getAttribute("placeholder"),
                 tagName: el.tagName,
             };
-        }, { target, value, clear });
+        }`);
 
         return {
             acted: result.found,
@@ -460,27 +493,26 @@ export class AntAdapter {
      * Ant Radio 选择
      */
     async radio(frame, fieldLabel, optionLabel) {
-        const result = await frame.evaluate(({ field, opt }) => {
-            const items = Array.from(document.querySelectorAll(".ant-form-item"));
-            const item = items.find((x) => {
-                const lbl = x.querySelector(".ant-form-item-label");
-                return lbl && (lbl.innerText || lbl.textContent || "").trim().includes(field);
-            });
+        const field = fieldLabel.replace(/'/g, "\\'");
+        const opt = optionLabel.replace(/'/g, "\\'");
+
+        const result = await this._evalWithFormHelper(frame, `() => {
+            var item = _findFormItem('${field}');
             if (!item) return { found: false, reason: "form item not found" };
 
-            const wrappers = Array.from(item.querySelectorAll(".ant-radio-wrapper"));
-            const target = wrappers.find((w) => (w.innerText || "").trim().includes(opt));
-            if (!target) return { found: false, reason: `radio option "${opt}" not found`, available: wrappers.map((w) => (w.innerText || "").trim()) };
+            var wrappers = Array.from(item.querySelectorAll(".ant-radio-wrapper"));
+            var target = wrappers.find(function(w) { return (w.innerText || "").trim().includes('${opt}'); });
+            if (!target) return { found: false, reason: 'radio option not found', available: wrappers.map(function(w) { return (w.innerText || "").trim(); }) };
 
             target.scrollIntoView({ block: "center" });
             target.click();
-            const input = target.querySelector("input[type='radio']");
+            var input = target.querySelector("input[type='radio']");
             return {
                 found: true,
-                checked: input?.checked || false,
-                value: input?.value || "",
+                checked: input && input.checked || false,
+                value: input && input.value || "",
             };
-        }, { field: fieldLabel, opt: optionLabel });
+        }`);
         return {
             acted: result.found,
             field: fieldLabel,
@@ -495,24 +527,20 @@ export class AntAdapter {
      * Ant Checkbox 切换（按 label 文本）
      */
     async checkbox(frame, fieldLabel, optionLabel, checked = true) {
-        const result = await frame.evaluate(({ field, opt, target }) => {
-            const items = Array.from(document.querySelectorAll(".ant-form-item"));
-            const item = items.find((x) => {
-                const lbl = x.querySelector(".ant-form-item-label");
-                return lbl && (lbl.innerText || lbl.textContent || "").trim().includes(field);
-            });
+        const field = fieldLabel.replace(/'/g, "\\'");
+        const opt = (optionLabel || '').replace(/'/g, "\\'");
+
+        const result = await this._evalWithFormHelper(frame, `() => {
+            var item = _findFormItem('${field}');
             if (!item) return { found: false };
-            // 支持 group 和单独 checkbox
-            const wrappers = Array.from(item.querySelectorAll(".ant-checkbox-wrapper"));
-            const wrapper = opt
-                ? wrappers.find((w) => (w.innerText || "").includes(opt))
-                : wrappers[0];
+            var wrappers = Array.from(item.querySelectorAll(".ant-checkbox-wrapper"));
+            var wrapper = '${opt}' ? wrappers.find(function(w) { return (w.innerText || "").includes('${opt}'); }) : wrappers[0];
             if (!wrapper) return { found: false, reason: "checkbox not found" };
-            const input = wrapper.querySelector("input[type='checkbox']");
+            var input = wrapper.querySelector("input[type='checkbox']");
             if (!input) return { found: false };
-            if (input.checked !== target) wrapper.click();
+            if (input.checked !== ${checked}) wrapper.click();
             return { found: true, checked: input.checked };
-        }, { field: fieldLabel, opt: optionLabel, target: checked });
+        }`);
         return { acted: result.found, field: fieldLabel, option: optionLabel, verified: result.checked === checked };
     }
 
@@ -520,19 +548,17 @@ export class AntAdapter {
      * Ant Switch 切换
      */
     async switch(frame, fieldLabel, on = true) {
-        const result = await frame.evaluate(({ field, target }) => {
-            const items = Array.from(document.querySelectorAll(".ant-form-item"));
-            const item = items.find((x) => {
-                const lbl = x.querySelector(".ant-form-item-label");
-                return lbl && (lbl.innerText || lbl.textContent || "").trim().includes(field);
-            });
+        const field = fieldLabel.replace(/'/g, "\\'");
+
+        const result = await this._evalWithFormHelper(frame, `() => {
+            var item = _findFormItem('${field}');
             if (!item) return { found: false };
-            const sw = item.querySelector(".ant-switch");
+            var sw = item.querySelector(".ant-switch");
             if (!sw) return { found: false };
-            const isOn = sw.getAttribute("aria-checked") === "true" || sw.classList.contains("ant-switch-checked");
-            if (isOn !== target) sw.click();
-            return { found: true, state: target };
-        }, { field: fieldLabel, target: on });
+            var isOn = sw.getAttribute("aria-checked") === "true" || sw.classList.contains("ant-switch-checked");
+            if (isOn !== ${on}) sw.click();
+            return { found: true, state: ${on} };
+        }`);
         return { acted: result.found, field: fieldLabel, state: result.state, verified: result.state === on };
     }
 
@@ -541,29 +567,27 @@ export class AntAdapter {
      */
     async datePicker(frame, fieldLabel, dateString) {
         await this.closeAllDropdowns(frame);
-        const result = await frame.evaluate(({ field, value }) => {
-            const items = Array.from(document.querySelectorAll(".ant-form-item"));
-            const item = items.find((x) => {
-                const lbl = x.querySelector(".ant-form-item-label");
-                return lbl && (lbl.innerText || lbl.textContent || "").trim().includes(field);
-            });
+        const field = fieldLabel.replace(/'/g, "\\'");
+        const val = (dateString || '').replace(/'/g, "\\'");
+
+        const result = await this._evalWithFormHelper(frame, `() => {
+            var item = _findFormItem('${field}');
             if (!item) return { found: false };
-            const picker = item.querySelector(".ant-picker");
-            const input = picker?.querySelector("input");
+            var picker = item.querySelector(".ant-picker");
+            var input = picker && picker.querySelector("input");
             if (!input) return { found: false };
 
             input.scrollIntoView({ block: "center" });
             input.focus();
-            const setter = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(input), "value")?.set;
-            if (setter) setter.call(input, value);
-            else input.value = value;
+            var setter = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(input), "value") && Object.getOwnPropertyDescriptor(Object.getPrototypeOf(input), "value").set;
+            if (setter) setter.call(input, '${val}');
+            else input.value = '${val}';
             input.dispatchEvent(new Event("input", { bubbles: true }));
             input.dispatchEvent(new Event("change", { bubbles: true }));
-            // 回车确认
             input.dispatchEvent(new KeyboardEvent("keydown", { key: "Enter", code: "Enter", keyCode: 13, which: 13, bubbles: true }));
             input.blur();
             return { found: true, value: input.value };
-        }, { field: fieldLabel, value: dateString });
+        }`);
         await this.closeAllDropdowns(frame);
         return { acted: result.found, field: fieldLabel, value: result.value, verified: result.value === dateString };
     }
@@ -596,7 +620,7 @@ export class AntAdapter {
             const seg = segments[i];
             const result = await pollEval(frame, (text) => {
                 const all = Array.from(document.querySelectorAll(
-                    "body > .ant-cascader-dropdown:not(.ant-cascader-dropdown-hidden) .ant-cascader-menu-item"
+                    ".ant-cascader-dropdown:not(.ant-cascader-dropdown-hidden) .ant-cascader-menu-item"
                 ));
                 const visible = all.filter((el) => {
                     const r = el.getBoundingClientRect();
@@ -625,21 +649,16 @@ export class AntAdapter {
      * Upload 文件上传
      */
     async upload(frame, fieldLabel, filePath) {
-        // 注意：puppeteer 上传文件需要通过 ElementHandle.uploadFile，evaluate 内做不到
-        // 这里只能返回需要上层处理的标志
-        const result = await frame.evaluate((field) => {
-            const items = Array.from(document.querySelectorAll(".ant-form-item"));
-            const item = items.find((x) => {
-                const lbl = x.querySelector(".ant-form-item-label");
-                return lbl && (lbl.innerText || lbl.textContent || "").trim().includes(field);
-            });
+        const field = fieldLabel.replace(/'/g, "\\'");
+        const result = await this._evalWithFormHelper(frame, `() => {
+            var item = _findFormItem('${field}');
             if (!item) return { found: false };
-            const input = item.querySelector("input[type='file']");
+            var input = item.querySelector("input[type='file']");
             if (!input) return { found: false };
-            const marker = `__sz_upload_${Date.now()}`;
+            var marker = '__sz_upload_' + Date.now();
             input.setAttribute("data-sz-marker", marker);
-            return { found: true, marker };
-        }, fieldLabel);
+            return { found: true, marker: marker };
+        }`);
 
         if (!result.found) return { acted: false, reason: "upload input not found" };
 

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

@@ -24,6 +24,7 @@ export class BrowserEngine {
         this._activeFrame = null;  // 当前活跃 iframe 上下文（微前端场景）
         this._adapter = null;      // 懒加载 AntAdapter
         this._lastActWasDropdown = false; // 用于 act 入口自动 closeAllDropdowns
+        this._wujieContext = null;  // wujie 微前端模式 { type, frameCount, wujieApp? }
     }
 
     /**
@@ -72,6 +73,133 @@ export class BrowserEngine {
         }
     }
 
+    /**
+     * 检测 wujie 微前端模式（WebComponent / iframe）
+     * @returns {{ type: 'webcomponent'|'iframe'|'none', frameCount: number, wujieApp?: object }}
+     */
+    async _detectWujieMode() {
+        const frames = this.page.frames();
+        const frameCount = frames.length;
+        const mainFrame = this.page.mainFrame();
+
+        // 检查主文档中是否有 <wujie-app> 自定义元素（WebComponent 模式标志）
+        const wujieInfo = await mainFrame.evaluate(() => {
+            const app = document.querySelector('wujie-app');
+            if (!app) return null;
+            const sr = app.shadowRoot;
+            return {
+                tagName: app.tagName,
+                className: app.className,
+                hasShadowRoot: !!sr,
+                shadowChildren: sr?.children?.length || 0,
+                shadowBodyText: sr?.querySelector('body')?.innerText?.substring(0, 80) || ''
+            };
+        }).catch(() => null);
+
+        if (wujieInfo) {
+            const ctx = { type: 'webcomponent', frameCount, wujieApp: wujieInfo };
+            process.stderr.write(`[wujie] WebComponent 模式: <${wujieInfo.tagName} class="${wujieInfo.className}"> shadowRoot=${wujieInfo.hasShadowRoot} children=${wujieInfo.shadowChildren} frames=${frameCount}\n`);
+            if (wujieInfo.shadowBodyText) {
+                process.stderr.write(`[wujie]   shadow body preview: "${wujieInfo.shadowBodyText}"\n`);
+            }
+            // 列出所有 frame 供排障
+            for (let i = 0; i < frames.length; i++) {
+                process.stderr.write(`[wujie]   frame[${i}]: ${frames[i].url().substring(0, 100)}\n`);
+            }
+            return ctx;
+        }
+
+        if (frameCount > 1) {
+            process.stderr.write(`[wujie] iframe 模式: ${frameCount} frames\n`);
+            for (let i = 0; i < frames.length; i++) {
+                process.stderr.write(`[wujie]   frame[${i}]: ${frames[i].url().substring(0, 100)}\n`);
+            }
+            return { type: 'iframe', frameCount };
+        }
+
+        process.stderr.write(`[wujie] 未检测到微前端 (frames=${frameCount})\n`);
+        return { type: 'none', frameCount };
+    }
+
+    /**
+     * 安全获取页面列表（优先同步 targets() 避免 pages() 挂死 + 泄露 WebSocket）
+     */
+    async _safeGetPages() {
+        // 1. 优先使用同步 targets()，不会挂死也不会泄露未完成的 promise
+        try {
+            const targets = this.browser.targets();
+            const pageTargets = targets.filter((t) => t.type() === "page");
+            if (pageTargets.length > 0) {
+                const pages = [];
+                for (const t of pageTargets) {
+                    try {
+                        const p = await Promise.race([
+                            t.page(),
+                            new Promise((_, reject) => setTimeout(() => reject(new Error("page() timeout")), 3000)),
+                        ]);
+                        if (p) pages.push(p);
+                    } catch {
+                        // 跳过无法获取的 target
+                    }
+                }
+                if (pages.length > 0) return pages;
+            }
+        } catch {
+            // targets() 失败
+        }
+
+        // 2. 回退：CDP Target.getTargets
+        try {
+            const client = await this.browser.target().createCDPSession();
+            const { targetInfos } = await client.send("Target.getTargets");
+            const pageInfos = targetInfos.filter((t) => t.type === "page");
+            const pages = [];
+            for (const info of pageInfos) {
+                try {
+                    const target = await Promise.race([
+                        this.browser.waitForTarget((t) => t.url() === info.url, { timeout: 2000 }),
+                        new Promise((_, reject) => setTimeout(() => reject(new Error("waitForTarget timeout")), 3000)),
+                    ]);
+                    if (target) {
+                        const p = await Promise.race([
+                            target.page(),
+                            new Promise((_, reject) => setTimeout(() => reject(new Error("page() timeout")), 3000)),
+                        ]);
+                        if (p) pages.push(p);
+                    }
+                } catch {
+                    // skip
+                }
+            }
+            if (pages.length > 0) return pages;
+        } catch {
+            // CDP 回退也失败
+        }
+
+        // 3. 最后手段：只能尝试 pages()（带严格超时，用完立即 disconnect/reconnect 清理）
+        try {
+            const pages = await Promise.race([
+                this.browser.pages(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error("pages() timeout")), 5000)),
+            ]);
+            if (pages && pages.length > 0) return pages;
+        } catch {
+            // pages() 超时；注意此时 browser.pages() 的 WebSocket 可能泄露
+            // 清理：断开后重新连接
+            try {
+                const wsUrl = this.browser.wsEndpoint();
+                const puppeteer = await loadPuppeteer();
+                await this.browser.disconnect();
+                this.browser = await puppeteer.connect({ browserWSEndpoint: wsUrl, defaultViewport: null });
+            } catch {
+                // reconnect 失败，继续用当前 browser
+            }
+        }
+
+        // 4. 最后手段：newPage()
+        return [await this.browser.newPage()];
+    }
+
     /**
      * 模式 A：连接到用户已有的 Chrome
      */
@@ -82,7 +210,7 @@ export class BrowserEngine {
         this.ownedBrowser = false;
 
         // 获取页面：优先使用指定 URL 匹配的标签页
-        const pages = await this.browser.pages();
+        const pages = await this._safeGetPages();
         if (options.pageUrl) {
             this.page = pages.find((p) => p.url().includes(options.pageUrl))
                      || await this.browser.newPage();
@@ -96,6 +224,9 @@ export class BrowserEngine {
             await this.page.setViewport(options.viewport);
         }
 
+        // 微前端模式检测
+        this._wujieContext = await this._detectWujieMode();
+
         return {
             mode: "connect",
             cdpUrl,
@@ -223,6 +354,7 @@ export class BrowserEngine {
                 frameUrl: targetFrame.frame.url(),
                 matchedBy: targetFrame.matchedBy,
             },
+            wujieContext: this._wujieContext,
             frames,
             tree,
             interactiveElements,
@@ -247,7 +379,10 @@ export class BrowserEngine {
 
         const targetFrame = await this._resolveObserveFrame(options);
         if (options.menuPath) {
-            return this._actMenuPath(targetFrame, options);
+            // 菜单在 main frame 外壳中渲染，不随子应用切换
+            const menuFrame = this.page.mainFrame();
+            const menuTarget = { frame: menuFrame, frameId: "main", matchedBy: "main (menu shell)" };
+            return this._actMenuPath(menuTarget, options);
         }
 
         const index = options.index !== undefined ? Number.parseInt(options.index, 10) : undefined;
@@ -944,6 +1079,15 @@ export class BrowserEngine {
     }
 
     async _resolveObserveFrame(options = {}) {
+        // testCase setup 已预定位 iframe，且调用方未显式传 frame 参数 → 直接复用
+        if (this._activeFrame && options.frameIndex === undefined && !options.frameUrlContains && !options.frameContentContains) {
+            const frames = this.page.frames();
+            const idx = frames.indexOf(this._activeFrame);
+            if (idx >= 0) {
+                return { frame: this._activeFrame, frameId: idx === 0 ? "main" : `frame-${idx}`, matchedBy: "activeFrame (from testCase setup)" };
+            }
+        }
+
         const frames = this.page.frames();
         const mainFrame = this.page.mainFrame();
 
@@ -973,6 +1117,14 @@ export class BrowserEngine {
             }
         }
 
+        // 无显式 frame 参数时：WebComponent 模式默认用 sandbox iframe（含子应用实际 DOM）
+        if (this._wujieContext?.type === 'webcomponent' && frames.length > 1) {
+            const sandboxIdx = frames.findIndex((f) => f !== mainFrame && !f.url().startsWith('about:'));
+            if (sandboxIdx >= 0) {
+                return { frame: frames[sandboxIdx], frameId: `frame-${sandboxIdx}`, matchedBy: 'webcomponent sandbox iframe' };
+            }
+        }
+
         const mainIndex = frames.indexOf(mainFrame);
         return { frame: mainFrame, frameId: mainIndex <= 0 ? "main" : `frame-${mainIndex}`, matchedBy: "main" };
     }
@@ -1693,7 +1845,7 @@ export class BrowserEngine {
      * 查找已打开的标签页（connect 模式，端口可变场景）
      */
     async _findPage(step) {
-        const pages = await this.browser.pages();
+        const pages = await this._safeGetPages();
         let matched = null;
         let matchReason = "";
 

package/qwen-extension/skills/local-browser-test/package.json

@@ -0,0 +1 @@
+{"type": "module"}