ms-vite-plugin 1.4.16 → 1.4.17

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

@@ -6,24 +6,16 @@ export type HttpApiMethod = "GET" | "POST";
  * HTTP API 文档条目
  */
 export type HttpApiDocEntry = {
-    /** 稳定 slug，可用于读取单个接口文档 */
-    slug: string;
-    /** HTTP API 文档绝对路径 */
-    filePath: string;
     /** 接口请求方法 */
     method: HttpApiMethod;
     /** 接口路径 */
     path: string;
     /** 接口标题 */
     title: string;
-    /** 所属一级章节 */
-    section: string;
     /** 文档片段起始行号（1-based） */
     startLine: number;
     /** 文档片段结束行号（1-based） */
     endLine: number;
-    /** 接口完整 markdown 片段 */
-    content: string;
 };
 /**
  * 获取 HTTP API 文档路径
@@ -32,22 +24,6 @@ export type HttpApiDocEntry = {
  * const filePath = getHttpApiDocPath()
  */
 export declare function getHttpApiDocPath(): string;
-/**
- * 读取 HTTP API markdown 文档
- * @returns 返回完整 markdown 文本
- * @example
- * const markdown = await readHttpApiMarkdown()
- */
-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;
 /**
  * 解析 HTTP API markdown 为接口条目
  * @returns 返回按文档顺序排列的接口条目
@@ -56,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

@@ -34,16 +34,12 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getHttpApiDocPath = getHttpApiDocPath;
-exports.readHttpApiMarkdown = readHttpApiMarkdown;
-exports.createHttpApiSlug = createHttpApiSlug;
 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;
 /**
@@ -55,30 +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();
-    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 返回按文档顺序排列的接口条目
@@ -94,14 +66,8 @@ async function getHttpApiDocEntries() {
     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;
@@ -128,15 +94,11 @@ async function getHttpApiDocEntries() {
             }
         }
         entries.push({
-            slug: createHttpApiSlug(method, apiPath),
-            filePath,
             method,
             path: apiPath,
             title,
-            section: currentSection,
             startLine: index + 1,
             endLine: endIndex,
-            content: lines.slice(index, endIndex).join("\n").trim(),
         });
     }
     cachedHttpApiDocEntries = {
@@ -146,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

package/dist/mcp/httpapi-tools.js

@@ -34,35 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerHttpApiTools = registerHttpApiTools;
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const z = __importStar(require("zod/v4"));
 const httpapi_docs_service_1 = require("./httpapi-docs-service");
 const tool_utils_1 = require("./tool-utils");
-/**
- * HTTP API 文档完整资源 URI
- */
-const HTTP_API_DOC_RESOURCE_URI = "kuaijs://httpapi/api";
-const HTTP_API_ENDPOINT_RESOURCE_PREFIX = "kuaijs://httpapi/endpoints";
-/**
- * 格式化 HTTP API 文档搜索摘要
- * @param entry HTTP API 文档条目
- * @param index 列表序号
- * @returns 返回摘要文本
- * @example
- * formatHttpApiDocSummary(entry, 0)
- */
-function formatHttpApiDocSummary(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}`,
-        `uri: ${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
-    ].join("\n");
-}
 /**
  * 标准化并校验 HTTP API 路径输入
  * @param apiPath 用户传入路径
@@ -158,128 +132,16 @@ async function readHttpApiResponseText(response, responseFormat) {
     }
 }
 /**
- * 注册 HTTP API 文档与通用调用工具
+ * 注册通用 HTTP API 调用工具
  * @param server MCP 服务实例
  * @returns 无返回值
  * @example
  * registerHttpApiTools(server)
  */
 function registerHttpApiTools(server) {
-    server.registerResource("http-api-doc", HTTP_API_DOC_RESOURCE_URI, {
-        title: "KuaiJS HTTP API document",
-        mimeType: "text/markdown",
-    }, async () => ({
-        contents: [
-            {
-                uri: HTTP_API_DOC_RESOURCE_URI,
-                mimeType: "text/markdown",
-                text: await (0, httpapi_docs_service_1.readHttpApiMarkdown)(),
-            },
-        ],
-    }));
-    server.registerResource("http-api-endpoint", new mcp_js_1.ResourceTemplate(`${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/{slug}`, {
-        list: async () => {
-            const entries = await (0, httpapi_docs_service_1.getHttpApiDocEntries)();
-            return {
-                resources: entries.map((entry) => ({
-                    uri: `${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
-                    name: `${entry.method} ${entry.path}`,
-                    description: `${entry.title} [${entry.section || "未分组"}] | file: ${entry.filePath}`,
-                    mimeType: "text/markdown",
-                })),
-            };
-        },
-    }), {
-        title: "KuaiJS HTTP API endpoint documents",
-        mimeType: "text/markdown",
-    }, async (_uri, variables) => {
-        const slug = String(variables.slug || "");
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(slug);
-        if (!entry) {
-            throw new Error(`HTTP API 文档不存在: ${slug}`);
-        }
-        return {
-            contents: [
-                {
-                    uri: `${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
-                    mimeType: "text/markdown",
-                    text: entry.content,
-                },
-            ],
-        };
-    });
-    server.registerTool("search_http_api_docs", {
-        title: "Search HTTP API Docs",
-        description: "搜索 HTTP API 文档中声明的接口。调用 http_api_call 前应先用本工具确认接口 method、path、参数和 slug。",
-        inputSchema: {
-            query: z
-                .string()
-                .min(1)
-                .describe("搜索关键词，例如 click、/api/control/click、截图"),
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(20)
-                .optional()
-                .default(8)
-                .describe("返回条数上限，默认 8"),
-        },
-    }, async ({ query, limit }) => {
-        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);
-        return (0, tool_utils_1.createTextToolResult)(matches.length === 0
-            ? `未找到与 "${query}" 匹配的 HTTP API 文档。`
-            : [
-                "HTTP API 文档匹配结果:",
-                "",
-                ...matches.map((entry, index) => formatHttpApiDocSummary(entry, index)),
-            ].join("\n"));
-    });
-    server.registerTool("read_http_api_doc", {
-        title: "Read HTTP API Doc",
-        description: "按 slug 或 path 读取 HTTP API 文档中的接口片段。调用 http_api_call 前应读取目标接口片段，确认参数位置、类型和返回结构。",
-        inputSchema: {
-            identifier: z
-                .string()
-                .min(1)
-                .describe("接口 slug 或 path，例如 get-api-control-click 或 /api/control/click"),
-            method: z
-                .enum(["GET", "POST"])
-                .optional()
-                .describe("可选 HTTP 方法，用于同路径多方法时消歧"),
-        },
-    }, async ({ identifier, method }) => {
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(identifier, method);
-        if (!entry) {
-            return (0, tool_utils_1.createTextToolResult)(`未找到 HTTP API 文档: ${identifier}\n请先调用 search_http_api_docs 搜索可用接口。`, true);
-        }
-        return (0, tool_utils_1.createTextToolResult)([
-            `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"));
-    });
     server.registerTool("http_api_call", {
         title: "HTTP API Call",
-        description: "调用 HTTP API 文档中已声明的接口。使用前应先调用 search_http_api_docs/read_http_api_doc 获取 docSlug，并确认 method、path、query/body 参数；本工具会拒绝 docSlug、method、path 不匹配的调用。",
+        description: "调用 HTTP API 文档中已声明的接口。使用前应直接读取 get_docs_paths 返回的 HTTP API 文档，确认 method、path、query/body 参数；本工具会拒绝文档中未声明的 method/path。",
         inputSchema: {
             method: z
                 .enum(["GET", "POST"])
@@ -288,10 +150,6 @@ function registerHttpApiTools(server) {
                 .string()
                 .min(1)
                 .describe("HTTP API 相对路径，例如 /api/control/click；不能包含 query string"),
-            docSlug: z
-                .string()
-                .min(1)
-                .describe("search_http_api_docs/read_http_api_doc 返回的接口 slug"),
             query: z
                 .record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]))
                 .optional()
@@ -314,21 +172,13 @@ function registerHttpApiTools(server) {
                 .default(30000)
                 .describe("请求超时时间，默认 30000 毫秒"),
         },
-    }, async ({ method, path, docSlug, query, body, responseFormat, timeoutMs, }) => {
+    }, async ({ method, path, query, body, responseFormat, timeoutMs, }) => {
         const apiPath = normalizeHttpApiPath(path);
-        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(docSlug);
+        const entry = await (0, httpapi_docs_service_1.findHttpApiDocEntry)(apiPath, method);
         if (!entry) {
             return (0, tool_utils_1.createTextToolResult)([
-                `HTTP API 文档中不存在该 docSlug: ${docSlug}`,
-                "请先调用 search_http_api_docs 搜索可用接口，再调用 read_http_api_doc 确认参数和 slug。",
-            ].join("\n"), true);
-        }
-        if (entry.method !== method || entry.path !== apiPath) {
-            return (0, tool_utils_1.createTextToolResult)([
-                "HTTP API 调用与文档条目不匹配。",
-                `传入: ${method} ${apiPath} (${docSlug})`,
-                `文档: ${entry.method} ${entry.path} (${entry.slug})`,
-                "请重新调用 read_http_api_doc 确认目标接口。",
+                `HTTP API 文档中不存在该接口: ${method} ${apiPath}`,
+                "请直接读取 get_docs_paths 返回的 HTTP API 文档路径，确认接口 method、path 和参数。",
             ].join("\n"), true);
         }
         if (method === "GET" && body !== undefined) {
@@ -351,7 +201,7 @@ function registerHttpApiTools(server) {
             return (0, tool_utils_1.createTextToolResult)([
                 `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,

package/dist/mcp/tool-utils.d.ts

@@ -1,4 +1,3 @@
-import type { ApiDocsLanguage } from "./types";
 /**
  * MCP 文本响应内容结构
  */
@@ -61,15 +60,3 @@ export declare function resolveRuntimeHttpTarget(): Promise<RuntimeHttpTarget>;
  * formatRuntimeJsonText({ success: true })
  */
 export declare function formatRuntimeJsonText(value: unknown): string;
-/**
- * 格式化单条 API 文档摘要
- * @param language 文档语言
- * @param title 文档标题
- * @param slug 文档 slug
- * @param index 列表序号
- * @param filePath 文档文件绝对路径
- * @returns 返回用于列表展示的文本块
- * @example
- * formatApiDocSummary("js", "Tap", "tap", 0, "/tmp/tap.md")
- */
-export declare function formatApiDocSummary(language: ApiDocsLanguage, title: string, slug: string, index: number, filePath?: string): string;

package/dist/mcp/tool-utils.js

@@ -4,8 +4,6 @@ exports.createTextToolResult = createTextToolResult;
 exports.createRuntimeHttpRequestOptions = createRuntimeHttpRequestOptions;
 exports.resolveRuntimeHttpTarget = resolveRuntimeHttpTarget;
 exports.formatRuntimeJsonText = formatRuntimeJsonText;
-exports.formatApiDocSummary = formatApiDocSummary;
-const docs_service_1 = require("./docs-service");
 const device_config_1 = require("./device-config");
 /**
  * 创建标准 MCP 文本内容对象
@@ -81,22 +79,3 @@ function formatRuntimeJsonText(value) {
     }
     return JSON.stringify(value, null, 2);
 }
-/**
- * 格式化单条 API 文档摘要
- * @param language 文档语言
- * @param title 文档标题
- * @param slug 文档 slug
- * @param index 列表序号
- * @param filePath 文档文件绝对路径
- * @returns 返回用于列表展示的文本块
- * @example
- * formatApiDocSummary("js", "Tap", "tap", 0, "/tmp/tap.md")
- */
-function formatApiDocSummary(language, title, slug, index, filePath) {
-    return [
-        `${index + 1}. ${title}`,
-        `slug: ${slug}`,
-        `uri: ${(0, docs_service_1.getDocUri)(language, slug)}`,
-        ...(filePath ? [`path: ${filePath}`] : []),
-    ].join("\n");
-}

package/dist/mcp/types.d.ts

@@ -13,19 +13,6 @@ export type DeviceConfig = {
  * 文档语言类型
  */
 export type ApiDocsLanguage = "js" | "js_zh" | "python";
-/**
- * 文档条目结构
- */
-export type ApiDocItem = {
-    /** 文档分类（即文件名，不含 .md） */
-    slug: string;
-    /** 文档标题（优先取首个 markdown 标题） */
-    title: string;
-    /** 文档全文 */
-    content: string;
-    /** 文档目录绝对路径 */
-    filePath: string;
-};
 /**
  * 文档语言显示名映射
  */

package/docs/AGENTS.md

@@ -36,42 +36,38 @@
 
 ## 文档优先
 
-回答快点JS API 问题或编写脚本前，必须先查询目标语言对应的快点JS文档。
+回答快点JS API 问题或编写脚本前，必须先获取本地文档路径并直接读取目标语言对应的 markdown 文件。文档随 `ms-vite-plugin` npm 包发布，路径一定存在，不需要额外的文档查询或读取 API。
 
 MCP 入口：
 
-1. 使用 `get_docs_paths` 获取本地文档路径。
-2. 使用 `search_api_docs` 搜索相关模块或 API，按需传 `language`。
-3. 使用 `read_api_doc` 读取完整文档，按需传 `language`。
-4. 只依据已确认的文档内容回答或编写代码。
+1. 使用 `get_docs_paths` 获取本地文档根目录、语言 API 文档目录和 HTTP API 文档路径。
+2. 直接读取对应 markdown 文件。
+3. 只依据已读取的本地文档内容回答或编写代码。
 
 CLI 入口：
 
-1. 使用 `npx ms docs paths` 获取本地文档路径。
-2. 使用 `npx ms docs search <query> --language js_zh|js|python` 搜索语言 API 文档。
-3. 使用 `npx ms docs read <slug> --language js_zh|js|python` 读取完整文档。
-4. 只使用文档中已经确认的 API。
+1. 使用 `npx ms docs paths` 获取同一组本地文档路径。
+2. 直接读取对应 markdown 文件。
+3. 只使用文档中已经确认的 API。
 
 ## HTTP API 工作流
 
-调用设备 HTTP API 前，必须先查询 HTTP API 文档。不要猜测接口路径、请求方法或参数名称。
+调用设备 HTTP API 前，必须先直接读取 HTTP API 文档。不要猜测接口路径、请求方法或参数名称。
 
 MCP 入口：
 
-1. 使用 `search_http_api_docs` 搜索目标能力、中文标题或接口路径。
-2. 使用 `read_http_api_doc` 读取目标接口片段。
-3. 确认 `method`、`path`、参数位置、参数类型和返回结构。
-4. 使用 `http_api_call` 传入文档返回的 `docSlug`、`method`、`path`、`query` 或 `body`。
+1. 使用 `get_docs_paths` 获取 HTTP API 文档路径。
+2. 直接读取 HTTP API markdown，确认 `method`、`path`、参数位置、参数类型和返回结构。
+3. 使用 `http_api_call` 传入 `method`、`path`、`query` 或 `body`。
 
-`http_api_call` 只能调用 HTTP API 文档中已声明的接口，并且会校验 `docSlug`、`method`、`path` 是否匹配。
+`http_api_call` 只能调用 HTTP API 文档中已声明的 `method` 和 `path`。
 
 CLI 入口：
 
 1. 使用 `npx ms docs paths` 获取 HTTP API 文档路径。
-2. 使用 `npx ms http-docs search <query>` 搜索目标接口。
-3. 使用 `npx ms http-docs read <identifier> --method GET|POST` 读取目标接口片段。
-4. 使用 `npx ms http-call -i <device-ip> --port <port> --method <method> --path <path> --doc-slug <slug>` 调用明确存在的接口。
-5. 不要把未确认的路径当成可用接口。
+2. 直接读取 HTTP API markdown，确认接口存在和参数要求。
+3. 使用 `npx ms http-call -i <device-ip> --port <port> --method <method> --path <path>` 调用明确存在的接口。
+4. 不要把未确认的路径当成可用接口。
 
 ## 设备与运行
 
@@ -92,6 +88,7 @@ CLI 入口可以使用：
 ```bash
 npx ms --help
 npx ms docs paths
+npx ms http-call -i <device-ip> --port <port> --method GET --path <path>
 npx ms run -i <device-ip> --port <port>
 npx ms run-ui -i <device-ip> --port <port>
 npx ms screenshot -i <device-ip> --port <port> --format file --output <path>
@@ -106,18 +103,13 @@ npx ms stop -i <device-ip> --port <port>
 npx ms package
 ```
 
-`build`、`package`、`run`、`run-ui` 需要在快点JS项目根目录运行，项目根目录通常包含 `package.json` 和 `scripts/`。文档、HTTP API 查询/调用、截图、节点、日志、OCR、图片处理、停止和 WS 状态命令可以在任意目录使用。不要用未确认的通用 Node.js、浏览器或 Python 命令替代 MCP 或项目自带 `ms` CLI。
+`build`、`package`、`run`、`run-ui` 需要在快点JS项目根目录运行，项目根目录通常包含 `package.json` 和 `scripts/`。文档路径、HTTP API 调用、截图、节点、日志、OCR、图片处理、停止和 WS 状态命令可以在任意目录使用。不要用未确认的通用 Node.js、浏览器或 Python 命令替代 MCP 或项目自带 `ms` CLI。
 
 ## 工具分组
 
 ### 文档
 
 - `get_docs_paths`
-- `list_api_docs`
-- `search_api_docs`
-- `read_api_doc`
-- `search_http_api_docs`
-- `read_http_api_doc`
 
 ### 工作区与运行
 
@@ -146,12 +138,12 @@ npx ms package
 
 - `http_api_call`
 
-控制、HID、IME、镜像、配置、当前应用、运行脚本等普通设备 HTTP API 通过 `search_http_api_docs`、`read_http_api_doc` 和 `http_api_call` 使用，不要恢复为大量独立工具。
+控制、HID、IME、镜像、配置、当前应用、运行脚本等普通设备 HTTP API 通过 `get_docs_paths` 和 `http_api_call` 使用，不要恢复为大量独立工具。
 
 ## 工具选择规则
 
-- 写快点JS脚本代码：先设置或确认文档语言，再查语言 API 文档。
-- 调设备 HTTP API：先查 HTTP API 文档，再调用 `http_api_call` 或 `npx ms http-call`。
+- 写快点JS脚本代码：先确认项目语言，再读取本地语言 API 文档。
+- 调设备 HTTP API：先读取本地 HTTP API 文档，再调用 `http_api_call` 或 `npx ms http-call`。
 - 获取截图：使用 `take_screenshot` 或 `npx ms screenshot`。
 - 获取节点 XML：使用 `get_node_source` 或 `npx ms source --mode 1`。
 - 查看日志：使用 `get_logs` 或 `npx ms logs`。
@@ -171,7 +163,7 @@ OCR 识别使用 `ocr_recognize`，不要手写未确认的 OCR 调用链路。
 
 - `ocr_recognize` 支持 `appleocr` 和 `paddleocr`。
 - 默认使用 `appleocr`。
-- 数字识别优先使用 `appleocr`，因为 PaddleOCR 文档未提供独立 numbers 模式。
+- 数字识别优先使用 `appleocr`。
 - PaddleOCR 识别和查找方法会自动加载所需模型，不需要先手动调用 `loadV5`。
 
 ## 验证要求
@@ -189,12 +181,12 @@ UI 预览发起后不需要长时间等待结果，可以通过截图查看当
 
 ## 禁止事项
 
-- 不要在没有查询文档的情况下回答 API 用法或编写 API 调用代码。
+- 不要在没有读取本地文档的情况下回答 API 用法或编写 API 调用代码。
 - 不要臆造快点JS API、对象、参数、返回值或运行机制。
 - 不要混用 JavaScript 与 Python API。
 - 不要把快点JS当成普通 Node.js、浏览器或通用 Python 环境。
 - 不要对快点JS Python 脚本运行 `py_compile` 或其他 CPython 编译校验。
-- 不要在没有查询 HTTP API 文档的情况下调用 `http_api_call` 或 `ms http-call`。
+- 不要在没有读取本地 HTTP API 文档的情况下调用 `http_api_call` 或 `ms http-call`。
 - 不要把完整 URL 传给 `http_api_call.path`，只能传 `/api/...`、`/logger/...`、`/mirror/...` 这类相对路径。
 - 不要调用 HTTP API 文档中未声明的接口。
 - 不要用 `http_api_call` 替代截图落文件、节点 XML 落文件、日志缓存、项目打包和项目运行等专用工具。