ms-vite-plugin 1.4.16 → 1.4.17

package/dist/cli.js

@@ -148,16 +148,6 @@ function parseCliChoice(value, defaultValue, choices, name) {
     }
     return text;
 }
-/**
- * 解析文档语言参数
- * @param value 用户传入的语言
- * @returns 返回文档语言
- * @example
- * parseDocsLanguageOption("js_zh")
- */
-function parseDocsLanguageOption(value) {
-    return parseCliChoice(value, "js_zh", ["js", "js_zh", "python"], "language");
-}
 /**
  * 解析 HTTP API 请求方法
  * @param value 用户传入的方法
@@ -169,19 +159,6 @@ function parseHttpApiMethodOption(value) {
     const method = value?.trim().toUpperCase();
     return parseCliChoice(method, "GET", ["GET", "POST"], "method");
 }
-/**
- * 解析可选 HTTP API 请求方法
- * @param value 用户传入的方法
- * @returns 返回 HTTP API 方法或 undefined
- * @example
- * parseOptionalHttpApiMethodOption("POST")
- */
-function parseOptionalHttpApiMethodOption(value) {
-    if (!value?.trim()) {
-        return undefined;
-    }
-    return parseHttpApiMethodOption(value);
-}
 /**
  * 解析设备 HTTP 地址
  * @param options 设备命令选项
@@ -220,44 +197,6 @@ async function writeOrPrintText(text, output, savedLabel) {
     }
     console.log(text);
 }
-/**
- * 格式化 API 文档摘要
- * @param language 文档语言
- * @param title 文档标题
- * @param slug 文档 slug
- * @param index 序号
- * @param filePath 文档文件绝对路径
- * @returns 返回摘要文本
- * @example
- * formatCliApiDocSummary("js_zh", "设备", "device", 0, "/tmp/device.md")
- */
-function formatCliApiDocSummary(language, title, slug, index, filePath) {
-    return [
-        `${index + 1}. ${title}`,
-        `slug: ${slug}`,
-        `uri: ${(0, docs_service_1.getDocUri)(language, slug)}`,
-        ...(filePath ? [`path: ${filePath}`] : []),
-    ].join("\n");
-}
-/**
- * 格式化 HTTP API 文档摘要
- * @param entry HTTP API 文档条目
- * @param index 序号
- * @returns 返回摘要文本
- * @example
- * formatCliHttpApiDocSummary(entry, 0)
- */
-function formatCliHttpApiDocSummary(entry, index) {
-    return [
-        `${index + 1}. ${entry.title}`,
-        `method: ${entry.method}`,
-        `path: ${entry.path}`,
-        `slug: ${entry.slug}`,
-        `section: ${entry.section || "未分组"}`,
-        `lines: ${entry.startLine}-${entry.endLine}`,
-        `file: ${entry.filePath}`,
-    ].join("\n");
-}
 /**
  * 格式化 CLI 文档路径清单
  * @returns 返回本地文档路径文本
@@ -271,7 +210,7 @@ function formatCliDocsPathsText() {
         `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 路径；docs/http-docs 命令用于定位具体文档。",
+        "说明: 直接读取上述 markdown 路径。",
     ].join("\n");
 }
 /**
@@ -642,30 +581,6 @@ async function logsCommand(options) {
         process.exit(1);
     }
 }
-/**
- * docs list 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms docs list --language js_zh
- */
-async function docsListCommand(options) {
-    try {
-        const language = parseDocsLanguageOption(options.language);
-        const docs = await (0, docs_service_1.getApiDocsByLanguage)(language);
-        const lines = docs.map((doc, index) => formatCliApiDocSummary(language, doc.title, doc.slug, index, doc.filePath));
-        const text = [
-            `文档语言: ${language} (${types_1.DOC_LANGUAGE_LABELS[language]})`,
-            "",
-            ...(lines.length > 0 ? lines : ["无可用文档"]),
-        ].join("\n");
-        await writeOrPrintText(text, options.output, "文档列表已保存");
-    }
-    catch (error) {
-        console.error("❌ 列出文档失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
 /**
  * docs paths 命令处理函数
  * @param options 命令选项
@@ -682,186 +597,21 @@ async function docsPathsCommand(options) {
         process.exit(1);
     }
 }
-/**
- * docs search 命令处理函数
- * @param query 搜索词
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms docs search 点击 --language js_zh --limit 5
- */
-async function docsSearchCommand(query, options) {
-    try {
-        const language = parseDocsLanguageOption(options.language);
-        const limit = parseCliInteger(options.limit, 5, "limit", 1, 20);
-        const normalizedQuery = query.toLowerCase();
-        const docs = await (0, docs_service_1.getApiDocsByLanguage)(language);
-        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
-            ? `文档语言: ${language} (${types_1.DOC_LANGUAGE_LABELS[language]})\n未找到与 "${query}" 匹配的文档。`
-            : [
-                `文档语言: ${language} (${types_1.DOC_LANGUAGE_LABELS[language]})`,
-                "",
-                ...matches.map((doc, index) => formatCliApiDocSummary(language, doc.title, doc.slug, index, doc.filePath)),
-            ].join("\n");
-        await writeOrPrintText(text, options.output, "文档搜索结果已保存");
-    }
-    catch (error) {
-        console.error("❌ 搜索文档失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * docs read 命令处理函数
- * @param slug 文档 slug
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms docs read action --language js_zh
- */
-async function docsReadCommand(slug, options) {
-    try {
-        const language = parseDocsLanguageOption(options.language);
-        const docs = await (0, docs_service_1.getApiDocsByLanguage)(language);
-        const target = docs.find((doc) => doc.slug === slug);
-        if (!target) {
-            throw new Error(`未找到文档 ${slug}.md（语言: ${language}）。`);
-        }
-        const text = [
-            `标题: ${target.title}`,
-            `语言: ${language}`,
-            `URI: ${(0, docs_service_1.getDocUri)(language, target.slug)}`,
-            `path: ${target.filePath}`,
-            "",
-            target.content,
-        ].join("\n");
-        await writeOrPrintText(text, options.output, "文档已保存");
-    }
-    catch (error) {
-        console.error("❌ 读取文档失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * http-docs list 命令处理函数
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms http-docs list
- */
-async function httpDocsListCommand(options) {
-    try {
-        const entries = await (0, httpapi_docs_service_1.getHttpApiDocEntries)();
-        const text = [
-            "HTTP API 文档列表:",
-            "",
-            ...entries.map((entry, index) => formatCliHttpApiDocSummary(entry, index)),
-        ].join("\n");
-        await writeOrPrintText(text, options.output, "HTTP API 文档列表已保存");
-    }
-    catch (error) {
-        console.error("❌ 列出 HTTP API 文档失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * http-docs search 命令处理函数
- * @param query 搜索词
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms http-docs search 截图 --limit 8
- */
-async function httpDocsSearchCommand(query, options) {
-    try {
-        const limit = parseCliInteger(options.limit, 8, "limit", 1, 20);
-        const normalizedQuery = query.toLowerCase();
-        const entries = await (0, httpapi_docs_service_1.getHttpApiDocEntries)();
-        const matches = entries
-            .map((entry) => ({
-            entry,
-            score: (0, httpapi_docs_service_1.scoreHttpApiDocEntry)(entry, normalizedQuery),
-        }))
-            .filter((item) => item.score > 0)
-            .sort((a, b) => b.score - a.score ||
-            a.entry.path.localeCompare(b.entry.path) ||
-            a.entry.method.localeCompare(b.entry.method))
-            .slice(0, limit)
-            .map((item) => item.entry);
-        const text = matches.length === 0
-            ? `未找到与 "${query}" 匹配的 HTTP API 文档。`
-            : [
-                "HTTP API 文档匹配结果:",
-                "",
-                ...matches.map((entry, index) => formatCliHttpApiDocSummary(entry, index)),
-            ].join("\n");
-        await writeOrPrintText(text, options.output, "HTTP API 文档搜索结果已保存");
-    }
-    catch (error) {
-        console.error("❌ 搜索 HTTP API 文档失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
-/**
- * http-docs read 命令处理函数
- * @param identifier slug 或接口路径
- * @param options 命令选项
- * @returns 请求完成后退出
- * @example
- * ms http-docs read /api/source --method GET
- */
-async function httpDocsReadCommand(identifier, options) {
-    try {
-        const method = parseOptionalHttpApiMethodOption(options.method);
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(identifier, method);
-        if (!entry) {
-            throw new Error(`未找到 HTTP API 文档: ${identifier}`);
-        }
-        const text = [
-            `title: ${entry.title}`,
-            `method: ${entry.method}`,
-            `path: ${entry.path}`,
-            `slug: ${entry.slug}`,
-            `section: ${entry.section || "未分组"}`,
-            `lines: ${entry.startLine}-${entry.endLine}`,
-            `file: ${entry.filePath}`,
-            "",
-            entry.content,
-        ].join("\n");
-        await writeOrPrintText(text, options.output, "HTTP API 文档已保存");
-    }
-    catch (error) {
-        console.error("❌ 读取 HTTP API 文档失败:", error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-}
 /**
  * http-call 命令处理函数
  * @param options 命令选项
  * @returns 请求完成后退出
  * @example
- * ms http-call --ip 192.168.1.100 --method GET --path /api/status --doc-slug get-api-status
+ * ms http-call --ip 192.168.1.100 --method GET --path /api/status
  */
 async function httpCallCommand(options) {
     try {
         const target = parseDeviceHttpTarget(options);
         const method = parseHttpApiMethodOption(options.method);
         const apiPath = normalizeCliHttpApiPath(options.path ?? "");
-        const docSlug = options.docSlug?.trim();
-        if (!docSlug) {
-            throw new Error("请通过 --doc-slug 指定 HTTP API 文档 slug。");
-        }
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(docSlug);
+        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(apiPath, method);
         if (!entry) {
-            throw new Error(`HTTP API 文档中不存在该 docSlug: ${docSlug}`);
-        }
-        if (entry.method !== method || entry.path !== apiPath) {
-            throw new Error(`HTTP API 调用与文档条目不匹配。传入 ${method} ${apiPath}，文档 ${entry.method} ${entry.path}。`);
+            throw new Error(`HTTP API 文档中不存在该接口: ${method} ${apiPath}。请先读取 docs paths 返回的 HTTP API 文档路径。`);
         }
         const query = parseJsonRecordOption(options.query, "query");
         const body = parseJsonBodyOption(options.body);
@@ -886,7 +636,7 @@ async function httpCallCommand(options) {
             const text = [
                 `HTTP API 调用${response.ok ? "成功" : "失败"}: ${method} ${apiPath}`,
                 `设备: ${target.label}`,
-                `文档: ${entry.title} (${entry.slug}, lines ${entry.startLine}-${entry.endLine})`,
+                `文档: ${entry.title} (lines ${entry.startLine}-${entry.endLine})`,
                 `状态码: ${response.status}`,
                 "",
                 responseText,
@@ -1426,56 +1176,12 @@ commander_1.program
 // API 文档命令
 const docsCommand = commander_1.program
     .command("docs")
-    .description("查询 KuaiJS JS/中文/Python API 文档");
+    .description("显示 KuaiJS 本地文档路径");
 docsCommand
     .command("paths")
     .description("显示 KuaiJS 本地文档路径")
     .option("--output <output>", "输出文件路径（可选）")
     .action(docsPathsCommand);
-docsCommand
-    .command("list")
-    .description("列出 API 文档")
-    .option("--language <language>", "文档语言: js|js_zh|python", "js_zh")
-    .option("--output <output>", "输出文件路径（可选）")
-    .action(docsListCommand);
-docsCommand
-    .command("search")
-    .description("搜索 API 文档")
-    .argument("<query>", "搜索关键字")
-    .option("--language <language>", "文档语言: js|js_zh|python", "js_zh")
-    .option("--limit <limit>", "返回条数上限，范围 1..20", "5")
-    .option("--output <output>", "输出文件路径（可选）")
-    .action(docsSearchCommand);
-docsCommand
-    .command("read")
-    .description("读取 API 文档")
-    .argument("<slug>", "文档 slug（文件名，不含 .md）")
-    .option("--language <language>", "文档语言: js|js_zh|python", "js_zh")
-    .option("--output <output>", "输出文件路径（可选）")
-    .action(docsReadCommand);
-// HTTP API 文档命令
-const httpDocsCommand = commander_1.program
-    .command("http-docs")
-    .description("查询 KuaiJS 设备 HTTP API 文档");
-httpDocsCommand
-    .command("list")
-    .description("列出 HTTP API 文档条目")
-    .option("--output <output>", "输出文件路径（可选）")
-    .action(httpDocsListCommand);
-httpDocsCommand
-    .command("search")
-    .description("搜索 HTTP API 文档")
-    .argument("<query>", "搜索关键字、标题或接口路径")
-    .option("--limit <limit>", "返回条数上限，范围 1..20", "8")
-    .option("--output <output>", "输出文件路径（可选）")
-    .action(httpDocsSearchCommand);
-httpDocsCommand
-    .command("read")
-    .description("读取 HTTP API 文档条目")
-    .argument("<identifier>", "接口 slug 或 path")
-    .option("--method <method>", "HTTP 方法，用于同路径多方法时消歧: GET|POST")
-    .option("--output <output>", "输出文件路径（可选）")
-    .action(httpDocsReadCommand);
 // HTTP API 调用命令
 commander_1.program
     .command("http-call")
@@ -1484,7 +1190,6 @@ commander_1.program
     .option("--port <port>", "设备端口", "9800")
     .requiredOption("--method <method>", "HTTP 方法: GET|POST")
     .requiredOption("--path <path>", "HTTP API 相对路径，例如 /api/status")
-    .requiredOption("--doc-slug <docSlug>", "http-docs 返回的接口 slug")
     .option("--query <query>", "JSON 对象 query 参数")
     .option("--body <body>", "JSON 请求体；普通字符串会作为 JSON 字符串提交")
     .option("--response-format <responseFormat>", "响应格式: json|text", "json")

package/dist/mcp/doc-tools.js

@@ -1,40 +1,6 @@
 "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.registerDocTools = registerDocTools;
-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");
@@ -52,7 +18,7 @@ function formatDocsPathsText() {
         `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 路径；search/read 工具用于定位具体文档。",
+        "说明: 直接读取上述 markdown 路径。",
     ].join("\n");
 }
 /**
@@ -70,88 +36,4 @@ function registerDocTools(server) {
     }, async () => {
         return (0, tool_utils_1.createTextToolResult)(formatDocsPathsText());
     });
-    server.registerTool("list_api_docs", {
-        title: "List API Docs",
-        description: "列出指定语言下可用的 API 文档；不传 language 时默认 js_zh。",
-        inputSchema: {
-            language: z
-                .enum(["js", "js_zh", "python"])
-                .optional()
-                .describe("可选语言，不传默认 js_zh"),
-        },
-    }, async ({ language }) => {
-        const activeLanguage = language ?? "js_zh";
-        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, doc.filePath));
-        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: "在指定语言文档中按关键字搜索；不传 language 时默认 js_zh。",
-        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("可选语言，不传默认 js_zh"),
-        },
-    }, async ({ query, limit, language }) => {
-        const activeLanguage = language ?? "js_zh";
-        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, doc.filePath)),
-            ].join("\n");
-        return (0, tool_utils_1.createTextToolResult)(text);
-    });
-    server.registerTool("read_api_doc", {
-        title: "Read API Doc",
-        description: "读取指定语言下某个文档的完整 markdown 内容；不传 language 时默认 js_zh。",
-        inputSchema: {
-            slug: z.string().min(1).describe("文档 slug（文件名，不含 .md）"),
-            language: z
-                .enum(["js", "js_zh", "python"])
-                .optional()
-                .describe("可选语言，不传默认 js_zh"),
-        },
-    }, async ({ slug, language }) => {
-        const activeLanguage = language ?? "js_zh";
-        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}`,
-            `语言: ${activeLanguage}`,
-            `URI: ${(0, docs_service_1.getDocUri)(activeLanguage, target.slug)}`,
-            `path: ${target.filePath}`,
-            "",
-            target.content,
-        ].join("\n"));
-    });
 }

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

@@ -1,4 +1,4 @@
-import type { ApiDocItem, ApiDocsLanguage } from "./types";
+import type { ApiDocsLanguage } from "./types";
 /**
  * 获取 docs 根目录
  * @returns 返回 docs 目录绝对路径
@@ -14,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

@@ -35,10 +35,6 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 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"));
 /**
  * 获取 docs 根目录
@@ -65,64 +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);
-    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}`;
-}