ms-vite-plugin 1.0.2 → 1.0.3

package/dist/project.js

@@ -0,0 +1,478 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runOnDevice = runOnDevice;
+exports.runUIOnDevice = runUIOnDevice;
+exports.stopOnDevice = stopOnDevice;
+const fsExtra = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const build_1 = require("./build");
+const crc_1 = __importDefault(require("crc"));
+const ws_manager_1 = require("./ws-manager");
+/**
+ * 读取并校验设备连接参数
+ * @param options 命令选项
+ * @returns 返回标准化后的设备地址信息
+ * @example
+ * parseHttpOptions({ ip: "192.168.1.10", port: "9800" })
+ */
+function parseHttpOptions(options) {
+    const ip = options.ip?.trim();
+    const portText = (options.port ?? "9800").trim();
+    const port = Number.parseInt(portText, 10);
+    if (!ip) {
+        throw new Error("请通过 --ip 指定设备 IP 地址");
+    }
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`无效端口: ${portText}`);
+    }
+    return { ip, port };
+}
+/**
+ * 解析 WS 服务参数
+ * @param options 命令选项
+ * @returns 返回 wsPort 与等待设备连接超时时间
+ * @example
+ * parseWsOptions({ wsPort: "31111", wsWaitMs: "30000" })
+ */
+function parseWsOptions(options) {
+    const wsPortText = (options.wsPort ?? "31111").trim();
+    const wsWaitText = (options.wsWaitMs ?? "30000").trim();
+    const wsPort = Number.parseInt(wsPortText, 10);
+    const wsWaitMs = Number.parseInt(wsWaitText, 10);
+    if (!Number.isInteger(wsPort) || wsPort < 1 || wsPort > 65535) {
+        throw new Error(`无效 ws 端口: ${wsPortText}`);
+    }
+    if (!Number.isInteger(wsWaitMs) || wsWaitMs < 1) {
+        throw new Error(`无效 ws 等待时间: ${wsWaitText}`);
+    }
+    return { wsPort, wsWaitMs };
+}
+/**
+ * 解析传输方式
+ * @param options 命令选项
+ * @returns 返回 http 或 ws
+ * @example
+ * parseTransport({ transport: "ws" })
+ */
+function parseTransport(options) {
+    const transport = (options.transport ?? "http").trim().toLowerCase();
+    if (transport !== "http" && transport !== "ws") {
+        throw new Error(`无效 transport: ${transport}`);
+    }
+    return transport;
+}
+/**
+ * 计算文件的 CRC32 值
+ * @param filePath 文件路径
+ * @returns CRC32 十六进制字符串（8位）
+ * @example
+ * await calculateCrc32("/tmp/a.txt")
+ */
+async function calculateCrc32(filePath) {
+    const fileBuffer = await fsExtra.readFile(filePath);
+    const crc32 = crc_1.default.crc32(fileBuffer);
+    return crc32.toString(16).padStart(8, "0");
+}
+/**
+ * 递归收集目录中的所有文件
+ * @param rootDir 需要遍历的根目录
+ * @param bundlePrefix 输出到设备时的目录前缀
+ * @returns 返回可同步文件列表（含 size 与 crc32）
+ * @example
+ * await collectFilesInDir("/tmp/project/ui", "ui")
+ */
+async function collectFilesInDir(rootDir, bundlePrefix) {
+    const files = [];
+    async function walk(dir) {
+        const entries = await fsExtra.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                const relPath = path.relative(rootDir, fullPath).replace(/\\/g, "/");
+                const stat = await fsExtra.stat(fullPath);
+                files.push({
+                    path: fullPath,
+                    bundlePath: `${bundlePrefix}/${relPath}`,
+                    size: stat.size,
+                    crc32: await calculateCrc32(fullPath),
+                });
+            }
+        }
+    }
+    if (await fsExtra.pathExists(rootDir)) {
+        await walk(rootDir);
+    }
+    return files;
+}
+/**
+ * 读取项目运行所需的元信息
+ * @param workspacePath 项目根目录
+ * @returns 返回 projectName、appVersion 与 packageJsonPath
+ * @example
+ * await getProjectMeta("/Users/demo/project")
+ */
+async function getProjectMeta(workspacePath) {
+    const packageJsonPath = path.join(workspacePath, "package.json");
+    const packageJson = await fsExtra.readJSON(packageJsonPath);
+    const projectName = packageJson.name;
+    const appVersion = packageJson.appVersion;
+    if (!projectName) {
+        throw new Error("请在 package.json 中添加 name 字段");
+    }
+    if (!appVersion) {
+        throw new Error("请在 package.json 中添加 appVersion 字段");
+    }
+    return { projectName, appVersion, packageJsonPath };
+}
+/**
+ * 收集运行前需要同步的文件
+ * @param workspacePath 项目根目录
+ * @returns 返回项目文件清单（含 size 与 crc32）
+ * @example
+ * await collectProjectFiles("/Users/demo/project")
+ */
+async function collectProjectFiles(workspacePath) {
+    let scriptPath = path.join(workspacePath, "dist", "scripts");
+    const isPy = await fsExtra.pathExists(path.join(workspacePath, "scripts", "main.py"));
+    if (isPy) {
+        scriptPath = path.join(workspacePath, "scripts");
+    }
+    const uiPath = path.join(workspacePath, "ui");
+    const resPath = path.join(workspacePath, "res");
+    const packageJsonPath = path.join(workspacePath, "package.json");
+    const files = [
+        {
+            path: packageJsonPath,
+            bundlePath: "package.json",
+            size: (await fsExtra.stat(packageJsonPath)).size,
+            crc32: await calculateCrc32(packageJsonPath),
+        },
+    ];
+    const [scriptFiles, uiFiles, resFiles] = await Promise.all([
+        collectFilesInDir(scriptPath, "scripts"),
+        collectFilesInDir(uiPath, "ui"),
+        collectFilesInDir(resPath, "res"),
+    ]);
+    files.push(...scriptFiles, ...uiFiles, ...resFiles);
+    return files;
+}
+/**
+ * 执行项目构建（使用 build.ts 的 dev 模式）
+ * @param workspacePath 项目根目录
+ * @returns 构建成功时返回 Promise<void>
+ * @example
+ * await runDevBuild("/Users/demo/project")
+ */
+async function runDevBuild(workspacePath) {
+    await (0, build_1.buildAll)(true, workspacePath);
+}
+/**
+ * 获取设备上的文件列表
+ * @param ip 设备 IP 地址
+ * @param port 设备端口
+ * @param projectName 项目名称
+ * @returns 设备当前文件信息列表
+ * @example
+ * await listDeviceFiles("192.168.1.10", 9800, "demo")
+ */
+async function listDeviceFiles(ip, port, projectName) {
+    const url = new URL(`http://${ip}:${port}/api/files`);
+    url.searchParams.set("projectName", projectName);
+    const response = await fetch(url.toString(), { method: "GET" });
+    if (!response.ok) {
+        throw new Error(`文件列表请求失败: ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return Array.isArray(data) ? data : [];
+}
+/**
+ * 通过 WS 获取设备上的文件列表
+ * @param projectName 项目名称
+ * @returns 设备当前文件信息列表
+ * @example
+ * await listDeviceFilesByWs("demo")
+ */
+async function listDeviceFilesByWs(projectName) {
+    const result = await ws_manager_1.WSManager.request("files", { projectName });
+    if (!result.success) {
+        throw new Error(`文件列表请求失败: ${String(result.message ?? "unknown")}`);
+    }
+    const data = result.data;
+    return Array.isArray(data) ? data : [];
+}
+/**
+ * 将项目文件增量同步到设备
+ * @param workspacePath 项目根目录
+ * @param ip 设备 IP 地址
+ * @param port 设备端口
+ * @returns 同步完成后返回 Promise<void>
+ * @example
+ * await syncProjectToDevice("/Users/demo/project", "192.168.1.10", 9800)
+ */
+async function syncProjectToDevice(workspacePath, ip, port) {
+    const { projectName, appVersion } = await getProjectMeta(workspacePath);
+    console.log("🔎 正在获取设备文件列表...");
+    const deviceFiles = await listDeviceFiles(ip, port, projectName);
+    const deviceFileMap = new Map(deviceFiles.map((file) => [file.path, file]));
+    console.log("📂 正在分析项目文件...");
+    const files = await collectProjectFiles(workspacePath);
+    const filesToSync = [];
+    for (const file of files) {
+        const deviceFile = deviceFileMap.get(file.bundlePath);
+        const requireSyncFile = file.bundlePath.includes("main.js") ||
+            file.bundlePath.includes("main.py");
+        if (!deviceFile) {
+            filesToSync.push(file);
+            continue;
+        }
+        const changed = deviceFile.size !== file.size ||
+            deviceFile.crc32.toLowerCase() !== file.crc32.toLowerCase();
+        if (requireSyncFile || changed) {
+            filesToSync.push(file);
+        }
+    }
+    console.log(`📦 发现 ${filesToSync.length} 个文件需要同步`);
+    if (filesToSync.length === 0) {
+        console.log("✅ 无需同步文件");
+        return;
+    }
+    let syncedCount = 0;
+    for (const file of filesToSync) {
+        syncedCount += 1;
+        console.log(`⬆️  [${syncedCount}/${filesToSync.length}] 同步 ${file.bundlePath}`);
+        const binary = await fsExtra.readFile(file.path);
+        const url = new URL(`http://${ip}:${port}/debug/patchSync`);
+        url.searchParams.set("path", file.bundlePath);
+        url.searchParams.set("projectName", projectName);
+        url.searchParams.set("appVersion", appVersion);
+        const response = await fetch(url.toString(), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/octet-stream",
+            },
+            body: binary,
+        });
+        if (!response.ok) {
+            throw new Error(`同步失败: ${file.bundlePath} (状态码: ${response.status})`);
+        }
+    }
+    console.log(`✅ 同步完成，共 ${filesToSync.length} 个文件`);
+}
+/**
+ * 通过 WS 将项目文件增量同步到设备
+ * @param workspacePath 项目根目录
+ * @returns 同步完成后返回 Promise<void>
+ * @example
+ * await syncProjectToDeviceByWs("/Users/demo/project")
+ */
+async function syncProjectToDeviceByWs(workspacePath) {
+    const { projectName, appVersion } = await getProjectMeta(workspacePath);
+    console.log("🔎 正在获取设备文件列表...");
+    const deviceFiles = await listDeviceFilesByWs(projectName);
+    const deviceFileMap = new Map(deviceFiles.map((file) => [file.path, file]));
+    console.log("📂 正在分析项目文件...");
+    const files = await collectProjectFiles(workspacePath);
+    const filesToSync = [];
+    for (const file of files) {
+        const deviceFile = deviceFileMap.get(file.bundlePath);
+        const requireSyncFile = file.bundlePath.includes("main.js") ||
+            file.bundlePath.includes("main.py");
+        if (!deviceFile) {
+            filesToSync.push(file);
+            continue;
+        }
+        const changed = deviceFile.size !== file.size ||
+            deviceFile.crc32.toLowerCase() !== file.crc32.toLowerCase();
+        if (requireSyncFile || changed) {
+            filesToSync.push(file);
+        }
+    }
+    console.log(`📦 发现 ${filesToSync.length} 个文件需要同步`);
+    if (filesToSync.length === 0) {
+        console.log("✅ 无需同步文件");
+        return;
+    }
+    let syncedCount = 0;
+    for (const file of filesToSync) {
+        syncedCount += 1;
+        console.log(`⬆️  [${syncedCount}/${filesToSync.length}] 同步 ${file.bundlePath}`);
+        const binary = await fsExtra.readFile(file.path);
+        const result = await ws_manager_1.WSManager.request("patchSync", {
+            path: file.bundlePath,
+            data: binary.toString("base64"),
+            projectName,
+            appVersion,
+        });
+        if (!result.success) {
+            throw new Error(`同步失败: ${file.bundlePath} ${String(result.message ?? "")}`);
+        }
+    }
+    console.log(`✅ 同步完成，共 ${filesToSync.length} 个文件`);
+}
+/**
+ * 发送设备动作请求
+ * @param action 动作名称，支持 run 与 stop
+ * @param ip 设备 IP 地址
+ * @param port 设备端口
+ * @returns 请求成功时返回 Promise<void>
+ * @example
+ * await requestDeviceAction("stop", "192.168.1.10", 9800)
+ */
+async function requestDeviceAction(action, ip, port) {
+    const url = `http://${ip}:${port}/api/${action}`;
+    const response = await fetch(url, { method: "GET" });
+    if (!response.ok) {
+        throw new Error(`${action} 失败，状态码: ${response.status}`);
+    }
+}
+/**
+ * 通过 WS 发送设备动作请求
+ * @param action 动作名称，支持 run、runUI、stop
+ * @returns 请求成功时返回 Promise<void>
+ * @example
+ * await requestDeviceActionByWs("run")
+ */
+async function requestDeviceActionByWs(action) {
+    const result = await ws_manager_1.WSManager.request(action);
+    if (!result.success) {
+        throw new Error(`${action} 失败: ${String(result.message ?? "unknown")}`);
+    }
+}
+/**
+ * 确保 WS 服务可用并已连接设备
+ * @param options 命令选项
+ * @returns 返回 Promise<void>
+ * @example
+ * await ensureWsReady({ wsPort: "31111", wsWaitMs: "30000" })
+ */
+async function ensureWsReady(options) {
+    const { wsPort, wsWaitMs } = parseWsOptions(options);
+    const ws = ws_manager_1.WSManager.get();
+    if (!ws.isStarted()) {
+        await ws.start(wsPort);
+    }
+    if (!ws_manager_1.WSManager.isConnected()) {
+        console.log("⌛ 等待设备通过 WS 连接...");
+        await ws.waitForClient(wsWaitMs);
+    }
+}
+/**
+ * 在设备上运行项目（先同步后运行）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+async function runOnDevice(options) {
+    const workspacePath = options.path
+        ? path.resolve(options.path)
+        : process.cwd();
+    const transport = parseTransport(options);
+    console.log(`🔧 开始构建项目: ${workspacePath}`);
+    await runDevBuild(workspacePath);
+    if (transport === "ws") {
+        await ensureWsReady(options);
+        console.log("📦 开始通过 WS 同步项目到设备");
+        await syncProjectToDeviceByWs(workspacePath);
+        console.log("🚀 开始通过 WS 运行项目");
+        await requestDeviceActionByWs("run");
+        console.log("✅ 运行请求已发送");
+        return;
+    }
+    const { ip, port } = parseHttpOptions(options);
+    console.log(`📦 开始同步项目到设备: ${ip}:${port}`);
+    await syncProjectToDevice(workspacePath, ip, port);
+    console.log(`🚀 开始运行项目: ${ip}:${port}`);
+    await requestDeviceAction("run", ip, port);
+    console.log("✅ 运行请求已发送");
+}
+/**
+ * 在设备上预览 UI（先同步后调用 runUI）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+async function runUIOnDevice(options) {
+    const workspacePath = options.path
+        ? path.resolve(options.path)
+        : process.cwd();
+    const transport = parseTransport(options);
+    console.log(`🔧 开始构建项目: ${workspacePath}`);
+    await runDevBuild(workspacePath);
+    if (transport === "ws") {
+        await ensureWsReady(options);
+        console.log("📦 开始通过 WS 同步项目到设备");
+        await syncProjectToDeviceByWs(workspacePath);
+        console.log("🖼️ 开始通过 WS 预览 UI");
+        await requestDeviceActionByWs("runUI");
+        console.log("✅ UI 预览请求已发送");
+        return;
+    }
+    const { ip, port } = parseHttpOptions(options);
+    console.log(`📦 开始同步项目到设备: ${ip}:${port}`);
+    await syncProjectToDevice(workspacePath, ip, port);
+    console.log(`🖼️ 开始预览 UI: ${ip}:${port}`);
+    await requestDeviceAction("runUI", ip, port);
+    console.log("✅ UI 预览请求已发送");
+}
+/**
+ * 停止设备上的项目
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+async function stopOnDevice(options) {
+    const transport = parseTransport(options);
+    if (transport === "ws") {
+        await ensureWsReady(options);
+        console.log("🛑 开始通过 WS 停止项目");
+        await requestDeviceActionByWs("stop");
+        console.log("✅ 停止请求已发送");
+        return;
+    }
+    const { ip, port } = parseHttpOptions(options);
+    console.log(`🛑 开始停止项目: ${ip}:${port}`);
+    await requestDeviceAction("stop", ip, port);
+    console.log("✅ 停止请求已发送");
+}

package/dist/ws-manager.d.ts

@@ -0,0 +1,110 @@
+/**
+ * WS 响应数据结构
+ */
+export type WsResponse = {
+    requestId: string;
+    success: boolean;
+    message?: unknown;
+    data?: unknown;
+};
+/**
+ * CLI 版 WebSocket 管理器
+ */
+export declare class WSManager {
+    private static instance;
+    private wss;
+    private client;
+    private checkInterval;
+    private readonly hostIp;
+    private port;
+    private pending;
+    /**
+     * 获取 WS 管理器单例
+     * @returns 返回单例实例
+     * @example
+     * const ws = WSManager.get()
+     */
+    static get(): WSManager;
+    /**
+     * 判断是否已有设备连接
+     * @returns 已连接返回 true，否则 false
+     * @example
+     * WSManager.isConnected()
+     */
+    static isConnected(): boolean;
+    /**
+     * 静态请求入口
+     * @param type 请求类型
+     * @param message 请求参数
+     * @param timeoutMs 超时时间（毫秒）
+     * @returns 返回设备响应
+     * @example
+     * await WSManager.request("runtime_status", {}, 5000)
+     */
+    static request(type: string, message?: Record<string, unknown>, timeoutMs?: number): Promise<WsResponse>;
+    /**
+     * 获取监听地址
+     * @returns 返回 ws 地址
+     * @example
+     * ws.getAddress()
+     */
+    getAddress(): string;
+    /**
+     * 判断服务器是否已启动
+     * @returns 已启动返回 true，否则 false
+     * @example
+     * ws.isStarted()
+     */
+    isStarted(): boolean;
+    /**
+     * 启动 WS 服务
+     * @param port 指定端口，默认 31111
+     * @returns 启动完成后返回 Promise<void>
+     * @example
+     * await ws.start(31111)
+     */
+    start(port?: number): Promise<void>;
+    /**
+     * 等待设备连接
+     * @param timeoutMs 超时时间（毫秒）
+     * @returns 成功连接后返回 Promise<void>
+     * @example
+     * await ws.waitForClient(30000)
+     */
+    waitForClient(timeoutMs?: number): Promise<void>;
+    /**
+     * 发送请求并等待响应
+     * @param type 请求类型
+     * @param message 请求消息
+     * @param timeoutMs 超时时间（毫秒）
+     * @returns 返回设备响应
+     * @example
+     * await ws.request("files", {}, 60000)
+     */
+    request(type: string, message?: Record<string, unknown>, timeoutMs?: number): Promise<WsResponse>;
+    /**
+     * 停止 WS 服务
+     * @returns 停止完成后返回 Promise<void>
+     * @example
+     * await ws.stop()
+     */
+    stop(): Promise<void>;
+    /**
+     * 启动运行状态轮询
+     * @returns 无返回值
+     * @example
+     * ws.startStatusInterval()
+     */
+    private startStatusInterval;
+    /**
+     * 停止运行状态轮询
+     * @returns 无返回值
+     * @example
+     * ws.stopStatusInterval()
+     */
+    private stopStatusInterval;
+}
+/**
+ * 对齐原有命名导出
+ */
+export declare const WebSocketServerManager: typeof WSManager;