ms-vite-plugin 1.1.6 → 1.1.8

package/dist/mcp/tools.js

@@ -303,23 +303,63 @@ function registerRuntimeTools(server) {
         return workspace;
     }
     /**
-     * 格式化日志监听结果，供 run/run_ui 结果文本复用
+     * 格式化运行期日志结果（供 run/run_ui 直接回传）
+     * @param ip 设备 IP
+     * @param port 设备端口
+     * @param durationSeconds 监听秒数
      * @param result 日志监听结果
-     * @returns 返回可直接拼接到 tool 响应中的文本
+     * @returns 可拼接到 tool 响应的文本
      * @example
-     * const text = formatWatchLogsResult(result)
+     * const text = formatRunLogSection("192.168.1.10", 9800, 10, result)
      */
-    function formatWatchLogsResult(result) {
+    function formatRunLogSection(ip, port, durationSeconds, result) {
         const logsPreview = result.logs
-            .slice(-10)
+            .slice(-20)
             .map((log) => `[${log.timestamp}] [${log.level.toUpperCase()}] ${log.message}`)
             .join("\n");
         return [
-            `日志监听: 收集 ${result.logs.length} 条，runtime_status ${result.runtimeStatus.length} 条`,
-            "最新日志（后10条）:",
+            `启动期日志窗口: ${durationSeconds}s（${ip}:${port}）`,
+            `结束原因: ${result.stopReason}，日志: ${result.logs.length} 条，runtime_status: ${result.runtimeStatus.length} 条`,
+            "最新日志（最多展示最后20条）:",
             logsPreview || "无日志",
         ].join("\n");
     }
+    /**
+     * 提取最后一次 runtime_status 的 isRunning 值
+     * @param result 日志监听结果
+     * @returns 返回 true/false，无法判断时返回 undefined
+     * @example
+     * const running = getLatestIsRunning(result)
+     */
+    function getLatestIsRunning(result) {
+        for (let i = result.runtimeStatus.length - 1; i >= 0; i -= 1) {
+            const raw = result.runtimeStatus[i].raw;
+            if (typeof raw.isRunning === "boolean") {
+                return raw.isRunning;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * 启动持续日志监听（后台，不阻塞当前 tool 返回）
+     * @param ip 设备 IP
+     * @param port 设备端口
+     * @param maxLogs 日志环形缓冲上限
+     * @returns 返回提示文本
+     * @example
+     * const tip = startBackgroundContinuousLogWatch("192.168.1.10", 9800, 300)
+     */
+    function startBackgroundContinuousLogWatch(ip, port, maxLogs) {
+        void (0, project_1.watchDeviceLogsBySse)(ip, port, 0, maxLogs, false)
+            .then((result) => {
+            console.log(`[mcp] continuous logs ${ip}:${port} ended, reason=${result.stopReason}, logs=${result.logs.length}, runtime_status=${result.runtimeStatus.length}`);
+        })
+            .catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`[mcp] continuous logs ${ip}:${port} failed: ${message}`);
+        });
+        return `已切换为持续日志监听: ${ip}:${port}（直到连接断开，max ${maxLogs}）`;
+    }
     /**
      * 解析运行目标：
      * - 显式 transport=ws: 强制走 ws
@@ -631,11 +671,11 @@ function registerRuntimeTools(server) {
             durationSeconds: z
                 .number()
                 .int()
-                .min(1)
+                .min(0)
                 .max(300)
                 .optional()
                 .default(15)
-                .describe("监听时长（秒），默认 15 秒，最大 300 秒"),
+                .describe("监听时长（秒），默认 15 秒；传 0 表示持续监听直到连接断开"),
             maxLogs: z
                 .number()
                 .int()
@@ -659,7 +699,8 @@ function registerRuntimeTools(server) {
                     type: "text",
                     text: [
                         `监听目标: ${device.ip}:${device.port}`,
-                        `监听时长: ${durationSeconds}s，收集日志: ${result.logs.length} 条，runtime_status: ${result.runtimeStatus.length} 条`,
+                        `监听模式: ${durationSeconds === 0 ? "持续直到连接断开" : `${durationSeconds}s`}`,
+                        `结束原因: ${result.stopReason}，收集日志: ${result.logs.length} 条，runtime_status: ${result.runtimeStatus.length} 条`,
                         "",
                         "最新日志（最多展示最后20条）:",
                         logsPreview || "无日志",
@@ -752,14 +793,19 @@ function registerRuntimeTools(server) {
                 .optional()
                 .default(true)
                 .describe("是否在运行前启动实时日志监听，默认 true"),
+            logMode: z
+                .enum(["auto", "single", "continuous"])
+                .optional()
+                .default("auto")
+                .describe("日志模式：auto=单次优先并自动判长任务，single=按 runtime_status 收敛，continuous=持续监听"),
             logDurationSeconds: z
                 .number()
                 .int()
                 .min(1)
                 .max(300)
                 .optional()
-                .default(20)
-                .describe("日志监听时长（秒），默认 20"),
+                .default(10)
+                .describe("日志监听时长（秒），默认 10，用于回传 run 启动期实时输出"),
             logMaxLogs: z
                 .number()
                 .int()
@@ -769,17 +815,25 @@ function registerRuntimeTools(server) {
                 .default(300)
                 .describe("日志最大收集条数，默认 300"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath, watchLogs, logDurationSeconds, logMaxLogs, }) => {
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath, watchLogs, logMode, logDurationSeconds, logMaxLogs, }) => {
         const workspace = await ensureWorkspacePath(workspacePath);
-        let logTask;
-        let logTargetText = "";
+        let logPromise;
+        let logDeviceIp = "";
+        let logDevicePort = 0;
         let logSetupWarning = "";
+        let logModeNotice = "";
         if (watchLogs) {
             try {
                 const logDevice = await (0, device_config_1.resolveDeviceConfig)(ip, port);
-                logTargetText = `${logDevice.ip}:${logDevice.port}`;
-                // 先启动日志监听，再执行 run，确保不会错过启动期日志
-                logTask = (0, project_1.watchDeviceLogsBySse)(logDevice.ip, logDevice.port, logDurationSeconds * 1000, logMaxLogs);
+                // 先挂监听，再执行 run，确保拿到启动期实时日志
+                logDeviceIp = logDevice.ip;
+                logDevicePort = logDevice.port;
+                if (logMode === "continuous") {
+                    logModeNotice = startBackgroundContinuousLogWatch(logDevice.ip, logDevice.port, logMaxLogs);
+                }
+                else {
+                    logPromise = (0, project_1.watchDeviceLogsBySse)(logDevice.ip, logDevice.port, logDurationSeconds * 1000, logMaxLogs, logMode === "single" || logMode === "auto");
+                }
             }
             catch (error) {
                 logSetupWarning = `日志监听未启动: ${error instanceof Error ? error.message : String(error)}`;
@@ -805,11 +859,26 @@ function registerRuntimeTools(server) {
                 transport: "http",
                 workspacePath: workspace,
             });
-        const logSection = logTask
-            ? `\n\n运行前日志监听目标: ${logTargetText}\n${formatWatchLogsResult(await logTask)}`
-            : logSetupWarning
-                ? `\n\n${logSetupWarning}`
-                : "";
+        let logSection = "";
+        if (logPromise) {
+            const result = await logPromise;
+            const sections = [
+                formatRunLogSection(logDeviceIp, logDevicePort, logDurationSeconds, result),
+            ];
+            if (logMode === "auto") {
+                const latestIsRunning = getLatestIsRunning(result);
+                if (result.stopReason === "timeout" && latestIsRunning === true) {
+                    sections.push(startBackgroundContinuousLogWatch(logDeviceIp, logDevicePort, logMaxLogs));
+                }
+            }
+            logSection = `\n\n${sections.join("\n")}`;
+        }
+        else if (logModeNotice) {
+            logSection = `\n\n${logModeNotice}`;
+        }
+        else if (logSetupWarning) {
+            logSection = `\n\n${logSetupWarning}`;
+        }
         return {
             content: [
                 {
@@ -863,14 +932,19 @@ function registerRuntimeTools(server) {
                 .optional()
                 .default(true)
                 .describe("是否在预览前启动实时日志监听，默认 true"),
+            logMode: z
+                .enum(["auto", "single", "continuous"])
+                .optional()
+                .default("auto")
+                .describe("日志模式：auto=单次优先并自动判长任务，single=按 runtime_status 收敛，continuous=持续监听"),
             logDurationSeconds: z
                 .number()
                 .int()
                 .min(1)
                 .max(300)
                 .optional()
-                .default(20)
-                .describe("日志监听时长（秒），默认 20"),
+                .default(10)
+                .describe("日志监听时长（秒），默认 10，用于回传 run-ui 启动期实时输出"),
             logMaxLogs: z
                 .number()
                 .int()
@@ -880,17 +954,25 @@ function registerRuntimeTools(server) {
                 .default(300)
                 .describe("日志最大收集条数，默认 300"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath, watchLogs, logDurationSeconds, logMaxLogs, }) => {
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath, watchLogs, logMode, logDurationSeconds, logMaxLogs, }) => {
         const workspace = await ensureWorkspacePath(workspacePath);
-        let logTask;
-        let logTargetText = "";
+        let logPromise;
+        let logDeviceIp = "";
+        let logDevicePort = 0;
         let logSetupWarning = "";
+        let logModeNotice = "";
         if (watchLogs) {
             try {
                 const logDevice = await (0, device_config_1.resolveDeviceConfig)(ip, port);
-                logTargetText = `${logDevice.ip}:${logDevice.port}`;
-                // 先启动日志监听，再执行 run-ui，确保不会错过启动期日志
-                logTask = (0, project_1.watchDeviceLogsBySse)(logDevice.ip, logDevice.port, logDurationSeconds * 1000, logMaxLogs);
+                // 先挂监听，再执行 run-ui，确保拿到启动期实时日志
+                logDeviceIp = logDevice.ip;
+                logDevicePort = logDevice.port;
+                if (logMode === "continuous") {
+                    logModeNotice = startBackgroundContinuousLogWatch(logDevice.ip, logDevice.port, logMaxLogs);
+                }
+                else {
+                    logPromise = (0, project_1.watchDeviceLogsBySse)(logDevice.ip, logDevice.port, logDurationSeconds * 1000, logMaxLogs, logMode === "single" || logMode === "auto");
+                }
             }
             catch (error) {
                 logSetupWarning = `日志监听未启动: ${error instanceof Error ? error.message : String(error)}`;
@@ -916,11 +998,26 @@ function registerRuntimeTools(server) {
                 transport: "http",
                 workspacePath: workspace,
             });
-        const logSection = logTask
-            ? `\n\n预览前日志监听目标: ${logTargetText}\n${formatWatchLogsResult(await logTask)}`
-            : logSetupWarning
-                ? `\n\n${logSetupWarning}`
-                : "";
+        let logSection = "";
+        if (logPromise) {
+            const result = await logPromise;
+            const sections = [
+                formatRunLogSection(logDeviceIp, logDevicePort, logDurationSeconds, result),
+            ];
+            if (logMode === "auto") {
+                const latestIsRunning = getLatestIsRunning(result);
+                if (result.stopReason === "timeout" && latestIsRunning === true) {
+                    sections.push(startBackgroundContinuousLogWatch(logDeviceIp, logDevicePort, logMaxLogs));
+                }
+            }
+            logSection = `\n\n${sections.join("\n")}`;
+        }
+        else if (logModeNotice) {
+            logSection = `\n\n${logModeNotice}`;
+        }
+        else if (logSetupWarning) {
+            logSection = `\n\n${logSetupWarning}`;
+        }
         return {
             content: [
                 {

package/dist/project.d.ts

@@ -37,6 +37,8 @@ export interface DeviceLogWatchResult {
     logs: DeviceLogEntry[];
     /** 收集到的 runtime_status 条目 */
     runtimeStatus: DeviceRuntimeStatusEntry[];
+    /** 监听结束原因 */
+    stopReason: "timeout" | "runtime_stopped" | "stream_closed" | "manual_abort" | "unknown";
 }
 /**
  * 在设备上获取截图 JPG 二进制数据（HTTP）
@@ -68,13 +70,14 @@ export declare function getSourceOnDevice(options: DeviceCliOptions, maxDepth?:
  * 监听设备 SSE 日志并返回原始结果
  * @param ip 设备 IP 地址
  * @param port 设备端口
- * @param durationMs 监听时长（毫秒），默认 15000
+ * @param durationMs 监听时长（毫秒），默认 15000；传 0 表示不设超时，持续监听
  * @param maxLogs 最多收集日志条数，默认 200
+ * @param stopOnRuntimeStopped 若为 true，则在运行状态从 true 回落到 false 后结束监听
  * @returns 返回日志与运行状态
  * @example
- * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 10000, 100)
+ * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 30000, 300, true)
  */
-export declare function watchDeviceLogsBySse(ip: string, port: number, durationMs?: number, maxLogs?: number): Promise<DeviceLogWatchResult>;
+export declare function watchDeviceLogsBySse(ip: string, port: number, durationMs?: number, maxLogs?: number, stopOnRuntimeStopped?: boolean): Promise<DeviceLogWatchResult>;
 /**
  * 在设备上运行项目（先同步后运行）
  * @param options 命令选项

package/dist/project.js

@@ -513,20 +513,21 @@ function normalizeLogEntry(payload) {
  * 监听设备 SSE 日志并返回原始结果
  * @param ip 设备 IP 地址
  * @param port 设备端口
- * @param durationMs 监听时长（毫秒），默认 15000
+ * @param durationMs 监听时长（毫秒），默认 15000；传 0 表示不设超时，持续监听
  * @param maxLogs 最多收集日志条数，默认 200
+ * @param stopOnRuntimeStopped 若为 true，则在运行状态从 true 回落到 false 后结束监听
  * @returns 返回日志与运行状态
  * @example
- * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 10000, 100)
+ * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 30000, 300, true)
  */
-async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200) {
+async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200, stopOnRuntimeStopped = false) {
     if (!ip.trim()) {
         throw new Error("监听日志失败: 设备 IP 不能为空");
     }
     if (!Number.isInteger(port) || port < 1 || port > 65535) {
         throw new Error(`监听日志失败: 无效端口 ${port}`);
     }
-    if (!Number.isInteger(durationMs) || durationMs < 1000) {
+    if (!Number.isInteger(durationMs) || durationMs < 0) {
         throw new Error(`监听日志失败: 无效 durationMs ${durationMs}`);
     }
     if (!Number.isInteger(maxLogs) || maxLogs < 1) {
@@ -536,9 +537,14 @@ async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200)
     const logs = [];
     const runtimeStatus = [];
     const controller = new AbortController();
-    const timeoutHandle = setTimeout(() => {
-        controller.abort();
-    }, durationMs);
+    let stopReason = "unknown";
+    let seenRunningStatus = false;
+    const timeoutHandle = durationMs > 0
+        ? setTimeout(() => {
+            stopReason = "timeout";
+            controller.abort();
+        }, durationMs)
+        : undefined;
     try {
         const response = await fetch(url, {
             method: "GET",
@@ -556,6 +562,9 @@ async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200)
         while (true) {
             const { value, done } = await reader.read();
             if (done) {
+                if (stopReason === "unknown") {
+                    stopReason = "stream_closed";
+                }
                 break;
             }
             buffer += decoder.decode(value, { stream: true });
@@ -569,25 +578,36 @@ async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200)
                     try {
                         const parsed = JSON.parse(event.data);
                         if (event.event === "log") {
-                            if (logs.length < maxLogs) {
-                                logs.push(normalizeLogEntry(parsed));
+                            // 日志缓冲使用环形窗口，持续监听时不会无限增长
+                            if (logs.length >= maxLogs) {
+                                logs.shift();
                             }
+                            logs.push(normalizeLogEntry(parsed));
                         }
                         else if (event.event === "runtime_status") {
+                            if (runtimeStatus.length >= maxLogs) {
+                                runtimeStatus.shift();
+                            }
                             runtimeStatus.push({
                                 raw: parsed,
                                 timestamp: new Date().toISOString(),
                             });
+                            if (parsed.isRunning === true) {
+                                seenRunningStatus = true;
+                            }
+                            if (stopOnRuntimeStopped &&
+                                seenRunningStatus &&
+                                parsed.isRunning === false) {
+                                stopReason = "runtime_stopped";
+                                controller.abort();
+                                break;
+                            }
                         }
                     }
                     catch {
                         // 兼容非 JSON 数据：不抛错，继续监听后续事件
                     }
                 }
-                if (logs.length >= maxLogs) {
-                    controller.abort();
-                    break;
-                }
                 splitIndex = buffer.search(/\r?\n\r?\n/);
             }
         }
@@ -599,13 +619,19 @@ async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200)
                 error.message === "The operation was aborted."))) {
             throw error;
         }
+        if (stopReason === "unknown") {
+            stopReason = "manual_abort";
+        }
     }
     finally {
-        clearTimeout(timeoutHandle);
+        if (timeoutHandle) {
+            clearTimeout(timeoutHandle);
+        }
     }
     return {
         logs,
         runtimeStatus,
+        stopReason,
     };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {