ms-vite-plugin 1.1.16 → 1.1.18

package/dist/mcp/mirror-tools.js

@@ -0,0 +1,82 @@
+"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.registerMirrorTools = registerMirrorTools;
+const z = __importStar(require("zod/v4"));
+const tool_utils_1 = require("./tool-utils");
+/**
+ * 注册镜像流相关 MCP 工具
+ * @param server MCP 服务实例
+ * @returns 无返回值
+ * @example
+ * registerMirrorTools(server)
+ */
+function registerMirrorTools(server) {
+    server.registerTool("get_mirror_mjpeg_url", {
+        title: "Get Mirror MJPEG URL",
+        description: "生成设备镜像 MJPEG 流地址。MCP 普通文本/图片响应不适合持续显示 MJPEG，建议将返回 URL 交给浏览器或支持 MJPEG 的查看器打开。",
+        inputSchema: {
+            fps: z.number().int().min(1).max(60).optional().default(10).describe("帧率，默认 10"),
+            quality: z
+                .number()
+                .min(0.1)
+                .max(1)
+                .optional()
+                .default(0.25)
+                .describe("压缩质量，默认 0.25"),
+            scalingFactor: z
+                .number()
+                .min(0.1)
+                .max(1)
+                .optional()
+                .default(1)
+                .describe("缩放因子，默认 1.0"),
+        },
+    }, async ({ fps, quality, scalingFactor }) => {
+        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+        const url = new URL(`http://${target.ip}:${target.port}/mirror/image`);
+        url.searchParams.set("fps", String(fps));
+        url.searchParams.set("quality", String(quality));
+        url.searchParams.set("scalingFactor", String(scalingFactor));
+        return (0, tool_utils_1.createTextToolResult)([
+            `MJPEG 地址: ${url.toString()}`,
+            `设备: ${target.label}`,
+            `fps: ${fps}`,
+            `quality: ${quality}`,
+            `scalingFactor: ${scalingFactor}`,
+            "说明: MCP 工具本身不适合持续渲染 MJPEG 流，建议把这个地址交给浏览器或支持 MJPEG 的播放器打开。",
+        ].join("\n"));
+    });
+}

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

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 注册设备与项目执行工具
+ * @param server MCP 服务实例
+ * @returns 无返回值
+ * @example
+ * registerRuntimeTools(server)
+ */
+export declare function registerRuntimeTools(server: McpServer): void;

package/dist/mcp/runtime-tools.js

@@ -0,0 +1,391 @@
+"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 z = __importStar(require("zod/v4"));
+const fsExtra = __importStar(require("fs-extra"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const packager_1 = require("../packager");
+const project_1 = require("../project");
+const project_2 = require("./project");
+const device_config_1 = require("./device-config");
+const device_log_1 = require("./device-log");
+const tool_utils_1 = require("./tool-utils");
+const control_tools_1 = require("./control-tools");
+const hid_tools_1 = require("./hid-tools");
+const ime_tools_1 = require("./ime-tools");
+const mirror_tools_1 = require("./mirror-tools");
+/**
+ * 注册设备与项目执行工具
+ * @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);
+        const reusedSubscription = (0, device_log_1.ensureDeviceLogSubscription)(config.ip, config.port);
+        return (0, tool_utils_1.createTextToolResult)([
+            `默认设备已设置为 ${config.ip}:${config.port}`,
+            reusedSubscription
+                ? "SSE 日志后台订阅已复用现有连接"
+                : `SSE 日志后台订阅已启动，内存缓存上限 ${device_log_1.DEVICE_LOG_MEMORY_LIMIT} 条`,
+        ].join("\n"));
+    });
+    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("get_active_app_info", {
+        title: "Get Active App Info",
+        description: "获取当前激活应用信息。",
+        inputSchema: {},
+    }, async () => {
+        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "activeAppInfo");
+        return (0, tool_utils_1.createTextToolResult)(`当前激活应用信息:\n${(0, tool_utils_1.formatRuntimeJsonText)((0, tool_utils_1.unwrapRuntimeData)(payload, "activeAppInfo"))}`);
+    });
+    server.registerTool("take_me_to_front", {
+        title: "Take Me To Front",
+        description: "将当前应用切到前台。",
+        inputSchema: {},
+    }, async () => {
+        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "takeMeToFront");
+        return (0, tool_utils_1.createTextToolResult)(payload.success === true
+            ? `切到前台成功: ${target.label}`
+            : `切到前台失败: ${target.label}`, payload.success !== true);
+    });
+    server.registerTool("get_all_config", {
+        title: "Get All Config",
+        description: "获取当前设备全部配置参数。",
+        inputSchema: {},
+    }, async () => {
+        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "getAllConfig");
+        return (0, tool_utils_1.createTextToolResult)(`当前配置:\n${(0, tool_utils_1.formatRuntimeJsonText)((0, tool_utils_1.unwrapRuntimeData)(payload, "getAllConfig"))}`);
+    });
+    server.registerTool("set_all_config", {
+        title: "Set All Config",
+        description: "批量设置当前设备全部配置参数。",
+        inputSchema: {
+            config: z
+                .record(z.string(), z.unknown())
+                .describe("完整配置对象，会直接提交到 setAllConfig"),
+        },
+    }, async ({ config }) => {
+        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "setAllConfig", "POST", config);
+        return (0, tool_utils_1.createTextToolResult)(payload.success === true
+            ? `批量设置配置成功: ${target.label}`
+            : `批量设置配置失败: ${target.label}`, payload.success !== true);
+    });
+    server.registerTool("set_config", {
+        title: "Set Config",
+        description: "设置单个配置参数。",
+        inputSchema: {
+            key: z.string().min(1).describe("配置键名"),
+            value: z.unknown().describe("配置值，支持任意 JSON 兼容类型"),
+        },
+    }, async ({ key, value }) => {
+        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "setConfig", "POST", {
+            key,
+            value,
+        });
+        return (0, tool_utils_1.createTextToolResult)(payload.success === true
+            ? `配置设置成功: ${key}`
+            : `配置设置失败: ${key}`, payload.success !== true);
+    });
+    server.registerTool("run_script", {
+        title: "Run Script",
+        description: "在当前设备上执行一段 JavaScript 并返回结果。",
+        inputSchema: {
+            script: z.string().min(1).describe("要执行的 JavaScript 代码"),
+        },
+    }, async ({ script }) => {
+        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "runScript", "POST", {
+            script,
+        });
+        const success = payload.success === true;
+        return (0, tool_utils_1.createTextToolResult)(success
+            ? `脚本执行成功:\n${(0, tool_utils_1.formatRuntimeJsonText)(payload)}`
+            : `脚本执行失败:\n${(0, tool_utils_1.formatRuntimeJsonText)(payload)}`, !success);
+    });
+    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 = outputPath && outputPath.trim()
+            ? path.resolve(outputPath.trim())
+            : path.join(os.tmpdir(), `ms-mcp-screenshot-${Date.now()}-${Math.random()
+                .toString(36)
+                .slice(2, 8)}.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（/api/source），写入文件后返回路径，避免长文本响应被截断。",
+        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"),
+            outputPath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选输出文件路径，不传则写入系统临时目录"),
+        },
+    }, async ({ maxDepth, timeout, 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);
+        const targetPath = outputPath && outputPath.trim()
+            ? path.resolve(outputPath.trim())
+            : path.join(os.tmpdir(), `ms-mcp-node-source-${Date.now()}-${Math.random()
+                .toString(36)
+                .slice(2, 8)}.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}\npath: ${targetPath}\nsize: ${Buffer.byteLength(source, "utf8")} bytes`);
+    });
+    server.registerTool("get_logs", {
+        title: "Get Device Logs",
+        description: "获取当前默认设备的日志缓存快照。调用 set_device 后会自动建立 SSE 后台订阅，此工具只返回当前已缓存的日志内容。",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(5000)
+                .optional()
+                .default(200)
+                .describe("返回最近日志条数，默认 200，最大 5000"),
+            runtimeStatusLimit: z
+                .number()
+                .int()
+                .min(0)
+                .max(200)
+                .optional()
+                .default(20)
+                .describe("返回最近 runtime_status 条数，默认 20"),
+        },
+    }, async ({ limit, runtimeStatusLimit }) => {
+        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+        (0, device_log_1.ensureDeviceLogSubscription)(target.ip, Number.parseInt(target.port, 10));
+        return (0, tool_utils_1.createTextToolResult)((0, device_log_1.buildDeviceLogSnapshotText)(limit, runtimeStatusLimit));
+    });
+    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}`);
+    });
+    (0, control_tools_1.registerControlTools)(server);
+    (0, hid_tools_1.registerHidTools)(server);
+    (0, ime_tools_1.registerImeTools)(server);
+    (0, mirror_tools_1.registerMirrorTools)(server);
+}

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

@@ -0,0 +1,104 @@
+import type { ApiDocsLanguage } from "./types";
+/**
+ * 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 API
+ * @param target 当前默认设备目标
+ * @param endpoint API 路径（不含前导 `/api/`）
+ * @param method 请求方法
+ * @param body 可选 JSON 请求体
+ * @returns 返回解析后的 JSON 数据
+ * @example
+ * const payload = await requestRuntimeJsonApi(target, "activeAppInfo")
+ */
+export declare function requestRuntimeJsonApi(target: RuntimeHttpTarget, endpoint: string, method?: "GET" | "POST", body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+/**
+ * 请求任意相对路径 JSON API，并可附带 query 参数
+ * @param target 当前默认设备目标
+ * @param routePath 相对路径，例如 `/api/control/click`
+ * @param query 可选查询参数
+ * @returns 返回解析后的 JSON 数据
+ * @example
+ * const payload = await requestRuntimePathJson(target, "/api/ime/getText")
+ */
+export declare function requestRuntimePathJson(target: RuntimeHttpTarget, routePath: string, query?: Record<string, RuntimeQueryValue>): Promise<Record<string, unknown>>;
+/**
+ * 从通用 JSON 响应中读取 `data` 字段
+ * @param payload API 返回 JSON
+ * @param endpoint API 路径名，用于错误提示
+ * @returns 返回 `data` 字段内容
+ * @example
+ * const data = unwrapRuntimeData(payload, "getAllConfig")
+ */
+export declare function unwrapRuntimeData(payload: Record<string, unknown>, endpoint: string): unknown;
+/**
+ * 将任意 JSON 兼容值格式化为文本
+ * @param value 任意待展示值
+ * @returns 返回便于 MCP 文本输出的内容
+ * @example
+ * formatRuntimeJsonText({ success: true })
+ */
+export declare function formatRuntimeJsonText(value: unknown): string;
+/**
+ * 格式化单条 API 文档摘要
+ * @param language 文档语言
+ * @param title 文档标题
+ * @param slug 文档 slug
+ * @param index 列表序号
+ * @returns 返回用于列表展示的文本块
+ * @example
+ * formatApiDocSummary("js", "Tap", "tap", 0)
+ */
+export declare function formatApiDocSummary(language: ApiDocsLanguage, title: string, slug: string, index: number): string;