ms-vite-plugin 1.4.47 → 1.4.49

package/dist/mcp/httpapi-tools.js

@@ -1,222 +1,4 @@
-"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.registerHttpApiTools = registerHttpApiTools;
-const z = __importStar(require("zod/v4"));
-const httpapi_docs_service_1 = require("./httpapi-docs-service");
-const tool_utils_1 = require("./tool-utils");
-/**
- * 标准化并校验 HTTP API 路径输入
- * @param apiPath 用户传入路径
- * @returns 返回标准化后的路径
- * @example
- * normalizeHttpApiPath("/api/status")
- */
-function normalizeHttpApiPath(apiPath) {
-    const normalizedPath = apiPath.trim();
-    if (/^https?:\/\//i.test(normalizedPath)) {
-        throw new Error("path 只能传 HTTP API 相对路径，不能传完整 URL。");
-    }
-    if (!normalizedPath.startsWith("/")) {
-        throw new Error("path 必须以 / 开头，例如 /api/status。");
-    }
-    if (normalizedPath.includes("?")) {
-        throw new Error("path 不能包含 query string，请使用 query 参数传递查询参数。");
-    }
-    return normalizedPath;
-}
-/**
- * 将 query 参数追加到 URL
- * @param url 目标 URL
- * @param query 可选 query 参数
- * @returns 无返回值
- * @example
- * appendQueryParams(url, { x: 1 })
- */
-function appendQueryParams(url, query) {
-    if (!query) {
-        return;
-    }
-    for (const [key, value] of Object.entries(query)) {
-        if (value === undefined || value === null) {
-            continue;
-        }
-        url.searchParams.set(key, String(value));
-    }
-}
-/**
- * 构建 JSON HTTP 请求体
- * @param body 工具调用传入的 body
- * @returns 返回可直接用于 fetch 的请求体和头
- * @example
- * createHttpRequestBody({ actions: [] })
- */
-function createHttpRequestBody(body) {
-    if (body === undefined) {
-        return {};
-    }
-    const headers = {
-        "Content-Type": "application/json",
-    };
-    if (typeof body === "string") {
-        const trimmedBody = body.trim();
-        try {
-            JSON.parse(trimmedBody);
-            return {
-                headers,
-                requestBody: trimmedBody,
-            };
-        }
-        catch {
-            return {
-                headers,
-                requestBody: JSON.stringify(body),
-            };
-        }
-    }
-    return {
-        headers,
-        requestBody: JSON.stringify(body),
-    };
-}
-/**
- * 读取响应体并按要求格式化
- * @param response fetch 响应对象
- * @param responseFormat 响应格式
- * @returns 返回格式化文本
- * @example
- * const text = await readHttpApiResponseText(response, "json")
- */
-async function readHttpApiResponseText(response, responseFormat) {
-    const responseText = await response.text();
-    if (responseFormat === "text") {
-        return responseText;
-    }
-    try {
-        return (0, tool_utils_1.formatRuntimeJsonText)(JSON.parse(responseText));
-    }
-    catch {
-        throw new Error("响应不是有效 JSON；如需读取文本响应，请设置 responseFormat=text。");
-    }
-}
-/**
- * 注册通用 HTTP API 调用工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerHttpApiTools(server)
- */
-function registerHttpApiTools(server) {
-    server.registerTool("http_api_call", {
-        title: "HTTP API Call",
-        description: "调用 HTTP API 文档中已声明的接口。使用前应直接读取 get_docs_paths 返回的 HTTP API 文档，确认 method、path、query/body 参数；本工具会拒绝文档中未声明的 method/path。",
-        inputSchema: {
-            method: z
-                .enum(["GET", "POST"])
-                .describe("HTTP 方法，必须与 HTTP API 文档一致"),
-            path: z
-                .string()
-                .min(1)
-                .describe("HTTP API 相对路径，例如 /api/control/click；不能包含 query string"),
-            query: z
-                .record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]))
-                .optional()
-                .describe("query 参数；GET 接口通常使用 query 传参"),
-            body: z
-                .unknown()
-                .optional()
-                .describe("POST 请求体；始终按 JSON 提交。推荐传 JSON 对象；JSON 字符串会按原 JSON 提交，普通字符串会作为 JSON 字符串值提交。"),
-            responseFormat: z
-                .enum(["json", "text"])
-                .optional()
-                .default("json")
-                .describe("响应解析格式，默认 json"),
-            timeoutMs: z
-                .number()
-                .int()
-                .min(1000)
-                .max(600000)
-                .optional()
-                .default(30000)
-                .describe("请求超时时间，默认 30000 毫秒"),
-        },
-    }, async ({ method, path, query, body, responseFormat, timeoutMs, }) => {
-        const apiPath = normalizeHttpApiPath(path);
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(apiPath, method);
-        if (!entry) {
-            return (0, tool_utils_1.createTextToolResult)([
-                `HTTP API 文档中不存在该接口: ${method} ${apiPath}`,
-                "请直接读取 get_docs_paths 返回的 HTTP API 文档路径，确认接口 method、path 和参数。",
-            ].join("\n"), true);
-        }
-        if (method === "GET" && body !== undefined) {
-            return (0, tool_utils_1.createTextToolResult)("GET 接口不能传 body，请使用 query 参数。", true);
-        }
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const url = new URL(`http://${target.ip}:${target.port}${apiPath}`);
-        appendQueryParams(url, query);
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), timeoutMs);
-        try {
-            const { headers, requestBody } = createHttpRequestBody(body);
-            const response = await fetch(url.toString(), {
-                method,
-                signal: controller.signal,
-                headers,
-                body: requestBody,
-            });
-            const responseText = await readHttpApiResponseText(response, responseFormat);
-            return (0, tool_utils_1.createTextToolResult)([
-                `HTTP API 调用${response.ok ? "成功" : "失败"}: ${method} ${apiPath}`,
-                `设备: ${target.label}`,
-                `文档: ${entry.title} (lines ${entry.startLine}-${entry.endLine})`,
-                `状态码: ${response.status}`,
-                "",
-                responseText,
-            ].join("\n"), !response.ok);
-        }
-        catch (error) {
-            const message = error instanceof Error && error.name === "AbortError"
-                ? `请求超时: ${timeoutMs}ms`
-                : error instanceof Error
-                    ? error.message
-                    : String(error);
-            return (0, tool_utils_1.createTextToolResult)(`HTTP API 调用失败: ${method} ${apiPath}\n${message}`, true);
-        }
-        finally {
-            clearTimeout(timeout);
-        }
-    });
-}
+"use strict";var _=exports&&exports.__createBinding||(Object.create?(function(e,t,r,n){n===void 0&&(n=r);var i=Object.getOwnPropertyDescriptor(t,r);(!i||("get"in i?!t.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,i)}):(function(e,t,r,n){n===void 0&&(n=r),e[n]=t[r]})),b=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),m=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var n=[];for(var i in r)Object.prototype.hasOwnProperty.call(r,i)&&(n[n.length]=i);return n},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var n=e(t),i=0;i<n.length;i++)n[i]!=="default"&&_(r,t,n[i]);return b(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.registerHttpApiTools=$;const o=m(require("zod/v4")),O=require("./httpapi-docs-service"),a=require("./tool-utils");function w(e){const t=e.trim();if(/^https?:\/\//i.test(t))throw new Error("path \u53EA\u80FD\u4F20 HTTP API \u76F8\u5BF9\u8DEF\u5F84\uFF0C\u4E0D\u80FD\u4F20\u5B8C\u6574 URL\u3002");if(!t.startsWith("/"))throw new Error("path \u5FC5\u987B\u4EE5 / \u5F00\u5934\uFF0C\u4F8B\u5982 /api/status\u3002");if(t.includes("?"))throw new Error("path \u4E0D\u80FD\u5305\u542B query string\uFF0C\u8BF7\u4F7F\u7528 query \u53C2\u6570\u4F20\u9012\u67E5\u8BE2\u53C2\u6570\u3002");return t}function H(e,t){if(t)for(const[r,n]of Object.entries(t))n!=null&&e.searchParams.set(r,String(n))}function S(e){if(e===void 0)return{};const t={"Content-Type":"application/json"};if(typeof e=="string"){const r=e.trim();try{return JSON.parse(r),{headers:t,requestBody:r}}catch{return{headers:t,requestBody:JSON.stringify(e)}}}return{headers:t,requestBody:JSON.stringify(e)}}async function A(e,t){const r=await e.text();if(t==="text")return r;try{return(0,a.formatRuntimeJsonText)(JSON.parse(r))}catch{throw new Error("\u54CD\u5E94\u4E0D\u662F\u6709\u6548 JSON\uFF1B\u5982\u9700\u8BFB\u53D6\u6587\u672C\u54CD\u5E94\uFF0C\u8BF7\u8BBE\u7F6E responseFormat=text\u3002")}}function $(e){e.registerTool("http_api_call",{title:"HTTP API Call",description:"\u8C03\u7528 HTTP API \u6587\u6863\u4E2D\u5DF2\u58F0\u660E\u7684\u63A5\u53E3\u3002\u4F7F\u7528\u524D\u5E94\u76F4\u63A5\u8BFB\u53D6 get_docs_paths \u8FD4\u56DE\u7684 HTTP API \u6587\u6863\uFF0C\u786E\u8BA4 method\u3001path\u3001query/body \u53C2\u6570\uFF1B\u672C\u5DE5\u5177\u4F1A\u62D2\u7EDD\u6587\u6863\u4E2D\u672A\u58F0\u660E\u7684 method/path\u3002",inputSchema:{method:o.enum(["GET","POST"]).describe("HTTP \u65B9\u6CD5\uFF0C\u5FC5\u987B\u4E0E HTTP API \u6587\u6863\u4E00\u81F4"),path:o.string().min(1).describe("HTTP API \u76F8\u5BF9\u8DEF\u5F84\uFF0C\u4F8B\u5982 /api/control/click\uFF1B\u4E0D\u80FD\u5305\u542B query string"),query:o.record(o.string(),o.union([o.string(),o.number(),o.boolean(),o.null()])).optional().describe("query \u53C2\u6570\uFF1BGET \u63A5\u53E3\u901A\u5E38\u4F7F\u7528 query \u4F20\u53C2"),body:o.unknown().optional().describe("POST \u8BF7\u6C42\u4F53\uFF1B\u59CB\u7EC8\u6309 JSON \u63D0\u4EA4\u3002\u63A8\u8350\u4F20 JSON \u5BF9\u8C61\uFF1BJSON \u5B57\u7B26\u4E32\u4F1A\u6309\u539F JSON \u63D0\u4EA4\uFF0C\u666E\u901A\u5B57\u7B26\u4E32\u4F1A\u4F5C\u4E3A JSON \u5B57\u7B26\u4E32\u503C\u63D0\u4EA4\u3002"),responseFormat:o.enum(["json","text"]).optional().default("json").describe("\u54CD\u5E94\u89E3\u6790\u683C\u5F0F\uFF0C\u9ED8\u8BA4 json"),timeoutMs:o.number().int().min(1e3).max(6e5).optional().default(3e4).describe("\u8BF7\u6C42\u8D85\u65F6\u65F6\u95F4\uFF0C\u9ED8\u8BA4 30000 \u6BEB\u79D2")}},async({method:t,path:r,query:n,body:i,responseFormat:y,timeoutMs:T})=>{const u=w(r),c=await(0,O.findHttpApiDocEntry)(u,t);if(!c)return(0,a.createTextToolResult)([`HTTP API \u6587\u6863\u4E2D\u4E0D\u5B58\u5728\u8BE5\u63A5\u53E3: ${t} ${u}`,"\u8BF7\u76F4\u63A5\u8BFB\u53D6 get_docs_paths \u8FD4\u56DE\u7684 HTTP API \u6587\u6863\u8DEF\u5F84\uFF0C\u786E\u8BA4\u63A5\u53E3 method\u3001path \u548C\u53C2\u6570\u3002"].join(`
+`),!0);if(t==="GET"&&i!==void 0)return(0,a.createTextToolResult)("GET \u63A5\u53E3\u4E0D\u80FD\u4F20 body\uFF0C\u8BF7\u4F7F\u7528 query \u53C2\u6570\u3002",!0);const f=await(0,a.resolveRuntimeHttpTarget)(),d=new URL(`http://${f.ip}:${f.port}${u}`);H(d,n);const h=new AbortController,P=setTimeout(()=>h.abort(),T);try{const{headers:s,requestBody:p}=S(i),l=await fetch(d.toString(),{method:t,signal:h.signal,headers:s,body:p}),g=await A(l,y);return(0,a.createTextToolResult)([`HTTP API \u8C03\u7528${l.ok?"\u6210\u529F":"\u5931\u8D25"}: ${t} ${u}`,`\u8BBE\u5907: ${f.label}`,`\u6587\u6863: ${c.title} (lines ${c.startLine}-${c.endLine})`,`\u72B6\u6001\u7801: ${l.status}`,"",g].join(`
+`),!l.ok)}catch(s){const p=s instanceof Error&&s.name==="AbortError"?`\u8BF7\u6C42\u8D85\u65F6: ${T}ms`:s instanceof Error?s.message:String(s);return(0,a.createTextToolResult)(`HTTP API \u8C03\u7528\u5931\u8D25: ${t} ${u}
+${p}`,!0)}finally{clearTimeout(P)}})}

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

@@ -1,78 +1,16 @@
 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 服务实例
- * @returns 无返回值
- * @example
- * registerImageTools(server)
- */
 export declare function registerImageTools(server: McpServer): void;