ms-vite-plugin 1.4.47 → 1.4.49

package/dist/mcp/ocr-tools.js

@@ -1,413 +1,5 @@
-"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.APPLE_OCR_LANGUAGES = exports.PADDLE_OCR_DEFAULT_MAX_SIDE_LEN = exports.PADDLE_OCR_MODELS = void 0;
-exports.formatOcrToolText = formatOcrToolText;
-exports.runOcrRecognitionOnDevice = runOcrRecognitionOnDevice;
-exports.registerOcrTools = registerOcrTools;
-const fsExtra = __importStar(require("fs-extra"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-const z = __importStar(require("zod/v4"));
-const tool_utils_1 = require("./tool-utils");
-/** PaddleOCR 内置可切换模型 ID；同一时间只保留一个 active 模型。 */
-exports.PADDLE_OCR_MODELS = [
-    "ppocr-v6-tiny",
-    "ppocr-v6-small",
-    "ppocr-v5",
-];
-/** PaddleOCR 检测阶段默认最大边长，与运行时一致；传 0 或负数时回落到该值。 */
-exports.PADDLE_OCR_DEFAULT_MAX_SIDE_LEN = 768;
-exports.APPLE_OCR_LANGUAGES = [
-    "en-US",
-    "fr-FR",
-    "it-IT",
-    "de-DE",
-    "es-ES",
-    "pt-BR",
-    "zh-Hans",
-    "zh-Hant",
-];
-/**
- * 生成安全的 JavaScript 字面量
- * @param value 任意 JSON 兼容值
- * @returns 返回可嵌入脚本的 JSON 字面量
- * @example
- * jsonLiteral(["zh-Hans", "en-US"])
- */
-function jsonLiteral(value) {
-    return JSON.stringify(value);
-}
-/**
- * 解析 OCR 输出文件路径
- * @param outputPath 用户指定的可选路径
- * @returns 返回最终输出文件绝对路径
- * @example
- * resolveOcrOutputPath(undefined)
- */
-function resolveOcrOutputPath(outputPath) {
-    if (outputPath && outputPath.trim()) {
-        return path.resolve(outputPath.trim());
-    }
-    return path.join(os.tmpdir(), `ms-mcp-ocr-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.json`);
-}
-/**
- * 构建 Apple OCR 运行脚本
- * @param mode OCR 模式
- * @param input 输入源
- * @param x 区域左上角 x
- * @param y 区域左上角 y
- * @param ex 区域右下角 x
- * @param ey 区域右下角 y
- * @param texts 查找文本数组
- * @param languages 识别语言数组
- * @param exactMatch 是否完整匹配文本
- * @returns 返回可交给 runScript 的 JavaScript 脚本
- * @example
- * buildAppleOcrScript("recognize", "screen", 0, 0, 0, 0)
- */
-function buildAppleOcrScript(mode, input, x, y, ex, ey, texts, languages, exactMatch = false) {
-    if (mode === "findText") {
-        if (!texts || texts.length === 0) {
-            throw new Error("findText 模式必须传 texts。");
-        }
-        return `appleOcr.findTextAbs(${jsonLiteral(input)}, ${jsonLiteral(texts)}, ${x}, ${y}, ${ex}, ${ey}, ${jsonLiteral(languages)}, ${exactMatch});`;
-    }
-    if (mode === "numbers") {
-        return `appleOcr.recognizeNumbersAbs(${jsonLiteral(input)}, ${x}, ${y}, ${ex}, ${ey});`;
-    }
-    return `appleOcr.recognizeAbs(${jsonLiteral(input)}, ${x}, ${y}, ${ex}, ${ey}, ${jsonLiteral(languages)});`;
-}
-/**
- * 构建 Paddle OCR 运行脚本
- * @param mode OCR 模式
- * @param input 输入源
- * @param x 区域左上角 x
- * @param y 区域左上角 y
- * @param ex 区域右下角 x
- * @param ey 区域右下角 y
- * @param texts 查找文本数组
- * @param confidenceThreshold 置信度阈值
- * @param exactMatch 是否完整匹配文本
- * @param paddleModel 可选切换的 PaddleOCR 模型 ID
- * @param maxSideLen 可选检测阶段最大边长
- * @param useGpu loadModel 时是否启用 GPU
- * @returns 返回可交给 runScript 的 JavaScript 脚本
- * @example
- * buildPaddleOcrScript("recognize", "screen", 0, 0, 0, 0, undefined, 0.6, false)
- */
-function buildPaddleOcrScript(mode, input, x, y, ex, ey, texts, confidenceThreshold, exactMatch, paddleModel, maxSideLen, useGpu) {
-    if (mode === "numbers") {
-        throw new Error("PaddleOCR 文档未提供 numbers 模式，请使用 appleocr 引擎。");
-    }
-    // 先设置检测长边，再切换模型；loadModel 会沿用当前长边加载目标模型。
-    const setup = [];
-    if (maxSideLen !== undefined) {
-        setup.push(`paddleOcr.setMaxSideLen(${maxSideLen});`);
-    }
-    if (paddleModel) {
-        setup.push(`paddleOcr.loadModel(${jsonLiteral(paddleModel)}, ${useGpu ?? false});`);
-    }
-    let call;
-    if (mode === "findText") {
-        if (!texts || texts.length === 0) {
-            throw new Error("findText 模式必须传 texts。");
-        }
-        call = `paddleOcr.findTextAbs(${jsonLiteral(input)}, ${jsonLiteral(texts)}, ${x}, ${y}, ${ex}, ${ey}, ${confidenceThreshold}, ${exactMatch});`;
-    }
-    else {
-        call = `paddleOcr.recognizeAbs(${jsonLiteral(input)}, ${x}, ${y}, ${ex}, ${ey}, ${confidenceThreshold});`;
-    }
-    return [...setup, call].join("\n");
-}
-/**
- * 构建 OCR 运行脚本
- * @param engine OCR 引擎
- * @param mode OCR 模式
- * @param input 输入源
- * @param x 区域左上角 x
- * @param y 区域左上角 y
- * @param ex 区域右下角 x
- * @param ey 区域右下角 y
- * @param texts 查找文本数组
- * @param languages Apple OCR 识别语言数组
- * @param confidenceThreshold PaddleOCR 置信度阈值
- * @param exactMatch 是否完整匹配文本
- * @param paddleModel 可选切换的 PaddleOCR 模型 ID
- * @param maxSideLen 可选 PaddleOCR 检测阶段最大边长
- * @param useGpu PaddleOCR loadModel 时是否启用 GPU
- * @returns 返回可交给 runScript 的 JavaScript 脚本
- * @example
- * buildOcrScript("appleocr", "recognize", "screen", 0, 0, 0, 0)
- */
-function buildOcrScript(engine, mode, input, x, y, ex, ey, texts, languages, confidenceThreshold, exactMatch, paddleModel, maxSideLen, useGpu) {
-    if (engine === "paddleocr") {
-        return buildPaddleOcrScript(mode, input, x, y, ex, ey, texts, confidenceThreshold, exactMatch, paddleModel, maxSideLen, useGpu);
-    }
-    if (paddleModel !== undefined ||
-        maxSideLen !== undefined ||
-        useGpu !== undefined) {
-        throw new Error("paddleModel / maxSideLen / useGpu 仅适用于 paddleocr 引擎。");
-    }
-    return buildAppleOcrScript(mode, input, x, y, ex, ey, texts, languages, exactMatch);
-}
-/**
- * 调用设备 runScript 接口
- * @param ip 设备 IP
- * @param port 设备端口
- * @param script JavaScript 脚本文本
- * @param timeoutMs 超时时间
- * @returns 返回 runScript 的 JSON 响应
- * @example
- * await callRunScript("192.168.1.10", "9800", "1 + 1;", 30000)
- */
-async function callRunScript(ip, port, script, timeoutMs) {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        const response = await fetch(`http://${ip}:${port}/api/runScript`, {
-            method: "POST",
-            signal: controller.signal,
-            headers: {
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({ script }),
-        });
-        const text = await response.text();
-        let body;
-        try {
-            body = JSON.parse(text);
-        }
-        catch {
-            throw new Error(`runScript 响应不是有效 JSON: ${text}`);
-        }
-        if (!response.ok) {
-            throw new Error(`runScript HTTP ${response.status}: ${text}`);
-        }
-        return {
-            status: response.status,
-            body,
-        };
-    }
-    catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-            throw new Error(`runScript 请求超时: ${timeoutMs}ms`);
-        }
-        throw error;
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-/**
- * 格式化 OCR 工具结果
- * @param response runScript 响应
- * @param outputPath 可选输出文件路径
- * @returns 返回 MCP 文本内容
- * @example
- * await formatOcrToolText({ success: true, result: [] })
- */
-async function formatOcrToolText(response, outputPath) {
-    const resultCount = Array.isArray(response.result)
-        ? response.result.length
-        : undefined;
-    const responseText = (0, tool_utils_1.formatRuntimeJsonText)(response);
-    if (outputPath || responseText.length > 12000) {
-        const targetPath = resolveOcrOutputPath(outputPath);
-        await fsExtra.ensureDir(path.dirname(targetPath));
-        await fsExtra.writeJson(targetPath, response, { spaces: 2 });
-        return [
-            "OCR 执行成功",
-            ...(resultCount === undefined ? [] : [`resultCount: ${resultCount}`]),
-            `resultType: ${response.resultType ?? "unknown"}`,
-            `output: ${targetPath}`,
-        ].join("\n");
-    }
-    return [
-        "OCR 执行成功",
-        ...(resultCount === undefined ? [] : [`resultCount: ${resultCount}`]),
-        `resultType: ${response.resultType ?? "unknown"}`,
-        "",
-        responseText,
-    ].join("\n");
-}
-/**
- * 在指定 HTTP 设备上执行 OCR 识别
- * @param target 设备 HTTP 地址
- * @param options OCR 参数
- * @returns 返回 HTTP 状态码、原始结果与格式化文本
- * @example
- * await runOcrRecognitionOnDevice({ ip: "192.168.1.10", port: "9800" }, options)
- */
-async function runOcrRecognitionOnDevice(target, options) {
-    const script = buildOcrScript(options.engine, options.mode, options.input, options.x, options.y, options.ex, options.ey, options.texts, options.languages, options.confidenceThreshold, options.exactMatch, options.paddleModel, options.maxSideLen, options.useGpu);
-    const response = await callRunScript(target.ip, target.port, script, options.timeoutMs);
-    const text = await formatOcrToolText(response.body, options.outputPath);
-    return {
-        status: response.status,
-        body: response.body,
-        text,
-    };
-}
-/**
- * 注册 OCR MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerOcrTools(server)
- */
-function registerOcrTools(server) {
-    server.registerTool("ocr_recognize", {
-        title: "OCR Recognize",
-        description: "在当前默认设备执行 OCR。支持 appleocr 与 paddleocr，默认 appleocr；返回坐标使用绝对坐标。",
-        inputSchema: {
-            engine: z
-                .enum(["appleocr", "paddleocr"])
-                .optional()
-                .default("appleocr")
-                .describe("OCR 引擎：appleocr=Apple Vision，paddleocr=PaddleOCR"),
-            mode: z
-                .enum(["recognize", "numbers", "findText"])
-                .optional()
-                .default("recognize")
-                .describe("OCR 模式：recognize=识别文本，numbers=识别数字，findText=查找文本"),
-            input: z
-                .string()
-                .min(1)
-                .optional()
-                .default("screen")
-                .describe('输入源，默认 "screen"，也可传图片路径、URL 或 imageId'),
-            x: z.number().int().min(0).optional().default(0).describe("区域左上角 x"),
-            y: z.number().int().min(0).optional().default(0).describe("区域左上角 y"),
-            ex: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .default(0)
-                .describe("区域右下角 x；全屏可传 0"),
-            ey: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .default(0)
-                .describe("区域右下角 y；全屏可传 0"),
-            texts: z
-                .array(z.string().min(1))
-                .optional()
-                .describe("findText 模式要查找的文本数组"),
-            languages: z
-                .array(z.enum(exports.APPLE_OCR_LANGUAGES))
-                .optional()
-                .describe('Apple OCR 识别语言数组，默认由运行时使用 ["zh-Hans", "en-US"]'),
-            exactMatch: z
-                .boolean()
-                .optional()
-                .default(false)
-                .describe("findText 模式是否要求整条识别文本完全匹配目标文本"),
-            confidenceThreshold: z
-                .number()
-                .min(0)
-                .max(1)
-                .optional()
-                .default(0.6)
-                .describe("PaddleOCR 置信度阈值，默认 0.6"),
-            paddleModel: z
-                .enum(exports.PADDLE_OCR_MODELS)
-                .optional()
-                .describe("仅 paddleocr：切换内置模型，识别前执行 loadModel；不传则使用当前 active 模型，未加载时自动加载 ppocr-v6-small"),
-            maxSideLen: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe(`仅 paddleocr：检测阶段最大边长，识别前执行 setMaxSideLen；不传保持运行时当前值，0 回落到默认 ${exports.PADDLE_OCR_DEFAULT_MAX_SIDE_LEN}`),
-            useGpu: z
-                .boolean()
-                .optional()
-                .describe("仅 paddleocr：配合 paddleModel 切换模型时是否启用 GPU，默认 false"),
-            outputPath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("可选输出 JSON 路径；不传且结果很长时写入系统临时目录"),
-            timeoutMs: z
-                .number()
-                .int()
-                .min(1000)
-                .max(600000)
-                .optional()
-                .default(60000)
-                .describe("runScript 请求超时时间，默认 60000 毫秒"),
-        },
-    }, async ({ engine, mode, input, x, y, ex, ey, texts, languages, exactMatch, confidenceThreshold, paddleModel, maxSideLen, useGpu, outputPath, timeoutMs, }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const response = await runOcrRecognitionOnDevice(target, {
-            engine,
-            mode,
-            input,
-            x,
-            y,
-            ex,
-            ey,
-            texts,
-            languages,
-            confidenceThreshold,
-            exactMatch,
-            paddleModel,
-            maxSideLen,
-            useGpu,
-            outputPath,
-            timeoutMs,
-        });
-        return (0, tool_utils_1.createTextToolResult)([
-            response.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: ${response.status}`,
-        ].join("\n"), response.body.success === false);
-    });
-}
+"use strict";var D=exports&&exports.__createBinding||(Object.create?(function(r,e,i,t){t===void 0&&(t=i);var n=Object.getOwnPropertyDescriptor(e,i);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[i]}}),Object.defineProperty(r,t,n)}):(function(r,e,i,t){t===void 0&&(t=i),r[t]=e[i]})),R=exports&&exports.__setModuleDefault||(Object.create?(function(r,e){Object.defineProperty(r,"default",{enumerable:!0,value:e})}):function(r,e){r.default=e}),O=exports&&exports.__importStar||(function(){var r=function(e){return r=Object.getOwnPropertyNames||function(i){var t=[];for(var n in i)Object.prototype.hasOwnProperty.call(i,n)&&(t[t.length]=n);return t},r(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null)for(var t=r(e),n=0;n<t.length;n++)t[n]!=="default"&&D(i,e,t[n]);return R(i,e),i}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.APPLE_OCR_LANGUAGES=exports.PADDLE_OCR_DEFAULT_MAX_SIDE_LEN=exports.PADDLE_OCR_MODELS=void 0,exports.formatOcrToolText=E,exports.runOcrRecognitionOnDevice=w,exports.registerOcrTools=x;const T=O(require("fs-extra")),P=O(require("os")),_=O(require("path")),o=O(require("zod/v4")),g=require("./tool-utils");exports.PADDLE_OCR_MODELS=["ppocr-v6-tiny","ppocr-v6-small","ppocr-v5"],exports.PADDLE_OCR_DEFAULT_MAX_SIDE_LEN=768,exports.APPLE_OCR_LANGUAGES=["en-US","fr-FR","it-IT","de-DE","es-ES","pt-BR","zh-Hans","zh-Hant"];function f(r){return JSON.stringify(r)}function L(r){return r&&r.trim()?_.resolve(r.trim()):_.join(P.tmpdir(),`ms-mcp-ocr-${Date.now()}-${Math.random().toString(36).slice(2,8)}.json`)}function C(r,e,i,t,n,u,a,c,l=!1){if(r==="findText"){if(!a||a.length===0)throw new Error("findText \u6A21\u5F0F\u5FC5\u987B\u4F20 texts\u3002");return`appleOcr.findTextAbs(${f(e)}, ${f(a)}, ${i}, ${t}, ${n}, ${u}, ${f(c)}, ${l});`}return r==="numbers"?`appleOcr.recognizeNumbersAbs(${f(e)}, ${i}, ${t}, ${n}, ${u});`:`appleOcr.recognizeAbs(${f(e)}, ${i}, ${t}, ${n}, ${u}, ${f(c)});`}function v(r,e,i,t,n,u,a,c,l,b,p,$){if(r==="numbers")throw new Error("PaddleOCR \u6587\u6863\u672A\u63D0\u4F9B numbers \u6A21\u5F0F\uFF0C\u8BF7\u4F7F\u7528 appleocr \u5F15\u64CE\u3002");const s=[];p!==void 0&&s.push(`paddleOcr.setMaxSideLen(${p});`),b&&s.push(`paddleOcr.loadModel(${f(b)}, ${$??!1});`);let d;if(r==="findText"){if(!a||a.length===0)throw new Error("findText \u6A21\u5F0F\u5FC5\u987B\u4F20 texts\u3002");d=`paddleOcr.findTextAbs(${f(e)}, ${f(a)}, ${i}, ${t}, ${n}, ${u}, ${c}, ${l});`}else d=`paddleOcr.recognizeAbs(${f(e)}, ${i}, ${t}, ${n}, ${u}, ${c});`;return[...s,d].join(`
+`)}function M(r,e,i,t,n,u,a,c,l,b,p,$,s,d){if(r==="paddleocr")return v(e,i,t,n,u,a,c,b,p,$,s,d);if($!==void 0||s!==void 0||d!==void 0)throw new Error("paddleModel / maxSideLen / useGpu \u4EC5\u9002\u7528\u4E8E paddleocr \u5F15\u64CE\u3002");return C(e,i,t,n,u,a,c,l,p)}async function j(r,e,i,t){const n=new AbortController,u=setTimeout(()=>n.abort(),t);try{const a=await fetch(`http://${r}:${e}/api/runScript`,{method:"POST",signal:n.signal,headers:{"Content-Type":"application/json"},body:JSON.stringify({script:i})}),c=await a.text();let l;try{l=JSON.parse(c)}catch{throw new Error(`runScript \u54CD\u5E94\u4E0D\u662F\u6709\u6548 JSON: ${c}`)}if(!a.ok)throw new Error(`runScript HTTP ${a.status}: ${c}`);return{status:a.status,body:l}}catch(a){throw a instanceof Error&&a.name==="AbortError"?new Error(`runScript \u8BF7\u6C42\u8D85\u65F6: ${t}ms`):a}finally{clearTimeout(u)}}async function E(r,e){const i=Array.isArray(r.result)?r.result.length:void 0,t=(0,g.formatRuntimeJsonText)(r);if(e||t.length>12e3){const n=L(e);return await T.ensureDir(_.dirname(n)),await T.writeJson(n,r,{spaces:2}),["OCR \u6267\u884C\u6210\u529F",...i===void 0?[]:[`resultCount: ${i}`],`resultType: ${r.resultType??"unknown"}`,`output: ${n}`].join(`
+`)}return["OCR \u6267\u884C\u6210\u529F",...i===void 0?[]:[`resultCount: ${i}`],`resultType: ${r.resultType??"unknown"}`,"",t].join(`
+`)}async function w(r,e){const i=M(e.engine,e.mode,e.input,e.x,e.y,e.ex,e.ey,e.texts,e.languages,e.confidenceThreshold,e.exactMatch,e.paddleModel,e.maxSideLen,e.useGpu),t=await j(r.ip,r.port,i,e.timeoutMs),n=await E(t.body,e.outputPath);return{status:t.status,body:t.body,text:n}}function x(r){r.registerTool("ocr_recognize",{title:"OCR Recognize",description:"\u5728\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u6267\u884C OCR\u3002\u652F\u6301 appleocr \u4E0E paddleocr\uFF0C\u9ED8\u8BA4 appleocr\uFF1B\u8FD4\u56DE\u5750\u6807\u4F7F\u7528\u7EDD\u5BF9\u5750\u6807\u3002",inputSchema:{engine:o.enum(["appleocr","paddleocr"]).optional().default("appleocr").describe("OCR \u5F15\u64CE\uFF1Aappleocr=Apple Vision\uFF0Cpaddleocr=PaddleOCR"),mode:o.enum(["recognize","numbers","findText"]).optional().default("recognize").describe("OCR \u6A21\u5F0F\uFF1Arecognize=\u8BC6\u522B\u6587\u672C\uFF0Cnumbers=\u8BC6\u522B\u6570\u5B57\uFF0CfindText=\u67E5\u627E\u6587\u672C"),input:o.string().min(1).optional().default("screen").describe('\u8F93\u5165\u6E90\uFF0C\u9ED8\u8BA4 "screen"\uFF0C\u4E5F\u53EF\u4F20\u56FE\u7247\u8DEF\u5F84\u3001URL \u6216 imageId'),x:o.number().int().min(0).optional().default(0).describe("\u533A\u57DF\u5DE6\u4E0A\u89D2 x"),y:o.number().int().min(0).optional().default(0).describe("\u533A\u57DF\u5DE6\u4E0A\u89D2 y"),ex:o.number().int().min(0).optional().default(0).describe("\u533A\u57DF\u53F3\u4E0B\u89D2 x\uFF1B\u5168\u5C4F\u53EF\u4F20 0"),ey:o.number().int().min(0).optional().default(0).describe("\u533A\u57DF\u53F3\u4E0B\u89D2 y\uFF1B\u5168\u5C4F\u53EF\u4F20 0"),texts:o.array(o.string().min(1)).optional().describe("findText \u6A21\u5F0F\u8981\u67E5\u627E\u7684\u6587\u672C\u6570\u7EC4"),languages:o.array(o.enum(exports.APPLE_OCR_LANGUAGES)).optional().describe('Apple OCR \u8BC6\u522B\u8BED\u8A00\u6570\u7EC4\uFF0C\u9ED8\u8BA4\u7531\u8FD0\u884C\u65F6\u4F7F\u7528 ["zh-Hans", "en-US"]'),exactMatch:o.boolean().optional().default(!1).describe("findText \u6A21\u5F0F\u662F\u5426\u8981\u6C42\u6574\u6761\u8BC6\u522B\u6587\u672C\u5B8C\u5168\u5339\u914D\u76EE\u6807\u6587\u672C"),confidenceThreshold:o.number().min(0).max(1).optional().default(.6).describe("PaddleOCR \u7F6E\u4FE1\u5EA6\u9608\u503C\uFF0C\u9ED8\u8BA4 0.6"),paddleModel:o.enum(exports.PADDLE_OCR_MODELS).optional().describe("\u4EC5 paddleocr\uFF1A\u5207\u6362\u5185\u7F6E\u6A21\u578B\uFF0C\u8BC6\u522B\u524D\u6267\u884C loadModel\uFF1B\u4E0D\u4F20\u5219\u4F7F\u7528\u5F53\u524D active \u6A21\u578B\uFF0C\u672A\u52A0\u8F7D\u65F6\u81EA\u52A8\u52A0\u8F7D ppocr-v6-small"),maxSideLen:o.number().int().min(0).optional().describe(`\u4EC5 paddleocr\uFF1A\u68C0\u6D4B\u9636\u6BB5\u6700\u5927\u8FB9\u957F\uFF0C\u8BC6\u522B\u524D\u6267\u884C setMaxSideLen\uFF1B\u4E0D\u4F20\u4FDD\u6301\u8FD0\u884C\u65F6\u5F53\u524D\u503C\uFF0C0 \u56DE\u843D\u5230\u9ED8\u8BA4 ${exports.PADDLE_OCR_DEFAULT_MAX_SIDE_LEN}`),useGpu:o.boolean().optional().describe("\u4EC5 paddleocr\uFF1A\u914D\u5408 paddleModel \u5207\u6362\u6A21\u578B\u65F6\u662F\u5426\u542F\u7528 GPU\uFF0C\u9ED8\u8BA4 false"),outputPath:o.string().min(1).optional().describe("\u53EF\u9009\u8F93\u51FA JSON \u8DEF\u5F84\uFF1B\u4E0D\u4F20\u4E14\u7ED3\u679C\u5F88\u957F\u65F6\u5199\u5165\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55"),timeoutMs:o.number().int().min(1e3).max(6e5).optional().default(6e4).describe("runScript \u8BF7\u6C42\u8D85\u65F6\u65F6\u95F4\uFF0C\u9ED8\u8BA4 60000 \u6BEB\u79D2")}},async({engine:e,mode:i,input:t,x:n,y:u,ex:a,ey:c,texts:l,languages:b,exactMatch:p,confidenceThreshold:$,paddleModel:s,maxSideLen:d,useGpu:A,outputPath:S,timeoutMs:y})=>{const h=await(0,g.resolveRuntimeHttpTarget)(),m=await w(h,{engine:e,mode:i,input:t,x:n,y:u,ex:a,ey:c,texts:l,languages:b,confidenceThreshold:$,exactMatch:p,paddleModel:s,maxSideLen:d,useGpu:A,outputPath:S,timeoutMs:y});return(0,g.createTextToolResult)([m.text,"",`device: ${h.label}`,`engine: ${e}`,`mode: ${i}`,`input: ${t}`,`region: x=${n}, y=${u}, ex=${a}, ey=${c}`,...e==="paddleocr"&&s?[`paddleModel: ${s}`]:[],...e==="paddleocr"&&d!==void 0?[`maxSideLen: ${d}`]:[],`status: ${m.status}`].join(`
+`),m.body.success===!1)})}

package/dist/mcp/project.d.ts

@@ -1,16 +1,2 @@
-/**
- * 检查工作目录是否为有效的 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>;

package/dist/mcp/project.js

@@ -1,74 +1 @@
-"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.isValidKuaiJSProject = isValidKuaiJSProject;
-exports.ensureValidKuaiJSProject = ensureValidKuaiJSProject;
-const fsExtra = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
-/**
- * 检查工作目录是否为有效的 KuaiJS 项目
- * @param workspacePath 工作目录路径
- * @returns 若目录包含 package.json 与 scripts 目录则返回 true，否则返回 false
- * @example
- * const ok = 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;
-    }
-}
-/**
- * 校验当前目录是否是可执行构建/运行的 KuaiJS 项目
- * @param workspacePath 待校验目录
- * @returns 校验通过时返回 Promise<void>，失败时抛出异常
- * @example
- * await ensureValidKuaiJSProject("/Users/demo/project")
- */
-async function ensureValidKuaiJSProject(workspacePath) {
-    const valid = await isValidKuaiJSProject(workspacePath);
-    if (valid) {
-        return;
-    }
-    throw new Error("当前目录不是有效的 快点JS 项目，请确保目录包含 package.json 与 scripts/");
-}
+"use strict";var o=exports&&exports.__createBinding||(Object.create?(function(r,e,i,t){t===void 0&&(t=i);var n=Object.getOwnPropertyDescriptor(e,i);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[i]}}),Object.defineProperty(r,t,n)}):(function(r,e,i,t){t===void 0&&(t=i),r[t]=e[i]})),f=exports&&exports.__setModuleDefault||(Object.create?(function(r,e){Object.defineProperty(r,"default",{enumerable:!0,value:e})}):function(r,e){r.default=e}),a=exports&&exports.__importStar||(function(){var r=function(e){return r=Object.getOwnPropertyNames||function(i){var t=[];for(var n in i)Object.prototype.hasOwnProperty.call(i,n)&&(t[t.length]=n);return t},r(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null)for(var t=r(e),n=0;n<t.length;n++)t[n]!=="default"&&o(i,e,t[n]);return f(i,e),i}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.isValidKuaiJSProject=s,exports.ensureValidKuaiJSProject=l;const u=a(require("fs-extra")),c=a(require("path"));async function s(r){try{const e=c.join(r,"package.json"),i=c.join(r,"scripts"),[t,n]=await Promise.all([u.pathExists(e),u.pathExists(i)]);return t&&n}catch{return!1}}async function l(r){if(!await s(r))throw new Error("\u5F53\u524D\u76EE\u5F55\u4E0D\u662F\u6709\u6548\u7684 \u5FEB\u70B9JS \u9879\u76EE\uFF0C\u8BF7\u786E\u4FDD\u76EE\u5F55\u5305\u542B package.json \u4E0E scripts/")}

package/dist/mcp/runtime-tools.d.ts

@@ -1,9 +1,2 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * 注册设备与项目执行工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerRuntimeTools(server)
- */
 export declare function registerRuntimeTools(server: McpServer): void;