@aiscene/aiserver 1.8.2 → 1.8.4

package/dist/debug/websocket-server.js

@@ -41,6 +41,7 @@ export class DebugWebSocketServer {
     config;
     port;
     isStarted = false;
+    activeBatchSessionIds = new Set();
     // 任务日志订阅: taskId -> Set of WebSocket clients
     taskLogSubscribers = new Map();
     // 记录客户端订阅的所有任务（用于断开时清理）
@@ -258,6 +259,13 @@ export class DebugWebSocketServer {
             }
             for (const sessionId of sessionManager.findByClient(ws)) {
                 const s = sessionManager.get(sessionId);
+                // 本地批量执行已经交给 AIServer 后台顺序跑，前端页面断开不应中断执行。
+                if (this.activeBatchSessionIds.has(sessionId)) {
+                    if (s)
+                        s.client = undefined;
+                    logger.info(`[BatchAction] Client disconnected, keep active batch session running: ${sessionId}`);
+                    continue;
+                }
                 // Web 调试会话：客户端断开不销毁浏览器/投屏，仅解绑 client，由 TTL 在 30 分钟无活动时自动回收
                 if (s && s.platform === 'web' && this.webSessionsActivity.has(sessionId)) {
                     s.client = undefined;
@@ -295,6 +303,12 @@ export class DebugWebSocketServer {
             case 'execute_web_action':
                 await this.handleExecuteWebAction(ws, message);
                 break;
+            case 'batch_action':
+                await this.handleBatchAction(ws, message);
+                break;
+            case 'stop_batch':
+                await this.handleStopBatch(ws, message);
+                break;
             case 'start_screencast':
                 await this.handleStartScreencast(ws, message);
                 break;
@@ -478,10 +492,10 @@ export class DebugWebSocketServer {
         }
     }
     /**
-     * Web 调试主进程内嵌执行（支持 sessionId 复用 + 浏览器/投屏保留 + 30 分钟 TTL）
+     * Web 调试主进程内嵌执行
      * - 首次请求：懒启动浏览器 + PlaywrightAgent + 自动投屏
      * - 复用请求：跳过初始化，直接执行 naturalLanguage
-     * - 执行完不关浏览器，由 startWebSessionGc 按 TTL 自动回收
+     * - 执行完成后自动关闭浏览器，释放资源
      */
     async handleStartDebugWeb(ws, request) {
         // 1) 决定 sessionId（客户端传了就用以复用）
@@ -597,11 +611,19 @@ export class DebugWebSocketServer {
                     const contextOptions = {
                         viewport: request.viewport || { width: 1280, height: 800 },
                     };
-                    const acquired = await webBrowserPool.acquireContext(contextOptions);
-                    browser = acquired.browser;
-                    context = acquired.context;
+                    browser = await playwright.chromium.launch({ headless: false });
+                    context = await browser.newContext(contextOptions);
                     page = await context.newPage();
-                    releaseBrowser = acquired.release;
+                    releaseBrowser = async () => {
+                        try {
+                            await context.close();
+                        }
+                        catch { /* ignore */ }
+                        try {
+                            await browser.close();
+                        }
+                        catch { /* ignore */ }
+                    };
                 }
                 session.browser = browser;
                 session.context = context;
@@ -636,12 +658,6 @@ export class DebugWebSocketServer {
                     page,
                     logPrefix: `[WebDebug ${sessionId}]`,
                 });
-                // 兼容旧版表单登录配置（仅首次启动时执行）
-                if (request.loginConfig && request.loginConfig.loginUrl
-                    && request.loginConfig.loginUsername && request.loginConfig.loginPassword) {
-                    const loginConfig = { ...request.loginConfig, mobileMode: request.mobileMode || false };
-                    await this.performWebLogin(page, loginConfig);
-                }
             }
             else {
                 logger.info(`[WebDebug] Reusing existing session: ${sessionId}`);
@@ -660,7 +676,7 @@ export class DebugWebSocketServer {
             // 5) 若指定了 url，则导航（首启或复用，传了就 goto）
             if (request.url) {
                 try {
-                    await page.goto(request.url, { waitUntil: 'networkidle' });
+                    await this.safeWebGoto(page, request.url, `[WebDebug] Navigate to ${request.url}`);
                     logger.info(`[WebDebug] Navigated to: ${request.url}`);
                 }
                 catch (gotoErr) {
@@ -697,7 +713,7 @@ export class DebugWebSocketServer {
             logger.info(`[WebDebug] report uploaded: reportUrl=${reportUrl || 'null'}, reportFile=${reportFile}`);
             const success = !execError;
             sessionManager.updateStatus(sessionId, success ? 'completed' : 'failed');
-            // ★ 关键：不调用 closeWebSession()，浏览器与投屏完全保留，等 TTL 自然回收
+            // 执行完成后自动关闭浏览器，释放资源
             this.sendMessage(ws, {
                 type: 'debug_completed',
                 sessionId,
@@ -705,6 +721,12 @@ export class DebugWebSocketServer {
                 reportUrl,
                 errorMessage: execError,
             });
+            try {
+                await this.closeWebSession(sessionId);
+            }
+            catch (closeErr) {
+                logger.warn(`[WebDebug] Auto close browser failed: ${closeErr.message}`);
+            }
         }
         catch (error) {
             const msg = error.message;
@@ -712,7 +734,13 @@ export class DebugWebSocketServer {
             sessionManager.updateStatus(sessionId, 'failed');
             this.sendMessage(ws, { type: 'debug_error', sessionId, error: msg });
             this.sendMessage(ws, { type: 'debug_completed', sessionId, success: false, errorMessage: msg });
-            // 注：致命错误也不主动关浏览器，避免破坏复用契约；如需销毁让前端发 close_web_session
+            // 致命错误也自动关闭浏览器
+            try {
+                await this.closeWebSession(sessionId);
+            }
+            catch (closeErr) {
+                logger.warn(`[WebDebug] Auto close browser (fatal) failed: ${closeErr.message}`);
+            }
         }
     }
     /**
@@ -792,21 +820,11 @@ export class DebugWebSocketServer {
             skipAppRestart: request.skipAppRestart,
             mobileMode: request.mobileMode,
             deviceName: request.deviceName,
+            loginContext: request.loginContext,
             // 环境代理配置
             proxyPort: request.proxyPort,
             // 公司代理平台账号
             proxyAccount: request.proxyAccount,
-            // 添加登录配置
-            ...(request.loginConfig && {
-                loginUrl: request.loginConfig.loginUrl,
-                loginUsername: request.loginConfig.loginUsername,
-                loginPassword: request.loginConfig.loginPassword,
-                usernameSelector: request.loginConfig.usernameSelector,
-                passwordSelector: request.loginConfig.passwordSelector,
-                loginButtonSelector: request.loginConfig.loginButtonSelector,
-                loginModeSelector: request.loginConfig.loginModeSelector,
-                agreementSelector: request.loginConfig.agreementSelector,
-            }),
         };
         // 注意：proxy-service.jd.com 的规则由前端（浏览器端）设置，后端只负责设备代理 + 抓包
         try {
@@ -919,21 +937,11 @@ export class DebugWebSocketServer {
             nodeId: this.config.task.nodeId,
             modelConfig: fullModelConfig,
             skipAppRestart: request.skipAppRestart,
+            loginContext: request.loginContext,
             // 环境代理配置
             proxyPort: request.proxyPort,
             // 公司代理平台账号
             proxyAccount: request.proxyAccount,
-            // 添加登录配置
-            ...(request.loginConfig && {
-                loginUrl: request.loginConfig.loginUrl,
-                loginUsername: request.loginConfig.loginUsername,
-                loginPassword: request.loginConfig.loginPassword,
-                usernameSelector: request.loginConfig.usernameSelector,
-                passwordSelector: request.loginConfig.passwordSelector,
-                loginButtonSelector: request.loginConfig.loginButtonSelector,
-                loginModeSelector: request.loginConfig.loginModeSelector,
-                agreementSelector: request.loginConfig.agreementSelector,
-            }),
         };
         // 注意：proxy-service.jd.com 的规则由前端（浏览器端）设置，后端只负责设备代理 + 抓包
         // 始终启动请求抓包
@@ -1514,58 +1522,79 @@ export class DebugWebSocketServer {
         }
     }
     // ==================== Execute Web Action (Playwright + Midscene, with screencast) ====================
-    async performWebLogin(page, loginConfig) {
-        if (!loginConfig.loginUrl || !loginConfig.loginUsername || !loginConfig.loginPassword) {
-            logger.warn('Login credentials not provided, skipping login');
-            return;
+    normalizeWebUrl(value) {
+        if (!value)
+            return '';
+        try {
+            const parsed = new URL(value);
+            parsed.hash = '';
+            return parsed.toString().replace(/\/$/, '');
+        }
+        catch {
+            return String(value).split('#')[0].replace(/\/$/, '');
         }
-        logger.info(`Performing web login at: ${loginConfig.loginUrl}`);
+    }
+    getCurrentWebUrl(page) {
         try {
-            // Navigate to login page
-            await page.goto(loginConfig.loginUrl, { waitUntil: 'networkidle' });
-            logger.info(`Navigated to login page: ${loginConfig.loginUrl}`);
-            // Wait for page to load
-            await new Promise(resolve => setTimeout(resolve, loginConfig.mobileMode ? 3000 : 2000));
-            // Click "账号密码登录" button first
-            logger.info('Clicking account password login button');
-            await page.click('span.J_ping.planBLogin:has-text("账号密码登录")');
-            // Wait for login form to appear
-            await new Promise(resolve => setTimeout(resolve, loginConfig.mobileMode ? 2000 : 1000));
-            // Fill username
-            const usernameSelector = loginConfig.usernameSelector || '#username';
-            logger.info(`Filling username with selector: ${usernameSelector}`);
-            await page.fill(usernameSelector, loginConfig.loginUsername);
-            // Fill password
-            const passwordSelector = loginConfig.passwordSelector || '#pwd';
-            logger.info(`Filling password with selector: ${passwordSelector}`);
-            await page.fill(passwordSelector, loginConfig.loginPassword);
-            // Check agreement checkbox - using the specific selector
-            const agreementSelector = loginConfig.agreementSelector || '.policy_tip-checkbox';
-            logger.info(`Checking agreement with selector: ${agreementSelector}`);
-            await page.check(agreementSelector);
-            // Click login button - using the specific selector
-            const loginButtonSelector = loginConfig.loginButtonSelector || 'a.J_ping:has-text("同意协议并登录")';
-            logger.info(`Clicking login button with selector: ${loginButtonSelector}`);
-            await page.click(loginButtonSelector);
-            // Wait for login to complete
-            await new Promise(resolve => setTimeout(resolve, loginConfig.mobileMode ? 8000 : 5000));
-            // Check if login was successful
-            try {
-                const currentUrl = page.url();
-                if (currentUrl !== loginConfig.loginUrl && !currentUrl.includes('login')) {
-                    logger.info('Login appears to be successful');
-                }
-                else {
-                    logger.warn('Still on login page, login may have failed');
-                }
-            }
-            catch (e) {
-                logger.warn('Could not verify login status');
-            }
+            return typeof page?.url === 'function' ? page.url() : '';
+        }
+        catch {
+            return '';
+        }
+    }
+    async waitForWebPageStable(page) {
+        await page.waitForLoadState('domcontentloaded', { timeout: 5000 }).catch(() => undefined);
+        await page.waitForLoadState('networkidle', { timeout: 8000 }).catch(() => undefined);
+    }
+    async safeWebGoto(page, url, label) {
+        const targetUrl = this.normalizeWebUrl(url);
+        const currentUrl = this.normalizeWebUrl(this.getCurrentWebUrl(page));
+        if (currentUrl && targetUrl && currentUrl === targetUrl) {
+            logger.info(`${label}: already at target url, skip duplicate goto`);
+            await this.waitForWebPageStable(page);
+            return null;
+        }
+        try {
+            logger.info(`${label}: ${url}`);
+            const result = await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 45000 });
+            await page.waitForLoadState('networkidle', { timeout: 8000 }).catch(() => undefined);
+            return result;
         }
         catch (error) {
-            logger.error(`Web login failed: ${error.message}`);
-            throw new Error(`Web login failed: ${error.message}`);
+            const message = error.message || '';
+            const latestUrl = this.normalizeWebUrl(this.getCurrentWebUrl(page));
+            // 导航被中断/中止时，检查页面是否已到达目标 URL，若已到达则继续执行
+            const isAborted = message.includes('ERR_ABORTED') || message.includes('is interrupted by another navigation');
+            if (isAborted) {
+                // 短暂等待让页面重定向/跳转完成
+                await new Promise((r) => setTimeout(r, 1500));
+                const settledUrl = this.normalizeWebUrl(this.getCurrentWebUrl(page));
+                if (settledUrl && settledUrl === targetUrl) {
+                    logger.warn(`${label}: navigation aborted but page reached target url, continue`);
+                    await this.waitForWebPageStable(page);
+                    return null;
+                }
+                // URL 不完全匹配但导航被中止，可能是目标页面发生了重定向（登录回调等），
+                // 尝试重新导航一次
+                logger.warn(`${label}: navigation aborted, current=${settledUrl}, retrying goto`);
+                try {
+                    const retryResult = await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+                    await page.waitForLoadState('networkidle', { timeout: 8000 }).catch(() => undefined);
+                    return retryResult;
+                }
+                catch (retryError) {
+                    const retryMessage = retryError.message || '';
+                    const finalUrl = this.normalizeWebUrl(this.getCurrentWebUrl(page));
+                    // 重试后仍报错，但只要页面不在 about:blank 就继续
+                    if (finalUrl && finalUrl !== 'about:blank') {
+                        logger.warn(`${label}: retry goto also failed (${retryMessage.substring(0, 80)}), but page has content at ${finalUrl}, continue`);
+                        await this.waitForWebPageStable(page);
+                        return null;
+                    }
+                    throw retryError;
+                }
+            }
+            throw error;
         }
     }
     async handleExecuteWebAction(ws, request) {
@@ -1642,15 +1671,23 @@ export class DebugWebSocketServer {
                     };
                 }
                 else {
-                    // 桌面模式：走浏览器池，复用已 launch 的 Chromium
+                    // 桌面模式：每次执行独立启动 Chromium，结束后真正关闭，避免残留 Chrome 进程。
                     const contextOptions = {
                         viewport: request.viewport || { width: 1280, height: 800 },
                     };
-                    const acquired = await webBrowserPool.acquireContext(contextOptions);
-                    browser = acquired.browser;
-                    context = acquired.context;
+                    browser = await playwright.chromium.launch({ headless: false });
+                    context = await browser.newContext(contextOptions);
                     page = await context.newPage();
-                    releaseBrowser = acquired.release;
+                    releaseBrowser = async () => {
+                        try {
+                            await context.close();
+                        }
+                        catch { /* ignore */ }
+                        try {
+                            await browser.close();
+                        }
+                        catch { /* ignore */ }
+                    };
                 }
                 // mobileMode 下注入脚本，将 touchstart/touchmove/wheel 事件监听器设为 passive:false
                 // 修复部分移动端网页在 passive listener 中调用 preventDefault 导致点击失效的问题
@@ -1714,20 +1751,25 @@ export class DebugWebSocketServer {
             // 取出 agent / page
             const agent = session.webAgent;
             const page = session.page;
+            // 执行前检查浏览器和页面是否仍然存活，防止在已崩溃的浏览器上操作导致不明错误
+            const browserRef = session.browser;
+            if (browserRef && typeof browserRef.isConnected === 'function' && !browserRef.isConnected()) {
+                throw new Error('Browser has been disconnected before action execution. The browser process may have crashed or been killed.');
+            }
+            if (page && typeof page.isClosed === 'function' && page.isClosed()) {
+                throw new Error('Page has been closed before action execution. The browser context may have been terminated.');
+            }
             // 刷新 web session 活跃时间，避免 TTL 误杀
             this.touchWebSession(sessionId);
+            // 标记 web action 正在执行中，防止 TTL GC 或并发路径误关浏览器
+            session.webActionRunning = true;
             await executeWebLogin({
                 source: request,
                 page,
                 logPrefix: `[WebAction ${sessionId}]`,
             });
-            // 兼容旧版表单登录配置
-            if (request.loginConfig && request.loginConfig.loginUrl && request.loginConfig.loginUsername && request.loginConfig.loginPassword) {
-                const loginConfig = {
-                    ...request.loginConfig,
-                    mobileMode: request.mobileMode || false
-                };
-                await this.performWebLogin(page, loginConfig);
+            if (request.url && request.actionType !== 'goto') {
+                await this.safeWebGoto(page, request.url, `[WebAction] Navigate before action`);
             }
             // ===== 周期 dump（与移动端 handleExecuteAction 行为一致） =====
             const sendDump = (dump) => {
@@ -1765,6 +1807,8 @@ export class DebugWebSocketServer {
                             const intervalDump = agent.dumpDataString({ inlineScreenshots: false });
                             sendDump(intervalDump);
                         }
+                        // 每次 dump 周期刷新活跃时间，防止长时间 aiAct 操作期间被 TTL GC 误杀
+                        this.touchWebSession(sessionId);
                     }
                     catch (dumpError) {
                         logger.warn(`[WebAction] interval dump failed: ${dumpError.message}`);
@@ -1787,7 +1831,7 @@ export class DebugWebSocketServer {
                 case 'goto': {
                     if (!request.url)
                         throw new Error('goto requires url parameter');
-                    result = await page.goto(request.url, { waitUntil: 'networkidle' });
+                    result = await this.safeWebGoto(page, request.url, `[WebAction] goto`);
                     break;
                 }
                 case 'aiAction': {
@@ -1833,11 +1877,6 @@ export class DebugWebSocketServer {
                     const code = request.actionParams?.code || request.code || '';
                     if (!code)
                         throw new Error('runCode requires actionParams.code');
-                    // 如果提供了URL，先导航到指定页面
-                    if (request.url) {
-                        logger.info(`[WebAction] Navigating to URL before runCode: ${request.url}`);
-                        await page.goto(request.url, { waitUntil: 'networkidle' });
-                    }
                     // 行号探针：与真机 runCode 一致，通过 instrumentCode 在每条语句前插入 __lineCallback(line)，
                     // 推送 type='execution_line' 给前端，使 web 与真机调试体验一致
                     const onExecutionLine = (line) => {
@@ -2036,6 +2075,10 @@ export class DebugWebSocketServer {
             });
         }
         finally {
+            // 清除执行中标记，允许后续关闭浏览器
+            if (session) {
+                session.webActionRunning = false;
+            }
             // 不管成功还是失败，web 调试结束后必须关闭浏览器
             try {
                 await this.closeWebSession(sessionId);
@@ -2045,6 +2088,504 @@ export class DebugWebSocketServer {
             }
         }
     }
+    // ==================== Batch Action (逐条执行一批用例，支持 web / android / ios) ====================
+    batchAbortControllers = new Map();
+    async handleBatchAction(ws, request) {
+        const { batchId, cases, platform } = request;
+        if (!batchId || !Array.isArray(cases) || cases.length === 0) {
+            this.sendError(ws, 'batch_action requires batchId and non-empty cases array');
+            return;
+        }
+        // 创建 AbortController 用于取消批次
+        const abortController = new AbortController();
+        this.batchAbortControllers.set(batchId, abortController);
+        // 批次级别配置
+        const batchLoginContext = request.loginContext;
+        const batchModelConfig = request.modelConfig;
+        // 通知前端：批次开始
+        this.sendMessage(ws, {
+            type: 'batch_started',
+            batchId,
+            totalCases: cases.length,
+            platform,
+        });
+        const results = [];
+        // Web 相关状态
+        let browserLaunched = false;
+        let sharedSessionId = '';
+        try {
+            for (let i = 0; i < cases.length; i++) {
+                // 检查是否已取消
+                if (abortController.signal.aborted) {
+                    logger.info(`[BatchAction] Batch ${batchId} aborted, skipping remaining ${cases.length - i} cases`);
+                    break;
+                }
+                const tc = cases[i];
+                const caseLabel = `[Batch ${batchId} case ${i + 1}/${cases.length}] ${tc.id}${tc.title ? ` - ${tc.title}` : ''}`;
+                logger.info(`${caseLabel}: starting (platform=${platform})`);
+                // 通知前端：当前用例开始
+                this.sendMessage(ws, {
+                    type: 'batch_case_started',
+                    batchId,
+                    caseId: tc.id,
+                    caseIndex: i,
+                    totalCases: cases.length,
+                });
+                await this.postBatchCallback(request, `/test-batches/${encodeURIComponent(batchId)}/items/${encodeURIComponent(tc.id)}`, {
+                    status: 'running',
+                    caseIndex: i,
+                    totalCases: cases.length,
+                });
+                let caseSuccess = false;
+                let caseError;
+                let caseReportUrl;
+                let caseCaptureDataUrl;
+                let caseSessionId;
+                const caseStartedAt = Date.now();
+                try {
+                    if (platform === 'web') {
+                        // ============ Web 路径 ============
+                        const result = await this.executeBatchWebCase(ws, request, tc, i, caseLabel, batchLoginContext, batchModelConfig, sharedSessionId, browserLaunched);
+                        caseSuccess = result.success;
+                        caseError = result.error;
+                        caseReportUrl = result.reportUrl;
+                        caseCaptureDataUrl = result.captureDataUrl;
+                        caseSessionId = result.sessionId;
+                        sharedSessionId = result.sessionId;
+                        browserLaunched = result.browserLaunched;
+                    }
+                    else {
+                        // ============ App (Android/iOS) 路径 ============
+                        const result = await this.executeBatchAppCase(ws, request, tc, i, caseLabel, batchLoginContext, batchModelConfig);
+                        caseSuccess = result.success;
+                        caseError = result.error;
+                        caseReportUrl = result.reportUrl;
+                        caseCaptureDataUrl = result.captureDataUrl;
+                        caseSessionId = result.sessionId;
+                    }
+                    if (caseSuccess) {
+                        logger.info(`${caseLabel}: completed successfully`);
+                    }
+                }
+                catch (err) {
+                    caseError = err.message;
+                    caseSuccess = false;
+                    logger.warn(`${caseLabel}: failed - ${caseError}`);
+                }
+                const caseResult = {
+                    id: tc.id,
+                    success: caseSuccess,
+                    error: caseError,
+                    reportUrl: caseReportUrl,
+                    captureDataUrl: caseCaptureDataUrl,
+                };
+                results.push(caseResult);
+                // 通知前端：当前用例完成
+                this.sendMessage(ws, {
+                    type: 'batch_case_completed',
+                    batchId,
+                    caseId: tc.id,
+                    caseIndex: i,
+                    totalCases: cases.length,
+                    success: caseSuccess,
+                    error: caseError,
+                    reportUrl: caseReportUrl,
+                    captureDataUrl: caseCaptureDataUrl,
+                });
+                await this.postBatchCallback(request, `/test-batches/${encodeURIComponent(batchId)}/items/${encodeURIComponent(tc.id)}`, {
+                    status: caseSuccess ? 'completed' : 'failed',
+                    success: caseSuccess,
+                    error: caseError,
+                    reportUrl: caseReportUrl,
+                    captureDataUrl: caseCaptureDataUrl,
+                    sessionId: caseSessionId,
+                    deviceId: tc.deviceId || request.deviceId,
+                    durationMs: Date.now() - caseStartedAt,
+                });
+            }
+        }
+        finally {
+            // 清理 AbortController
+            this.batchAbortControllers.delete(batchId);
+            // 关闭浏览器（仅 web）
+            if (platform === 'web' && sharedSessionId && browserLaunched) {
+                try {
+                    await this.closeWebSession(sharedSessionId);
+                }
+                catch { /* ignore */ }
+            }
+            // 通知前端：批次完成
+            this.sendMessage(ws, {
+                type: 'batch_completed',
+                batchId,
+                totalCases: cases.length,
+                completedCases: results.length,
+                results,
+            });
+            await this.postBatchCallback(request, `/test-batches/${encodeURIComponent(batchId)}/finalize`, {
+                status: 'completed',
+                totalCases: cases.length,
+                completedCases: results.length,
+                results,
+            });
+        }
+    }
+    /** 批次执行 - 单条 Web 用例 */
+    async executeBatchWebCase(ws, request, tc, caseIndex, caseLabel, batchLoginContext, batchModelConfig, sharedSessionId, browserLaunched) {
+        // 构造单条 WebActionExecuteRequest
+        const webActionRequest = {
+            type: 'execute_web_action',
+            actionType: tc.actionType || 'aiAction',
+            url: tc.url || request.url,
+            naturalLanguage: tc.naturalLanguage,
+            actionParams: tc.actionParams,
+            sessionId: sharedSessionId || undefined,
+            mobileMode: request.mobileMode,
+            deviceName: request.deviceName,
+            viewport: request.viewport,
+            headless: request.headless,
+            screencast: request.screencast,
+            modelConfig: batchModelConfig,
+            loginContext: tc.loginContext || batchLoginContext,
+        };
+        let caseSuccess = false;
+        let caseError;
+        let caseReportUrl;
+        let caseCaptureDataUrl;
+        // 如果 freshBrowserPerCase 或首次执行，需要完整启动浏览器
+        if (!browserLaunched || request.freshBrowserPerCase) {
+            // 关闭之前的浏览器（如果有）
+            if (sharedSessionId && browserLaunched) {
+                try {
+                    await this.closeWebSession(sharedSessionId);
+                }
+                catch { /* ignore */ }
+            }
+            sharedSessionId = `batch-${request.batchId}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+            webActionRequest.sessionId = sharedSessionId;
+        }
+        else {
+            // 复用浏览器
+            webActionRequest.sessionId = sharedSessionId;
+        }
+        const sessionId = sharedSessionId;
+        const reportGroupName = tc.title || tc.id || `batch-${request.batchId}-case-${caseIndex + 1}`;
+        let session = sessionManager.get(sessionId);
+        const isNewSession = !session || !session.browser;
+        if (isNewSession) {
+            if (!session)
+                session = sessionManager.create(sessionId, ws);
+            session.platform = 'web';
+            // 并发上限保护
+            if (this.webSessionsActivity.size >= this.webSessionMaxConcurrency) {
+                throw new Error(`Web 调试会话数已达上限 (${this.webSessionMaxConcurrency})，请稍后重试`);
+            }
+            const playwright = await import('playwright');
+            const midscene = await import('@aiscene/web/playwright');
+            let browser;
+            let context;
+            let page;
+            let releaseBrowser = null;
+            if (request.mobileMode) {
+                const deviceName = request.deviceName || 'iPhone 13';
+                const deviceDescriptor = playwright.devices[deviceName];
+                browser = await playwright.chromium.launch({ headless: false });
+                if (deviceDescriptor) {
+                    context = await browser.newContext(deviceDescriptor);
+                }
+                else {
+                    context = await browser.newContext({
+                        viewport: { width: 375, height: 667 }, isMobile: true,
+                        hasTouch: true, deviceScaleFactor: 2,
+                        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.0 Mobile/15E148 Safari/604.1',
+                    });
+                }
+                page = await context.newPage();
+                releaseBrowser = async () => { try {
+                    await context.close();
+                }
+                catch { /* ignore */ } try {
+                    await browser.close();
+                }
+                catch { /* ignore */ } };
+            }
+            else {
+                browser = await playwright.chromium.launch({ headless: false });
+                context = await browser.newContext({ viewport: request.viewport || { width: 1280, height: 800 } });
+                page = await context.newPage();
+                releaseBrowser = async () => { try {
+                    await context.close();
+                }
+                catch { /* ignore */ } try {
+                    await browser.close();
+                }
+                catch { /* ignore */ } };
+            }
+            if (request.mobileMode) {
+                await page.addInitScript(() => {
+                    const origAdd = EventTarget.prototype.addEventListener;
+                    EventTarget.prototype.addEventListener = function (type, listener, options) {
+                        if (['touchstart', 'touchmove', 'wheel'].includes(type)) {
+                            if (typeof options === 'boolean')
+                                options = { capture: options, passive: false };
+                            else if (options && typeof options === 'object')
+                                options = { ...options, passive: false };
+                            else
+                                options = { passive: false };
+                        }
+                        return origAdd.call(this, type, listener, options);
+                    };
+                });
+            }
+            session.browser = browser;
+            session.context = context;
+            session.page = page;
+            session.releaseBrowser = releaseBrowser;
+            session.webAgent = new midscene.PlaywrightAgent(page, {
+                outputFormat: 'html-and-external-assets',
+                groupName: reportGroupName,
+                modelConfig: this.applyModelConfig(batchModelConfig),
+            });
+            this.registerWebSession(sessionId);
+            browserLaunched = true;
+            logger.info(`[BatchAction] Browser launched for session: ${sessionId}`);
+        }
+        // 确保 session 存在
+        if (!session)
+            throw new Error('Session not available');
+        // 复用时重建 agent（每条用例独立报告）
+        const midscene = await import('@aiscene/web/playwright');
+        session.webAgent = new midscene.PlaywrightAgent(session.page, {
+            outputFormat: 'html-and-external-assets',
+            groupName: reportGroupName,
+            modelConfig: this.applyModelConfig(batchModelConfig),
+        });
+        const agent = session.webAgent;
+        const page = session.page;
+        // 检查浏览器存活
+        const browserRef = session.browser;
+        if (browserRef && typeof browserRef.isConnected === 'function' && !browserRef.isConnected()) {
+            throw new Error('Browser has been disconnected');
+        }
+        if (page && typeof page.isClosed === 'function' && page.isClosed()) {
+            throw new Error('Page has been closed');
+        }
+        this.touchWebSession(sessionId);
+        session.webActionRunning = true;
+        // 执行登录（仅首条或 freshBrowserPerCase 时）
+        const effectiveLoginContext = tc.loginContext || batchLoginContext;
+        if (effectiveLoginContext && (caseIndex === 0 || request.freshBrowserPerCase || !request.loginContext)) {
+            await executeWebLogin({
+                source: { loginContext: effectiveLoginContext },
+                page,
+                logPrefix: caseLabel,
+            });
+        }
+        // 导航到目标URL
+        const targetUrl = tc.url || request.url;
+        if (targetUrl && webActionRequest.actionType !== 'goto') {
+            await this.safeWebGoto(page, targetUrl, `${caseLabel} Navigate`);
+        }
+        // 执行动作
+        const actionType = tc.actionType || 'aiAction';
+        if (actionType === 'aiAction' || actionType === 'aiAct') {
+            const text = tc.naturalLanguage || '';
+            if (!text)
+                throw new Error('aiAction requires naturalLanguage');
+            await agent.aiAct(text);
+        }
+        else if (actionType === 'goto') {
+            if (!targetUrl)
+                throw new Error('goto requires url');
+            await this.safeWebGoto(page, targetUrl, `${caseLabel} goto`);
+        }
+        else if (actionType === 'runCode') {
+            const code = tc.actionParams?.code || '';
+            if (!code)
+                throw new Error('runCode requires actionParams.code');
+            const AsyncFunctionCtor = async function () { }.constructor;
+            const ctx = {
+                agent, page,
+                sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+                nativeSwipe: (direction, duration) => playwrightSwipe(page, { direction, duration: duration || 300 }),
+                console: {
+                    log: (...args) => {
+                        sessionManager.addLog(sessionId, args.map(String).join(' '));
+                        this.sendMessage(ws, { type: 'log_output', sessionId, content: args.map(String).join(' ') });
+                    },
+                },
+            };
+            const fn = new AsyncFunctionCtor(code);
+            await fn.call(ctx);
+        }
+        caseSuccess = true;
+        // 提取报告
+        let reportFile = '';
+        try {
+            const sess = sessionManager.get(sessionId);
+            if (sess?.webAgent && typeof sess.webAgent.reportFile === 'string') {
+                reportFile = sess.webAgent.reportFile || '';
+            }
+        }
+        catch { /* ignore */ }
+        caseReportUrl = (await this.safeUploadReport(reportFile, `${request.batchId}-${tc.id}`)) ?? undefined;
+        // 停止抓包
+        try {
+            const capturedRequests = await whistleManager.stopCapture(sessionId);
+            if (capturedRequests.length > 0) {
+                const uploadResult = await this.saveAndUploadCaptureData(capturedRequests, `${request.batchId}-${tc.id}`);
+                if (uploadResult)
+                    caseCaptureDataUrl = uploadResult;
+            }
+        }
+        catch { /* ignore */ }
+        // 重置执行标记
+        const sess = sessionManager.get(sessionId);
+        if (sess)
+            sess.webActionRunning = false;
+        return { success: caseSuccess, error: caseError, reportUrl: caseReportUrl, captureDataUrl: caseCaptureDataUrl, sessionId, browserLaunched };
+    }
+    /** 批次执行 - 单条 App (Android/iOS) 用例 */
+    async executeBatchAppCase(ws, request, tc, caseIndex, caseLabel, batchLoginContext, batchModelConfig) {
+        const { platform, batchId } = request;
+        const effectiveDeviceId = tc.deviceId || request.deviceId;
+        const effectivePackageName = tc.packageName || request.packageName;
+        const effectiveBundleId = tc.bundleId || request.bundleId;
+        const effectiveLoginContext = tc.loginContext || batchLoginContext;
+        const caseSessionId = `batch-${batchId}-case-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        const session = sessionManager.create(caseSessionId, ws, effectiveDeviceId);
+        this.activeBatchSessionIds.add(caseSessionId);
+        const caseAbortController = new AbortController();
+        session.abortController = caseAbortController;
+        // 应用模型配置
+        const fullModelConfig = this.applyModelConfig(batchModelConfig);
+        let caseSuccess = false;
+        let caseError;
+        let caseReportUrl;
+        let caseCaptureDataUrl;
+        try {
+            sessionManager.updateStatus(caseSessionId, 'running');
+            // 执行 Android 登录
+            if (platform === 'android') {
+                await executeAndroidLogin({
+                    source: { loginContext: effectiveLoginContext },
+                    deviceId: effectiveDeviceId,
+                    platform,
+                    logPrefix: caseLabel,
+                });
+            }
+            // 创建 Executor
+            const executor = ExecutorFactory.create('action', {
+                sessionId: caseSessionId,
+                onLog: (msg) => {
+                    sessionManager.addLog(caseSessionId, msg);
+                    this.sendMessage(ws, { type: 'log_output', sessionId: caseSessionId, content: msg }, effectiveDeviceId);
+                },
+                onDump: (dump) => {
+                    this.sendMessage(ws, { type: 'action_dump', sessionId: caseSessionId, dump }, effectiveDeviceId);
+                },
+                onExecutionLine: (line) => {
+                    this.sendMessage(ws, { type: 'execution_line', sessionId: caseSessionId, line }, effectiveDeviceId);
+                },
+            });
+            session.executor = executor;
+            // 启动抓包
+            try {
+                await whistleManager.startCapture(caseSessionId, undefined, 3000, request.proxyAccount);
+                logger.info(`[BatchAction] Whistle capture started: sessionId=${caseSessionId}`);
+            }
+            catch (captureErr) {
+                logger.warn(`[BatchAction] Failed to start capture: ${captureErr.message}`);
+            }
+            // 构造 ExecuteConfig
+            const actionType = tc.actionType || 'aiAct';
+            const config = {
+                type: platform,
+                testName: tc.title || tc.id || `batch-${batchId}-case-${caseIndex + 1}`,
+                actionType,
+                naturalLanguage: tc.naturalLanguage,
+                locatePrompt: tc.actionParams?.locatePrompt,
+                actionParams: tc.actionParams,
+                udid: effectiveDeviceId,
+                packageName: effectivePackageName,
+                bundleId: effectiveBundleId,
+                modelConfig: fullModelConfig,
+                executionId: caseSessionId,
+                skipAppRestart: request.skipAppRestart,
+                proxyPort: request.proxyPort,
+                proxyAccount: request.proxyAccount,
+            };
+            // 使用 AbortSignal 监听停止
+            const executePromise = executor.execute(config);
+            const abortPromise = new Promise((resolve) => {
+                caseAbortController.signal.addEventListener('abort', () => {
+                    resolve({ success: false, errorMessage: 'Action stopped by user' });
+                }, { once: true });
+            });
+            const result = await Promise.race([executePromise, abortPromise]);
+            // 清理 executor
+            if (executor && typeof executor.destroy === 'function') {
+                try {
+                    await executor.destroy();
+                }
+                catch { /* ignore */ }
+            }
+            session.executor = undefined;
+            caseSuccess = result.success;
+            if (!result.success && result.errorMessage)
+                caseError = result.errorMessage;
+            // 上传报告
+            const reportFile = result.reportFile || '';
+            caseReportUrl = (await this.safeUploadReport(reportFile, `${batchId}-${tc.id}`)) ?? undefined;
+            // 停止抓包
+            try {
+                const capturedRequests = await whistleManager.stopCapture(caseSessionId);
+                if (capturedRequests.length > 0) {
+                    const uploadResult = await this.saveAndUploadCaptureData(capturedRequests, `${batchId}-${tc.id}`);
+                    if (uploadResult)
+                        caseCaptureDataUrl = uploadResult;
+                }
+            }
+            catch { /* ignore */ }
+        }
+        catch (err) {
+            caseError = err.message;
+            caseSuccess = false;
+            // 清理 executor
+            if (session.executor && typeof session.executor.destroy === 'function') {
+                try {
+                    await session.executor.destroy();
+                }
+                catch { /* ignore */ }
+            }
+            session.executor = undefined;
+        }
+        sessionManager.updateStatus(caseSessionId, caseSuccess ? 'completed' : 'failed');
+        this.activeBatchSessionIds.delete(caseSessionId);
+        try {
+            await this.cleanupSession(caseSessionId);
+        }
+        catch (cleanupError) {
+            logger.warn(`[BatchAction] Session cleanup failed: sessionId=${caseSessionId}, error=${cleanupError.message}`);
+        }
+        return { success: caseSuccess, error: caseError, reportUrl: caseReportUrl, captureDataUrl: caseCaptureDataUrl, sessionId: caseSessionId };
+    }
+    // ==================== Stop Batch ====================
+    async handleStopBatch(ws, request) {
+        const { batchId } = request;
+        const abortController = this.batchAbortControllers.get(batchId);
+        if (abortController) {
+            abortController.abort();
+            this.batchAbortControllers.delete(batchId);
+            this.sendMessage(ws, { type: 'batch_stopped', batchId });
+        }
+        else {
+            this.sendMessage(ws, {
+                type: 'error',
+                message: `No active batch found with id: ${batchId}`,
+            });
+        }
+    }
     // ==================== Start Screencast (for existing web session) ====================
     async handleStartScreencast(ws, request) {
         const session = sessionManager.get(request.sessionId);
@@ -2094,6 +2635,11 @@ export class DebugWebSocketServer {
         const session = sessionManager.get(sessionId);
         if (!session || !session.browser)
             return;
+        // 如果 web action 正在执行中，跳过关闭，防止 TTL GC 或其他并发路径误杀浏览器
+        if (session.webActionRunning) {
+            logger.warn(`[WebSession] Session ${sessionId} has running web action, skipping close to avoid race condition`);
+            return;
+        }
         // 停止周期 dump
         if (session.dumpIntervalId) {
             clearInterval(session.dumpIntervalId);
@@ -2378,6 +2924,31 @@ export class DebugWebSocketServer {
         logger.info(`[ModelConfig] Model config applied successfully`);
         return result;
     }
+    async postBatchCallback(request, pathName, payload) {
+        const baseUrl = request.callback?.baseUrl?.trim();
+        if (!baseUrl)
+            return;
+        try {
+            const relativePath = pathName.replace(/^\/+/, '');
+            const url = new URL(relativePath, baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`);
+            const headers = { 'Content-Type': 'application/json' };
+            const token = request.callback?.token?.trim();
+            if (token)
+                headers.Authorization = token.startsWith('Bearer ') ? token : `Bearer ${token}`;
+            const response = await fetch(url.toString(), {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                logger.warn(`[BatchAction] Callback failed: ${response.status} ${response.statusText}, path=${pathName}, body=${text.slice(0, 300)}`);
+            }
+        }
+        catch (error) {
+            logger.warn(`[BatchAction] Callback error: path=${pathName}, error=${error.message}`);
+        }
+    }
     sendMessage(ws, message, deviceId) {
         try {
             const msg = {