ms-vite-plugin 1.3.1 → 1.3.2

package/docs/api/action.md

@@ -529,14 +529,16 @@ function completeTaskAndGoHome() {
 ### pressButton - 按下系统按钮
 
 ```typescript
-function pressButton(button: "home" | "volumeup" | "volumedown"): boolean;
+function pressButton(
+  button: "home" | "volumeup" | "volumedown" | "brightnessup" | "brightnessdown",
+): boolean;
 ```
 
 **参数说明：**
 
 | 参数名   | 类型   | 是否必填 | 默认值 | 描述                                                                                       |
 | -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------ |
-| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
+| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
 
 **返回值：**
 

package/docs/api/device.md

@@ -111,7 +111,6 @@ logi(`服务器设备ID: ${serverDeviceId}`);
 
 ### getECID - 获取设备 ECID。
 
-
 ```typescript
 function getECID(): string;
 ```
@@ -132,7 +131,6 @@ logi(`ECID: ${ecid}`);
 
 ### getUDID - 获取设备 UDID。
 
-
 ```typescript
 function getUDID(): string;
 ```
@@ -271,6 +269,53 @@ const scale = device.getScreenScale();
 logi(`屏幕缩放比例: ${scale}`);
 ```
 
+### getScreenBrightness - 获取屏幕亮度。
+
+```typescript
+function getScreenBrightness(): number;
+```
+
+**返回值：**
+
+| 类型     | 描述                     |
+| -------- | ------------------------ |
+| `number` | 屏幕亮度，范围 `0.0-1.0` |
+
+**示例：**
+
+```typescript
+// 获取屏幕亮度
+const brightness = device.getScreenBrightness();
+logi(`屏幕亮度: ${brightness}`);
+```
+
+### setScreenBrightness - 设置屏幕亮度。
+
+设置设备屏幕亮度，亮度范围为 `0.0-1.0`。
+
+```typescript
+function setScreenBrightness(brightness: number): boolean;
+```
+
+**参数说明：**
+
+| 参数名       | 类型     | 是否必填 | 默认值 | 描述                         |
+| ------------ | -------- | -------- | ------ | ---------------------------- |
+| `brightness` | `number` | 是       | -      | 目标屏幕亮度，范围 `0.0-1.0` |
+
+**返回值：**
+
+| 类型      | 描述                     |
+| --------- | ------------------------ |
+| `boolean` | 是否设置成功 |
+
+**示例：**
+
+```typescript
+// 设置屏幕亮度到 50%
+device.setScreenBrightness(0.5);
+```
+
 ### getOrientation - 获取屏幕方向。
 
 **注意事项**

package/docs/api/global.md

@@ -32,22 +32,6 @@ declare const __runMode__: "agent" | "hid";
 logi(`运行模式: ${__runMode__}`);
 ```
 
-### 是否使用内置Agent
-
-#### **isSupportBuiltAgent**
-
-是否使用内置 Agent。
-
-```typescript
-declare const __isSupportBuiltAgent__: boolean;
-```
-
-**示例:**
-
-```javascript
-logi(`是否使用内置Agent: ${__isSupportBuiltAgent__}`);
-```
-
 ### 调试和状态
 
 #### **debug**
@@ -325,8 +309,8 @@ function setAgentFastMode(enabled: boolean): boolean;
 
 **返回值:**
 
-| 类型      | 描述                                               |
-| --------- | -------------------------------------------------- |
+| 类型      | 描述                 |
+| --------- | -------------------- |
 | `boolean` | 实际是否开启快速模式 |
 
 **示例:**
@@ -346,8 +330,8 @@ function getAgentFastMode(): boolean;
 
 **返回值:**
 
-| 类型      | 描述                                               |
-| --------- | -------------------------------------------------- |
+| 类型      | 描述                 |
+| --------- | -------------------- |
 | `boolean` | 当前是否开启快速模式 |
 
 **示例:**

package/docs/api/hid.md

@@ -761,7 +761,22 @@ hid.enter();
 
 ```typescript
 function pressButton(
-  button: "home" | "volumeup" | "volumedown" | "eject",
+  button:
+    | "home"
+    | "volumeup"
+    | "volumedown"
+    | "mute"
+    | "playpause"
+    | "next"
+    | "prev"
+    | "eject"
+    | "globe"
+    | "search"
+    | "brightnessup"
+    | "brightnessdown"
+    | "power"
+    | "menu"
+    | "snapshot",
 ): boolean;
 ```
 
@@ -769,7 +784,7 @@ function pressButton(
 
 | 参数名   | 类型   | 是否必填 | 默认值 | 描述                                                                                                                     |
 | -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
+| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 
@@ -789,6 +804,12 @@ hid.pressButton("volumeup");
 // 调低音量
 hid.pressButton("volumedown");
 
+// 调高屏幕亮度
+hid.pressButton("brightnessup");
+
+// 触发系统截图
+hid.pressButton("snapshot");
+
 // 连续调节音量
 for (let i = 0; i < 5; i++) {
   hid.pressButton("volumeup");

package/docs/api/http.md

@@ -13,7 +13,7 @@ function request(params: {
   method?: string;
   proxy?: { host: string; port: number };
   followRedirects?: boolean;
-  requestBody?: string;
+  requestBody?: string | ArrayBuffer;
   userAgent?: string;
   ignoreContentType?: boolean;
   ignoreHttpErrors?: boolean;
@@ -44,7 +44,7 @@ function request(params: {
 | `method`            | string  | 否       | GET      | 请求方法（GET、POST 等）    |
 | `proxy`             | object  | 否       | -        | 代理服务器配置              |
 | `followRedirects`   | boolean | 否       | true     | 是否跟随重定向              |
-| `requestBody`       | string  | 否       | -        | 请求体（POST 等方法使用）   |
+| `requestBody`       | string \| ArrayBuffer | 否       | -        | 请求体，JSON 对象需先 JSON.stringify |
 | `userAgent`         | string  | 否       | -        | 用户代理字符串              |
 | `ignoreContentType` | boolean | 否       | false    | 是否忽略内容类型            |
 | `ignoreHttpErrors`  | boolean | 否       | false    | 是否忽略 HTTP 错误          |

package/docs/apicn/action.md

@@ -520,14 +520,16 @@ function completeTaskAndGoHome() {
 ### 按键 - 按下系统按钮
 
 ```typescript
-function 按键(按键: "home" | "volumeup" | "volumedown"): 布尔值;
+function 按键(
+  按键: "home" | "volumeup" | "volumedown" | "brightnessup" | "brightnessdown",
+): 布尔值;
 ```
 
 **参数说明：**
 
 | 参数名 | 类型   | 是否必填 | 默认值 | 描述                                                                                       |
 | ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------ |
-| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
+| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
 
 **返回值：**
 

package/docs/apicn/device.md

@@ -111,7 +111,6 @@ $打印信息日志(`服务器设备ID: ${serverDeviceId}`);
 
 ### 获取 ECID
 
-
 ```typescript
 function 获取ECID(): 字符串;
 ```
@@ -132,7 +131,6 @@ $打印信息日志(`ECID: ${ecid}`);
 
 ### 获取 UDID
 
-
 ```typescript
 function 获取UDID(): 字符串;
 ```
@@ -285,6 +283,53 @@ const scale = $设备.获取屏幕缩放比例();
 $打印信息日志(`屏幕缩放比例: ${scale}`);
 ```
 
+### 获取屏幕亮度
+
+```typescript
+function 获取屏幕亮度(): 数字;
+```
+
+**返回值：**
+
+| 类型 | 描述                     |
+| ---- | ------------------------ |
+| 数字 | 屏幕亮度，范围 `0.0-1.0` |
+
+**示例：**
+
+```typescript
+// 获取屏幕亮度
+const 屏幕亮度 = $设备.获取屏幕亮度();
+$打印信息日志(`屏幕亮度: ${屏幕亮度}`);
+```
+
+### 设置屏幕亮度
+
+设置设备屏幕亮度，亮度范围为 `0.0-1.0`。
+
+```typescript
+function 设置屏幕亮度(亮度: 数字): 布尔值;
+```
+
+**参数说明：**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述                         |
+| ------ | ---- | -------- | ------ | ---------------------------- |
+| `亮度` | 数字 | 是       | -      | 目标屏幕亮度，范围 `0.0-1.0` |
+
+**返回值：**
+
+| 类型   | 描述                     |
+| ------ | ------------------------ |
+| 布尔值 | 是否设置成功 |
+
+**示例：**
+
+```typescript
+// 设置屏幕亮度到 50%
+$设备.设置屏幕亮度(0.5);
+```
+
 ### 获取屏幕方向
 
 **注意事项**

package/docs/apicn/global.md

@@ -34,22 +34,6 @@ declare const $运行模式: "agent" | "hid";
 $打印信息日志(`运行模式: ${$运行模式}`);
 ```
 
-### 是否使用内置Agent
-
-#### **$是否内置Agent**
-
-是否使用内置 Agent。
-
-```typescript
-declare const $是否内置Agent: 布尔值;
-```
-
-**示例:**
-
-```javascript
-$打印信息日志(`是否使用内置Agent: ${$是否内置Agent}`);
-```
-
 ### 调试和状态
 
 #### **$是否调试**
@@ -326,8 +310,8 @@ declare function $设置Agent快速模式(是否开启: 布尔值): 布尔值;
 
 **返回值:**
 
-| 类型     | 描述                                               |
-| -------- | -------------------------------------------------- |
+| 类型     | 描述                 |
+| -------- | -------------------- |
 | `布尔值` | 实际是否开启快速模式 |
 
 **示例:**
@@ -347,8 +331,8 @@ declare function $获取Agent快速模式(): 布尔值;
 
 **返回值:**
 
-| 类型     | 描述                                               |
-| -------- | -------------------------------------------------- |
+| 类型     | 描述                 |
+| -------- | -------------------- |
 | `布尔值` | 当前是否开启快速模式 |
 
 **示例:**

package/docs/apicn/hid.md

@@ -760,14 +760,31 @@ $HID.回车键();
 ### 按键 - 按下系统按钮
 
 ```typescript
-function 按键(按键: "home" | "volumeup" | "volumedown" | "eject"): 布尔值;
+function 按键(
+  按键:
+    | "home"
+    | "volumeup"
+    | "volumedown"
+    | "mute"
+    | "playpause"
+    | "next"
+    | "prev"
+    | "eject"
+    | "globe"
+    | "search"
+    | "brightnessup"
+    | "brightnessdown"
+    | "power"
+    | "menu"
+    | "snapshot",
+): 布尔值;
 ```
 
 **参数说明：**
 
 | 参数名 | 类型   | 是否必填 | 默认值 | 描述                                                                                                                     |
 | ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
+| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 
@@ -787,6 +804,12 @@ $HID.按键("volumeup");
 // 调低音量
 $HID.按键("volumedown");
 
+// 调高屏幕亮度
+$HID.按键("brightnessup");
+
+// 触发系统截图
+$HID.按键("snapshot");
+
 // 连续调节音量
 for (let i = 0; i < 5; i++) {
   const 是否成功 = $HID.按键("volumeup");

package/docs/apicn/http.md

@@ -38,9 +38,9 @@ function 发送请求(params: {
    */
   followRedirects?: 布尔值;
   /**
-   * 请求体 仅在POST方法下有效 json 需要进行JSON.stringify
+   * 请求体，支持字符串或二进制数据；JSON 对象需要先 JSON.stringify
    */
-  requestBody?: 字符串;
+  requestBody?: 字符串 | ArrayBuffer;
   /**
    * 请求头
    */
@@ -122,7 +122,7 @@ function 发送请求(params: {
 | `method`            | 字符串         | 否       | GET      | 请求方法（GET、POST 等）    |
 | `proxy`             | 对象           | 否       | -        | 代理服务器配置              |
 | `followRedirects`   | 布尔值         | 否       | true     | 是否跟随重定向              |
-| `requestBody`       | 字符串         | 否       | -        | 请求体（POST 等方法使用）   |
+| `requestBody`       | 字符串 \| ArrayBuffer | 否       | -        | 请求体，JSON 对象需先 JSON.stringify |
 | `userAgent`         | 字符串         | 否       | -        | 用户代理字符串              |
 | `ignoreContentType` | 布尔值         | 否       | false    | 是否忽略内容类型            |
 | `ignoreHttpErrors`  | 布尔值         | 否       | false    | 是否忽略 HTTP 错误          |

package/docs/apipython/action.md

@@ -498,14 +498,16 @@ def completeTaskAndGoHome():
 ### pressButton - 按下系统按钮
 
 ```python
-def pressButton(button: Literal["home", "volumeup", "volumedown"]) -> bool
+def pressButton(
+    button: Literal["home", "volumeup", "volumedown", "brightnessup", "brightnessdown"],
+) -> bool
 ```
 
 **参数说明：**
 
 | 参数名   | 类型    | 是否必填 | 默认值 | 描述                                                                                       |
 | -------- | ------- | -------- | ------ | ------------------------------------------------------------------------------------------ |
-| `button` | Literal | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
+| `button` | Literal | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
 
 **返回值：**
 

package/docs/apipython/device.md

@@ -115,7 +115,6 @@ print(device.getServerDeviceId())
 
 ### getECID - 获取设备 ECID。
 
-
 ```python
 def getECID() -> str
 ```
@@ -135,7 +134,6 @@ print(device.getECID())
 
 ### getUDID - 获取设备 UDID。
 
-
 ```python
 def getUDID() -> str
 ```
@@ -266,6 +264,52 @@ from kuaijs import device
 print(device.getScreenScale())
 ```
 
+### getScreenBrightness - 获取屏幕亮度。
+
+```python
+def getScreenBrightness() -> float
+```
+
+**返回值：**
+
+| 类型    | 描述                     |
+| ------- | ------------------------ |
+| `float` | 屏幕亮度，范围 `0.0-1.0` |
+
+**示例:**
+
+```python
+from kuaijs import device
+print(device.getScreenBrightness())
+```
+
+### setScreenBrightness - 设置屏幕亮度。
+
+设置设备屏幕亮度，亮度范围为 `0.0-1.0`。
+
+```python
+def setScreenBrightness(brightness: float) -> bool
+```
+
+**参数说明：**
+
+| 参数名       | 类型    | 是否必填 | 默认值 | 描述                         |
+| ------------ | ------- | -------- | ------ | ---------------------------- |
+| `brightness` | `float` | 是       | -      | 目标屏幕亮度，范围 `0.0-1.0` |
+
+**返回值：**
+
+| 类型   | 描述                     |
+| ------ | ------------------------ |
+| `bool` | 是否设置成功 |
+
+**示例:**
+
+```python
+from kuaijs import device
+device.setScreenBrightness(0.5)
+```
+
 ### getOrientation - 获取屏幕方向。
 
 **注意事项：**

package/docs/apipython/g.md

@@ -11,7 +11,6 @@
 ## 常量
 
 - `runMode: str` 运行模式，"agent" 或 "hid"
-- `isSupportBuiltAgent: bool` 是否使用内置Agent
 - `platform: str` 平台信息（"ios" 或 "android"）
 - `appVersion: str` 应用版本号
 - `appBuildNumber: int` 应用构建号

package/docs/apipython/hid.md

@@ -785,14 +785,32 @@ hid.enter()
 ### pressButton - 按下系统按钮
 
 ```python
-def pressButton(button: Literal["home", "volumeup", "volumedown", "eject"]) -> bool
+def pressButton(
+    button: Literal[
+        "home",
+        "volumeup",
+        "volumedown",
+        "mute",
+        "playpause",
+        "next",
+        "prev",
+        "eject",
+        "globe",
+        "search",
+        "brightnessup",
+        "brightnessdown",
+        "power",
+        "menu",
+        "snapshot",
+    ],
+) -> bool
 ```
 
 **参数说明：**
 
 | 参数名   | 类型    | 是否必填 | 默认值 | 描述                                                                                                                     |
 | -------- | ------- | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `button` | Literal | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
+| `button` | Literal | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 

package/docs/httpapi/api.md

@@ -1562,6 +1562,74 @@ GET /api/control/openURL
 |---|---|---|---|---|---|
 |» success|boolean|true|none|是否成功|none|
 
+## GET 设置 Agent 快速模式
+
+GET /api/control/setAgentFastMode
+
+快速模式默认开启，设置会持久化。开启后，Agent 执行动作响应更快，但开始执行时电量可能快速消耗。
+
+### 请求参数
+
+|名称|位置|类型|必选|中文名|说明|
+|---|---|---|---|---|---|
+|enabled|query|boolean| 是 |是否开启|是否开启 Agent 快速模式|
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true,
+  "data": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+|» data|boolean|true|none|Agent 快速模式|设置后的 Agent 快速模式状态|
+
+## GET 获取 Agent 快速模式
+
+GET /api/control/getAgentFastMode
+
+### 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true,
+  "data": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+|» data|boolean|true|none|Agent 快速模式|当前 Agent 快速模式状态|
+
 ## POST W3CActions
 
 POST /api/control/w3cActions
@@ -2408,4 +2476,3 @@ GET /api/hid/mouseUp
 |orientation|LANDSCAPE|
 |serverType|international|
 |serverType|domestic|
-

package/package.json

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