ms-types 0.0.65 → 0.0.66

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

@@ -0,0 +1,274 @@
+/// <reference path="全局模块.d.ts" />
+/**
+ * 节点模块 包含节点操作、节点内容读写等功能
+ */
+declare function $创建节点选择器(params?: {
+  /**
+   *  1 代表不管visible是true还是false都获取，2 代表只获取 visible=true的节点
+   */
+  visibleFilter: 1 | 2;
+  /**
+   *  1 代表不管label是否有值都获取，2 代表只获取label有值的节点
+   */
+  labelFilter: 1 | 2;
+  /**
+   *  1 代表不过滤 2 bounds 区域属性x,y,w,h都小于0就被过滤
+   */
+  boundsFilter: 1 | 2;
+  /**
+   * 代表要获取节点的层级，越少速度越快，建议 1 - 50
+   */
+  maxDepth: 数字;
+  /**
+   * 最大获取子节点数量，0代表不限制
+   */
+  maxChildCount: 数字;
+  /**
+   * 代表要过滤的属性，用英文逗号分割，可以增加抓取速度，例如 visible,enable
+   */
+  excludedAttributes: 字符串;
+}): $节点选择器;
+
+declare interface $节点位置信息 {
+  /**
+   * x坐标
+   */
+  x: 数字;
+  /**
+   * y坐标
+   */
+  y: 数字;
+  /**
+   * 宽度
+   */
+  width: 数字;
+  /**
+   * 高度
+   */
+  height: 数字;
+  /**
+   * 节点中心x坐标
+   */
+  centerX: 数字;
+  /**
+   * 节点中心y坐标
+   */
+  centerY: 数字;
+}
+
+declare interface $节点信息 {
+  id: 数字;
+  /**
+   * 节点标签
+   */
+  label: 字符串;
+  /**
+   * 节点类型
+   */
+  type: 字符串;
+  /**
+   * 节点值
+   */
+  value: 字符串;
+  /**
+   * 节点名称
+   */
+  name: 字符串;
+  /**
+   * 节点是否可见
+   */
+  visible: 布尔值;
+  /**
+   * 节点是否启用
+   */
+  enabled: 布尔值;
+  /**
+   * 节点是否可访问
+   */
+  accessible: 布尔值;
+  /**
+   * 节点位置
+   */
+  bounds: $节点位置信息;
+  /**
+   * 节点层级
+   */
+  depth: 数字;
+  /**
+   * 节点索引
+   */
+  index: 数字;
+  /**
+   * 父节点id
+   */
+  parentId: 数字;
+  /**
+   * 子节点数量
+   */
+  childCount: 数字;
+  /**
+   * 点击节点中心
+   */
+  clickCenter(): 布尔值;
+  /**
+   * 点击节点随机位置
+   */
+  clickRandom(): 布尔值;
+  /**
+   * 获取父节点
+   */
+  parent(): $节点信息 | null;
+  /**
+   * 获取子节点
+   * @param 索引 子节点索引
+   */
+  child(索引: 数字): $节点信息 | null;
+  /**
+   * 获取所有子节点
+   */
+  allChildren(): 数组<$节点信息>;
+  /**
+   * 获取所有兄弟节点
+   */
+  siblings(): 数组<$节点信息>;
+  /**
+   * 获取所有前兄弟节点
+   */
+  previousSiblings(): 数组<$节点信息>;
+  /**
+   * 获取所有后兄弟节点
+   */
+  nextSiblings(): 数组<$节点信息>;
+}
+
+/**
+ * 节点选择器 包含节点选择、节点操作等功能
+ */
+declare class $节点选择器 {
+  /**
+   * 获取节点信息
+   * @param 超时时间 单位毫秒 默认为 5000 毫秒
+   * @returns 节点信息数组
+   */
+  获取所有节点(超时时间?: 数字): 数组<$节点信息>;
+  /**
+   * 获取一个节点信息
+   * @param 超时时间 超时时间，单位毫秒 默认为 5000 毫秒
+   * @returns 节点信息
+   */
+  获取一个节点(超时时间?: 数字): $节点信息 | null;
+  /**
+   * 加载节点
+   * @param 超时时间 超时时间，单位毫秒 默认为 5000 毫秒
+   */
+  加载节点数据(超时时间?: 数字): $节点选择器;
+  /**
+   * 清除条件
+   */
+  清除所有选择条件(): $节点选择器;
+  /**
+   * 获取节点xpath
+   * @param xpath 节点xpath路径
+   * @returns 节点选择器
+   */
+  xpath(xpath: 字符串): $节点选择器;
+  /**
+   * 获取节点标签
+   * @param label 节点标签
+   * @returns 节点选择器
+   */
+  label(label: 字符串): $节点选择器;
+  /**
+   * 获取节点标签匹配
+   * @param match 匹配字符串
+   * @returns 节点选择器
+   */
+  labelMatch(match: 字符串): $节点选择器;
+  /**
+   * 获取节点名称
+   * @param name 节点名称
+   * @returns 节点选择器
+   */
+  name(name: 字符串): $节点选择器;
+  /**
+   * 获取节点名称匹配
+   * @param match 匹配字符串
+   * @returns 节点选择器
+   */
+  nameMatch(match: 字符串): $节点选择器;
+  /**
+   * 获取节点类型
+   * @param type 节点类型
+   * @returns 节点选择器
+   */
+  type(type: 字符串): $节点选择器;
+  /**
+   * 获取节点类型匹配
+   * @param match 匹配字符串
+   * @returns 节点选择器
+   */
+  typeMatch(match: 字符串): $节点选择器;
+  /**
+   * 获取节点值
+   * @param value 节点值
+   * @returns 节点选择器
+   */
+  value(value: 字符串): $节点选择器;
+  /**
+   * 获取节点值匹配
+   * @param match 匹配字符串
+   * @returns 节点选择器
+   */
+  valueMatch(match: 字符串): $节点选择器;
+  /**
+   * 获取节点是否启用
+   * @param enable 是否启用
+   * @returns 节点选择器
+   */
+  enable(enable: 布尔值): $节点选择器;
+  /**
+   * 获取节点是否可访问
+   * @param accessible 是否可访问
+   * @returns 节点选择器
+   */
+  accessible(accessible: 布尔值): $节点选择器;
+  /**
+   * 获取节点是否可见
+   * @param visible 是否可见
+   * @returns 节点选择器
+   */
+  visible(visible: 布尔值): $节点选择器;
+  /**
+   * 获取节点索引
+   * @param index 节点索引
+   * @returns 节点选择器
+   */
+  index(index: 数字): $节点选择器;
+  /**
+   * 获取节点层级
+   * @param depth 节点层级
+   * @returns 节点选择器
+   */
+  depth(depth: 数字): $节点选择器;
+  /**
+   * 获取节点是否选中
+   * @param selected 是否选中
+   * @returns 节点选择器
+   */
+  selected(selected: 布尔值): $节点选择器;
+  /**
+   * 获取节点子节点数量
+   * @param childCount 子节点数量
+   * @returns 节点选择器
+   */
+  childCount(childCount: 数字): $节点选择器;
+  /**
+   * 获取节点位置
+   * @param x x坐标
+   * @param y y坐标
+   * @param width 宽度
+   * @param height 高度
+   * @returns 节点选择器
+   */
+  bounds(x: 数字, y: 数字, width: 数字, height: 数字): $节点选择器;
+}

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

@@ -9,25 +9,25 @@ declare namespace $苹果OCR {
    */
   interface OCR识别结果 {
     /** 识别的文本内容 */
-    text: string;
+    text: 字符串;
     /** 识别置信度 (0-1) */
-    confidence: number;
+    confidence: 数字;
     /** 文本区域左上角 x 坐标 */
-    x: number;
+    x: 数字;
     /** 文本区域左上角 y 坐标 */
-    y: number;
+    y: 数字;
     /** 文本区域右下角 x 坐标 */
-    ex: number;
+    ex: 数字;
     /** 文本区域右下角 y 坐标 */
-    ey: number;
+    ey: 数字;
     /** 文本区域宽度 */
-    width: number;
+    width: 数字;
     /** 文本区域高度 */
-    height: number;
+    height: 数字;
     /** 文本区域中心点 x 坐标 */
-    centerX: number;
+    centerX: 数字;
     /** 文本区域中心点 y 坐标 */
-    centerY: number;
+    centerY: 数字;
   }
 
   /**
@@ -40,17 +40,17 @@ declare namespace $苹果OCR {
    * @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}`)
+   * const 检查结果数组 = $苹果OCR.识别("screen", 0, 0, 100, 100, ["zh-Hans", "en-US"])
+   * 检查结果数组.forEach(目标 => {
+   *   $打印信息日志(`文本: ${目标.text}, 置信度: ${目标.confidence}`)
    * })
    */
   function 识别(
     输入源: 字符串,
-    图片边界框左上角x坐标: 数字,
-    图片边界框左上角y坐标: 数字,
-    图片边界框右下角x坐标: 数字,
-    图片边界框右下角y坐标: 数字,
+    图片边界框左上角x坐标?: 数字,
+    图片边界框左上角y坐标?: 数字,
+    图片边界框右下角x坐标?: 数字,
+    图片边界框右下角y坐标?: 数字,
     识别语言数组?: Array<字符串>
   ): 数组<OCR识别结果>;
 
@@ -63,17 +63,17 @@ declare namespace $苹果OCR {
    * @param 图片边界框右下角y坐标 图片边界框右下角y坐标
    * @returns 识别结果数组，包含文本、置信度、坐标等信息
    * @example
-   * const results = $苹果OCR.识别数字("screen", 0, 0, 100, 100)
-   * results.forEach(result => {
-   *   logger.info(`文本: ${result.text}, 置信度: ${result.confidence}`)
+   * const 检查结果数组 = $苹果OCR.识别数字("screen", 0, 0, 100, 100)
+   * 检查结果数组.forEach(目标 => {
+   *   $打印信息日志(`文本: ${目标.text}, 置信度: ${目标.confidence}`)
    * })
    */
   function 识别数字(
     输入源: 字符串,
-    图片边界框左上角x坐标: 数字,
-    图片边界框左上角y坐标: 数字,
-    图片边界框右下角x坐标: 数字,
-    图片边界框右下角y坐标: 数字
+    图片边界框左上角x坐标?: 数字,
+    图片边界框左上角y坐标?: 数字,
+    图片边界框右下角x坐标?: 数字,
+    图片边界框右下角y坐标?: 数字
   ): 数组<OCR识别结果>;
 
   /**
@@ -87,18 +87,18 @@ declare namespace $苹果OCR {
    * @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}`)
+   * const 检查结果数组 = $苹果OCR.查找文本("screen", ["123", "456"], 0, 0, 100, 100, ["zh-Hans", "en-US"])
+   * 检查结果数组.forEach(目标 => {
+   *   $打印信息日志(`文本: ${目标.text}, 置信度: ${目标.confidence}`)
    * })
    */
   function 查找文本(
     输入源: 字符串,
     要查找的文本数组: 数组<字符串>,
-    图片边界框左上角x坐标: 数字,
-    图片边界框左上角y坐标: 数字,
-    图片边界框右下角x坐标: 数字,
-    图片边界框右下角y坐标: 数字,
+    图片边界框左上角x坐标?: 数字,
+    图片边界框左上角y坐标?: 数字,
+    图片边界框右下角x坐标?: 数字,
+    图片边界框右下角y坐标?: 数字,
     识别语言数组?: 数组<字符串>
   ): 数组<OCR识别结果>;
 }

package/types/zh//350/247/206/345/233/276/346/250/241/345/235/227.d.ts

@@ -0,0 +1,167 @@
+/// <reference path="全局模块.d.ts" />
+
+declare namespace $快点 {
+  /**
+   * 注册UI函数 网页页面使用，给主进程调用
+   * @param name 函数名称
+   * @param func 函数
+   */
+  function registerUIFunc(
+    name: string,
+    func: (data: Record<string, any>) => void
+  ): void;
+
+  /**
+   * 发送事件 网页页面使用 给主进程发送事件
+   * @param event 事件名称
+   * @param data 事件参数
+   */
+  function emitEvent(event: string, data: Record<string, any>): void;
+
+  /**
+   * 启动脚本 网页页面使用
+   * @returns 如果启动成功返回true，否则返回false
+   */
+  function startTask(): Promise<boolean>;
+
+  /**
+   * 停止脚本 网页页面使用
+   * @returns 如果停止成功返回false，否则返回true
+   */
+  function stopTask(): Promise<boolean>;
+
+  /**
+   * 检查脚本是否正在运行 网页页面使用
+   * @returns 如果脚本正在运行返回true，否则返回false
+   */
+  function isTaskRunning(): Promise<boolean>;
+
+  /**
+   * 设置配置项
+   * @param key 配置项键
+   * @param value 配置项值
+   * @returns 如果设置成功返回true，否则返回false
+   */
+  function setConfig(key: string, value: any): Promise<boolean>;
+
+  /**
+   * 获取配置项
+   * @param key 配置项键
+   * @returns 配置项值
+   */
+  function getConfig(key: string): Promise<any>;
+
+  /**
+   * 移除配置项
+   * @param key 配置项键
+   * @returns 如果移除成功返回true，否则返回false
+   */
+  function removeConfig(key: string): Promise<boolean>;
+
+  /**
+   * 获取所有配置的字典
+   * @returns 包含所有配置的字典
+   */
+  function getAllConfig(): Promise<Record<string, any>>;
+
+  /**
+   * 获取服务器设备ID
+   * @returns 服务器设备ID
+   */
+  function getServerDeviceId(): Promise<string>;
+
+  /**
+   * 获取WDA状态
+   * @returns 如果WDA正在运行返回true，否则返回false
+   */
+  function getWDAStatus(): Promise<boolean>;
+
+  /**
+   * 启动WDA服务
+   * @returns 如果调用成功返回true，否则返回false。注意：返回值仅表示调用是否成功，不代表WDA服务是否启动成功
+   */
+  function startWDA(): Promise<boolean>;
+
+  /**
+   * 打开URL
+   * @param url URL地址
+   * @returns 如果调用成功返回true，否则返回false
+   */
+  function openURL(url: string): Promise<boolean>;
+}
+
+/**
+ * UI模块 提供WebView相关功能
+ */
+declare namespace $视图 {
+  /**
+   * 设置事件回调函数
+   * @param onEvent 事件回调函数
+   * @example
+   * $视图.监听事件回调((事件名称, 数据) => {
+   *   // 接收网页发送的事件
+   *   $打印信息日志(`事件名称: ${事件名称}, 数据: ${JSON.stringify(数据)}`)
+   * })
+   */
+  function 监听事件回调(
+    回调函数: (事件名称: string, 数据: 字典<任意类型>) => 无返回值
+  ): 无返回值;
+
+  /**
+   * 调用WebView中的JavaScript函数
+   * @param 函数名 registerUIFunc 注册的函数名
+   * @param 数据
+   * @example
+   * $视图.调用函数("jsMethod", {
+   *   name: "快点JS",
+   * })
+   */
+  function 调用函数(函数名: 字符串, 数据: 任意类型): 无返回值;
+
+  /**
+   * 显示Toast提示消息
+   * @param 消息内容 提示消息内容
+   * @example
+   * $视图.显示Toast提示("操作成功");
+   */
+  function 显示Toast提示(消息内容: 字符串): 无返回值;
+
+  /**
+   * 显示确认对话框
+   * @param title 对话框标题
+   * @param message 对话框内容
+   * @returns 用户选择结果，确定返回true，取消返回false
+   * @example
+   * const 是否确认 = $视图.显示确认对话框("确认", "是否继续操作？");
+   * if (是否确认) {
+   *   $打印信息日志("用户点击了确定");
+   * } else {
+   *   $打印信息日志("用户点击了取消");
+   * }
+   */
+  function 显示确认对话框(标题: 字符串, 消息内容: 字符串): 布尔值;
+
+  /**
+   * 显示输入对话框
+   * @param 标题 对话框标题
+   * @param 消息内容 对话框内容
+   * @returns 用户输入的内容，取消返回空字符串
+   * @example
+   * const 输入内容 = $视图.显示输入对话框("输入", "请输入您的姓名：");
+   * if (输入内容) {
+   *   $打印信息日志(`用户输入了：${输入内容}`);
+   * } else {
+   *   $打印信息日志("用户取消了输入");
+   * }
+   */
+  function 显示输入对话框(标题: 字符串, 消息内容: 字符串): 字符串;
+
+  /**
+   * 显示警告对话框
+   * @param 标题 对话框标题
+   * @param 消息内容 对话框内容
+   * @example
+   * $视图.显示警告对话框("警告", "操作失败，请重试！");
+   */
+  function 显示警告对话框(标题: 字符串, 消息内容: 字符串): 无返回值;
+}

package/types/zh//350/276/223/345/205/245/346/263/225/346/250/241/345/235/227.d.ts

@@ -0,0 +1,100 @@
+/// <reference path="全局模块.d.ts" />
+/**
+ * 输入法模块 包含输入法操作、输入法内容读写等功能
+ */
+declare namespace $输入法 {
+  /**
+   * 检查输入法是否正常工作 键盘是否已弹出
+   * @returns 如果输入法键盘是否已弹出返回 true，否则返回 false
+   * @example
+   * if ($输入法.是否可用()) {
+   *   $打印信息日志("输入法已启动")
+   * }
+   */
+  function 是否可用(): 布尔值;
+  /**
+   * 获取当前输入框的文本内容
+   * @returns 当前输入框的完整文本
+   * @example
+   * const 文本 = $输入法.获取文本()
+   * $打印信息日志(文本)
+   */
+  function 获取文本(): 字符串;
+  /**
+   * 清空当前输入框的文本内容
+   * @example
+   * $输入法.清空文本()
+   */
+  function 清空文本(): 布尔值;
+  /**
+   * 模拟输入文本
+   * @param 要输入的文本
+   * @returns 输入后的文本内容 失败返回空字符串
+   * @example
+   * const 文本 = $输入法.输入("hello")
+   * $打印信息日志(文本)
+   */
+  function 输入(要输入的文本: 字符串): 字符串;
+  /**
+   * 模拟粘贴文本
+   * @param 要粘贴的文本
+   * @returns 粘贴后的文本内容 失败返回空字符串
+   * @example
+   * const 文本 = $输入法.粘贴("hello")
+   * $打印信息日志(文本)
+   */
+  function 粘贴(要粘贴的文本?: 字符串): 字符串;
+  /**
+   * 模拟删除键
+   * @returns 如果为空，代表输入框无数据，如果不为空，代表输入框剩余数据
+   * @example
+   * const 文本 = $输入法.按删除键()
+   * $打印信息日志(文本)
+   */
+  function 按删除键(): 字符串;
+  /**
+   * 模拟回车键
+   * @returns {boolean} 如果成功返回 true，否则返回 false
+   * @example
+   * if ($输入法.按回车键()) {
+   *   $打印信息日志("回车键按下")
+   * }
+   */
+  function 按回车键(): 布尔值;
+  /**
+   * 隐藏键盘
+   * @returns {boolean} 如果成功返回 true，否则返回 false
+   * @example
+   * if ($输入法.隐藏键盘()) {
+   *   $打印信息日志("键盘已隐藏")
+   * }
+   */
+  function 隐藏键盘(): 布尔值;
+  /**
+   * 获取剪贴板内容
+   * @returns 剪贴板内容
+   * @example
+   * const 文本 = $输入法.获取剪贴板内容()
+   * $打印信息日志(文本)
+   */
+  function 获取剪贴板内容(): 字符串;
+  /**
+   * 设置剪贴板内容
+   * @param 要设置的剪贴板内容 键盘显示时才能设置
+   * @returns 如果成功返回 true，否则返回 false
+   * @example
+   * if ($输入法.设置剪切板内容("hello")) {
+   *   $打印信息日志("剪贴板内容已设置")
+   * }
+   */
+  function 设置剪切板内容(要设置的剪贴板内容: 字符串): 布尔值;
+  /**
+   * 切换键盘
+   * @returns 如果成功返回 true，否则返回 false
+   * @example
+   * if ($输入法.切换输入法()) {
+   *   $打印信息日志("键盘已切换")
+   * }
+   */
+  function 切换输入法(): 布尔值;
+}