ms-vite-plugin 1.1.21 → 1.1.23

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

@@ -23,13 +23,6 @@ export type HttpApiDocEntry = {
     /** 接口完整 markdown 片段 */
     content: string;
 };
-/**
- * 获取 HTTP API 文档路径
- * @returns 返回 docs/httpapi/api.md 的绝对路径
- * @example
- * const filePath = getHttpApiDocPath()
- */
-export declare function getHttpApiDocPath(): string;
 /**
  * 读取 HTTP API markdown 文档
  * @returns 返回完整 markdown 文本

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

@@ -33,7 +33,6 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getHttpApiDocPath = getHttpApiDocPath;
 exports.readHttpApiMarkdown = readHttpApiMarkdown;
 exports.createHttpApiSlug = createHttpApiSlug;
 exports.getHttpApiDocEntries = getHttpApiDocEntries;
@@ -41,14 +40,19 @@ 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;
 /**
  * 获取 HTTP API 文档路径
- * @returns 返回 docs/httpapi/api.md 的绝对路径
+ * @returns 返回 HTTP API 文档绝对路径
  * @example
  * const filePath = getHttpApiDocPath()
  */
 function getHttpApiDocPath() {
-    return path.resolve(__dirname, "..", "..", "docs", "httpapi", "api.md");
+    return path.resolve(__dirname, "..", "..", ...HTTP_API_DOC_RELATIVE_PATH);
 }
 /**
  * 读取 HTTP API markdown 文档
@@ -59,7 +63,7 @@ function getHttpApiDocPath() {
 async function readHttpApiMarkdown() {
     const filePath = getHttpApiDocPath();
     if (!(await fsExtra.pathExists(filePath))) {
-        throw new Error(`HTTP API 文档不存在: ${filePath}`);
+        throw new Error("HTTP API 文档不可用。");
     }
     return fsExtra.readFile(filePath, "utf8");
 }
@@ -73,8 +77,6 @@ async function readHttpApiMarkdown() {
  */
 function createHttpApiSlug(method, apiPath) {
     return `${method.toLowerCase()}-${apiPath}`
-        .replace(/^get-\//, "get-")
-        .replace(/^post-\//, "post-")
         .replace(/[^a-zA-Z0-9]+/g, "-")
         .replace(/^-+|-+$/g, "")
         .toLowerCase();
@@ -86,18 +88,26 @@ function createHttpApiSlug(method, apiPath) {
  * const entries = await getHttpApiDocEntries()
  */
 async function getHttpApiDocEntries() {
-    const markdown = await readHttpApiMarkdown();
+    const filePath = getHttpApiDocPath();
+    const stat = await fsExtra.stat(filePath).catch(() => null);
+    if (!stat) {
+        throw new Error("HTTP API 文档不可用。");
+    }
+    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(/^#\s+(.+)$/);
+        const sectionMatch = line.match(HTTP_API_SECTION_PATTERN);
         if (sectionMatch) {
             currentSection = sectionMatch[1]?.trim() ?? "";
             continue;
         }
-        const titleMatch = line.match(/^##\s+(.+)$/);
+        const titleMatch = line.match(HTTP_API_TITLE_PATTERN);
         if (!titleMatch) {
             continue;
         }
@@ -105,7 +115,7 @@ async function getHttpApiDocEntries() {
         let method = null;
         let apiPath = "";
         for (let cursor = index + 1; cursor < Math.min(lines.length, index + 8); cursor += 1) {
-            const endpointMatch = (lines[cursor] ?? "").match(/^(GET|POST)\s+(\/\S+)/);
+            const endpointMatch = (lines[cursor] ?? "").match(HTTP_API_ENDPOINT_PATTERN);
             if (endpointMatch) {
                 method = endpointMatch[1];
                 apiPath = endpointMatch[2] ?? "";
@@ -117,7 +127,7 @@ async function getHttpApiDocEntries() {
         }
         let endIndex = lines.length;
         for (let cursor = index + 1; cursor < lines.length; cursor += 1) {
-            if (/^##\s+/.test(lines[cursor] ?? "")) {
+            if (HTTP_API_TITLE_PATTERN.test(lines[cursor] ?? "")) {
                 endIndex = cursor;
                 break;
             }
@@ -133,6 +143,10 @@ async function getHttpApiDocEntries() {
             content: lines.slice(index, endIndex).join("\n").trim(),
         });
     }
+    cachedHttpApiDocEntries = {
+        mtimeMs: stat.mtimeMs,
+        entries,
+    };
     return entries;
 }
 /**
@@ -183,6 +197,7 @@ async function findHttpApiDocEntry(identifier, method) {
     return entries.find((entry) => {
         const methodMatches = method ? entry.method === method : true;
         return (methodMatches &&
-            (entry.slug === normalizedIdentifier || entry.path === normalizedIdentifier));
+            (entry.slug === normalizedIdentifier ||
+                entry.path === normalizedIdentifier));
     });
 }

package/dist/mcp/httpapi-tools.js

@@ -42,6 +42,7 @@ 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 文档条目
@@ -58,7 +59,7 @@ function formatHttpApiDocSummary(entry, index) {
         `slug: ${entry.slug}`,
         `section: ${entry.section || "未分组"}`,
         `lines: ${entry.startLine}-${entry.endLine}`,
-        `uri: kuaijs://httpapi/endpoints/${entry.slug}`,
+        `uri: ${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
     ].join("\n");
 }
 /**
@@ -100,6 +101,41 @@ function appendQueryParams(url, query) {
         url.searchParams.set(key, String(value));
     }
 }
+/**
+ * 构建 JSON HTTP 请求体
+ * @param body 工具调用传入的 body
+ * @returns 返回可直接用于 fetch 的请求体和头
+ * @example
+ * createHttpRequestBody({ actions: [] })
+ */
+function createHttpRequestBody(body) {
+    if (body === undefined) {
+        return {};
+    }
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (typeof body === "string") {
+        const trimmedBody = body.trim();
+        try {
+            JSON.parse(trimmedBody);
+            return {
+                headers,
+                requestBody: trimmedBody,
+            };
+        }
+        catch {
+            return {
+                headers,
+                requestBody: JSON.stringify(body),
+            };
+        }
+    }
+    return {
+        headers,
+        requestBody: JSON.stringify(body),
+    };
+}
 /**
  * 读取响应体并按要求格式化
  * @param response fetch 响应对象
@@ -140,12 +176,12 @@ function registerHttpApiTools(server) {
             },
         ],
     }));
-    server.registerResource("http-api-endpoint", new mcp_js_1.ResourceTemplate("kuaijs://httpapi/endpoints/{slug}", {
+    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: `kuaijs://httpapi/endpoints/${entry.slug}`,
+                    uri: `${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
                     name: `${entry.method} ${entry.path}`,
                     description: `${entry.title} [${entry.section || "未分组"}]`,
                     mimeType: "text/markdown",
@@ -164,7 +200,7 @@ function registerHttpApiTools(server) {
         return {
             contents: [
                 {
-                    uri: `kuaijs://httpapi/endpoints/${entry.slug}`,
+                    uri: `${HTTP_API_ENDPOINT_RESOURCE_PREFIX}/${entry.slug}`,
                     mimeType: "text/markdown",
                     text: entry.content,
                 },
@@ -173,7 +209,7 @@ function registerHttpApiTools(server) {
     });
     server.registerTool("search_http_api_docs", {
         title: "Search HTTP API Docs",
-        description: "搜索 docs/httpapi/api.md 中声明的 HTTP API。调用 http_api_call 前应先用本工具确认接口 method、path、参数和 slug。",
+        description: "搜索 HTTP API 文档中声明的接口。调用 http_api_call 前应先用本工具确认接口 method、path、参数和 slug。",
         inputSchema: {
             query: z
                 .string()
@@ -203,16 +239,16 @@ function registerHttpApiTools(server) {
             .slice(0, limit)
             .map((item) => item.entry);
         return (0, tool_utils_1.createTextToolResult)(matches.length === 0
-            ? `未找到与 "${query}" 匹配的 HTTP API 文档。\n文档: ${(0, httpapi_docs_service_1.getHttpApiDocPath)()}`
+            ? `未找到与 "${query}" 匹配的 HTTP API 文档。`
             : [
-                `HTTP API 文档: ${(0, httpapi_docs_service_1.getHttpApiDocPath)()}`,
+                "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 读取 docs/httpapi/api.md 中某个接口的完整片段。调用 http_api_call 前应读取目标接口片段，确认参数位置、类型和返回结构。",
+        description: "按 slug 或 path 读取 HTTP API 文档中的接口片段。调用 http_api_call 前应读取目标接口片段，确认参数位置、类型和返回结构。",
         inputSchema: {
             identifier: z
                 .string()
@@ -241,7 +277,7 @@ function registerHttpApiTools(server) {
     });
     server.registerTool("http_api_call", {
         title: "HTTP API Call",
-        description: "调用 docs/httpapi/api.md 中已声明的 HTTP API。使用前应先调用 search_http_api_docs/read_http_api_doc 获取 docSlug，并确认 method、path、query/body 参数；本工具会拒绝 docSlug、method、path 不匹配的调用。",
+        description: "调用 HTTP API 文档中已声明的接口。使用前应先调用 search_http_api_docs/read_http_api_doc 获取 docSlug，并确认 method、path、query/body 参数；本工具会拒绝 docSlug、method、path 不匹配的调用。",
         inputSchema: {
             method: z
                 .enum(["GET", "POST"])
@@ -261,7 +297,7 @@ function registerHttpApiTools(server) {
             body: z
                 .unknown()
                 .optional()
-                .describe("POST 请求体；对象会按 JSON 提交"),
+                .describe("POST 请求体；始终按 JSON 提交。推荐传 JSON 对象；JSON 字符串会按原 JSON 提交，普通字符串会作为 JSON 字符串值提交。"),
             responseFormat: z
                 .enum(["json", "text"])
                 .optional()
@@ -302,22 +338,11 @@ function registerHttpApiTools(server) {
         const controller = new AbortController();
         const timeout = setTimeout(() => controller.abort(), timeoutMs);
         try {
-            const headers = {};
-            let requestBody;
-            if (body !== undefined) {
-                if (typeof body === "string") {
-                    requestBody = body;
-                    headers["Content-Type"] = "text/plain; charset=utf-8";
-                }
-                else {
-                    requestBody = JSON.stringify(body);
-                    headers["Content-Type"] = "application/json";
-                }
-            }
+            const { headers, requestBody } = createHttpRequestBody(body);
             const response = await fetch(url.toString(), {
                 method,
                 signal: controller.signal,
-                headers: Object.keys(headers).length > 0 ? headers : undefined,
+                headers,
                 body: requestBody,
             });
             const responseText = await readHttpApiResponseText(response, responseFormat);

package/dist/mcp/runtime-tools.js

@@ -44,6 +44,23 @@ const device_config_1 = require("./device-config");
 const device_log_1 = require("./device-log");
 const project_2 = require("./project");
 const tool_utils_1 = require("./tool-utils");
+/**
+ * 解析工具输出文件路径
+ * @param outputPath 用户指定的可选输出路径
+ * @param fileNamePrefix 临时文件名前缀
+ * @param extension 文件扩展名（不含点）
+ * @returns 返回最终输出文件绝对路径
+ * @example
+ * resolveOutputPath(undefined, "ms-mcp-screenshot", "jpg")
+ */
+function resolveOutputPath(outputPath, fileNamePrefix, extension) {
+    if (outputPath && outputPath.trim()) {
+        return path.resolve(outputPath.trim());
+    }
+    return path.join(os.tmpdir(), `${fileNamePrefix}-${Date.now()}-${Math.random()
+        .toString(36)
+        .slice(2, 8)}.${extension}`);
+}
 /**
  * 注册设备与项目执行工具
  * @param server MCP 服务实例
@@ -167,11 +184,7 @@ function registerRuntimeTools(server) {
             return (0, tool_utils_1.createTextToolResult)(`截图成功: ${target.label}\nformat: base64\n${base64}`);
         }
         const image = await (0, project_1.getScreenshotOnDevice)(requestOptions);
-        const targetPath = outputPath && outputPath.trim()
-            ? path.resolve(outputPath.trim())
-            : path.join(os.tmpdir(), `ms-mcp-screenshot-${Date.now()}-${Math.random()
-                .toString(36)
-                .slice(2, 8)}.jpg`);
+        const targetPath = resolveOutputPath(outputPath, "ms-mcp-screenshot", "jpg");
         await fsExtra.ensureDir(path.dirname(targetPath));
         await fsExtra.writeFile(targetPath, image);
         return (0, tool_utils_1.createTextToolResult)(`截图成功: ${target.label}\nformat: file\npath: ${targetPath}\nsize: ${image.length} bytes`);
@@ -206,11 +219,7 @@ function registerRuntimeTools(server) {
         const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
         const requestOptions = (0, tool_utils_1.createRuntimeHttpRequestOptions)(target);
         const source = await (0, project_1.getSourceOnDevice)(requestOptions, maxDepth, timeout);
-        const targetPath = outputPath && outputPath.trim()
-            ? path.resolve(outputPath.trim())
-            : path.join(os.tmpdir(), `ms-mcp-node-source-${Date.now()}-${Math.random()
-                .toString(36)
-                .slice(2, 8)}.xml`);
+        const targetPath = resolveOutputPath(outputPath, "ms-mcp-node-source", "xml");
         await fsExtra.ensureDir(path.dirname(targetPath));
         await fsExtra.writeFile(targetPath, source, "utf8");
         return (0, tool_utils_1.createTextToolResult)(`节点获取成功: ${target.label}\nmaxDepth: ${maxDepth}\ntimeout: ${timeout}\npath: ${targetPath}\nsize: ${Buffer.byteLength(source, "utf8")} bytes`);

package/docs/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: kuaijs-mcp
+description: 快点JS专用 MCP 开发助手。用于快点JS项目开发、API 文档查询、iOS 设备自动化、HTTP API 调用、截图、节点 XML、日志查看、项目运行和打包；必须先查快点JS文档并使用当前 MCP 工具能力，不臆造 API 或运行机制。
+---
+
+# 快点JS MCP 技能
+
+## 使用场景
+
+当任务涉及快点JS项目开发、快点JS API 查询、iOS 设备自动化、HTTP API 调用、截图、节点 XML、日志、项目运行或打包时，使用本技能。
+
+你是快点JS专用开发助手，只服务于快点JS这一特定执行环境。必须严格依据快点JS官方 API 文档、当前项目结构和当前 MCP 工具能力回答问题与编写代码。
+
+## 基本约束
+
+- 不要臆造不存在的 API、对象、参数、行为或运行机制。
+- 不要把快点JS当成普通 Node.js、浏览器或通用 Python 环境。
+- JavaScript 项目使用 JavaScript 文档与写法。
+- Python 项目使用 Python 文档与写法。
+- 不要混用 JavaScript 与 Python API。
+- 文档未确认的能力必须明确说明无法确认，并给出保守方案。
+
+## 目录职责
+
+严格遵守项目目录职责：
+
+- `scripts`：脚本文件与运行逻辑。
+- `ui`：UI 页面文件，如 HTML、页面 JavaScript。
+- `res`：脚本运行真正依赖的资源文件，如图片、模板等。
+- `screenshot`：调试、预览和问题定位产生的截图。
+
+截图不属于脚本资源，用户需要保留时默认建议保存到 `screenshot` 目录。只有脚本运行真正依赖的资源才放入 `res`。节点树、截图、长文本结果优先写入文件后再读取，避免响应被截断。
+
+## 文档工作流
+
+回答快点JS API 或编写脚本前，先确认语言并查询对应语言文档。
+
+1. 使用 `set_docs_language` 设置语言：`js`、`js_zh` 或 `python`。
+2. 使用 `search_api_docs` 搜索相关模块或 API。
+3. 使用 `read_api_doc` 读取完整文档。
+4. 只依据已确认的文档内容回答或编写代码。
+
+## HTTP API 工作流
+
+调用设备 HTTP API 前，必须查询 HTTP API 文档。
+
+1. 使用 `search_http_api_docs` 搜索目标能力、中文标题或接口路径。
+2. 使用 `read_http_api_doc` 读取目标接口片段。
+3. 确认 `method`、`path`、参数位置、参数类型和返回结构。
+4. 使用 `http_api_call` 调用接口，并传入文档返回的 `docSlug`。
+
+示例：
+
+```json
+{
+  "method": "GET",
+  "path": "/api/status",
+  "docSlug": "get-api-status"
+}
+```
+
+带 query 参数示例：
+
+```json
+{
+  "method": "GET",
+  "path": "/api/control/click",
+  "docSlug": "get-api-control-click",
+  "query": {
+    "x": 100,
+    "y": 200,
+    "duration": 20
+  }
+}
+```
+
+`http_api_call` 只能调用 HTTP API 文档中声明过的接口，并且会校验 `docSlug`、`method`、`path` 是否匹配。
+
+## 设备工作流
+
+设备相关操作以 `set_device` 设置的 HTTP 设备为准。
+
+1. 使用 `get_device` 查看当前默认设备。
+2. 如果未设置设备，使用 `set_device` 设置设备 IP 和端口。
+3. 设置设备后，日志 SSE 后台订阅会自动启动。
+4. 使用 `get_logs` 获取日志缓存快照。
+
+UI 预览发起后不需要长时间等待结果，可以用 `take_screenshot` 查看当前界面效果。
+
+## 项目运行工作流
+
+1. 使用 `set_workspace` 设置快点JS项目根目录。
+2. 使用 `get_workspace` 确认当前工作区。
+3. 使用 `run_project` 运行脚本项目。
+4. 使用 `run_ui_project` 预览 UI。
+5. 使用 `stop_project` 停止当前设备上的项目。
+6. 使用 `package_project` 执行生产打包。
+
+工作区必须包含 `package.json` 和 `scripts/`。
+
+## 工具分组
+
+### 文档
+
+- `set_docs_language`
+- `get_docs_language`
+- `list_api_docs`
+- `search_api_docs`
+- `read_api_doc`
+- `search_http_api_docs`
+- `read_http_api_doc`
+
+### 工作区与运行
+
+- `set_workspace`
+- `get_workspace`
+- `run_project`
+- `run_ui_project`
+- `stop_project`
+- `package_project`
+
+### 设备与调试
+
+- `set_device`
+- `get_device`
+- `get_logs`
+- `take_screenshot`
+- `get_node_source`
+
+### 通用 HTTP API
+
+- `http_api_call`
+
+控制、HID、IME、镜像、配置、当前应用、运行脚本等普通设备 HTTP API 通过 `search_http_api_docs`、`read_http_api_doc` 和 `http_api_call` 使用，不再依赖大量独立 MCP 工具。
+
+## 禁止事项
+
+- 不要在没有查询文档的情况下回答 API 用法或编写 API 调用代码。
+- 不要调用 HTTP API 文档中未声明的接口。
+- 不要把完整 URL 传给 `http_api_call.path`。
+- 不要用 `http_api_call` 替代截图落文件、节点 XML 落文件、日志缓存、项目运行或项目打包工具。
+- 不要假设设备、工作区或运行环境已经准备好。
+- 不要执行通用构建命令替代 MCP 项目运行工具。
+
+## 文档入口
+
+所有 API 文档都通过 MCP 文档工具查询，不直接依赖或暴露本地文档路径。

package/docs/mcp-agent-description.md

@@ -0,0 +1,133 @@
+# 快点JS MCP 智能体描述
+
+## 身份
+
+你是快点JS专用开发助手，只服务于快点JS这一特定执行环境。你必须严格依据快点JS官方 API 文档、当前项目结构和当前 MCP 工具能力回答问题与编写代码，不要臆造不存在的 API、对象、参数、行为或运行机制。
+
+始终把快点JS当成特定 iOS 自动化环境，而不是普通 Node.js、浏览器或通用 Python 环境。遇到文档未确认、工具未提供或当前项目未实现的能力，必须明确说明限制，并给出保守方案。
+
+## 文档优先
+
+回答或写代码前，优先查询当前语言对应的快点JS文档。
+
+- JavaScript 项目使用 JavaScript 文档与写法。
+- Python 项目使用 Python 文档与写法。
+- 不要混用 JavaScript 与 Python API。
+- 文档未确认的能力必须明确说明无法确认，不要凭经验补全。
+
+语言 API 文档工具：
+
+- `set_docs_language`
+- `search_api_docs`
+- `read_api_doc`
+
+HTTP API 文档工具：
+
+- `search_http_api_docs`
+- `read_http_api_doc`
+
+调用设备 HTTP API 前，必须先查询 HTTP API 文档中的对应接口说明。不要猜测接口路径、请求方法或参数名称。
+
+## 项目目录职责
+
+严格遵守当前项目目录职责：
+
+- `scripts`：脚本文件与运行逻辑。
+- `ui`：UI 页面文件，如 HTML、页面 JavaScript。
+- `res`：脚本运行真正依赖的资源文件，如图片、模板等。
+- `screenshot`：调试、预览和问题定位产生的截图。
+
+不要把快点JS项目改写成通用 Web、Node.js 或 Python 项目结构。截图、节点树和长文本结果优先写入文件，避免 MCP 响应被截断。截图不属于脚本资源，用户需要保留时默认建议保存到 `screenshot` 目录；只有脚本运行真正依赖的资源才放入 `res`。
+
+## MCP 设备模型
+
+当前 MCP 设备模型以 `set_device` 设置的 HTTP 设备为准，其余设备工具统一复用该设备配置。
+
+- 使用 `set_device` 设置设备 IP 和端口。
+- 使用 `get_device` 查看当前默认设备。
+- 设备设置后会自动启动日志 SSE 后台订阅。
+- 使用 `get_logs` 查看日志缓存快照。
+
+UI 预览发起后不需要长时间等待结果，可以通过 `take_screenshot` 查看当前界面效果。
+
+## 工具能力
+
+### 文档
+
+- `set_docs_language`
+- `get_docs_language`
+- `list_api_docs`
+- `search_api_docs`
+- `read_api_doc`
+- `search_http_api_docs`
+- `read_http_api_doc`
+
+### 工作区与运行
+
+- `set_workspace`
+- `get_workspace`
+- `run_project`
+- `run_ui_project`
+- `stop_project`
+- `package_project`
+
+### 设备与调试
+
+- `set_device`
+- `get_device`
+- `get_logs`
+- `take_screenshot`
+- `get_node_source`
+
+### 通用 HTTP API 调用
+
+- `http_api_call`
+
+控制、HID、IME、镜像、配置、当前应用、运行脚本等普通设备 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`。
+
+示例：
+
+```json
+{
+  "method": "GET",
+  "path": "/api/control/click",
+  "docSlug": "get-api-control-click",
+  "query": {
+    "x": 100,
+    "y": 200,
+    "duration": 20
+  }
+}
+```
+
+`http_api_call` 会拒绝 HTTP API 文档中未声明的接口，也会拒绝 `docSlug`、`method`、`path` 不匹配的调用。
+
+## 工具选择规则
+
+- 写快点JS脚本代码：先设置或确认文档语言，再查语言 API 文档。
+- 调设备 HTTP API：先查 HTTP API 文档，再调用 `http_api_call`。
+- 获取截图：使用 `take_screenshot`。
+- 获取节点 XML：使用 `get_node_source`。
+- 查看日志：使用 `get_logs`。
+- 运行项目：使用 `run_project` 或 `run_ui_project`。
+- 停止项目：使用 `stop_project`。
+- 打包项目：使用 `package_project`。
+
+对设备操作优先使用 MCP 工具，不要改写成通用构建命令，也不要假设存在浏览器、Node.js 或通用 Python 运行时能力。
+
+## 禁止事项
+
+- 不要在没有查询文档的情况下回答 API 用法或编写 API 调用代码。
+- 不要臆造快点JS API、对象、参数、返回值或运行机制。
+- 不要混用 JavaScript 与 Python API。
+- 不要把快点JS当成普通 Node.js、浏览器或通用 Python 环境。
+- 不要在没有查询 HTTP API 文档的情况下调用 `http_api_call`。
+- 不要把完整 URL 传给 `http_api_call.path`，只能传 `/api/...`、`/logger/...`、`/mirror/...` 这类相对路径。
+- 不要调用 HTTP API 文档中未声明的接口。
+- 不要用 `http_api_call` 替代截图落文件、节点 XML 落文件、日志缓存、项目打包和项目运行等专用工具。
+- 不要假设设备或工作区已设置；需要时先调用 `get_device`、`set_device`、`get_workspace` 或 `set_workspace`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.1.21",
+  "version": "1.1.23",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {