ms-vite-plugin 1.4.14 → 1.4.16

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

@@ -1,27 +1,4 @@
 import type { ApiDocItem, ApiDocsLanguage } from "./types";
-/**
- * 获取当前文档语言
- * @returns 返回当前语言
- * @example
- * const language = getCurrentDocsLanguage()
- */
-export declare function getCurrentDocsLanguage(): ApiDocsLanguage;
-/**
- * 设置当前文档语言
- * @param language 目标语言
- * @returns 设置后的语言
- * @example
- * const language = setCurrentDocsLanguage("python")
- */
-export declare function setCurrentDocsLanguage(language: ApiDocsLanguage): ApiDocsLanguage;
-/**
- * 根据可选入参解析实际使用的文档语言
- * @param language 工具调用时传入的语言（可选）
- * @returns 返回最终生效的语言
- * @example
- * const activeLanguage = resolveDocsLanguage(undefined)
- */
-export declare function resolveDocsLanguage(language?: ApiDocsLanguage): ApiDocsLanguage;
 /**
  * 获取 docs 根目录
  * @returns 返回 docs 目录绝对路径

package/dist/mcp/docs-service.js

@@ -33,9 +33,6 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCurrentDocsLanguage = getCurrentDocsLanguage;
-exports.setCurrentDocsLanguage = setCurrentDocsLanguage;
-exports.resolveDocsLanguage = resolveDocsLanguage;
 exports.getDocsRootDir = getDocsRootDir;
 exports.getDocsDirByLanguage = getDocsDirByLanguage;
 exports.getApiDocsByLanguage = getApiDocsByLanguage;
@@ -43,40 +40,6 @@ exports.scoreApiDoc = scoreApiDoc;
 exports.getDocUri = getDocUri;
 const fsExtra = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
-/**
- * 当前 MCP 进程默认文档语言
- */
-let currentDocsLanguage = "js_zh";
-/**
- * 获取当前文档语言
- * @returns 返回当前语言
- * @example
- * const language = getCurrentDocsLanguage()
- */
-function getCurrentDocsLanguage() {
-    return currentDocsLanguage;
-}
-/**
- * 设置当前文档语言
- * @param language 目标语言
- * @returns 设置后的语言
- * @example
- * const language = setCurrentDocsLanguage("python")
- */
-function setCurrentDocsLanguage(language) {
-    currentDocsLanguage = language;
-    return currentDocsLanguage;
-}
-/**
- * 根据可选入参解析实际使用的文档语言
- * @param language 工具调用时传入的语言（可选）
- * @returns 返回最终生效的语言
- * @example
- * const activeLanguage = resolveDocsLanguage(undefined)
- */
-function resolveDocsLanguage(language) {
-    return language ?? currentDocsLanguage;
-}
 /**
  * 获取 docs 根目录
  * @returns 返回 docs 目录绝对路径
@@ -111,9 +74,6 @@ function getDocsDirByLanguage(language) {
  */
 async function getApiDocsByLanguage(language) {
     const docsDir = getDocsDirByLanguage(language);
-    if (!(await fsExtra.pathExists(docsDir))) {
-        throw new Error(`文档目录不存在: ${docsDir}`);
-    }
     const fileNames = await fsExtra.readdir(docsDir);
     const mdFiles = fileNames
         .filter((name) => name.toLowerCase().endsWith(".md"))

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

@@ -8,6 +8,8 @@ export type HttpApiMethod = "GET" | "POST";
 export type HttpApiDocEntry = {
     /** 稳定 slug，可用于读取单个接口文档 */
     slug: string;
+    /** HTTP API 文档绝对路径 */
+    filePath: string;
     /** 接口请求方法 */
     method: HttpApiMethod;
     /** 接口路径 */
@@ -23,6 +25,13 @@ export type HttpApiDocEntry = {
     /** 接口完整 markdown 片段 */
     content: string;
 };
+/**
+ * 获取 HTTP API 文档路径
+ * @returns 返回 HTTP API 文档绝对路径
+ * @example
+ * const filePath = getHttpApiDocPath()
+ */
+export declare function getHttpApiDocPath(): string;
 /**
  * 读取 HTTP API markdown 文档
  * @returns 返回完整 markdown 文本

package/dist/mcp/httpapi-docs-service.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHttpApiDocPath = getHttpApiDocPath;
 exports.readHttpApiMarkdown = readHttpApiMarkdown;
 exports.createHttpApiSlug = createHttpApiSlug;
 exports.getHttpApiDocEntries = getHttpApiDocEntries;
@@ -62,9 +63,6 @@ function getHttpApiDocPath() {
  */
 async function readHttpApiMarkdown() {
     const filePath = getHttpApiDocPath();
-    if (!(await fsExtra.pathExists(filePath))) {
-        throw new Error("HTTP API 文档不可用。");
-    }
     return fsExtra.readFile(filePath, "utf8");
 }
 /**
@@ -89,10 +87,7 @@ function createHttpApiSlug(method, apiPath) {
  */
 async function getHttpApiDocEntries() {
     const filePath = getHttpApiDocPath();
-    const stat = await fsExtra.stat(filePath).catch(() => null);
-    if (!stat) {
-        throw new Error("HTTP API 文档不可用。");
-    }
+    const stat = await fsExtra.stat(filePath);
     if (cachedHttpApiDocEntries?.mtimeMs === stat.mtimeMs) {
         return cachedHttpApiDocEntries.entries;
     }
@@ -134,6 +129,7 @@ async function getHttpApiDocEntries() {
         }
         entries.push({
             slug: createHttpApiSlug(method, apiPath),
+            filePath,
             method,
             path: apiPath,
             title,

package/dist/mcp/httpapi-tools.js

@@ -59,6 +59,7 @@ function formatHttpApiDocSummary(entry, index) {
         `slug: ${entry.slug}`,
         `section: ${entry.section || "未分组"}`,
         `lines: ${entry.startLine}-${entry.endLine}`,
+        `file: ${entry.filePath}`,
         `uri: ${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
     ].join("\n");
 }
@@ -183,7 +184,7 @@ function registerHttpApiTools(server) {
                 resources: entries.map((entry) => ({
                     uri: `${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
                     name: `${entry.method} ${entry.path}`,
-                    description: `${entry.title} [${entry.section || "未分组"}]`,
+                    description: `${entry.title} [${entry.section || "未分组"}] | file: ${entry.filePath}`,
                     mimeType: "text/markdown",
                 })),
             };
@@ -271,6 +272,7 @@ function registerHttpApiTools(server) {
             `slug: ${entry.slug}`,
             `section: ${entry.section || "未分组"}`,
             `lines: ${entry.startLine}-${entry.endLine}`,
+            `file: ${entry.filePath}`,
             "",
             entry.content,
         ].join("\n"));

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 服务实例