ms-vite-plugin 1.4.47 → 1.4.49

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

@@ -1,55 +1,8 @@
 import type { DeviceConfig } from "./types";
-/**
- * 默认设备端口
- */
 export declare const DEFAULT_DEVICE_PORT = 9800;
-/**
- * 设备连接配置持久化文件
- * - 使用系统临时目录，避免污染项目源码目录
- * - 文件名包含 pid/时间戳/随机串，确保并发窗口与多次启动互不冲突
- */
 export declare const DEVICE_CONFIG_FILE: string;
-/**
- * 将端口标准化为字符串（内部沿用 DeviceCliOptions 字符串端口）
- * @param port 端口号
- * @returns 返回标准端口字符串
- * @example
- * const textPort = normalizePort(9800)
- */
 export declare function normalizePort(port: number): string;
-/**
- * 读取已保存的设备配置
- * @returns 若存在有效配置则返回配置对象，否则返回 null
- * @example
- * const cfg = await readDeviceConfig()
- */
 export declare function readDeviceConfig(): Promise<DeviceConfig | null>;
-/**
- * 保存设备配置
- * @param config 需要保存的设备配置
- * @returns 保存完成后返回 Promise<void>
- * @example
- * await writeDeviceConfig({ ip: "192.168.1.100", port: 9800, updatedAt: Date.now() })
- */
 export declare function writeDeviceConfig(config: DeviceConfig): Promise<void>;
-/**
- * 构建并保存设备配置
- * @param ip 设备 IP
- * @param port 设备端口（可选）
- * @returns 返回保存后的设备配置
- * @example
- * const cfg = await setDeviceConfig("192.168.1.100", 9800)
- */
 export declare function setDeviceConfig(ip: string, port?: number): Promise<DeviceConfig>;
-/**
- * 获取最终生效的设备配置
- * - 若调用参数携带 ip，则优先使用调用参数并落盘
- * - 若只传 port，则复用已保存 ip，并更新 port 后落盘
- * - 若都不传，则读取已保存配置
- * @param ip 调用参数中的设备 ip（可选）
- * @param port 调用参数中的设备端口（可选）
- * @returns 返回可直接用于请求设备的配置
- * @example
- * const target = await resolveDeviceConfig(undefined, undefined)
- */
 export declare function resolveDeviceConfig(ip?: string, port?: number): Promise<DeviceConfig>;

package/dist/mcp/device-config.js

@@ -1,183 +1 @@
-"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.DEVICE_CONFIG_FILE = exports.DEFAULT_DEVICE_PORT = void 0;
-exports.normalizePort = normalizePort;
-exports.readDeviceConfig = readDeviceConfig;
-exports.writeDeviceConfig = writeDeviceConfig;
-exports.setDeviceConfig = setDeviceConfig;
-exports.resolveDeviceConfig = resolveDeviceConfig;
-const fsExtra = __importStar(require("fs-extra"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-/**
- * 默认设备端口
- */
-exports.DEFAULT_DEVICE_PORT = 9800;
-/**
- * 设备连接配置持久化文件
- * - 使用系统临时目录，避免污染项目源码目录
- * - 文件名包含 pid/时间戳/随机串，确保并发窗口与多次启动互不冲突
- */
-exports.DEVICE_CONFIG_FILE = path.join(os.tmpdir(), `ms-cli-mcp-device-${process.pid}-${Date.now()}-${Math.random()
-    .toString(36)
-    .slice(2, 10)}.json`);
-/**
- * 将端口标准化为字符串（内部沿用 DeviceCliOptions 字符串端口）
- * @param port 端口号
- * @returns 返回标准端口字符串
- * @example
- * const textPort = normalizePort(9800)
- */
-function normalizePort(port) {
-    return String(port);
-}
-/**
- * 校验并标准化 IP 字符串
- * @param ip 原始 ip 输入
- * @returns 返回去空格后的 ip
- * @example
- * const normalizedIp = normalizeIp(" 192.168.1.100 ")
- */
-function normalizeIp(ip) {
-    const normalizedIp = ip.trim();
-    if (!normalizedIp) {
-        throw new Error("设备 IP 不能为空");
-    }
-    return normalizedIp;
-}
-/**
- * 校验并标准化端口
- * @param port 原始端口（可选）
- * @returns 返回有效端口，默认 9800
- * @example
- * const normalizedPort = normalizeDevicePort(undefined)
- */
-function normalizeDevicePort(port) {
-    const targetPort = port ?? exports.DEFAULT_DEVICE_PORT;
-    if (!Number.isInteger(targetPort) || targetPort < 1 || targetPort > 65535) {
-        throw new Error(`无效设备端口: ${String(port)}`);
-    }
-    return targetPort;
-}
-/**
- * 读取已保存的设备配置
- * @returns 若存在有效配置则返回配置对象，否则返回 null
- * @example
- * const cfg = await readDeviceConfig()
- */
-async function readDeviceConfig() {
-    try {
-        if (!(await fsExtra.pathExists(exports.DEVICE_CONFIG_FILE))) {
-            return null;
-        }
-        const data = (await fsExtra.readJSON(exports.DEVICE_CONFIG_FILE));
-        const ip = typeof data.ip === "string" ? data.ip.trim() : "";
-        const port = typeof data.port === "number" ? data.port : Number.parseInt(String(data.port), 10);
-        if (!ip || !Number.isInteger(port) || port < 1 || port > 65535) {
-            return null;
-        }
-        return {
-            ip,
-            port,
-            updatedAt: typeof data.updatedAt === "number" && Number.isFinite(data.updatedAt)
-                ? data.updatedAt
-                : Date.now(),
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 保存设备配置
- * @param config 需要保存的设备配置
- * @returns 保存完成后返回 Promise<void>
- * @example
- * await writeDeviceConfig({ ip: "192.168.1.100", port: 9800, updatedAt: Date.now() })
- */
-async function writeDeviceConfig(config) {
-    await fsExtra.writeJSON(exports.DEVICE_CONFIG_FILE, config, { spaces: 2 });
-}
-/**
- * 构建并保存设备配置
- * @param ip 设备 IP
- * @param port 设备端口（可选）
- * @returns 返回保存后的设备配置
- * @example
- * const cfg = await setDeviceConfig("192.168.1.100", 9800)
- */
-async function setDeviceConfig(ip, port) {
-    const config = {
-        ip: normalizeIp(ip),
-        port: normalizeDevicePort(port),
-        updatedAt: Date.now(),
-    };
-    await writeDeviceConfig(config);
-    return config;
-}
-/**
- * 获取最终生效的设备配置
- * - 若调用参数携带 ip，则优先使用调用参数并落盘
- * - 若只传 port，则复用已保存 ip，并更新 port 后落盘
- * - 若都不传，则读取已保存配置
- * @param ip 调用参数中的设备 ip（可选）
- * @param port 调用参数中的设备端口（可选）
- * @returns 返回可直接用于请求设备的配置
- * @example
- * const target = await resolveDeviceConfig(undefined, undefined)
- */
-async function resolveDeviceConfig(ip, port) {
-    const savedConfig = await readDeviceConfig();
-    if (ip !== undefined) {
-        return setDeviceConfig(ip, port);
-    }
-    if (port !== undefined) {
-        if (!savedConfig) {
-            throw new Error("尚未配置设备 IP。请先调用 set_device 设置 ip，或在本次 run 调用里传入 ip。");
-        }
-        const nextConfig = {
-            ip: savedConfig.ip,
-            port: normalizeDevicePort(port),
-            updatedAt: Date.now(),
-        };
-        await writeDeviceConfig(nextConfig);
-        return nextConfig;
-    }
-    if (savedConfig) {
-        return savedConfig;
-    }
-    throw new Error("未找到可用设备配置。请先调用 set_device 设置 ip，或在 run/run_ui/stop 调用里传入 ip。");
-}
+"use strict";var d=exports&&exports.__createBinding||(Object.create?(function(t,e,r,n){n===void 0&&(n=r);var i=Object.getOwnPropertyDescriptor(e,r);(!i||("get"in i?!e.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return e[r]}}),Object.defineProperty(t,n,i)}):(function(t,e,r,n){n===void 0&&(n=r),t[n]=e[r]})),l=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),o=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(r){var n=[];for(var i in r)Object.prototype.hasOwnProperty.call(r,i)&&(n[n.length]=i);return n},t(e)};return function(e){if(e&&e.__esModule)return e;var r={};if(e!=null)for(var n=t(e),i=0;i<n.length;i++)n[i]!=="default"&&d(r,e,n[i]);return l(r,e),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.DEVICE_CONFIG_FILE=exports.DEFAULT_DEVICE_PORT=void 0,exports.normalizePort=E,exports.readDeviceConfig=f,exports.writeDeviceConfig=a,exports.setDeviceConfig=s,exports.resolveDeviceConfig=v;const u=o(require("fs-extra")),p=o(require("os")),_=o(require("path"));exports.DEFAULT_DEVICE_PORT=9800,exports.DEVICE_CONFIG_FILE=_.join(p.tmpdir(),`ms-cli-mcp-device-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2,10)}.json`);function E(t){return String(t)}function g(t){const e=t.trim();if(!e)throw new Error("\u8BBE\u5907 IP \u4E0D\u80FD\u4E3A\u7A7A");return e}function c(t){const e=t??exports.DEFAULT_DEVICE_PORT;if(!Number.isInteger(e)||e<1||e>65535)throw new Error(`\u65E0\u6548\u8BBE\u5907\u7AEF\u53E3: ${String(t)}`);return e}async function f(){try{if(!await u.pathExists(exports.DEVICE_CONFIG_FILE))return null;const t=await u.readJSON(exports.DEVICE_CONFIG_FILE),e=typeof t.ip=="string"?t.ip.trim():"",r=typeof t.port=="number"?t.port:Number.parseInt(String(t.port),10);return!e||!Number.isInteger(r)||r<1||r>65535?null:{ip:e,port:r,updatedAt:typeof t.updatedAt=="number"&&Number.isFinite(t.updatedAt)?t.updatedAt:Date.now()}}catch{return null}}async function a(t){await u.writeJSON(exports.DEVICE_CONFIG_FILE,t,{spaces:2})}async function s(t,e){const r={ip:g(t),port:c(e),updatedAt:Date.now()};return await a(r),r}async function v(t,e){const r=await f();if(t!==void 0)return s(t,e);if(e!==void 0){if(!r)throw new Error("\u5C1A\u672A\u914D\u7F6E\u8BBE\u5907 IP\u3002\u8BF7\u5148\u8C03\u7528 set_device \u8BBE\u7F6E ip\uFF0C\u6216\u5728\u672C\u6B21 run \u8C03\u7528\u91CC\u4F20\u5165 ip\u3002");const n={ip:r.ip,port:c(e),updatedAt:Date.now()};return await a(n),n}if(r)return r;throw new Error("\u672A\u627E\u5230\u53EF\u7528\u8BBE\u5907\u914D\u7F6E\u3002\u8BF7\u5148\u8C03\u7528 set_device \u8BBE\u7F6E ip\uFF0C\u6216\u5728 run/run_ui/stop \u8C03\u7528\u91CC\u4F20\u5165 ip\u3002")}

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

@@ -1,10 +1,2 @@
 import type { RuntimeHttpTarget } from "./tool-utils";
-/**
- * 构建当前设备日志文本快照
- * @param target 当前默认 HTTP 设备
- * @param limit 需要返回的最新日志行数
- * @returns 返回可直接作为 MCP 文本响应的日志内容
- * @example
- * const text = await buildDeviceLogSnapshotText({ ip: "192.168.1.10", port: "9800", label: "192.168.1.10:9800" }, 200)
- */
 export declare function buildDeviceLogSnapshotText(target: RuntimeHttpTarget, limit: number): Promise<string>;

package/dist/mcp/device-log.js

@@ -1,27 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildDeviceLogSnapshotText = buildDeviceLogSnapshotText;
-const project_1 = require("../project");
-/**
- * 构建当前设备日志文本快照
- * @param target 当前默认 HTTP 设备
- * @param limit 需要返回的最新日志行数
- * @returns 返回可直接作为 MCP 文本响应的日志内容
- * @example
- * const text = await buildDeviceLogSnapshotText({ ip: "192.168.1.10", port: "9800", label: "192.168.1.10:9800" }, 200)
- */
-async function buildDeviceLogSnapshotText(target, limit) {
-    const result = await (0, project_1.getCurrentLogLinesOnDevice)({
-        ip: target.ip,
-        port: target.port,
-        transport: "http",
-    }, limit);
-    const lines = result.lines.length > 0 ? result.lines.join("\n") : "无日志";
-    return [
-        `设备: ${target.label}`,
-        `还有更早日志: ${result.hasMore ? "是" : "否"}`,
-        "",
-        `最新日志（最多 ${limit} 行）:`,
-        lines,
-    ].join("\n");
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.buildDeviceLogSnapshotText=s;const i=require("../project");async function s(e,t){const n=await(0,i.getCurrentLogLinesOnDevice)({ip:e.ip,port:e.port,transport:"http"},t),o=n.lines.length>0?n.lines.join(`
+`):"\u65E0\u65E5\u5FD7";return[`\u8BBE\u5907: ${e.label}`,`\u8FD8\u6709\u66F4\u65E9\u65E5\u5FD7: ${n.hasMore?"\u662F":"\u5426"}`,"",`\u6700\u65B0\u65E5\u5FD7\uFF08\u6700\u591A ${t} \u884C\uFF09:`,o].join(`
+`)}

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

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

package/dist/mcp/doc-tools.js

@@ -1,39 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerDocTools = registerDocTools;
-const docs_service_1 = require("./docs-service");
-const httpapi_docs_service_1 = require("./httpapi-docs-service");
-const tool_utils_1 = require("./tool-utils");
-const types_1 = require("./types");
-/**
- * 格式化 KuaiJS 文档路径清单
- * @returns 返回可直接交给 AI 读取的文档路径文本
- * @example
- * const text = formatDocsPathsText()
- */
-function formatDocsPathsText() {
-    const languages = ["js", "js_zh", "python"];
-    return [
-        "KuaiJS 文档路径:",
-        `docsRoot: ${(0, docs_service_1.getDocsRootDir)()}`,
-        ...languages.map((language) => `${language}: ${(0, docs_service_1.getDocsDirByLanguage)(language)} (${types_1.DOC_LANGUAGE_LABELS[language]})`),
-        `httpApi: ${(0, httpapi_docs_service_1.getHttpApiDocPath)()}`,
-        "说明: 直接读取上述 markdown 路径。",
-    ].join("\n");
-}
-/**
- * 注册文档工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerDocTools(server)
- */
-function registerDocTools(server) {
-    server.registerTool("get_docs_paths", {
-        title: "Get Docs Paths",
-        description: "获取 KuaiJS 本地文档路径，便于 AI 直接读取 markdown 文件而不是猜测位置。",
-        inputSchema: {},
-    }, async () => {
-        return (0, tool_utils_1.createTextToolResult)(formatDocsPathsText());
-    });
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.registerDocTools=n;const o=require("./docs-service"),s=require("./httpapi-docs-service"),r=require("./tool-utils"),c=require("./types");function i(){const t=["js","js_zh","python"];return["KuaiJS \u6587\u6863\u8DEF\u5F84:",`docsRoot: ${(0,o.getDocsRootDir)()}`,...t.map(e=>`${e}: ${(0,o.getDocsDirByLanguage)(e)} (${c.DOC_LANGUAGE_LABELS[e]})`),`httpApi: ${(0,s.getHttpApiDocPath)()}`,"\u8BF4\u660E: \u76F4\u63A5\u8BFB\u53D6\u4E0A\u8FF0 markdown \u8DEF\u5F84\u3002"].join(`
+`)}function n(t){t.registerTool("get_docs_paths",{title:"Get Docs Paths",description:"\u83B7\u53D6 KuaiJS \u672C\u5730\u6587\u6863\u8DEF\u5F84\uFF0C\u4FBF\u4E8E AI \u76F4\u63A5\u8BFB\u53D6 markdown \u6587\u4EF6\u800C\u4E0D\u662F\u731C\u6D4B\u4F4D\u7F6E\u3002",inputSchema:{}},async()=>(0,r.createTextToolResult)(i()))}

package/dist/mcp/docs-service.d.ts

@@ -1,16 +1,3 @@
 import type { ApiDocsLanguage } from "./types";
-/**
- * 获取 docs 根目录
- * @returns 返回 docs 目录绝对路径
- * @example
- * const docsRoot = getDocsRootDir()
- */
 export declare function getDocsRootDir(): string;
-/**
- * 获取某语言对应的文档目录
- * @param language 文档语言
- * @returns 返回文档目录绝对路径
- * @example
- * const dir = getDocsDirByLanguage("js_zh")
- */
 export declare function getDocsDirByLanguage(language: ApiDocsLanguage): string;

package/dist/mcp/docs-service.js

@@ -1,63 +1 @@
-"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.getDocsRootDir = getDocsRootDir;
-exports.getDocsDirByLanguage = getDocsDirByLanguage;
-const path = __importStar(require("path"));
-/**
- * 获取 docs 根目录
- * @returns 返回 docs 目录绝对路径
- * @example
- * const docsRoot = getDocsRootDir()
- */
-function getDocsRootDir() {
-    return path.resolve(__dirname, "..", "..", "docs");
-}
-/**
- * 获取某语言对应的文档目录
- * @param language 文档语言
- * @returns 返回文档目录绝对路径
- * @example
- * const dir = getDocsDirByLanguage("js_zh")
- */
-function getDocsDirByLanguage(language) {
-    if (language === "js") {
-        return path.join(getDocsRootDir(), "api");
-    }
-    if (language === "js_zh") {
-        return path.join(getDocsRootDir(), "apicn");
-    }
-    return path.join(getDocsRootDir(), "apipython");
-}
+"use strict";var c=exports&&exports.__createBinding||(Object.create?(function(r,e,i,t){t===void 0&&(t=i);var n=Object.getOwnPropertyDescriptor(e,i);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[i]}}),Object.defineProperty(r,t,n)}):(function(r,e,i,t){t===void 0&&(t=i),r[t]=e[i]})),f=exports&&exports.__setModuleDefault||(Object.create?(function(r,e){Object.defineProperty(r,"default",{enumerable:!0,value:e})}):function(r,e){r.default=e}),o=exports&&exports.__importStar||(function(){var r=function(e){return r=Object.getOwnPropertyNames||function(i){var t=[];for(var n in i)Object.prototype.hasOwnProperty.call(i,n)&&(t[t.length]=n);return t},r(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null)for(var t=r(e),n=0;n<t.length;n++)t[n]!=="default"&&c(i,e,t[n]);return f(i,e),i}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.getDocsRootDir=a,exports.getDocsDirByLanguage=l;const u=o(require("path"));function a(){return u.resolve(__dirname,"..","..","docs")}function l(r){return r==="js"?u.join(a(),"api"):r==="js_zh"?u.join(a(),"apicn"):u.join(a(),"apipython")}

package/dist/mcp/httpapi-docs-service.d.ts

@@ -1,42 +1,11 @@
-/**
- * HTTP API 请求方法
- */
 export type HttpApiMethod = "GET" | "POST";
-/**
- * HTTP API 文档条目
- */
 export type HttpApiDocEntry = {
-    /** 接口请求方法 */
     method: HttpApiMethod;
-    /** 接口路径 */
     path: string;
-    /** 接口标题 */
     title: string;
-    /** 文档片段起始行号（1-based） */
     startLine: number;
-    /** 文档片段结束行号（1-based） */
     endLine: number;
 };
-/**
- * 获取 HTTP API 文档路径
- * @returns 返回 HTTP API 文档绝对路径
- * @example
- * const filePath = getHttpApiDocPath()
- */
 export declare function getHttpApiDocPath(): string;
-/**
- * 解析 HTTP API markdown 为接口条目
- * @returns 返回按文档顺序排列的接口条目
- * @example
- * const entries = await getHttpApiDocEntries()
- */
 export declare function getHttpApiDocEntries(): Promise<HttpApiDocEntry[]>;
-/**
- * 根据 method/path 查找 HTTP API 文档条目
- * @param apiPath API 路径
- * @param method HTTP 方法
- * @returns 找到时返回条目，否则返回 undefined
- * @example
- * const entry = await findHttpApiDocEntry("/api/control/click", "GET")
- */
 export declare function findHttpApiDocEntry(apiPath: string, method: HttpApiMethod): Promise<HttpApiDocEntry | undefined>;

package/dist/mcp/httpapi-docs-service.js

@@ -1,122 +1 @@
-"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.getHttpApiDocPath = getHttpApiDocPath;
-exports.getHttpApiDocEntries = getHttpApiDocEntries;
-exports.findHttpApiDocEntry = findHttpApiDocEntry;
-const fsExtra = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
-const HTTP_API_DOC_RELATIVE_PATH = ["docs", "httpapi", "api.md"];
-const HTTP_API_ENDPOINT_PATTERN = /^(GET|POST)\s+(\/\S+)/;
-const HTTP_API_TITLE_PATTERN = /^##\s+(.+)$/;
-let cachedHttpApiDocEntries = null;
-/**
- * 获取 HTTP API 文档路径
- * @returns 返回 HTTP API 文档绝对路径
- * @example
- * const filePath = getHttpApiDocPath()
- */
-function getHttpApiDocPath() {
-    return path.resolve(__dirname, "..", "..", ...HTTP_API_DOC_RELATIVE_PATH);
-}
-/**
- * 解析 HTTP API markdown 为接口条目
- * @returns 返回按文档顺序排列的接口条目
- * @example
- * const entries = await getHttpApiDocEntries()
- */
-async function getHttpApiDocEntries() {
-    const filePath = getHttpApiDocPath();
-    const stat = await fsExtra.stat(filePath);
-    if (cachedHttpApiDocEntries?.mtimeMs === stat.mtimeMs) {
-        return cachedHttpApiDocEntries.entries;
-    }
-    const markdown = await fsExtra.readFile(filePath, "utf8");
-    const lines = markdown.split(/\r?\n/);
-    const entries = [];
-    for (let index = 0; index < lines.length; index += 1) {
-        const line = lines[index] ?? "";
-        const titleMatch = line.match(HTTP_API_TITLE_PATTERN);
-        if (!titleMatch) {
-            continue;
-        }
-        const title = titleMatch[1]?.trim() ?? "";
-        let method = null;
-        let apiPath = "";
-        for (let cursor = index + 1; cursor < Math.min(lines.length, index + 8); cursor += 1) {
-            const endpointMatch = (lines[cursor] ?? "").match(HTTP_API_ENDPOINT_PATTERN);
-            if (endpointMatch) {
-                method = endpointMatch[1];
-                apiPath = endpointMatch[2] ?? "";
-                break;
-            }
-        }
-        if (!method || !apiPath) {
-            continue;
-        }
-        let endIndex = lines.length;
-        for (let cursor = index + 1; cursor < lines.length; cursor += 1) {
-            if (HTTP_API_TITLE_PATTERN.test(lines[cursor] ?? "")) {
-                endIndex = cursor;
-                break;
-            }
-        }
-        entries.push({
-            method,
-            path: apiPath,
-            title,
-            startLine: index + 1,
-            endLine: endIndex,
-        });
-    }
-    cachedHttpApiDocEntries = {
-        mtimeMs: stat.mtimeMs,
-        entries,
-    };
-    return entries;
-}
-/**
- * 根据 method/path 查找 HTTP API 文档条目
- * @param apiPath API 路径
- * @param method HTTP 方法
- * @returns 找到时返回条目，否则返回 undefined
- * @example
- * const entry = await findHttpApiDocEntry("/api/control/click", "GET")
- */
-async function findHttpApiDocEntry(apiPath, method) {
-    const normalizedPath = apiPath.trim();
-    const entries = await getHttpApiDocEntries();
-    return entries.find((entry) => entry.method === method && entry.path === normalizedPath);
-}
+"use strict";var T=exports&&exports.__createBinding||(Object.create?(function(i,t,r,e){e===void 0&&(e=r);var n=Object.getOwnPropertyDescriptor(t,r);(!n||("get"in n?!t.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(i,e,n)}):(function(i,t,r,e){e===void 0&&(e=r),i[e]=t[r]})),b=exports&&exports.__setModuleDefault||(Object.create?(function(i,t){Object.defineProperty(i,"default",{enumerable:!0,value:t})}):function(i,t){i.default=t}),d=exports&&exports.__importStar||(function(){var i=function(t){return i=Object.getOwnPropertyNames||function(r){var e=[];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(e[e.length]=n);return e},i(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var e=i(t),n=0;n<e.length;n++)e[n]!=="default"&&T(r,t,e[n]);return b(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.getHttpApiDocPath=P,exports.getHttpApiDocEntries=g,exports.findHttpApiDocEntry=v;const _=d(require("fs-extra")),A=d(require("path")),O=["docs","httpapi","api.md"],E=/^(GET|POST)\s+(\/\S+)/,p=/^##\s+(.+)$/;let l=null;function P(){return A.resolve(__dirname,"..","..",...O)}async function g(){const i=P(),t=await _.stat(i);if(l?.mtimeMs===t.mtimeMs)return l.entries;const e=(await _.readFile(i,"utf8")).split(/\r?\n/),n=[];for(let c=0;c<e.length;c+=1){const f=(e[c]??"").match(p);if(!f)continue;const m=f[1]?.trim()??"";let o=null,s="";for(let a=c+1;a<Math.min(e.length,c+8);a+=1){const u=(e[a]??"").match(E);if(u){o=u[1],s=u[2]??"";break}}if(!o||!s)continue;let h=e.length;for(let a=c+1;a<e.length;a+=1)if(p.test(e[a]??"")){h=a;break}n.push({method:o,path:s,title:m,startLine:c+1,endLine:h})}return l={mtimeMs:t.mtimeMs,entries:n},n}async function v(i,t){const r=i.trim();return(await g()).find(n=>n.method===t&&n.path===r)}

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

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