ms-vite-plugin 1.0.1 → 1.0.3

package/dist/build.js

@@ -42,7 +42,6 @@ const child_process_1 = require("child_process");
 const fsExtra = __importStar(require("fs-extra"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
-const vite_1 = require("vite");
 const vite_plugin_bundle_obfuscator_1 = __importDefault(require("vite-plugin-bundle-obfuscator"));
 async function zipDirectory(source, out) {
     const archive = (0, archiver_1.default)("zip", { zlib: { level: 9 } });
@@ -167,6 +166,7 @@ const buildAll = async (isDev = true, workspacePath) => {
     const isPy = await fsExtra.pathExists(path.join(workspacePath, "scripts", "main.py"));
     if (isJs) {
         console.log("🚀 开始构建JavaScript项目...");
+        const { build } = await import("vite");
         const obfuscatorConfigPath = path.join(workspacePath, "obfuscator.json");
         if (!(await fsExtra.pathExists(obfuscatorConfigPath))) {
             console.error("❌ 错误: 当前目录不是有效的 快点JS 项目");
@@ -180,7 +180,7 @@ const buildAll = async (isDev = true, workspacePath) => {
         const entryFiles = await findEntryFiles(baseDir, baseDir);
         await fsExtra.remove(outputDir);
         for (const entry of entryFiles) {
-            await (0, vite_1.build)({
+            await build({
                 root: workspacePath,
                 build: {
                     lib: {

package/dist/cli.js

@@ -35,9 +35,13 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const build_1 = require("./build");
 const fsExtra = __importStar(require("fs-extra"));
+const project_1 = require("./project");
+const ws_manager_1 = require("./ws-manager");
+const WS_PID_FILE = path.join(os.tmpdir(), "ms-cli-ws-server.json");
 /**
  * 检查工作目录是否为有效的 KuaiJS 项目
  * @param workspacePath 工作目录路径
@@ -87,6 +91,159 @@ async function buildCommand(options) {
         process.exit(1);
     }
 }
+/**
+ * run 命令处理函数
+ * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms run --ip 192.168.1.100 --port 9800 --path ./
+ */
+async function runCommand(options) {
+    try {
+        await (0, project_1.runOnDevice)(options);
+        console.log("✅ 运行请求已发送");
+    }
+    catch (error) {
+        console.error("❌ 运行失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * runUI 命令处理函数
+ * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms run-ui --ip 192.168.1.100 --port 9800 --path ./
+ */
+async function runUICommand(options) {
+    try {
+        await (0, project_1.runUIOnDevice)(options);
+        console.log("✅ UI 预览请求已发送");
+    }
+    catch (error) {
+        console.error("❌ UI 预览失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * stop 命令处理函数
+ * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms stop --ip 192.168.1.100 --port 9800
+ */
+async function stopCommand(options) {
+    try {
+        await (0, project_1.stopOnDevice)(options);
+        console.log("✅ 停止请求已发送");
+    }
+    catch (error) {
+        console.error("❌ 停止失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * ws-start 命令处理函数
+ * @param options 命令选项
+ * @returns 常驻直到收到退出信号
+ * @example
+ * ms ws-start --ws-port 31111
+ */
+async function wsStartCommand(options) {
+    try {
+        const wsPortText = (options.wsPort ?? "31111").trim();
+        const wsPort = Number.parseInt(wsPortText, 10);
+        if (!Number.isInteger(wsPort) || wsPort < 1 || wsPort > 65535) {
+            throw new Error(`无效 ws 端口: ${wsPortText}`);
+        }
+        const ws = ws_manager_1.WSManager.get();
+        await ws.start(wsPort);
+        await fsExtra.writeJSON(WS_PID_FILE, {
+            pid: process.pid,
+            port: wsPort,
+            address: ws.getAddress(),
+            startedAt: Date.now(),
+        });
+        console.log("按 Ctrl+C 停止 WS 服务");
+        await new Promise((resolve) => {
+            const shutdown = async () => {
+                process.off("SIGINT", shutdown);
+                process.off("SIGTERM", shutdown);
+                await ws.stop();
+                await fsExtra.remove(WS_PID_FILE);
+                resolve();
+            };
+            process.on("SIGINT", shutdown);
+            process.on("SIGTERM", shutdown);
+        });
+    }
+    catch (error) {
+        console.error("❌ WS 服务启动失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * ws-stop 命令处理函数
+ * @returns 请求完成后退出
+ * @example
+ * ms ws-stop
+ */
+async function wsStopCommand() {
+    try {
+        if (!(await fsExtra.pathExists(WS_PID_FILE))) {
+            console.log("WS 服务未运行");
+            return;
+        }
+        const info = await fsExtra.readJSON(WS_PID_FILE);
+        const pid = Number(info.pid);
+        if (!Number.isInteger(pid) || pid <= 0) {
+            await fsExtra.remove(WS_PID_FILE);
+            throw new Error("WS PID 文件损坏");
+        }
+        try {
+            process.kill(pid, "SIGTERM");
+            console.log(`✅ 已发送停止信号到 WS 进程: ${pid}`);
+        }
+        catch {
+            console.log("WS 进程不存在，清理 PID 文件");
+        }
+        await fsExtra.remove(WS_PID_FILE);
+    }
+    catch (error) {
+        console.error("❌ WS 服务停止失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * ws-status 命令处理函数
+ * @returns 请求完成后退出
+ * @example
+ * ms ws-status
+ */
+async function wsStatusCommand() {
+    if (!(await fsExtra.pathExists(WS_PID_FILE))) {
+        console.log("服务状态: stopped");
+        return;
+    }
+    const info = await fsExtra.readJSON(WS_PID_FILE);
+    const pid = Number(info.pid);
+    const address = String(info.address || "unknown");
+    let running = false;
+    try {
+        process.kill(pid, 0);
+        running = true;
+    }
+    catch {
+        running = false;
+    }
+    if (!running) {
+        await fsExtra.remove(WS_PID_FILE);
+        console.log("服务状态: stopped");
+        return;
+    }
+    console.log(`服务状态: running (pid=${pid})`);
+    console.log(`WS 地址: ${address}`);
+}
 // 配置 CLI 程序
 commander_1.program.name("ms-cli").description("快点JS 构建工具").version("0.0.7");
 // 构建命令
@@ -96,5 +253,53 @@ commander_1.program
     .option("-d, --dev", "开发模式构建 (包含 source map)")
     .option("-p, --path <path>", "指定项目路径")
     .action(buildCommand);
+// 运行命令
+commander_1.program
+    .command("run")
+    .description("在设备上运行项目")
+    .option("-i, --ip <ip>", "设备 IP 地址（transport=http 时必填）")
+    .option("--port <port>", "设备端口 (默认: 9800)", "9800")
+    .option("-t, --transport <transport>", "传输方式: http|ws", "http")
+    .option("--ws-port <wsPort>", "WS 服务端口 (默认: 31111)", "31111")
+    .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
+    .option("-p, --path <path>", "指定项目路径")
+    .action(runCommand);
+// UI 预览命令
+commander_1.program
+    .command("run-ui")
+    .description("在设备上预览 UI")
+    .option("-i, --ip <ip>", "设备 IP 地址（transport=http 时必填）")
+    .option("--port <port>", "设备端口 (默认: 9800)", "9800")
+    .option("-t, --transport <transport>", "传输方式: http|ws", "http")
+    .option("--ws-port <wsPort>", "WS 服务端口 (默认: 31111)", "31111")
+    .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
+    .option("-p, --path <path>", "指定项目路径")
+    .action(runUICommand);
+// 停止命令
+commander_1.program
+    .command("stop")
+    .description("停止设备上的项目")
+    .option("-i, --ip <ip>", "设备 IP 地址（transport=http 时必填）")
+    .option("--port <port>", "设备端口 (默认: 9800)", "9800")
+    .option("-t, --transport <transport>", "传输方式: http|ws", "http")
+    .option("--ws-port <wsPort>", "WS 服务端口 (默认: 31111)", "31111")
+    .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
+    .action(stopCommand);
+// WS 服务启动命令
+commander_1.program
+    .command("ws-start")
+    .description("启动 CLI 内置 WS 服务")
+    .option("--ws-port <wsPort>", "WS 服务端口 (默认: 31111)", "31111")
+    .action(wsStartCommand);
+// WS 服务停止命令
+commander_1.program
+    .command("ws-stop")
+    .description("停止 CLI 内置 WS 服务")
+    .action(wsStopCommand);
+// WS 服务状态命令
+commander_1.program
+    .command("ws-status")
+    .description("查看 CLI 内置 WS 服务状态")
+    .action(wsStatusCommand);
 // 解析命令行参数
 commander_1.program.parse();

package/dist/device.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 设备命令选项
+ */
+export interface DeviceCliOptions {
+    ip: string;
+    port?: string;
+    path?: string;
+}
+/**
+ * 在设备上运行项目（先同步后运行）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+export declare function runOnDevice(options: DeviceCliOptions): Promise<void>;
+/**
+ * 在设备上预览 UI（先同步后调用 runUI）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+export declare function runUIOnDevice(options: DeviceCliOptions): Promise<void>;
+/**
+ * 停止设备上的项目
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+export declare function stopOnDevice(options: DeviceCliOptions): Promise<void>;

package/dist/device.js

@@ -0,0 +1,325 @@
+"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.runOnDevice = runOnDevice;
+exports.runUIOnDevice = runUIOnDevice;
+exports.stopOnDevice = stopOnDevice;
+const fsExtra = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const build_js_1 = require("./build.js");
+/**
+ * 读取并校验设备连接参数
+ * @param options 命令选项
+ * @returns 返回标准化后的设备地址信息
+ * @example
+ * parseDeviceOptions({ ip: "192.168.1.10", port: "9800" })
+ */
+function parseDeviceOptions(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 };
+}
+/**
+ * 计算 Buffer 的 CRC32 值
+ * @param input 二进制输入数据
+ * @returns CRC32 十六进制字符串（8位）
+ * @example
+ * calculateCrc32FromBuffer(Buffer.from("hello"))
+ */
+function calculateCrc32FromBuffer(input) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < input.length; i += 1) {
+        crc ^= input[i];
+        for (let j = 0; j < 8; j += 1) {
+            if ((crc & 1) === 1) {
+                crc = (crc >>> 1) ^ 0xedb88320;
+            }
+            else {
+                crc >>>= 1;
+            }
+        }
+    }
+    const finalValue = (crc ^ 0xffffffff) >>> 0;
+    return finalValue.toString(16).padStart(8, "0");
+}
+/**
+ * 计算文件的 CRC32 值
+ * @param filePath 文件路径
+ * @returns CRC32 十六进制字符串（8位）
+ * @example
+ * await calculateCrc32("/tmp/a.txt")
+ */
+async function calculateCrc32(filePath) {
+    const fileBuffer = await fsExtra.readFile(filePath);
+    return calculateCrc32FromBuffer(fileBuffer);
+}
+/**
+ * 递归收集目录中的所有文件
+ * @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) {
+    const scriptDistPath = path.join(workspacePath, "dist", "scripts");
+    const scriptSrcPath = path.join(workspacePath, "scripts");
+    const uiPath = path.join(workspacePath, "ui");
+    const resPath = path.join(workspacePath, "res");
+    const packageJsonPath = path.join(workspacePath, "package.json");
+    const useDistScripts = await fsExtra.pathExists(scriptDistPath);
+    const scriptPath = useDistScripts ? scriptDistPath : scriptSrcPath;
+    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;
+}
+/**
+ * 获取设备上的文件列表
+ * @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 : [];
+}
+/**
+ * 将项目文件增量同步到设备
+ * @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} 个文件`);
+}
+/**
+ * 发送设备动作请求
+ * @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}`);
+    }
+}
+/**
+ * 在设备上运行项目（先同步后运行）
+ * @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 { ip, port } = parseDeviceOptions(options);
+    console.log(`🔧 开始构建项目: ${workspacePath}`);
+    await (0, build_js_1.buildAll)(true, workspacePath);
+    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 { ip, port } = parseDeviceOptions(options);
+    console.log(`🔧 开始构建项目: ${workspacePath}`);
+    await (0, build_js_1.buildAll)(true, workspacePath);
+    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 { ip, port } = parseDeviceOptions(options);
+    console.log(`🛑 开始停止项目: ${ip}:${port}`);
+    await requestDeviceAction("stop", ip, port);
+    console.log("✅ 停止请求已发送");
+}

package/dist/project.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 设备命令选项
+ */
+export interface DeviceCliOptions {
+    ip?: string;
+    port?: string;
+    path?: string;
+    transport?: string;
+    wsPort?: string;
+    wsWaitMs?: string;
+}
+/**
+ * 在设备上运行项目（先同步后运行）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+export declare function runOnDevice(options: DeviceCliOptions): Promise<void>;
+/**
+ * 在设备上预览 UI（先同步后调用 runUI）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+export declare function runUIOnDevice(options: DeviceCliOptions): Promise<void>;
+/**
+ * 停止设备上的项目
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+export declare function stopOnDevice(options: DeviceCliOptions): Promise<void>;