ms-types 0.9.23 → 0.9.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.9.23",
+  "version": "0.9.24",
   "type": "module",
   "license": "MIT",
   "publishConfig": {

package/types/global.d.ts

@@ -160,23 +160,42 @@ declare function time(): number;
 declare function takeMeToFront(): boolean;
 
 /**
- * 设置 Agent 快速模式
+ * 设置 Agent 快速模式（兼容旧接口）
  * @param enabled 是否开启快速模式
  * @returns 实际是否开启快速模式
- * @description 快速模式默认开启，设置会持久化。开启后 Agent 执行动作响应更快，但开始执行时电量可能快速消耗
+ * @description 开启对应模式 1，关闭对应模式 0。推荐改用 setAgentTouchMode。设置会持久化
  * @example
  * const enabled = setAgentFastMode(true);
  */
 declare function setAgentFastMode(enabled: boolean): boolean;
 
 /**
- * 获取 Agent 快速模式当前状态。快速模式默认开启，设置会持久化
+ * 获取 Agent 快速模式当前状态（兼容旧接口）
  * @returns 当前是否开启快速模式
  * @example
  * const enabled = getAgentFastMode();
  */
 declare function getAgentFastMode(): boolean;
 
+/**
+ * 设置 Agent 触控模式
+ * @param mode 0 标准 / 1 快速 / 2 真实点击
+ * @returns 实际生效的模式
+ * @description 默认 1，设置会持久化。0 标准、1 快速、2 真实点击
+ * @example
+ * const mode = setAgentTouchMode(1);
+ */
+declare function setAgentTouchMode(mode: number): number;
+
+/**
+ * 获取 Agent 触控模式
+ * @returns 当前模式（0/1/2）
+ * @description 默认 1，设置会持久化
+ * @example
+ * const mode = getAgentTouchMode();
+ */
+declare function getAgentTouchMode(): number;
+
 /**
  * 设置脚本 CPU 自动限流
  * @param enabled 是否开启自动限流

package/types/node.d.ts

@@ -105,33 +105,34 @@ declare interface NodeInfo {
    */
   hittable(): boolean;
   /**
-   * 无障碍点击
+   * 无障碍点击。不可见时会先自动滚到可见再点击。
    */
   tap(): boolean;
   /**
-   * 无障碍双击
+   * 无障碍双击。不可见时会先自动滚到可见再双击。
    */
   doubleTap(): boolean;
   /**
-   * 无障碍长按
+   * 无障碍长按。不可见时会先自动滚到可见再长按。
    * @param duration 长按持续时间，单位毫秒，默认 500
    */
   press(duration?: number): boolean;
   /**
-   * 将节点滚动到可见区域
+   * 仅将节点滚动到可见区域，不点击。
+   * `tap` / `doubleTap` / `press` / `setValue` 已内置自动滚动，一般不必手动调用。
    */
   scrollToVisible(): boolean;
   /**
-   * 清空输入
+   * 清空输入。内部会先 `tap` 聚焦（不可见时也会自动滚到可见）。
    */
   clearInput(): boolean;
   /**
-   * 追加输入（聚焦后输入）
+   * 追加输入（聚焦后输入）。内部会先 `tap` 聚焦。
    * @param text 要输入的文本
    */
   input(text: string): boolean;
   /**
-   * 设置节点的值，按控件类型自动处理：
+   * 设置节点的值，按控件类型自动处理；不可见时会先自动滚到可见：
    * - `XCUIElementTypePickerWheel`：传选项文案，如 `"1小时"`
    * - 文本类控件（`TextField` / `SecureTextField` / `TextView` / `SearchField` 等）：传要输入的文本（先聚焦再输入，不清空已有内容）
    * @param text 目标值

package/types/zh//345/205/250/345/261/200/346/250/241/345/235/227.d.ts

@@ -156,23 +156,42 @@ declare function $获取当前时间戳(): 数字;
 declare function $APP切入前台(): 无返回值;
 
 /**
- * 设置 Agent 快速模式
+ * 设置 Agent 快速模式（兼容旧接口）
  * @param 是否开启 是否开启快速模式
  * @returns 实际是否开启快速模式
- * @description 快速模式默认开启，设置会持久化。开启后 Agent 执行动作响应更快，但开始执行时电量可能快速消耗
+ * @description 开启对应模式 1，关闭对应模式 0。推荐改用 $设置Agent触控模式。设置会持久化
  * @example
  * const 是否开启 = $设置Agent快速模式(true);
  */
 declare function $设置Agent快速模式(是否开启: 布尔值): 布尔值;
 
 /**
- * 获取 Agent 快速模式当前状态。快速模式默认开启，设置会持久化
+ * 获取 Agent 快速模式当前状态（兼容旧接口）
  * @returns 当前是否开启快速模式
  * @example
  * const 是否开启 = $获取Agent快速模式();
  */
 declare function $获取Agent快速模式(): 布尔值;
 
+/**
+ * 设置 Agent 触控模式
+ * @param 模式 0 标准 / 1 快速 / 2 真实点击
+ * @returns 实际生效的模式
+ * @description 默认 1，设置会持久化。0 标准、1 快速、2 真实点击
+ * @example
+ * const 模式 = $设置Agent触控模式(1);
+ */
+declare function $设置Agent触控模式(模式: 数字): 数字;
+
+/**
+ * 获取 Agent 触控模式
+ * @returns 当前模式（0/1/2）
+ * @description 默认 1，设置会持久化
+ * @example
+ * const 模式 = $获取Agent触控模式();
+ */
+declare function $获取Agent触控模式(): 数字;
+
 /**
  * 设置脚本 CPU 自动限流
  * @param 是否开启 是否开启自动限流

package/types/zh//350/212/202/347/202/271/346/250/241/345/235/227.d.ts

@@ -103,33 +103,34 @@ declare interface $节点信息 {
    */
   hittable(): 布尔值;
   /**
-   * 无障碍点击
+   * 无障碍点击。不可见时会先自动滚到可见再点击。
    */
   tap(): 布尔值;
   /**
-   * 无障碍双击
+   * 无障碍双击。不可见时会先自动滚到可见再双击。
    */
   doubleTap(): 布尔值;
   /**
-   * 无障碍长按
+   * 无障碍长按。不可见时会先自动滚到可见再长按。
    * @param duration 长按持续时间，单位毫秒，默认 500
    */
   press(duration?: 数字): 布尔值;
   /**
-   * 将节点滚动到可见区域
+   * 仅将节点滚动到可见区域，不点击。
+   * `tap` / `doubleTap` / `press` / `setValue` 已内置自动滚动，一般不必手动调用。
    */
   scrollToVisible(): 布尔值;
   /**
-   * 清空输入
+   * 清空输入。内部会先 `tap` 聚焦（不可见时也会自动滚到可见）。
    */
   clearInput(): 布尔值;
   /**
-   * 追加输入（聚焦后输入）
+   * 追加输入（聚焦后输入）。内部会先 `tap` 聚焦。
    * @param text 要输入的文本
    */
   input(text: 字符串): 布尔值;
   /**
-   * 设置节点的值，按控件类型自动处理：
+   * 设置节点的值，按控件类型自动处理；不可见时会先自动滚到可见：
    * - `XCUIElementTypePickerWheel`：传选项文案，如 `"1小时"`
    * - 文本类控件（`TextField` / `SecureTextField` / `TextView` / `SearchField` 等）：传要输入的文本（先聚焦再输入，不清空已有内容）
    * @param text 目标值