ms-vite-plugin 1.1.2 → 1.1.4

package/dist/mcp/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 设备连接配置结构
+ */
+export type DeviceConfig = {
+    /** 设备 IP 地址 */
+    ip: string;
+    /** 设备端口 */
+    port: number;
+    /** 最近更新时间戳（毫秒） */
+    updatedAt: number;
+};
+/**
+ * 文档语言类型
+ */
+export type ApiDocsLanguage = "js" | "js_zh" | "python";
+/**
+ * 文档条目结构
+ */
+export type ApiDocItem = {
+    /** 文档分类（即文件名，不含 .md） */
+    slug: string;
+    /** 文档标题（优先取首个 markdown 标题） */
+    title: string;
+    /** 文档全文 */
+    content: string;
+    /** 文档目录绝对路径 */
+    filePath: string;
+};
+/**
+ * 文档语言显示名映射
+ */
+export declare const DOC_LANGUAGE_LABELS: Record<ApiDocsLanguage, string>;

package/dist/mcp/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOC_LANGUAGE_LABELS = void 0;
+/**
+ * 文档语言显示名映射
+ */
+exports.DOC_LANGUAGE_LABELS = {
+    js: "JavaScript",
+    js_zh: "JavaScript (中文)",
+    python: "Python",
+};

package/dist/mcp-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/mcp-server.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fsExtra = __importStar(require("fs-extra"));
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const tools_1 = require("./mcp/tools");
+const device_config_1 = require("./mcp/device-config");
+/**
+ * 启动 MCP 服务（stdio）
+ * @returns 启动成功后常驻运行
+ * @example
+ * await main()
+ */
+async function main() {
+    const server = (0, tools_1.createMcpServer)();
+    const transport = new stdio_js_1.StdioServerTransport();
+    /**
+     * 进程退出时清理当前实例的临时配置文件，避免系统临时目录残留
+     * 注意：只清理“当前进程文件”，不会影响其他并发窗口实例
+     */
+    const cleanupConfigFile = async () => {
+        try {
+            await fsExtra.remove(device_config_1.DEVICE_CONFIG_FILE);
+        }
+        catch {
+            // 忽略清理错误，避免影响主流程退出
+        }
+    };
+    process.once("SIGINT", () => {
+        cleanupConfigFile()
+            .catch(() => undefined)
+            .finally(() => process.exit(0));
+    });
+    process.once("SIGTERM", () => {
+        cleanupConfigFile()
+            .catch(() => undefined)
+            .finally(() => process.exit(0));
+    });
+    process.once("exit", () => {
+        try {
+            fsExtra.removeSync(device_config_1.DEVICE_CONFIG_FILE);
+        }
+        catch {
+            // ignore
+        }
+    });
+    await server.connect(transport);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`MCP 服务启动失败: ${message}`);
+    process.exit(1);
+});

package/dist/project.d.ts

@@ -8,6 +8,95 @@ export interface DeviceCliOptions {
     wsPort?: string;
     wsWaitMs?: string;
 }
+/**
+ * 设备日志条目
+ */
+export interface DeviceLogEntry {
+    /** 日志级别，例如 debug/info/warn/error */
+    level: string;
+    /** 日志文本 */
+    message: string;
+    /** 日志时间戳（ISO 字符串） */
+    timestamp: string;
+}
+/**
+ * 运行时状态条目（来自 SSE runtime_status 事件）
+ */
+export interface DeviceRuntimeStatusEntry {
+    /** 原始 runtime_status 数据 */
+    raw: Record<string, unknown>;
+    /** 事件时间戳（本地接收时间） */
+    timestamp: string;
+}
+/**
+ * 设备日志判定项
+ */
+export interface DeviceLogFinding {
+    /** 严重级别 */
+    severity: "error" | "warn";
+    /** 命中的判定规则 */
+    rule: string;
+    /** 证据日志 */
+    log: DeviceLogEntry;
+}
+/**
+ * SSE 日志监听结果
+ */
+export interface DeviceLogWatchResult {
+    /** 收集到的日志条目 */
+    logs: DeviceLogEntry[];
+    /** 收集到的 runtime_status 条目 */
+    runtimeStatus: DeviceRuntimeStatusEntry[];
+    /** 自动判定结果 */
+    findings: DeviceLogFinding[];
+    /** 结果摘要 */
+    summary: string;
+}
+/**
+ * 在设备上获取截图 JPG 二进制数据（HTTP）
+ * @param options 命令选项（transport 仅支持 http）
+ * @returns 返回 JPG 二进制 Buffer
+ * @example
+ * const image = await getScreenshotOnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+export declare function getScreenshotOnDevice(options: DeviceCliOptions): Promise<Buffer>;
+/**
+ * 在设备上获取截图 Base64（HTTP）
+ * @param options 命令选项（transport 仅支持 http）
+ * @returns 返回截图 base64 字符串
+ * @example
+ * const b64 = await getScreenshotBase64OnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+export declare function getScreenshotBase64OnDevice(options: DeviceCliOptions): Promise<string>;
+/**
+ * 在设备上获取节点 XML（HTTP）
+ * @param options 命令选项（transport 仅支持 http）
+ * @param maxDepth 节点最大深度，默认 50
+ * @param timeout 获取节点超时秒数，默认 120
+ * @returns 返回 XML 字符串
+ * @example
+ * const xml = await getSourceOnDevice({ ip: "192.168.1.10", port: "9800" }, 50, 120)
+ */
+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 日志并返回自动判定结果
+ * @param ip 设备 IP 地址
+ * @param port 设备端口
+ * @param durationMs 监听时长（毫秒），默认 15000
+ * @param maxLogs 最多收集日志条数，默认 200
+ * @returns 返回日志、运行状态和判定结果
+ * @example
+ * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 10000, 100)
+ */
+export declare function watchDeviceLogsBySse(ip: string, port: number, durationMs?: number, maxLogs?: number): Promise<DeviceLogWatchResult>;
 /**
  * 在设备上运行项目（先同步后运行）
  * @param options 命令选项

package/dist/project.js

@@ -36,6 +36,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 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;
 exports.stopOnDevice = stopOnDevice;
@@ -364,6 +369,307 @@ async function requestDeviceAction(action, ip, port) {
         throw new Error(`${action} 失败，状态码: ${response.status}`);
     }
 }
+/**
+ * 在设备上获取截图 JPG 二进制数据（HTTP）
+ * @param options 命令选项（transport 仅支持 http）
+ * @returns 返回 JPG 二进制 Buffer
+ * @example
+ * const image = await getScreenshotOnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+async function getScreenshotOnDevice(options) {
+    const transport = parseTransport(options);
+    if (transport === "ws") {
+        await ensureWsReady(options);
+        const result = await ws_manager_1.WSManager.request("screenshot");
+        if (!result.success || typeof result.data !== "string") {
+            throw new Error(`截图失败: ${String(result.message ?? "unknown")}`);
+        }
+        return Buffer.from(result.data, "base64");
+    }
+    const { ip, port } = parseHttpOptions(options);
+    const url = `http://${ip}:${port}/api/screenshot`;
+    const response = await fetch(url, { method: "GET" });
+    if (!response.ok) {
+        throw new Error(`截图失败，状态码: ${response.status}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    return Buffer.from(arrayBuffer);
+}
+/**
+ * 在设备上获取截图 Base64（HTTP）
+ * @param options 命令选项（transport 仅支持 http）
+ * @returns 返回截图 base64 字符串
+ * @example
+ * const b64 = await getScreenshotBase64OnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+async function getScreenshotBase64OnDevice(options) {
+    const transport = parseTransport(options);
+    if (transport === "ws") {
+        await ensureWsReady(options);
+        const result = await ws_manager_1.WSManager.request("screenshot");
+        if (!result.success || typeof result.data !== "string") {
+            throw new Error(`截图(base64)失败: ${String(result.message ?? "unknown")}`);
+        }
+        return result.data;
+    }
+    const { ip, port } = parseHttpOptions(options);
+    const url = `http://${ip}:${port}/api/screenshotBase64`;
+    const response = await fetch(url, { method: "GET" });
+    if (!response.ok) {
+        throw new Error(`截图(base64)失败，状态码: ${response.status}`);
+    }
+    const payload = (await response.json());
+    if (!payload.success || typeof payload.data !== "string") {
+        throw new Error(`截图(base64)失败: ${String(payload.message ?? "unknown")}`);
+    }
+    return payload.data;
+}
+/**
+ * 在设备上获取节点 XML（HTTP）
+ * @param options 命令选项（transport 仅支持 http）
+ * @param maxDepth 节点最大深度，默认 50
+ * @param timeout 获取节点超时秒数，默认 120
+ * @returns 返回 XML 字符串
+ * @example
+ * const xml = await getSourceOnDevice({ ip: "192.168.1.10", port: "9800" }, 50, 120)
+ */
+async function getSourceOnDevice(options, maxDepth = 50, timeout = 120) {
+    const transport = parseTransport(options);
+    if (!Number.isInteger(maxDepth) || maxDepth < 1) {
+        throw new Error(`无效 maxDepth: ${maxDepth}`);
+    }
+    if (!Number.isInteger(timeout) || timeout < 1) {
+        throw new Error(`无效 timeout: ${timeout}`);
+    }
+    if (transport === "ws") {
+        await ensureWsReady(options);
+        const result = await ws_manager_1.WSManager.request("source", {
+            max_depth: maxDepth,
+            timeout,
+            maxDepth,
+        });
+        if (!result.success || typeof result.data !== "string") {
+            throw new Error(`获取节点失败: ${String(result.message ?? "unknown")}`);
+        }
+        return result.data;
+    }
+    const { ip, port } = parseHttpOptions(options);
+    const url = new URL(`http://${ip}:${port}/api/source`);
+    url.searchParams.set("max_depth", String(maxDepth));
+    url.searchParams.set("timeout", String(timeout));
+    const response = await fetch(url.toString(), { method: "GET" });
+    if (!response.ok) {
+        throw new Error(`获取节点失败，状态码: ${response.status}`);
+    }
+    return response.text();
+}
+/**
+ * 将 SSE 文本块解析为事件字段结构
+ * @param rawBlock 单个 SSE 事件文本块（以空行分隔）
+ * @returns 返回事件名与数据字符串
+ * @example
+ * parseSseEventBlock("event: log\ndata: {\"level\":\"info\"}")
+ */
+function parseSseEventBlock(rawBlock) {
+    const lines = rawBlock.split(/\r?\n/);
+    let eventName = "message";
+    const dataLines = [];
+    for (const line of lines) {
+        if (!line || line.startsWith(":")) {
+            continue;
+        }
+        if (line.startsWith("event:")) {
+            eventName = line.slice("event:".length).trim() || "message";
+            continue;
+        }
+        if (line.startsWith("data:")) {
+            dataLines.push(line.slice("data:".length).trimStart());
+        }
+    }
+    return {
+        event: eventName,
+        data: dataLines.join("\n"),
+    };
+}
+/**
+ * 将原始日志对象标准化为 DeviceLogEntry
+ * @param payload 日志原始对象
+ * @returns 返回标准化日志对象
+ * @example
+ * normalizeLogEntry({ level: "info", message: "ok", timestamp: "2026-01-01T00:00:00Z" })
+ */
+function normalizeLogEntry(payload) {
+    const levelText = String(payload.level ?? "info").toLowerCase();
+    const messageText = String(payload.message ?? "");
+    const timestampText = typeof payload.timestamp === "string" && payload.timestamp
+        ? payload.timestamp
+        : new Date().toISOString();
+    return {
+        level: levelText,
+        message: messageText,
+        timestamp: timestampText,
+    };
+}
+/**
+ * 基于关键字与日志级别做自动异常判定
+ * @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 日志并返回自动判定结果
+ * @param ip 设备 IP 地址
+ * @param port 设备端口
+ * @param durationMs 监听时长（毫秒），默认 15000
+ * @param maxLogs 最多收集日志条数，默认 200
+ * @returns 返回日志、运行状态和判定结果
+ * @example
+ * const result = await watchDeviceLogsBySse("192.168.1.10", 9800, 10000, 100)
+ */
+async function watchDeviceLogsBySse(ip, port, durationMs = 15000, maxLogs = 200) {
+    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) {
+        throw new Error(`监听日志失败: 无效 durationMs ${durationMs}`);
+    }
+    if (!Number.isInteger(maxLogs) || maxLogs < 1) {
+        throw new Error(`监听日志失败: 无效 maxLogs ${maxLogs}`);
+    }
+    const url = `http://${ip}:${port}/logger/sse`;
+    const logs = [];
+    const runtimeStatus = [];
+    const controller = new AbortController();
+    const timeoutHandle = setTimeout(() => {
+        controller.abort();
+    }, durationMs);
+    try {
+        const response = await fetch(url, {
+            method: "GET",
+            signal: controller.signal,
+            headers: {
+                Accept: "text/event-stream",
+            },
+        });
+        if (!response.ok || !response.body) {
+            throw new Error(`监听日志失败: ${response.status} ${response.statusText || "unknown"}`);
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder("utf-8");
+        let buffer = "";
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done) {
+                break;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            // SSE 事件以双换行分隔，这里逐块解析，避免半包解析错误
+            let splitIndex = buffer.search(/\r?\n\r?\n/);
+            while (splitIndex >= 0) {
+                const rawBlock = buffer.slice(0, splitIndex);
+                buffer = buffer.slice(splitIndex + (buffer[splitIndex] === "\r" ? 4 : 2));
+                const event = parseSseEventBlock(rawBlock);
+                if (event.data) {
+                    try {
+                        const parsed = JSON.parse(event.data);
+                        if (event.event === "log") {
+                            if (logs.length < maxLogs) {
+                                logs.push(normalizeLogEntry(parsed));
+                            }
+                        }
+                        else if (event.event === "runtime_status") {
+                            runtimeStatus.push({
+                                raw: parsed,
+                                timestamp: new Date().toISOString(),
+                            });
+                        }
+                    }
+                    catch {
+                        // 兼容非 JSON 数据：不抛错，继续监听后续事件
+                    }
+                }
+                if (logs.length >= maxLogs) {
+                    controller.abort();
+                    break;
+                }
+                splitIndex = buffer.search(/\r?\n\r?\n/);
+            }
+        }
+    }
+    catch (error) {
+        // 监听超时是预期行为，忽略 AbortError 并正常输出已采集日志
+        if (!(error instanceof Error &&
+            (error.name === "AbortError" ||
+                error.message === "The operation was aborted."))) {
+            throw error;
+        }
+    }
+    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,
+    };
+}
 /**
  * 通过 WS 发送设备动作请求
  * @param action 动作名称，支持 run、runUI、stop

package/dist/version.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 读取当前包版本号（自动定位 package.json）
+ * @param fallbackVersion 读取失败时回退版本号，默认 dev
+ * @returns 返回版本号字符串
+ * @example
+ * const version = readPackageVersion()
+ */
+export declare function readPackageVersion(fallbackVersion?: string): string;
+/**
+ * 当前包版本号（模块加载时读取）
+ */
+export declare const PACKAGE_VERSION: string;

package/dist/version.js

@@ -0,0 +1,63 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PACKAGE_VERSION = void 0;
+exports.readPackageVersion = readPackageVersion;
+const fsExtra = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+/**
+ * 读取当前包版本号（自动定位 package.json）
+ * @param fallbackVersion 读取失败时回退版本号，默认 dev
+ * @returns 返回版本号字符串
+ * @example
+ * const version = readPackageVersion()
+ */
+function readPackageVersion(fallbackVersion = "dev") {
+    try {
+        const packageJsonPath = path.resolve(__dirname, "..", "package.json");
+        const packageJson = fsExtra.readJSONSync(packageJsonPath);
+        if (typeof packageJson.version === "string" && packageJson.version.trim()) {
+            return packageJson.version.trim();
+        }
+    }
+    catch {
+        // ignore and fallback
+    }
+    return fallbackVersion;
+}
+/**
+ * 当前包版本号（模块加载时读取）
+ */
+exports.PACKAGE_VERSION = readPackageVersion();