ms-vite-plugin 1.1.20 → 1.1.22

package/dist/mcp/runtime-tools.js

@@ -34,20 +34,33 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerRuntimeTools = registerRuntimeTools;
-const z = __importStar(require("zod/v4"));
 const fsExtra = __importStar(require("fs-extra"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
+const z = __importStar(require("zod/v4"));
 const packager_1 = require("../packager");
 const project_1 = require("../project");
-const project_2 = require("./project");
 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");
-const control_tools_1 = require("./control-tools");
-const hid_tools_1 = require("./hid-tools");
-const ime_tools_1 = require("./ime-tools");
-const mirror_tools_1 = require("./mirror-tools");
+/**
+ * 解析工具输出文件路径
+ * @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 服务实例
@@ -148,83 +161,6 @@ function registerRuntimeTools(server) {
         }
         return (0, tool_utils_1.createTextToolResult)(`当前默认设备: ${config.ip}:${config.port}`);
     });
-    server.registerTool("get_active_app_info", {
-        title: "Get Active App Info",
-        description: "获取当前激活应用信息。",
-        inputSchema: {},
-    }, async () => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "activeAppInfo");
-        return (0, tool_utils_1.createTextToolResult)(`当前激活应用信息:\n${(0, tool_utils_1.formatRuntimeJsonText)((0, tool_utils_1.unwrapRuntimeData)(payload, "activeAppInfo"))}`);
-    });
-    server.registerTool("take_me_to_front", {
-        title: "Take Me To Front",
-        description: "将当前应用切到前台。",
-        inputSchema: {},
-    }, async () => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "takeMeToFront");
-        return (0, tool_utils_1.createTextToolResult)(payload.success === true
-            ? `切到前台成功: ${target.label}`
-            : `切到前台失败: ${target.label}`, payload.success !== true);
-    });
-    server.registerTool("get_all_config", {
-        title: "Get All Config",
-        description: "获取当前设备全部配置参数。",
-        inputSchema: {},
-    }, async () => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "getAllConfig");
-        return (0, tool_utils_1.createTextToolResult)(`当前配置:\n${(0, tool_utils_1.formatRuntimeJsonText)((0, tool_utils_1.unwrapRuntimeData)(payload, "getAllConfig"))}`);
-    });
-    server.registerTool("set_all_config", {
-        title: "Set All Config",
-        description: "批量设置当前设备全部配置参数。",
-        inputSchema: {
-            config: z
-                .record(z.string(), z.unknown())
-                .describe("完整配置对象，会直接提交到 setAllConfig"),
-        },
-    }, async ({ config }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "setAllConfig", "POST", config);
-        return (0, tool_utils_1.createTextToolResult)(payload.success === true
-            ? `批量设置配置成功: ${target.label}`
-            : `批量设置配置失败: ${target.label}`, payload.success !== true);
-    });
-    server.registerTool("set_config", {
-        title: "Set Config",
-        description: "设置单个配置参数。",
-        inputSchema: {
-            key: z.string().min(1).describe("配置键名"),
-            value: z.unknown().describe("配置值，支持任意 JSON 兼容类型"),
-        },
-    }, async ({ key, value }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "setConfig", "POST", {
-            key,
-            value,
-        });
-        return (0, tool_utils_1.createTextToolResult)(payload.success === true
-            ? `配置设置成功: ${key}`
-            : `配置设置失败: ${key}`, payload.success !== true);
-    });
-    server.registerTool("run_script", {
-        title: "Run Script",
-        description: "在当前设备上执行一段 JavaScript 并返回结果。",
-        inputSchema: {
-            script: z.string().min(1).describe("要执行的 JavaScript 代码"),
-        },
-    }, async ({ script }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const payload = await (0, tool_utils_1.requestRuntimeJsonApi)(target, "runScript", "POST", {
-            script,
-        });
-        const success = payload.success === true;
-        return (0, tool_utils_1.createTextToolResult)(success
-            ? `脚本执行成功:\n${(0, tool_utils_1.formatRuntimeJsonText)(payload)}`
-            : `脚本执行失败:\n${(0, tool_utils_1.formatRuntimeJsonText)(payload)}`, !success);
-    });
     server.registerTool("take_screenshot", {
         title: "Take Screenshot",
         description: "获取当前默认设备截图。可返回 base64，或落地到文件后返回文件路径（默认写入系统临时目录）。",
@@ -248,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`);
@@ -287,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`);
@@ -384,8 +312,4 @@ function registerRuntimeTools(server) {
         await (0, project_1.stopOnDevice)((0, tool_utils_1.createRuntimeHttpRequestOptions)(target));
         return (0, tool_utils_1.createTextToolResult)(`停止请求已发送到 ${target.label}`);
     });
-    (0, control_tools_1.registerControlTools)(server);
-    (0, hid_tools_1.registerHidTools)(server);
-    (0, ime_tools_1.registerImeTools)(server);
-    (0, mirror_tools_1.registerMirrorTools)(server);
 }

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

@@ -53,36 +53,6 @@ export declare function createRuntimeHttpRequestOptions(target: RuntimeHttpTarge
  * const target = await resolveRuntimeHttpTarget()
  */
 export declare function resolveRuntimeHttpTarget(): Promise<RuntimeHttpTarget>;
-/**
- * 请求设备通用 JSON API
- * @param target 当前默认设备目标
- * @param endpoint API 路径（不含前导 `/api/`）
- * @param method 请求方法
- * @param body 可选 JSON 请求体
- * @returns 返回解析后的 JSON 数据
- * @example
- * const payload = await requestRuntimeJsonApi(target, "activeAppInfo")
- */
-export declare function requestRuntimeJsonApi(target: RuntimeHttpTarget, endpoint: string, method?: "GET" | "POST", body?: Record<string, unknown>): Promise<Record<string, unknown>>;
-/**
- * 请求任意相对路径 JSON API，并可附带 query 参数
- * @param target 当前默认设备目标
- * @param routePath 相对路径，例如 `/api/control/click`
- * @param query 可选查询参数
- * @returns 返回解析后的 JSON 数据
- * @example
- * const payload = await requestRuntimePathJson(target, "/api/ime/getText")
- */
-export declare function requestRuntimePathJson(target: RuntimeHttpTarget, routePath: string, query?: Record<string, RuntimeQueryValue>): Promise<Record<string, unknown>>;
-/**
- * 从通用 JSON 响应中读取 `data` 字段
- * @param payload API 返回 JSON
- * @param endpoint API 路径名，用于错误提示
- * @returns 返回 `data` 字段内容
- * @example
- * const data = unwrapRuntimeData(payload, "getAllConfig")
- */
-export declare function unwrapRuntimeData(payload: Record<string, unknown>, endpoint: string): unknown;
 /**
  * 将任意 JSON 兼容值格式化为文本
  * @param value 任意待展示值

package/dist/mcp/tool-utils.js

@@ -3,9 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTextToolResult = createTextToolResult;
 exports.createRuntimeHttpRequestOptions = createRuntimeHttpRequestOptions;
 exports.resolveRuntimeHttpTarget = resolveRuntimeHttpTarget;
-exports.requestRuntimeJsonApi = requestRuntimeJsonApi;
-exports.requestRuntimePathJson = requestRuntimePathJson;
-exports.unwrapRuntimeData = unwrapRuntimeData;
 exports.formatRuntimeJsonText = formatRuntimeJsonText;
 exports.formatApiDocSummary = formatApiDocSummary;
 const docs_service_1 = require("./docs-service");
@@ -71,77 +68,6 @@ async function resolveRuntimeHttpTarget() {
         label: `${device.ip}:${device.port}`,
     };
 }
-/**
- * 请求设备通用 JSON API
- * @param target 当前默认设备目标
- * @param endpoint API 路径（不含前导 `/api/`）
- * @param method 请求方法
- * @param body 可选 JSON 请求体
- * @returns 返回解析后的 JSON 数据
- * @example
- * const payload = await requestRuntimeJsonApi(target, "activeAppInfo")
- */
-async function requestRuntimeJsonApi(target, endpoint, method = "GET", body) {
-    const url = `http://${target.ip}:${target.port}/api/${endpoint}`;
-    const response = await fetch(url, {
-        method,
-        headers: body ? { "Content-Type": "application/json" } : undefined,
-        body: body ? JSON.stringify(body) : undefined,
-    });
-    if (!response.ok) {
-        throw new Error(`${endpoint} 请求失败，状态码: ${response.status}`);
-    }
-    const payload = (await response.json());
-    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
-        throw new Error(`${endpoint} 返回了无效响应`);
-    }
-    return payload;
-}
-/**
- * 请求任意相对路径 JSON API，并可附带 query 参数
- * @param target 当前默认设备目标
- * @param routePath 相对路径，例如 `/api/control/click`
- * @param query 可选查询参数
- * @returns 返回解析后的 JSON 数据
- * @example
- * const payload = await requestRuntimePathJson(target, "/api/ime/getText")
- */
-async function requestRuntimePathJson(target, routePath, query) {
-    const url = new URL(`http://${target.ip}:${target.port}${routePath}`);
-    if (query) {
-        for (const [key, value] of Object.entries(query)) {
-            if (value === undefined || value === null) {
-                continue;
-            }
-            url.searchParams.set(key, String(value));
-        }
-    }
-    const response = await fetch(url.toString(), {
-        method: "GET",
-    });
-    if (!response.ok) {
-        throw new Error(`${routePath} 请求失败，状态码: ${response.status}`);
-    }
-    const payload = (await response.json());
-    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
-        throw new Error(`${routePath} 返回了无效响应`);
-    }
-    return payload;
-}
-/**
- * 从通用 JSON 响应中读取 `data` 字段
- * @param payload API 返回 JSON
- * @param endpoint API 路径名，用于错误提示
- * @returns 返回 `data` 字段内容
- * @example
- * const data = unwrapRuntimeData(payload, "getAllConfig")
- */
-function unwrapRuntimeData(payload, endpoint) {
-    if (payload.success !== true) {
-        throw new Error(String(payload.message ?? `${endpoint} 返回失败`));
-    }
-    return payload.data;
-}
 /**
  * 将任意 JSON 兼容值格式化为文本
  * @param value 任意待展示值

package/dist/mcp/tools.js

@@ -7,6 +7,7 @@ const version_1 = require("../version");
 const device_config_1 = require("./device-config");
 Object.defineProperty(exports, "DEFAULT_DEVICE_PORT", { enumerable: true, get: function () { return device_config_1.DEFAULT_DEVICE_PORT; } });
 const doc_tools_1 = require("./doc-tools");
+const httpapi_tools_1 = require("./httpapi-tools");
 const runtime_tools_1 = require("./runtime-tools");
 /**
  * 创建并注册 MCP 工具
@@ -21,6 +22,7 @@ function createMcpServer() {
     });
     (0, doc_tools_1.registerDocResources)(server);
     (0, doc_tools_1.registerDocTools)(server);
+    (0, httpapi_tools_1.registerHttpApiTools)(server);
     (0, runtime_tools_1.registerRuntimeTools)(server);
     return server;
 }

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 文档工具查询，不直接依赖或暴露本地文档路径。