ms-vite-plugin 1.4.41 → 1.4.45

package/docs/api/global.md

@@ -12,7 +12,7 @@
 - **脚本生命周期**: 设置停止回调、异常回调、重启脚本等
 - **时间工具**: 获取时间戳
 - **应用控制**: 切换应用到前台
-- **Agent 设置**: 读取和设置 Agent 快速模式
+- **Agent 设置**: 读取和设置 Agent 触控模式
 
 ## 全局常量
 
@@ -309,7 +309,7 @@ logi("应用已切换到前台");
 
 ### setAgentFastMode
 
-设置 Agent 快速模式。快速模式默认开启，设置会持久化。开启后，Agent 执行动作响应更快，但开始执行时电量可能快速消耗。
+设置 Agent 快速模式（兼容旧接口）。开启对应模式 `1`，关闭对应模式 `0`。推荐改用 `setAgentTouchMode`。设置会持久化。
 
 ```typescript
 function setAgentFastMode(enabled: boolean): boolean;
@@ -336,7 +336,7 @@ logi(`Agent 快速模式: ${enabled}`);
 
 ### getAgentFastMode
 
-获取 Agent 快速模式当前状态。快速模式默认开启，设置会持久化。
+获取 Agent 快速模式当前状态（兼容旧接口）。
 
 ```typescript
 function getAgentFastMode(): boolean;
@@ -356,6 +356,58 @@ if (getAgentFastMode()) {
 }
 ```
 
+### setAgentTouchMode
+
+设置 Agent 触控模式。默认 `1`，设置会持久化。
+
+- `0` 标准：等待完整执行完成
+- `1` 快速：更快的执行速度
+- `2` 真实点击：更接近真实手指触控
+
+```typescript
+function setAgentTouchMode(mode: number): number;
+```
+
+**参数:**
+
+| 参数名 | 类型     | 是否必填 | 默认值 | 描述                         |
+| ------ | -------- | -------- | ------ | ---------------------------- |
+| `mode` | `number` | 是       | -      | 0 标准 / 1 快速 / 2 真实点击 |
+
+**返回值:**
+
+| 类型     | 描述           |
+| -------- | -------------- |
+| `number` | 实际生效的模式 |
+
+**示例:**
+
+```javascript
+const mode = setAgentTouchMode(1);
+logi(`Agent 触控模式: ${mode}`);
+```
+
+### getAgentTouchMode
+
+获取 Agent 触控模式。默认 `1`，设置会持久化。
+
+```typescript
+function getAgentTouchMode(): number;
+```
+
+**返回值:**
+
+| 类型     | 描述              |
+| -------- | ----------------- |
+| `number` | 当前模式（0/1/2） |
+
+**示例:**
+
+```javascript
+const mode = getAgentTouchMode();
+logi(`当前触控模式: ${mode}`);
+```
+
 ### setCpuAutoThrottle
 
 设置脚本 CPU 自动限流。默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险。
@@ -410,21 +462,24 @@ if (getCpuAutoThrottle()) {
 设置 CPU 限流单次 sleep 延迟范围（毫秒）。默认 `minMs=3`、`maxMs=30`。仅在 CPU 自动限流开启且触发限流时生效。
 
 ```typescript
-function setCpuThrottleDelay(minMs: number, maxMs: number): { minMs: number; maxMs: number };
+function setCpuThrottleDelay(
+  minMs: number,
+  maxMs: number,
+): { minMs: number; maxMs: number };
 ```
 
 **参数:**
 
-| 参数名   | 类型     | 是否必填 | 默认值 | 描述                               |
-| -------- | -------- | -------- | ------ | ---------------------------------- |
-| `minMs`  | `number` | 是       | -      | 最低延迟（毫秒）                   |
-| `maxMs`  | `number` | 是       | -      | 最高延迟（毫秒）；小于 minMs 时自动对齐 |
+| 参数名  | 类型     | 是否必填 | 默认值 | 描述                                    |
+| ------- | -------- | -------- | ------ | --------------------------------------- |
+| `minMs` | `number` | 是       | -      | 最低延迟（毫秒）                        |
+| `maxMs` | `number` | 是       | -      | 最高延迟（毫秒）；小于 minMs 时自动对齐 |
 
 **返回值:**
 
-| 类型                              | 描述                 |
-| --------------------------------- | -------------------- |
-| `{ minMs: number; maxMs: number }` | 实际生效的延迟范围   |
+| 类型                               | 描述               |
+| ---------------------------------- | ------------------ |
+| `{ minMs: number; maxMs: number }` | 实际生效的延迟范围 |
 
 **示例:**
 
@@ -443,8 +498,8 @@ function getCpuThrottleDelay(): { minMs: number; maxMs: number };
 
 **返回值:**
 
-| 类型                              | 描述               |
-| --------------------------------- | ------------------ |
+| 类型                               | 描述               |
+| ---------------------------------- | ------------------ |
 | `{ minMs: number; maxMs: number }` | 当前最低与最高延迟 |
 
 **示例:**
@@ -466,8 +521,8 @@ function setStopCallback(
 
 **参数:**
 
-| 参数名     | 类型                                                   | 是否必填 | 默认值 | 描述         |
-| ---------- | ------------------------------------------------------ | -------- | ------ | ------------ |
+| 参数名     | 类型                                                | 是否必填 | 默认值 | 描述         |
+| ---------- | --------------------------------------------------- | -------- | ------ | ------------ |
 | `callback` | (status: "success" \| "error" \| "stopped") => void | 是       | -      | 停止回调函数 |
 
 **说明:**