ms-types 0.0.63 → 0.0.65

package/package.json

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

package/types/action.d.ts

@@ -23,27 +23,6 @@ declare namespace action {
     duration?: number,
     jitter?: boolean
   ): boolean;
-  /**
-   * 滑动
-   * @param startX 起始坐标x
-   * @param startY 起始坐标y
-   * @param endX 结束坐标x
-   * @param endY 结束坐标y
-   * @param duration 持续时间 默认 100ms
-   * @param jitter 抖动 开启抖动，会在像素范围随机偏移 滑动 默认false
-   * @param steps 步数 生成抖动点数量 默认6
-   * @returns 滑动是否成功
-   * @example action.swipe(100, 100, 200, 200, 500, true, 10)
-   */
-  function swipe(
-    startX: number,
-    startY: number,
-    endX: number,
-    endY: number,
-    duration?: number,
-    jitter?: boolean,
-    steps?: number
-  ): boolean;
   /**
    * 随机点击
    * @param x1 区域左上角x坐标
@@ -97,6 +76,27 @@ declare namespace action {
     duration?: number,
     interval?: number
   ): boolean;
+  /**
+   * 滑动
+   * @param startX 起始坐标x
+   * @param startY 起始坐标y
+   * @param endX 结束坐标x
+   * @param endY 结束坐标y
+   * @param duration 持续时间 默认 100ms
+   * @param jitter 抖动 开启抖动，会在像素范围随机偏移 滑动 默认false
+   * @param steps 步数 生成抖动点数量 默认6
+   * @returns 滑动是否成功
+   * @example action.swipe(100, 100, 200, 200, 500, true, 10)
+   */
+  function swipe(
+    startX: number,
+    startY: number,
+    endX: number,
+    endY: number,
+    duration?: number,
+    jitter?: boolean,
+    steps?: number
+  ): boolean;
   /**
    * 长按滑动
    * @param startX 起始坐标x

package/types/global.d.ts

@@ -1,50 +1,33 @@
-declare type 回调 = Function;
-declare type 布尔值 = boolean;
-declare type 字符串 = string;
-declare type 数字 = number;
-declare type 任意类型 = any;
-declare type 日期时间 = Date;
-declare type 数组<T> = Array<T>;
-declare type 字典<T> = Record<string, T>;
-declare type 无返回值 = void;
-
 /**
  * 是否是调试模式
  */
 declare const __debug__: boolean;
-declare const $是否调试: boolean;
 /**
  * 是否应该退出应用
  */
 declare const __shouldExit__: boolean;
-declare const $是否退出: boolean;
 /**
  * 应用版本
  */
 declare const __appVersion__: string;
-declare const $APP应用版本: string;
 /**
  * 应用构建号
  */
 declare const __appBuildNumber__: string;
-declare const $APP应用构建号: string;
 /**
  * 应用名称
  */
 declare const __appName__: string;
-declare const $APP应用名称: string;
 /**
  * 应用 bundleId
  */
 declare const __bundleId__: string;
-declare const $APP应用包名: string;
 /**
  * 当前线程名称
  */
 declare const __threadName__: string;
-declare const $线程名称: string;
 /**
- * 应用包信息
+ * 脚本信息
  */
 declare const __package__: {
   /**
@@ -74,16 +57,6 @@ declare const __package__: {
   };
   [key: string]: any;
 };
-declare const $脚本配置: {
-  name: string;
-  appVersion: string;
-  appId: string;
-  update: {
-    url: string;
-    timeout: number;
-  };
-  [key: string]: any;
-};
 
 /**
  * 设置停止回调（仅主线程调用）
@@ -96,17 +69,6 @@ declare const $脚本配置: {
  */
 declare function setStopCallback(callback: Function): void;
 
-/**
- * 设置停止回调（仅主线程调用）
- * @param callback 停止回调
- * @description 脚本执行完成或异常停止时调用，exit 退出不会触发
- * @example
- * $设置停止回调(() => {
- *   $打印信息日志("脚本执行完成");
- * });
- */
-declare const $设置停止回调: (回调: 回调) => 无返回值;
-
 /**
  * 设置异常停止回调（仅主线程调用）
  * @param callback 异常停止回调
@@ -118,17 +80,6 @@ declare const $设置停止回调: (回调: 回调) => 无返回值;
  */
 declare function setExceptionCallback(callback: () => void): void;
 
-/**
- * 设置异常停止回调（仅主线程调用）
- * @param callback 异常停止回调
- * @description 脚本执行异常停止时调用
- * @example
- * $设置异常停止回调(() => {
- *   $打印错误日志("脚本执行异常");
- * });
- */
-declare const $设置异常停止回调: (回调: 回调) => 无返回值;
-
 /**
  * 重启脚本（仅主线程调用）
  * @param delay 延迟时间 毫秒
@@ -140,15 +91,6 @@ declare const $设置异常停止回调: (回调: 回调) => 无返回值;
  */
 declare function restartScript(delay: number): void;
 
-/**
- * 重启脚本（仅主线程调用）
- * @param delay 延迟时间 毫秒
- * @description 重启脚本会延迟指定时间后再重启，不要低于 2000 毫秒
- * @example
- * $重启脚本(2000);
- */
-declare const $重启脚本: (延迟时间: 数字) => 无返回值;
-
 /**
  * 线程睡眠
  * @param ms 毫秒
@@ -158,15 +100,6 @@ declare const $重启脚本: (延迟时间: 数字) => 无返回值;
  */
 declare function sleep(ms: number): void;
 
-/**
- * 线程睡眠
- * @param ms 毫秒
- * @description 线程睡眠会阻塞当前线程，等待指定时间后继续执行
- * @example
- * $延时(1000);
- */
-declare const $延时: (毫秒: 数字) => 无返回值;
-
 /**
  * 退出脚本
  * @param exitAll 是否退出所有线程 true 退出所有 false 退出当前线程，不传默认 false
@@ -176,15 +109,6 @@ declare const $延时: (毫秒: 数字) => 无返回值;
  */
 declare function exit(exitAll?: boolean): void;
 
-/**
- * 退出脚本
- * @param 退出所有线程 是否退出所有线程 true 退出所有 false 退出当前线程，不传默认 false
- * @description 退出脚本会终止所有线程的执行
- * @example
- * $退出脚本();
- */
-declare const $退出脚本: (退出所有线程?: 布尔值) => 无返回值;
-
 /**
  * 获取当前时间戳
  * @returns 时间戳
@@ -193,14 +117,6 @@ declare const $退出脚本: (退出所有线程?: 布尔值) => 无返回值;
  */
 declare function time(): number;
 
-/**
- * 获取当前时间戳
- * @returns 时间戳
- * @example
- * const timestamp = $获取当前时间戳();
- */
-declare function $获取当前时间戳(): 数字;
-
 /**
  * 把 app 切换到前台 utils.takeMeToFront 的别名
  * @see utils.takeMeToFront
@@ -210,15 +126,6 @@ declare function $获取当前时间戳(): 数字;
  */
 declare function takeMeToFront(): void;
 
-/**
- * 把 app 切换到前台 utils.takeMeToFront 的别名
- * @see utils.takeMeToFront
- * @description 把 app 切换到前台
- * @example
- * $切入前台();
- */
-declare function $APP切入前台(): 无返回值;
-
 /**
  * 打印调试日志 - 输出调试级别的日志
  * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪
@@ -230,17 +137,6 @@ declare function $APP切入前台(): 无返回值;
  */
 declare function logd(...args: any[]): void;
 
-/**
- * 打印调试日志 - 输出调试级别的日志
- * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪
- * @param args 日志消息内容
- * @see logger.debug
- * @example
- * $打印调试日志("程序开始执行");
- * $打印调试日志(`当前用户: ${username}`);
- */
-declare function $打印调试日志(...args: 数组<任意类型>): 无返回值;
-
 /**
  * 打印信息日志 - 输出信息级别的日志
  * 用于程序正常运行信息、重要操作的确认、状态变更通知
@@ -252,17 +148,6 @@ declare function $打印调试日志(...args: 数组<任意类型>): 无返回
  */
 declare function logi(...args: any[]): void;
 
-/**
- * 打印信息日志 - 输出信息级别的日志
- * 用于程序正常运行信息、重要操作的确认、状态变更通知
- * @param args 日志消息内容
- * @see logger.info
- * @example
- * $打印信息日志("应用程序启动成功");
- * $打印信息日志("用户登录成功");
- */
-declare function $打印信息日志(...args: 数组<任意类型>): 无返回值;
-
 /**
  * 打印警告日志 - 输出警告级别的日志
  * 用于潜在的问题、不推荐的操作、性能警告、兼容性问题
@@ -274,17 +159,6 @@ declare function $打印信息日志(...args: 数组<任意类型>): 无返回
  */
 declare function logw(...args: any[]): void;
 
-/**
- * 打印警告日志 - 输出警告级别的日志
- * 用于潜在的问题、不推荐的操作、性能警告、兼容性问题
- * @param args 日志消息内容
- * @see logger.warn
- * @example
- * $打印警告日志("电池电量低于 20%");
- * $打印警告日志("网络连接不稳定");
- */
-declare function $打印警告日志(...args: 数组<任意类型>): 无返回值;
-
 /**
  * 打印错误日志 - 输出错误级别的日志
  * 用于程序错误和异常、操作失败、系统错误、致命问题
@@ -295,14 +169,3 @@ declare function $打印警告日志(...args: 数组<任意类型>): 无返回
  * loge("文件读取错误");
  */
 declare function loge(...args: any[]): void;
-
-/**
- * 打印错误日志 - 输出错误级别的日志
- * 用于程序错误和异常、操作失败、系统错误、致命问题
- * @param args 日志消息内容
- * @see logger.error
- * @example
- * $打印错误日志("网络请求失败");
- * $打印错误日志("文件读取错误");
- */
-declare function $打印错误日志(...args: 数组<任意类型>): 无返回值;

package/types/index.d.ts

@@ -22,3 +22,4 @@
 /// <reference path="ui.d.ts" />
 /// <reference path="utils.d.ts" />
 /// <reference path="yolo.d.ts" />
+/// <reference path="zh/index.d.ts" />

package/types/zh/index.d.ts

@@ -0,0 +1,5 @@
+/// <reference path="全局模块.d.ts" />
+/// <reference path="动作模块.d.ts" />
+/// <reference path="苹果OCR.d.ts" />
+/// <reference path="配置模块.d.ts" />
+/// <reference path="设备模块.d.ts" />

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

@@ -0,0 +1,164 @@
+declare type 回调 = Function;
+declare type 布尔值 = boolean;
+declare type 字符串 = string;
+declare type 数字 = number;
+declare type 任意类型 = any;
+declare type 日期时间 = Date;
+declare type 数组<T> = Array<T>;
+declare type 字典<T> = Record<字符串, T>;
+declare type 无返回值 = void;
+
+declare const $真: 布尔值;
+declare const $假: 布尔值;
+
+/**
+ * 是否是调试模式
+ */
+declare const $是否调试: boolean;
+/**
+ * 是否应该退出应用
+ */
+declare const $是否退出: boolean;
+/**
+ * 应用版本
+ */
+declare const $APP应用版本: string;
+/**
+ * 应用构建号
+ */
+declare const $APP应用构建号: string;
+/**
+ * 应用名称
+ */
+declare const $APP应用名称: string;
+/**
+ * 应用 bundleId
+ */
+declare const $APP应用包名: string;
+/**
+ * 当前线程名称
+ */
+declare const $线程名称: string;
+/**
+ * 脚本信息
+ */
+declare const $脚本配置: {
+  name: string;
+  appVersion: string;
+  appId: string;
+  update: {
+    url: string;
+    timeout: number;
+  };
+  [key: string]: any;
+};
+
+/**
+ * 设置停止回调（仅主线程调用）
+ * @param callback 停止回调
+ * @description 脚本执行完成或异常停止时调用，exit 退出不会触发
+ * @example
+ * $设置停止回调(() => {
+ *   $打印信息日志("脚本执行完成");
+ * });
+ */
+declare const $设置停止回调: (回调: 回调) => 无返回值;
+
+/**
+ * 设置异常停止回调（仅主线程调用）
+ * @param callback 异常停止回调
+ * @description 脚本执行异常停止时调用
+ * @example
+ * $设置异常停止回调(() => {
+ *   $打印错误日志("脚本执行异常");
+ * });
+ */
+declare const $设置异常停止回调: (回调: 回调) => 无返回值;
+
+/**
+ * 重启脚本（仅主线程调用）
+ * @param delay 延迟时间 毫秒
+ * @description 重启脚本会延迟指定时间后再重启，不要低于 2000 毫秒
+ * @example
+ * $重启脚本(2000);
+ */
+declare const $重启脚本: (延迟时间: 数字) => 无返回值;
+
+/**
+ * 线程睡眠
+ * @param ms 毫秒
+ * @description 线程睡眠会阻塞当前线程，等待指定时间后继续执行
+ * @example
+ * $延时(1000);
+ */
+declare const $延时: (毫秒: 数字) => 无返回值;
+
+/**
+ * 退出脚本
+ * @param 退出所有线程 是否退出所有线程 true 退出所有 false 退出当前线程，不传默认 false
+ * @description 退出脚本会终止所有线程的执行
+ * @example
+ * $退出脚本();
+ */
+declare const $退出脚本: (退出所有线程?: 布尔值) => 无返回值;
+
+/**
+ * 获取当前时间戳
+ * @returns 时间戳
+ * @example
+ * const timestamp = $获取当前时间戳();
+ */
+declare function $获取当前时间戳(): 数字;
+
+/**
+ * 把 app 切换到前台 utils.takeMeToFront 的别名
+ * @see utils.takeMeToFront
+ * @description 把 app 切换到前台
+ * @example
+ * $APP切入前台();
+ */
+declare function $APP切入前台(): 无返回值;
+
+/**
+ * 打印调试日志 - 输出调试级别的日志
+ * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪
+ * @param args 日志消息内容
+ * @see logger.debug
+ * @example
+ * $打印调试日志("程序开始执行");
+ * $打印调试日志(`当前用户: ${username}`);
+ */
+declare function $打印调试日志(...args: 数组<任意类型>): 无返回值;
+
+/**
+ * 打印信息日志 - 输出信息级别的日志
+ * 用于程序正常运行信息、重要操作的确认、状态变更通知
+ * @param args 日志消息内容
+ * @see logger.info
+ * @example
+ * $打印信息日志("应用程序启动成功");
+ * $打印信息日志("用户登录成功");
+ */
+declare function $打印信息日志(...args: 数组<任意类型>): 无返回值;
+
+/**
+ * 打印警告日志 - 输出警告级别的日志
+ * 用于潜在的问题、不推荐的操作、性能警告、兼容性问题
+ * @param args 日志消息内容
+ * @see logger.warn
+ * @example
+ * $打印警告日志("电池电量低于 20%");
+ * $打印警告日志("网络连接不稳定");
+ */
+declare function $打印警告日志(...args: 数组<任意类型>): 无返回值;
+
+/**
+ * 打印错误日志 - 输出错误级别的日志
+ * 用于程序错误和异常、操作失败、系统错误、致命问题
+ * @param args 日志消息内容
+ * @see logger.error
+ * @example
+ * $打印错误日志("网络请求失败");
+ * $打印错误日志("文件读取错误");
+ */
+declare function $打印错误日志(...args: 数组<任意类型>): 无返回值;

package/types/zh//345/212/250/344/275/234/346/250/241/345/235/227.d.ts

@@ -0,0 +1,298 @@
+/// <reference path="全局模块.d.ts" />
+
+/**
+ * 动作模块 包含点击、滑动、长按滑动、返回首页等动作
+ */
+declare namespace $动作 {
+  /**
+   * 设置动作抖动值 点击、滑动等动作会在像素范围-5到5随机偏移
+   * @param value 抖动值
+   * @example $动作.设置抖动值(5)
+   */
+  function 设置抖动值(抖动值: 数字): 无返回值;
+  /**
+   * 点击
+   * @param 坐标x
+   * @param 坐标y
+   * @param 按下持续时间 默认20ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
+   * @returns 点击是否成功
+   * @example $动作.点击(100, 100, 20, true)
+   */
+  function 点击(
+    坐标x: 数字,
+    坐标y: 数字,
+    按下持续时间?: 数字,
+    抖动?: 布尔值
+  ): 布尔值;
+  /**
+   * 随机点击
+   * @param 区域左上角x坐标
+   * @param 区域左上角y坐标
+   * @param 区域右下角x坐标
+   * @param 区域右下角y坐标
+   * @param 按下持续时间 默认20ms
+   * @returns 随机点击是否成功
+   * @example $动作.点击随机范围(100, 100, 200, 200, 20)
+   */
+  function 点击随机范围(
+    区域左上角x坐标: 数字,
+    区域左上角y坐标: 数字,
+    区域右下角x坐标: 数字,
+    区域右下角y坐标: 数字,
+    按下持续时间?: 数字
+  ): 布尔值;
+  /**
+   * 双击
+   * @param 坐标x
+   * @param 坐标y
+   * @param 按下持续时间 默认20ms
+   * @param 间隔时间 默认20ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
+   * @returns 双击是否成功
+   * @example $动作.双击(100, 100, 20, 20, true)
+   */
+  function 双击(
+    坐标x: 数字,
+    坐标y: 数字,
+    按下持续时间?: 数字,
+    间隔时间?: 数字,
+    抖动?: 布尔值
+  ): 布尔值;
+  /**
+   * 随机双击
+   * @param 区域左上角x坐标
+   * @param 区域左上角y坐标
+   * @param 区域右下角x坐标
+   * @param 区域右下角y坐标
+   * @param 按下持续时间 默认20ms
+   * @param 间隔时间 默认20ms
+   * @returns 随机双击是否成功
+   * @example $动作.双击随机范围(100, 100, 200, 200, 20, 20)
+   */
+  function 双击随机范围(
+    区域左上角x坐标: 数字,
+    区域左上角y坐标: 数字,
+    区域右下角x坐标: 数字,
+    区域右下角y坐标: 数字,
+    按下持续时间?: 数字,
+    间隔时间?: 数字
+  ): 布尔值;
+  /**
+   * 滑动
+   * @param 起始x坐标
+   * @param 起始y坐标
+   * @param 目标x坐标
+   * @param 目标y坐标
+   * @param 滑动持续时间 默认 100ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 滑动 默认false
+   * @param 步数 生成抖动点数量 默认6
+   * @returns 滑动是否成功
+   * @example $动作.滑动(100, 100, 200, 200, 500, true, 10)
+   */
+  function 滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+    滑动持续时间?: 数字,
+    抖动?: 布尔值,
+    步数?: 数字
+  ): 布尔值;
+  /**
+   * 长按滑动
+   * @param 起始x坐标
+   * @param 起始y坐标
+   * @param 目标x坐标
+   * @param 目标y坐标
+   * @param 按下持续时间 默认500ms
+   * @param 移动持续时间 默认1000ms
+   * @param 松开持续时间 默认500ms
+   * @param 抖动 开启抖动，会在像素范围随机偏移 长按滑动 默认false
+   * @param 步数 生成抖动点数量 默认6
+   * @returns 长按滑动是否成功
+   * @example $动作.长按并滑动(100, 100, 200, 200, 500, 500, 500, true, 10)
+   */
+  function 长按并滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+    按下持续时间?: 数字,
+    移动持续时间?: 数字,
+    松开持续时间?: 数字,
+    抖动?: 布尔值,
+    步数?: 数字
+  ): 布尔值;
+  /**
+   * 3点曲线滑动（先快后慢，拟人化轨迹）
+   * 使用二次贝塞尔曲线算法，添加随机偏移和时间抖动，模拟真实人手操作
+   * @param 起始x坐标
+   * @param 起始y坐标
+   * @param 中间点x坐标（控制曲线弯曲程度）
+   * @param 中间点y坐标（控制曲线弯曲程度）
+   * @param 目标x坐标
+   * @param 目标y坐标
+   * @param 滑动持续时间 总持续时间（毫秒），默认1000ms，实际执行时间会有随机变化
+   * @returns 曲线滑动是否成功
+   * @example $动作.曲线滑动(100, 100, 200, 150, 300, 200, 1000)
+   */
+  function 曲线滑动(
+    起始x坐标: 数字,
+    起始y坐标: 数字,
+    中间点x坐标: 数字,
+    中间点y坐标: 数字,
+    目标x坐标: 数字,
+    目标y坐标: 数字,
+    滑动持续时间?: 数字
+  ): 布尔值;
+  /**
+   * 输入文本
+   * @param text 文本内容
+   * @returns 输入文本是否成功
+   * @example $动作.输入文本("123456")
+   */
+  function 输入文本(文本: 字符串): 布尔值;
+  /**
+   * 删除文本
+   * @param 删除数量 默认为1
+   * @returns 删除文本是否成功
+   * @example $动作.删除文本(1)
+   */
+  function 删除文本(删除数量?: 数字): 布尔值;
+  /**
+   * 调用回车
+   * @returns 调用回车是否成功
+   * @example $动作.回车()
+   */
+  function 回车(): 布尔值;
+  /**
+   * 返回首页
+   * @returns 返回首页是否成功
+   * @example $动作.回到主页()
+   */
+  function 回到主页(): 布尔值;
+  /**
+   * 按下按钮
+   * @param 按键 按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键
+   * @returns 按下按钮是否成功
+   * @example $动作.按键("home")
+   */
+  function 按键(按键: "home" | "volumeup" | "volumedown"): 布尔值;
+  /**
+   * 模拟按下HID按钮
+   * @param 按键 HID按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键 power 按下电源键 snapshot 按下截图键
+   * @param 持续时间 持续时间 单位毫秒 默认20ms
+   * @returns 按下HID按钮是否成功
+   * @example $动作.按键HID("home", 200)
+   */
+  function 按键HID(
+    按键: "home" | "volumeup" | "volumedown" | "power" | "snapshot",
+    持续时间?: 数字
+  ): 布尔值;
+
+  /**
+   * 创建 动作构建器，支持链式调用构建复杂的多点触控动作
+   * @returns 动作构建器 实例
+   * @example const 动作构建器 = $动作.创建动作构建器()
+   */
+  function 创建动作构建器(): $动作构建器;
+
+  /**
+   * ActionBuilder 构建器接口
+   * 支持链式调用构建复杂的多点触控动作
+   */
+  interface $动作构建器 {
+    /**
+     * 添加一个指针（手指）
+     * @param id 指针编号，如 1-10
+     * @returns PointerBuilder 用于配置该指针的动作
+     * @example 动作构建器.添加手指(1).移动到(100, 100).点击(200, 200).完成()
+     */
+    添加手指(手指: 数字): $指针构建器;
+
+    /**
+     * 快速创建单点点击
+     * @param 坐标x
+     * @param 坐标y
+     * @param 持续时间 点击持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example 动作构建器.单指点击(100, 100, 50).执行()
+     */
+    单指点击(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $指针构建器;
+
+    /**
+     * 快速创建多点点击
+     * @param points 点击坐标数组，每个元素包含 x 和 y 坐标
+     * @param duration 点击持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example 动作构建器.多指点击([{x: 100, y: 100}, {x: 200, y: 200}], 50).执行()
+     */
+    多指点击(
+      坐标数组: Array<{ x: 数字; y: 数字 }>,
+      持续时间?: 数字
+    ): $动作构建器;
+
+    /**
+     * 执行构建的动作
+     * @returns 执行是否成功
+     * @example const 是否成功 = 动作构建器.执行()
+     */
+    执行(): 布尔值;
+  }
+
+  /**
+   * 指针构建器接口
+   * 用于配置单个指针（手指）的动作序列
+   */
+  interface $指针构建器 {
+    /**
+     * 移动到指定坐标
+     * @param 坐标x
+     * @param 坐标y
+     * @param 持续时间 移动持续时间，如果未定义则默认为 0ms
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.移动到(100, 100, 200)
+     */
+    移动到(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $指针构建器;
+
+    /**
+     * 按下手指
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.按下()
+     */
+    按下(): $指针构建器;
+
+    /**
+     * 抬起手指
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.抬起()
+     */
+    抬起(): $指针构建器;
+
+    /**
+     * 延迟指定时间（暂停）
+     * @param 持续时间 延迟时间（毫秒），如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.停留(100)
+     */
+    停留(持续时间?: 数字): $指针构建器;
+
+    /**
+     * 执行点击动作（移动 -> 按下 -> 暂停 -> 抬起）
+     * @param 坐标x
+     * @param 坐标y
+     * @param 持续时间 按下持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example 指针构建器.点击(100, 100, 50)
+     */
+    点击(坐标x: 数字, 坐标y: 数字, 持续时间?: 数字): $指针构建器;
+
+    /**
+     * 完成当前指针配置，返回到主构建器
+     * @returns 返回 ActionBuilder，可以继续添加其他指针
+     * @example pointer.done().addPointer(2)
+     */
+    完成(): $动作构建器;
+  }
+}

package/types/zh//346/226/207/344/273/266/346/250/241/345/235/227.d.ts

@@ -0,0 +1,137 @@
+/// <reference path="全局模块.d.ts" />
+/**
+ * 文件模块 包含文件操作、文件内容读写等功能
+ */
+declare namespace $文件 {
+  /**
+   * 获取应用内部目录
+   * @param 目录类型
+   * @returns 目录路径
+   * @example $文件.获取内部目录("documents")
+   */
+  function 获取内部目录(
+    目录类型: "documents" | "library" | "temp" | "libraryCaches"
+  ): 字符串;
+  /**
+   * 获取应用数据目录
+   * @returns 目录路径
+   * @example $文件.获取数据目录()
+   */
+  function 获取数据目录(): 字符串;
+  /**
+   * 获取应用数据文件路径
+   * @param 文件名称 文件名
+   * @returns 文件路径
+   * @example $文件.获取数据文件("config.json")
+   */
+  function 获取数据文件(文件名称: 字符串): 字符串;
+  /**
+   * 创建文件
+   * @param 文件路径
+   * @returns 是否创建成功
+   * @example $文件.创建文件("config.json")
+   */
+  function 创建文件(文件路径: 字符串): 布尔值;
+  /**
+   * 创建目录
+   * @param 目录路径
+   * @returns 是否创建成功
+   * @example $文件.创建目录("config")
+   */
+  function 创建目录(目录路径: 字符串): 布尔值;
+  /**
+   * 删除文件或目录
+   * @param 文件或目录路径
+   * @returns 是否删除成功
+   * @example $文件.删除所有文件("config")
+   */
+  function 删除所有文件(文件或目录路径: 字符串): 布尔值;
+  /**
+   * 读取文件内容
+   * @param 文件路径
+   * @returns 文件内容
+   * @example $文件.读取文件("config.json")
+   */
+  function 读取文件(文件路径: 字符串): 字符串;
+  /**
+   * 读取资源文件
+   * @param 文件名
+   * @returns 文件内容
+   * @example $文件.读取资源文件("test.txt")
+   */
+  function 读取资源文件(文件名: 字符串): 字符串 | null;
+  /**
+   * 删除文件内容
+   * @param 文件路径 文件路径
+   * @param 行号 如果是-1 代表这个条件不生效
+   * @param 包含内容 如果是null 代表这个条件不生效
+   * @returns 是否删除成功
+   * @example $文件.删除指定行("config.json", 1, null)
+   */
+  function 删除指定行(
+    文件路径: 字符串,
+    行号: 数字,
+    包含内容: 字符串 | null
+  ): 布尔值;
+  /**
+   * 列出目录下所有文件
+   * @param 目录路径
+   * @param 是否递归
+   * @returns 文件路径数组
+   * @example $文件.列出目录列表("config", true)
+   */
+  function 列出目录列表(目录路径: 字符串, 是否递归: 布尔值): 数组<字符串>;
+  /**
+   * 写入文件内容
+   * @param 文件路径
+   * @param 文件内容
+   * @returns 是否写入成功
+   * @example $文件.写入文件("config.json", "name=wda")
+   */
+  function 写入文件(文件路径: 字符串, 文件内容: 字符串): 布尔值;
+  /**
+   * 追加文件内容
+   * @param 文件路径
+   * @param 文件内容
+   * @returns 是否追加成功
+   * @example $文件.追加行("config.json", "name=wda")
+   */
+  function 追加行(文件路径: 字符串, 文件内容: 字符串): 布尔值;
+  /**
+   * 读取文件第N行内容
+   * @param 文件路径
+   * @param 行号
+   * @returns 行内容
+   * @example $文件.读取指定行("config.json", 1)
+   */
+  function 读取指定行(文件路径: 字符串, 行号: 数字): 字符串;
+  /**
+   * 读取文件所有行内容
+   * @param 文件路径
+   * @returns 行内容数组
+   * @example $文件.读取所有行("config.json")
+   */
+  function 读取所有行(文件路径: 字符串): 数组<字符串>;
+  /**
+   * 文件或者文件夹是否存在
+   * @param 文件路径
+   * @returns 是否存在
+   * @example $文件.文件是否存在("config.json")
+   */
+  function 文件是否存在(文件路径: 字符串): 布尔值;
+  /**
+   * 复制文件
+   * @param 源文件路径
+   * @param 目标文件路径
+   * @returns 是否复制成功
+   * @example $文件.复制文件("config.json", "config2.json")
+   */
+  function 复制文件(源文件路径: 字符串, 目标文件路径: 字符串): 布尔值;
+  /**
+   * 获取文件MD5值
+   * @param 文件路径
+   * @returns 文件MD5值
+   * @example $文件.计算文件MD5("config.json")
+   */
+  function 计算文件MD5(文件路径: 字符串): 字符串 | null;
+}

package/types/zh//350/213/271/346/236/234OCR.d.ts

@@ -0,0 +1,104 @@
+/// <reference path="全局模块.d.ts" />
+
+/**
+ * Apple OCR模块 使用Apple Vision框架进行文本识别
+ */
+declare namespace $苹果OCR {
+  /**
+   * OCR识别结果接口
+   */
+  interface OCR识别结果 {
+    /** 识别的文本内容 */
+    text: string;
+    /** 识别置信度 (0-1) */
+    confidence: number;
+    /** 文本区域左上角 x 坐标 */
+    x: number;
+    /** 文本区域左上角 y 坐标 */
+    y: number;
+    /** 文本区域右下角 x 坐标 */
+    ex: number;
+    /** 文本区域右下角 y 坐标 */
+    ey: number;
+    /** 文本区域宽度 */
+    width: number;
+    /** 文本区域高度 */
+    height: number;
+    /** 文本区域中心点 x 坐标 */
+    centerX: number;
+    /** 文本区域中心点 y 坐标 */
+    centerY: number;
+  }
+
+  /**
+   * 执行OCR识别（使用Apple Vision框架）
+   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
+   * @param 图片边界框左上角x坐标 图片边界框左上角x坐标
+   * @param 图片边界框左上角y坐标 图片边界框左上角y坐标
+   * @param 图片边界框右下角x坐标 图片边界框右下角x坐标
+   * @param 图片边界框右下角y坐标 图片边界框右下角y坐标
+   * @param 识别语言数组 识别语言数组，默认为["zh-Hans", "en-US"]
+   * @returns 识别结果数组，包含文本、置信度、坐标等信息
+   * @example
+   * const results = $苹果OCR.识别("screen", 0, 0, 100, 100, ["zh-Hans", "en-US"])
+   * results.forEach(result => {
+   *   logger.info(`文本: ${result.text}, 置信度: ${result.confidence}`)
+   * })
+   */
+  function 识别(
+    输入源: 字符串,
+    图片边界框左上角x坐标: 数字,
+    图片边界框左上角y坐标: 数字,
+    图片边界框右下角x坐标: 数字,
+    图片边界框右下角y坐标: 数字,
+    识别语言数组?: Array<字符串>
+  ): 数组<OCR识别结果>;
+
+  /**
+   * 执行OCR识别（仅识别数字）0-9.,+-
+   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
+   * @param 图片边界框左上角x坐标 图片边界框左上角x坐标
+   * @param 图片边界框左上角y坐标 图片边界框左上角y坐标
+   * @param 图片边界框右下角x坐标 图片边界框右下角x坐标
+   * @param 图片边界框右下角y坐标 图片边界框右下角y坐标
+   * @returns 识别结果数组，包含文本、置信度、坐标等信息
+   * @example
+   * const results = $苹果OCR.识别数字("screen", 0, 0, 100, 100)
+   * results.forEach(result => {
+   *   logger.info(`文本: ${result.text}, 置信度: ${result.confidence}`)
+   * })
+   */
+  function 识别数字(
+    输入源: 字符串,
+    图片边界框左上角x坐标: 数字,
+    图片边界框左上角y坐标: 数字,
+    图片边界框右下角x坐标: 数字,
+    图片边界框右下角y坐标: 数字
+  ): 数组<OCR识别结果>;
+
+  /**
+   * 执行OCR识别（查找指定文本）
+   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
+   * @param 要查找的文本数组 要查找的文本数组
+   * @param 图片边界框左上角x坐标 图片边界框左上角x坐标
+   * @param 图片边界框左上角y坐标 图片边界框左上角y坐标
+   * @param 图片边界框右下角x坐标 图片边界框右下角x坐标
+   * @param 图片边界框右下角y坐标 图片边界框右下角y坐标
+   * @param 识别语言数组 识别语言数组，默认为["zh-Hans", "en-US"]
+   * @returns 识别结果数组，包含文本、置信度、坐标等信息
+   * @example
+   * const results = $苹果OCR.查找文本("screen", ["123", "456"], 0, 0, 100, 100, ["zh-Hans", "en-US"])
+   * results.forEach(result => {
+   *   logger.info(`文本: ${result.text}, 置信度: ${result.confidence}`)
+   * })
+   */
+  function 查找文本(
+    输入源: 字符串,
+    要查找的文本数组: 数组<字符串>,
+    图片边界框左上角x坐标: 数字,
+    图片边界框左上角y坐标: 数字,
+    图片边界框右下角x坐标: 数字,
+    图片边界框右下角y坐标: 数字,
+    识别语言数组?: 数组<字符串>
+  ): 数组<OCR识别结果>;
+}

package/types/zh//350/256/276/345/244/207/346/250/241/345/235/227.d.ts

@@ -0,0 +1,106 @@
+/// <reference path="全局模块.d.ts" />
+/**
+ * 设备模块 包含获取设备信息、设备操作等功能
+ */
+declare namespace $设备 {
+  /**
+   * 获取电池信息
+   * @returns 电池信息
+   * @example $设备.获取电池状态()
+   */
+  function 获取电池状态(): {
+    /**
+     * 电池电量
+     */
+    level: number;
+    /**
+     * 是否充电
+     */
+    isCharging: boolean;
+  };
+  /**
+   * 获取设备ID
+   * @returns 设备ID
+   * @example $设备.获取设备ID()
+   */
+  function 获取设备ID(): 字符串;
+  /**
+   * 获取服务器设备ID
+   * @returns 服务器设备ID
+   * @example $设备.获取服务器设备ID()
+   */
+  function 获取服务器设备ID(): 字符串;
+  /**
+   * 获取设备名称
+   * @returns 设备名称
+   * @example $设备.获取设备名称()
+   */
+  function 获取设备名称(): 字符串;
+  /**
+   * 获取设备型号
+   * @returns 设备型号
+   * @example $设备.获取设备型号()
+   */
+  function 获取设备型号(): 字符串;
+  /**
+   * 获取屏幕大小
+   * @returns 屏幕大小
+   * @example $设备.获取屏幕宽高()
+   */
+  function 获取屏幕宽高(): {
+    /**
+     * 屏幕宽度
+     */
+    width: number;
+    /**
+     * 屏幕高度
+     */
+    height: number;
+  };
+  /**
+   * 获取屏幕实际大小
+   * @returns 屏幕实际大小
+   * @example $设备.获取屏幕实际宽高()
+   */
+  function 获取屏幕实际宽高(): {
+    /**
+     * 屏幕宽度
+     */
+    width: number;
+    /**
+     * 屏幕高度
+     */
+    height: number;
+  };
+  /**
+   * 获取屏幕缩放比例
+   * @returns 屏幕缩放比例
+   * @example $设备.获取屏幕缩放比例()
+   */
+  function 获取屏幕缩放比例(): number;
+  /**
+   * 获取设备方向 PORTRAIT 竖屏 LANDSCAPE 横屏
+   * @returns 设备方向
+   * @example $设备.获取设备方向()
+   */
+  function 获取设备方向(): "PORTRAIT" | "LANDSCAPE";
+  /**
+   * 获取系统版本 例如 16.7.11
+   * @returns 系统版本
+   * @example $设备.获取系统版本()
+   */
+  function 获取系统版本(): 字符串;
+  /**
+   * 获取局域网IP 例如 192.168.1.100
+   * @returns 局域网IP
+   * @example $设备.获取局域网IP()
+   */
+  function 获取局域网IP(): 字符串;
+  /**
+   * 振动
+   * @param 持续时间 持续时间 单位毫秒
+   * @param 强度 强度 0.0-1.0
+   * @example $设备.震动(1000, 0.5)
+   */
+  function 震动(持续时间: 数字, 强度: 数字): 无返回值;
+}

package/types/zh//351/205/215/347/275/256/346/250/241/345/235/227.d.ts

@@ -0,0 +1,56 @@
+/// <reference path="全局模块.d.ts" />
+
+/**
+ * 配置模块 包含读取配置、更新配置、删除配置等功能
+ */
+declare namespace $配置 {
+  /**
+   * 读取配置Int
+   * @param 配置键 配置key
+   * @returns 配置值
+   * @example $配置.读取整数("key")
+   */
+  function 读取整数(配置键: 字符串): 数字;
+  /**
+   * 读取配置Double
+   * @param 配置键 配置key
+   * @returns 配置值
+   * @example $配置.读取浮点数("key")
+   */
+  function 读取浮点数(配置键: 字符串): 数字;
+  /**
+   * 读取配置String
+   * @param 配置键 配置key
+   * @returns 配置值
+   * @example $配置.读取字符串("key")
+   */
+  function 读取字符串(配置键: 字符串): 字符串;
+  /**
+   * 读取配置Bool
+   * @param 配置键 配置key
+   * @returns 配置值
+   * @example $配置.读取布尔值("key")
+   */
+  function 读取布尔值(配置键: 字符串): 布尔值;
+  /**
+   * 获取所有配置JSON
+   * @returns 所有配置JSON
+   * @example $配置.读取所有配置()
+   */
+  function 读取所有配置(): 字典<任意类型>;
+  /**
+   * 更新配置
+   * @param 配置键 配置key
+   * @param 配置值 配置值
+   * @returns 更新是否成功
+   * @example $配置.更新配置("key", 100)
+   */
+  function 更新配置(配置键: 字符串, 配置值: 任意类型): 布尔值;
+  /**
+   * 删除配置
+   * @param key 配置key
+   * @returns 删除是否成功
+   * @example $配置.删除配置("key")
+   */
+  function 删除配置(配置键: 字符串): 布尔值;
+}