ms-vite-plugin 1.1.4 → 1.1.6

package/dist/mcp/tools.js

@@ -269,6 +269,57 @@ function registerDocTools(server) {
  * registerRuntimeTools(server)
  */
 function registerRuntimeTools(server) {
+    /**
+     * MCP 进程内当前工作目录（可通过 set_workspace 修改）
+     */
+    let currentWorkspacePath;
+    /**
+     * 解析并记忆工作目录
+     * @param workspacePath 可选的工作目录
+     * @returns 返回本次生效的绝对路径
+     * @example
+     * const workspace = resolveWorkspacePath("/Users/demo/project")
+     */
+    function resolveWorkspacePath(workspacePath) {
+        if (workspacePath && workspacePath.trim()) {
+            currentWorkspacePath = path.resolve(workspacePath.trim());
+            return currentWorkspacePath;
+        }
+        if (currentWorkspacePath) {
+            return currentWorkspacePath;
+        }
+        return process.cwd();
+    }
+    /**
+     * 校验并返回有效工作目录
+     * @param workspacePath 可选工作目录
+     * @returns 返回校验通过的绝对路径
+     * @example
+     * const workspace = await ensureWorkspacePath("/Users/demo/project")
+     */
+    async function ensureWorkspacePath(workspacePath) {
+        const workspace = resolveWorkspacePath(workspacePath);
+        await (0, project_2.ensureValidKuaiJSProject)(workspace);
+        return workspace;
+    }
+    /**
+     * 格式化日志监听结果，供 run/run_ui 结果文本复用
+     * @param result 日志监听结果
+     * @returns 返回可直接拼接到 tool 响应中的文本
+     * @example
+     * const text = formatWatchLogsResult(result)
+     */
+    function formatWatchLogsResult(result) {
+        const logsPreview = result.logs
+            .slice(-10)
+            .map((log) => `[${log.timestamp}] [${log.level.toUpperCase()}] ${log.message}`)
+            .join("\n");
+        return [
+            `日志监听: 收集 ${result.logs.length} 条，runtime_status ${result.runtimeStatus.length} 条`,
+            "最新日志（后10条）:",
+            logsPreview || "无日志",
+        ].join("\n");
+    }
     /**
      * 解析运行目标：
      * - 显式 transport=ws: 强制走 ws
@@ -306,6 +357,41 @@ function registerRuntimeTools(server) {
             label: `${device.ip}:${device.port}`,
         };
     }
+    server.registerTool("set_workspace", {
+        title: "Set Workspace",
+        description: "设置默认工作目录。后续 build/run/package/watch 等工具会优先使用该目录。",
+        inputSchema: {
+            workspacePath: z
+                .string()
+                .min(1)
+                .describe("快点JS 项目目录绝对路径（需包含 package.json 与 scripts）"),
+        },
+    }, async ({ workspacePath }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `默认工作目录已设置为: ${workspace}`,
+                },
+            ],
+        };
+    });
+    server.registerTool("get_workspace", {
+        title: "Get Workspace",
+        description: "查看当前 MCP 生效的工作目录。",
+        inputSchema: {},
+    }, async () => {
+        const workspace = resolveWorkspacePath();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `当前工作目录: ${workspace}`,
+                },
+            ],
+        };
+    });
     server.registerTool("set_device", {
         title: "Set Device",
         description: "设置默认设备连接信息。首次配置后，后续 run/stop 可不再传 ip。",
@@ -523,8 +609,13 @@ function registerRuntimeTools(server) {
     });
     server.registerTool("watch_logs", {
         title: "Watch Logs",
-        description: "通过 SSE 监听设备日志并自动判定异常。首次可传 ip，也可复用 set_device 保存的默认设备。",
+        description: "通过 SSE 监听设备实时日志。首次可传 ip，也可复用 set_device 保存的默认设备。",
         inputSchema: {
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
             ip: z
                 .string()
                 .min(1)
@@ -554,14 +645,10 @@ function registerRuntimeTools(server) {
                 .default(200)
                 .describe("最多收集日志条数，默认 200"),
         },
-    }, async ({ ip, port, durationSeconds, maxLogs }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
+    }, async ({ workspacePath, ip, port, durationSeconds, maxLogs }) => {
+        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}`)
@@ -573,10 +660,6 @@ function registerRuntimeTools(server) {
                     text: [
                         `监听目标: ${device.ip}:${device.port}`,
                         `监听时长: ${durationSeconds}s，收集日志: ${result.logs.length} 条，runtime_status: ${result.runtimeStatus.length} 条`,
-                        result.summary,
-                        "",
-                        "异常判定（最多展示前20条）:",
-                        findingsPreview || "未命中异常规则",
                         "",
                         "最新日志（最多展示最后20条）:",
                         logsPreview || "无日志",
@@ -589,14 +672,19 @@ function registerRuntimeTools(server) {
         title: "Build Project",
         description: "构建 KuaiJS 项目，支持开发模式与生产模式。",
         inputSchema: {
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
             dev: z
                 .boolean()
                 .optional()
                 .describe("是否开发模式构建，true=开发模式，false=生产模式"),
         },
-    }, async ({ dev }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
-        await (0, build_1.buildAll)(Boolean(dev), process.cwd());
+    }, async ({ workspacePath, dev }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
+        await (0, build_1.buildAll)(Boolean(dev), workspace);
         return {
             content: [
                 { type: "text", text: `构建完成，模式: ${dev ? "dev" : "prod"}` },
@@ -606,10 +694,16 @@ function registerRuntimeTools(server) {
     server.registerTool("package_project", {
         title: "Package Project",
         description: "执行生产构建并加密，返回 enc.msbundle 路径。",
-        inputSchema: {},
-    }, async () => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
-        const encryptedPath = await (0, packager_1.packageProject)(process.cwd());
+        inputSchema: {
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
+        },
+    }, async ({ workspacePath }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
+        const encryptedPath = await (0, packager_1.packageProject)(workspace);
         return {
             content: [{ type: "text", text: `打包完成: ${encryptedPath}` }],
         };
@@ -648,9 +742,49 @@ function registerRuntimeTools(server) {
                 .max(600000)
                 .optional()
                 .describe("WS 等待连接超时毫秒（transport=ws 时可选，默认 30000）"),
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
+            watchLogs: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("是否在运行前启动实时日志监听，默认 true"),
+            logDurationSeconds: z
+                .number()
+                .int()
+                .min(1)
+                .max(300)
+                .optional()
+                .default(20)
+                .describe("日志监听时长（秒），默认 20"),
+            logMaxLogs: z
+                .number()
+                .int()
+                .min(10)
+                .max(5000)
+                .optional()
+                .default(300)
+                .describe("日志最大收集条数，默认 300"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath, watchLogs, logDurationSeconds, logMaxLogs, }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
+        let logTask;
+        let logTargetText = "";
+        let logSetupWarning = "";
+        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);
+            }
+            catch (error) {
+                logSetupWarning = `日志监听未启动: ${error instanceof Error ? error.message : String(error)}`;
+            }
+        }
         const target = await resolvePreferredRuntimeTarget({
             transport,
             ip,
@@ -663,17 +797,24 @@ function registerRuntimeTools(server) {
                 transport: "ws",
                 wsPort: target.wsPort,
                 wsWaitMs: target.wsWaitMs,
+                workspacePath: workspace,
             }
             : {
                 ip: target.ip,
                 port: target.port,
                 transport: "http",
+                workspacePath: workspace,
             });
+        const logSection = logTask
+            ? `\n\n运行前日志监听目标: ${logTargetText}\n${formatWatchLogsResult(await logTask)}`
+            : logSetupWarning
+                ? `\n\n${logSetupWarning}`
+                : "";
         return {
             content: [
                 {
                     type: "text",
-                    text: `运行请求已发送到 ${target.label}`,
+                    text: `运行请求已发送到 ${target.label}${logSection}`,
                 },
             ],
         };
@@ -712,9 +853,49 @@ function registerRuntimeTools(server) {
                 .max(600000)
                 .optional()
                 .describe("WS 等待连接超时毫秒（transport=ws 时可选，默认 30000）"),
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
+            watchLogs: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("是否在预览前启动实时日志监听，默认 true"),
+            logDurationSeconds: z
+                .number()
+                .int()
+                .min(1)
+                .max(300)
+                .optional()
+                .default(20)
+                .describe("日志监听时长（秒），默认 20"),
+            logMaxLogs: z
+                .number()
+                .int()
+                .min(10)
+                .max(5000)
+                .optional()
+                .default(300)
+                .describe("日志最大收集条数，默认 300"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath, watchLogs, logDurationSeconds, logMaxLogs, }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
+        let logTask;
+        let logTargetText = "";
+        let logSetupWarning = "";
+        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);
+            }
+            catch (error) {
+                logSetupWarning = `日志监听未启动: ${error instanceof Error ? error.message : String(error)}`;
+            }
+        }
         const target = await resolvePreferredRuntimeTarget({
             transport,
             ip,
@@ -727,17 +908,24 @@ function registerRuntimeTools(server) {
                 transport: "ws",
                 wsPort: target.wsPort,
                 wsWaitMs: target.wsWaitMs,
+                workspacePath: workspace,
             }
             : {
                 ip: target.ip,
                 port: target.port,
                 transport: "http",
+                workspacePath: workspace,
             });
+        const logSection = logTask
+            ? `\n\n预览前日志监听目标: ${logTargetText}\n${formatWatchLogsResult(await logTask)}`
+            : logSetupWarning
+                ? `\n\n${logSetupWarning}`
+                : "";
         return {
             content: [
                 {
                     type: "text",
-                    text: `UI 预览请求已发送到 ${target.label}`,
+                    text: `UI 预览请求已发送到 ${target.label}${logSection}`,
                 },
             ],
         };
@@ -776,9 +964,14 @@ function registerRuntimeTools(server) {
                 .max(600000)
                 .optional()
                 .describe("WS 等待连接超时毫秒（transport=ws 时可选，默认 30000）"),
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath }) => {
+        resolveWorkspacePath(workspacePath);
         const target = await resolvePreferredRuntimeTarget({
             transport,
             ip,

package/dist/project.d.ts

@@ -7,6 +7,7 @@ export interface DeviceCliOptions {
     transport?: string;
     wsPort?: string;
     wsWaitMs?: string;
+    workspacePath?: string;
 }
 /**
  * 设备日志条目
@@ -28,17 +29,6 @@ export interface DeviceRuntimeStatusEntry {
     /** 事件时间戳（本地接收时间） */
     timestamp: string;
 }
-/**
- * 设备日志判定项
- */
-export interface DeviceLogFinding {
-    /** 严重级别 */
-    severity: "error" | "warn";
-    /** 命中的判定规则 */
-    rule: string;
-    /** 证据日志 */
-    log: DeviceLogEntry;
-}
 /**
  * SSE 日志监听结果
  */
@@ -47,10 +37,6 @@ export interface DeviceLogWatchResult {
     logs: DeviceLogEntry[];
     /** 收集到的 runtime_status 条目 */
     runtimeStatus: DeviceRuntimeStatusEntry[];
-    /** 自动判定结果 */
-    findings: DeviceLogFinding[];
-    /** 结果摘要 */
-    summary: string;
 }
 /**
  * 在设备上获取截图 JPG 二进制数据（HTTP）
@@ -79,20 +65,12 @@ 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 maxLogs 最多收集日志条数，默认 200
- * @returns 返回日志、运行状态和判定结果
+ * @returns 返回日志与运行状态
  * @example
  * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 10000, 100)
  */

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,65 +510,12 @@ 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 maxLogs 最多收集日志条数，默认 200
- * @returns 返回日志、运行状态和判定结果
+ * @returns 返回日志与运行状态
  * @example
  * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 10000, 100)
  */
@@ -657,17 +603,9 @@ async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200)
     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 风险。`;
     return {
         logs,
         runtimeStatus,
-        findings,
-        summary,
     };
 }
 /**
@@ -709,7 +647,9 @@ async function ensureWsReady(options) {
  * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
  */
 async function runOnDevice(options) {
-    const workspacePath = process.cwd();
+    const workspacePath = options.workspacePath
+        ? path.resolve(options.workspacePath)
+        : process.cwd();
     const transport = parseTransport(options);
     console.log(`🔧 开始构建项目: ${workspacePath}`);
     await runDevBuild(workspacePath);
@@ -737,7 +677,9 @@ async function runOnDevice(options) {
  * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
  */
 async function runUIOnDevice(options) {
-    const workspacePath = process.cwd();
+    const workspacePath = options.workspacePath
+        ? path.resolve(options.workspacePath)
+        : process.cwd();
     const transport = parseTransport(options);
     console.log(`🔧 开始构建项目: ${workspacePath}`);
     await runDevBuild(workspacePath);

package/package.json

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