ms-vite-plugin 1.1.2 → 1.1.4

package/dist/build.js

@@ -43,6 +43,12 @@ const fsExtra = __importStar(require("fs-extra"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const vite_plugin_bundle_obfuscator_1 = __importDefault(require("vite-plugin-bundle-obfuscator"));
+/**
+ * 压缩目录
+ * @param source 源目录路径
+ * @param out 输出文件路径
+ * @returns 压缩完成后的 Promise
+ */
 async function zipDirectory(source, out) {
     const archive = (0, archiver_1.default)("zip", { zlib: { level: 9 } });
     const stream = fsExtra.createWriteStream(out);

package/dist/cli.js

@@ -42,6 +42,7 @@ const fsExtra = __importStar(require("fs-extra"));
 const project_1 = require("./project");
 const packager_1 = require("./packager");
 const ws_manager_1 = require("./ws-manager");
+const version_1 = require("./version");
 /**
  * WS 状态持久化文件路径（用于跨进程查询 ws-status）
  */
@@ -183,6 +184,70 @@ async function stopCommand(options) {
         process.exit(1);
     }
 }
+/**
+ * screenshot 命令处理函数
+ * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms screenshot --ip 192.168.1.100 --port 9800 --output ./screen.jpg
+ */
+async function screenshotCommand(options) {
+    try {
+        await ensureValidKuaiJSProject(process.cwd());
+        const format = options.format ?? "file";
+        if (format === "base64") {
+            const base64 = await (0, project_1.getScreenshotBase64OnDevice)(options);
+            console.log(base64);
+            return;
+        }
+        const image = await (0, project_1.getScreenshotOnDevice)(options);
+        const outputPath = options.output?.trim()
+            ? path.resolve(options.output.trim())
+            : path.resolve(process.cwd(), "screenshot.jpg");
+        await fsExtra.ensureDir(path.dirname(outputPath));
+        await fsExtra.writeFile(outputPath, image);
+        console.log(`✅ 截图成功: ${outputPath} (${image.length} bytes)`);
+    }
+    catch (error) {
+        console.error("❌ 截图失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * source 命令处理函数
+ * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms source --ip 192.168.1.100 --port 9800 --max-depth 50 --timeout 120
+ */
+async function sourceCommand(options) {
+    try {
+        await ensureValidKuaiJSProject(process.cwd());
+        const maxDepthText = (options.maxDepth ?? "50").trim();
+        const timeoutText = (options.timeout ?? "120").trim();
+        const maxDepth = Number.parseInt(maxDepthText, 10);
+        const timeout = Number.parseInt(timeoutText, 10);
+        if (!Number.isInteger(maxDepth) || maxDepth < 1) {
+            throw new Error(`无效 max-depth: ${maxDepthText}`);
+        }
+        if (!Number.isInteger(timeout) || timeout < 1) {
+            throw new Error(`无效 timeout: ${timeoutText}`);
+        }
+        const source = await (0, project_1.getSourceOnDevice)(options, maxDepth, timeout);
+        if (options.output?.trim()) {
+            const outputPath = path.resolve(options.output.trim());
+            await fsExtra.ensureDir(path.dirname(outputPath));
+            await fsExtra.writeFile(outputPath, source, "utf8");
+            console.log(`✅ 节点已保存: ${outputPath}`);
+            return;
+        }
+        console.log(source);
+    }
+    catch (error) {
+        console.error("❌ 获取节点失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
 /**
  * ws-start 命令处理函数
  * @param options 命令选项
@@ -365,7 +430,7 @@ function renderDetailedCommandHelp() {
     return lines.join("\n");
 }
 // 配置 CLI 程序
-commander_1.program.name("ms-cli").description("快点JS 构建工具").version("1.1.2");
+commander_1.program.name("ms-cli").description("快点JS 构建工具").version(version_1.PACKAGE_VERSION);
 commander_1.program.addHelpText("after", renderDetailedCommandHelp);
 // 构建命令
 commander_1.program
@@ -408,6 +473,31 @@ commander_1.program
     .option("--ws-port <wsPort>", "WS 服务端口", "31111")
     .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
     .action(stopCommand);
+// 截图命令
+commander_1.program
+    .command("screenshot")
+    .description("获取设备截图（JPG）")
+    .option("-i, --ip <ip>", "设备 IP 地址（transport=http 时必填）")
+    .option("--port <port>", "设备端口", "9800")
+    .option("-t, --transport <transport>", "传输方式: http|ws", "http")
+    .option("--ws-port <wsPort>", "WS 服务端口", "31111")
+    .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
+    .option("--format <format>", "返回格式: file|base64", "file")
+    .option("--output <output>", "截图输出文件路径（format=file 时生效）")
+    .action(screenshotCommand);
+// 节点命令
+commander_1.program
+    .command("source")
+    .description("获取设备当前页面节点 XML")
+    .option("-i, --ip <ip>", "设备 IP 地址（transport=http 时必填）")
+    .option("--port <port>", "设备端口", "9800")
+    .option("-t, --transport <transport>", "传输方式: http|ws", "http")
+    .option("--ws-port <wsPort>", "WS 服务端口", "31111")
+    .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
+    .option("--max-depth <maxDepth>", "节点最大深度", "50")
+    .option("--timeout <timeout>", "节点抓取超时秒数", "120")
+    .option("--output <output>", "节点 XML 输出文件路径（可选）")
+    .action(sourceCommand);
 // WS 服务启动命令
 commander_1.program
     .command("ws-start")

package/dist/mcp/device-config.d.ts

@@ -0,0 +1,55 @@
+import type { DeviceConfig } from "./types";
+/**
+ * 默认设备端口
+ */
+export declare const DEFAULT_DEVICE_PORT = 9800;
+/**
+ * 设备连接配置持久化文件
+ * - 使用系统临时目录，避免污染项目源码目录
+ * - 文件名包含 pid/时间戳/随机串，确保并发窗口与多次启动互不冲突
+ */
+export declare const DEVICE_CONFIG_FILE: string;
+/**
+ * 将端口标准化为字符串（内部沿用 DeviceCliOptions 字符串端口）
+ * @param port 端口号
+ * @returns 返回标准端口字符串
+ * @example
+ * const textPort = normalizePort(9800)
+ */
+export declare function normalizePort(port: number): string;
+/**
+ * 读取已保存的设备配置
+ * @returns 若存在有效配置则返回配置对象，否则返回 null
+ * @example
+ * const cfg = await readDeviceConfig()
+ */
+export declare function readDeviceConfig(): Promise<DeviceConfig | null>;
+/**
+ * 保存设备配置
+ * @param config 需要保存的设备配置
+ * @returns 保存完成后返回 Promise<void>
+ * @example
+ * await writeDeviceConfig({ ip: "192.168.1.100", port: 9800, updatedAt: Date.now() })
+ */
+export declare function writeDeviceConfig(config: DeviceConfig): Promise<void>;
+/**
+ * 构建并保存设备配置
+ * @param ip 设备 IP
+ * @param port 设备端口（可选）
+ * @returns 返回保存后的设备配置
+ * @example
+ * const cfg = await setDeviceConfig("192.168.1.100", 9800)
+ */
+export declare function setDeviceConfig(ip: string, port?: number): Promise<DeviceConfig>;
+/**
+ * 获取最终生效的设备配置
+ * - 若调用参数携带 ip，则优先使用调用参数并落盘
+ * - 若只传 port，则复用已保存 ip，并更新 port 后落盘
+ * - 若都不传，则读取已保存配置
+ * @param ip 调用参数中的设备 ip（可选）
+ * @param port 调用参数中的设备端口（可选）
+ * @returns 返回可直接用于请求设备的配置
+ * @example
+ * const target = await resolveDeviceConfig(undefined, undefined)
+ */
+export declare function resolveDeviceConfig(ip?: string, port?: number): Promise<DeviceConfig>;

package/dist/mcp/device-config.js

@@ -0,0 +1,183 @@
+"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.DEVICE_CONFIG_FILE = exports.DEFAULT_DEVICE_PORT = void 0;
+exports.normalizePort = normalizePort;
+exports.readDeviceConfig = readDeviceConfig;
+exports.writeDeviceConfig = writeDeviceConfig;
+exports.setDeviceConfig = setDeviceConfig;
+exports.resolveDeviceConfig = resolveDeviceConfig;
+const fsExtra = __importStar(require("fs-extra"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * 默认设备端口
+ */
+exports.DEFAULT_DEVICE_PORT = 9800;
+/**
+ * 设备连接配置持久化文件
+ * - 使用系统临时目录，避免污染项目源码目录
+ * - 文件名包含 pid/时间戳/随机串，确保并发窗口与多次启动互不冲突
+ */
+exports.DEVICE_CONFIG_FILE = path.join(os.tmpdir(), `ms-cli-mcp-device-${process.pid}-${Date.now()}-${Math.random()
+    .toString(36)
+    .slice(2, 10)}.json`);
+/**
+ * 将端口标准化为字符串（内部沿用 DeviceCliOptions 字符串端口）
+ * @param port 端口号
+ * @returns 返回标准端口字符串
+ * @example
+ * const textPort = normalizePort(9800)
+ */
+function normalizePort(port) {
+    return String(port);
+}
+/**
+ * 校验并标准化 IP 字符串
+ * @param ip 原始 ip 输入
+ * @returns 返回去空格后的 ip
+ * @example
+ * const normalizedIp = normalizeIp(" 192.168.1.100 ")
+ */
+function normalizeIp(ip) {
+    const normalizedIp = ip.trim();
+    if (!normalizedIp) {
+        throw new Error("设备 IP 不能为空");
+    }
+    return normalizedIp;
+}
+/**
+ * 校验并标准化端口
+ * @param port 原始端口（可选）
+ * @returns 返回有效端口，默认 9800
+ * @example
+ * const normalizedPort = normalizeDevicePort(undefined)
+ */
+function normalizeDevicePort(port) {
+    const targetPort = port ?? exports.DEFAULT_DEVICE_PORT;
+    if (!Number.isInteger(targetPort) || targetPort < 1 || targetPort > 65535) {
+        throw new Error(`无效设备端口: ${String(port)}`);
+    }
+    return targetPort;
+}
+/**
+ * 读取已保存的设备配置
+ * @returns 若存在有效配置则返回配置对象，否则返回 null
+ * @example
+ * const cfg = await readDeviceConfig()
+ */
+async function readDeviceConfig() {
+    try {
+        if (!(await fsExtra.pathExists(exports.DEVICE_CONFIG_FILE))) {
+            return null;
+        }
+        const data = (await fsExtra.readJSON(exports.DEVICE_CONFIG_FILE));
+        const ip = typeof data.ip === "string" ? data.ip.trim() : "";
+        const port = typeof data.port === "number" ? data.port : Number.parseInt(String(data.port), 10);
+        if (!ip || !Number.isInteger(port) || port < 1 || port > 65535) {
+            return null;
+        }
+        return {
+            ip,
+            port,
+            updatedAt: typeof data.updatedAt === "number" && Number.isFinite(data.updatedAt)
+                ? data.updatedAt
+                : Date.now(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 保存设备配置
+ * @param config 需要保存的设备配置
+ * @returns 保存完成后返回 Promise<void>
+ * @example
+ * await writeDeviceConfig({ ip: "192.168.1.100", port: 9800, updatedAt: Date.now() })
+ */
+async function writeDeviceConfig(config) {
+    await fsExtra.writeJSON(exports.DEVICE_CONFIG_FILE, config, { spaces: 2 });
+}
+/**
+ * 构建并保存设备配置
+ * @param ip 设备 IP
+ * @param port 设备端口（可选）
+ * @returns 返回保存后的设备配置
+ * @example
+ * const cfg = await setDeviceConfig("192.168.1.100", 9800)
+ */
+async function setDeviceConfig(ip, port) {
+    const config = {
+        ip: normalizeIp(ip),
+        port: normalizeDevicePort(port),
+        updatedAt: Date.now(),
+    };
+    await writeDeviceConfig(config);
+    return config;
+}
+/**
+ * 获取最终生效的设备配置
+ * - 若调用参数携带 ip，则优先使用调用参数并落盘
+ * - 若只传 port，则复用已保存 ip，并更新 port 后落盘
+ * - 若都不传，则读取已保存配置
+ * @param ip 调用参数中的设备 ip（可选）
+ * @param port 调用参数中的设备端口（可选）
+ * @returns 返回可直接用于请求设备的配置
+ * @example
+ * const target = await resolveDeviceConfig(undefined, undefined)
+ */
+async function resolveDeviceConfig(ip, port) {
+    const savedConfig = await readDeviceConfig();
+    if (ip !== undefined) {
+        return setDeviceConfig(ip, port);
+    }
+    if (port !== undefined) {
+        if (!savedConfig) {
+            throw new Error("尚未配置设备 IP。请先调用 set_device 设置 ip，或在本次 run 调用里传入 ip。");
+        }
+        const nextConfig = {
+            ip: savedConfig.ip,
+            port: normalizeDevicePort(port),
+            updatedAt: Date.now(),
+        };
+        await writeDeviceConfig(nextConfig);
+        return nextConfig;
+    }
+    if (savedConfig) {
+        return savedConfig;
+    }
+    throw new Error("未找到可用设备配置。请先调用 set_device 设置 ip，或在 run/run_ui/stop 调用里传入 ip。");
+}

package/dist/mcp/docs-service.d.ts

@@ -0,0 +1,65 @@
+import type { ApiDocItem, ApiDocsLanguage } from "./types";
+/**
+ * 获取当前文档语言
+ * @returns 返回当前语言
+ * @example
+ * const language = getCurrentDocsLanguage()
+ */
+export declare function getCurrentDocsLanguage(): ApiDocsLanguage;
+/**
+ * 设置当前文档语言
+ * @param language 目标语言
+ * @returns 设置后的语言
+ * @example
+ * const language = setCurrentDocsLanguage("python")
+ */
+export declare function setCurrentDocsLanguage(language: ApiDocsLanguage): ApiDocsLanguage;
+/**
+ * 根据可选入参解析实际使用的文档语言
+ * @param language 工具调用时传入的语言（可选）
+ * @returns 返回最终生效的语言
+ * @example
+ * const activeLanguage = resolveDocsLanguage(undefined)
+ */
+export declare function resolveDocsLanguage(language?: ApiDocsLanguage): ApiDocsLanguage;
+/**
+ * 获取 docs 根目录
+ * @returns 返回 docs 目录绝对路径
+ * @example
+ * const docsRoot = getDocsRootDir()
+ */
+export declare function getDocsRootDir(): string;
+/**
+ * 获取某语言对应的文档目录
+ * @param language 文档语言
+ * @returns 返回文档目录绝对路径
+ * @example
+ * const dir = getDocsDirByLanguage("js_zh")
+ */
+export declare function getDocsDirByLanguage(language: ApiDocsLanguage): string;
+/**
+ * 读取指定语言的 API 文档列表
+ * @param language 文档语言
+ * @returns 返回文档条目数组（按 slug 升序）
+ * @example
+ * const docs = await getApiDocsByLanguage("python")
+ */
+export declare function getApiDocsByLanguage(language: ApiDocsLanguage): Promise<ApiDocItem[]>;
+/**
+ * 对文档按查询词打分，用于检索排序
+ * @param doc 文档条目
+ * @param normalizedQuery 已转小写的查询词
+ * @returns 分数，0 表示不命中
+ * @example
+ * const score = scoreApiDoc(doc, "click")
+ */
+export declare function scoreApiDoc(doc: ApiDocItem, normalizedQuery: string): number;
+/**
+ * 生成文档 URI（用于资源与文本返回）
+ * @param language 文档语言
+ * @param slug 文档分类
+ * @returns 返回 MCP 资源 URI 字符串
+ * @example
+ * const uri = getDocUri("js_zh", "device")
+ */
+export declare function getDocUri(language: ApiDocsLanguage, slug: string): string;

package/dist/mcp/docs-service.js

@@ -0,0 +1,168 @@
+"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.getCurrentDocsLanguage = getCurrentDocsLanguage;
+exports.setCurrentDocsLanguage = setCurrentDocsLanguage;
+exports.resolveDocsLanguage = resolveDocsLanguage;
+exports.getDocsRootDir = getDocsRootDir;
+exports.getDocsDirByLanguage = getDocsDirByLanguage;
+exports.getApiDocsByLanguage = getApiDocsByLanguage;
+exports.scoreApiDoc = scoreApiDoc;
+exports.getDocUri = getDocUri;
+const fsExtra = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+/**
+ * 当前 MCP 进程默认文档语言
+ */
+let currentDocsLanguage = "js_zh";
+/**
+ * 获取当前文档语言
+ * @returns 返回当前语言
+ * @example
+ * const language = getCurrentDocsLanguage()
+ */
+function getCurrentDocsLanguage() {
+    return currentDocsLanguage;
+}
+/**
+ * 设置当前文档语言
+ * @param language 目标语言
+ * @returns 设置后的语言
+ * @example
+ * const language = setCurrentDocsLanguage("python")
+ */
+function setCurrentDocsLanguage(language) {
+    currentDocsLanguage = language;
+    return currentDocsLanguage;
+}
+/**
+ * 根据可选入参解析实际使用的文档语言
+ * @param language 工具调用时传入的语言（可选）
+ * @returns 返回最终生效的语言
+ * @example
+ * const activeLanguage = resolveDocsLanguage(undefined)
+ */
+function resolveDocsLanguage(language) {
+    return language ?? currentDocsLanguage;
+}
+/**
+ * 获取 docs 根目录
+ * @returns 返回 docs 目录绝对路径
+ * @example
+ * const docsRoot = getDocsRootDir()
+ */
+function getDocsRootDir() {
+    return path.resolve(__dirname, "..", "..", "docs");
+}
+/**
+ * 获取某语言对应的文档目录
+ * @param language 文档语言
+ * @returns 返回文档目录绝对路径
+ * @example
+ * const dir = getDocsDirByLanguage("js_zh")
+ */
+function getDocsDirByLanguage(language) {
+    if (language === "js") {
+        return path.join(getDocsRootDir(), "api");
+    }
+    if (language === "js_zh") {
+        return path.join(getDocsRootDir(), "apicn");
+    }
+    return path.join(getDocsRootDir(), "apipython");
+}
+/**
+ * 读取指定语言的 API 文档列表
+ * @param language 文档语言
+ * @returns 返回文档条目数组（按 slug 升序）
+ * @example
+ * const docs = await getApiDocsByLanguage("python")
+ */
+async function getApiDocsByLanguage(language) {
+    const docsDir = getDocsDirByLanguage(language);
+    if (!(await fsExtra.pathExists(docsDir))) {
+        throw new Error(`文档目录不存在: ${docsDir}`);
+    }
+    const fileNames = await fsExtra.readdir(docsDir);
+    const mdFiles = fileNames
+        .filter((name) => name.toLowerCase().endsWith(".md"))
+        .sort();
+    const docs = [];
+    for (const fileName of mdFiles) {
+        const filePath = path.join(docsDir, fileName);
+        const content = await fsExtra.readFile(filePath, "utf8");
+        const slug = path.basename(fileName, ".md");
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        const title = titleMatch?.[1]?.trim() || slug;
+        docs.push({
+            slug,
+            title,
+            content,
+            filePath,
+        });
+    }
+    return docs;
+}
+/**
+ * 对文档按查询词打分，用于检索排序
+ * @param doc 文档条目
+ * @param normalizedQuery 已转小写的查询词
+ * @returns 分数，0 表示不命中
+ * @example
+ * const score = scoreApiDoc(doc, "click")
+ */
+function scoreApiDoc(doc, normalizedQuery) {
+    let score = 0;
+    if (doc.title.toLowerCase().includes(normalizedQuery)) {
+        score += 50;
+    }
+    if (doc.slug.toLowerCase().includes(normalizedQuery)) {
+        score += 40;
+    }
+    if (doc.content.toLowerCase().includes(normalizedQuery)) {
+        score += 10;
+    }
+    return score;
+}
+/**
+ * 生成文档 URI（用于资源与文本返回）
+ * @param language 文档语言
+ * @param slug 文档分类
+ * @returns 返回 MCP 资源 URI 字符串
+ * @example
+ * const uri = getDocUri("js_zh", "device")
+ */
+function getDocUri(language, slug) {
+    return `kuaijs://docs/${language}/${slug}`;
+}

package/dist/mcp/project.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 检查工作目录是否为有效的 KuaiJS 项目
+ * @param workspacePath 工作目录路径
+ * @returns 若目录包含 package.json 与 scripts 目录则返回 true，否则返回 false
+ * @example
+ * const ok = await isValidKuaiJSProject(process.cwd())
+ */
+export declare function isValidKuaiJSProject(workspacePath: string): Promise<boolean>;
+/**
+ * 校验当前目录是否是可执行构建/运行的 KuaiJS 项目
+ * @param workspacePath 待校验目录
+ * @returns 校验通过时返回 Promise<void>，失败时抛出异常
+ * @example
+ * await ensureValidKuaiJSProject("/Users/demo/project")
+ */
+export declare function ensureValidKuaiJSProject(workspacePath: string): Promise<void>;