ms-vite-plugin 1.1.15 → 1.1.17

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

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 注册 Control API 对应 MCP 工具
+ * @param server MCP 服务实例
+ * @returns 无返回值
+ * @example
+ * registerControlTools(server)
+ */
+export declare function registerControlTools(server: McpServer): void;

package/dist/mcp/control-tools.js

@@ -0,0 +1,201 @@
+"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.registerControlTools = registerControlTools;
+const z = __importStar(require("zod/v4"));
+const tool_utils_1 = require("./tool-utils");
+/**
+ * 请求控制路由
+ * @param endpoint 控制 API 名称
+ * @param query 可选查询参数
+ * @returns 返回设备端 JSON 响应
+ * @example
+ * const payload = await requestControlApi("home")
+ */
+async function requestControlApi(endpoint, query) {
+    const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
+    return (0, tool_utils_1.requestRuntimePathJson)(target, `/api/control/${endpoint}`, query);
+}
+/**
+ * 将控制类 API 响应格式化为 MCP 文本
+ * @param actionName 操作名称
+ * @param payload 设备端响应
+ * @returns 返回标准文本工具响应
+ * @example
+ * formatControlResult("返回桌面", { success: true })
+ */
+function formatControlResult(actionName, payload) {
+    const success = payload.success === true;
+    if ("data" in payload) {
+        return (0, tool_utils_1.createTextToolResult)(`${actionName}${success ? "成功" : "失败"}:\n${(0, tool_utils_1.formatRuntimeJsonText)(payload.data)}`, !success);
+    }
+    return (0, tool_utils_1.createTextToolResult)(`${actionName}${success ? "成功" : "失败"}`, !success);
+}
+/**
+ * 注册 Control API 对应 MCP 工具
+ * @param server MCP 服务实例
+ * @returns 无返回值
+ * @example
+ * registerControlTools(server)
+ */
+function registerControlTools(server) {
+    server.registerTool("control_home", {
+        title: "Control Home",
+        description: "返回桌面。",
+        inputSchema: {},
+    }, async () => formatControlResult("返回桌面", await requestControlApi("home")));
+    server.registerTool("control_click", {
+        title: "Control Click",
+        description: "点击指定坐标。",
+        inputSchema: {
+            x: z.number().int().min(0).describe("点击坐标 x"),
+            y: z.number().int().min(0).describe("点击坐标 y"),
+            duration: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("按压时长，默认 20"),
+            jitter: z.boolean().optional().describe("是否启用抖动，默认 false"),
+        },
+    }, async ({ x, y, duration, jitter }) => formatControlResult("点击", await requestControlApi("click", { x, y, duration, jitter })));
+    server.registerTool("control_double_click", {
+        title: "Control Double Click",
+        description: "双击指定坐标。",
+        inputSchema: {
+            x: z.number().int().min(0).describe("双击坐标 x"),
+            y: z.number().int().min(0).describe("双击坐标 y"),
+            duration: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("单次按压时长，默认 20"),
+            interval: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("两次点击间隔，默认 20"),
+            jitter: z.boolean().optional().describe("是否启用抖动，默认 false"),
+        },
+    }, async ({ x, y, duration, interval, jitter }) => formatControlResult("双击", await requestControlApi("doubleClick", {
+        x,
+        y,
+        duration,
+        interval,
+        jitter,
+    })));
+    server.registerTool("control_swipe", {
+        title: "Control Swipe",
+        description: "从起点滑动到终点。",
+        inputSchema: {
+            startX: z.number().int().min(0).describe("起点 x"),
+            startY: z.number().int().min(0).describe("起点 y"),
+            endX: z.number().int().min(0).describe("终点 x"),
+            endY: z.number().int().min(0).describe("终点 y"),
+            duration: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("滑动时长，默认 100"),
+            jitter: z.boolean().optional().describe("是否启用抖动，默认 false"),
+            steps: z.number().int().min(1).optional().describe("分段步数，默认 6"),
+        },
+    }, async ({ startX, startY, endX, endY, duration, jitter, steps }) => formatControlResult("滑动", await requestControlApi("swipe", {
+        startX,
+        startY,
+        endX,
+        endY,
+        duration,
+        jitter,
+        steps,
+    })));
+    server.registerTool("control_press_button", {
+        title: "Control Press Button",
+        description: "按下指定系统按键。",
+        inputSchema: {
+            button: z.string().min(1).describe("按钮名称"),
+        },
+    }, async ({ button }) => formatControlResult("按键", await requestControlApi("pressButton", { button })));
+    server.registerTool("control_input", {
+        title: "Control Input",
+        description: "输入文本。",
+        inputSchema: {
+            text: z.string().min(1).describe("待输入文本"),
+        },
+    }, async ({ text }) => formatControlResult("输入", await requestControlApi("input", { text })));
+    server.registerTool("control_backspace", {
+        title: "Control Backspace",
+        description: "执行退格操作。",
+        inputSchema: {
+            count: z.number().int().min(1).optional().describe("退格次数，默认 1"),
+        },
+    }, async ({ count }) => formatControlResult("退格", await requestControlApi("backspace", { count })));
+    server.registerTool("control_enter", {
+        title: "Control Enter",
+        description: "执行回车操作。",
+        inputSchema: {},
+    }, async () => formatControlResult("回车", await requestControlApi("enter")));
+    server.registerTool("control_start_app", {
+        title: "Control Start App",
+        description: "启动指定应用。",
+        inputSchema: {
+            bundleId: z.string().min(1).describe("应用 bundleId"),
+        },
+    }, async ({ bundleId }) => formatControlResult("启动应用", await requestControlApi("startApp", { bundleId })));
+    server.registerTool("control_activate_app", {
+        title: "Control Activate App",
+        description: "激活指定应用。",
+        inputSchema: {
+            bundleId: z.string().min(1).describe("应用 bundleId"),
+        },
+    }, async ({ bundleId }) => formatControlResult("激活应用", await requestControlApi("activateApp", { bundleId })));
+    server.registerTool("control_stop_app", {
+        title: "Control Stop App",
+        description: "停止指定应用。",
+        inputSchema: {
+            bundleId: z.string().min(1).describe("应用 bundleId"),
+        },
+    }, async ({ bundleId }) => formatControlResult("停止应用", await requestControlApi("stopApp", { bundleId })));
+    server.registerTool("control_open_url", {
+        title: "Control Open URL",
+        description: "打开指定 URL。",
+        inputSchema: {
+            url: z.string().min(1).describe("目标 URL"),
+        },
+    }, async ({ url }) => formatControlResult("打开 URL", await requestControlApi("openURL", { url })));
+}

package/dist/mcp/device-log.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 设备日志内存缓存上限
+ * - 采用环形窗口思路，仅保留最新 5000 条，避免 MCP 进程长期运行时内存无限增长
+ */
+export declare const DEVICE_LOG_MEMORY_LIMIT = 5000;
+/**
+ * 确保后台日志订阅处于目标设备上
+ * - 若目标未变化且订阅仍在运行，则直接复用已有连接
+ * - 若目标发生变化，则重置缓存并重新建立订阅
+ * @param ip 设备 IP
+ * @param port 设备端口
+ * @returns 返回是否复用了现有订阅
+ * @example
+ * const reused = ensureDeviceLogSubscription("192.168.1.10", 9800)
+ */
+export declare function ensureDeviceLogSubscription(ip: string, port: number): boolean;
+/**
+ * 生成日志缓存快照文本
+ * @param limit 需要返回的日志条数
+ * @param runtimeStatusLimit 需要返回的 runtime_status 条数
+ * @returns 返回用于 MCP 文本响应的快照内容
+ * @example
+ * const text = buildDeviceLogSnapshotText(100, 20)
+ */
+export declare function buildDeviceLogSnapshotText(limit: number, runtimeStatusLimit: number): string;

package/dist/mcp/device-log.js

@@ -0,0 +1,391 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVICE_LOG_MEMORY_LIMIT = void 0;
+exports.ensureDeviceLogSubscription = ensureDeviceLogSubscription;
+exports.buildDeviceLogSnapshotText = buildDeviceLogSnapshotText;
+/**
+ * 设备日志内存缓存上限
+ * - 采用环形窗口思路，仅保留最新 5000 条，避免 MCP 进程长期运行时内存无限增长
+ */
+exports.DEVICE_LOG_MEMORY_LIMIT = 5000;
+/**
+ * SSE 重连等待时间（毫秒）
+ * - 当设备日志流异常断开时，后台会自动尝试重连
+ */
+const DEVICE_LOG_RECONNECT_DELAY_MS = 1500;
+/**
+ * 视为“仍在工作中”的日志订阅状态集合
+ * - 用于判断同一设备是否可以直接复用已有后台连接
+ */
+const ACTIVE_DEVICE_LOG_SUBSCRIPTION_STATUSES = new Set([
+    "connecting",
+    "connected",
+    "reconnecting",
+]);
+/**
+ * 进程级设备日志订阅状态
+ * - 当前 MCP 仅维护单设备日志缓存
+ * - MCP Tool 处理函数会复用同一份内存缓存
+ */
+const deviceLogSubscriptionState = {
+    target: null,
+    status: "idle",
+    lastError: null,
+    lastEventAt: null,
+    startedAt: null,
+    logs: [],
+    runtimeStatus: [],
+    generation: 0,
+    controller: null,
+    reconnectTimer: null,
+};
+/**
+ * 向环形缓冲区追加数据
+ * @param buffer 目标数组
+ * @param entry 待写入的数据
+ * @param limit 数组最大长度
+ * @returns 无返回值
+ * @example
+ * pushRingBuffer([1, 2], 3, 2)
+ */
+function pushRingBuffer(buffer, entry, limit) {
+    if (buffer.length >= limit) {
+        buffer.splice(0, buffer.length - limit + 1);
+    }
+    buffer.push(entry);
+}
+/**
+ * 重置当前日志缓存快照
+ * @returns 无返回值
+ * @example
+ * resetDeviceLogSnapshotState()
+ */
+function resetDeviceLogSnapshotState() {
+    deviceLogSubscriptionState.lastError = null;
+    deviceLogSubscriptionState.lastEventAt = null;
+    deviceLogSubscriptionState.startedAt = new Date().toISOString();
+    deviceLogSubscriptionState.logs = [];
+    deviceLogSubscriptionState.runtimeStatus = [];
+}
+/**
+ * 判断日志订阅是否仍然活跃
+ * @returns 活跃返回 true，否则返回 false
+ * @example
+ * const active = isDeviceLogSubscriptionActive()
+ */
+function isDeviceLogSubscriptionActive() {
+    return (ACTIVE_DEVICE_LOG_SUBSCRIPTION_STATUSES.has(deviceLogSubscriptionState.status) || deviceLogSubscriptionState.reconnectTimer !== null);
+}
+/**
+ * 解析单个 SSE 文本块
+ * @param rawBlock 原始 SSE 文本块
+ * @returns 返回事件名与 data 字符串
+ * @example
+ * parseSseEventBlock("event: log\ndata: {\"message\":\"ok\"}")
+ */
+function parseSseEventBlock(rawBlock) {
+    const lines = rawBlock.split(/\r?\n/);
+    let eventName = "message";
+    const dataLines = [];
+    for (const line of lines) {
+        if (line.startsWith("event:")) {
+            eventName = line.slice(6).trim() || "message";
+            continue;
+        }
+        if (line.startsWith("data:")) {
+            dataLines.push(line.slice(5).trimStart());
+        }
+    }
+    return {
+        event: eventName,
+        data: dataLines.join("\n"),
+    };
+}
+/**
+ * 将原始日志对象标准化为统一结构
+ * @param payload 日志原始对象
+ * @returns 返回标准化后的日志
+ * @example
+ * normalizeBufferedLogEntry({ level: "info", message: "started" })
+ */
+function normalizeBufferedLogEntry(payload) {
+    const levelText = String(payload.level ?? "info").toLowerCase();
+    const messageText = String(payload.message ?? "");
+    const timestampText = typeof payload.timestamp === "string" && payload.timestamp
+        ? payload.timestamp
+        : new Date().toISOString();
+    return {
+        level: levelText,
+        message: messageText,
+        timestamp: timestampText,
+    };
+}
+/**
+ * 清理当前后台日志订阅
+ * @returns 无返回值
+ * @example
+ * stopDeviceLogSubscription()
+ */
+function stopDeviceLogSubscription() {
+    if (deviceLogSubscriptionState.reconnectTimer) {
+        clearTimeout(deviceLogSubscriptionState.reconnectTimer);
+        deviceLogSubscriptionState.reconnectTimer = null;
+    }
+    if (deviceLogSubscriptionState.controller) {
+        deviceLogSubscriptionState.controller.abort();
+        deviceLogSubscriptionState.controller = null;
+    }
+}
+/**
+ * 安排后台重连
+ * @param generation 当前订阅代次
+ * @returns 无返回值
+ * @example
+ * scheduleDeviceLogReconnect(1)
+ */
+function scheduleDeviceLogReconnect(generation) {
+    if (generation !== deviceLogSubscriptionState.generation ||
+        !deviceLogSubscriptionState.target) {
+        return;
+    }
+    if (deviceLogSubscriptionState.reconnectTimer) {
+        return;
+    }
+    deviceLogSubscriptionState.status = "reconnecting";
+    deviceLogSubscriptionState.reconnectTimer = setTimeout(() => {
+        deviceLogSubscriptionState.reconnectTimer = null;
+        void startDeviceLogSubscriptionLoop(generation);
+    }, DEVICE_LOG_RECONNECT_DELAY_MS);
+}
+/**
+ * 启动一次 SSE 读取循环
+ * - 该函数仅负责单次连接；若连接中断，会由外层自动调度重连
+ * @param generation 当前订阅代次
+ * @returns 读取流程结束后返回 Promise<void>
+ * @example
+ * await startDeviceLogSubscriptionLoop(1)
+ */
+async function startDeviceLogSubscriptionLoop(generation) {
+    if (generation !== deviceLogSubscriptionState.generation ||
+        !deviceLogSubscriptionState.target) {
+        return;
+    }
+    const { ip, port } = deviceLogSubscriptionState.target;
+    const controller = new AbortController();
+    const url = `http://${ip}:${port}/logger/sse`;
+    deviceLogSubscriptionState.controller = controller;
+    deviceLogSubscriptionState.status =
+        deviceLogSubscriptionState.lastEventAt === null
+            ? "connecting"
+            : "reconnecting";
+    try {
+        const response = await fetch(url, {
+            method: "GET",
+            signal: controller.signal,
+            headers: {
+                Accept: "text/event-stream",
+            },
+        });
+        if (!response.ok || !response.body) {
+            throw new Error(`连接日志流失败: ${response.status} ${response.statusText || "unknown"}`);
+        }
+        deviceLogSubscriptionState.status = "connected";
+        deviceLogSubscriptionState.lastError = null;
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder("utf-8");
+        let buffer = "";
+        while (generation === deviceLogSubscriptionState.generation) {
+            const { value, done } = await reader.read();
+            if (done) {
+                break;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            let splitIndex = buffer.search(/\r?\n\r?\n/);
+            while (splitIndex >= 0) {
+                const rawBlock = buffer.slice(0, splitIndex);
+                buffer = buffer.slice(splitIndex + (buffer[splitIndex] === "\r" ? 4 : 2));
+                const event = parseSseEventBlock(rawBlock);
+                if (event.data) {
+                    try {
+                        const parsed = JSON.parse(event.data);
+                        deviceLogSubscriptionState.lastEventAt = new Date().toISOString();
+                        if (event.event === "log") {
+                            pushRingBuffer(deviceLogSubscriptionState.logs, normalizeBufferedLogEntry(parsed), exports.DEVICE_LOG_MEMORY_LIMIT);
+                        }
+                        else if (event.event === "runtime_status") {
+                            pushRingBuffer(deviceLogSubscriptionState.runtimeStatus, {
+                                raw: parsed,
+                                timestamp: new Date().toISOString(),
+                            }, exports.DEVICE_LOG_MEMORY_LIMIT);
+                        }
+                    }
+                    catch {
+                        // 忽略单条非法 JSON，避免因为异常日志阻塞整个后台连接
+                    }
+                }
+                splitIndex = buffer.search(/\r?\n\r?\n/);
+            }
+        }
+        if (generation === deviceLogSubscriptionState.generation) {
+            scheduleDeviceLogReconnect(generation);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            (error.name === "AbortError" ||
+                error.message === "The operation was aborted.")) {
+            return;
+        }
+        if (generation === deviceLogSubscriptionState.generation) {
+            deviceLogSubscriptionState.status = "error";
+            deviceLogSubscriptionState.lastError =
+                error instanceof Error ? error.message : String(error);
+            scheduleDeviceLogReconnect(generation);
+        }
+    }
+    finally {
+        if (deviceLogSubscriptionState.controller === controller) {
+            deviceLogSubscriptionState.controller = null;
+        }
+    }
+}
+/**
+ * 确保后台日志订阅处于目标设备上
+ * - 若目标未变化且订阅仍在运行，则直接复用已有连接
+ * - 若目标发生变化，则重置缓存并重新建立订阅
+ * @param ip 设备 IP
+ * @param port 设备端口
+ * @returns 返回是否复用了现有订阅
+ * @example
+ * const reused = ensureDeviceLogSubscription("192.168.1.10", 9800)
+ */
+function ensureDeviceLogSubscription(ip, port) {
+    const sameTarget = deviceLogSubscriptionState.target?.ip === ip &&
+        deviceLogSubscriptionState.target?.port === port;
+    const isActive = isDeviceLogSubscriptionActive();
+    if (sameTarget && isActive) {
+        return true;
+    }
+    stopDeviceLogSubscription();
+    deviceLogSubscriptionState.generation += 1;
+    deviceLogSubscriptionState.target = { ip, port };
+    deviceLogSubscriptionState.status = "connecting";
+    resetDeviceLogSnapshotState();
+    void startDeviceLogSubscriptionLoop(deviceLogSubscriptionState.generation);
+    return false;
+}
+/**
+ * 按日志页面风格格式化时间
+ * @param value ISO 时间字符串
+ * @returns 返回 `yyyy/mm/dd hh:mm:ss.xxx` 风格文本，异常时回退原值
+ * @example
+ * formatDisplayTimestamp("2026-05-07T11:34:48.776Z")
+ */
+function formatDisplayTimestamp(value) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return value;
+    }
+    const pad = (number, length = 2) => String(number).padStart(length, "0");
+    return `${date.getFullYear()}/${pad(date.getMonth() + 1)}/${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.${pad(date.getMilliseconds(), 3)}`;
+}
+/**
+ * 将日志订阅连接状态转为中文文本
+ * @param status 原始连接状态
+ * @returns 返回中文状态说明
+ * @example
+ * formatDeviceLogSubscriptionStatus("connected")
+ */
+function formatDeviceLogSubscriptionStatus(status) {
+    switch (status) {
+        case "idle":
+            return "未订阅";
+        case "connecting":
+            return "连接中";
+        case "connected":
+            return "已连接";
+        case "reconnecting":
+            return "重连中";
+        case "error":
+            return "连接异常";
+        default:
+            return status;
+    }
+}
+/**
+ * 将 runtime_status 中的内存数值格式化为可读文本
+ * @param value 原始数值
+ * @param suffix 数值单位后缀
+ * @returns 数值存在时返回格式化结果，否则返回未知
+ * @example
+ * formatRuntimeMetricText(12.3456, " MB")
+ */
+function formatRuntimeMetricText(value, suffix = "") {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return `${value.toFixed(2)}${suffix}`;
+    }
+    return "未知";
+}
+/**
+ * 将单条 runtime_status 事件格式化为中文运行状态摘要
+ * @param entry runtime_status 条目
+ * @returns 返回更易读的状态文本
+ * @example
+ * formatRuntimeStatusEntry({ raw: { isRunning: false }, timestamp: "2026-01-01T00:00:00.000Z" })
+ */
+function formatRuntimeStatusEntry(entry) {
+    const raw = entry.raw;
+    const memory = raw.memory && typeof raw.memory === "object"
+        ? raw.memory
+        : {};
+    return [
+        `[${formatDisplayTimestamp(entry.timestamp)}]`,
+        `UI: ${typeof raw.isUIShowing === "boolean"
+            ? raw.isUIShowing
+                ? "显示中"
+                : "未显示"
+            : "未知"}`,
+        `脚本: ${typeof raw.isRunning === "boolean"
+            ? raw.isRunning
+                ? "运行中"
+                : "未运行"
+            : "未知"}`,
+        `总内存: ${formatRuntimeMetricText(memory.total, " MB")}`,
+        `可用: ${formatRuntimeMetricText(memory.available, " MB")}`,
+        `已用: ${formatRuntimeMetricText(memory.used, " MB")}`,
+        `占用: ${formatRuntimeMetricText(memory.usagePercentage, "%")}`,
+    ].join(" | ");
+}
+/**
+ * 生成日志缓存快照文本
+ * @param limit 需要返回的日志条数
+ * @param runtimeStatusLimit 需要返回的 runtime_status 条数
+ * @returns 返回用于 MCP 文本响应的快照内容
+ * @example
+ * const text = buildDeviceLogSnapshotText(100, 20)
+ */
+function buildDeviceLogSnapshotText(limit, runtimeStatusLimit) {
+    const recentLogs = deviceLogSubscriptionState.logs
+        .slice(-limit)
+        .map((log) => `[${formatDisplayTimestamp(log.timestamp)}] [${log.level.toUpperCase()}] ${log.message}`);
+    const recentRuntimeStatus = deviceLogSubscriptionState.runtimeStatus
+        .slice(-runtimeStatusLimit)
+        .map((entry) => formatRuntimeStatusEntry(entry));
+    return [
+        `设备: ${deviceLogSubscriptionState.target
+            ? `${deviceLogSubscriptionState.target.ip}:${deviceLogSubscriptionState.target.port}`
+            : "未订阅"}`,
+        `状态: ${formatDeviceLogSubscriptionStatus(deviceLogSubscriptionState.status)}`,
+        ...(deviceLogSubscriptionState.lastError
+            ? [`最近错误: ${deviceLogSubscriptionState.lastError}`]
+            : []),
+        "",
+        `最新日志（最多 ${limit} 条）:`,
+        recentLogs.length > 0 ? recentLogs.join("\n") : "无日志",
+        "",
+        `最新运行状态（最多 ${runtimeStatusLimit} 条）:`,
+        recentRuntimeStatus.length > 0
+            ? recentRuntimeStatus.join("\n")
+            : "无运行状态",
+    ].join("\n");
+}

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

@@ -0,0 +1,17 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 注册文档资源
+ * @param server MCP 服务实例
+ * @returns 无返回值
+ * @example
+ * registerDocResources(server)
+ */
+export declare function registerDocResources(server: McpServer): void;
+/**
+ * 注册文档工具
+ * @param server MCP 服务实例
+ * @returns 无返回值
+ * @example
+ * registerDocTools(server)
+ */
+export declare function registerDocTools(server: McpServer): void;