ms-vite-plugin 1.4.47 → 1.4.49

package/dist/mcp/runtime-tools.js

@@ -1,308 +1,11 @@
-"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.registerRuntimeTools = registerRuntimeTools;
-const fsExtra = __importStar(require("fs-extra"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-const z = __importStar(require("zod/v4"));
-const packager_1 = require("../packager");
-const project_1 = require("../project");
-const device_config_1 = require("./device-config");
-const device_log_1 = require("./device-log");
-const project_2 = require("./project");
-const tool_utils_1 = require("./tool-utils");
-/**
- * 解析工具输出文件路径
- * @param outputPath 用户指定的可选输出路径
- * @param fileNamePrefix 临时文件名前缀
- * @param extension 文件扩展名（不含点）
- * @returns 返回最终输出文件绝对路径
- * @example
- * resolveOutputPath(undefined, "ms-mcp-screenshot", "jpg")
- */
-function resolveOutputPath(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 server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerRuntimeTools(server)
- */
-function registerRuntimeTools(server) {
-    /**
-     * MCP 进程内当前工作目录（仅内存态，不落盘）
-     * 说明：用于同一轮 MCP 进程内复用目录，进程重启后需由 AI 再次调用 set_workspace 设置。
-     */
-    let currentWorkspacePath;
-    /**
-     * 解析本次调用使用的工作目录
-     * 优先级：workspacePath 参数 > set_workspace 记忆值
-     * @param workspacePath 可选工作目录
-     * @returns 返回生效的绝对路径
-     * @example
-     * const workspace = resolveWorkspacePath("/Users/demo/project")
-     */
-    function resolveWorkspacePath(workspacePath) {
-        if (workspacePath && workspacePath.trim()) {
-            currentWorkspacePath = path.resolve(workspacePath.trim());
-            return currentWorkspacePath;
-        }
-        if (currentWorkspacePath) {
-            return currentWorkspacePath;
-        }
-        throw new Error("未设置工作目录：请先调用 set_workspace，或在本次工具调用时传 workspacePath。");
-    }
-    /**
-     * 校验并返回有效工作目录
-     * @param workspacePath 可选工作目录
-     * @returns 返回校验通过的绝对路径
-     * @example
-     * const workspace = await ensureWorkspacePath("/Users/demo/project")
-     */
-    async function ensureWorkspacePath(workspacePath) {
-        const workspace = resolveWorkspacePath(workspacePath);
-        await (0, project_2.ensureValidKuaiJSProject)(workspace);
-        return workspace;
-    }
-    server.registerTool("set_workspace", {
-        title: "Set Workspace",
-        description: "设置当前 MCP 进程内的默认工作目录。后续 build/run/package 优先使用该目录。",
-        inputSchema: {
-            workspacePath: z
-                .string()
-                .min(1)
-                .describe("快点JS 项目目录绝对路径（需包含 package.json 与 scripts）"),
-        },
-    }, async ({ workspacePath }) => {
-        const workspace = await ensureWorkspacePath(workspacePath);
-        return (0, tool_utils_1.createTextToolResult)(`默认工作目录已设置为: ${workspace}`);
-    });
-    server.registerTool("get_workspace", {
-        title: "Get Workspace",
-        description: "查看当前 MCP 进程内记忆的工作目录。",
-        inputSchema: {},
-    }, async () => {
-        if (!currentWorkspacePath) {
-            return (0, tool_utils_1.createTextToolResult)("当前未设置工作目录，请先调用 set_workspace。");
-        }
-        return (0, tool_utils_1.createTextToolResult)(`当前工作目录: ${currentWorkspacePath}`);
-    });
-    server.registerTool("set_device", {
-        title: "Set Device",
-        description: "设置当前唯一设备连接信息。设置后其余设备工具均复用该设备。",
-        inputSchema: {
-            ip: z.string().min(1).describe("设备 IP 地址，例如 192.168.1.100"),
-            port: z
-                .number()
-                .int()
-                .min(1)
-                .max(65535)
-                .optional()
-                .describe("设备端口，默认 9800"),
-        },
-    }, async ({ ip, port }) => {
-        const config = await (0, device_config_1.setDeviceConfig)(ip, port);
-        return (0, tool_utils_1.createTextToolResult)(`默认设备已设置为 ${config.ip}:${config.port}`);
-    });
-    server.registerTool("get_device", {
-        title: "Get Device",
-        description: "查看当前默认设备配置。",
-        inputSchema: {},
-    }, async () => {
-        const config = await (0, device_config_1.readDeviceConfig)();
-        if (!config) {
-            return (0, tool_utils_1.createTextToolResult)("当前未设置默认设备，请先调用 set_device。");
-        }
-        return (0, tool_utils_1.createTextToolResult)(`当前默认设备: ${config.ip}:${config.port}`);
-    });
-    server.registerTool("take_screenshot", {
-        title: "Take Screenshot",
-        description: "获取当前默认设备截图。可返回 base64，或落地到文件后返回文件路径（默认写入系统临时目录）。",
-        inputSchema: {
-            format: z
-                .enum(["file", "base64"])
-                .optional()
-                .default("file")
-                .describe("截图返回格式：file=文件路径，base64=图片 base64"),
-            outputPath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("当 format=file 时可指定输出路径，不传则写入系统临时目录"),
-        },
-    }, async ({ format, outputPath }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const requestOptions = (0, tool_utils_1.createRuntimeHttpRequestOptions)(target);
-        if (format === "base64") {
-            const base64 = await (0, project_1.getScreenshotBase64OnDevice)(requestOptions);
-            return (0, tool_utils_1.createTextToolResult)(`截图成功: ${target.label}\nformat: base64\n${base64}`);
-        }
-        const image = await (0, project_1.getScreenshotOnDevice)(requestOptions);
-        const targetPath = resolveOutputPath(outputPath, "ms-mcp-screenshot", "jpg");
-        await fsExtra.ensureDir(path.dirname(targetPath));
-        await fsExtra.writeFile(targetPath, image);
-        return (0, tool_utils_1.createTextToolResult)(`截图成功: ${target.label}\nformat: file\npath: ${targetPath}\nsize: ${image.length} bytes`);
-    });
-    server.registerTool("get_node_source", {
-        title: "Get Node Source",
-        description: "获取当前默认设备页面节点 XML，写入文件后返回路径，避免长文本响应被截断。",
-        inputSchema: {
-            maxDepth: z
-                .number()
-                .int()
-                .min(1)
-                .max(200)
-                .optional()
-                .default(50)
-                .describe("节点树最大深度，默认 50"),
-            timeout: z
-                .number()
-                .int()
-                .min(1)
-                .max(600)
-                .optional()
-                .default(120)
-                .describe("设备端节点抓取超时秒数，默认 120"),
-            mode: z
-                .number()
-                .int()
-                .min(1)
-                .max(3)
-                .optional()
-                .default(1)
-                .describe("节点抓取模式：1、2、3，默认 1"),
-            outputPath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("可选输出文件路径，不传则写入系统临时目录"),
-        },
-    }, async ({ maxDepth, timeout, mode, outputPath }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const requestOptions = (0, tool_utils_1.createRuntimeHttpRequestOptions)(target);
-        const source = await (0, project_1.getSourceOnDevice)(requestOptions, maxDepth, timeout, mode);
-        const targetPath = resolveOutputPath(outputPath, "ms-mcp-node-source", "xml");
-        await fsExtra.ensureDir(path.dirname(targetPath));
-        await fsExtra.writeFile(targetPath, source, "utf8");
-        return (0, tool_utils_1.createTextToolResult)(`节点获取成功: ${target.label}\nmaxDepth: ${maxDepth}\ntimeout: ${timeout}\nmode: ${mode}\npath: ${targetPath}\nsize: ${Buffer.byteLength(source, "utf8")} bytes`);
-    });
-    server.registerTool("get_logs", {
-        title: "Get Device Logs",
-        description: "获取当前默认设备的最新日志行。",
-        inputSchema: {
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(5000)
-                .optional()
-                .default(200)
-                .describe("返回最近日志条数，默认 200，最大 5000"),
-        },
-    }, async ({ limit }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        return (0, tool_utils_1.createTextToolResult)(await (0, device_log_1.buildDeviceLogSnapshotText)(target, limit));
-    });
-    server.registerTool("package_project", {
-        title: "Package Project",
-        description: "执行生产构建并加密，返回 enc.msbundle 路径。",
-        inputSchema: {
-            workspacePath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("可选工作目录；不传时使用 set_workspace 记忆值"),
-        },
-    }, async ({ workspacePath }) => {
-        const workspace = await ensureWorkspacePath(workspacePath);
-        const encryptedPath = await (0, packager_1.packageProject)(workspace);
-        return (0, tool_utils_1.createTextToolResult)(`打包完成: ${encryptedPath}`);
-    });
-    server.registerTool("run_project", {
-        title: "Run Project",
-        description: "构建并同步到当前默认设备后运行项目，仅使用 HTTP 设备连接。",
-        inputSchema: {
-            workspacePath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("可选工作目录；不传时使用 set_workspace 记忆值"),
-        },
-    }, async ({ workspacePath }) => {
-        const workspace = await ensureWorkspacePath(workspacePath);
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        await (0, project_1.runOnDevice)({
-            ...(0, tool_utils_1.createRuntimeHttpRequestOptions)(target),
-            workspacePath: workspace,
-        });
-        return (0, tool_utils_1.createTextToolResult)(`运行请求已发送到 ${target.label}`);
-    });
-    server.registerTool("run_ui_project", {
-        title: "Run UI Project",
-        description: "构建并同步到当前默认设备后预览 UI，仅使用 HTTP 设备连接。",
-        inputSchema: {
-            workspacePath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("可选工作目录；不传时使用 set_workspace 记忆值"),
-        },
-    }, async ({ workspacePath }) => {
-        const workspace = await ensureWorkspacePath(workspacePath);
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        await (0, project_1.runUIOnDevice)({
-            ...(0, tool_utils_1.createRuntimeHttpRequestOptions)(target),
-            workspacePath: workspace,
-        });
-        return (0, tool_utils_1.createTextToolResult)(`UI 预览请求已发送到 ${target.label}`);
-    });
-    server.registerTool("stop_project", {
-        title: "Stop Project",
-        description: "停止当前默认设备上的项目，仅使用 HTTP 设备连接。",
-        inputSchema: {},
-    }, async () => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        await (0, project_1.stopOnDevice)((0, tool_utils_1.createRuntimeHttpRequestOptions)(target));
-        return (0, tool_utils_1.createTextToolResult)(`停止请求已发送到 ${target.label}`);
-    });
-}
+"use strict";var _=exports&&exports.__createBinding||(Object.create?(function(r,t,o,n){n===void 0&&(n=o);var e=Object.getOwnPropertyDescriptor(t,o);(!e||("get"in e?!t.__esModule:e.writable||e.configurable))&&(e={enumerable:!0,get:function(){return t[o]}}),Object.defineProperty(r,n,e)}):(function(r,t,o,n){n===void 0&&(n=o),r[n]=t[o]})),R=exports&&exports.__setModuleDefault||(Object.create?(function(r,t){Object.defineProperty(r,"default",{enumerable:!0,value:t})}):function(r,t){r.default=t}),d=exports&&exports.__importStar||(function(){var r=function(t){return r=Object.getOwnPropertyNames||function(o){var n=[];for(var e in o)Object.prototype.hasOwnProperty.call(o,e)&&(n[n.length]=e);return n},r(t)};return function(t){if(t&&t.__esModule)return t;var o={};if(t!=null)for(var n=r(t),e=0;e<n.length;e++)n[e]!=="default"&&_(o,t,n[e]);return R(o,t),o}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.registerRuntimeTools=$;const T=d(require("fs-extra")),P=d(require("os")),g=d(require("path")),s=d(require("zod/v4")),v=require("../packager"),u=require("../project"),b=require("./device-config"),O=require("./device-log"),S=require("./project"),i=require("./tool-utils");function h(r,t,o){return r&&r.trim()?g.resolve(r.trim()):g.join(P.tmpdir(),`${t}-${Date.now()}-${Math.random().toString(36).slice(2,8)}.${o}`)}function $(r){let t;function o(e){if(e&&e.trim())return t=g.resolve(e.trim()),t;if(t)return t;throw new Error("\u672A\u8BBE\u7F6E\u5DE5\u4F5C\u76EE\u5F55\uFF1A\u8BF7\u5148\u8C03\u7528 set_workspace\uFF0C\u6216\u5728\u672C\u6B21\u5DE5\u5177\u8C03\u7528\u65F6\u4F20 workspacePath\u3002")}async function n(e){const a=o(e);return await(0,S.ensureValidKuaiJSProject)(a),a}r.registerTool("set_workspace",{title:"Set Workspace",description:"\u8BBE\u7F6E\u5F53\u524D MCP \u8FDB\u7A0B\u5185\u7684\u9ED8\u8BA4\u5DE5\u4F5C\u76EE\u5F55\u3002\u540E\u7EED build/run/package \u4F18\u5148\u4F7F\u7528\u8BE5\u76EE\u5F55\u3002",inputSchema:{workspacePath:s.string().min(1).describe("\u5FEB\u70B9JS \u9879\u76EE\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84\uFF08\u9700\u5305\u542B package.json \u4E0E scripts\uFF09")}},async({workspacePath:e})=>{const a=await n(e);return(0,i.createTextToolResult)(`\u9ED8\u8BA4\u5DE5\u4F5C\u76EE\u5F55\u5DF2\u8BBE\u7F6E\u4E3A: ${a}`)}),r.registerTool("get_workspace",{title:"Get Workspace",description:"\u67E5\u770B\u5F53\u524D MCP \u8FDB\u7A0B\u5185\u8BB0\u5FC6\u7684\u5DE5\u4F5C\u76EE\u5F55\u3002",inputSchema:{}},async()=>t?(0,i.createTextToolResult)(`\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55: ${t}`):(0,i.createTextToolResult)("\u5F53\u524D\u672A\u8BBE\u7F6E\u5DE5\u4F5C\u76EE\u5F55\uFF0C\u8BF7\u5148\u8C03\u7528 set_workspace\u3002")),r.registerTool("set_device",{title:"Set Device",description:"\u8BBE\u7F6E\u5F53\u524D\u552F\u4E00\u8BBE\u5907\u8FDE\u63A5\u4FE1\u606F\u3002\u8BBE\u7F6E\u540E\u5176\u4F59\u8BBE\u5907\u5DE5\u5177\u5747\u590D\u7528\u8BE5\u8BBE\u5907\u3002",inputSchema:{ip:s.string().min(1).describe("\u8BBE\u5907 IP \u5730\u5740\uFF0C\u4F8B\u5982 192.168.1.100"),port:s.number().int().min(1).max(65535).optional().describe("\u8BBE\u5907\u7AEF\u53E3\uFF0C\u9ED8\u8BA4 9800")}},async({ip:e,port:a})=>{const c=await(0,b.setDeviceConfig)(e,a);return(0,i.createTextToolResult)(`\u9ED8\u8BA4\u8BBE\u5907\u5DF2\u8BBE\u7F6E\u4E3A ${c.ip}:${c.port}`)}),r.registerTool("get_device",{title:"Get Device",description:"\u67E5\u770B\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u914D\u7F6E\u3002",inputSchema:{}},async()=>{const e=await(0,b.readDeviceConfig)();return e?(0,i.createTextToolResult)(`\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907: ${e.ip}:${e.port}`):(0,i.createTextToolResult)("\u5F53\u524D\u672A\u8BBE\u7F6E\u9ED8\u8BA4\u8BBE\u5907\uFF0C\u8BF7\u5148\u8C03\u7528 set_device\u3002")}),r.registerTool("take_screenshot",{title:"Take Screenshot",description:"\u83B7\u53D6\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u622A\u56FE\u3002\u53EF\u8FD4\u56DE base64\uFF0C\u6216\u843D\u5730\u5230\u6587\u4EF6\u540E\u8FD4\u56DE\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u5199\u5165\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55\uFF09\u3002",inputSchema:{format:s.enum(["file","base64"]).optional().default("file").describe("\u622A\u56FE\u8FD4\u56DE\u683C\u5F0F\uFF1Afile=\u6587\u4EF6\u8DEF\u5F84\uFF0Cbase64=\u56FE\u7247 base64"),outputPath:s.string().min(1).optional().describe("\u5F53 format=file \u65F6\u53EF\u6307\u5B9A\u8F93\u51FA\u8DEF\u5F84\uFF0C\u4E0D\u4F20\u5219\u5199\u5165\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55")}},async({format:e,outputPath:a})=>{const c=await(0,i.resolveRuntimeHttpTarget)(),m=(0,i.createRuntimeHttpRequestOptions)(c);if(e==="base64"){const f=await(0,u.getScreenshotBase64OnDevice)(m);return(0,i.createTextToolResult)(`\u622A\u56FE\u6210\u529F: ${c.label}
+format: base64
+${f}`)}const l=await(0,u.getScreenshotOnDevice)(m),p=h(a,"ms-mcp-screenshot","jpg");return await T.ensureDir(g.dirname(p)),await T.writeFile(p,l),(0,i.createTextToolResult)(`\u622A\u56FE\u6210\u529F: ${c.label}
+format: file
+path: ${p}
+size: ${l.length} bytes`)}),r.registerTool("get_node_source",{title:"Get Node Source",description:"\u83B7\u53D6\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u9875\u9762\u8282\u70B9 XML\uFF0C\u5199\u5165\u6587\u4EF6\u540E\u8FD4\u56DE\u8DEF\u5F84\uFF0C\u907F\u514D\u957F\u6587\u672C\u54CD\u5E94\u88AB\u622A\u65AD\u3002",inputSchema:{maxDepth:s.number().int().min(1).max(200).optional().default(50).describe("\u8282\u70B9\u6811\u6700\u5927\u6DF1\u5EA6\uFF0C\u9ED8\u8BA4 50"),timeout:s.number().int().min(1).max(600).optional().default(120).describe("\u8BBE\u5907\u7AEF\u8282\u70B9\u6293\u53D6\u8D85\u65F6\u79D2\u6570\uFF0C\u9ED8\u8BA4 120"),mode:s.number().int().min(1).max(3).optional().default(1).describe("\u8282\u70B9\u6293\u53D6\u6A21\u5F0F\uFF1A1\u30012\u30013\uFF0C\u9ED8\u8BA4 1"),outputPath:s.string().min(1).optional().describe("\u53EF\u9009\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF0C\u4E0D\u4F20\u5219\u5199\u5165\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55")}},async({maxDepth:e,timeout:a,mode:c,outputPath:m})=>{const l=await(0,i.resolveRuntimeHttpTarget)(),p=(0,i.createRuntimeHttpRequestOptions)(l),f=await(0,u.getSourceOnDevice)(p,e,a,c),w=h(m,"ms-mcp-node-source","xml");return await T.ensureDir(g.dirname(w)),await T.writeFile(w,f,"utf8"),(0,i.createTextToolResult)(`\u8282\u70B9\u83B7\u53D6\u6210\u529F: ${l.label}
+maxDepth: ${e}
+timeout: ${a}
+mode: ${c}
+path: ${w}
+size: ${Buffer.byteLength(f,"utf8")} bytes`)}),r.registerTool("get_logs",{title:"Get Device Logs",description:"\u83B7\u53D6\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u7684\u6700\u65B0\u65E5\u5FD7\u884C\u3002",inputSchema:{limit:s.number().int().min(1).max(5e3).optional().default(200).describe("\u8FD4\u56DE\u6700\u8FD1\u65E5\u5FD7\u6761\u6570\uFF0C\u9ED8\u8BA4 200\uFF0C\u6700\u5927 5000")}},async({limit:e})=>{const a=await(0,i.resolveRuntimeHttpTarget)();return(0,i.createTextToolResult)(await(0,O.buildDeviceLogSnapshotText)(a,e))}),r.registerTool("package_project",{title:"Package Project",description:"\u6267\u884C\u751F\u4EA7\u6784\u5EFA\u5E76\u52A0\u5BC6\uFF0C\u8FD4\u56DE enc.msbundle \u8DEF\u5F84\u3002",inputSchema:{workspacePath:s.string().min(1).optional().describe("\u53EF\u9009\u5DE5\u4F5C\u76EE\u5F55\uFF1B\u4E0D\u4F20\u65F6\u4F7F\u7528 set_workspace \u8BB0\u5FC6\u503C")}},async({workspacePath:e})=>{const a=await n(e),c=await(0,v.packageProject)(a);return(0,i.createTextToolResult)(`\u6253\u5305\u5B8C\u6210: ${c}`)}),r.registerTool("run_project",{title:"Run Project",description:"\u6784\u5EFA\u5E76\u540C\u6B65\u5230\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u540E\u8FD0\u884C\u9879\u76EE\uFF0C\u4EC5\u4F7F\u7528 HTTP \u8BBE\u5907\u8FDE\u63A5\u3002",inputSchema:{workspacePath:s.string().min(1).optional().describe("\u53EF\u9009\u5DE5\u4F5C\u76EE\u5F55\uFF1B\u4E0D\u4F20\u65F6\u4F7F\u7528 set_workspace \u8BB0\u5FC6\u503C")}},async({workspacePath:e})=>{const a=await n(e),c=await(0,i.resolveRuntimeHttpTarget)();return await(0,u.runOnDevice)({...(0,i.createRuntimeHttpRequestOptions)(c),workspacePath:a}),(0,i.createTextToolResult)(`\u8FD0\u884C\u8BF7\u6C42\u5DF2\u53D1\u9001\u5230 ${c.label}`)}),r.registerTool("run_ui_project",{title:"Run UI Project",description:"\u6784\u5EFA\u5E76\u540C\u6B65\u5230\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u540E\u9884\u89C8 UI\uFF0C\u4EC5\u4F7F\u7528 HTTP \u8BBE\u5907\u8FDE\u63A5\u3002",inputSchema:{workspacePath:s.string().min(1).optional().describe("\u53EF\u9009\u5DE5\u4F5C\u76EE\u5F55\uFF1B\u4E0D\u4F20\u65F6\u4F7F\u7528 set_workspace \u8BB0\u5FC6\u503C")}},async({workspacePath:e})=>{const a=await n(e),c=await(0,i.resolveRuntimeHttpTarget)();return await(0,u.runUIOnDevice)({...(0,i.createRuntimeHttpRequestOptions)(c),workspacePath:a}),(0,i.createTextToolResult)(`UI \u9884\u89C8\u8BF7\u6C42\u5DF2\u53D1\u9001\u5230 ${c.label}`)}),r.registerTool("stop_project",{title:"Stop Project",description:"\u505C\u6B62\u5F53\u524D\u9ED8\u8BA4\u8BBE\u5907\u4E0A\u7684\u9879\u76EE\uFF0C\u4EC5\u4F7F\u7528 HTTP \u8BBE\u5907\u8FDE\u63A5\u3002",inputSchema:{}},async()=>{const e=await(0,i.resolveRuntimeHttpTarget)();return await(0,u.stopOnDevice)((0,i.createRuntimeHttpRequestOptions)(e)),(0,i.createTextToolResult)(`\u505C\u6B62\u8BF7\u6C42\u5DF2\u53D1\u9001\u5230 ${e.label}`)})}

package/dist/mcp/tool-utils.d.ts

@@ -1,62 +1,22 @@
-/**
- * MCP 文本响应内容结构
- */
 export type TextContent = {
     type: "text";
     text: string;
 };
-/**
- * 通用文本工具返回值结构
- */
 export type TextToolResult = {
     content: TextContent[];
     isError?: boolean;
 };
-/**
- * HTTP 设备目标信息
- */
 export type RuntimeHttpTarget = {
     ip: string;
     port: string;
     label: string;
 };
-/**
- * 查询参数允许的基础值类型
- */
 export type RuntimeQueryValue = string | number | boolean | null | undefined;
-/**
- * 创建标准 MCP 文本工具返回值
- * @param text 返回文本
- * @param isError 是否标记为错误响应
- * @returns 返回包含单条文本内容的 MCP Tool 结果
- * @example
- * createTextToolResult("done")
- */
 export declare function createTextToolResult(text: string, isError?: boolean): TextToolResult;
-/**
- * 构建运行时 HTTP 请求参数
- * @param target 已解析的设备目标
- * @returns 返回项目内部设备请求参数
- * @example
- * const options = createRuntimeHttpRequestOptions(target)
- */
 export declare function createRuntimeHttpRequestOptions(target: RuntimeHttpTarget): {
     ip: string;
     port: string;
     transport: "http";
 };
-/**
- * 解析当前默认 HTTP 设备
- * @returns 返回标准化后的 HTTP 请求目标
- * @example
- * const target = await resolveRuntimeHttpTarget()
- */
 export declare function resolveRuntimeHttpTarget(): Promise<RuntimeHttpTarget>;
-/**
- * 将任意 JSON 兼容值格式化为文本
- * @param value 任意待展示值
- * @returns 返回便于 MCP 文本输出的内容
- * @example
- * formatRuntimeJsonText({ success: true })
- */
 export declare function formatRuntimeJsonText(value: unknown): string;

package/dist/mcp/tool-utils.js

@@ -1,81 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTextToolResult = createTextToolResult;
-exports.createRuntimeHttpRequestOptions = createRuntimeHttpRequestOptions;
-exports.resolveRuntimeHttpTarget = resolveRuntimeHttpTarget;
-exports.formatRuntimeJsonText = formatRuntimeJsonText;
-const device_config_1 = require("./device-config");
-/**
- * 创建标准 MCP 文本内容对象
- * @param text 返回文本
- * @returns 返回 `{ type: "text", text }` 结构
- * @example
- * createTextContent("ok")
- */
-function createTextContent(text) {
-    return {
-        type: "text",
-        text,
-    };
-}
-/**
- * 创建标准 MCP 文本工具返回值
- * @param text 返回文本
- * @param isError 是否标记为错误响应
- * @returns 返回包含单条文本内容的 MCP Tool 结果
- * @example
- * createTextToolResult("done")
- */
-function createTextToolResult(text, isError = false) {
-    return {
-        content: [createTextContent(text)],
-        ...(isError ? { isError: true } : {}),
-    };
-}
-/**
- * 构建运行时 HTTP 请求参数
- * @param target 已解析的设备目标
- * @returns 返回项目内部设备请求参数
- * @example
- * const options = createRuntimeHttpRequestOptions(target)
- */
-function createRuntimeHttpRequestOptions(target) {
-    return {
-        ip: target.ip,
-        port: target.port,
-        transport: "http",
-    };
-}
-/**
- * 解析当前默认 HTTP 设备
- * @returns 返回标准化后的 HTTP 请求目标
- * @example
- * const target = await resolveRuntimeHttpTarget()
- */
-async function resolveRuntimeHttpTarget() {
-    let device;
-    try {
-        device = await (0, device_config_1.resolveDeviceConfig)();
-    }
-    catch {
-        throw new Error("未设置设备：请先调用 set_device。");
-    }
-    return {
-        ip: device.ip,
-        port: (0, device_config_1.normalizePort)(device.port),
-        label: `${device.ip}:${device.port}`,
-    };
-}
-/**
- * 将任意 JSON 兼容值格式化为文本
- * @param value 任意待展示值
- * @returns 返回便于 MCP 文本输出的内容
- * @example
- * formatRuntimeJsonText({ success: true })
- */
-function formatRuntimeJsonText(value) {
-    if (typeof value === "string") {
-        return value;
-    }
-    return JSON.stringify(value, null, 2);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.createTextToolResult=o,exports.createRuntimeHttpRequestOptions=i,exports.resolveRuntimeHttpTarget=u,exports.formatRuntimeJsonText=c;const e=require("./device-config");function n(t){return{type:"text",text:t}}function o(t,r=!1){return{content:[n(t)],...r?{isError:!0}:{}}}function i(t){return{ip:t.ip,port:t.port,transport:"http"}}async function u(){let t;try{t=await(0,e.resolveDeviceConfig)()}catch{throw new Error("\u672A\u8BBE\u7F6E\u8BBE\u5907\uFF1A\u8BF7\u5148\u8C03\u7528 set_device\u3002")}return{ip:t.ip,port:(0,e.normalizePort)(t.port),label:`${t.ip}:${t.port}`}}function c(t){return typeof t=="string"?t:JSON.stringify(t,null,2)}

package/dist/mcp/tools.d.ts

@@ -1,18 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { DEFAULT_DEVICE_PORT } from "./device-config";
 import type { ApiDocsLanguage } from "./types";
-/**
- * 创建并注册 MCP 工具
- * @returns 返回已注册工具的 MCP Server 实例
- * @example
- * const server = createMcpServer()
- */
 export declare function createMcpServer(): McpServer;
-/**
- * 文档语言联合类型导出，便于其他模块复用
- */
 export type { ApiDocsLanguage };
-/**
- * 默认设备端口导出，便于外部引用
- */
 export { DEFAULT_DEVICE_PORT };

package/dist/mcp/tools.js

@@ -1,31 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_DEVICE_PORT = void 0;
-exports.createMcpServer = createMcpServer;
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const version_1 = require("../version");
-const device_config_1 = require("./device-config");
-Object.defineProperty(exports, "DEFAULT_DEVICE_PORT", { enumerable: true, get: function () { return device_config_1.DEFAULT_DEVICE_PORT; } });
-const doc_tools_1 = require("./doc-tools");
-const httpapi_tools_1 = require("./httpapi-tools");
-const image_tools_1 = require("./image-tools");
-const ocr_tools_1 = require("./ocr-tools");
-const runtime_tools_1 = require("./runtime-tools");
-/**
- * 创建并注册 MCP 工具
- * @returns 返回已注册工具的 MCP Server 实例
- * @example
- * const server = createMcpServer()
- */
-function createMcpServer() {
-    const server = new mcp_js_1.McpServer({
-        name: "ms-vite-plugin-mcp",
-        version: version_1.PACKAGE_VERSION,
-    });
-    (0, doc_tools_1.registerDocTools)(server);
-    (0, httpapi_tools_1.registerHttpApiTools)(server);
-    (0, image_tools_1.registerImageTools)(server);
-    (0, ocr_tools_1.registerOcrTools)(server);
-    (0, runtime_tools_1.registerRuntimeTools)(server);
-    return server;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.DEFAULT_DEVICE_PORT=void 0,exports.createMcpServer=u;const r=require("@modelcontextprotocol/sdk/server/mcp.js"),o=require("../version"),t=require("./device-config");Object.defineProperty(exports,"DEFAULT_DEVICE_PORT",{enumerable:!0,get:function(){return t.DEFAULT_DEVICE_PORT}});const s=require("./doc-tools"),i=require("./httpapi-tools"),c=require("./image-tools"),n=require("./ocr-tools"),_=require("./runtime-tools");function u(){const e=new r.McpServer({name:"ms-vite-plugin-mcp",version:o.PACKAGE_VERSION});return(0,s.registerDocTools)(e),(0,i.registerHttpApiTools)(e),(0,c.registerImageTools)(e),(0,n.registerOcrTools)(e),(0,_.registerRuntimeTools)(e),e}

package/dist/mcp/types.d.ts

@@ -1,19 +1,7 @@
-/**
- * 设备连接配置结构
- */
 export type DeviceConfig = {
-    /** 设备 IP 地址 */
     ip: string;
-    /** 设备端口 */
     port: number;
-    /** 最近更新时间戳（毫秒） */
     updatedAt: number;
 };
-/**
- * 文档语言类型
- */
 export type ApiDocsLanguage = "js" | "js_zh" | "python";
-/**
- * 文档语言显示名映射
- */
 export declare const DOC_LANGUAGE_LABELS: Record<ApiDocsLanguage, string>;

package/dist/mcp/types.js

@@ -1,11 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DOC_LANGUAGE_LABELS = void 0;
-/**
- * 文档语言显示名映射
- */
-exports.DOC_LANGUAGE_LABELS = {
-    js: "JavaScript",
-    js_zh: "JavaScript (中文)",
-    python: "Python",
-};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.DOC_LANGUAGE_LABELS=void 0,exports.DOC_LANGUAGE_LABELS={js:"JavaScript",js_zh:"JavaScript (\u4E2D\u6587)",python:"Python"};

package/dist/mcp-server.js

@@ -1,86 +1,2 @@
 #!/usr/bin/env node
-"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 });
-const fsExtra = __importStar(require("fs-extra"));
-const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const tools_1 = require("./mcp/tools");
-const device_config_1 = require("./mcp/device-config");
-/**
- * 启动 MCP 服务（stdio）
- * @returns 启动成功后常驻运行
- * @example
- * await main()
- */
-async function main() {
-    const server = (0, tools_1.createMcpServer)();
-    const transport = new stdio_js_1.StdioServerTransport();
-    /**
-     * 进程退出时清理当前实例的临时配置文件，避免系统临时目录残留
-     * 注意：只清理“当前进程文件”，不会影响其他并发窗口实例
-     */
-    const cleanupConfigFile = async () => {
-        try {
-            await fsExtra.remove(device_config_1.DEVICE_CONFIG_FILE);
-        }
-        catch {
-            // 忽略清理错误，避免影响主流程退出
-        }
-    };
-    process.once("SIGINT", () => {
-        cleanupConfigFile()
-            .catch(() => undefined)
-            .finally(() => process.exit(0));
-    });
-    process.once("SIGTERM", () => {
-        cleanupConfigFile()
-            .catch(() => undefined)
-            .finally(() => process.exit(0));
-    });
-    process.once("exit", () => {
-        try {
-            fsExtra.removeSync(device_config_1.DEVICE_CONFIG_FILE);
-        }
-        catch {
-            // ignore
-        }
-    });
-    await server.connect(transport);
-}
-main().catch((error) => {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(`MCP 服务启动失败: ${message}`);
-    process.exit(1);
-});
+"use strict";var o=exports&&exports.__createBinding||(Object.create?(function(t,e,n,r){r===void 0&&(r=n);var c=Object.getOwnPropertyDescriptor(e,n);(!c||("get"in c?!e.__esModule:c.writable||c.configurable))&&(c={enumerable:!0,get:function(){return e[n]}}),Object.defineProperty(t,r,c)}):(function(t,e,n,r){r===void 0&&(r=n),t[r]=e[n]})),s=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),u=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(n){var r=[];for(var c in n)Object.prototype.hasOwnProperty.call(n,c)&&(r[r.length]=c);return r},t(e)};return function(e){if(e&&e.__esModule)return e;var n={};if(e!=null)for(var r=t(e),c=0;c<r.length;c++)r[c]!=="default"&&o(n,e,r[c]);return s(n,e),n}})();Object.defineProperty(exports,"__esModule",{value:!0});const i=u(require("fs-extra")),f=require("@modelcontextprotocol/sdk/server/stdio.js"),l=require("./mcp/tools"),a=require("./mcp/device-config");async function _(){const t=(0,l.createMcpServer)(),e=new f.StdioServerTransport,n=async()=>{try{await i.remove(a.DEVICE_CONFIG_FILE)}catch{}};process.once("SIGINT",()=>{n().catch(()=>{}).finally(()=>process.exit(0))}),process.once("SIGTERM",()=>{n().catch(()=>{}).finally(()=>process.exit(0))}),process.once("exit",()=>{try{i.removeSync(a.DEVICE_CONFIG_FILE)}catch{}}),await t.connect(e)}_().catch(t=>{const e=t instanceof Error?t.message:String(t);console.error(`MCP \u670D\u52A1\u542F\u52A8\u5931\u8D25: ${e}`),process.exit(1)});

package/dist/packager.d.ts

@@ -1,8 +1 @@
-/**
- * 执行 package 流程（生产构建 + bundle 加密）
- * @param workspacePath 当前工作目录（项目根目录）
- * @returns 返回加密产物 enc.msbundle 的绝对路径
- * @example
- * const output = await packageProject(process.cwd())
- */
 export declare function packageProject(workspacePath: string): Promise<string>;