ms-vite-plugin 1.4.15 → 1.4.17

package/dist/mcp/httpapi-tools.js

@@ -34,34 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerHttpApiTools = registerHttpApiTools;
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const z = __importStar(require("zod/v4"));
 const httpapi_docs_service_1 = require("./httpapi-docs-service");
 const tool_utils_1 = require("./tool-utils");
-/**
- * HTTP API 文档完整资源 URI
- */
-const HTTP_API_DOC_RESOURCE_URI = "kuaijs://httpapi/api";
-const HTTP_API_ENDPOINT_RESOURCE_PREFIX = "kuaijs://httpapi/endpoints";
-/**
- * 格式化 HTTP API 文档搜索摘要
- * @param entry HTTP API 文档条目
- * @param index 列表序号
- * @returns 返回摘要文本
- * @example
- * formatHttpApiDocSummary(entry, 0)
- */
-function formatHttpApiDocSummary(entry, index) {
-    return [
-        `${index + 1}. ${entry.title}`,
-        `method: ${entry.method}`,
-        `path: ${entry.path}`,
-        `slug: ${entry.slug}`,
-        `section: ${entry.section || "未分组"}`,
-        `lines: ${entry.startLine}-${entry.endLine}`,
-        `uri: ${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
-    ].join("\n");
-}
 /**
  * 标准化并校验 HTTP API 路径输入
  * @param apiPath 用户传入路径
@@ -157,127 +132,16 @@ async function readHttpApiResponseText(response, responseFormat) {
     }
 }
 /**
- * 注册 HTTP API 文档与通用调用工具
+ * 注册通用 HTTP API 调用工具
  * @param server MCP 服务实例
  * @returns 无返回值
  * @example
  * registerHttpApiTools(server)
  */
 function registerHttpApiTools(server) {
-    server.registerResource("http-api-doc", HTTP_API_DOC_RESOURCE_URI, {
-        title: "KuaiJS HTTP API document",
-        mimeType: "text/markdown",
-    }, async () => ({
-        contents: [
-            {
-                uri: HTTP_API_DOC_RESOURCE_URI,
-                mimeType: "text/markdown",
-                text: await (0, httpapi_docs_service_1.readHttpApiMarkdown)(),
-            },
-        ],
-    }));
-    server.registerResource("http-api-endpoint", new mcp_js_1.ResourceTemplate(`${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/{slug}`, {
-        list: async () => {
-            const entries = await (0, httpapi_docs_service_1.getHttpApiDocEntries)();
-            return {
-                resources: entries.map((entry) => ({
-                    uri: `${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
-                    name: `${entry.method} ${entry.path}`,
-                    description: `${entry.title} [${entry.section || "未分组"}]`,
-                    mimeType: "text/markdown",
-                })),
-            };
-        },
-    }), {
-        title: "KuaiJS HTTP API endpoint documents",
-        mimeType: "text/markdown",
-    }, async (_uri, variables) => {
-        const slug = String(variables.slug || "");
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(slug);
-        if (!entry) {
-            throw new Error(`HTTP API 文档不存在: ${slug}`);
-        }
-        return {
-            contents: [
-                {
-                    uri: `${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
-                    mimeType: "text/markdown",
-                    text: entry.content,
-                },
-            ],
-        };
-    });
-    server.registerTool("search_http_api_docs", {
-        title: "Search HTTP API Docs",
-        description: "搜索 HTTP API 文档中声明的接口。调用 http_api_call 前应先用本工具确认接口 method、path、参数和 slug。",
-        inputSchema: {
-            query: z
-                .string()
-                .min(1)
-                .describe("搜索关键词，例如 click、/api/control/click、截图"),
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(20)
-                .optional()
-                .default(8)
-                .describe("返回条数上限，默认 8"),
-        },
-    }, async ({ query, limit }) => {
-        const normalizedQuery = query.toLowerCase();
-        const entries = await (0, httpapi_docs_service_1.getHttpApiDocEntries)();
-        const matches = entries
-            .map((entry) => ({
-            entry,
-            score: (0, httpapi_docs_service_1.scoreHttpApiDocEntry)(entry, normalizedQuery),
-        }))
-            .filter((item) => item.score > 0)
-            .sort((a, b) => b.score - a.score ||
-            a.entry.path.localeCompare(b.entry.path) ||
-            a.entry.method.localeCompare(b.entry.method))
-            .slice(0, limit)
-            .map((item) => item.entry);
-        return (0, tool_utils_1.createTextToolResult)(matches.length === 0
-            ? `未找到与 "${query}" 匹配的 HTTP API 文档。`
-            : [
-                "HTTP API 文档匹配结果:",
-                "",
-                ...matches.map((entry, index) => formatHttpApiDocSummary(entry, index)),
-            ].join("\n"));
-    });
-    server.registerTool("read_http_api_doc", {
-        title: "Read HTTP API Doc",
-        description: "按 slug 或 path 读取 HTTP API 文档中的接口片段。调用 http_api_call 前应读取目标接口片段，确认参数位置、类型和返回结构。",
-        inputSchema: {
-            identifier: z
-                .string()
-                .min(1)
-                .describe("接口 slug 或 path，例如 get-api-control-click 或 /api/control/click"),
-            method: z
-                .enum(["GET", "POST"])
-                .optional()
-                .describe("可选 HTTP 方法，用于同路径多方法时消歧"),
-        },
-    }, async ({ identifier, method }) => {
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(identifier, method);
-        if (!entry) {
-            return (0, tool_utils_1.createTextToolResult)(`未找到 HTTP API 文档: ${identifier}\n请先调用 search_http_api_docs 搜索可用接口。`, true);
-        }
-        return (0, tool_utils_1.createTextToolResult)([
-            `title: ${entry.title}`,
-            `method: ${entry.method}`,
-            `path: ${entry.path}`,
-            `slug: ${entry.slug}`,
-            `section: ${entry.section || "未分组"}`,
-            `lines: ${entry.startLine}-${entry.endLine}`,
-            "",
-            entry.content,
-        ].join("\n"));
-    });
     server.registerTool("http_api_call", {
         title: "HTTP API Call",
-        description: "调用 HTTP API 文档中已声明的接口。使用前应先调用 search_http_api_docs/read_http_api_doc 获取 docSlug，并确认 method、path、query/body 参数；本工具会拒绝 docSlug、method、path 不匹配的调用。",
+        description: "调用 HTTP API 文档中已声明的接口。使用前应直接读取 get_docs_paths 返回的 HTTP API 文档，确认 method、path、query/body 参数；本工具会拒绝文档中未声明的 method/path。",
         inputSchema: {
             method: z
                 .enum(["GET", "POST"])
@@ -286,10 +150,6 @@ function registerHttpApiTools(server) {
                 .string()
                 .min(1)
                 .describe("HTTP API 相对路径，例如 /api/control/click；不能包含 query string"),
-            docSlug: z
-                .string()
-                .min(1)
-                .describe("search_http_api_docs/read_http_api_doc 返回的接口 slug"),
             query: z
                 .record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]))
                 .optional()
@@ -312,21 +172,13 @@ function registerHttpApiTools(server) {
                 .default(30000)
                 .describe("请求超时时间，默认 30000 毫秒"),
         },
-    }, async ({ method, path, docSlug, query, body, responseFormat, timeoutMs, }) => {
+    }, async ({ method, path, query, body, responseFormat, timeoutMs, }) => {
         const apiPath = normalizeHttpApiPath(path);
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(docSlug);
+        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(apiPath, method);
         if (!entry) {
             return (0, tool_utils_1.createTextToolResult)([
-                `HTTP API 文档中不存在该 docSlug: ${docSlug}`,
-                "请先调用 search_http_api_docs 搜索可用接口，再调用 read_http_api_doc 确认参数和 slug。",
-            ].join("\n"), true);
-        }
-        if (entry.method !== method || entry.path !== apiPath) {
-            return (0, tool_utils_1.createTextToolResult)([
-                "HTTP API 调用与文档条目不匹配。",
-                `传入: ${method} ${apiPath} (${docSlug})`,
-                `文档: ${entry.method} ${entry.path} (${entry.slug})`,
-                "请重新调用 read_http_api_doc 确认目标接口。",
+                `HTTP API 文档中不存在该接口: ${method} ${apiPath}`,
+                "请直接读取 get_docs_paths 返回的 HTTP API 文档路径，确认接口 method、path 和参数。",
             ].join("\n"), true);
         }
         if (method === "GET" && body !== undefined) {
@@ -349,7 +201,7 @@ function registerHttpApiTools(server) {
             return (0, tool_utils_1.createTextToolResult)([
                 `HTTP API 调用${response.ok ? "成功" : "失败"}: ${method} ${apiPath}`,
                 `设备: ${target.label}`,
-                `文档: ${entry.title} (${entry.slug}, lines ${entry.startLine}-${entry.endLine})`,
+                `文档: ${entry.title} (lines ${entry.startLine}-${entry.endLine})`,
                 `状态码: ${response.status}`,
                 "",
                 responseText,

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

@@ -1,4 +1,73 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export type ImageSampleCorner = "topLeft" | "topRight" | "bottomLeft" | "bottomRight";
+/**
+ * 裁切本地图片
+ * @param imagePath 输入图片路径
+ * @param x 裁切起点 x
+ * @param y 裁切起点 y
+ * @param width 裁切宽度
+ * @param height 裁切高度
+ * @param outputPath 可选输出路径
+ * @returns 返回操作结果文本
+ * @example
+ * await cropLocalImage("./screen.jpg", 0, 0, 100, 100)
+ */
+export declare function cropLocalImage(imagePath: string, x: number, y: number, width: number, height: number, outputPath?: string): Promise<string>;
+/**
+ * 裁切设备截图
+ * @param target 设备 HTTP 地址
+ * @param x 裁切起点 x
+ * @param y 裁切起点 y
+ * @param width 裁切宽度
+ * @param height 裁切高度
+ * @param outputPath 可选输出路径
+ * @returns 返回操作结果文本
+ * @example
+ * await cropDeviceScreen({ ip: "192.168.1.10", port: "9800", label: "192.168.1.10:9800" }, 0, 0, 100, 100)
+ */
+export declare function cropDeviceScreen(target: {
+    ip: string;
+    port: string;
+    label: string;
+}, x: number, y: number, width: number, height: number, outputPath?: string): Promise<string>;
+/**
+ * 读取本地图片颜色
+ * @param imagePath 输入图片路径
+ * @param x 目标坐标 x
+ * @param y 目标坐标 y
+ * @param radius 采样半径
+ * @returns 返回取色结果文本
+ * @example
+ * await pickLocalImageColor("./screen.jpg", 10, 10, 0)
+ */
+export declare function pickLocalImageColor(imagePath: string, x: number, y: number, radius: number): Promise<string>;
+/**
+ * 读取设备截图颜色
+ * @param target 设备 HTTP 地址
+ * @param x 目标坐标 x
+ * @param y 目标坐标 y
+ * @param radius 采样半径
+ * @returns 返回取色结果文本
+ * @example
+ * await pickDeviceScreenColor({ ip: "192.168.1.10", port: "9800", label: "192.168.1.10:9800" }, 10, 10, 0)
+ */
+export declare function pickDeviceScreenColor(target: {
+    ip: string;
+    port: string;
+    label: string;
+}, x: number, y: number, radius: number): Promise<string>;
+/**
+ * 制作本地图片透明图
+ * @param imagePath 输入图片路径
+ * @param outputPath 可选输出路径
+ * @param transparentColor 可选透明色
+ * @param sampleCorner 未传透明色时采样的角落
+ * @param tolerance 颜色容差
+ * @returns 返回操作结果文本
+ * @example
+ * await makeLocalImageTransparent("./button.png", undefined, "#ffffff", "topLeft", 24)
+ */
+export declare function makeLocalImageTransparent(imagePath: string, outputPath: string | undefined, transparentColor: string | undefined, sampleCorner: ImageSampleCorner, tolerance: number): Promise<string>;
 /**
  * 注册图片处理 MCP 工具
  * @param server MCP 服务实例

package/dist/mcp/image-tools.js

@@ -36,6 +36,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.cropLocalImage = cropLocalImage;
+exports.cropDeviceScreen = cropDeviceScreen;
+exports.pickLocalImageColor = pickLocalImageColor;
+exports.pickDeviceScreenColor = pickDeviceScreenColor;
+exports.makeLocalImageTransparent = makeLocalImageTransparent;
 exports.registerImageTools = registerImageTools;
 const fsExtra = __importStar(require("fs-extra"));
 const os = __importStar(require("os"));
@@ -247,6 +252,164 @@ function formatPickedColorText(source, x, y, radius, imageWidth, imageHeight, co
         `rgba: ${color.r},${color.g},${color.b},${color.a}`,
     ].join("\n");
 }
+/**
+ * 裁切本地图片
+ * @param imagePath 输入图片路径
+ * @param x 裁切起点 x
+ * @param y 裁切起点 y
+ * @param width 裁切宽度
+ * @param height 裁切高度
+ * @param outputPath 可选输出路径
+ * @returns 返回操作结果文本
+ * @example
+ * await cropLocalImage("./screen.jpg", 0, 0, 100, 100)
+ */
+async function cropLocalImage(imagePath, x, y, width, height, outputPath) {
+    const inputPath = await resolveExistingImagePath(imagePath);
+    const targetPath = resolveImageOutputPath(inputPath, outputPath, "crop");
+    const metadata = await (0, sharp_1.default)(inputPath).metadata();
+    const imageWidth = metadata.width ?? 0;
+    const imageHeight = metadata.height ?? 0;
+    if (x + width > imageWidth || y + height > imageHeight) {
+        throw new Error(`裁切范围超出图片尺寸: image=${imageWidth}x${imageHeight}, crop=${x},${y},${width},${height}`);
+    }
+    await fsExtra.ensureDir(path.dirname(targetPath));
+    const info = await (0, sharp_1.default)(inputPath)
+        .extract({ left: x, top: y, width, height })
+        .png()
+        .toFile(targetPath);
+    return [
+        "图片裁切成功",
+        `input: ${inputPath}`,
+        `output: ${targetPath}`,
+        `crop: x=${x}, y=${y}, width=${width}, height=${height}`,
+        `size: ${info.size} bytes`,
+    ].join("\n");
+}
+/**
+ * 裁切设备截图
+ * @param target 设备 HTTP 地址
+ * @param x 裁切起点 x
+ * @param y 裁切起点 y
+ * @param width 裁切宽度
+ * @param height 裁切高度
+ * @param outputPath 可选输出路径
+ * @returns 返回操作结果文本
+ * @example
+ * await cropDeviceScreen({ ip: "192.168.1.10", port: "9800", label: "192.168.1.10:9800" }, 0, 0, 100, 100)
+ */
+async function cropDeviceScreen(target, x, y, width, height, outputPath) {
+    const screenshot = await (0, project_1.getScreenshotOnDevice)({
+        ip: target.ip,
+        port: target.port,
+        transport: "http",
+    });
+    const metadata = await (0, sharp_1.default)(screenshot).metadata();
+    const imageWidth = metadata.width ?? 0;
+    const imageHeight = metadata.height ?? 0;
+    if (x + width > imageWidth || y + height > imageHeight) {
+        throw new Error(`裁切范围超出截图尺寸: image=${imageWidth}x${imageHeight}, crop=${x},${y},${width},${height}`);
+    }
+    const targetPath = resolveGeneratedImageOutputPath(outputPath, "ms-mcp-screen-crop", "png");
+    await fsExtra.ensureDir(path.dirname(targetPath));
+    const info = await (0, sharp_1.default)(screenshot)
+        .extract({ left: x, top: y, width, height })
+        .png()
+        .toFile(targetPath);
+    return [
+        "屏幕裁图成功",
+        `device: ${target.label}`,
+        `output: ${targetPath}`,
+        `screen: ${imageWidth}x${imageHeight}`,
+        `crop: x=${x}, y=${y}, width=${width}, height=${height}`,
+        `size: ${info.size} bytes`,
+    ].join("\n");
+}
+/**
+ * 读取本地图片颜色
+ * @param imagePath 输入图片路径
+ * @param x 目标坐标 x
+ * @param y 目标坐标 y
+ * @param radius 采样半径
+ * @returns 返回取色结果文本
+ * @example
+ * await pickLocalImageColor("./screen.jpg", 10, 10, 0)
+ */
+async function pickLocalImageColor(imagePath, x, y, radius) {
+    const inputPath = await resolveExistingImagePath(imagePath);
+    const image = await readRgbaImage(inputPath);
+    const picked = pickAverageColor(image.data, image.width, image.height, x, y, radius);
+    return formatPickedColorText(inputPath, x, y, radius, image.width, image.height, picked.color, picked.sampleCount);
+}
+/**
+ * 读取设备截图颜色
+ * @param target 设备 HTTP 地址
+ * @param x 目标坐标 x
+ * @param y 目标坐标 y
+ * @param radius 采样半径
+ * @returns 返回取色结果文本
+ * @example
+ * await pickDeviceScreenColor({ ip: "192.168.1.10", port: "9800", label: "192.168.1.10:9800" }, 10, 10, 0)
+ */
+async function pickDeviceScreenColor(target, x, y, radius) {
+    const screenshot = await (0, project_1.getScreenshotOnDevice)({
+        ip: target.ip,
+        port: target.port,
+        transport: "http",
+    });
+    const image = await readRgbaImage(screenshot);
+    const picked = pickAverageColor(image.data, image.width, image.height, x, y, radius);
+    return formatPickedColorText(target.label, x, y, radius, image.width, image.height, picked.color, picked.sampleCount);
+}
+/**
+ * 制作本地图片透明图
+ * @param imagePath 输入图片路径
+ * @param outputPath 可选输出路径
+ * @param transparentColor 可选透明色
+ * @param sampleCorner 未传透明色时采样的角落
+ * @param tolerance 颜色容差
+ * @returns 返回操作结果文本
+ * @example
+ * await makeLocalImageTransparent("./button.png", undefined, "#ffffff", "topLeft", 24)
+ */
+async function makeLocalImageTransparent(imagePath, outputPath, transparentColor, sampleCorner, tolerance) {
+    const inputPath = await resolveExistingImagePath(imagePath);
+    const targetPath = resolveImageOutputPath(inputPath, outputPath, "transparent");
+    const { data, info } = await (0, sharp_1.default)(inputPath)
+        .ensureAlpha()
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    const targetColor = transparentColor
+        ? parseHexColor(transparentColor)
+        : sampleCornerColor(data, info.width, info.height, sampleCorner);
+    let transparentPixelCount = 0;
+    for (let offset = 0; offset < data.length; offset += 4) {
+        if (isColorMatch(data, offset, targetColor, tolerance)) {
+            data[offset + 3] = 0;
+            transparentPixelCount += 1;
+        }
+    }
+    await fsExtra.ensureDir(path.dirname(targetPath));
+    const output = await (0, sharp_1.default)(data, {
+        raw: {
+            width: info.width,
+            height: info.height,
+            channels: 4,
+        },
+    })
+        .png()
+        .toFile(targetPath);
+    return [
+        "透明图制作成功",
+        `input: ${inputPath}`,
+        `output: ${targetPath}`,
+        `image: ${info.width}x${info.height}`,
+        `transparentColor: ${formatRgbHex(targetColor)}`,
+        `tolerance: ${tolerance}`,
+        `transparentPixels: ${transparentPixelCount}`,
+        `size: ${output.size} bytes`,
+    ].join("\n");
+}
 /**
  * 注册图片处理 MCP 工具
  * @param server MCP 服务实例

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

@@ -1,4 +1,54 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export type OcrEngine = "appleocr" | "paddleocr";
+export type OcrMode = "recognize" | "numbers" | "findText";
+export type ScriptResultResponse = {
+    success?: boolean;
+    result?: unknown;
+    resultType?: string;
+    error?: string;
+};
+export type OcrRecognitionOptions = {
+    engine: OcrEngine;
+    mode: OcrMode;
+    input: string;
+    x: number;
+    y: number;
+    ex: number;
+    ey: number;
+    texts?: string[];
+    languages?: string[];
+    confidenceThreshold: number;
+    exactMatch: boolean;
+    outputPath?: string;
+    timeoutMs: number;
+};
+export type OcrRecognitionResult = {
+    status: number;
+    body: ScriptResultResponse;
+    text: string;
+};
+export declare const APPLE_OCR_LANGUAGES: readonly ["en-US", "fr-FR", "it-IT", "de-DE", "es-ES", "pt-BR", "zh-Hans", "zh-Hant"];
+/**
+ * 格式化 OCR 工具结果
+ * @param response runScript 响应
+ * @param outputPath 可选输出文件路径
+ * @returns 返回 MCP 文本内容
+ * @example
+ * await formatOcrToolText({ success: true, result: [] })
+ */
+export declare function formatOcrToolText(response: ScriptResultResponse, outputPath?: string): Promise<string>;
+/**
+ * 在指定 HTTP 设备上执行 OCR 识别
+ * @param target 设备 HTTP 地址
+ * @param options OCR 参数
+ * @returns 返回 HTTP 状态码、原始结果与格式化文本
+ * @example
+ * await runOcrRecognitionOnDevice({ ip: "192.168.1.10", port: "9800" }, options)
+ */
+export declare function runOcrRecognitionOnDevice(target: {
+    ip: string;
+    port: string;
+}, options: OcrRecognitionOptions): Promise<OcrRecognitionResult>;
 /**
  * 注册 OCR MCP 工具
  * @param server MCP 服务实例