ms-vite-plugin 1.4.30 → 1.4.32

package/dist/build.js

@@ -220,6 +220,8 @@ const buildAll = async (isDev = true, workspacePath) => {
                                     disableConsoleOutput: false,
                                     domainLock: [],
                                     selfDefending: false,
+                                    renameGlobals: false,
+                                    renameProperties: false,
                                 },
                             }),
                         ]),

package/docs/api/cloud.md

@@ -30,6 +30,7 @@
 ```
 
 `event` 是脚本和服务器约定的自定义事件名。`data` 在 JS 中是普通 Object，必须能被 JSON 序列化。
+设备总览自定义字段读取最新一次 `cloud:status` 上报数据；上报时事件名固定为 `cloud:status`，`data` 是 key-value 对象。
 
 ## API 参考
 
@@ -128,6 +129,20 @@ const ok = cloud.report("taskFinished", {
 logi("上报结果:", ok);
 ```
 
+**上报云控状态**
+
+设备总览自定义字段读取设备最新 `cloud:status` 上报数据。服务端按设备只保存最新一份状态；同一设备再次上报会覆盖前一次状态。
+
+`data` 的 key 必须使用云控端已经配置好的设备总览自定义字段名。上报了云控端未配置的多余字段时，协议仍可发送，但云控端设备总览不会显示这些字段。
+
+```javascript
+cloud.report("cloud:status", {
+  taskName: "巡检任务",
+  progress: 80,
+  online: true,
+});
+```
+
 ### onEvent - 监听服务器事件
 
 ```typescript

package/docs/api/global.md

@@ -459,25 +459,32 @@ logi(`CPU 限流延迟: ${delay.minMs}~${delay.maxMs}ms`);
 设置停止回调函数。此回调注册接口只能在主线程调用，不能在线程脚本中调用。
 
 ```typescript
-function setStopCallback(callback: () => void): void;
+function setStopCallback(
+  callback: (status: "success" | "error" | "stopped") => void,
+): void;
 ```
 
 **参数:**
 
-| 参数名     | 类型       | 是否必填 | 默认值 | 描述         |
-| ---------- | ---------- | -------- | ------ | ------------ |
-| `callback` | () => void | 是       | -      | 停止回调函数 |
+| 参数名     | 类型                                                   | 是否必填 | 默认值 | 描述         |
+| ---------- | ------------------------------------------------------ | -------- | ------ | ------------ |
+| `callback` | (status: "success" \| "error" \| "stopped") => void | 是       | -      | 停止回调函数 |
 
 **说明:**
 
-脚本执行完成或异常停止时调用，`exit()` 退出不会触发此回调。
+脚本执行停止时调用，`status` 表示停止状态：`success` 为正常完成，`error` 为异常停止，`stopped` 为手动停止。
 
 **示例:**
 
 ```javascript
-setStopCallback(() => {
-  logi("脚本执行完成");
-  // 执行清理工作
+setStopCallback((status) => {
+  if (status === "success") {
+    logi("脚本执行完成");
+  } else if (status === "error") {
+    loge("脚本执行异常");
+  } else if (status === "stopped") {
+    logi("脚本手动停止");
+  }
 });
 ```
 

package/docs/apicn/cloud.md

@@ -30,6 +30,7 @@
 ```
 
 `event` 是脚本和服务器约定的自定义事件名。`data` 在 JS 中是普通 Object，必须能被 JSON 序列化。
+设备总览自定义字段读取最新一次 `cloud:status` 上报数据；上报时事件名固定为 `cloud:status`，`data` 是 key-value 对象。
 
 ## API 参考
 
@@ -128,6 +129,20 @@ const 成功 = $云控.上报数据("taskFinished", {
 $打印信息日志("上报结果:", 成功);
 ```
 
+**上报云控状态**
+
+设备总览自定义字段读取设备最新 `cloud:status` 上报数据。服务端按设备只保存最新一份状态；同一设备再次上报会覆盖前一次状态。
+
+`数据` 的 key 必须使用云控端已经配置好的设备总览自定义字段名。上报了云控端未配置的多余字段时，协议仍可发送，但云控端设备总览不会显示这些字段。
+
+```javascript
+$云控.上报数据("cloud:status", {
+  taskName: "巡检任务",
+  progress: 80,
+  online: true,
+});
+```
+
 ### 监听事件回调
 
 ```typescript

package/docs/apicn/global.md

@@ -460,25 +460,32 @@ $打印信息日志(`CPU 限流延迟: ${延迟.minMs}~${延迟.maxMs}ms`);
 设置停止回调函数。该回调注册接口只能在主线程调用，不能在线程脚本中调用。
 
 ```typescript
-declare const $设置停止回调: (回调: () => 无返回值) => 无返回值;
+declare const $设置停止回调: (
+  回调: (状态: "success" | "error" | "stopped") => 无返回值,
+) => 无返回值;
 ```
 
 **参数:**
 
-| 参数名 | 类型           | 是否必填 | 默认值 | 描述         |
-| ------ | -------------- | -------- | ------ | ------------ |
-| `回调` | () => 无返回值 | 是       | -      | 停止回调函数 |
+| 参数名 | 类型                                                       | 是否必填 | 默认值 | 描述         |
+| ------ | ---------------------------------------------------------- | -------- | ------ | ------------ |
+| `回调` | (状态: "success" \| "error" \| "stopped") => 无返回值 | 是       | -      | 停止回调函数 |
 
 **说明:**
 
-脚本执行完成或异常停止时调用，`$退出脚本()` 退出不会触发此回调。
+脚本执行停止时调用，`状态` 表示停止状态：`success` 为正常完成，`error` 为异常停止，`stopped` 为手动停止。
 
 **示例:**
 
 ```javascript
-$设置停止回调(() => {
-  $打印信息日志("脚本执行完成");
-  // 执行清理工作
+$设置停止回调((状态) => {
+  if (状态 === "success") {
+    $打印信息日志("脚本执行完成");
+  } else if (状态 === "error") {
+    $打印错误日志("脚本执行异常");
+  } else if (状态 === "stopped") {
+    $打印信息日志("脚本手动停止");
+  }
 });
 ```
 

package/docs/apipython/cloud.md

@@ -31,6 +31,7 @@
 ```
 
 `event` 是脚本和服务器约定的自定义事件名。`data` 在 Python 中是普通 `dict`，必须能被 JSON 序列化。
+设备总览自定义字段读取最新一次 `cloud:status` 上报数据；上报时事件名固定为 `cloud:status`，`data` 是 key-value 字典。
 
 ## API 参考
 
@@ -138,6 +139,20 @@ ok = cloud.report("taskFinished", {
 logger.info(f"上报结果: {ok}")
 ```
 
+**上报云控状态**
+
+设备总览自定义字段读取设备最新 `cloud:status` 上报数据。服务端按设备只保存最新一份状态；同一设备再次上报会覆盖前一次状态。
+
+`data` 的 key 必须使用云控端已经配置好的设备总览自定义字段名。上报了云控端未配置的多余字段时，协议仍可发送，但云控端设备总览不会显示这些字段。
+
+```python
+cloud.report("cloud:status", {
+    "taskName": "巡检任务",
+    "progress": 80,
+    "online": True,
+})
+```
+
 ### onEvent - 监听服务器事件
 
 ```python

package/docs/apipython/g.md

@@ -7,6 +7,7 @@
 - 应用信息常量：版本号/构建号/名称/包名
 - 前台切换：将宿主应用切到前台
 - Agent 设置：读取和设置 Agent 快速模式
+- 脚本生命周期：设置停止回调和异常停止回调
 
 ## 常量
 
@@ -226,6 +227,69 @@ from kuaijs import g
 g.restartScript()
 ```
 
+#### `setStopCallback` - 设置停止回调
+
+设置脚本停止回调函数。回调只在主脚本结束时调用，不能在线程脚本中分别注册。
+
+```python
+def setStopCallback(callback: Callable[[Literal["success", "error", "stopped"]], None] | None) -> None
+```
+
+**参数:**
+
+| 参数名     | 类型                                                      | 是否必填 | 默认值 | 描述 |
+| ---------- | --------------------------------------------------------- | -------- | ------ | ---- |
+| `callback` | `Callable[[Literal["success", "error", "stopped"]], None]` 或 `None` | 是 | - | 停止回调函数，传 `None` 取消回调 |
+
+**状态值:**
+
+| 状态 | 描述 |
+| ---- | ---- |
+| `success` | 脚本正常执行完成 |
+| `error` | 脚本发生未捕获异常 |
+| `stopped` | 脚本被手动停止或主动退出 |
+
+**示例:**
+
+```python
+from kuaijs import g
+
+def on_stop(status: str) -> None:
+    if status == "success":
+        print("脚本执行完成")
+    elif status == "error":
+        print("脚本执行异常")
+    elif status == "stopped":
+        print("脚本手动停止")
+
+g.setStopCallback(on_stop)
+```
+
+#### `setExceptionCallback` - 设置异常停止回调
+
+设置脚本异常停止回调函数。该回调只在主脚本发生未捕获异常时调用，并且会早于 `setStopCallback` 注册的停止回调执行。
+
+```python
+def setExceptionCallback(callback: Callable[[], None] | None) -> None
+```
+
+**参数:**
+
+| 参数名     | 类型                         | 是否必填 | 默认值 | 描述 |
+| ---------- | ---------------------------- | -------- | ------ | ---- |
+| `callback` | `Callable[[], None]` 或 `None` | 是 | - | 异常停止回调函数，传 `None` 取消回调 |
+
+**示例:**
+
+```python
+from kuaijs import g
+
+def on_exception() -> None:
+    print("脚本异常停止")
+
+g.setExceptionCallback(on_exception)
+```
+
 #### `loadDex` - 加载指定的 dex、apk 文件
 
 **注意:**

package/docs/httpapi/api.md

@@ -299,6 +299,92 @@ GET /api/activeAppInfo
 | »» bundleId | string  | true | none | 应用包名 | none |
 | »» pid      | integer | true | none |          | none |
 
+## GET 获取锁屏状态
+
+GET /api/isLocked
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true,
+  "data": false
+}
+```
+
+### 返回结果
+
+| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
+| ------ | ------------------------------------------------------- | ---- | -------- |
+| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+
+### 返回数据结构
+
+状态码 **200**
+
+| 名称      | 类型    | 必选 | 约束 | 中文名   | 说明 |
+| --------- | ------- | ---- | ---- | -------- | ---- |
+| » success | boolean | true | none | 是否成功 | none |
+| » data    | boolean | true | none | 是否锁屏 | `true` 表示已锁屏，`false` 表示未锁屏 |
+
+## GET 锁屏
+
+GET /api/lock
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
+| ------ | ------------------------------------------------------- | ---- | -------- |
+| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+
+### 返回数据结构
+
+状态码 **200**
+
+| 名称      | 类型    | 必选 | 约束 | 中文名   | 说明 |
+| --------- | ------- | ---- | ---- | -------- | ---- |
+| » success | boolean | true | none | 是否成功 | none |
+
+## GET 解锁
+
+GET /api/unlock
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
+| ------ | ------------------------------------------------------- | ---- | -------- |
+| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+
+### 返回数据结构
+
+状态码 **200**
+
+| 名称      | 类型    | 必选 | 约束 | 中文名   | 说明 |
+| --------- | ------- | ---- | ---- | -------- | ---- |
+| » success | boolean | true | none | 是否成功 | none |
+
 ## GET 获取屏幕亮度
 
 GET /api/getScreenBrightness
@@ -541,6 +627,7 @@ GET /api/status
     "appName": "string",
     "appBuildNumber": 0,
     "appBundleId": "string",
+    "appNo": "string",
     "deviceModel": "string",
     "agentConnected": true,
     "isRun": true,
@@ -550,6 +637,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 +687,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 +697,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,28 +867,55 @@ POST /api/setConfig
 | --------- | ------- | ---- | ---- | -------- | ---- |
 | » success | boolean | true | none | 是否成功 | none |
 
-## GET 实时屏幕画面流MJPEG
+## WebSocket 实时屏幕画面流
 
-GET /mirror/image
+WebSocket Upgrade /mirror/ws
 
 ### 请求参数
 
 | 名称          | 位置  | 类型    | 必选 | 中文名 | 说明                         |
 | ------------- | ----- | ------- | ---- | ------ | ---------------------------- |
-| fps           | query | integer | 否   |        | 帧率，默认 10，范围 1-30     |
+| fps           | query | integer | 否   |        | 帧率，默认 10，范围 1-60     |
 | quality       | query | number  | 否   |        | 质量，默认 0.25，范围 0.1-1.0 |
+| scalingFactor | query | number  | 否   |        | 缩放比例，默认 1.0，范围 0.1-1.0 |
 
-> 返回示例
+### 返回数据
 
-> 200 Response
+连接成功后服务端持续发送 JPEG 二进制 WebSocket frame；客户端不需要发送业务消息。
 
-### 返回结果
+## HTTP-FLV 实时屏幕画面流
 
-| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
-| ------ | ------------------------------------------------------- | ---- | -------- |
-| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+GET /mirror/flv
 
-### 返回数据结构
+### 请求参数
+
+| 名称          | 位置  | 类型    | 必选 | 中文名 | 说明                                |
+| ------------- | ----- | ------- | ---- | ------ | ----------------------------------- |
+| fps           | query | integer | 否   |        | 帧率，默认 10，范围 1-60            |
+| quality       | query | number  | 否   |        | JPEG 源质量，默认 0.25，范围 0.1-1.0 |
+| scalingFactor | query | number  | 否   |        | 缩放比例，默认 1.0，范围 0.1-1.0    |
+| bitrate       | query | number  | 否   |        | H.264 目标码率，单位 Mbps，默认 4    |
+
+### 返回数据
+
+响应类型为 `video/x-flv`，服务端持续输出 FLV 容器内的 H.264 视频 tag。
+
+## WHEP 实时屏幕画面流
+
+POST /mirror/whep
+
+### 请求参数
+
+| 名称          | 位置  | 类型    | 必选 | 中文名 | 说明                                |
+| ------------- | ----- | ------- | ---- | ------ | ----------------------------------- |
+| fps           | query | integer | 否   |        | 帧率，默认 10，范围 1-60            |
+| quality       | query | number  | 否   |        | JPEG 源质量，默认 0.25，范围 0.1-1.0 |
+| scalingFactor | query | number  | 否   |        | 缩放比例，默认 1.0，范围 0.1-1.0    |
+| bitrate       | query | number  | 否   |        | WebRTC 发送码率，单位 Mbps，默认 4   |
+
+### 返回数据
+
+请求 body 为 `application/sdp` 的 WebRTC offer；响应类型为 `application/sdp`，内容为 WebRTC answer。
 
 ## POST 执行脚本（仅支持JS脚本）
 
@@ -2927,6 +3057,28 @@ GET /api/file/download
 | 401    | [Unauthorized](https://tools.ietf.org/html/rfc7235#section-3.1)  | 设备未授权 | Inline   |
 | 404    | [Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)   | 文件不存在 | Inline   |
 
+## GET MJPEG 镜像流
+
+GET /mirror/image
+
+返回 `multipart/x-mixed-replace` MJPEG 长连接，每个 part 都是一帧 JPEG。浏览器可直接用 `<img src="/mirror/image">` 预览。
+
+### 请求参数
+
+| 名称          | 位置  | 类型    | 必选 | 说明 |
+| ------------- | ----- | ------- | ---- | ---- |
+| fps           | query | integer | 否   | 目标帧率，范围 1-60，默认 10 |
+| quality       | query | number  | 否   | JPEG 质量，范围 0.1-1.0，默认 0.25 |
+| scalingFactor | query | number  | 否   | 截图缩放因子，范围 0.1-1.0，默认 1.0 |
+
+### 返回结果
+
+| 状态码 | 状态码含义                                                       | 说明 | 数据模型 |
+| ------ | ---------------------------------------------------------------- | ---- | -------- |
+| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)          | `multipart/x-mixed-replace; boundary=kuaijs-mjpeg-boundary` 流 | file |
+| 429    | [Too Many Requests](https://tools.ietf.org/html/rfc6585#section-4) | 镜像流客户端数量已满 | Inline |
+| 503    | [Service Unavailable](https://tools.ietf.org/html/rfc7231#section-6.6.4) | HID 录屏链路未就绪 | Inline |
+
 # 数据模型
 
 <h2 id="tocS_软件状态">软件状态</h2>
@@ -2954,6 +3106,7 @@ GET /api/file/download
   "appName": "string",
   "appBuildNumber": 0,
   "appBundleId": "string",
+  "appNo": "string",
   "deviceModel": "string",
   "agentConnected": true,
   "isRun": true,
@@ -2963,6 +3116,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 +3155,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 +3165,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.30",
+  "version": "1.4.32",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {