ms-vite-plugin 1.1.16 → 1.1.17

package/dist/mcp/tool-utils.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTextToolResult = createTextToolResult;
+exports.createRuntimeHttpRequestOptions = createRuntimeHttpRequestOptions;
+exports.resolveRuntimeHttpTarget = resolveRuntimeHttpTarget;
+exports.requestRuntimeJsonApi = requestRuntimeJsonApi;
+exports.requestRuntimePathJson = requestRuntimePathJson;
+exports.unwrapRuntimeData = unwrapRuntimeData;
+exports.formatRuntimeJsonText = formatRuntimeJsonText;
+exports.formatApiDocSummary = formatApiDocSummary;
+const docs_service_1 = require("./docs-service");
+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 API
+ * @param target 当前默认设备目标
+ * @param endpoint API 路径（不含前导 `/api/`）
+ * @param method 请求方法
+ * @param body 可选 JSON 请求体
+ * @returns 返回解析后的 JSON 数据
+ * @example
+ * const payload = await requestRuntimeJsonApi(target, "activeAppInfo")
+ */
+async function requestRuntimeJsonApi(target, endpoint, method = "GET", body) {
+    const url = `http://${target.ip}:${target.port}/api/${endpoint}`;
+    const response = await fetch(url, {
+        method,
+        headers: body ? { "Content-Type": "application/json" } : undefined,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!response.ok) {
+        throw new Error(`${endpoint} 请求失败，状态码: ${response.status}`);
+    }
+    const payload = (await response.json());
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        throw new Error(`${endpoint} 返回了无效响应`);
+    }
+    return payload;
+}
+/**
+ * 请求任意相对路径 JSON API，并可附带 query 参数
+ * @param target 当前默认设备目标
+ * @param routePath 相对路径，例如 `/api/control/click`
+ * @param query 可选查询参数
+ * @returns 返回解析后的 JSON 数据
+ * @example
+ * const payload = await requestRuntimePathJson(target, "/api/ime/getText")
+ */
+async function requestRuntimePathJson(target, routePath, query) {
+    const url = new URL(`http://${target.ip}:${target.port}${routePath}`);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            url.searchParams.set(key, String(value));
+        }
+    }
+    const response = await fetch(url.toString(), {
+        method: "GET",
+    });
+    if (!response.ok) {
+        throw new Error(`${routePath} 请求失败，状态码: ${response.status}`);
+    }
+    const payload = (await response.json());
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        throw new Error(`${routePath} 返回了无效响应`);
+    }
+    return payload;
+}
+/**
+ * 从通用 JSON 响应中读取 `data` 字段
+ * @param payload API 返回 JSON
+ * @param endpoint API 路径名，用于错误提示
+ * @returns 返回 `data` 字段内容
+ * @example
+ * const data = unwrapRuntimeData(payload, "getAllConfig")
+ */
+function unwrapRuntimeData(payload, endpoint) {
+    if (payload.success !== true) {
+        throw new Error(String(payload.message ?? `${endpoint} 返回失败`));
+    }
+    return payload.data;
+}
+/**
+ * 将任意 JSON 兼容值格式化为文本
+ * @param value 任意待展示值
+ * @returns 返回便于 MCP 文本输出的内容
+ * @example
+ * formatRuntimeJsonText({ success: true })
+ */
+function formatRuntimeJsonText(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    return JSON.stringify(value, null, 2);
+}
+/**
+ * 格式化单条 API 文档摘要
+ * @param language 文档语言
+ * @param title 文档标题
+ * @param slug 文档 slug
+ * @param index 列表序号
+ * @returns 返回用于列表展示的文本块
+ * @example
+ * formatApiDocSummary("js", "Tap", "tap", 0)
+ */
+function formatApiDocSummary(language, title, slug, index) {
+    return `${index + 1}. ${title}\nslug: ${slug}\nuri: ${(0, docs_service_1.getDocUri)(language, slug)}`;
+}

package/dist/mcp/tools.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { DEFAULT_DEVICE_PORT } from "./device-config";
-import { type ApiDocsLanguage } from "./types";
+import type { ApiDocsLanguage } from "./types";
 /**
  * 创建并注册 MCP 工具
  * @returns 返回已注册工具的 MCP Server 实例