ms-vite-plugin 1.4.47 → 1.4.49

package/dist/cli.js

@@ -1,1235 +1,7 @@
 #!/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 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 packager_1 = require("./packager");
-const ws_manager_1 = require("./ws-manager");
-const version_1 = require("./version");
-const docs_service_1 = require("./mcp/docs-service");
-const httpapi_docs_service_1 = require("./mcp/httpapi-docs-service");
-const tool_utils_1 = require("./mcp/tool-utils");
-const types_1 = require("./mcp/types");
-const ocr_tools_1 = require("./mcp/ocr-tools");
-const image_tools_1 = require("./mcp/image-tools");
-/**
- * WS 状态持久化文件路径（用于跨进程查询 ws-status）
- */
-const WS_PID_FILE = path.join(os.tmpdir(), "ms-cli-ws-server.json");
-/**
- * 检查工作目录是否为有效的 KuaiJS 项目
- * @param workspacePath 工作目录路径
- * @returns 是否为有效项目
- * @example
- * await isValidKuaiJSProject(process.cwd())
- */
-async function isValidKuaiJSProject(workspacePath) {
-    try {
-        const packageJsonPath = path.join(workspacePath, "package.json");
-        const scriptsPath = path.join(workspacePath, "scripts");
-        const [packageExists, scriptsExists] = await Promise.all([
-            fsExtra.pathExists(packageJsonPath),
-            fsExtra.pathExists(scriptsPath),
-        ]);
-        return packageExists && scriptsExists;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * 统一校验项目目录合法性
- * @param workspacePath 待校验的项目目录
- * @returns 校验通过返回 Promise<void>
- * @example
- * await ensureValidKuaiJSProject("/Users/demo/project")
- */
-async function ensureValidKuaiJSProject(workspacePath) {
-    if (await isValidKuaiJSProject(workspacePath)) {
-        return;
-    }
-    console.error("❌ 错误: 当前目录不是有效的 快点JS 项目");
-    console.error("请确保目录包含以下文件:");
-    console.error("  - package.json");
-    console.error("  - scripts/ 目录");
-    process.exit(1);
-}
-/**
- * 解析整数参数
- * @param value 用户传入的参数文本
- * @param defaultValue 默认值
- * @param name 参数名称
- * @param min 最小值
- * @param max 最大值
- * @returns 返回校验后的整数
- * @example
- * parseCliInteger("20", 10, "limit", 1, 100)
- */
-function parseCliInteger(value, defaultValue, name, min, max) {
-    const text = (value ?? String(defaultValue)).trim();
-    const numberValue = Number.parseInt(text, 10);
-    if (!Number.isInteger(numberValue) ||
-        numberValue < min ||
-        (max !== undefined && numberValue > max)) {
-        throw new Error(`无效 ${name}: ${text}，允许范围 ${min}${max === undefined ? "+" : `..${max}`}`);
-    }
-    return numberValue;
-}
-/**
- * 解析浮点数参数
- * @param value 用户传入的参数文本
- * @param defaultValue 默认值
- * @param name 参数名称
- * @param min 最小值
- * @param max 最大值
- * @returns 返回校验后的数字
- * @example
- * parseCliNumber("0.6", 0.6, "confidence", 0, 1)
- */
-function parseCliNumber(value, defaultValue, name, min, max) {
-    const text = (value ?? String(defaultValue)).trim();
-    const numberValue = Number.parseFloat(text);
-    if (!Number.isFinite(numberValue) || numberValue < min || numberValue > max) {
-        throw new Error(`无效 ${name}: ${text}，允许范围 ${min}..${max}`);
-    }
-    return numberValue;
-}
-/**
- * 解析枚举参数
- * @param value 用户传入的参数文本
- * @param defaultValue 默认值
- * @param choices 允许的取值
- * @param name 参数名称
- * @returns 返回校验后的枚举值
- * @example
- * parseCliChoice("json", "text", ["text", "json"], "format")
- */
-function parseCliChoice(value, defaultValue, choices, name) {
-    const text = (value ?? defaultValue).trim();
-    if (!choices.includes(text)) {
-        throw new Error(`无效 ${name}: ${text}，可选值: ${choices.join("|")}`);
-    }
-    return text;
-}
-/**
- * 解析 HTTP API 请求方法
- * @param value 用户传入的方法
- * @returns 返回 HTTP API 方法
- * @example
- * parseHttpApiMethodOption("GET")
- */
-function parseHttpApiMethodOption(value) {
-    const method = value?.trim().toUpperCase();
-    return parseCliChoice(method, "GET", ["GET", "POST"], "method");
-}
-/**
- * 解析设备 HTTP 地址
- * @param options 设备命令选项
- * @returns 返回设备 HTTP 目标
- * @example
- * parseDeviceHttpTarget({ ip: "192.168.1.10", port: "9800" })
- */
-function parseDeviceHttpTarget(options) {
-    const ip = options.ip?.trim();
-    if (!ip) {
-        throw new Error("请通过 --ip 指定设备 IP 地址");
-    }
-    const port = parseCliInteger(options.port, 9800, "port", 1, 65535);
-    return {
-        ip,
-        port: String(port),
-        label: `${ip}:${port}`,
-    };
-}
-/**
- * 输出文本到终端或文件
- * @param text 待输出文本
- * @param output 用户指定输出路径
- * @param savedLabel 保存成功提示
- * @returns 输出完成后返回
- * @example
- * await writeOrPrintText("ok", "./out.txt", "结果已保存")
- */
-async function writeOrPrintText(text, output, savedLabel) {
-    if (output?.trim()) {
-        const outputPath = path.resolve(output.trim());
-        await fsExtra.ensureDir(path.dirname(outputPath));
-        await fsExtra.writeFile(outputPath, text, "utf8");
-        console.log(`✅ ${savedLabel}: ${outputPath}`);
-        return;
-    }
-    console.log(text);
-}
-/**
- * 格式化 CLI 文档路径清单
- * @returns 返回本地文档路径文本
- * @example
- * const text = formatCliDocsPathsText()
- */
-function formatCliDocsPathsText() {
-    const languages = ["js", "js_zh", "python"];
-    return [
-        "KuaiJS 文档路径:",
-        `docsRoot: ${(0, docs_service_1.getDocsRootDir)()}`,
-        ...languages.map((language) => `${language}: ${(0, docs_service_1.getDocsDirByLanguage)(language)} (${types_1.DOC_LANGUAGE_LABELS[language]})`),
-        `httpApi: ${(0, httpapi_docs_service_1.getHttpApiDocPath)()}`,
-        "说明: 直接读取上述 markdown 路径。",
-    ].join("\n");
-}
-/**
- * 收集可重复字符串参数
- * @param value 当前参数值
- * @param previous 之前收集的值
- * @returns 返回追加后的数组
- * @example
- * collectStringOption("登录", [])
- */
-function collectStringOption(value, previous) {
-    previous.push(value);
-    return previous;
-}
-/**
- * 解析字符串数组参数
- * @param value 用户传入文本
- * @param name 参数名
- * @returns 返回字符串数组或 undefined
- * @example
- * parseStringArrayOption("zh-Hans,en-US", "languages")
- */
-function parseStringArrayOption(value, name) {
-    const text = value?.trim();
-    if (!text) {
-        return undefined;
-    }
-    if (text.startsWith("[")) {
-        const parsed = JSON.parse(text);
-        if (!Array.isArray(parsed) ||
-            !parsed.every((item) => typeof item === "string" && item.trim())) {
-            throw new Error(`${name} 必须是字符串数组。`);
-        }
-        return parsed.map((item) => item.trim());
-    }
-    const items = text
-        .split(",")
-        .map((item) => item.trim())
-        .filter((item) => item.length > 0);
-    if (items.length === 0) {
-        throw new Error(`${name} 不能为空。`);
-    }
-    return items;
-}
-/**
- * 解析 Apple OCR 语言数组
- * @param value 用户传入语言文本
- * @returns 返回语言数组或 undefined
- * @example
- * parseAppleOcrLanguages("zh-Hans,en-US")
- */
-function parseAppleOcrLanguages(value) {
-    const languages = parseStringArrayOption(value, "languages");
-    if (!languages) {
-        return undefined;
-    }
-    const allowed = new Set(ocr_tools_1.APPLE_OCR_LANGUAGES);
-    const invalid = languages.filter((language) => !allowed.has(language));
-    if (invalid.length > 0) {
-        throw new Error(`无效 languages: ${invalid.join(", ")}，可选值: ${ocr_tools_1.APPLE_OCR_LANGUAGES.join(", ")}`);
-    }
-    return languages;
-}
-/**
- * 解析 JSON 对象参数
- * @param value 用户传入 JSON 文本
- * @param name 参数名
- * @returns 返回对象或 undefined
- * @example
- * parseJsonRecordOption('{"x":1}', "query")
- */
-function parseJsonRecordOption(value, name) {
-    const text = value?.trim();
-    if (!text) {
-        return undefined;
-    }
-    const parsed = JSON.parse(text);
-    if (!parsed ||
-        typeof parsed !== "object" ||
-        Array.isArray(parsed) ||
-        !Object.values(parsed).every((item) => typeof item === "string" ||
-            typeof item === "number" ||
-            typeof item === "boolean" ||
-            item === null)) {
-        throw new Error(`${name} 必须是 JSON 对象，且值只能是 string/number/boolean/null。`);
-    }
-    return parsed;
-}
-/**
- * 解析 JSON 请求体参数
- * @param value 用户传入请求体文本
- * @returns 返回 JSON 值或 undefined
- * @example
- * parseJsonBodyOption('{"x":1}')
- */
-function parseJsonBodyOption(value) {
-    const text = value?.trim();
-    if (text === undefined || text.length === 0) {
-        return undefined;
-    }
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return value;
-    }
-}
-/**
- * 标准化 HTTP API 路径
- * @param apiPath 用户传入路径
- * @returns 返回相对路径
- * @example
- * normalizeCliHttpApiPath("/api/status")
- */
-function normalizeCliHttpApiPath(apiPath) {
-    const normalizedPath = apiPath.trim();
-    if (/^https?:\/\//i.test(normalizedPath)) {
-        throw new Error("path 只能传 HTTP API 相对路径，不能传完整 URL。");
-    }
-    if (!normalizedPath.startsWith("/")) {
-        throw new Error("path 必须以 / 开头，例如 /api/status。");
-    }
-    if (normalizedPath.includes("?")) {
-        throw new Error("path 不能包含 query string，请使用 --query 传递查询参数。");
-    }
-    return normalizedPath;
-}
-/**
- * 追加 HTTP query 参数
- * @param url 目标 URL
- * @param query query 参数
- * @returns 无返回值
- * @example
- * appendCliQueryParams(url, { x: 1 })
- */
-function appendCliQueryParams(url, query) {
-    if (!query) {
-        return;
-    }
-    for (const [key, value] of Object.entries(query)) {
-        if (value === null) {
-            continue;
-        }
-        url.searchParams.set(key, String(value));
-    }
-}
-/**
- * 创建 HTTP API 请求体
- * @param body 用户传入请求体
- * @returns 返回 fetch 请求体和头
- * @example
- * createCliHttpRequestBody({ x: 1 })
- */
-function createCliHttpRequestBody(body) {
-    if (body === undefined) {
-        return {};
-    }
-    return {
-        headers: {
-            "Content-Type": "application/json",
-        },
-        requestBody: JSON.stringify(body),
-    };
-}
-/**
- * 读取 HTTP API 响应文本
- * @param response fetch 响应
- * @param responseFormat 响应格式
- * @returns 返回格式化文本
- * @example
- * await readCliHttpApiResponseText(response, "json")
- */
-async function readCliHttpApiResponseText(response, responseFormat) {
-    const responseText = await response.text();
-    if (responseFormat === "text") {
-        return responseText;
-    }
-    return (0, tool_utils_1.formatRuntimeJsonText)(JSON.parse(responseText));
-}
-/**
- * 构建命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms build -d
- */
-async function buildCommand(options) {
-    try {
-        const workspacePath = process.cwd();
-        const isDev = options.dev || false;
-        console.log(`🔍 检查项目目录: ${workspacePath}`);
-        await ensureValidKuaiJSProject(workspacePath);
-        console.log(`🚀 开始构建项目 (${isDev ? "开发模式" : "生产模式"})...`);
-        await (0, build_1.buildAll)(isDev, workspacePath);
-        console.log("✅ 构建完成!");
-        // console.log(
-        //   `📦 输出文件: ${path.join(workspacePath, "dist", "ms.msbundle")}`
-        // );
-    }
-    catch (error) {
-        console.error("❌ 构建失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * package 命令处理函数（生产构建 + 加密）
- * @returns 请求完成后退出
- * @example
- * ms package
- */
-async function packageCommand() {
-    try {
-        const workspacePath = process.cwd();
-        console.log(`🔍 检查项目目录: ${workspacePath}`);
-        await ensureValidKuaiJSProject(workspacePath);
-        console.log("📦 开始打包生产构建并加密 bundle...");
-        const encryptedPath = await (0, packager_1.packageProject)(workspacePath);
-        console.log(`✅ 打包完成: ${encryptedPath}`);
-    }
-    catch (error) {
-        console.error("❌ 打包失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * run 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms run --ip 192.168.1.100 --port 9800
- */
-async function runCommand(options) {
-    try {
-        const workspacePath = process.cwd();
-        await ensureValidKuaiJSProject(workspacePath);
-        await (0, project_1.runOnDevice)(options);
-    }
-    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
- */
-async function runUICommand(options) {
-    try {
-        const workspacePath = process.cwd();
-        await ensureValidKuaiJSProject(workspacePath);
-        await (0, project_1.runUIOnDevice)(options);
-    }
-    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);
-    }
-    catch (error) {
-        console.error("❌ 停止失败:", error instanceof Error ? error.message : error);
-        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 {
-        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 --mode 1
- */
-async function sourceCommand(options) {
-    try {
-        const maxDepthText = (options.maxDepth ?? "50").trim();
-        const timeoutText = (options.timeout ?? "120").trim();
-        const modeText = (options.mode ?? "1").trim();
-        const maxDepth = Number.parseInt(maxDepthText, 10);
-        const timeout = Number.parseInt(timeoutText, 10);
-        const mode = Number.parseInt(modeText, 10);
-        if (!Number.isInteger(maxDepth) || maxDepth < 1) {
-            throw new Error(`无效 max-depth: ${maxDepthText}`);
-        }
-        if (!Number.isInteger(timeout) || timeout < 1) {
-            throw new Error(`无效 timeout: ${timeoutText}`);
-        }
-        if (!Number.isInteger(mode) || (mode !== 1 && mode !== 2 && mode !== 3)) {
-            throw new Error(`无效 mode: ${modeText}`);
-        }
-        const source = await (0, project_1.getSourceOnDevice)(options, maxDepth, timeout, mode);
-        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);
-    }
-}
-/**
- * logs 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms logs --ip 192.168.1.100 --port 9800 --limit 200
- */
-async function logsCommand(options) {
-    try {
-        const limit = parseCliInteger(options.limit, 200, "limit", 1, 5000);
-        const format = parseCliChoice(options.format, "text", ["text", "json"], "format");
-        const result = await (0, project_1.getCurrentLogLinesOnDevice)(options, limit);
-        const text = format === "json"
-            ? (0, tool_utils_1.formatRuntimeJsonText)(result)
-            : result.lines.length > 0
-                ? result.lines.join("\n")
-                : "无日志";
-        await writeOrPrintText(text, options.output, "日志已保存");
-        if (format === "text" && result.hasMore && !options.output?.trim()) {
-            console.error(`还有更早日志，可增大 --limit，当前最多 ${limit} 行。`);
-        }
-    }
-    catch (error) {
-        console.error("❌ 获取日志失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * docs paths 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms docs paths
- */
-async function docsPathsCommand(options) {
-    try {
-        await writeOrPrintText(formatCliDocsPathsText(), options.output, "文档路径已保存");
-    }
-    catch (error) {
-        console.error("❌ 输出文档路径失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * http-call 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms http-call --ip 192.168.1.100 --method GET --path /api/status
- */
-async function httpCallCommand(options) {
-    try {
-        const target = parseDeviceHttpTarget(options);
-        const method = parseHttpApiMethodOption(options.method);
-        const apiPath = normalizeCliHttpApiPath(options.path ?? "");
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(apiPath, method);
-        if (!entry) {
-            throw new Error(`HTTP API 文档中不存在该接口: ${method} ${apiPath}。请先读取 docs paths 返回的 HTTP API 文档路径。`);
-        }
-        const query = parseJsonRecordOption(options.query, "query");
-        const body = parseJsonBodyOption(options.body);
-        if (method === "GET" && body !== undefined) {
-            throw new Error("GET 接口不能传 body，请使用 --query。");
-        }
-        const responseFormat = parseCliChoice(options.responseFormat, "json", ["json", "text"], "response-format");
-        const timeoutMs = parseCliInteger(options.timeoutMs, 30000, "timeout-ms", 1000, 600000);
-        const url = new URL(`http://${target.ip}:${target.port}${apiPath}`);
-        appendCliQueryParams(url, query);
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), timeoutMs);
-        try {
-            const { headers, requestBody } = createCliHttpRequestBody(body);
-            const response = await fetch(url.toString(), {
-                method,
-                signal: controller.signal,
-                headers,
-                body: requestBody,
-            });
-            const responseText = await readCliHttpApiResponseText(response, responseFormat);
-            const text = [
-                `HTTP API 调用${response.ok ? "成功" : "失败"}: ${method} ${apiPath}`,
-                `设备: ${target.label}`,
-                `文档: ${entry.title} (lines ${entry.startLine}-${entry.endLine})`,
-                `状态码: ${response.status}`,
-                "",
-                responseText,
-            ].join("\n");
-            await writeOrPrintText(text, options.output, "HTTP API 响应已保存");
-            if (!response.ok) {
-                process.exit(1);
-            }
-        }
-        finally {
-            clearTimeout(timeout);
-        }
-    }
-    catch (error) {
-        const message = error instanceof Error && error.name === "AbortError"
-            ? "请求超时"
-            : error instanceof Error
-                ? error.message
-                : String(error);
-        console.error("❌ HTTP API 调用失败:", message);
-        process.exit(1);
-    }
-}
-/**
- * ocr 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms ocr --ip 192.168.1.100 --mode recognize
- */
-async function ocrCommand(options) {
-    try {
-        const target = parseDeviceHttpTarget(options);
-        const engine = parseCliChoice(options.engine, "appleocr", ["appleocr", "paddleocr"], "engine");
-        const mode = parseCliChoice(options.mode, "recognize", ["recognize", "numbers", "findText"], "mode");
-        const input = options.input?.trim() || "screen";
-        const x = parseCliInteger(options.x, 0, "x", 0);
-        const y = parseCliInteger(options.y, 0, "y", 0);
-        const ex = parseCliInteger(options.ex, 0, "ex", 0);
-        const ey = parseCliInteger(options.ey, 0, "ey", 0);
-        const textItems = [
-            ...(parseStringArrayOption(options.texts, "texts") ?? []),
-            ...(options.text ?? []),
-        ];
-        const texts = textItems.length > 0 ? textItems : undefined;
-        const languages = parseAppleOcrLanguages(options.languages);
-        const confidenceThreshold = parseCliNumber(options.confidenceThreshold, 0.6, "confidence-threshold", 0, 1);
-        const paddleModel = options.paddleModel === undefined
-            ? undefined
-            : parseCliChoice(options.paddleModel, ocr_tools_1.PADDLE_OCR_MODELS[0], ocr_tools_1.PADDLE_OCR_MODELS, "paddle-model");
-        const maxSideLen = options.maxSideLen === undefined
-            ? undefined
-            : parseCliInteger(options.maxSideLen, 0, "max-side-len", 0);
-        const useGpu = options.useGpu === true ? true : undefined;
-        const timeoutMs = parseCliInteger(options.timeoutMs, 60000, "timeout-ms", 1000, 600000);
-        const format = parseCliChoice(options.format, "summary", ["summary", "json"], "format");
-        const result = await (0, ocr_tools_1.runOcrRecognitionOnDevice)(target, {
-            engine,
-            mode,
-            input,
-            x,
-            y,
-            ex,
-            ey,
-            texts,
-            languages,
-            confidenceThreshold,
-            exactMatch: options.exactMatch === true,
-            paddleModel,
-            maxSideLen,
-            useGpu,
-            outputPath: format === "summary" ? options.output : undefined,
-            timeoutMs,
-        });
-        const text = format === "json" ? (0, tool_utils_1.formatRuntimeJsonText)(result.body) : result.text;
-        if (format === "json") {
-            await writeOrPrintText(text, options.output, "OCR 结果已保存");
-        }
-        else {
-            console.log([
-                text,
-                "",
-                `device: ${target.label}`,
-                `engine: ${engine}`,
-                `mode: ${mode}`,
-                `input: ${input}`,
-                `region: x=${x}, y=${y}, ex=${ex}, ey=${ey}`,
-                ...(engine === "paddleocr" && paddleModel
-                    ? [`paddleModel: ${paddleModel}`]
-                    : []),
-                ...(engine === "paddleocr" && maxSideLen !== undefined
-                    ? [`maxSideLen: ${maxSideLen}`]
-                    : []),
-                `status: ${result.status}`,
-            ].join("\n"));
-        }
-        if (result.body.success === false) {
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        console.error("❌ OCR 执行失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * image-crop 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms image-crop --image ./screen.jpg --x 0 --y 0 --width 100 --height 100
- */
-async function imageCropCommand(options) {
-    try {
-        const imagePath = options.image?.trim();
-        if (!imagePath) {
-            throw new Error("请通过 --image 指定输入图片路径。");
-        }
-        const x = parseCliInteger(options.x, 0, "x", 0);
-        const y = parseCliInteger(options.y, 0, "y", 0);
-        const width = parseCliInteger(options.width, 1, "width", 1);
-        const height = parseCliInteger(options.height, 1, "height", 1);
-        const text = await (0, image_tools_1.cropLocalImage)(imagePath, x, y, width, height, options.output);
-        console.log(text);
-    }
-    catch (error) {
-        console.error("❌ 图片裁切失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * screen-crop 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms screen-crop -i 192.168.1.100 --x 0 --y 0 --width 100 --height 100
- */
-async function screenCropCommand(options) {
-    try {
-        const target = parseDeviceHttpTarget(options);
-        const x = parseCliInteger(options.x, 0, "x", 0);
-        const y = parseCliInteger(options.y, 0, "y", 0);
-        const width = parseCliInteger(options.width, 1, "width", 1);
-        const height = parseCliInteger(options.height, 1, "height", 1);
-        const text = await (0, image_tools_1.cropDeviceScreen)(target, x, y, width, height, options.output);
-        console.log(text);
-    }
-    catch (error) {
-        console.error("❌ 屏幕裁图失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * image-pick-color 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms image-pick-color --image ./screen.jpg --x 10 --y 10
- */
-async function imagePickColorCommand(options) {
-    try {
-        const imagePath = options.image?.trim();
-        if (!imagePath) {
-            throw new Error("请通过 --image 指定输入图片路径。");
-        }
-        const x = parseCliInteger(options.x, 0, "x", 0);
-        const y = parseCliInteger(options.y, 0, "y", 0);
-        const radius = parseCliInteger(options.radius, 0, "radius", 0, 20);
-        const text = await (0, image_tools_1.pickLocalImageColor)(imagePath, x, y, radius);
-        console.log(text);
-    }
-    catch (error) {
-        console.error("❌ 图片取色失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * screen-pick-color 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms screen-pick-color -i 192.168.1.100 --x 10 --y 10
- */
-async function screenPickColorCommand(options) {
-    try {
-        const target = parseDeviceHttpTarget(options);
-        const x = parseCliInteger(options.x, 0, "x", 0);
-        const y = parseCliInteger(options.y, 0, "y", 0);
-        const radius = parseCliInteger(options.radius, 0, "radius", 0, 20);
-        const text = await (0, image_tools_1.pickDeviceScreenColor)(target, x, y, radius);
-        console.log(text);
-    }
-    catch (error) {
-        console.error("❌ 屏幕取色失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * image-transparent 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms image-transparent --image ./button.png --transparent-color "#ffffff"
- */
-async function imageTransparentCommand(options) {
-    try {
-        const imagePath = options.image?.trim();
-        if (!imagePath) {
-            throw new Error("请通过 --image 指定输入图片路径。");
-        }
-        const sampleCorner = parseCliChoice(options.sampleCorner, "topLeft", ["topLeft", "topRight", "bottomLeft", "bottomRight"], "sample-corner");
-        const tolerance = parseCliInteger(options.tolerance, 24, "tolerance", 0, 441);
-        const text = await (0, image_tools_1.makeLocalImageTransparent)(imagePath, options.output, options.transparentColor, sampleCorner, tolerance);
-        console.log(text);
-    }
-    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);
-        /**
-         * 写入 WS 运行状态到临时文件，供 ws-status 命令跨进程读取
-         */
-        const writeStatus = async () => {
-            const payload = {
-                pid: process.pid,
-                port: wsPort,
-                address: ws.getAddress(),
-                startedAt: Date.now(),
-                connected: ws.isClientConnected(),
-                clientIp: ws.getConnectedClientIp(),
-            };
-            await fsExtra.writeJSON(WS_PID_FILE, payload);
-        };
-        await writeStatus();
-        const statusTimer = setInterval(() => {
-            writeStatus().catch(() => {
-                // ignore periodic write errors
-            });
-        }, 1000);
-        await fsExtra.writeJSON(WS_PID_FILE, {
-            pid: process.pid,
-            port: wsPort,
-            address: ws.getAddress(),
-            startedAt: Date.now(),
-            connected: ws.isClientConnected(),
-            clientIp: ws.getConnectedClientIp(),
-        });
-        await new Promise((resolve) => {
-            const shutdown = async () => {
-                process.off("SIGINT", shutdown);
-                process.off("SIGTERM", shutdown);
-                clearInterval(statusTimer);
-                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(JSON.stringify({
-            status: "stopped",
-            running: false,
-            pid: null,
-            address: null,
-            connected: false,
-            clientIp: null,
-        }));
-        return;
-    }
-    const info = await fsExtra.readJSON(WS_PID_FILE);
-    const pid = Number(info.pid);
-    const address = String(info.address || "unknown");
-    const connected = Boolean(info.connected);
-    const clientIp = info.clientIp === null || info.clientIp === undefined
-        ? null
-        : String(info.clientIp);
-    let running = false;
-    try {
-        process.kill(pid, 0);
-        running = true;
-    }
-    catch {
-        running = false;
-    }
-    if (!running) {
-        await fsExtra.remove(WS_PID_FILE);
-        console.log(JSON.stringify({
-            status: "stopped",
-            running: false,
-            pid: null,
-            address: null,
-            connected: false,
-            clientIp: null,
-        }));
-        return;
-    }
-    console.log(JSON.stringify({
-        status: "running",
-        running: true,
-        pid,
-        address,
-        connected,
-        clientIp: connected ? clientIp || "unknown" : null,
-    }));
-}
-/**
- * 生成顶层 help 的详细命令参数说明
- * @returns 返回格式化后的帮助文本
- * @example
- * renderDetailedCommandHelp()
- */
-function renderDetailedCommandHelp() {
-    const lines = [];
-    lines.push("");
-    lines.push("详细命令参数:");
-    const commands = commander_1.program.commands.filter((cmd) => cmd.name() !== "help");
-    for (const cmd of commands) {
-        lines.push(`  ${cmd.name()}:`);
-        if (cmd.options.length === 0) {
-            lines.push("    (无额外参数)");
-            continue;
-        }
-        for (const opt of cmd.options) {
-            const defaultText = opt.defaultValue !== undefined && opt.defaultValue !== null
-                ? ` (默认: ${String(opt.defaultValue)})`
-                : "";
-            const desc = opt.description
-                ? `  ${opt.description}${defaultText}`
-                : defaultText;
-            lines.push(`    ${opt.flags}${desc}`);
-        }
-    }
-    lines.push("");
-    return lines.join("\n");
-}
-// 配置 CLI 程序
-commander_1.program.name("ms-cli").description("快点JS 构建工具").version(version_1.PACKAGE_VERSION);
-commander_1.program.addHelpText("after", renderDetailedCommandHelp);
-// 构建命令
-commander_1.program
-    .command("build")
-    .description("构建 快点JS 项目")
-    .option("-d, --dev", "开发模式构建 (包含 source map)")
-    .action(buildCommand);
-// 打包命令
-commander_1.program
-    .command("package")
-    .description("生产构建并加密 ms.msbundle")
-    .action(packageCommand);
-// 运行命令
-commander_1.program
-    .command("run")
-    .description("在设备上运行项目")
-    .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")
-    .action(runCommand);
-// UI 预览命令
-commander_1.program
-    .command("run-ui")
-    .description("在设备上预览 UI")
-    .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")
-    .action(runUICommand);
-// 停止命令
-commander_1.program
-    .command("stop")
-    .description("停止设备上的项目")
-    .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")
-    .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("--mode <mode>", "节点抓取模式: 1=模式1, 2=模式2, 3=模式3", "1")
-    .option("--output <output>", "节点 XML 输出文件路径（可选）")
-    .action(sourceCommand);
-// 日志命令
-commander_1.program
-    .command("logs")
-    .description("获取设备当前日志最新行")
-    .option("-i, --ip <ip>", "设备 IP 地址")
-    .option("--port <port>", "设备端口", "9800")
-    .option("--limit <limit>", "读取最新日志行数，范围 1..5000", "200")
-    .option("--format <format>", "返回格式: text|json", "text")
-    .option("--output <output>", "日志输出文件路径（可选）")
-    .action(logsCommand);
-// OCR 命令
-commander_1.program
-    .command("ocr")
-    .description("在设备上执行 OCR 识别")
-    .option("-i, --ip <ip>", "设备 IP 地址")
-    .option("--port <port>", "设备端口", "9800")
-    .option("--engine <engine>", "OCR 引擎: appleocr|paddleocr", "appleocr")
-    .option("--mode <mode>", "OCR 模式: recognize|numbers|findText", "recognize")
-    .option("--input <input>", '输入源，默认 "screen"', "screen")
-    .option("--x <x>", "区域左上角 x", "0")
-    .option("--y <y>", "区域左上角 y", "0")
-    .option("--ex <ex>", "区域右下角 x；全屏可传 0", "0")
-    .option("--ey <ey>", "区域右下角 y；全屏可传 0", "0")
-    .option("--text <text>", "findText 文本，可重复", collectStringOption, [])
-    .option("--texts <texts>", "findText 文本数组，支持 JSON 数组或逗号分隔")
-    .option("--languages <languages>", "Apple OCR 语言，支持 JSON 数组或逗号分隔")
-    .option("--exact-match", "findText 要求完整匹配文本")
-    .option("--confidence-threshold <confidenceThreshold>", "PaddleOCR 置信度阈值", "0.6")
-    .option("--paddle-model <paddleModel>", "仅 paddleocr：切换模型 ppocr-v6-tiny|ppocr-v6-small|ppocr-v5")
-    .option("--max-side-len <maxSideLen>", "仅 paddleocr：检测最大边长，0 回落默认 768")
-    .option("--use-gpu", "仅 paddleocr：切换模型时启用 GPU")
-    .option("--timeout-ms <timeoutMs>", "请求超时时间(毫秒)", "60000")
-    .option("--format <format>", "返回格式: summary|json", "summary")
-    .option("--output <output>", "OCR 输出文件路径（可选）")
-    .action(ocrCommand);
-// 本地图片裁切命令
-commander_1.program
-    .command("image-crop")
-    .description("裁切本地图片并输出 PNG")
-    .requiredOption("--image <image>", "输入图片路径")
-    .option("--x <x>", "裁切起点 x", "0")
-    .option("--y <y>", "裁切起点 y", "0")
-    .requiredOption("--width <width>", "裁切宽度")
-    .requiredOption("--height <height>", "裁切高度")
-    .option("--output <output>", "输出 PNG 路径（可选）")
-    .action(imageCropCommand);
-// 设备截图裁切命令
-commander_1.program
-    .command("screen-crop")
-    .description("从设备截图中裁切 PNG")
-    .option("-i, --ip <ip>", "设备 IP 地址")
-    .option("--port <port>", "设备端口", "9800")
-    .option("--x <x>", "裁切起点 x", "0")
-    .option("--y <y>", "裁切起点 y", "0")
-    .requiredOption("--width <width>", "裁切宽度")
-    .requiredOption("--height <height>", "裁切高度")
-    .option("--output <output>", "输出 PNG 路径（可选）")
-    .action(screenCropCommand);
-// 本地图片取色命令
-commander_1.program
-    .command("image-pick-color")
-    .description("读取本地图片指定坐标颜色")
-    .requiredOption("--image <image>", "输入图片路径")
-    .option("--x <x>", "目标坐标 x", "0")
-    .option("--y <y>", "目标坐标 y", "0")
-    .option("--radius <radius>", "采样半径，范围 0..20", "0")
-    .action(imagePickColorCommand);
-// 设备截图取色命令
-commander_1.program
-    .command("screen-pick-color")
-    .description("读取设备截图指定坐标颜色")
-    .option("-i, --ip <ip>", "设备 IP 地址")
-    .option("--port <port>", "设备端口", "9800")
-    .option("--x <x>", "目标坐标 x", "0")
-    .option("--y <y>", "目标坐标 y", "0")
-    .option("--radius <radius>", "采样半径，范围 0..20", "0")
-    .action(screenPickColorCommand);
-// 本地图片透明化命令
-commander_1.program
-    .command("image-transparent")
-    .description("将图片中接近指定颜色或角落背景色的像素设为透明")
-    .requiredOption("--image <image>", "输入图片路径")
-    .option("--output <output>", "输出 PNG 路径（可选）")
-    .option("--transparent-color <transparentColor>", "透明化颜色，格式 #RRGGBB")
-    .option("--sample-corner <sampleCorner>", "未传 transparent-color 时采样角落: topLeft|topRight|bottomLeft|bottomRight", "topLeft")
-    .option("--tolerance <tolerance>", "RGB 欧氏距离容差，范围 0..441", "24")
-    .action(imageTransparentCommand);
-// API 文档命令
-const docsCommand = commander_1.program
-    .command("docs")
-    .description("显示 KuaiJS 本地文档路径");
-docsCommand
-    .command("paths")
-    .description("显示 KuaiJS 本地文档路径")
-    .option("--output <output>", "输出文件路径（可选）")
-    .action(docsPathsCommand);
-// HTTP API 调用命令
-commander_1.program
-    .command("http-call")
-    .description("按 HTTP API 文档声明调用设备接口")
-    .option("-i, --ip <ip>", "设备 IP 地址")
-    .option("--port <port>", "设备端口", "9800")
-    .requiredOption("--method <method>", "HTTP 方法: GET|POST")
-    .requiredOption("--path <path>", "HTTP API 相对路径，例如 /api/status")
-    .option("--query <query>", "JSON 对象 query 参数")
-    .option("--body <body>", "JSON 请求体；普通字符串会作为 JSON 字符串提交")
-    .option("--response-format <responseFormat>", "响应格式: json|text", "json")
-    .option("--timeout-ms <timeoutMs>", "请求超时时间(毫秒)", "30000")
-    .option("--output <output>", "响应输出文件路径（可选）")
-    .action(httpCallCommand);
-// WS 服务启动命令
-commander_1.program
-    .command("ws-start")
-    .description("启动 CLI 内置 WS 服务")
-    .option("--ws-port <wsPort>", "WS 服务端口", "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();
+"use strict";var R=exports&&exports.__createBinding||(Object.create?(function(e,t,r,o){o===void 0&&(o=r);var n=Object.getOwnPropertyDescriptor(t,r);(!n||("get"in n?!t.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,o,n)}):(function(e,t,r,o){o===void 0&&(o=r),e[o]=t[r]})),J=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),N=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var o=[];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(o[o.length]=n);return o},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var o=e(t),n=0;n<o.length;n++)o[n]!=="default"&&R(r,t,o[n]);return J(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0});const c=require("commander"),M=N(require("os")),m=N(require("path")),G=require("./build"),p=N(require("fs-extra")),h=require("./project"),W=require("./packager"),H=require("./ws-manager"),k=require("./version"),A=require("./mcp/docs-service"),L=require("./mcp/httpapi-docs-service"),j=require("./mcp/tool-utils"),B=require("./mcp/types"),x=require("./mcp/ocr-tools"),P=require("./mcp/image-tools"),d=m.join(M.tmpdir(),"ms-cli-ws-server.json");async function U(e){try{const t=m.join(e,"package.json"),r=m.join(e,"scripts"),[o,n]=await Promise.all([p.pathExists(t),p.pathExists(r)]);return o&&n}catch{return!1}}async function C(e){await U(e)||(console.error("\u274C \u9519\u8BEF: \u5F53\u524D\u76EE\u5F55\u4E0D\u662F\u6709\u6548\u7684 \u5FEB\u70B9JS \u9879\u76EE"),console.error("\u8BF7\u786E\u4FDD\u76EE\u5F55\u5305\u542B\u4EE5\u4E0B\u6587\u4EF6:"),console.error("  - package.json"),console.error("  - scripts/ \u76EE\u5F55"),process.exit(1))}function a(e,t,r,o,n){const i=(e??String(t)).trim(),s=Number.parseInt(i,10);if(!Number.isInteger(s)||s<o||n!==void 0&&s>n)throw new Error(`\u65E0\u6548 ${r}: ${i}\uFF0C\u5141\u8BB8\u8303\u56F4 ${o}${n===void 0?"+":`..${n}`}`);return s}function F(e,t,r,o,n){const i=(e??String(t)).trim(),s=Number.parseFloat(i);if(!Number.isFinite(s)||s<o||s>n)throw new Error(`\u65E0\u6548 ${r}: ${i}\uFF0C\u5141\u8BB8\u8303\u56F4 ${o}..${n}`);return s}function g(e,t,r,o){const n=(e??t).trim();if(!r.includes(n))throw new Error(`\u65E0\u6548 ${o}: ${n}\uFF0C\u53EF\u9009\u503C: ${r.join("|")}`);return n}function V(e){const t=e?.trim().toUpperCase();return g(t,"GET",["GET","POST"],"method")}function E(e){const t=e.ip?.trim();if(!t)throw new Error("\u8BF7\u901A\u8FC7 --ip \u6307\u5B9A\u8BBE\u5907 IP \u5730\u5740");const r=a(e.port,9800,"port",1,65535);return{ip:t,port:String(r),label:`${t}:${r}`}}async function $(e,t,r){if(t?.trim()){const o=m.resolve(t.trim());await p.ensureDir(m.dirname(o)),await p.writeFile(o,e,"utf8"),console.log(`\u2705 ${r}: ${o}`);return}console.log(e)}function z(){const e=["js","js_zh","python"];return["KuaiJS \u6587\u6863\u8DEF\u5F84:",`docsRoot: ${(0,A.getDocsRootDir)()}`,...e.map(t=>`${t}: ${(0,A.getDocsDirByLanguage)(t)} (${B.DOC_LANGUAGE_LABELS[t]})`),`httpApi: ${(0,L.getHttpApiDocPath)()}`,"\u8BF4\u660E: \u76F4\u63A5\u8BFB\u53D6\u4E0A\u8FF0 markdown \u8DEF\u5F84\u3002"].join(`
+`)}function K(e,t){return t.push(e),t}function q(e,t){const r=e?.trim();if(!r)return;if(r.startsWith("[")){const n=JSON.parse(r);if(!Array.isArray(n)||!n.every(i=>typeof i=="string"&&i.trim()))throw new Error(`${t} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32\u6570\u7EC4\u3002`);return n.map(i=>i.trim())}const o=r.split(",").map(n=>n.trim()).filter(n=>n.length>0);if(o.length===0)throw new Error(`${t} \u4E0D\u80FD\u4E3A\u7A7A\u3002`);return o}function X(e){const t=q(e,"languages");if(!t)return;const r=new Set(x.APPLE_OCR_LANGUAGES),o=t.filter(n=>!r.has(n));if(o.length>0)throw new Error(`\u65E0\u6548 languages: ${o.join(", ")}\uFF0C\u53EF\u9009\u503C: ${x.APPLE_OCR_LANGUAGES.join(", ")}`);return t}function Q(e,t){const r=e?.trim();if(!r)return;const o=JSON.parse(r);if(!o||typeof o!="object"||Array.isArray(o)||!Object.values(o).every(n=>typeof n=="string"||typeof n=="number"||typeof n=="boolean"||n===null))throw new Error(`${t} \u5FC5\u987B\u662F JSON \u5BF9\u8C61\uFF0C\u4E14\u503C\u53EA\u80FD\u662F string/number/boolean/null\u3002`);return o}function Y(e){const t=e?.trim();if(!(t===void 0||t.length===0))try{return JSON.parse(t)}catch{return e}}function Z(e){const t=e.trim();if(/^https?:\/\//i.test(t))throw new Error("path \u53EA\u80FD\u4F20 HTTP API \u76F8\u5BF9\u8DEF\u5F84\uFF0C\u4E0D\u80FD\u4F20\u5B8C\u6574 URL\u3002");if(!t.startsWith("/"))throw new Error("path \u5FC5\u987B\u4EE5 / \u5F00\u5934\uFF0C\u4F8B\u5982 /api/status\u3002");if(t.includes("?"))throw new Error("path \u4E0D\u80FD\u5305\u542B query string\uFF0C\u8BF7\u4F7F\u7528 --query \u4F20\u9012\u67E5\u8BE2\u53C2\u6570\u3002");return t}function tt(e,t){if(t)for(const[r,o]of Object.entries(t))o!==null&&e.searchParams.set(r,String(o))}function et(e){return e===void 0?{}:{headers:{"Content-Type":"application/json"},requestBody:JSON.stringify(e)}}async function ot(e,t){const r=await e.text();return t==="text"?r:(0,j.formatRuntimeJsonText)(JSON.parse(r))}async function rt(e){try{const t=process.cwd(),r=e.dev||!1;console.log(`\u{1F50D} \u68C0\u67E5\u9879\u76EE\u76EE\u5F55: ${t}`),await C(t),console.log(`\u{1F680} \u5F00\u59CB\u6784\u5EFA\u9879\u76EE (${r?"\u5F00\u53D1\u6A21\u5F0F":"\u751F\u4EA7\u6A21\u5F0F"})...`),await(0,G.buildAll)(r,t),console.log("\u2705 \u6784\u5EFA\u5B8C\u6210!")}catch(t){console.error("\u274C \u6784\u5EFA\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function nt(){try{const e=process.cwd();console.log(`\u{1F50D} \u68C0\u67E5\u9879\u76EE\u76EE\u5F55: ${e}`),await C(e),console.log("\u{1F4E6} \u5F00\u59CB\u6253\u5305\u751F\u4EA7\u6784\u5EFA\u5E76\u52A0\u5BC6 bundle...");const t=await(0,W.packageProject)(e);console.log(`\u2705 \u6253\u5305\u5B8C\u6210: ${t}`)}catch(e){console.error("\u274C \u6253\u5305\u5931\u8D25:",e instanceof Error?e.message:e),process.exit(1)}}async function it(e){try{const t=process.cwd();await C(t),await(0,h.runOnDevice)(e)}catch(t){console.error("\u274C \u8FD0\u884C\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function st(e){try{const t=process.cwd();await C(t),await(0,h.runUIOnDevice)(e)}catch(t){console.error("\u274C UI \u9884\u89C8\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function at(e){try{await(0,h.stopOnDevice)(e)}catch(t){console.error("\u274C \u505C\u6B62\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function ct(e){try{if((e.format??"file")==="base64"){const n=await(0,h.getScreenshotBase64OnDevice)(e);console.log(n);return}const r=await(0,h.getScreenshotOnDevice)(e),o=e.output?.trim()?m.resolve(e.output.trim()):m.resolve(process.cwd(),"screenshot.jpg");await p.ensureDir(m.dirname(o)),await p.writeFile(o,r),console.log(`\u2705 \u622A\u56FE\u6210\u529F: ${o} (${r.length} bytes)`)}catch(t){console.error("\u274C \u622A\u56FE\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function pt(e){try{const t=(e.maxDepth??"50").trim(),r=(e.timeout??"120").trim(),o=(e.mode??"1").trim(),n=Number.parseInt(t,10),i=Number.parseInt(r,10),s=Number.parseInt(o,10);if(!Number.isInteger(n)||n<1)throw new Error(`\u65E0\u6548 max-depth: ${t}`);if(!Number.isInteger(i)||i<1)throw new Error(`\u65E0\u6548 timeout: ${r}`);if(!Number.isInteger(s)||s!==1&&s!==2&&s!==3)throw new Error(`\u65E0\u6548 mode: ${o}`);const u=await(0,h.getSourceOnDevice)(e,n,i,s);if(e.output?.trim()){const l=m.resolve(e.output.trim());await p.ensureDir(m.dirname(l)),await p.writeFile(l,u,"utf8"),console.log(`\u2705 \u8282\u70B9\u5DF2\u4FDD\u5B58: ${l}`);return}console.log(u)}catch(t){console.error("\u274C \u83B7\u53D6\u8282\u70B9\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function ut(e){try{const t=a(e.limit,200,"limit",1,5e3),r=g(e.format,"text",["text","json"],"format"),o=await(0,h.getCurrentLogLinesOnDevice)(e,t),n=r==="json"?(0,j.formatRuntimeJsonText)(o):o.lines.length>0?o.lines.join(`
+`):"\u65E0\u65E5\u5FD7";await $(n,e.output,"\u65E5\u5FD7\u5DF2\u4FDD\u5B58"),r==="text"&&o.hasMore&&!e.output?.trim()&&console.error(`\u8FD8\u6709\u66F4\u65E9\u65E5\u5FD7\uFF0C\u53EF\u589E\u5927 --limit\uFF0C\u5F53\u524D\u6700\u591A ${t} \u884C\u3002`)}catch(t){console.error("\u274C \u83B7\u53D6\u65E5\u5FD7\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function mt(e){try{await $(z(),e.output,"\u6587\u6863\u8DEF\u5F84\u5DF2\u4FDD\u5B58")}catch(t){console.error("\u274C \u8F93\u51FA\u6587\u6863\u8DEF\u5F84\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function dt(e){try{const t=E(e),r=V(e.method),o=Z(e.path??""),n=await(0,L.findHttpApiDocEntry)(o,r);if(!n)throw new Error(`HTTP API \u6587\u6863\u4E2D\u4E0D\u5B58\u5728\u8BE5\u63A5\u53E3: ${r} ${o}\u3002\u8BF7\u5148\u8BFB\u53D6 docs paths \u8FD4\u56DE\u7684 HTTP API \u6587\u6863\u8DEF\u5F84\u3002`);const i=Q(e.query,"query"),s=Y(e.body);if(r==="GET"&&s!==void 0)throw new Error("GET \u63A5\u53E3\u4E0D\u80FD\u4F20 body\uFF0C\u8BF7\u4F7F\u7528 --query\u3002");const u=g(e.responseFormat,"json",["json","text"],"response-format"),l=a(e.timeoutMs,3e4,"timeout-ms",1e3,6e5),w=new URL(`http://${t.ip}:${t.port}${o}`);tt(w,i);const S=new AbortController,I=setTimeout(()=>S.abort(),l);try{const{headers:b,requestBody:y}=et(s),f=await fetch(w.toString(),{method:r,signal:S.signal,headers:b,body:y}),T=await ot(f,u),_=[`HTTP API \u8C03\u7528${f.ok?"\u6210\u529F":"\u5931\u8D25"}: ${r} ${o}`,`\u8BBE\u5907: ${t.label}`,`\u6587\u6863: ${n.title} (lines ${n.startLine}-${n.endLine})`,`\u72B6\u6001\u7801: ${f.status}`,"",T].join(`
+`);await $(_,e.output,"HTTP API \u54CD\u5E94\u5DF2\u4FDD\u5B58"),f.ok||process.exit(1)}finally{clearTimeout(I)}}catch(t){const r=t instanceof Error&&t.name==="AbortError"?"\u8BF7\u6C42\u8D85\u65F6":t instanceof Error?t.message:String(t);console.error("\u274C HTTP API \u8C03\u7528\u5931\u8D25:",r),process.exit(1)}}async function lt(e){try{const t=E(e),r=g(e.engine,"appleocr",["appleocr","paddleocr"],"engine"),o=g(e.mode,"recognize",["recognize","numbers","findText"],"mode"),n=e.input?.trim()||"screen",i=a(e.x,0,"x",0),s=a(e.y,0,"y",0),u=a(e.ex,0,"ex",0),l=a(e.ey,0,"ey",0),w=[...q(e.texts,"texts")??[],...e.text??[]],S=w.length>0?w:void 0,I=X(e.languages),b=F(e.confidenceThreshold,.6,"confidence-threshold",0,1),y=e.paddleModel===void 0?void 0:g(e.paddleModel,x.PADDLE_OCR_MODELS[0],x.PADDLE_OCR_MODELS,"paddle-model"),f=e.maxSideLen===void 0?void 0:a(e.maxSideLen,0,"max-side-len",0),T=e.useGpu===!0?!0:void 0,_=a(e.timeoutMs,6e4,"timeout-ms",1e3,6e5),v=g(e.format,"summary",["summary","json"],"format"),O=await(0,x.runOcrRecognitionOnDevice)(t,{engine:r,mode:o,input:n,x:i,y:s,ex:u,ey:l,texts:S,languages:I,confidenceThreshold:b,exactMatch:e.exactMatch===!0,paddleModel:y,maxSideLen:f,useGpu:T,outputPath:v==="summary"?e.output:void 0,timeoutMs:_}),D=v==="json"?(0,j.formatRuntimeJsonText)(O.body):O.text;v==="json"?await $(D,e.output,"OCR \u7ED3\u679C\u5DF2\u4FDD\u5B58"):console.log([D,"",`device: ${t.label}`,`engine: ${r}`,`mode: ${o}`,`input: ${n}`,`region: x=${i}, y=${s}, ex=${u}, ey=${l}`,...r==="paddleocr"&&y?[`paddleModel: ${y}`]:[],...r==="paddleocr"&&f!==void 0?[`maxSideLen: ${f}`]:[],`status: ${O.status}`].join(`
+`)),O.body.success===!1&&process.exit(1)}catch(t){console.error("\u274C OCR \u6267\u884C\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function ft(e){try{const t=e.image?.trim();if(!t)throw new Error("\u8BF7\u901A\u8FC7 --image \u6307\u5B9A\u8F93\u5165\u56FE\u7247\u8DEF\u5F84\u3002");const r=a(e.x,0,"x",0),o=a(e.y,0,"y",0),n=a(e.width,1,"width",1),i=a(e.height,1,"height",1),s=await(0,P.cropLocalImage)(t,r,o,n,i,e.output);console.log(s)}catch(t){console.error("\u274C \u56FE\u7247\u88C1\u5207\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function gt(e){try{const t=E(e),r=a(e.x,0,"x",0),o=a(e.y,0,"y",0),n=a(e.width,1,"width",1),i=a(e.height,1,"height",1),s=await(0,P.cropDeviceScreen)(t,r,o,n,i,e.output);console.log(s)}catch(t){console.error("\u274C \u5C4F\u5E55\u88C1\u56FE\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function ht(e){try{const t=e.image?.trim();if(!t)throw new Error("\u8BF7\u901A\u8FC7 --image \u6307\u5B9A\u8F93\u5165\u56FE\u7247\u8DEF\u5F84\u3002");const r=a(e.x,0,"x",0),o=a(e.y,0,"y",0),n=a(e.radius,0,"radius",0,20),i=await(0,P.pickLocalImageColor)(t,r,o,n);console.log(i)}catch(t){console.error("\u274C \u56FE\u7247\u53D6\u8272\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function wt(e){try{const t=E(e),r=a(e.x,0,"x",0),o=a(e.y,0,"y",0),n=a(e.radius,0,"radius",0,20),i=await(0,P.pickDeviceScreenColor)(t,r,o,n);console.log(i)}catch(t){console.error("\u274C \u5C4F\u5E55\u53D6\u8272\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function yt(e){try{const t=e.image?.trim();if(!t)throw new Error("\u8BF7\u901A\u8FC7 --image \u6307\u5B9A\u8F93\u5165\u56FE\u7247\u8DEF\u5F84\u3002");const r=g(e.sampleCorner,"topLeft",["topLeft","topRight","bottomLeft","bottomRight"],"sample-corner"),o=a(e.tolerance,24,"tolerance",0,441),n=await(0,P.makeLocalImageTransparent)(t,e.output,e.transparentColor,r,o);console.log(n)}catch(t){console.error("\u274C \u900F\u660E\u56FE\u5236\u4F5C\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function xt(e){try{const t=(e.wsPort??"31111").trim(),r=Number.parseInt(t,10);if(!Number.isInteger(r)||r<1||r>65535)throw new Error(`\u65E0\u6548 ws \u7AEF\u53E3: ${t}`);const o=H.WSManager.get();await o.start(r);const n=async()=>{const s={pid:process.pid,port:r,address:o.getAddress(),startedAt:Date.now(),connected:o.isClientConnected(),clientIp:o.getConnectedClientIp()};await p.writeJSON(d,s)};await n();const i=setInterval(()=>{n().catch(()=>{})},1e3);await p.writeJSON(d,{pid:process.pid,port:r,address:o.getAddress(),startedAt:Date.now(),connected:o.isClientConnected(),clientIp:o.getConnectedClientIp()}),await new Promise(s=>{const u=async()=>{process.off("SIGINT",u),process.off("SIGTERM",u),clearInterval(i),await o.stop(),await p.remove(d),s()};process.on("SIGINT",u),process.on("SIGTERM",u)})}catch(t){console.error("\u274C WS \u670D\u52A1\u542F\u52A8\u5931\u8D25:",t instanceof Error?t.message:t),process.exit(1)}}async function Pt(){try{if(!await p.pathExists(d)){console.log("WS \u670D\u52A1\u672A\u8FD0\u884C");return}const e=await p.readJSON(d),t=Number(e.pid);if(!Number.isInteger(t)||t<=0)throw await p.remove(d),new Error("WS PID \u6587\u4EF6\u635F\u574F");try{process.kill(t,"SIGTERM"),console.log(`\u2705 \u5DF2\u53D1\u9001\u505C\u6B62\u4FE1\u53F7\u5230 WS \u8FDB\u7A0B: ${t}`)}catch{console.log("WS \u8FDB\u7A0B\u4E0D\u5B58\u5728\uFF0C\u6E05\u7406 PID \u6587\u4EF6")}await p.remove(d)}catch(e){console.error("\u274C WS \u670D\u52A1\u505C\u6B62\u5931\u8D25:",e instanceof Error?e.message:e),process.exit(1)}}async function St(){if(!await p.pathExists(d)){console.log(JSON.stringify({status:"stopped",running:!1,pid:null,address:null,connected:!1,clientIp:null}));return}const e=await p.readJSON(d),t=Number(e.pid),r=String(e.address||"unknown"),o=!!e.connected,n=e.clientIp===null||e.clientIp===void 0?null:String(e.clientIp);let i=!1;try{process.kill(t,0),i=!0}catch{i=!1}if(!i){await p.remove(d),console.log(JSON.stringify({status:"stopped",running:!1,pid:null,address:null,connected:!1,clientIp:null}));return}console.log(JSON.stringify({status:"running",running:!0,pid:t,address:r,connected:o,clientIp:o?n||"unknown":null}))}function Ot(){const e=[];e.push(""),e.push("\u8BE6\u7EC6\u547D\u4EE4\u53C2\u6570:");const t=c.program.commands.filter(r=>r.name()!=="help");for(const r of t){if(e.push(`  ${r.name()}:`),r.options.length===0){e.push("    (\u65E0\u989D\u5916\u53C2\u6570)");continue}for(const o of r.options){const n=o.defaultValue!==void 0&&o.defaultValue!==null?` (\u9ED8\u8BA4: ${String(o.defaultValue)})`:"",i=o.description?`  ${o.description}${n}`:n;e.push(`    ${o.flags}${i}`)}}return e.push(""),e.join(`
+`)}c.program.name("ms-cli").description("\u5FEB\u70B9JS \u6784\u5EFA\u5DE5\u5177").version(k.PACKAGE_VERSION),c.program.addHelpText("after",Ot),c.program.command("build").description("\u6784\u5EFA \u5FEB\u70B9JS \u9879\u76EE").option("-d, --dev","\u5F00\u53D1\u6A21\u5F0F\u6784\u5EFA (\u5305\u542B source map)").action(rt),c.program.command("package").description("\u751F\u4EA7\u6784\u5EFA\u5E76\u52A0\u5BC6 ms.msbundle").action(nt),c.program.command("run").description("\u5728\u8BBE\u5907\u4E0A\u8FD0\u884C\u9879\u76EE").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740\uFF08transport=http \u65F6\u5FC5\u586B\uFF09").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("-t, --transport <transport>","\u4F20\u8F93\u65B9\u5F0F: http|ws","http").option("--ws-port <wsPort>","WS \u670D\u52A1\u7AEF\u53E3","31111").option("--ws-wait-ms <wsWaitMs>","WS \u7B49\u5F85\u8BBE\u5907\u8FDE\u63A5\u65F6\u95F4(\u6BEB\u79D2)","30000").action(it),c.program.command("run-ui").description("\u5728\u8BBE\u5907\u4E0A\u9884\u89C8 UI").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740\uFF08transport=http \u65F6\u5FC5\u586B\uFF09").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("-t, --transport <transport>","\u4F20\u8F93\u65B9\u5F0F: http|ws","http").option("--ws-port <wsPort>","WS \u670D\u52A1\u7AEF\u53E3","31111").option("--ws-wait-ms <wsWaitMs>","WS \u7B49\u5F85\u8BBE\u5907\u8FDE\u63A5\u65F6\u95F4(\u6BEB\u79D2)","30000").action(st),c.program.command("stop").description("\u505C\u6B62\u8BBE\u5907\u4E0A\u7684\u9879\u76EE").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740\uFF08transport=http \u65F6\u5FC5\u586B\uFF09").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("-t, --transport <transport>","\u4F20\u8F93\u65B9\u5F0F: http|ws","http").option("--ws-port <wsPort>","WS \u670D\u52A1\u7AEF\u53E3","31111").option("--ws-wait-ms <wsWaitMs>","WS \u7B49\u5F85\u8BBE\u5907\u8FDE\u63A5\u65F6\u95F4(\u6BEB\u79D2)","30000").action(at),c.program.command("screenshot").description("\u83B7\u53D6\u8BBE\u5907\u622A\u56FE\uFF08JPG\uFF09").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740\uFF08transport=http \u65F6\u5FC5\u586B\uFF09").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("-t, --transport <transport>","\u4F20\u8F93\u65B9\u5F0F: http|ws","http").option("--ws-port <wsPort>","WS \u670D\u52A1\u7AEF\u53E3","31111").option("--ws-wait-ms <wsWaitMs>","WS \u7B49\u5F85\u8BBE\u5907\u8FDE\u63A5\u65F6\u95F4(\u6BEB\u79D2)","30000").option("--format <format>","\u8FD4\u56DE\u683C\u5F0F: file|base64","file").option("--output <output>","\u622A\u56FE\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08format=file \u65F6\u751F\u6548\uFF09").action(ct),c.program.command("source").description("\u83B7\u53D6\u8BBE\u5907\u5F53\u524D\u9875\u9762\u8282\u70B9 XML").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740\uFF08transport=http \u65F6\u5FC5\u586B\uFF09").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("-t, --transport <transport>","\u4F20\u8F93\u65B9\u5F0F: http|ws","http").option("--ws-port <wsPort>","WS \u670D\u52A1\u7AEF\u53E3","31111").option("--ws-wait-ms <wsWaitMs>","WS \u7B49\u5F85\u8BBE\u5907\u8FDE\u63A5\u65F6\u95F4(\u6BEB\u79D2)","30000").option("--max-depth <maxDepth>","\u8282\u70B9\u6700\u5927\u6DF1\u5EA6","50").option("--timeout <timeout>","\u8282\u70B9\u6293\u53D6\u8D85\u65F6\u79D2\u6570","120").option("--mode <mode>","\u8282\u70B9\u6293\u53D6\u6A21\u5F0F: 1=\u6A21\u5F0F1, 2=\u6A21\u5F0F2, 3=\u6A21\u5F0F3","1").option("--output <output>","\u8282\u70B9 XML \u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08\u53EF\u9009\uFF09").action(pt),c.program.command("logs").description("\u83B7\u53D6\u8BBE\u5907\u5F53\u524D\u65E5\u5FD7\u6700\u65B0\u884C").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("--limit <limit>","\u8BFB\u53D6\u6700\u65B0\u65E5\u5FD7\u884C\u6570\uFF0C\u8303\u56F4 1..5000","200").option("--format <format>","\u8FD4\u56DE\u683C\u5F0F: text|json","text").option("--output <output>","\u65E5\u5FD7\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08\u53EF\u9009\uFF09").action(ut),c.program.command("ocr").description("\u5728\u8BBE\u5907\u4E0A\u6267\u884C OCR \u8BC6\u522B").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("--engine <engine>","OCR \u5F15\u64CE: appleocr|paddleocr","appleocr").option("--mode <mode>","OCR \u6A21\u5F0F: recognize|numbers|findText","recognize").option("--input <input>",'\u8F93\u5165\u6E90\uFF0C\u9ED8\u8BA4 "screen"',"screen").option("--x <x>","\u533A\u57DF\u5DE6\u4E0A\u89D2 x","0").option("--y <y>","\u533A\u57DF\u5DE6\u4E0A\u89D2 y","0").option("--ex <ex>","\u533A\u57DF\u53F3\u4E0B\u89D2 x\uFF1B\u5168\u5C4F\u53EF\u4F20 0","0").option("--ey <ey>","\u533A\u57DF\u53F3\u4E0B\u89D2 y\uFF1B\u5168\u5C4F\u53EF\u4F20 0","0").option("--text <text>","findText \u6587\u672C\uFF0C\u53EF\u91CD\u590D",K,[]).option("--texts <texts>","findText \u6587\u672C\u6570\u7EC4\uFF0C\u652F\u6301 JSON \u6570\u7EC4\u6216\u9017\u53F7\u5206\u9694").option("--languages <languages>","Apple OCR \u8BED\u8A00\uFF0C\u652F\u6301 JSON \u6570\u7EC4\u6216\u9017\u53F7\u5206\u9694").option("--exact-match","findText \u8981\u6C42\u5B8C\u6574\u5339\u914D\u6587\u672C").option("--confidence-threshold <confidenceThreshold>","PaddleOCR \u7F6E\u4FE1\u5EA6\u9608\u503C","0.6").option("--paddle-model <paddleModel>","\u4EC5 paddleocr\uFF1A\u5207\u6362\u6A21\u578B ppocr-v6-tiny|ppocr-v6-small|ppocr-v5").option("--max-side-len <maxSideLen>","\u4EC5 paddleocr\uFF1A\u68C0\u6D4B\u6700\u5927\u8FB9\u957F\uFF0C0 \u56DE\u843D\u9ED8\u8BA4 768").option("--use-gpu","\u4EC5 paddleocr\uFF1A\u5207\u6362\u6A21\u578B\u65F6\u542F\u7528 GPU").option("--timeout-ms <timeoutMs>","\u8BF7\u6C42\u8D85\u65F6\u65F6\u95F4(\u6BEB\u79D2)","60000").option("--format <format>","\u8FD4\u56DE\u683C\u5F0F: summary|json","summary").option("--output <output>","OCR \u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08\u53EF\u9009\uFF09").action(lt),c.program.command("image-crop").description("\u88C1\u5207\u672C\u5730\u56FE\u7247\u5E76\u8F93\u51FA PNG").requiredOption("--image <image>","\u8F93\u5165\u56FE\u7247\u8DEF\u5F84").option("--x <x>","\u88C1\u5207\u8D77\u70B9 x","0").option("--y <y>","\u88C1\u5207\u8D77\u70B9 y","0").requiredOption("--width <width>","\u88C1\u5207\u5BBD\u5EA6").requiredOption("--height <height>","\u88C1\u5207\u9AD8\u5EA6").option("--output <output>","\u8F93\u51FA PNG \u8DEF\u5F84\uFF08\u53EF\u9009\uFF09").action(ft),c.program.command("screen-crop").description("\u4ECE\u8BBE\u5907\u622A\u56FE\u4E2D\u88C1\u5207 PNG").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("--x <x>","\u88C1\u5207\u8D77\u70B9 x","0").option("--y <y>","\u88C1\u5207\u8D77\u70B9 y","0").requiredOption("--width <width>","\u88C1\u5207\u5BBD\u5EA6").requiredOption("--height <height>","\u88C1\u5207\u9AD8\u5EA6").option("--output <output>","\u8F93\u51FA PNG \u8DEF\u5F84\uFF08\u53EF\u9009\uFF09").action(gt),c.program.command("image-pick-color").description("\u8BFB\u53D6\u672C\u5730\u56FE\u7247\u6307\u5B9A\u5750\u6807\u989C\u8272").requiredOption("--image <image>","\u8F93\u5165\u56FE\u7247\u8DEF\u5F84").option("--x <x>","\u76EE\u6807\u5750\u6807 x","0").option("--y <y>","\u76EE\u6807\u5750\u6807 y","0").option("--radius <radius>","\u91C7\u6837\u534A\u5F84\uFF0C\u8303\u56F4 0..20","0").action(ht),c.program.command("screen-pick-color").description("\u8BFB\u53D6\u8BBE\u5907\u622A\u56FE\u6307\u5B9A\u5750\u6807\u989C\u8272").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").option("--x <x>","\u76EE\u6807\u5750\u6807 x","0").option("--y <y>","\u76EE\u6807\u5750\u6807 y","0").option("--radius <radius>","\u91C7\u6837\u534A\u5F84\uFF0C\u8303\u56F4 0..20","0").action(wt),c.program.command("image-transparent").description("\u5C06\u56FE\u7247\u4E2D\u63A5\u8FD1\u6307\u5B9A\u989C\u8272\u6216\u89D2\u843D\u80CC\u666F\u8272\u7684\u50CF\u7D20\u8BBE\u4E3A\u900F\u660E").requiredOption("--image <image>","\u8F93\u5165\u56FE\u7247\u8DEF\u5F84").option("--output <output>","\u8F93\u51FA PNG \u8DEF\u5F84\uFF08\u53EF\u9009\uFF09").option("--transparent-color <transparentColor>","\u900F\u660E\u5316\u989C\u8272\uFF0C\u683C\u5F0F #RRGGBB").option("--sample-corner <sampleCorner>","\u672A\u4F20 transparent-color \u65F6\u91C7\u6837\u89D2\u843D: topLeft|topRight|bottomLeft|bottomRight","topLeft").option("--tolerance <tolerance>","RGB \u6B27\u6C0F\u8DDD\u79BB\u5BB9\u5DEE\uFF0C\u8303\u56F4 0..441","24").action(yt);const Ct=c.program.command("docs").description("\u663E\u793A KuaiJS \u672C\u5730\u6587\u6863\u8DEF\u5F84");Ct.command("paths").description("\u663E\u793A KuaiJS \u672C\u5730\u6587\u6863\u8DEF\u5F84").option("--output <output>","\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08\u53EF\u9009\uFF09").action(mt),c.program.command("http-call").description("\u6309 HTTP API \u6587\u6863\u58F0\u660E\u8C03\u7528\u8BBE\u5907\u63A5\u53E3").option("-i, --ip <ip>","\u8BBE\u5907 IP \u5730\u5740").option("--port <port>","\u8BBE\u5907\u7AEF\u53E3","9800").requiredOption("--method <method>","HTTP \u65B9\u6CD5: GET|POST").requiredOption("--path <path>","HTTP API \u76F8\u5BF9\u8DEF\u5F84\uFF0C\u4F8B\u5982 /api/status").option("--query <query>","JSON \u5BF9\u8C61 query \u53C2\u6570").option("--body <body>","JSON \u8BF7\u6C42\u4F53\uFF1B\u666E\u901A\u5B57\u7B26\u4E32\u4F1A\u4F5C\u4E3A JSON \u5B57\u7B26\u4E32\u63D0\u4EA4").option("--response-format <responseFormat>","\u54CD\u5E94\u683C\u5F0F: json|text","json").option("--timeout-ms <timeoutMs>","\u8BF7\u6C42\u8D85\u65F6\u65F6\u95F4(\u6BEB\u79D2)","30000").option("--output <output>","\u54CD\u5E94\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08\u53EF\u9009\uFF09").action(dt),c.program.command("ws-start").description("\u542F\u52A8 CLI \u5185\u7F6E WS \u670D\u52A1").option("--ws-port <wsPort>","WS \u670D\u52A1\u7AEF\u53E3","31111").action(xt),c.program.command("ws-stop").description("\u505C\u6B62 CLI \u5185\u7F6E WS \u670D\u52A1").action(Pt),c.program.command("ws-status").description("\u67E5\u770B CLI \u5185\u7F6E WS \u670D\u52A1\u72B6\u6001").action(St),c.program.parse();