ms-vite-plugin 1.4.29 → 1.4.31

package/dist/build.js

@@ -220,6 +220,12 @@ const buildAll = async (isDev = true, workspacePath) => {
                                     disableConsoleOutput: false,
                                     domainLock: [],
                                     selfDefending: false,
+                                    // 注入到引擎的全局对象与方法（如 paddleOcr.recognizeAbs、ms、ui、http…）
+                                    // 由原生侧按“名称字符串”绑定，一旦被改名原生就找不到对应实现。
+                                    // 这里强制关闭全局名 / 属性名改写，避免任何 obfuscator.json 误开导致注入 API 被混淆。
+                                    // 如确需对自有属性做重命名，请改用 renamePropertiesMode + reservedNames 白名单。
+                                    renameGlobals: false,
+                                    renameProperties: false,
                                 },
                             }),
                         ]),

package/docs/api/cloud.md

@@ -0,0 +1,169 @@
+# 云控模块 (Cloud)
+
+云控模块用于在主脚本中使用内置云控 WebSocket 连接。脚本可以主动连接云控服务器、判断连接状态、断开连接、上报事件数据，并监听服务器事件数据。
+
+## 注意事项
+
+- `cloud` 只在主脚本上下文注册，不支持在线程脚本里调用。
+- 服务器事件只有一个主脚本监听槽位，多次调用 `onEvent` 会覆盖旧监听。
+
+## 协议
+
+脚本上报数据时发送 JSON 文本帧：
+
+```json
+{
+  "type": "scriptReport",
+  "event": "eventName",
+  "data": {}
+}
+```
+
+服务器下发脚本事件时发送 JSON 文本帧：
+
+```json
+{
+  "type": "scriptEvent",
+  "event": "eventName",
+  "data": {}
+}
+```
+
+`event` 是脚本和服务器约定的自定义事件名。`data` 在 JS 中是普通 Object，必须能被 JSON 序列化。
+设备总览自定义字段读取最新一次 `cloud:status` 上报数据；上报时事件名固定为 `cloud:status`，`data` 是 key-value 对象。
+
+## API 参考
+
+### connect - 连接云控服务器
+
+```typescript
+function connect(url: string, deviceNo?: string): boolean;
+```
+
+**参数**
+
+| 参数名     | 类型   | 是否必填 | 默认值         | 描述 |
+| ---------- | ------ | -------- | -------------- | ---- |
+| `url`      | string | 是       | -              | 完整 `ws://` 或 `wss://` 云控地址 |
+| `deviceNo` | string | 否       | 已保存设备编号 | 连接时追加到 query 的设备编号 |
+
+**返回值**
+
+| 类型    | 描述 |
+| ------- | ---- |
+| boolean | URL 校验通过且连接请求已提交时返回 true |
+
+**说明**
+
+- `connect` 只能在主脚本上下文调用。
+- `connect` 只影响当前运行期云控连接，不会写入设置页的持久化云控配置。
+
+**示例**
+
+```javascript
+const accepted = cloud.connect("wss://example.com/control", "device-001");
+logi("云控连接请求:", accepted);
+```
+
+### isConnected - 判断是否已连接
+
+```typescript
+function isConnected(): boolean;
+```
+
+**返回值**
+
+| 类型    | 描述 |
+| ------- | ---- |
+| boolean | WebSocket 已连接时返回 true |
+
+**示例**
+
+```javascript
+if (cloud.isConnected()) {
+  cloud.report("status", { value: "ready" });
+}
+```
+
+### disconnect - 断开连接
+
+```typescript
+function disconnect(): void;
+```
+
+断开云控 WebSocket 并停止自动重连。
+
+**示例**
+
+```javascript
+cloud.disconnect();
+```
+
+### report - 上报数据
+
+```typescript
+function report(event: string, data: Record<string, any>): boolean;
+```
+
+**参数**
+
+| 参数名  | 类型      | 是否必填 | 默认值 | 描述 |
+| ------- | --------- | -------- | ------ | ---- |
+| `event` | string    | 是       | -      | 自定义事件名 |
+| `data`  | Record<string, any> | 是 | - | 要上报的普通 Object 参数 |
+
+**返回值**
+
+| 类型    | 描述 |
+| ------- | ---- |
+| boolean | 已连接且 JSON 文本帧已提交写出时返回 true |
+
+**示例**
+
+```javascript
+const ok = cloud.report("taskFinished", {
+  taskId: "A-1001",
+  success: true,
+  costMs: 1280,
+});
+logi("上报结果:", ok);
+```
+
+**上报云控状态**
+
+设备总览自定义字段读取设备最新 `cloud:status` 上报数据。服务端按设备只保存最新一份状态；同一设备再次上报会覆盖前一次状态。
+
+`data` 的 key 必须使用云控端已经配置好的设备总览自定义字段名。上报了云控端未配置的多余字段时，协议仍可发送，但云控端设备总览不会显示这些字段。
+
+```javascript
+cloud.report("cloud:status", {
+  taskName: "巡检任务",
+  progress: 80,
+  online: true,
+});
+```
+
+### onEvent - 监听服务器事件
+
+```typescript
+function onEvent(callback: ((event: string, data: Record<string, any>) => void) | null): void;
+```
+
+监听服务器发送的 `scriptEvent` 协议帧。传入 `null` 会取消主脚本监听。
+此回调注册接口只能在主线程调用，不能在线程脚本中调用。
+
+**参数**
+
+| 参数名     | 类型                          | 是否必填 | 描述 |
+| ---------- | ----------------------------- | -------- | ---- |
+| `callback` | `(event, data) => void` 或 `null` | 是    | 事件处理函数，或传 `null` 取消监听 |
+
+**示例**
+
+```javascript
+cloud.onEvent((event, data) => {
+  if (event === "startTask") {
+    logi("任务参数:", data);
+  }
+});
+```

package/docs/api/global.md

@@ -456,7 +456,7 @@ logi(`CPU 限流延迟: ${delay.minMs}~${delay.maxMs}ms`);
 
 ### setStopCallback
 
-设置停止回调函数（仅主线程调用）。
+设置停止回调函数。此回调注册接口只能在主线程调用，不能在线程脚本中调用。
 
 ```typescript
 function setStopCallback(callback: () => void): void;
@@ -483,7 +483,7 @@ setStopCallback(() => {
 
 ### setExceptionCallback
 
-设置异常停止回调函数（仅主线程调用）。
+设置异常停止回调函数。此回调注册接口只能在主线程调用，不能在线程脚本中调用。
 
 ```typescript
 function setExceptionCallback(callback: () => void): void;

package/docs/api/ui.md

@@ -74,15 +74,17 @@ UI 模块提供了 WebView 相关功能，支持事件通信和 JavaScript 交
 
 ```typescript
 function onEvent(
-  onEvent: (event: string, data: Record<string, any>) => void
+  onEvent: ((event: string, data: Record<string, any>) => void) | null
 ): void;
 ```
 
+此回调注册接口只能在主线程调用，不能在线程脚本中调用。传入 `null` 会取消监听。
+
 **参数：**
 
 | 参数名    | 类型                                               | 是否必填 | 默认值 | 描述                                 |
 | --------- | -------------------------------------------------- | -------- | ------ | ------------------------------------ |
-| `onEvent` | (event: string, data: Record<string, any>) => void | 是       |        | 事件回调函数，用于处理来自网页的事件 |
+| `onEvent` | ((event: string, data: Record<string, any>) => void) 或 null | 是 | | 事件回调函数，用于处理来自网页的事件，传 `null` 取消监听 |
 
 **示例：**
 

package/docs/apicn/cloud.md

@@ -0,0 +1,169 @@
+# 云控模块 ($云控)
+
+云控模块用于在主脚本中使用内置云控 WebSocket 连接。脚本可以连接服务器、判断连接状态、断开连接、上报事件数据，并监听服务器事件数据。
+
+## 注意事项
+
+- `$云控` 只在主脚本上下文注册，不支持在线程脚本里调用。
+- 服务器事件只有一个主脚本监听槽位，多次调用 `监听事件回调` 会覆盖旧监听。
+
+## 协议
+
+脚本上报数据时发送 JSON 文本帧：
+
+```json
+{
+  "type": "scriptReport",
+  "event": "eventName",
+  "data": {}
+}
+```
+
+服务器下发脚本事件时发送 JSON 文本帧：
+
+```json
+{
+  "type": "scriptEvent",
+  "event": "eventName",
+  "data": {}
+}
+```
+
+`event` 是脚本和服务器约定的自定义事件名。`data` 在 JS 中是普通 Object，必须能被 JSON 序列化。
+设备总览自定义字段读取最新一次 `cloud:status` 上报数据；上报时事件名固定为 `cloud:status`，`data` 是 key-value 对象。
+
+## API 参考
+
+### 连接
+
+```typescript
+function 连接(地址: 字符串, 设备编号?: 字符串): 布尔值;
+```
+
+**参数**
+
+| 参数名     | 类型   | 是否必填 | 默认值         | 描述 |
+| ---------- | ------ | -------- | -------------- | ---- |
+| `地址`     | 字符串 | 是       | -              | 完整 `ws://` 或 `wss://` 云控地址 |
+| `设备编号` | 字符串 | 否       | 已保存设备编号 | 连接时追加到 query 的设备编号 |
+
+**返回值**
+
+| 类型   | 描述 |
+| ------ | ---- |
+| 布尔值 | URL 校验通过且连接请求已提交时返回 true |
+
+**说明**
+
+- `连接` 只能在主脚本上下文调用。
+- `连接` 只影响当前运行期云控连接，不会写入设置页的持久化云控配置。
+
+**示例**
+
+```javascript
+const 已提交 = $云控.连接("wss://example.com/control", "device-001");
+$打印信息日志("云控连接请求:", 已提交);
+```
+
+### 是否已连接
+
+```typescript
+function 是否已连接(): 布尔值;
+```
+
+**返回值**
+
+| 类型   | 描述 |
+| ------ | ---- |
+| 布尔值 | WebSocket 已连接时返回 true |
+
+**示例**
+
+```javascript
+if ($云控.是否已连接()) {
+  $云控.上报数据("status", { value: "ready" });
+}
+```
+
+### 断开连接
+
+```typescript
+function 断开连接(): 无返回值;
+```
+
+断开云控 WebSocket 并停止自动重连。
+
+**示例**
+
+```javascript
+$云控.断开连接();
+```
+
+### 上报数据
+
+```typescript
+function 上报数据(事件: 字符串, 数据: 字典<任意类型>): 布尔值;
+```
+
+**参数**
+
+| 参数名 | 类型     | 是否必填 | 默认值 | 描述 |
+| ------ | -------- | -------- | ------ | ---- |
+| `事件` | 字符串   | 是       | -      | 自定义事件名 |
+| `数据` | 字典<任意类型> | 是 | - | 要上报的普通 Object 参数 |
+
+**返回值**
+
+| 类型   | 描述 |
+| ------ | ---- |
+| 布尔值 | 已连接且 JSON 文本帧已提交写出时返回 true |
+
+**示例**
+
+```javascript
+const 成功 = $云控.上报数据("taskFinished", {
+  taskId: "A-1001",
+  success: true,
+  costMs: 1280,
+});
+$打印信息日志("上报结果:", 成功);
+```
+
+**上报云控状态**
+
+设备总览自定义字段读取设备最新 `cloud:status` 上报数据。服务端按设备只保存最新一份状态；同一设备再次上报会覆盖前一次状态。
+
+`数据` 的 key 必须使用云控端已经配置好的设备总览自定义字段名。上报了云控端未配置的多余字段时，协议仍可发送，但云控端设备总览不会显示这些字段。
+
+```javascript
+$云控.上报数据("cloud:status", {
+  taskName: "巡检任务",
+  progress: 80,
+  online: true,
+});
+```
+
+### 监听事件回调
+
+```typescript
+function 监听事件回调(回调: ((事件: 字符串, 数据: 字典<任意类型>) => 无返回值) | null): 无返回值;
+```
+
+监听服务器发送的 `scriptEvent` 协议帧。传入 `null` 会取消主脚本监听。
+该回调注册接口只能在主线程调用，不能在线程脚本中调用。
+
+**参数**
+
+| 参数名 | 类型                    | 是否必填 | 描述 |
+| ------ | ----------------------- | -------- | ---- |
+| `回调` | `(事件, 数据) => 无返回值` 或 `null` | 是 | 事件处理函数，或传 `null` 取消监听 |
+
+**示例**
+
+```javascript
+$云控.监听事件回调((事件, 数据) => {
+  if (事件 === "startTask") {
+    $打印信息日志("任务参数:", 数据);
+  }
+});
+```

package/docs/apicn/global.md

@@ -457,7 +457,7 @@ $打印信息日志(`CPU 限流延迟: ${延迟.minMs}~${延迟.maxMs}ms`);
 
 ### $设置停止回调
 
-设置停止回调函数（仅主线程调用）。
+设置停止回调函数。该回调注册接口只能在主线程调用，不能在线程脚本中调用。
 
 ```typescript
 declare const $设置停止回调: (回调: () => 无返回值) => 无返回值;
@@ -484,7 +484,7 @@ $设置停止回调(() => {
 
 ### $设置异常停止回调
 
-设置异常停止回调函数（仅主线程调用）。
+设置异常停止回调函数。该回调注册接口只能在主线程调用，不能在线程脚本中调用。
 
 ```typescript
 declare const $设置异常停止回调: (回调: () => 无返回值) => 无返回值;

package/docs/apicn/ui.md

@@ -62,15 +62,17 @@ UI 模块提供了 WebView 相关功能，支持事件通信和 JavaScript 交
 
 ```typescript
 function 监听事件回调(
-  回调函数: (事件名称: 字符串, 数据: 字典<任意类型>) => 无返回值
+  回调函数: ((事件名称: 字符串, 数据: 字典<任意类型>) => 无返回值) | null
 ): 无返回值;
 ```
 
+该回调注册接口只能在主线程调用，不能在线程脚本中调用。传入 `null` 会取消监听。
+
 **参数：**
 
 | 参数名     | 类型                                                 | 是否必填 | 默认值 | 描述                                 |
 | ---------- | ---------------------------------------------------- | -------- | ------ | ------------------------------------ |
-| `回调函数` | (事件名称: 字符串, 数据: 字典<任意类型>) => 无返回值 | 是       |        | 事件回调函数，用于处理来自网页的事件 |
+| `回调函数` | ((事件名称: 字符串, 数据: 字典<任意类型>) => 无返回值) 或 null | 是 | | 事件回调函数，用于处理来自网页的事件，传 `null` 取消监听 |
 
 **示例：**
 

package/docs/apipython/cloud.md

@@ -0,0 +1,190 @@
+# 云控模块 (Cloud)
+
+云控模块用于在 Python 主脚本中使用内置云控 WebSocket 连接。脚本可以连接云控服务器、判断连接状态、断开连接、上报事件数据，并监听服务器事件数据。
+
+## 注意事项
+
+- Python 云控模块只支持英文方法，不提供中文方法。
+- `cloud` 只能在主脚本中调用，不支持在线程脚本里调用。
+- 服务器事件只有一个主脚本监听槽位，多次调用 `onEvent` 会覆盖旧监听。
+
+## 协议
+
+脚本上报数据时发送 JSON 文本帧：
+
+```json
+{
+  "type": "scriptReport",
+  "event": "eventName",
+  "data": {}
+}
+```
+
+服务器下发脚本事件时发送 JSON 文本帧：
+
+```json
+{
+  "type": "scriptEvent",
+  "event": "eventName",
+  "data": {}
+}
+```
+
+`event` 是脚本和服务器约定的自定义事件名。`data` 在 Python 中是普通 `dict`，必须能被 JSON 序列化。
+设备总览自定义字段读取最新一次 `cloud:status` 上报数据；上报时事件名固定为 `cloud:status`，`data` 是 key-value 字典。
+
+## API 参考
+
+### connect - 连接云控服务器
+
+```python
+def connect(url: str, deviceNo: str | None = None) -> bool
+```
+
+**参数**
+
+| 参数名     | 类型         | 是否必填 | 默认值         | 描述 |
+| ---------- | ------------ | -------- | -------------- | ---- |
+| `url`      | str          | 是       | -              | 完整 `ws://` 或 `wss://` 云控地址 |
+| `deviceNo` | str 或 `None` | 否       | 已保存设备编号 | 连接时追加到 query 的设备编号 |
+
+**返回值**
+
+| 类型 | 描述 |
+| ---- | ---- |
+| bool | URL 校验通过且连接请求已提交时返回 `True` |
+
+**说明**
+
+- `connect` 只能在主脚本中调用。
+- `connect` 只影响当前运行期云控连接，不会写入设置页的持久化云控配置。
+
+**示例**
+
+```python
+from kuaijs import cloud, logger
+
+accepted = cloud.connect("wss://example.com/control", "device-001")
+logger.info(f"云控连接请求: {accepted}")
+```
+
+### isConnected - 判断是否已连接
+
+```python
+def isConnected() -> bool
+```
+
+**返回值**
+
+| 类型 | 描述 |
+| ---- | ---- |
+| bool | WebSocket 已连接时返回 `True` |
+
+**示例**
+
+```python
+from kuaijs import cloud
+
+if cloud.isConnected():
+    cloud.report("status", {"value": "ready"})
+```
+
+### disconnect - 断开连接
+
+```python
+def disconnect() -> None
+```
+
+断开云控 WebSocket 并停止自动重连。
+
+**示例**
+
+```python
+from kuaijs import cloud
+
+cloud.disconnect()
+```
+
+### report - 上报数据
+
+```python
+from typing import Any, Dict
+
+def report(event: str, data: Dict[str, Any]) -> bool
+```
+
+**参数**
+
+| 参数名  | 类型             | 是否必填 | 默认值 | 描述 |
+| ------- | ---------------- | -------- | ------ | ---- |
+| `event` | str              | 是       | -      | 自定义事件名 |
+| `data`  | `Dict[str, Any]` | 是       | -      | 要上报的普通 dict 参数 |
+
+**返回值**
+
+| 类型 | 描述 |
+| ---- | ---- |
+| bool | 已连接且 JSON 文本帧已提交写出时返回 `True` |
+
+**示例**
+
+```python
+from kuaijs import cloud, logger
+
+ok = cloud.report("taskFinished", {
+    "taskId": "A-1001",
+    "success": True,
+    "costMs": 1280,
+})
+logger.info(f"上报结果: {ok}")
+```
+
+**上报云控状态**
+
+设备总览自定义字段读取设备最新 `cloud:status` 上报数据。服务端按设备只保存最新一份状态；同一设备再次上报会覆盖前一次状态。
+
+`data` 的 key 必须使用云控端已经配置好的设备总览自定义字段名。上报了云控端未配置的多余字段时，协议仍可发送，但云控端设备总览不会显示这些字段。
+
+```python
+cloud.report("cloud:status", {
+    "taskName": "巡检任务",
+    "progress": 80,
+    "online": True,
+})
+```
+
+### onEvent - 监听服务器事件
+
+```python
+from typing import Any, Callable, Dict
+
+def onEvent(callback: Callable[[str, Dict[str, Any]], None] | None) -> None
+```
+
+监听服务器发送的 `scriptEvent` 协议帧。传入 `None` 会取消主脚本监听。
+该回调注册接口只能在 Python 主脚本中调用，不能在线程脚本中调用。
+
+**参数**
+
+| 参数名     | 类型                              | 是否必填 | 描述 |
+| ---------- | --------------------------------- | -------- | ---- |
+| `callback` | `Callable[[str, Dict[str, Any]], None]` 或 `None` | 是 | 事件处理函数，或传 `None` 取消监听 |
+
+事件处理函数参数：
+
+| 字段 | 类型 | 描述 |
+| ---- | ---- | ---- |
+| `event` | str | 自定义事件名称 |
+| `data` | dict | 服务端事件数据，普通 `dict` |
+
+**示例**
+
+```python
+from kuaijs import cloud, logger
+
+def handle_event(event: str, data: dict):
+    if event == "startTask":
+        logger.info(f"任务参数: {data}")
+
+cloud.onEvent(handle_event)
+```

package/docs/apipython/overview.md

@@ -5,7 +5,7 @@
 - 导入方式：
 
 ```python
-from kuaijs import action, hid, image, appleocr, paddleocr, yolo, yolocls, system, device, file, mysql, netcard, ime, media, hotupdate, tomatoocr, tts, ui, utils, node, pip, logger
+from kuaijs import action, cloud, hid, image, appleocr, paddleocr, yolo, yolocls, system, device, file, mysql, netcard, ime, media, hotupdate, tomatoocr, tts, ui, utils, node, pip, logger
 ```
 
 ## 下载资源

package/docs/apipython/ui.md

@@ -75,14 +75,16 @@ UI 模块提供 WebView 相关功能，支持事件通信与 JavaScript 交互
 ```python
 from typing import Callable, Any
 
-def onEvent(callback: Callable[[str, Any], None]) -> None
+def onEvent(callback: Callable[[str, Any], None] | None) -> None
 ```
 
+该回调注册接口只能在 Python 主脚本中调用，不能在线程脚本中调用。传入 `None` 会取消监听。
+
 **参数：**
 
 | 参数名     | 类型                         | 是否必填 | 默认值 | 描述                                 |
 | ---------- | ---------------------------- | -------- | ------ | ------------------------------------ |
-| `callback` | `Callable[[str, Any], None]` | 是       |        | 事件回调函数，用于处理来自网页的事件 |
+| `callback` | `Callable[[str, Any], None]` 或 `None` | 是 | | 事件回调函数，用于处理来自网页的事件，传 `None` 取消监听 |
 
 **示例：**
 

package/docs/httpapi/api.md

@@ -541,6 +541,7 @@ GET /api/status
     "appName": "string",
     "appBuildNumber": 0,
     "appBundleId": "string",
+    "appNo": "string",
     "deviceModel": "string",
     "agentConnected": true,
     "isRun": true,
@@ -550,6 +551,14 @@ GET /api/status
     "udid": "string",
     "serverDeviceId": "string",
     "orientation": "PORTRAIT",
+    "memory": {
+      "used": 0,
+      "available": 0,
+      "total": 0,
+      "systemUsed": 0,
+      "usagePercentage": 0
+    },
+    "cpuUsage": 0,
     "osVersion": "string",
     "ecid": "string",
     "isVolumeControlEnabled": true,
@@ -592,6 +601,7 @@ GET /api/status
 | »» appName                | string                      | true | none | app名称                         | none |
 | »» appBuildNumber         | integer                     | true | none | app构建号                       | none |
 | »» appBundleId            | string                      | true | none | app 包名                        | none |
+| »» appNo                  | string                      | true | none | 当前软件编号                    | 未加载软件时为空字符串 |
 | »» deviceModel            | string                      | true | none | 设备型号                        | none |
 | »» agentConnected         | boolean                     | true | none | agent是否连接                   | none |
 | »» isRun                  | boolean                     | true | none | 脚本是否启动                    | none |
@@ -601,6 +611,13 @@ GET /api/status
 | »» udid                   | string                      | true | none | 设备唯一 UDID                   | none |
 | »» serverDeviceId         | string                      | true | none | 服务器设备ID                    | none |
 | »» orientation            | string                      | true | none | 屏幕方向                        | none |
+| »» memory                 | object                      | true | none | 内存状态                        | 单位为 MB，字段与系统模块内存信息一致 |
+| »»» used                  | number                      | true | none | 应用已用内存                    | 当前应用内存占用，单位 MB |
+| »»» available             | number                      | true | none | 系统可用内存                    | 系统可用内存，单位 MB |
+| »»» total                 | number                      | true | none | 系统总内存                      | 物理内存总量，单位 MB |
+| »»» systemUsed            | number                      | true | none | 系统已用内存                    | 系统已用内存，单位 MB |
+| »»» usagePercentage       | integer                     | true | none | 系统内存使用率                  | 系统已用内存占总内存百分比 |
+| »» cpuUsage               | number                      | true | none | CPU 使用率                      | 当前应用 CPU 使用率百分比 |
 | »» osVersion              | string                      | true | none | 系统版本                        | none |
 | »» ecid                   | string                      | true | none | 设备唯一 ECID                   | none |
 | »» isVolumeControlEnabled | boolean                     | true | none | 是否开启了音量键启停            | none |
@@ -764,9 +781,9 @@ POST /api/setConfig
 | --------- | ------- | ---- | ---- | -------- | ---- |
 | » success | boolean | true | none | 是否成功 | none |
 
-## GET 实时屏幕画面流MJPEG
+## WebSocket 实时屏幕画面流
 
-GET /mirror/image
+WebSocket Upgrade /mirror/ws
 
 ### 请求参数
 
@@ -774,18 +791,11 @@ GET /mirror/image
 | ------------- | ----- | ------- | ---- | ------ | ---------------------------- |
 | fps           | query | integer | 否   |        | 帧率，默认 10，范围 1-30     |
 | quality       | query | number  | 否   |        | 质量，默认 0.25，范围 0.1-1.0 |
+| scalingFactor | query | number  | 否   |        | 缩放比例，默认 1.0，范围 0.1-1.0 |
 
-> 返回示例
-
-> 200 Response
-
-### 返回结果
-
-| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
-| ------ | ------------------------------------------------------- | ---- | -------- |
-| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+### 返回数据
 
-### 返回数据结构
+连接成功后服务端持续发送 JPEG 二进制 WebSocket frame；客户端不需要发送业务消息。
 
 ## POST 执行脚本（仅支持JS脚本）
 
@@ -2954,6 +2964,7 @@ GET /api/file/download
   "appName": "string",
   "appBuildNumber": 0,
   "appBundleId": "string",
+  "appNo": "string",
   "deviceModel": "string",
   "agentConnected": true,
   "isRun": true,
@@ -2963,6 +2974,14 @@ GET /api/file/download
   "udid": "string",
   "serverDeviceId": "string",
   "orientation": "PORTRAIT",
+  "memory": {
+    "used": 0,
+    "available": 0,
+    "total": 0,
+    "systemUsed": 0,
+    "usagePercentage": 0
+  },
+  "cpuUsage": 0,
   "osVersion": "string",
   "ecid": "string",
   "isVolumeControlEnabled": true,
@@ -2994,6 +3013,7 @@ GET /api/file/download
 | appName                | string  | true | none | app名称                         | none |
 | appBuildNumber         | integer | true | none | app构建号                       | none |
 | appBundleId            | string  | true | none | app 包名                        | none |
+| appNo                  | string  | true | none | 当前软件编号                    | 未加载软件时为空字符串 |
 | deviceModel            | string  | true | none | 设备型号                        | none |
 | agentConnected         | boolean | true | none | agent是否连接                   | none |
 | isRun                  | boolean | true | none | 脚本是否启动                    | none |
@@ -3003,6 +3023,13 @@ GET /api/file/download
 | udid                   | string  | true | none | 设备唯一 UDID                   | none |
 | serverDeviceId         | string  | true | none | 服务器设备ID                    | none |
 | orientation            | string  | true | none | 屏幕方向                        | none |
+| memory                 | object  | true | none | 内存状态                        | 单位为 MB，字段与系统模块内存信息一致 |
+| » used                 | number  | true | none | 应用已用内存                    | 当前应用内存占用，单位 MB |
+| » available            | number  | true | none | 系统可用内存                    | 系统可用内存，单位 MB |
+| » total                | number  | true | none | 系统总内存                      | 物理内存总量，单位 MB |
+| » systemUsed           | number  | true | none | 系统已用内存                    | 系统已用内存，单位 MB |
+| » usagePercentage      | integer | true | none | 系统内存使用率                  | 系统已用内存占总内存百分比 |
+| cpuUsage               | number  | true | none | CPU 使用率                      | 当前应用 CPU 使用率百分比 |
 | osVersion              | string  | true | none | 系统版本                        | none |
 | ecid                   | string  | true | none | 设备唯一 ECID                   | none |
 | isVolumeControlEnabled | boolean | true | none | 是否开启了音量键启停            | none |

package/package.json

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