ms-vite-plugin 1.4.41 → 1.4.45

package/docs/apicn/global.md

@@ -12,7 +12,7 @@
 - **脚本生命周期**: 设置停止回调、异常回调、重启脚本等
 - **时间工具**: 获取时间戳
 - **应用控制**: 切换应用到前台
-- **Agent 设置**: 读取和设置 Agent 快速模式
+- **Agent 设置**: 读取和设置 Agent 触控模式
 
 ## 全局常量
 
@@ -310,7 +310,7 @@ $打印信息日志("应用已切换到前台");
 
 ### $设置 Agent 快速模式
 
-设置 Agent 快速模式。快速模式默认开启，设置会持久化。开启后，Agent 执行动作响应更快，但开始执行时电量可能快速消耗。
+设置 Agent 快速模式（兼容旧接口）。开启对应模式 `1`，关闭对应模式 `0`。推荐改用 `$设置Agent触控模式`。设置会持久化。
 
 ```typescript
 declare function $设置Agent快速模式(是否开启: 布尔值): 布尔值;
@@ -337,7 +337,7 @@ $打印信息日志(`Agent 快速模式: ${是否开启}`);
 
 ### $获取 Agent 快速模式
 
-获取 Agent 快速模式当前状态。快速模式默认开启，设置会持久化。
+获取 Agent 快速模式当前状态（兼容旧接口）。
 
 ```typescript
 declare function $获取Agent快速模式(): 布尔值;
@@ -357,6 +357,58 @@ if ($获取Agent快速模式()) {
 }
 ```
 
+### $设置 Agent 触控模式
+
+设置 Agent 触控模式。默认 `1`，设置会持久化。
+
+- `0` 标准：等待完整执行完成
+- `1` 快速：更快的执行速度
+- `2` 真实点击：更接近真实手指触控
+
+```typescript
+declare function $设置Agent触控模式(模式: 数字): 数字;
+```
+
+**参数:**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述                         |
+| ------ | ------ | -------- | ------ | ---------------------------- |
+| `模式` | `数字` | 是       | -      | 0 标准 / 1 快速 / 2 真实点击 |
+
+**返回值:**
+
+| 类型   | 描述           |
+| ------ | -------------- |
+| `数字` | 实际生效的模式 |
+
+**示例:**
+
+```javascript
+const 模式 = $设置Agent触控模式(1);
+$打印信息日志(`Agent 触控模式: ${模式}`);
+```
+
+### $获取 Agent 触控模式
+
+获取 Agent 触控模式。默认 `1`，设置会持久化。
+
+```typescript
+declare function $获取Agent触控模式(): 数字;
+```
+
+**返回值:**
+
+| 类型   | 描述              |
+| ------ | ----------------- |
+| `数字` | 当前模式（0/1/2） |
+
+**示例:**
+
+```javascript
+const 模式 = $获取Agent触控模式();
+$打印信息日志(`当前触控模式: ${模式}`);
+```
+
 ### $设置CPU自动限流
 
 设置脚本 CPU 自动限流。默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险。
@@ -411,7 +463,10 @@ if ($获取CPU自动限流()) {
 设置 CPU 限流单次 sleep 延迟范围（毫秒）。默认 `minMs=3`、`maxMs=30`。仅在 CPU 自动限流开启且触发限流时生效。
 
 ```typescript
-declare function $设置CPU限流延迟(最小毫秒: 数字, 最大毫秒: 数字): { minMs: 数字; maxMs: 数字 };
+declare function $设置CPU限流延迟(
+  最小毫秒: 数字,
+  最大毫秒: 数字,
+): { minMs: 数字; maxMs: 数字 };
 ```
 
 **参数:**
@@ -423,8 +478,8 @@ declare function $设置CPU限流延迟(最小毫秒: 数字, 最大毫秒: 数
 
 **返回值:**
 
-| 类型                        | 描述               |
-| --------------------------- | ------------------ |
+| 类型                           | 描述               |
+| ------------------------------ | ------------------ |
 | `{ minMs: 数字; maxMs: 数字 }` | 实际生效的延迟范围 |
 
 **示例:**
@@ -444,8 +499,8 @@ declare function $获取CPU限流延迟(): { minMs: 数字; maxMs: 数字 };
 
 **返回值:**
 
-| 类型                        | 描述               |
-| --------------------------- | ------------------ |
+| 类型                           | 描述               |
+| ------------------------------ | ------------------ |
 | `{ minMs: 数字; maxMs: 数字 }` | 当前最低与最高延迟 |
 
 **示例:**
@@ -467,8 +522,8 @@ declare const $设置停止回调: (
 
 **参数:**
 
-| 参数名 | 类型                                                       | 是否必填 | 默认值 | 描述         |
-| ------ | ---------------------------------------------------------- | -------- | ------ | ------------ |
+| 参数名 | 类型                                                  | 是否必填 | 默认值 | 描述         |
+| ------ | ----------------------------------------------------- | -------- | ------ | ------------ |
 | `回调` | (状态: "success" \| "error" \| "stopped") => 无返回值 | 是       | -      | 停止回调函数 |
 
 **说明:**