ms-vite-plugin 1.4.43 → 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 | 是       | -      | 停止回调函数 |
 
 **说明:**

package/docs/api/node.md

@@ -73,15 +73,15 @@ const listPage = createNodeSelector({ mode: 2 });
 | 方法 | 说明 |
 | --- | --- |
 | `hittable()` | 当前是否可点击（可见且未被挡住） |
-| `scrollToVisible()` | 滚动到可见区域 |
-| `tap()` | 单击（不可见时会先尝试滚到可见） |
-| `doubleTap()` | 双击 |
-| `press(duration?)` | 长按，`duration` 单位毫秒，默认 500 |
-| `clickCenter()` | 点击中心坐标 |
-| `clickRandom()` | 在节点范围内随机点击 |
-| `clearInput()` | 清空输入内容 |
-| `input(text)` | 追加输入（不先清空） |
-| `setValue(text)` | 设置值（见下方） |
+| `scrollToVisible()` | 仅滚动到可见，不点击；一般不必手动调用 |
+| `tap()` | 单击；不可见时会先自动滚到可见 |
+| `doubleTap()` | 双击；不可见时会先自动滚到可见 |
+| `press(duration?)` | 长按，`duration` 单位毫秒，默认 500；不可见时会先自动滚到可见 |
+| `clickCenter()` | 点击中心坐标（坐标点击，不会自动滚动） |
+| `clickRandom()` | 在节点范围内随机点击（坐标点击，不会自动滚动） |
+| `clearInput()` | 清空输入内容（内部会先 `tap` 聚焦，因而也会自动滚到可见） |
+| `input(text)` | 追加输入（不先清空；内部会先 `tap` 聚焦） |
+| `setValue(text)` | 设置值（见下方；不可见时会先自动滚到可见） |
 | `parent()` | 父节点 |
 | `child(index)` | 第 `index` 个子节点 |
 | `allChildren()` | 全部子节点 |
@@ -170,28 +170,29 @@ selector
 
 ### 是否可点 / 滚到可见
 
+`tap` / `doubleTap` / `press` / `setValue`（以及内部会先 `tap` 的 `clearInput` / `input`）在元素当前不可见时，会**自动**先滚到可见再操作，一般不用手写滚动：
+
 ```typescript
-if (node.hittable()) {
-  node.tap();
-} else {
-  node.scrollToVisible();
-  node.tap();
-}
+// 推荐：直接操作，不可见时会自动滚到可见
+node.tap();
+node.doubleTap();
+node.press(800);
+node.setValue("hello");
 ```
 
-- `hittable()`：当前能否点到  
-- `scrollToVisible()`：手动滚到可见  
-- `tap` / `doubleTap` / `press`：不可见时会自动尝试滚到可见再操作  
+- `hittable()`：当前能否点到（可见且未被挡住），用于排查“点了没反应”
+- `scrollToVisible()`：只滚到可见、不点击；仅在你想先露出元素、稍后再操作时使用
+- `clickCenter()` / `clickRandom()`：按坐标点击，**不会**自动滚动
 
 ### 点击
 
 | 方法 | 说明 |
 | --- | --- |
-| `tap()` | 推荐，单击 |
-| `doubleTap()` | 双击 |
-| `press(ms?)` | 长按，默认 500ms |
-| `clickCenter()` | 点中心坐标 |
-| `clickRandom()` | 范围内随机点 |
+| `tap()` | 推荐，单击；不可见时自动滚到可见 |
+| `doubleTap()` | 双击；不可见时自动滚到可见 |
+| `press(ms?)` | 长按，默认 500ms；不可见时自动滚到可见 |
+| `clickCenter()` | 点中心坐标，不自动滚动 |
+| `clickRandom()` | 范围内随机点，不自动滚动 |
 
 ```typescript
 const btn = selector
@@ -210,15 +211,15 @@ if (btn) {
 
 | 方法 | 说明 |
 | --- | --- |
-| `clearInput()` | 清空 |
-| `input(text)` | 追加输入，不清空原内容 |
-| `setValue(text)` | 按控件类型设置 |
+| `clearInput()` | 清空（内部先 `tap` 聚焦，不可见时也会自动滚到可见） |
+| `input(text)` | 追加输入，不清空原内容（内部先 `tap` 聚焦） |
+| `setValue(text)` | 按控件类型设置；不可见时会先自动滚到可见 |
 
 **`setValue` 行为**
 
 | 控件类型 | 传参 | 效果 |
 | --- | --- | --- |
-| `PickerWheel` | 选项文案，如 `"1小时"` | 滚到该选项 |
+| `PickerWheel` | 选项文案，如 `"1小时"` | 滚到该选项（控件本身不可见时也会先自动滚到可见） |
 | 文本框类（TextField 等） | 字符串 | 聚焦后追加输入，不先清空 |
 
 覆盖原内容请先清空：
@@ -234,6 +235,7 @@ field.input("hello");
 ```typescript
 const wheel = selector.type("XCUIElementTypePickerWheel").getOneNodeInfo(3000);
 if (wheel) {
+  // 不可见时会自动滚到可见，再调到目标选项
   wheel.setValue("1小时");
 }
 ```

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") => 无返回值 | 是       | -      | 停止回调函数 |
 
 **说明:**

package/docs/apicn/node.md

@@ -73,15 +73,15 @@ const listPage = $创建节点选择器({ mode: 2 });
 | 方法 | 说明 |
 | --- | --- |
 | `hittable()` | 当前是否可点击（可见且未被挡住） |
-| `scrollToVisible()` | 滚动到可见区域 |
-| `tap()` | 单击（不可见时会先尝试滚到可见） |
-| `doubleTap()` | 双击 |
-| `press(duration?)` | 长按，`duration` 单位毫秒，默认 500 |
-| `点击中心()` | 点击中心坐标 |
-| `点击随机范围()` | 在节点范围内随机点击 |
-| `clearInput()` | 清空输入内容 |
-| `input(text)` | 追加输入（不先清空） |
-| `setValue(text)` | 设置值（见下方） |
+| `scrollToVisible()` | 仅滚动到可见，不点击；一般不必手动调用 |
+| `tap()` | 单击；不可见时会先自动滚到可见 |
+| `doubleTap()` | 双击；不可见时会先自动滚到可见 |
+| `press(duration?)` | 长按，`duration` 单位毫秒，默认 500；不可见时会先自动滚到可见 |
+| `点击中心()` | 点击中心坐标（坐标点击，不会自动滚动） |
+| `点击随机范围()` | 在节点范围内随机点击（坐标点击，不会自动滚动） |
+| `clearInput()` | 清空输入内容（内部会先 `tap` 聚焦，因而也会自动滚到可见） |
+| `input(text)` | 追加输入（不先清空；内部会先 `tap` 聚焦） |
+| `setValue(text)` | 设置值（见下方；不可见时会先自动滚到可见） |
 | `parent()` | 父节点 |
 | `child(index)` | 第 `index` 个子节点 |
 | `allChildren()` | 全部子节点 |
@@ -170,28 +170,29 @@ selector
 
 ### 是否可点 / 滚到可见
 
+`tap` / `doubleTap` / `press` / `setValue`（以及内部会先 `tap` 的 `clearInput` / `input`）在元素当前不可见时，会**自动**先滚到可见再操作，一般不用手写滚动：
+
 ```typescript
-if (node.hittable()) {
-  node.tap();
-} else {
-  node.scrollToVisible();
-  node.tap();
-}
+// 推荐：直接操作，不可见时会自动滚到可见
+node.tap();
+node.doubleTap();
+node.press(800);
+node.setValue("hello");
 ```
 
-- `hittable()`：当前能否点到  
-- `scrollToVisible()`：手动滚到可见  
-- `tap` / `doubleTap` / `press`：不可见时会自动尝试滚到可见再操作  
+- `hittable()`：当前能否点到（可见且未被挡住），用于排查“点了没反应”
+- `scrollToVisible()`：只滚到可见、不点击；仅在你想先露出元素、稍后再操作时使用
+- `点击中心()` / `点击随机范围()`：按坐标点击，**不会**自动滚动
 
 ### 点击
 
 | 方法 | 说明 |
 | --- | --- |
-| `tap()` | 推荐，单击 |
-| `doubleTap()` | 双击 |
-| `press(ms?)` | 长按，默认 500ms |
-| `点击中心()` | 点中心坐标 |
-| `点击随机范围()` | 范围内随机点 |
+| `tap()` | 推荐，单击；不可见时自动滚到可见 |
+| `doubleTap()` | 双击；不可见时自动滚到可见 |
+| `press(ms?)` | 长按，默认 500ms；不可见时自动滚到可见 |
+| `点击中心()` | 点中心坐标，不自动滚动 |
+| `点击随机范围()` | 范围内随机点，不自动滚动 |
 
 ```typescript
 const btn = selector
@@ -210,15 +211,15 @@ if (btn) {
 
 | 方法 | 说明 |
 | --- | --- |
-| `clearInput()` | 清空 |
-| `input(text)` | 追加输入，不清空原内容 |
-| `setValue(text)` | 按控件类型设置 |
+| `clearInput()` | 清空（内部先 `tap` 聚焦，不可见时也会自动滚到可见） |
+| `input(text)` | 追加输入，不清空原内容（内部先 `tap` 聚焦） |
+| `setValue(text)` | 按控件类型设置；不可见时会先自动滚到可见 |
 
 **`setValue` 行为**
 
 | 控件类型 | 传参 | 效果 |
 | --- | --- | --- |
-| `PickerWheel` | 选项文案，如 `"1小时"` | 滚到该选项 |
+| `PickerWheel` | 选项文案，如 `"1小时"` | 滚到该选项（控件本身不可见时也会先自动滚到可见） |
 | 文本框类（TextField 等） | 字符串 | 聚焦后追加输入，不先清空 |
 
 覆盖原内容请先清空：
@@ -231,6 +232,7 @@ field.setValue("hello");
 ```typescript
 const wheel = selector.类型("XCUIElementTypePickerWheel").获取一个节点信息(3000);
 if (wheel) {
+  // 不可见时会自动滚到可见，再调到目标选项
   wheel.setValue("1小时");
 }
 ```

package/docs/apipython/g.md

@@ -6,7 +6,7 @@
 
 - 应用信息常量：版本号/构建号/名称/包名
 - 前台切换：将宿主应用切到前台
-- Agent 设置：读取和设置 Agent 快速模式
+- Agent 设置：读取和设置 Agent 触控模式
 - 脚本生命周期：设置停止回调和异常停止回调
 
 ## 常量
@@ -55,9 +55,9 @@ from kuaijs import g
 g.takeMeToFront()
 ```
 
-#### `setAgentFastMode` - 设置 Agent 快速模式
+#### `setAgentFastMode` - 设置 Agent 快速模式（兼容）
 
-快速模式默认开启，设置会持久化。开启后，Agent 执行动作响应更快，但开始执行时电量可能快速消耗。
+兼容旧接口：开启对应模式 `1`，关闭对应模式 `0`。推荐改用 `setAgentTouchMode`。设置会持久化。
 
 ```python
 def setAgentFastMode(enabled: bool) -> bool
@@ -81,9 +81,9 @@ enabled = g.setAgentFastMode(True)
 print(f"Agent 快速模式: {enabled}")
 ```
 
-#### `getAgentFastMode` - 获取 Agent 快速模式
+#### `getAgentFastMode` - 获取 Agent 快速模式（兼容）
 
-快速模式默认开启，设置会持久化。
+获取 Agent 快速模式当前状态。
 
 ```python
 def getAgentFastMode() -> bool
@@ -102,6 +102,57 @@ if g.getAgentFastMode():
     print("Agent 快速模式已开启")
 ```
 
+#### `setAgentTouchMode` - 设置 Agent 触控模式
+
+默认 `1`，设置会持久化。
+
+- `0` 标准：等待完整执行完成
+- `1` 快速：更快的执行速度
+- `2` 真实点击：更接近真实手指触控
+
+```python
+def setAgentTouchMode(mode: int) -> int
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `mode` | int | 是 | - | 0 标准 / 1 快速 / 2 真实点击 |
+
+**返回值:**
+
+- `int` 实际生效的模式
+
+**示例:**
+
+```python
+from kuaijs import g
+
+mode = g.setAgentTouchMode(1)
+print(f"Agent 触控模式: {mode}")
+```
+
+#### `getAgentTouchMode` - 获取 Agent 触控模式
+
+默认 `1`，设置会持久化。
+
+```python
+def getAgentTouchMode() -> int
+```
+
+**返回值:**
+
+- `int` 当前模式（0/1/2）
+
+**示例:**
+
+```python
+from kuaijs import g
+
+mode = g.getAgentTouchMode()
+print(f"当前触控模式: {mode}")
+```
+
 #### `setCpuAutoThrottle` - 设置脚本 CPU 自动限流
 
 默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险。
@@ -164,17 +215,17 @@ def setCpuThrottleDelay(min_ms: int, max_ms: int) -> CpuThrottleDelay
 
 **参数:**
 
-| 参数名    | 类型  | 是否必填 | 默认值 | 描述                               |
-| --------- | ----- | -------- | ------ | ---------------------------------- |
-| `min_ms`  | `int` | 是       | -      | 最低延迟（毫秒）                   |
-| `max_ms`  | `int` | 是       | -      | 最高延迟（毫秒）；小于 min_ms 时自动对齐 |
+| 参数名   | 类型  | 是否必填 | 默认值 | 描述                                     |
+| -------- | ----- | -------- | ------ | ---------------------------------------- |
+| `min_ms` | `int` | 是       | -      | 最低延迟（毫秒）                         |
+| `max_ms` | `int` | 是       | -      | 最高延迟（毫秒）；小于 min_ms 时自动对齐 |
 
 **返回值:**
 
-| 字段名  | 类型  | 描述           |
-| ------- | ----- | -------------- |
-| `minMs` | `int` | 实际最低延迟   |
-| `maxMs` | `int` | 实际最高延迟   |
+| 字段名  | 类型  | 描述         |
+| ------- | ----- | ------------ |
+| `minMs` | `int` | 实际最低延迟 |
+| `maxMs` | `int` | 实际最高延迟 |
 
 **示例:**
 
@@ -237,16 +288,16 @@ def setStopCallback(callback: Callable[[Literal["success", "error", "stopped"]],
 
 **参数:**
 
-| 参数名     | 类型                                                      | 是否必填 | 默认值 | 描述 |
-| ---------- | --------------------------------------------------------- | -------- | ------ | ---- |
-| `callback` | `Callable[[Literal["success", "error", "stopped"]], None]` 或 `None` | 是 | - | 停止回调函数，传 `None` 取消回调 |
+| 参数名     | 类型                                                                 | 是否必填 | 默认值 | 描述                             |
+| ---------- | -------------------------------------------------------------------- | -------- | ------ | -------------------------------- |
+| `callback` | `Callable[[Literal["success", "error", "stopped"]], None]` 或 `None` | 是       | -      | 停止回调函数，传 `None` 取消回调 |
 
 **状态值:**
 
-| 状态 | 描述 |
-| ---- | ---- |
-| `success` | 脚本正常执行完成 |
-| `error` | 脚本发生未捕获异常 |
+| 状态      | 描述                     |
+| --------- | ------------------------ |
+| `success` | 脚本正常执行完成         |
+| `error`   | 脚本发生未捕获异常       |
 | `stopped` | 脚本被手动停止或主动退出 |
 
 **示例:**
@@ -275,9 +326,9 @@ def setExceptionCallback(callback: Callable[[], None] | None) -> None
 
 **参数:**
 
-| 参数名     | 类型                         | 是否必填 | 默认值 | 描述 |
-| ---------- | ---------------------------- | -------- | ------ | ---- |
-| `callback` | `Callable[[], None]` 或 `None` | 是 | - | 异常停止回调函数，传 `None` 取消回调 |
+| 参数名     | 类型                           | 是否必填 | 默认值 | 描述                                 |
+| ---------- | ------------------------------ | -------- | ------ | ------------------------------------ |
+| `callback` | `Callable[[], None]` 或 `None` | 是       | -      | 异常停止回调函数，传 `None` 取消回调 |
 
 **示例:**