ms-vite-plugin 1.3.0 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -529,14 +529,16 @@ function completeTaskAndGoHome() {
529
529
  ### pressButton - 按下系统按钮
530
530
 
531
531
  ```typescript
532
- function pressButton(button: "home" | "volumeup" | "volumedown"): boolean;
532
+ function pressButton(
533
+ button: "home" | "volumeup" | "volumedown" | "brightnessup" | "brightnessdown",
534
+ ): boolean;
533
535
  ```
534
536
 
535
537
  **参数说明:**
536
538
 
537
539
  | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
538
540
  | -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------ |
539
- | `button` | string | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
541
+ | `button` | string | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
540
542
 
541
543
  **返回值:**
542
544
 
@@ -111,7 +111,6 @@ logi(`服务器设备ID: ${serverDeviceId}`);
111
111
 
112
112
  ### getECID - 获取设备 ECID。
113
113
 
114
-
115
114
  ```typescript
116
115
  function getECID(): string;
117
116
  ```
@@ -132,7 +131,6 @@ logi(`ECID: ${ecid}`);
132
131
 
133
132
  ### getUDID - 获取设备 UDID。
134
133
 
135
-
136
134
  ```typescript
137
135
  function getUDID(): string;
138
136
  ```
@@ -271,6 +269,53 @@ const scale = device.getScreenScale();
271
269
  logi(`屏幕缩放比例: ${scale}`);
272
270
  ```
273
271
 
272
+ ### getScreenBrightness - 获取屏幕亮度。
273
+
274
+ ```typescript
275
+ function getScreenBrightness(): number;
276
+ ```
277
+
278
+ **返回值:**
279
+
280
+ | 类型 | 描述 |
281
+ | -------- | ------------------------ |
282
+ | `number` | 屏幕亮度,范围 `0.0-1.0` |
283
+
284
+ **示例:**
285
+
286
+ ```typescript
287
+ // 获取屏幕亮度
288
+ const brightness = device.getScreenBrightness();
289
+ logi(`屏幕亮度: ${brightness}`);
290
+ ```
291
+
292
+ ### setScreenBrightness - 设置屏幕亮度。
293
+
294
+ 设置设备屏幕亮度,亮度范围为 `0.0-1.0`。
295
+
296
+ ```typescript
297
+ function setScreenBrightness(brightness: number): boolean;
298
+ ```
299
+
300
+ **参数说明:**
301
+
302
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
303
+ | ------------ | -------- | -------- | ------ | ---------------------------- |
304
+ | `brightness` | `number` | 是 | - | 目标屏幕亮度,范围 `0.0-1.0` |
305
+
306
+ **返回值:**
307
+
308
+ | 类型 | 描述 |
309
+ | --------- | ------------------------ |
310
+ | `boolean` | 是否设置成功 |
311
+
312
+ **示例:**
313
+
314
+ ```typescript
315
+ // 设置屏幕亮度到 50%
316
+ device.setScreenBrightness(0.5);
317
+ ```
318
+
274
319
  ### getOrientation - 获取屏幕方向。
275
320
 
276
321
  **注意事项**
@@ -12,6 +12,7 @@
12
12
  - **脚本生命周期**: 设置停止回调、异常回调、重启脚本等
13
13
  - **时间工具**: 获取时间戳
14
14
  - **应用控制**: 切换应用到前台
15
+ - **Agent 设置**: 读取和设置 Agent 快速模式
15
16
 
16
17
  ## 全局常量
17
18
 
@@ -31,22 +32,6 @@ declare const __runMode__: "agent" | "hid";
31
32
  logi(`运行模式: ${__runMode__}`);
32
33
  ```
33
34
 
34
- ### 是否使用内置Agent
35
-
36
- #### **isSupportBuiltAgent**
37
-
38
- 是否使用内置 Agent。
39
-
40
- ```typescript
41
- declare const __isSupportBuiltAgent__: boolean;
42
- ```
43
-
44
- **示例:**
45
-
46
- ```javascript
47
- logi(`是否使用内置Agent: ${__isSupportBuiltAgent__}`);
48
- ```
49
-
50
35
  ### 调试和状态
51
36
 
52
37
  #### **debug**
@@ -308,6 +293,55 @@ takeMeToFront();
308
293
  logi("应用已切换到前台");
309
294
  ```
310
295
 
296
+ ### setAgentFastMode
297
+
298
+ 设置 Agent 快速模式。快速模式默认开启,设置会持久化。开启后,Agent 执行动作响应更快,但开始执行时电量可能快速消耗。
299
+
300
+ ```typescript
301
+ function setAgentFastMode(enabled: boolean): boolean;
302
+ ```
303
+
304
+ **参数:**
305
+
306
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
307
+ | --------- | --------- | -------- | ------ | ---------------- |
308
+ | `enabled` | `boolean` | 是 | - | 是否开启快速模式 |
309
+
310
+ **返回值:**
311
+
312
+ | 类型 | 描述 |
313
+ | --------- | -------------------- |
314
+ | `boolean` | 实际是否开启快速模式 |
315
+
316
+ **示例:**
317
+
318
+ ```javascript
319
+ const enabled = setAgentFastMode(true);
320
+ logi(`Agent 快速模式: ${enabled}`);
321
+ ```
322
+
323
+ ### getAgentFastMode
324
+
325
+ 获取 Agent 快速模式当前状态。快速模式默认开启,设置会持久化。
326
+
327
+ ```typescript
328
+ function getAgentFastMode(): boolean;
329
+ ```
330
+
331
+ **返回值:**
332
+
333
+ | 类型 | 描述 |
334
+ | --------- | -------------------- |
335
+ | `boolean` | 当前是否开启快速模式 |
336
+
337
+ **示例:**
338
+
339
+ ```javascript
340
+ if (getAgentFastMode()) {
341
+ logi("Agent 快速模式已开启");
342
+ }
343
+ ```
344
+
311
345
  ### setStopCallback
312
346
 
313
347
  设置停止回调函数(仅主线程调用)。
package/docs/api/hid.md CHANGED
@@ -761,7 +761,22 @@ hid.enter();
761
761
 
762
762
  ```typescript
763
763
  function pressButton(
764
- button: "home" | "volumeup" | "volumedown" | "eject",
764
+ button:
765
+ | "home"
766
+ | "volumeup"
767
+ | "volumedown"
768
+ | "mute"
769
+ | "playpause"
770
+ | "next"
771
+ | "prev"
772
+ | "eject"
773
+ | "globe"
774
+ | "search"
775
+ | "brightnessup"
776
+ | "brightnessdown"
777
+ | "power"
778
+ | "menu"
779
+ | "snapshot",
765
780
  ): boolean;
766
781
  ```
767
782
 
@@ -769,7 +784,7 @@ function pressButton(
769
784
 
770
785
  | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
771
786
  | -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
772
- | `button` | string | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
787
+ | `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"` 系统截图键 |
773
788
 
774
789
  **返回值:**
775
790
 
@@ -789,6 +804,12 @@ hid.pressButton("volumeup");
789
804
  // 调低音量
790
805
  hid.pressButton("volumedown");
791
806
 
807
+ // 调高屏幕亮度
808
+ hid.pressButton("brightnessup");
809
+
810
+ // 触发系统截图
811
+ hid.pressButton("snapshot");
812
+
792
813
  // 连续调节音量
793
814
  for (let i = 0; i < 5; i++) {
794
815
  hid.pressButton("volumeup");
package/docs/api/http.md CHANGED
@@ -13,7 +13,7 @@ function request(params: {
13
13
  method?: string;
14
14
  proxy?: { host: string; port: number };
15
15
  followRedirects?: boolean;
16
- requestBody?: string;
16
+ requestBody?: string | ArrayBuffer;
17
17
  userAgent?: string;
18
18
  ignoreContentType?: boolean;
19
19
  ignoreHttpErrors?: boolean;
@@ -44,7 +44,7 @@ function request(params: {
44
44
  | `method` | string | 否 | GET | 请求方法(GET、POST 等) |
45
45
  | `proxy` | object | 否 | - | 代理服务器配置 |
46
46
  | `followRedirects` | boolean | 否 | true | 是否跟随重定向 |
47
- | `requestBody` | string | 否 | - | 请求体(POST 等方法使用) |
47
+ | `requestBody` | string \| ArrayBuffer | 否 | - | 请求体,JSON 对象需先 JSON.stringify |
48
48
  | `userAgent` | string | 否 | - | 用户代理字符串 |
49
49
  | `ignoreContentType` | boolean | 否 | false | 是否忽略内容类型 |
50
50
  | `ignoreHttpErrors` | boolean | 否 | false | 是否忽略 HTTP 错误 |
@@ -520,14 +520,16 @@ function completeTaskAndGoHome() {
520
520
  ### 按键 - 按下系统按钮
521
521
 
522
522
  ```typescript
523
- function 按键(按键: "home" | "volumeup" | "volumedown"): 布尔值;
523
+ function 按键(
524
+ 按键: "home" | "volumeup" | "volumedown" | "brightnessup" | "brightnessdown",
525
+ ): 布尔值;
524
526
  ```
525
527
 
526
528
  **参数说明:**
527
529
 
528
530
  | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
529
531
  | ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------ |
530
- | `按键` | 字符串 | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
532
+ | `按键` | 字符串 | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
531
533
 
532
534
  **返回值:**
533
535
 
@@ -111,7 +111,6 @@ $打印信息日志(`服务器设备ID: ${serverDeviceId}`);
111
111
 
112
112
  ### 获取 ECID
113
113
 
114
-
115
114
  ```typescript
116
115
  function 获取ECID(): 字符串;
117
116
  ```
@@ -132,7 +131,6 @@ $打印信息日志(`ECID: ${ecid}`);
132
131
 
133
132
  ### 获取 UDID
134
133
 
135
-
136
134
  ```typescript
137
135
  function 获取UDID(): 字符串;
138
136
  ```
@@ -285,6 +283,53 @@ const scale = $设备.获取屏幕缩放比例();
285
283
  $打印信息日志(`屏幕缩放比例: ${scale}`);
286
284
  ```
287
285
 
286
+ ### 获取屏幕亮度
287
+
288
+ ```typescript
289
+ function 获取屏幕亮度(): 数字;
290
+ ```
291
+
292
+ **返回值:**
293
+
294
+ | 类型 | 描述 |
295
+ | ---- | ------------------------ |
296
+ | 数字 | 屏幕亮度,范围 `0.0-1.0` |
297
+
298
+ **示例:**
299
+
300
+ ```typescript
301
+ // 获取屏幕亮度
302
+ const 屏幕亮度 = $设备.获取屏幕亮度();
303
+ $打印信息日志(`屏幕亮度: ${屏幕亮度}`);
304
+ ```
305
+
306
+ ### 设置屏幕亮度
307
+
308
+ 设置设备屏幕亮度,亮度范围为 `0.0-1.0`。
309
+
310
+ ```typescript
311
+ function 设置屏幕亮度(亮度: 数字): 布尔值;
312
+ ```
313
+
314
+ **参数说明:**
315
+
316
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
317
+ | ------ | ---- | -------- | ------ | ---------------------------- |
318
+ | `亮度` | 数字 | 是 | - | 目标屏幕亮度,范围 `0.0-1.0` |
319
+
320
+ **返回值:**
321
+
322
+ | 类型 | 描述 |
323
+ | ------ | ------------------------ |
324
+ | 布尔值 | 是否设置成功 |
325
+
326
+ **示例:**
327
+
328
+ ```typescript
329
+ // 设置屏幕亮度到 50%
330
+ $设备.设置屏幕亮度(0.5);
331
+ ```
332
+
288
333
  ### 获取屏幕方向
289
334
 
290
335
  **注意事项**
@@ -12,6 +12,7 @@
12
12
  - **脚本生命周期**: 设置停止回调、异常回调、重启脚本等
13
13
  - **时间工具**: 获取时间戳
14
14
  - **应用控制**: 切换应用到前台
15
+ - **Agent 设置**: 读取和设置 Agent 快速模式
15
16
 
16
17
  ## 全局常量
17
18
 
@@ -33,22 +34,6 @@ declare const $运行模式: "agent" | "hid";
33
34
  $打印信息日志(`运行模式: ${$运行模式}`);
34
35
  ```
35
36
 
36
- ### 是否使用内置Agent
37
-
38
- #### **$是否内置Agent**
39
-
40
- 是否使用内置 Agent。
41
-
42
- ```typescript
43
- declare const $是否内置Agent: 布尔值;
44
- ```
45
-
46
- **示例:**
47
-
48
- ```javascript
49
- $打印信息日志(`是否使用内置Agent: ${$是否内置Agent}`);
50
- ```
51
-
52
37
  ### 调试和状态
53
38
 
54
39
  #### **$是否调试**
@@ -309,6 +294,55 @@ $APP切入前台();
309
294
  $打印信息日志("应用已切换到前台");
310
295
  ```
311
296
 
297
+ ### $设置 Agent 快速模式
298
+
299
+ 设置 Agent 快速模式。快速模式默认开启,设置会持久化。开启后,Agent 执行动作响应更快,但开始执行时电量可能快速消耗。
300
+
301
+ ```typescript
302
+ declare function $设置Agent快速模式(是否开启: 布尔值): 布尔值;
303
+ ```
304
+
305
+ **参数:**
306
+
307
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
308
+ | ---------- | -------- | -------- | ------ | ---------------- |
309
+ | `是否开启` | `布尔值` | 是 | - | 是否开启快速模式 |
310
+
311
+ **返回值:**
312
+
313
+ | 类型 | 描述 |
314
+ | -------- | -------------------- |
315
+ | `布尔值` | 实际是否开启快速模式 |
316
+
317
+ **示例:**
318
+
319
+ ```javascript
320
+ const 是否开启 = $设置Agent快速模式(true);
321
+ $打印信息日志(`Agent 快速模式: ${是否开启}`);
322
+ ```
323
+
324
+ ### $获取 Agent 快速模式
325
+
326
+ 获取 Agent 快速模式当前状态。快速模式默认开启,设置会持久化。
327
+
328
+ ```typescript
329
+ declare function $获取Agent快速模式(): 布尔值;
330
+ ```
331
+
332
+ **返回值:**
333
+
334
+ | 类型 | 描述 |
335
+ | -------- | -------------------- |
336
+ | `布尔值` | 当前是否开启快速模式 |
337
+
338
+ **示例:**
339
+
340
+ ```javascript
341
+ if ($获取Agent快速模式()) {
342
+ $打印信息日志("Agent 快速模式已开启");
343
+ }
344
+ ```
345
+
312
346
  ### $设置停止回调
313
347
 
314
348
  设置停止回调函数(仅主线程调用)。
package/docs/apicn/hid.md CHANGED
@@ -760,14 +760,31 @@ $HID.回车键();
760
760
  ### 按键 - 按下系统按钮
761
761
 
762
762
  ```typescript
763
- function 按键(按键: "home" | "volumeup" | "volumedown" | "eject"): 布尔值;
763
+ function 按键(
764
+ 按键:
765
+ | "home"
766
+ | "volumeup"
767
+ | "volumedown"
768
+ | "mute"
769
+ | "playpause"
770
+ | "next"
771
+ | "prev"
772
+ | "eject"
773
+ | "globe"
774
+ | "search"
775
+ | "brightnessup"
776
+ | "brightnessdown"
777
+ | "power"
778
+ | "menu"
779
+ | "snapshot",
780
+ ): 布尔值;
764
781
  ```
765
782
 
766
783
  **参数说明:**
767
784
 
768
785
  | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
769
786
  | ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
770
- | `按键` | 字符串 | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
787
+ | `按键` | 字符串 | 是 | - | 按钮类型: <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"` 系统截图键 |
771
788
 
772
789
  **返回值:**
773
790
 
@@ -787,6 +804,12 @@ $HID.按键("volumeup");
787
804
  // 调低音量
788
805
  $HID.按键("volumedown");
789
806
 
807
+ // 调高屏幕亮度
808
+ $HID.按键("brightnessup");
809
+
810
+ // 触发系统截图
811
+ $HID.按键("snapshot");
812
+
790
813
  // 连续调节音量
791
814
  for (let i = 0; i < 5; i++) {
792
815
  const 是否成功 = $HID.按键("volumeup");
@@ -38,9 +38,9 @@ function 发送请求(params: {
38
38
  */
39
39
  followRedirects?: 布尔值;
40
40
  /**
41
- * 请求体 仅在POST方法下有效 json 需要进行JSON.stringify
41
+ * 请求体,支持字符串或二进制数据;JSON 对象需要先 JSON.stringify
42
42
  */
43
- requestBody?: 字符串;
43
+ requestBody?: 字符串 | ArrayBuffer;
44
44
  /**
45
45
  * 请求头
46
46
  */
@@ -122,7 +122,7 @@ function 发送请求(params: {
122
122
  | `method` | 字符串 | 否 | GET | 请求方法(GET、POST 等) |
123
123
  | `proxy` | 对象 | 否 | - | 代理服务器配置 |
124
124
  | `followRedirects` | 布尔值 | 否 | true | 是否跟随重定向 |
125
- | `requestBody` | 字符串 | 否 | - | 请求体(POST 等方法使用) |
125
+ | `requestBody` | 字符串 \| ArrayBuffer | 否 | - | 请求体,JSON 对象需先 JSON.stringify |
126
126
  | `userAgent` | 字符串 | 否 | - | 用户代理字符串 |
127
127
  | `ignoreContentType` | 布尔值 | 否 | false | 是否忽略内容类型 |
128
128
  | `ignoreHttpErrors` | 布尔值 | 否 | false | 是否忽略 HTTP 错误 |
@@ -498,14 +498,16 @@ def completeTaskAndGoHome():
498
498
  ### pressButton - 按下系统按钮
499
499
 
500
500
  ```python
501
- def pressButton(button: Literal["home", "volumeup", "volumedown"]) -> bool
501
+ def pressButton(
502
+ button: Literal["home", "volumeup", "volumedown", "brightnessup", "brightnessdown"],
503
+ ) -> bool
502
504
  ```
503
505
 
504
506
  **参数说明:**
505
507
 
506
508
  | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
507
509
  | -------- | ------- | -------- | ------ | ------------------------------------------------------------------------------------------ |
508
- | `button` | Literal | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
510
+ | `button` | Literal | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
509
511
 
510
512
  **返回值:**
511
513
 
@@ -115,7 +115,6 @@ print(device.getServerDeviceId())
115
115
 
116
116
  ### getECID - 获取设备 ECID。
117
117
 
118
-
119
118
  ```python
120
119
  def getECID() -> str
121
120
  ```
@@ -135,7 +134,6 @@ print(device.getECID())
135
134
 
136
135
  ### getUDID - 获取设备 UDID。
137
136
 
138
-
139
137
  ```python
140
138
  def getUDID() -> str
141
139
  ```
@@ -266,6 +264,52 @@ from kuaijs import device
266
264
  print(device.getScreenScale())
267
265
  ```
268
266
 
267
+ ### getScreenBrightness - 获取屏幕亮度。
268
+
269
+ ```python
270
+ def getScreenBrightness() -> float
271
+ ```
272
+
273
+ **返回值:**
274
+
275
+ | 类型 | 描述 |
276
+ | ------- | ------------------------ |
277
+ | `float` | 屏幕亮度,范围 `0.0-1.0` |
278
+
279
+ **示例:**
280
+
281
+ ```python
282
+ from kuaijs import device
283
+ print(device.getScreenBrightness())
284
+ ```
285
+
286
+ ### setScreenBrightness - 设置屏幕亮度。
287
+
288
+ 设置设备屏幕亮度,亮度范围为 `0.0-1.0`。
289
+
290
+ ```python
291
+ def setScreenBrightness(brightness: float) -> bool
292
+ ```
293
+
294
+ **参数说明:**
295
+
296
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
297
+ | ------------ | ------- | -------- | ------ | ---------------------------- |
298
+ | `brightness` | `float` | 是 | - | 目标屏幕亮度,范围 `0.0-1.0` |
299
+
300
+ **返回值:**
301
+
302
+ | 类型 | 描述 |
303
+ | ------ | ------------------------ |
304
+ | `bool` | 是否设置成功 |
305
+
306
+ **示例:**
307
+
308
+ ```python
309
+ from kuaijs import device
310
+ device.setScreenBrightness(0.5)
311
+ ```
312
+
269
313
  ### getOrientation - 获取屏幕方向。
270
314
 
271
315
  **注意事项:**
@@ -6,11 +6,11 @@
6
6
 
7
7
  - 应用信息常量:版本号/构建号/名称/包名
8
8
  - 前台切换:将宿主应用切到前台
9
+ - Agent 设置:读取和设置 Agent 快速模式
9
10
 
10
11
  ## 常量
11
12
 
12
13
  - `runMode: str` 运行模式,"agent" 或 "hid"
13
- - `isSupportBuiltAgent: bool` 是否使用内置Agent
14
14
  - `platform: str` 平台信息("ios" 或 "android")
15
15
  - `appVersion: str` 应用版本号
16
16
  - `appBuildNumber: int` 应用构建号
@@ -54,6 +54,53 @@ from kuaijs import g
54
54
  g.takeMeToFront()
55
55
  ```
56
56
 
57
+ #### `setAgentFastMode` - 设置 Agent 快速模式
58
+
59
+ 快速模式默认开启,设置会持久化。开启后,Agent 执行动作响应更快,但开始执行时电量可能快速消耗。
60
+
61
+ ```python
62
+ def setAgentFastMode(enabled: bool) -> bool
63
+ ```
64
+
65
+ **参数:**
66
+ | 参数 | 类型 | 必需 | 默认值 | 描述 |
67
+ | ---- | ---- | ---- | ------ | ---- |
68
+ | `enabled` | bool | 是 | - | 是否开启快速模式 |
69
+
70
+ **返回值:**
71
+
72
+ - `bool` 实际是否开启快速模式
73
+
74
+ **示例:**
75
+
76
+ ```python
77
+ from kuaijs import g
78
+
79
+ enabled = g.setAgentFastMode(True)
80
+ print(f"Agent 快速模式: {enabled}")
81
+ ```
82
+
83
+ #### `getAgentFastMode` - 获取 Agent 快速模式
84
+
85
+ 快速模式默认开启,设置会持久化。
86
+
87
+ ```python
88
+ def getAgentFastMode() -> bool
89
+ ```
90
+
91
+ **返回值:**
92
+
93
+ - `bool` 当前是否开启快速模式
94
+
95
+ **示例:**
96
+
97
+ ```python
98
+ from kuaijs import g
99
+
100
+ if g.getAgentFastMode():
101
+ print("Agent 快速模式已开启")
102
+ ```
103
+
57
104
  #### `restartScript` - 重启脚本
58
105
 
59
106
  ```python
@@ -785,14 +785,32 @@ hid.enter()
785
785
  ### pressButton - 按下系统按钮
786
786
 
787
787
  ```python
788
- def pressButton(button: Literal["home", "volumeup", "volumedown", "eject"]) -> bool
788
+ def pressButton(
789
+ button: Literal[
790
+ "home",
791
+ "volumeup",
792
+ "volumedown",
793
+ "mute",
794
+ "playpause",
795
+ "next",
796
+ "prev",
797
+ "eject",
798
+ "globe",
799
+ "search",
800
+ "brightnessup",
801
+ "brightnessdown",
802
+ "power",
803
+ "menu",
804
+ "snapshot",
805
+ ],
806
+ ) -> bool
789
807
  ```
790
808
 
791
809
  **参数说明:**
792
810
 
793
811
  | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
794
812
  | -------- | ------- | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
795
- | `button` | Literal | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
813
+ | `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"` 系统截图键 |
796
814
 
797
815
  **返回值:**
798
816
 
@@ -1562,6 +1562,74 @@ GET /api/control/openURL
1562
1562
  |---|---|---|---|---|---|
1563
1563
  |» success|boolean|true|none|是否成功|none|
1564
1564
 
1565
+ ## GET 设置 Agent 快速模式
1566
+
1567
+ GET /api/control/setAgentFastMode
1568
+
1569
+ 快速模式默认开启,设置会持久化。开启后,Agent 执行动作响应更快,但开始执行时电量可能快速消耗。
1570
+
1571
+ ### 请求参数
1572
+
1573
+ |名称|位置|类型|必选|中文名|说明|
1574
+ |---|---|---|---|---|---|
1575
+ |enabled|query|boolean| 是 |是否开启|是否开启 Agent 快速模式|
1576
+
1577
+ > 返回示例
1578
+
1579
+ > 200 Response
1580
+
1581
+ ```json
1582
+ {
1583
+ "success": true,
1584
+ "data": true
1585
+ }
1586
+ ```
1587
+
1588
+ ### 返回结果
1589
+
1590
+ |状态码|状态码含义|说明|数据模型|
1591
+ |---|---|---|---|
1592
+ |200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
1593
+
1594
+ ### 返回数据结构
1595
+
1596
+ 状态码 **200**
1597
+
1598
+ |名称|类型|必选|约束|中文名|说明|
1599
+ |---|---|---|---|---|---|
1600
+ |» success|boolean|true|none|是否成功|none|
1601
+ |» data|boolean|true|none|Agent 快速模式|设置后的 Agent 快速模式状态|
1602
+
1603
+ ## GET 获取 Agent 快速模式
1604
+
1605
+ GET /api/control/getAgentFastMode
1606
+
1607
+ ### 返回示例
1608
+
1609
+ > 200 Response
1610
+
1611
+ ```json
1612
+ {
1613
+ "success": true,
1614
+ "data": true
1615
+ }
1616
+ ```
1617
+
1618
+ ### 返回结果
1619
+
1620
+ |状态码|状态码含义|说明|数据模型|
1621
+ |---|---|---|---|
1622
+ |200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
1623
+
1624
+ ### 返回数据结构
1625
+
1626
+ 状态码 **200**
1627
+
1628
+ |名称|类型|必选|约束|中文名|说明|
1629
+ |---|---|---|---|---|---|
1630
+ |» success|boolean|true|none|是否成功|none|
1631
+ |» data|boolean|true|none|Agent 快速模式|当前 Agent 快速模式状态|
1632
+
1565
1633
  ## POST W3CActions
1566
1634
 
1567
1635
  POST /api/control/w3cActions
@@ -2408,4 +2476,3 @@ GET /api/hid/mouseUp
2408
2476
  |orientation|LANDSCAPE|
2409
2477
  |serverType|international|
2410
2478
  |serverType|domestic|
2411
-
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ms-vite-plugin",
3
- "version": "1.3.0",
3
+ "version": "1.3.2",
4
4
  "type": "commonjs",
5
5
  "license": "MIT",
6
6
  "publishConfig": {