ms-vite-plugin 1.1.5 → 1.1.7

package/dist/mcp/tools.js

@@ -302,6 +302,31 @@ function registerRuntimeTools(server) {
         await (0, project_2.ensureValidKuaiJSProject)(workspace);
         return workspace;
     }
+    /**
+     * 在后台启动一次日志监听，不阻塞 run/run_ui 调用返回
+     * @param ip 设备 IP
+     * @param port 设备端口
+     * @param durationSeconds 监听秒数
+     * @param maxLogs 最大日志条数
+     * @returns 返回监听目标说明文本
+     * @example
+     * const tip = startBackgroundLogWatch("192.168.1.10", 9800, 20, 300)
+     */
+    function startBackgroundLogWatch(ip, port, durationSeconds, maxLogs) {
+        const durationMs = durationSeconds > 0 ? durationSeconds * 1000 : 0;
+        void (0, project_1.watchDeviceLogsBySse)(ip, port, durationMs, maxLogs)
+            .then((result) => {
+            console.log(`[mcp] background logs ${ip}:${port} done, 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] background logs ${ip}:${port} failed: ${message}`);
+        });
+        if (durationSeconds === 0) {
+            return `已在后台启动持续日志监听: ${ip}:${port}（直到连接断开，max ${maxLogs}）`;
+        }
+        return `已在后台启动日志监听: ${ip}:${port}（${durationSeconds}s，max ${maxLogs}）`;
+    }
     /**
      * 解析运行目标：
      * - 显式 transport=ws: 强制走 ws
@@ -591,7 +616,7 @@ function registerRuntimeTools(server) {
     });
     server.registerTool("watch_logs", {
         title: "Watch Logs",
-        description: "通过 SSE 监听设备日志并自动判定异常。首次可传 ip，也可复用 set_device 保存的默认设备。",
+        description: "通过 SSE 监听设备实时日志。首次可传 ip，也可复用 set_device 保存的默认设备。",
         inputSchema: {
             workspacePath: z
                 .string()
@@ -613,11 +638,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()
@@ -631,10 +656,6 @@ function registerRuntimeTools(server) {
         await ensureWorkspacePath(workspacePath);
         const device = await (0, device_config_1.resolveDeviceConfig)(ip, port);
         const result = await (0, project_1.watchDeviceLogsBySse)(device.ip, device.port, durationSeconds * 1000, maxLogs);
-        const findingsPreview = result.findings
-            .slice(0, 20)
-            .map((item, index) => `${index + 1}. [${item.severity}] ${item.rule} | ${item.log.timestamp} | ${item.log.message}`)
-            .join("\n");
         const logsPreview = result.logs
             .slice(-20)
             .map((log) => `[${log.timestamp}] [${log.level.toUpperCase()}] ${log.message}`)
@@ -645,11 +666,8 @@ function registerRuntimeTools(server) {
                     type: "text",
                     text: [
                         `监听目标: ${device.ip}:${device.port}`,
-                        `监听时长: ${durationSeconds}s，收集日志: ${result.logs.length} 条，runtime_status: ${result.runtimeStatus.length} 条`,
-                        result.summary,
-                        "",
-                        "异常判定（最多展示前20条）:",
-                        findingsPreview || "未命中异常规则",
+                        `监听模式: ${durationSeconds === 0 ? "持续直到连接断开" : `${durationSeconds}s`}`,
+                        `结束原因: ${result.stopReason}，收集日志: ${result.logs.length} 条，runtime_status: ${result.runtimeStatus.length} 条`,
                         "",
                         "最新日志（最多展示最后20条）:",
                         logsPreview || "无日志",
@@ -737,9 +755,42 @@ function registerRuntimeTools(server) {
                 .min(1)
                 .optional()
                 .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
+            watchLogs: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("是否在运行前启动实时日志监听，默认 true"),
+            logDurationSeconds: z
+                .number()
+                .int()
+                .min(0)
+                .max(300)
+                .optional()
+                .default(0)
+                .describe("日志监听时长（秒），默认 0；0 表示持续监听直到 runtime_status 失败或连接断开"),
+            logMaxLogs: z
+                .number()
+                .int()
+                .min(10)
+                .max(5000)
+                .optional()
+                .default(300)
+                .describe("日志最大收集条数，默认 300"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath }) => {
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath, watchLogs, logDurationSeconds, logMaxLogs, }) => {
         const workspace = await ensureWorkspacePath(workspacePath);
+        let logNotice = "";
+        let logSetupWarning = "";
+        if (watchLogs) {
+            try {
+                const logDevice = await (0, device_config_1.resolveDeviceConfig)(ip, port);
+                // 先启动日志监听，再执行 run，且不等待日志结束，避免 run 被阻塞
+                logNotice = startBackgroundLogWatch(logDevice.ip, logDevice.port, logDurationSeconds, logMaxLogs);
+            }
+            catch (error) {
+                logSetupWarning = `日志监听未启动: ${error instanceof Error ? error.message : String(error)}`;
+            }
+        }
         const target = await resolvePreferredRuntimeTarget({
             transport,
             ip,
@@ -760,11 +811,16 @@ function registerRuntimeTools(server) {
                 transport: "http",
                 workspacePath: workspace,
             });
+        const logSection = logNotice
+            ? `\n\n${logNotice}`
+            : logSetupWarning
+                ? `\n\n${logSetupWarning}`
+                : "";
         return {
             content: [
                 {
                     type: "text",
-                    text: `运行请求已发送到 ${target.label}`,
+                    text: `运行请求已发送到 ${target.label}${logSection}`,
                 },
             ],
         };
@@ -808,9 +864,42 @@ function registerRuntimeTools(server) {
                 .min(1)
                 .optional()
                 .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
+            watchLogs: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("是否在预览前启动实时日志监听，默认 true"),
+            logDurationSeconds: z
+                .number()
+                .int()
+                .min(0)
+                .max(300)
+                .optional()
+                .default(0)
+                .describe("日志监听时长（秒），默认 0；0 表示持续监听直到 runtime_status 失败或连接断开"),
+            logMaxLogs: z
+                .number()
+                .int()
+                .min(10)
+                .max(5000)
+                .optional()
+                .default(300)
+                .describe("日志最大收集条数，默认 300"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath }) => {
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath, watchLogs, logDurationSeconds, logMaxLogs, }) => {
         const workspace = await ensureWorkspacePath(workspacePath);
+        let logNotice = "";
+        let logSetupWarning = "";
+        if (watchLogs) {
+            try {
+                const logDevice = await (0, device_config_1.resolveDeviceConfig)(ip, port);
+                // 先启动日志监听，再执行 run-ui，且不等待日志结束，避免 run-ui 被阻塞
+                logNotice = startBackgroundLogWatch(logDevice.ip, logDevice.port, logDurationSeconds, logMaxLogs);
+            }
+            catch (error) {
+                logSetupWarning = `日志监听未启动: ${error instanceof Error ? error.message : String(error)}`;
+            }
+        }
         const target = await resolvePreferredRuntimeTarget({
             transport,
             ip,
@@ -831,11 +920,16 @@ function registerRuntimeTools(server) {
                 transport: "http",
                 workspacePath: workspace,
             });
+        const logSection = logNotice
+            ? `\n\n${logNotice}`
+            : logSetupWarning
+                ? `\n\n${logSetupWarning}`
+                : "";
         return {
             content: [
                 {
                     type: "text",
-                    text: `UI 预览请求已发送到 ${target.label}`,
+                    text: `UI 预览请求已发送到 ${target.label}${logSection}`,
                 },
             ],
         };

package/dist/project.d.ts

@@ -29,17 +29,6 @@ export interface DeviceRuntimeStatusEntry {
     /** 事件时间戳（本地接收时间） */
     timestamp: string;
 }
-/**
- * 设备日志判定项
- */
-export interface DeviceLogFinding {
-    /** 严重级别 */
-    severity: "error" | "warn";
-    /** 命中的判定规则 */
-    rule: string;
-    /** 证据日志 */
-    log: DeviceLogEntry;
-}
 /**
  * SSE 日志监听结果
  */
@@ -48,10 +37,8 @@ export interface DeviceLogWatchResult {
     logs: DeviceLogEntry[];
     /** 收集到的 runtime_status 条目 */
     runtimeStatus: DeviceRuntimeStatusEntry[];
-    /** 自动判定结果 */
-    findings: DeviceLogFinding[];
-    /** 结果摘要 */
-    summary: string;
+    /** 监听结束原因 */
+    stopReason: "timeout" | "stream_closed" | "manual_abort" | "unknown";
 }
 /**
  * 在设备上获取截图 JPG 二进制数据（HTTP）
@@ -80,22 +67,14 @@ export declare function getScreenshotBase64OnDevice(options: DeviceCliOptions):
  */
 export declare function getSourceOnDevice(options: DeviceCliOptions, maxDepth?: number, timeout?: number): Promise<string>;
 /**
- * 基于关键字与日志级别做自动异常判定
- * @param logs 待判定日志列表
- * @returns 返回判定命中项
- * @example
- * const findings = analyzeDeviceLogs([{ level: "error", message: "crash", timestamp: "..." }])
- */
-export declare function analyzeDeviceLogs(logs: DeviceLogEntry[]): DeviceLogFinding[];
-/**
- * 监听设备 SSE 日志并返回自动判定结果
+ * 监听设备 SSE 日志并返回原始结果
  * @param ip 设备 IP 地址
  * @param port 设备端口
- * @param durationMs 监听时长（毫秒），默认 15000
+ * @param durationMs 监听时长（毫秒），默认 15000；传 0 表示不设超时，持续监听
  * @param maxLogs 最多收集日志条数，默认 200
- * @returns 返回日志、运行状态和判定结果
+ * @returns 返回日志与运行状态
  * @example
- * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 10000, 100)
+ * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 0, 300)
  */
 export declare function watchDeviceLogsBySse(ip: string, port: number, durationMs?: number, maxLogs?: number): Promise<DeviceLogWatchResult>;
 /**

package/dist/project.js

@@ -39,7 +39,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getScreenshotOnDevice = getScreenshotOnDevice;
 exports.getScreenshotBase64OnDevice = getScreenshotBase64OnDevice;
 exports.getSourceOnDevice = getSourceOnDevice;
-exports.analyzeDeviceLogs = analyzeDeviceLogs;
 exports.watchDeviceLogsBySse = watchDeviceLogsBySse;
 exports.runOnDevice = runOnDevice;
 exports.runUIOnDevice = runUIOnDevice;
@@ -511,67 +510,14 @@ function normalizeLogEntry(payload) {
     };
 }
 /**
- * 基于关键字与日志级别做自动异常判定
- * @param logs 待判定日志列表
- * @returns 返回判定命中项
- * @example
- * const findings = analyzeDeviceLogs([{ level: "error", message: "crash", timestamp: "..." }])
- */
-function analyzeDeviceLogs(logs) {
-    const findings = [];
-    const criticalPatterns = [
-        { rule: "崩溃关键词", regex: /\b(crash|fatal|abort|sigabrt|segfault)\b/i },
-        {
-            rule: "异常关键词",
-            regex: /\b(exception|uncaught|assert|error:|failed|failure)\b/i,
-        },
-        {
-            rule: "内存风险关键词",
-            regex: /\b(out of memory|oom|memory leak|allocation failed)\b/i,
-        },
-        {
-            rule: "设备离线关键词",
-            regex: /\b(timeout|disconnected|connection reset|network error)\b/i,
-        },
-    ];
-    for (const log of logs) {
-        const level = log.level.toLowerCase();
-        const message = log.message;
-        if (level === "error") {
-            findings.push({
-                severity: "error",
-                rule: "error 级别日志",
-                log,
-            });
-        }
-        else if (level === "warn") {
-            findings.push({
-                severity: "warn",
-                rule: "warn 级别日志",
-                log,
-            });
-        }
-        for (const pattern of criticalPatterns) {
-            if (pattern.regex.test(message)) {
-                findings.push({
-                    severity: level === "error" ? "error" : "warn",
-                    rule: pattern.rule,
-                    log,
-                });
-            }
-        }
-    }
-    return findings;
-}
-/**
- * 监听设备 SSE 日志并返回自动判定结果
+ * 监听设备 SSE 日志并返回原始结果
  * @param ip 设备 IP 地址
  * @param port 设备端口
- * @param durationMs 监听时长（毫秒），默认 15000
+ * @param durationMs 监听时长（毫秒），默认 15000；传 0 表示不设超时，持续监听
  * @param maxLogs 最多收集日志条数，默认 200
- * @returns 返回日志、运行状态和判定结果
+ * @returns 返回日志与运行状态
  * @example
- * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 10000, 100)
+ * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 0, 300)
  */
 async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200) {
     if (!ip.trim()) {
@@ -580,7 +526,7 @@ async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200)
     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) {
@@ -590,9 +536,13 @@ 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";
+    const timeoutHandle = durationMs > 0
+        ? setTimeout(() => {
+            stopReason = "timeout";
+            controller.abort();
+        }, durationMs)
+        : undefined;
     try {
         const response = await fetch(url, {
             method: "GET",
@@ -610,6 +560,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 });
@@ -623,11 +576,16 @@ 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(),
@@ -638,10 +596,6 @@ async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200)
                         // 兼容非 JSON 数据：不抛错，继续监听后续事件
                     }
                 }
-                if (logs.length >= maxLogs) {
-                    controller.abort();
-                    break;
-                }
                 splitIndex = buffer.search(/\r?\n\r?\n/);
             }
         }
@@ -653,21 +607,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);
-    }
-    const findings = analyzeDeviceLogs(logs);
-    const errorCount = findings.filter((item) => item.severity === "error").length;
-    const warnCount = findings.filter((item) => item.severity === "warn").length;
-    const summary = findings.length === 0
-        ? `日志监听完成：共 ${logs.length} 条日志，未发现明显异常。`
-        : `日志监听完成：共 ${logs.length} 条日志，发现 ${errorCount} 条 error 风险、${warnCount} 条 warn 风险。`;
+        if (timeoutHandle) {
+            clearTimeout(timeoutHandle);
+        }
+    }
     return {
         logs,
         runtimeStatus,
-        findings,
-        summary,
+        stopReason,
     };
 }
 /**

package/package.json

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