ms-vite-plugin 1.4.47 → 1.4.49

package/dist/mcp/image-tools.js

@@ -1,607 +1,8 @@
-"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;
-    };
-})();
-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"));
-const path = __importStar(require("path"));
-const sharp_1 = __importDefault(require("sharp"));
-const z = __importStar(require("zod/v4"));
-const project_1 = require("../project");
-const tool_utils_1 = require("./tool-utils");
-/**
- * 解析输出路径
- * @param inputPath 输入图片路径
- * @param outputPath 可选输出路径
- * @param suffix 默认文件名后缀
- * @returns 返回输出图片绝对路径
- * @example
- * resolveImageOutputPath("/tmp/a.jpg", undefined, "crop")
- */
-function resolveImageOutputPath(inputPath, outputPath, suffix) {
-    if (outputPath && outputPath.trim()) {
-        return path.resolve(outputPath.trim());
-    }
-    const parsed = path.parse(path.resolve(inputPath));
-    return path.join(parsed.dir, `${parsed.name}-${suffix}.png`);
-}
-/**
- * 解析生成类输出路径
- * @param outputPath 可选输出路径
- * @param fileNamePrefix 默认文件名前缀
- * @param extension 文件扩展名（不含点）
- * @returns 返回输出图片绝对路径
- * @example
- * resolveGeneratedImageOutputPath(undefined, "ms-mcp-screen-crop", "png")
- */
-function resolveGeneratedImageOutputPath(outputPath, fileNamePrefix, extension) {
-    if (outputPath && outputPath.trim()) {
-        return path.resolve(outputPath.trim());
-    }
-    return path.join(os.tmpdir(), `${fileNamePrefix}-${Date.now()}-${Math.random()
-        .toString(36)
-        .slice(2, 8)}.${extension}`);
-}
-/**
- * 解析图片路径并确保文件存在
- * @param imagePath 原始图片路径
- * @returns 返回绝对路径
- * @example
- * const inputPath = await resolveExistingImagePath("./screen.jpg")
- */
-async function resolveExistingImagePath(imagePath) {
-    const inputPath = path.resolve(imagePath.trim());
-    if (!(await fsExtra.pathExists(inputPath))) {
-        throw new Error(`图片不存在: ${inputPath}`);
-    }
-    return inputPath;
-}
-/**
- * 解析十六进制颜色
- * @param value 颜色文本，支持 #RRGGBB 或 RRGGBB
- * @returns 返回 RGB 颜色
- * @example
- * parseHexColor("#ffffff")
- */
-function parseHexColor(value) {
-    const normalized = value.trim().replace(/^#/, "");
-    if (!/^[0-9a-fA-F]{6}$/.test(normalized)) {
-        throw new Error("transparentColor 必须是 #RRGGBB 或 RRGGBB 格式。");
-    }
-    return {
-        r: Number.parseInt(normalized.slice(0, 2), 16),
-        g: Number.parseInt(normalized.slice(2, 4), 16),
-        b: Number.parseInt(normalized.slice(4, 6), 16),
-    };
-}
-/**
- * 将 RGB 颜色格式化为 #RRGGBB
- * @param color RGB 颜色
- * @returns 返回十六进制颜色文本
- * @example
- * formatRgbHex({ r: 255, g: 255, b: 255 })
- */
-function formatRgbHex(color) {
-    return `#${color.r.toString(16).padStart(2, "0")}${color.g
-        .toString(16)
-        .padStart(2, "0")}${color.b.toString(16).padStart(2, "0")}`;
-}
-/**
- * 从图片角落采样背景色
- * @param pixels RGBA 像素数据
- * @param width 图片宽度
- * @param height 图片高度
- * @param corner 采样角落
- * @returns 返回采样到的 RGB 颜色
- * @example
- * sampleCornerColor(pixels, 100, 100, "topLeft")
- */
-function sampleCornerColor(pixels, width, height, corner) {
-    const x = corner === "topRight" || corner === "bottomRight" ? width - 1 : 0;
-    const y = corner === "bottomLeft" || corner === "bottomRight" ? height - 1 : 0;
-    const offset = (y * width + x) * 4;
-    return {
-        r: pixels[offset] ?? 0,
-        g: pixels[offset + 1] ?? 0,
-        b: pixels[offset + 2] ?? 0,
-    };
-}
-/**
- * 判断颜色是否在容差范围内
- * @param pixels RGBA 像素数据
- * @param offset 像素偏移
- * @param color 目标 RGB 颜色
- * @param tolerance RGB 欧氏距离容差
- * @returns 匹配返回 true
- * @example
- * isColorMatch(pixels, 0, { r: 255, g: 255, b: 255 }, 20)
- */
-function isColorMatch(pixels, offset, color, tolerance) {
-    const dr = (pixels[offset] ?? 0) - color.r;
-    const dg = (pixels[offset + 1] ?? 0) - color.g;
-    const db = (pixels[offset + 2] ?? 0) - color.b;
-    return Math.sqrt(dr * dr + dg * dg + db * db) <= tolerance;
-}
-/**
- * 读取图片为 RGBA 原始像素
- * @param input 图片路径或 Buffer
- * @returns 返回像素和图片尺寸
- * @example
- * const image = await readRgbaImage("/tmp/screen.jpg")
- */
-async function readRgbaImage(input) {
-    const { data, info } = await (0, sharp_1.default)(input)
-        .ensureAlpha()
-        .raw()
-        .toBuffer({ resolveWithObject: true });
-    return {
-        data,
-        width: info.width,
-        height: info.height,
-    };
-}
-/**
- * 获取指定坐标附近的平均颜色
- * @param data RGBA 像素数据
- * @param width 图片宽度
- * @param height 图片高度
- * @param x 目标坐标 x
- * @param y 目标坐标 y
- * @param radius 采样半径
- * @returns 返回平均 RGBA 颜色和采样像素数量
- * @example
- * pickAverageColor(data, 100, 100, 10, 10, 1)
- */
-function pickAverageColor(data, width, height, x, y, radius) {
-    if (x >= width || y >= height) {
-        throw new Error(`坐标超出图片范围: image=${width}x${height}, point=${x},${y}`);
-    }
-    const startX = Math.max(0, x - radius);
-    const endX = Math.min(width - 1, x + radius);
-    const startY = Math.max(0, y - radius);
-    const endY = Math.min(height - 1, y + radius);
-    let r = 0;
-    let g = 0;
-    let b = 0;
-    let a = 0;
-    let sampleCount = 0;
-    for (let currentY = startY; currentY <= endY; currentY += 1) {
-        for (let currentX = startX; currentX <= endX; currentX += 1) {
-            const offset = (currentY * width + currentX) * 4;
-            r += data[offset] ?? 0;
-            g += data[offset + 1] ?? 0;
-            b += data[offset + 2] ?? 0;
-            a += data[offset + 3] ?? 0;
-            sampleCount += 1;
-        }
-    }
-    return {
-        color: {
-            r: Math.round(r / sampleCount),
-            g: Math.round(g / sampleCount),
-            b: Math.round(b / sampleCount),
-            a: Math.round(a / sampleCount),
-        },
-        sampleCount,
-    };
-}
-/**
- * 格式化取色结果
- * @param source 颜色来源
- * @param x 坐标 x
- * @param y 坐标 y
- * @param radius 采样半径
- * @param imageWidth 图片宽度
- * @param imageHeight 图片高度
- * @param color 颜色
- * @param sampleCount 采样像素数量
- * @returns 返回 MCP 文本
- * @example
- * formatPickedColorText("screen", 1, 1, 0, 100, 100, color, 1)
- */
-function formatPickedColorText(source, x, y, radius, imageWidth, imageHeight, color, sampleCount) {
-    return [
-        "取色成功",
-        `source: ${source}`,
-        `image: ${imageWidth}x${imageHeight}`,
-        `point: x=${x}, y=${y}`,
-        `radius: ${radius}`,
-        `samplePixels: ${sampleCount}`,
-        `hex: ${formatRgbHex(color)}`,
-        `rgb: ${color.r},${color.g},${color.b}`,
-        `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 服务实例
- * @returns 无返回值
- * @example
- * registerImageTools(server)
- */
-function registerImageTools(server) {
-    server.registerTool("image_crop", {
-        title: "Image Crop",
-        description: "裁切本地图片并输出 PNG 文件，适合从截图中裁出找图模板。",
-        inputSchema: {
-            imagePath: z.string().min(1).describe("输入图片路径"),
-            x: z.number().int().min(0).describe("裁切起点 x"),
-            y: z.number().int().min(0).describe("裁切起点 y"),
-            width: z.number().int().min(1).describe("裁切宽度"),
-            height: z.number().int().min(1).describe("裁切高度"),
-            outputPath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("可选输出路径；不传则在输入图片同目录生成 *-crop.png"),
-        },
-    }, async ({ 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) {
-            return (0, tool_utils_1.createTextToolResult)(`裁切范围超出图片尺寸: image=${imageWidth}x${imageHeight}, crop=${x},${y},${width},${height}`, true);
-        }
-        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 (0, tool_utils_1.createTextToolResult)([
-            "图片裁切成功",
-            `input: ${inputPath}`,
-            `output: ${targetPath}`,
-            `crop: x=${x}, y=${y}, width=${width}, height=${height}`,
-            `size: ${info.size} bytes`,
-        ].join("\n"));
-    });
-    server.registerTool("screen_crop", {
-        title: "Screen Crop",
-        description: "从当前默认设备截图中按坐标裁切 PNG 文件，适合自动截取找图模板。",
-        inputSchema: {
-            x: z.number().int().min(0).describe("裁切起点 x"),
-            y: z.number().int().min(0).describe("裁切起点 y"),
-            width: z.number().int().min(1).describe("裁切宽度"),
-            height: z.number().int().min(1).describe("裁切高度"),
-            outputPath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("可选输出路径；不传则写入系统临时目录"),
-        },
-    }, async ({ x, y, width, height, outputPath }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const screenshot = await (0, project_1.getScreenshotOnDevice)((0, tool_utils_1.createRuntimeHttpRequestOptions)(target));
-        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) {
-            return (0, tool_utils_1.createTextToolResult)(`裁切范围超出截图尺寸: image=${imageWidth}x${imageHeight}, crop=${x},${y},${width},${height}`, true);
-        }
-        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 (0, tool_utils_1.createTextToolResult)([
-            "屏幕裁图成功",
-            `device: ${target.label}`,
-            `output: ${targetPath}`,
-            `screen: ${imageWidth}x${imageHeight}`,
-            `crop: x=${x}, y=${y}, width=${width}, height=${height}`,
-            `size: ${info.size} bytes`,
-        ].join("\n"));
-    });
-    server.registerTool("image_pick_color", {
-        title: "Image Pick Color",
-        description: "读取本地图片指定坐标颜色，返回 hex/rgb/rgba，适合生成找色代码。",
-        inputSchema: {
-            imagePath: z.string().min(1).describe("输入图片路径"),
-            x: z.number().int().min(0).describe("目标坐标 x"),
-            y: z.number().int().min(0).describe("目标坐标 y"),
-            radius: z
-                .number()
-                .int()
-                .min(0)
-                .max(20)
-                .optional()
-                .default(0)
-                .describe("采样半径，0 表示只取单点，默认 0"),
-        },
-    }, async ({ 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 (0, tool_utils_1.createTextToolResult)(formatPickedColorText(inputPath, x, y, radius, image.width, image.height, picked.color, picked.sampleCount));
-    });
-    server.registerTool("screen_pick_color", {
-        title: "Screen Pick Color",
-        description: "从当前默认设备截图中读取指定坐标颜色，返回 hex/rgb/rgba，适合自动生成找色代码。",
-        inputSchema: {
-            x: z.number().int().min(0).describe("目标坐标 x"),
-            y: z.number().int().min(0).describe("目标坐标 y"),
-            radius: z
-                .number()
-                .int()
-                .min(0)
-                .max(20)
-                .optional()
-                .default(0)
-                .describe("采样半径，0 表示只取单点，默认 0"),
-        },
-    }, async ({ x, y, radius }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const screenshot = await (0, project_1.getScreenshotOnDevice)((0, tool_utils_1.createRuntimeHttpRequestOptions)(target));
-        const image = await readRgbaImage(screenshot);
-        const picked = pickAverageColor(image.data, image.width, image.height, x, y, radius);
-        return (0, tool_utils_1.createTextToolResult)(formatPickedColorText(target.label, x, y, radius, image.width, image.height, picked.color, picked.sampleCount));
-    });
-    server.registerTool("image_make_transparent", {
-        title: "Image Make Transparent",
-        description: "将图片中接近指定颜色或角落背景色的像素设为透明，并输出 PNG 文件，适合制作找图模板透明图。",
-        inputSchema: {
-            imagePath: z.string().min(1).describe("输入图片路径"),
-            outputPath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("可选输出路径；不传则在输入图片同目录生成 *-transparent.png"),
-            transparentColor: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("要透明化的颜色，格式 #RRGGBB；不传则从指定角落采样"),
-            sampleCorner: z
-                .enum(["topLeft", "topRight", "bottomLeft", "bottomRight"])
-                .optional()
-                .default("topLeft")
-                .describe("未传 transparentColor 时采样的背景角落，默认 topLeft"),
-            tolerance: z
-                .number()
-                .int()
-                .min(0)
-                .max(441)
-                .optional()
-                .default(24)
-                .describe("RGB 欧氏距离容差，默认 24，最大 441"),
-        },
-    }, async ({ 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 (0, tool_utils_1.createTextToolResult)([
-            "透明图制作成功",
-            `input: ${inputPath}`,
-            `output: ${targetPath}`,
-            `image: ${info.width}x${info.height}`,
-            `transparentColor: ${formatRgbHex(targetColor)}`,
-            `tolerance: ${tolerance}`,
-            `transparentPixels: ${transparentPixelCount}`,
-            `size: ${output.size} bytes`,
-        ].join("\n"));
-    });
-}
+"use strict";var B=exports&&exports.__createBinding||(Object.create?(function(r,t,e,n){n===void 0&&(n=e);var i=Object.getOwnPropertyDescriptor(t,e);(!i||("get"in i?!t.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return t[e]}}),Object.defineProperty(r,n,i)}):(function(r,t,e,n){n===void 0&&(n=e),r[n]=t[e]})),G=exports&&exports.__setModuleDefault||(Object.create?(function(r,t){Object.defineProperty(r,"default",{enumerable:!0,value:t})}):function(r,t){r.default=t}),v=exports&&exports.__importStar||(function(){var r=function(t){return r=Object.getOwnPropertyNames||function(e){var n=[];for(var i in e)Object.prototype.hasOwnProperty.call(e,i)&&(n[n.length]=i);return n},r(t)};return function(t){if(t&&t.__esModule)return t;var e={};if(t!=null)for(var n=r(t),i=0;i<n.length;i++)n[i]!=="default"&&B(e,t,n[i]);return G(e,t),e}})(),L=exports&&exports.__importDefault||function(r){return r&&r.__esModule?r:{default:r}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.cropLocalImage=H,exports.cropDeviceScreen=k,exports.pickLocalImageColor=E,exports.pickDeviceScreenColor=F,exports.makeLocalImageTransparent=N,exports.registerImageTools=W;const b=v(require("fs-extra")),q=v(require("os")),h=v(require("path")),d=L(require("sharp")),l=v(require("zod/v4")),C=require("../project"),f=require("./tool-utils");function R(r,t,e){if(t&&t.trim())return h.resolve(t.trim());const n=h.parse(h.resolve(r));return h.join(n.dir,`${n.name}-${e}.png`)}function D(r,t,e){return r&&r.trim()?h.resolve(r.trim()):h.join(q.tmpdir(),`${t}-${Date.now()}-${Math.random().toString(36).slice(2,8)}.${e}`)}async function _(r){const t=h.resolve(r.trim());if(!await b.pathExists(t))throw new Error(`\u56FE\u7247\u4E0D\u5B58\u5728: ${t}`);return t}function I(r){const t=r.trim().replace(/^#/,"");if(!/^[0-9a-fA-F]{6}$/.test(t))throw new Error("transparentColor \u5FC5\u987B\u662F #RRGGBB \u6216 RRGGBB \u683C\u5F0F\u3002");return{r:Number.parseInt(t.slice(0,2),16),g:Number.parseInt(t.slice(2,4),16),b:Number.parseInt(t.slice(4,6),16)}}function j(r){return`#${r.r.toString(16).padStart(2,"0")}${r.g.toString(16).padStart(2,"0")}${r.b.toString(16).padStart(2,"0")}`}function M(r,t,e,n){const i=n==="topRight"||n==="bottomRight"?t-1:0,a=((n==="bottomLeft"||n==="bottomRight"?e-1:0)*t+i)*4;return{r:r[a]??0,g:r[a+1]??0,b:r[a+2]??0}}function z(r,t,e,n){const i=(r[t]??0)-e.r,o=(r[t+1]??0)-e.g,a=(r[t+2]??0)-e.b;return Math.sqrt(i*i+o*o+a*a)<=n}async function T(r){const{data:t,info:e}=await(0,d.default)(r).ensureAlpha().raw().toBuffer({resolveWithObject:!0});return{data:t,width:e.width,height:e.height}}function S(r,t,e,n,i,o){if(n>=t||i>=e)throw new Error(`\u5750\u6807\u8D85\u51FA\u56FE\u7247\u8303\u56F4: image=${t}x${e}, point=${n},${i}`);const a=Math.max(0,n-o),s=Math.min(t-1,n+o),c=Math.max(0,i-o),u=Math.min(e-1,i+o);let p=0,m=0,g=0,$=0,w=0;for(let y=c;y<=u;y+=1)for(let O=a;O<=s;O+=1){const P=(y*t+O)*4;p+=r[P]??0,m+=r[P+1]??0,g+=r[P+2]??0,$+=r[P+3]??0,w+=1}return{color:{r:Math.round(p/w),g:Math.round(m/w),b:Math.round(g/w),a:Math.round($/w)},sampleCount:w}}function x(r,t,e,n,i,o,a,s){return["\u53D6\u8272\u6210\u529F",`source: ${r}`,`image: ${i}x${o}`,`point: x=${t}, y=${e}`,`radius: ${n}`,`samplePixels: ${s}`,`hex: ${j(a)}`,`rgb: ${a.r},${a.g},${a.b}`,`rgba: ${a.r},${a.g},${a.b},${a.a}`].join(`
+`)}async function H(r,t,e,n,i,o){const a=await _(r),s=R(a,o,"crop"),c=await(0,d.default)(a).metadata(),u=c.width??0,p=c.height??0;if(t+n>u||e+i>p)throw new Error(`\u88C1\u5207\u8303\u56F4\u8D85\u51FA\u56FE\u7247\u5C3A\u5BF8: image=${u}x${p}, crop=${t},${e},${n},${i}`);await b.ensureDir(h.dirname(s));const m=await(0,d.default)(a).extract({left:t,top:e,width:n,height:i}).png().toFile(s);return["\u56FE\u7247\u88C1\u5207\u6210\u529F",`input: ${a}`,`output: ${s}`,`crop: x=${t}, y=${e}, width=${n}, height=${i}`,`size: ${m.size} bytes`].join(`
+`)}async function k(r,t,e,n,i,o){const a=await(0,C.getScreenshotOnDevice)({ip:r.ip,port:r.port,transport:"http"}),s=await(0,d.default)(a).metadata(),c=s.width??0,u=s.height??0;if(t+n>c||e+i>u)throw new Error(`\u88C1\u5207\u8303\u56F4\u8D85\u51FA\u622A\u56FE\u5C3A\u5BF8: image=${c}x${u}, crop=${t},${e},${n},${i}`);const p=D(o,"ms-mcp-screen-crop","png");await b.ensureDir(h.dirname(p));const m=await(0,d.default)(a).extract({left:t,top:e,width:n,height:i}).png().toFile(p);return["\u5C4F\u5E55\u88C1\u56FE\u6210\u529F",`device: ${r.label}`,`output: ${p}`,`screen: ${c}x${u}`,`crop: x=${t}, y=${e}, width=${n}, height=${i}`,`size: ${m.size} bytes`].join(`
+`)}async function E(r,t,e,n){const i=await _(r),o=await T(i),a=S(o.data,o.width,o.height,t,e,n);return x(i,t,e,n,o.width,o.height,a.color,a.sampleCount)}async function F(r,t,e,n){const i=await(0,C.getScreenshotOnDevice)({ip:r.ip,port:r.port,transport:"http"}),o=await T(i),a=S(o.data,o.width,o.height,t,e,n);return x(r.label,t,e,n,o.width,o.height,a.color,a.sampleCount)}async function N(r,t,e,n,i){const o=await _(r),a=R(o,t,"transparent"),{data:s,info:c}=await(0,d.default)(o).ensureAlpha().raw().toBuffer({resolveWithObject:!0}),u=e?I(e):M(s,c.width,c.height,n);let p=0;for(let g=0;g<s.length;g+=4)z(s,g,u,i)&&(s[g+3]=0,p+=1);await b.ensureDir(h.dirname(a));const m=await(0,d.default)(s,{raw:{width:c.width,height:c.height,channels:4}}).png().toFile(a);return["\u900F\u660E\u56FE\u5236\u4F5C\u6210\u529F",`input: ${o}`,`output: ${a}`,`image: ${c.width}x${c.height}`,`transparentColor: ${j(u)}`,`tolerance: ${i}`,`transparentPixels: ${p}`,`size: ${m.size} bytes`].join(`
+`)}function W(r){r.registerTool("image_crop",{title:"Image Crop",description:"\u88C1\u5207\u672C\u5730\u56FE\u7247\u5E76\u8F93\u51FA PNG \u6587\u4EF6\uFF0C\u9002\u5408\u4ECE\u622A\u56FE\u4E2D\u88C1\u51FA\u627E\u56FE\u6A21\u677F\u3002",inputSchema:{imagePath:l.string().min(1).describe("\u8F93\u5165\u56FE\u7247\u8DEF\u5F84"),x:l.number().int().min(0).describe("\u88C1\u5207\u8D77\u70B9 x"),y:l.number().int().min(0).describe("\u88C1\u5207\u8D77\u70B9 y"),width:l.number().int().min(1).describe("\u88C1\u5207\u5BBD\u5EA6"),height:l.number().int().min(1).describe("\u88C1\u5207\u9AD8\u5EA6"),outputPath:l.string().min(1).optional().describe("\u53EF\u9009\u8F93\u51FA\u8DEF\u5F84\uFF1B\u4E0D\u4F20\u5219\u5728\u8F93\u5165\u56FE\u7247\u540C\u76EE\u5F55\u751F\u6210 *-crop.png")}},async({imagePath:t,x:e,y:n,width:i,height:o,outputPath:a})=>{const s=await _(t),c=R(s,a,"crop"),u=await(0,d.default)(s).metadata(),p=u.width??0,m=u.height??0;if(e+i>p||n+o>m)return(0,f.createTextToolResult)(`\u88C1\u5207\u8303\u56F4\u8D85\u51FA\u56FE\u7247\u5C3A\u5BF8: image=${p}x${m}, crop=${e},${n},${i},${o}`,!0);await b.ensureDir(h.dirname(c));const g=await(0,d.default)(s).extract({left:e,top:n,width:i,height:o}).png().toFile(c);return(0,f.createTextToolResult)(["\u56FE\u7247\u88C1\u5207\u6210\u529F",`input: ${s}`,`output: ${c}`,`crop: x=${e}, y=${n}, width=${i}, height=${o}`,`size: ${g.size} bytes`].join(`
+`))}),r.registerTool("screen_crop",{title:"Screen Crop",description:"\u4ECE\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u622A\u56FE\u4E2D\u6309\u5750\u6807\u88C1\u5207 PNG \u6587\u4EF6\uFF0C\u9002\u5408\u81EA\u52A8\u622A\u53D6\u627E\u56FE\u6A21\u677F\u3002",inputSchema:{x:l.number().int().min(0).describe("\u88C1\u5207\u8D77\u70B9 x"),y:l.number().int().min(0).describe("\u88C1\u5207\u8D77\u70B9 y"),width:l.number().int().min(1).describe("\u88C1\u5207\u5BBD\u5EA6"),height:l.number().int().min(1).describe("\u88C1\u5207\u9AD8\u5EA6"),outputPath:l.string().min(1).optional().describe("\u53EF\u9009\u8F93\u51FA\u8DEF\u5F84\uFF1B\u4E0D\u4F20\u5219\u5199\u5165\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55")}},async({x:t,y:e,width:n,height:i,outputPath:o})=>{const a=await(0,f.resolveRuntimeHttpTarget)(),s=await(0,C.getScreenshotOnDevice)((0,f.createRuntimeHttpRequestOptions)(a)),c=await(0,d.default)(s).metadata(),u=c.width??0,p=c.height??0;if(t+n>u||e+i>p)return(0,f.createTextToolResult)(`\u88C1\u5207\u8303\u56F4\u8D85\u51FA\u622A\u56FE\u5C3A\u5BF8: image=${u}x${p}, crop=${t},${e},${n},${i}`,!0);const m=D(o,"ms-mcp-screen-crop","png");await b.ensureDir(h.dirname(m));const g=await(0,d.default)(s).extract({left:t,top:e,width:n,height:i}).png().toFile(m);return(0,f.createTextToolResult)(["\u5C4F\u5E55\u88C1\u56FE\u6210\u529F",`device: ${a.label}`,`output: ${m}`,`screen: ${u}x${p}`,`crop: x=${t}, y=${e}, width=${n}, height=${i}`,`size: ${g.size} bytes`].join(`
+`))}),r.registerTool("image_pick_color",{title:"Image Pick Color",description:"\u8BFB\u53D6\u672C\u5730\u56FE\u7247\u6307\u5B9A\u5750\u6807\u989C\u8272\uFF0C\u8FD4\u56DE hex/rgb/rgba\uFF0C\u9002\u5408\u751F\u6210\u627E\u8272\u4EE3\u7801\u3002",inputSchema:{imagePath:l.string().min(1).describe("\u8F93\u5165\u56FE\u7247\u8DEF\u5F84"),x:l.number().int().min(0).describe("\u76EE\u6807\u5750\u6807 x"),y:l.number().int().min(0).describe("\u76EE\u6807\u5750\u6807 y"),radius:l.number().int().min(0).max(20).optional().default(0).describe("\u91C7\u6837\u534A\u5F84\uFF0C0 \u8868\u793A\u53EA\u53D6\u5355\u70B9\uFF0C\u9ED8\u8BA4 0")}},async({imagePath:t,x:e,y:n,radius:i})=>{const o=await _(t),a=await T(o),s=S(a.data,a.width,a.height,e,n,i);return(0,f.createTextToolResult)(x(o,e,n,i,a.width,a.height,s.color,s.sampleCount))}),r.registerTool("screen_pick_color",{title:"Screen Pick Color",description:"\u4ECE\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u622A\u56FE\u4E2D\u8BFB\u53D6\u6307\u5B9A\u5750\u6807\u989C\u8272\uFF0C\u8FD4\u56DE hex/rgb/rgba\uFF0C\u9002\u5408\u81EA\u52A8\u751F\u6210\u627E\u8272\u4EE3\u7801\u3002",inputSchema:{x:l.number().int().min(0).describe("\u76EE\u6807\u5750\u6807 x"),y:l.number().int().min(0).describe("\u76EE\u6807\u5750\u6807 y"),radius:l.number().int().min(0).max(20).optional().default(0).describe("\u91C7\u6837\u534A\u5F84\uFF0C0 \u8868\u793A\u53EA\u53D6\u5355\u70B9\uFF0C\u9ED8\u8BA4 0")}},async({x:t,y:e,radius:n})=>{const i=await(0,f.resolveRuntimeHttpTarget)(),o=await(0,C.getScreenshotOnDevice)((0,f.createRuntimeHttpRequestOptions)(i)),a=await T(o),s=S(a.data,a.width,a.height,t,e,n);return(0,f.createTextToolResult)(x(i.label,t,e,n,a.width,a.height,s.color,s.sampleCount))}),r.registerTool("image_make_transparent",{title:"Image Make 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\uFF0C\u5E76\u8F93\u51FA PNG \u6587\u4EF6\uFF0C\u9002\u5408\u5236\u4F5C\u627E\u56FE\u6A21\u677F\u900F\u660E\u56FE\u3002",inputSchema:{imagePath:l.string().min(1).describe("\u8F93\u5165\u56FE\u7247\u8DEF\u5F84"),outputPath:l.string().min(1).optional().describe("\u53EF\u9009\u8F93\u51FA\u8DEF\u5F84\uFF1B\u4E0D\u4F20\u5219\u5728\u8F93\u5165\u56FE\u7247\u540C\u76EE\u5F55\u751F\u6210 *-transparent.png"),transparentColor:l.string().min(1).optional().describe("\u8981\u900F\u660E\u5316\u7684\u989C\u8272\uFF0C\u683C\u5F0F #RRGGBB\uFF1B\u4E0D\u4F20\u5219\u4ECE\u6307\u5B9A\u89D2\u843D\u91C7\u6837"),sampleCorner:l.enum(["topLeft","topRight","bottomLeft","bottomRight"]).optional().default("topLeft").describe("\u672A\u4F20 transparentColor \u65F6\u91C7\u6837\u7684\u80CC\u666F\u89D2\u843D\uFF0C\u9ED8\u8BA4 topLeft"),tolerance:l.number().int().min(0).max(441).optional().default(24).describe("RGB \u6B27\u6C0F\u8DDD\u79BB\u5BB9\u5DEE\uFF0C\u9ED8\u8BA4 24\uFF0C\u6700\u5927 441")}},async({imagePath:t,outputPath:e,transparentColor:n,sampleCorner:i,tolerance:o})=>{const a=await _(t),s=R(a,e,"transparent"),{data:c,info:u}=await(0,d.default)(a).ensureAlpha().raw().toBuffer({resolveWithObject:!0}),p=n?I(n):M(c,u.width,u.height,i);let m=0;for(let $=0;$<c.length;$+=4)z(c,$,p,o)&&(c[$+3]=0,m+=1);await b.ensureDir(h.dirname(s));const g=await(0,d.default)(c,{raw:{width:u.width,height:u.height,channels:4}}).png().toFile(s);return(0,f.createTextToolResult)(["\u900F\u660E\u56FE\u5236\u4F5C\u6210\u529F",`input: ${a}`,`output: ${s}`,`image: ${u.width}x${u.height}`,`transparentColor: ${j(p)}`,`tolerance: ${o}`,`transparentPixels: ${m}`,`size: ${g.size} bytes`].join(`
+`))})}

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

@@ -2,9 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export type OcrEngine = "appleocr" | "paddleocr";
 export type OcrMode = "recognize" | "numbers" | "findText";
 export type PaddleOcrModel = "ppocr-v6-tiny" | "ppocr-v6-small" | "ppocr-v5";
-/** PaddleOCR 内置可切换模型 ID；同一时间只保留一个 active 模型。 */
 export declare const PADDLE_OCR_MODELS: readonly ["ppocr-v6-tiny", "ppocr-v6-small", "ppocr-v5"];
-/** PaddleOCR 检测阶段默认最大边长，与运行时一致；传 0 或负数时回落到该值。 */
 export declare const PADDLE_OCR_DEFAULT_MAX_SIDE_LEN = 768;
 export type ScriptResultResponse = {
     success?: boolean;
@@ -36,32 +34,9 @@ export type OcrRecognitionResult = {
     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 服务实例
- * @returns 无返回值
- * @example
- * registerOcrTools(server)
- */
 export declare function registerOcrTools(server: McpServer): void;