ms-vite-plugin 1.4.15 → 1.4.17

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

@@ -1,12 +1,4 @@
 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 服务实例

package/dist/mcp/doc-tools.js

@@ -1,105 +1,25 @@
 "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.registerDocResources = registerDocResources;
 exports.registerDocTools = registerDocTools;
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const z = __importStar(require("zod/v4"));
 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");
 /**
- * 注册文档资源
- * @param server MCP 服务实例
- * @returns 无返回值
+ * 格式化 KuaiJS 文档路径清单
+ * @returns 返回可直接交给 AI 读取的文档路径文本
  * @example
- * registerDocResources(server)
+ * const text = formatDocsPathsText()
  */
-function registerDocResources(server) {
-    server.registerResource("current-language", "kuaijs://docs/current-language", {
-        title: "Current KuaiJS API language",
-        mimeType: "application/json",
-    }, async () => {
-        const language = (0, docs_service_1.getCurrentDocsLanguage)();
-        return {
-            contents: [
-                {
-                    uri: "kuaijs://docs/current-language",
-                    mimeType: "application/json",
-                    text: JSON.stringify({
-                        currentLanguage: language,
-                        label: types_1.DOC_LANGUAGE_LABELS[language],
-                    }, null, 2),
-                },
-            ],
-        };
-    });
-    server.registerResource("api-doc", new mcp_js_1.ResourceTemplate("kuaijs://docs/current/{slug}", {
-        list: async () => {
-            const language = (0, docs_service_1.getCurrentDocsLanguage)();
-            const docs = await (0, docs_service_1.getApiDocsByLanguage)(language);
-            return {
-                resources: docs.map((doc) => ({
-                    uri: `kuaijs://docs/current/${doc.slug}`,
-                    name: doc.title,
-                    description: `[${types_1.DOC_LANGUAGE_LABELS[language]}] ${doc.slug}`,
-                    mimeType: "text/markdown",
-                })),
-            };
-        },
-    }), {
-        title: "KuaiJS API documents",
-        mimeType: "text/markdown",
-    }, async (_uri, variables) => {
-        const language = (0, docs_service_1.getCurrentDocsLanguage)();
-        const docs = await (0, docs_service_1.getApiDocsByLanguage)(language);
-        const slug = String(variables.slug || "");
-        const target = docs.find((doc) => doc.slug === slug);
-        if (!target) {
-            throw new Error(`文档不存在: ${slug}`);
-        }
-        return {
-            contents: [
-                {
-                    uri: `kuaijs://docs/current/${target.slug}`,
-                    mimeType: "text/markdown",
-                    text: target.content,
-                },
-            ],
-        };
-    });
+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");
 }
 /**
  * 注册文档工具
@@ -109,102 +29,11 @@ function registerDocResources(server) {
  * registerDocTools(server)
  */
 function registerDocTools(server) {
-    server.registerTool("get_docs_language", {
-        title: "Get Docs Language",
-        description: "获取当前 KuaiJS API 文档语言。",
+    server.registerTool("get_docs_paths", {
+        title: "Get Docs Paths",
+        description: "获取 KuaiJS 本地文档路径，便于 AI 直接读取 markdown 文件而不是猜测位置。",
         inputSchema: {},
     }, async () => {
-        const language = (0, docs_service_1.getCurrentDocsLanguage)();
-        return (0, tool_utils_1.createTextToolResult)(`当前文档语言: ${language} (${types_1.DOC_LANGUAGE_LABELS[language]})`);
-    });
-    server.registerTool("set_docs_language", {
-        title: "Set Docs Language",
-        description: "设置当前 KuaiJS API 文档语言，影响后续文档查询与读取。",
-        inputSchema: {
-            language: z
-                .enum(["js", "js_zh", "python"])
-                .describe("文档语言：js | js_zh | python"),
-        },
-    }, async ({ language }) => {
-        const active = (0, docs_service_1.setCurrentDocsLanguage)(language);
-        const docsDir = (0, docs_service_1.getDocsDirByLanguage)(active);
-        return (0, tool_utils_1.createTextToolResult)(`文档语言已切换为 ${active} (${types_1.DOC_LANGUAGE_LABELS[active]})\n目录: ${docsDir}`);
-    });
-    server.registerTool("list_api_docs", {
-        title: "List API Docs",
-        description: "列出当前（或指定）语言下可用的 API 文档。",
-        inputSchema: {
-            language: z
-                .enum(["js", "js_zh", "python"])
-                .optional()
-                .describe("可选语言，不传则使用当前语言"),
-        },
-    }, async ({ language }) => {
-        const activeLanguage = (0, docs_service_1.resolveDocsLanguage)(language);
-        const docs = await (0, docs_service_1.getApiDocsByLanguage)(activeLanguage);
-        const lines = docs.map((doc, index) => (0, tool_utils_1.formatApiDocSummary)(activeLanguage, doc.title, doc.slug, index));
-        return (0, tool_utils_1.createTextToolResult)(lines.length === 0
-            ? `当前语言 ${activeLanguage} 下没有可用文档。`
-            : [
-                `当前语言: ${activeLanguage} (${types_1.DOC_LANGUAGE_LABELS[activeLanguage]})`,
-                "",
-                ...lines,
-            ].join("\n"));
-    });
-    server.registerTool("search_api_docs", {
-        title: "Search API Docs",
-        description: "在当前（或指定）语言文档中按关键字搜索。",
-        inputSchema: {
-            query: z.string().min(1).describe("搜索关键字"),
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(20)
-                .optional()
-                .default(5)
-                .describe("返回条数上限，默认 5"),
-            language: z
-                .enum(["js", "js_zh", "python"])
-                .optional()
-                .describe("可选语言，不传则使用当前语言"),
-        },
-    }, async ({ query, limit, language }) => {
-        const activeLanguage = (0, docs_service_1.resolveDocsLanguage)(language);
-        const docs = await (0, docs_service_1.getApiDocsByLanguage)(activeLanguage);
-        const normalizedQuery = query.toLowerCase();
-        const matches = docs
-            .map((doc) => ({ doc, score: (0, docs_service_1.scoreApiDoc)(doc, normalizedQuery) }))
-            .filter((item) => item.score > 0)
-            .sort((a, b) => b.score - a.score || a.doc.slug.localeCompare(b.doc.slug))
-            .slice(0, limit)
-            .map((item) => item.doc);
-        const text = matches.length === 0
-            ? `当前语言: ${activeLanguage} (${types_1.DOC_LANGUAGE_LABELS[activeLanguage]})\n未找到与 "${query}" 匹配的文档。`
-            : [
-                `当前语言: ${activeLanguage} (${types_1.DOC_LANGUAGE_LABELS[activeLanguage]})`,
-                "",
-                ...matches.map((doc, index) => (0, tool_utils_1.formatApiDocSummary)(activeLanguage, doc.title, doc.slug, index)),
-            ].join("\n");
-        return (0, tool_utils_1.createTextToolResult)(text);
-    });
-    server.registerTool("read_api_doc", {
-        title: "Read API Doc",
-        description: "读取当前（或指定）语言下某个文档的完整 markdown 内容。",
-        inputSchema: {
-            slug: z.string().min(1).describe("文档 slug（文件名，不含 .md）"),
-            language: z
-                .enum(["js", "js_zh", "python"])
-                .optional()
-                .describe("可选语言，不传则使用当前语言"),
-        },
-    }, async ({ slug, language }) => {
-        const activeLanguage = (0, docs_service_1.resolveDocsLanguage)(language);
-        const docs = await (0, docs_service_1.getApiDocsByLanguage)(activeLanguage);
-        const target = docs.find((doc) => doc.slug === slug);
-        if (!target) {
-            return (0, tool_utils_1.createTextToolResult)(`未找到文档 ${slug}.md（语言: ${activeLanguage}）。`, true);
-        }
-        return (0, tool_utils_1.createTextToolResult)(`标题: ${target.title}\n语言: ${activeLanguage}\nURI: ${(0, docs_service_1.getDocUri)(activeLanguage, target.slug)}\n\n${target.content}`);
+        return (0, tool_utils_1.createTextToolResult)(formatDocsPathsText());
     });
 }

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

@@ -1,27 +1,4 @@
-import type { ApiDocItem, ApiDocsLanguage } from "./types";
-/**
- * 获取当前文档语言
- * @returns 返回当前语言
- * @example
- * const language = getCurrentDocsLanguage()
- */
-export declare function getCurrentDocsLanguage(): ApiDocsLanguage;
-/**
- * 设置当前文档语言
- * @param language 目标语言
- * @returns 设置后的语言
- * @example
- * const language = setCurrentDocsLanguage("python")
- */
-export declare function setCurrentDocsLanguage(language: ApiDocsLanguage): ApiDocsLanguage;
-/**
- * 根据可选入参解析实际使用的文档语言
- * @param language 工具调用时传入的语言（可选）
- * @returns 返回最终生效的语言
- * @example
- * const activeLanguage = resolveDocsLanguage(undefined)
- */
-export declare function resolveDocsLanguage(language?: ApiDocsLanguage): ApiDocsLanguage;
+import type { ApiDocsLanguage } from "./types";
 /**
  * 获取 docs 根目录
  * @returns 返回 docs 目录绝对路径
@@ -37,29 +14,3 @@ export declare function getDocsRootDir(): string;
  * const dir = getDocsDirByLanguage("js_zh")
  */
 export declare function getDocsDirByLanguage(language: ApiDocsLanguage): string;
-/**
- * 读取指定语言的 API 文档列表
- * @param language 文档语言
- * @returns 返回文档条目数组（按 slug 升序）
- * @example
- * const docs = await getApiDocsByLanguage("python")
- */
-export declare function getApiDocsByLanguage(language: ApiDocsLanguage): Promise<ApiDocItem[]>;
-/**
- * 对文档按查询词打分，用于检索排序
- * @param doc 文档条目
- * @param normalizedQuery 已转小写的查询词
- * @returns 分数，0 表示不命中
- * @example
- * const score = scoreApiDoc(doc, "click")
- */
-export declare function scoreApiDoc(doc: ApiDocItem, normalizedQuery: string): number;
-/**
- * 生成文档 URI（用于资源与文本返回）
- * @param language 文档语言
- * @param slug 文档分类
- * @returns 返回 MCP 资源 URI 字符串
- * @example
- * const uri = getDocUri("js_zh", "device")
- */
-export declare function getDocUri(language: ApiDocsLanguage, slug: string): string;

package/dist/mcp/docs-service.js

@@ -33,50 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCurrentDocsLanguage = getCurrentDocsLanguage;
-exports.setCurrentDocsLanguage = setCurrentDocsLanguage;
-exports.resolveDocsLanguage = resolveDocsLanguage;
 exports.getDocsRootDir = getDocsRootDir;
 exports.getDocsDirByLanguage = getDocsDirByLanguage;
-exports.getApiDocsByLanguage = getApiDocsByLanguage;
-exports.scoreApiDoc = scoreApiDoc;
-exports.getDocUri = getDocUri;
-const fsExtra = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
-/**
- * 当前 MCP 进程默认文档语言
- */
-let currentDocsLanguage = "js_zh";
-/**
- * 获取当前文档语言
- * @returns 返回当前语言
- * @example
- * const language = getCurrentDocsLanguage()
- */
-function getCurrentDocsLanguage() {
-    return currentDocsLanguage;
-}
-/**
- * 设置当前文档语言
- * @param language 目标语言
- * @returns 设置后的语言
- * @example
- * const language = setCurrentDocsLanguage("python")
- */
-function setCurrentDocsLanguage(language) {
-    currentDocsLanguage = language;
-    return currentDocsLanguage;
-}
-/**
- * 根据可选入参解析实际使用的文档语言
- * @param language 工具调用时传入的语言（可选）
- * @returns 返回最终生效的语言
- * @example
- * const activeLanguage = resolveDocsLanguage(undefined)
- */
-function resolveDocsLanguage(language) {
-    return language ?? currentDocsLanguage;
-}
 /**
  * 获取 docs 根目录
  * @returns 返回 docs 目录绝对路径
@@ -102,67 +61,3 @@ function getDocsDirByLanguage(language) {
     }
     return path.join(getDocsRootDir(), "apipython");
 }
-/**
- * 读取指定语言的 API 文档列表
- * @param language 文档语言
- * @returns 返回文档条目数组（按 slug 升序）
- * @example
- * const docs = await getApiDocsByLanguage("python")
- */
-async function getApiDocsByLanguage(language) {
-    const docsDir = getDocsDirByLanguage(language);
-    if (!(await fsExtra.pathExists(docsDir))) {
-        throw new Error(`文档目录不存在: ${docsDir}`);
-    }
-    const fileNames = await fsExtra.readdir(docsDir);
-    const mdFiles = fileNames
-        .filter((name) => name.toLowerCase().endsWith(".md"))
-        .sort();
-    const docs = [];
-    for (const fileName of mdFiles) {
-        const filePath = path.join(docsDir, fileName);
-        const content = await fsExtra.readFile(filePath, "utf8");
-        const slug = path.basename(fileName, ".md");
-        const titleMatch = content.match(/^#\s+(.+)$/m);
-        const title = titleMatch?.[1]?.trim() || slug;
-        docs.push({
-            slug,
-            title,
-            content,
-            filePath,
-        });
-    }
-    return docs;
-}
-/**
- * 对文档按查询词打分，用于检索排序
- * @param doc 文档条目
- * @param normalizedQuery 已转小写的查询词
- * @returns 分数，0 表示不命中
- * @example
- * const score = scoreApiDoc(doc, "click")
- */
-function scoreApiDoc(doc, normalizedQuery) {
-    let score = 0;
-    if (doc.title.toLowerCase().includes(normalizedQuery)) {
-        score += 50;
-    }
-    if (doc.slug.toLowerCase().includes(normalizedQuery)) {
-        score += 40;
-    }
-    if (doc.content.toLowerCase().includes(normalizedQuery)) {
-        score += 10;
-    }
-    return score;
-}
-/**
- * 生成文档 URI（用于资源与文本返回）
- * @param language 文档语言
- * @param slug 文档分类
- * @returns 返回 MCP 资源 URI 字符串
- * @example
- * const uri = getDocUri("js_zh", "device")
- */
-function getDocUri(language, slug) {
-    return `kuaijs://docs/${language}/${slug}`;
-}

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

@@ -6,39 +6,24 @@ export type HttpApiMethod = "GET" | "POST";
  * HTTP API 文档条目
  */
 export type HttpApiDocEntry = {
-    /** 稳定 slug，可用于读取单个接口文档 */
-    slug: string;
     /** 接口请求方法 */
     method: HttpApiMethod;
     /** 接口路径 */
     path: string;
     /** 接口标题 */
     title: string;
-    /** 所属一级章节 */
-    section: string;
     /** 文档片段起始行号（1-based） */
     startLine: number;
     /** 文档片段结束行号（1-based） */
     endLine: number;
-    /** 接口完整 markdown 片段 */
-    content: string;
 };
 /**
- * 读取 HTTP API markdown 文档
- * @returns 返回完整 markdown 文本
+ * 获取 HTTP API 文档路径
+ * @returns 返回 HTTP API 文档绝对路径
  * @example
- * const markdown = await readHttpApiMarkdown()
+ * const filePath = getHttpApiDocPath()
  */
-export declare function readHttpApiMarkdown(): Promise<string>;
-/**
- * 根据 method/path 生成稳定 slug
- * @param method HTTP 请求方法
- * @param apiPath HTTP API 路径
- * @returns 返回可用于 MCP 资源路径的 slug
- * @example
- * createHttpApiSlug("GET", "/api/control/click")
- */
-export declare function createHttpApiSlug(method: HttpApiMethod, apiPath: string): string;
+export declare function getHttpApiDocPath(): string;
 /**
  * 解析 HTTP API markdown 为接口条目
  * @returns 返回按文档顺序排列的接口条目
@@ -47,20 +32,11 @@ export declare function createHttpApiSlug(method: HttpApiMethod, apiPath: string
  */
 export declare function getHttpApiDocEntries(): Promise<HttpApiDocEntry[]>;
 /**
- * 计算 HTTP API 文档条目搜索分数
- * @param entry 文档条目
- * @param normalizedQuery 已转小写的搜索词
- * @returns 返回匹配分数，0 表示不匹配
- * @example
- * scoreHttpApiDocEntry(entry, "click")
- */
-export declare function scoreHttpApiDocEntry(entry: HttpApiDocEntry, normalizedQuery: string): number;
-/**
- * 根据 slug 或 path 查找 HTTP API 文档条目
- * @param identifier slug 或 API 路径
- * @param method 可选 HTTP 方法，用于同路径多方法时消歧
+ * 根据 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(identifier: string, method?: HttpApiMethod): Promise<HttpApiDocEntry | undefined>;
+export declare function findHttpApiDocEntry(apiPath: string, method: HttpApiMethod): Promise<HttpApiDocEntry | undefined>;

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

@@ -33,16 +33,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readHttpApiMarkdown = readHttpApiMarkdown;
-exports.createHttpApiSlug = createHttpApiSlug;
+exports.getHttpApiDocPath = getHttpApiDocPath;
 exports.getHttpApiDocEntries = getHttpApiDocEntries;
-exports.scoreHttpApiDocEntry = scoreHttpApiDocEntry;
 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_SECTION_PATTERN = /^#\s+(.+)$/;
 const HTTP_API_TITLE_PATTERN = /^##\s+(.+)$/;
 let cachedHttpApiDocEntries = null;
 /**
@@ -54,33 +51,6 @@ let cachedHttpApiDocEntries = null;
 function getHttpApiDocPath() {
     return path.resolve(__dirname, "..", "..", ...HTTP_API_DOC_RELATIVE_PATH);
 }
-/**
- * 读取 HTTP API markdown 文档
- * @returns 返回完整 markdown 文本
- * @example
- * const markdown = await readHttpApiMarkdown()
- */
-async function readHttpApiMarkdown() {
-    const filePath = getHttpApiDocPath();
-    if (!(await fsExtra.pathExists(filePath))) {
-        throw new Error("HTTP API 文档不可用。");
-    }
-    return fsExtra.readFile(filePath, "utf8");
-}
-/**
- * 根据 method/path 生成稳定 slug
- * @param method HTTP 请求方法
- * @param apiPath HTTP API 路径
- * @returns 返回可用于 MCP 资源路径的 slug
- * @example
- * createHttpApiSlug("GET", "/api/control/click")
- */
-function createHttpApiSlug(method, apiPath) {
-    return `${method.toLowerCase()}-${apiPath}`
-        .replace(/[^a-zA-Z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .toLowerCase();
-}
 /**
  * 解析 HTTP API markdown 为接口条目
  * @returns 返回按文档顺序排列的接口条目
@@ -89,24 +59,15 @@ function createHttpApiSlug(method, apiPath) {
  */
 async function getHttpApiDocEntries() {
     const filePath = getHttpApiDocPath();
-    const stat = await fsExtra.stat(filePath).catch(() => null);
-    if (!stat) {
-        throw new Error("HTTP API 文档不可用。");
-    }
+    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 = [];
-    let currentSection = "";
     for (let index = 0; index < lines.length; index += 1) {
         const line = lines[index] ?? "";
-        const sectionMatch = line.match(HTTP_API_SECTION_PATTERN);
-        if (sectionMatch) {
-            currentSection = sectionMatch[1]?.trim() ?? "";
-            continue;
-        }
         const titleMatch = line.match(HTTP_API_TITLE_PATTERN);
         if (!titleMatch) {
             continue;
@@ -133,14 +94,11 @@ async function getHttpApiDocEntries() {
             }
         }
         entries.push({
-            slug: createHttpApiSlug(method, apiPath),
             method,
             path: apiPath,
             title,
-            section: currentSection,
             startLine: index + 1,
             endLine: endIndex,
-            content: lines.slice(index, endIndex).join("\n").trim(),
         });
     }
     cachedHttpApiDocEntries = {
@@ -150,54 +108,15 @@ async function getHttpApiDocEntries() {
     return entries;
 }
 /**
- * 计算 HTTP API 文档条目搜索分数
- * @param entry 文档条目
- * @param normalizedQuery 已转小写的搜索词
- * @returns 返回匹配分数，0 表示不匹配
- * @example
- * scoreHttpApiDocEntry(entry, "click")
- */
-function scoreHttpApiDocEntry(entry, normalizedQuery) {
-    const query = normalizedQuery.trim();
-    if (!query) {
-        return 0;
-    }
-    let score = 0;
-    if (entry.path.toLowerCase() === query) {
-        score += 100;
-    }
-    if (`${entry.method} ${entry.path}`.toLowerCase() === query) {
-        score += 120;
-    }
-    if (entry.path.toLowerCase().includes(query)) {
-        score += 60;
-    }
-    if (entry.title.toLowerCase().includes(query)) {
-        score += 50;
-    }
-    if (entry.section.toLowerCase().includes(query)) {
-        score += 20;
-    }
-    if (entry.content.toLowerCase().includes(query)) {
-        score += 10;
-    }
-    return score;
-}
-/**
- * 根据 slug 或 path 查找 HTTP API 文档条目
- * @param identifier slug 或 API 路径
- * @param method 可选 HTTP 方法，用于同路径多方法时消歧
+ * 根据 method/path 查找 HTTP API 文档条目
+ * @param apiPath API 路径
+ * @param method HTTP 方法
  * @returns 找到时返回条目，否则返回 undefined
  * @example
  * const entry = await findHttpApiDocEntry("/api/control/click", "GET")
  */
-async function findHttpApiDocEntry(identifier, method) {
-    const normalizedIdentifier = identifier.trim();
+async function findHttpApiDocEntry(apiPath, method) {
+    const normalizedPath = apiPath.trim();
     const entries = await getHttpApiDocEntries();
-    return entries.find((entry) => {
-        const methodMatches = method ? entry.method === method : true;
-        return (methodMatches &&
-            (entry.slug === normalizedIdentifier ||
-                entry.path === normalizedIdentifier));
-    });
+    return entries.find((entry) => entry.method === method && entry.path === normalizedPath);
 }

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

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**
- * 注册 HTTP API 文档与通用调用工具
+ * 注册通用 HTTP API 调用工具
  * @param server MCP 服务实例
  * @returns 无返回值
  * @example