ms-types 0.9.19 → 0.9.21

package/types/pip.d.ts

@@ -27,9 +27,10 @@ declare namespace pip {
   function closeWindow(): boolean;
   /**
    * 设置日志模式或自定义模式的悬浮窗内容尺寸
+   * 传入的宽高表示宽高比，不是最终像素尺寸；实际显示宽高由系统决定
    * 日志模式和自定义模式会分别持久化尺寸；保活模式返回 false
-   * @param width 目标内容宽度
-   * @param height 目标内容高度
+   * @param width 宽度方向比例值（与 height 共同决定宽高比，不是像素）
+   * @param height 高度方向比例值（与 width 共同决定宽高比，不是像素）
    * @returns true代表尺寸已提交，false代表当前模式不允许设置或宽高无效
    */
   function setContentSize(width: number, height: number): boolean;

package/types/zh/index.d.ts

@@ -6,6 +6,7 @@
 /// <reference path="云控模块.d.ts" />
 /// <reference path="配置模块.d.ts" />
 /// <reference path="苹果OCR.d.ts" />
+/// <reference path="点阵OCR模块.d.ts" />
 /// <reference path="全局模块.d.ts" />
 /// <reference path="热更新模块.d.ts" />
 /// <reference path="日志模块.d.ts" />

package/types/zh//346/202/254/346/265/256/347/252/227/346/250/241/345/235/227.d.ts

@@ -26,9 +26,10 @@ declare namespace $悬浮窗 {
   function 切换到自定义模式(): 布尔值;
   /**
    * 设置日志模式或自定义模式的悬浮窗内容尺寸
+   * 传入的宽高表示宽高比，不是最终像素尺寸；实际显示宽高由系统决定
    * 日志模式和自定义模式会分别持久化尺寸；保活模式返回 false
-   * @param 宽度 目标内容宽度
-   * @param 高度 目标内容高度
+   * @param 宽度 宽度方向比例值（与高度共同决定宽高比，不是像素）
+   * @param 高度 高度方向比例值（与宽度共同决定宽高比，不是像素）
    * @returns true代表尺寸已提交，false代表当前模式不允许设置或宽高无效
    */
   function 设置内容尺寸(宽度: 数字, 高度: 数字): 布尔值;

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

@@ -1,134 +1,138 @@
-/// <reference path="全局模块.d.ts" />
-/**
- * 文件模块 包含文件操作、文件内容读写等功能
- */
-declare namespace $文件 {
-  /**
-   * 获取应用内部目录
-   * @param 目录类型 documents 文档目录 library 库目录 temp 临时目录 libraryCaches 库缓存目录
-   * @description 一般使用documents目录，其他目录不常用 documents目录下的文件，会在我的文件中显示
-   * @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 文件内容，如果读取失败返回 null
-   * @example $文件.读取文件("config.json")
-   */
-  function 读取文件(文件路径: 字符串): 字符串 | null;
-  /**
-   * 读取资源文件
-   * @param 文件名
-   * @returns 文件内容
-   * @example $文件.读取资源文件("test.txt")
-   */
-  function 读取资源文件(文件名: 字符串): 字符串 | null;
-  /**
-   * 删除文件内容
-   * @param 文件路径 文件路径
-   * @param 行号 如果是-1 代表这个条件不生效
-   * @param 包含内容 如果是null 代表这个条件不生效
-   * @returns 是否删除成功
-   * @example $文件.删除指定行("config.json", 1, null)
-   */
-  function 删除指定行(文件路径: 字符串, 行号: 数字, 包含内容?: 字符串): 布尔值;
-  /**
-   * 列出目录下所有文件
-   * @param 目录路径
-   * @param 是否递归
-   * @returns 文件路径数组
-   * @example $文件.列出目录列表("config", true)
-   */
-  function 列出目录列表(目录路径: 字符串, 是否递归: 布尔值): 数组<字符串>;
-  /**
-   * 写入文件内容
-   * @param 文件路径
-   * @param 文件内容
-   * @returns 是否写入成功
-   * @example $文件.写入文件("config.json", "name=test")
-   */
-  function 写入文件(文件路径: 字符串, 文件内容: 字符串): 布尔值;
-  /**
-   * 追加文件内容
-   * @param 文件路径
-   * @param 文件内容
-   * @returns 是否追加成功
-   * @example $文件.追加行("config.json", "name=test")
-   */
-  function 追加行(文件路径: 字符串, 文件内容: 字符串): 布尔值;
-  /**
-   * 读取文件第N行内容
-   * @param 文件路径
-   * @param 行号
-   * @returns 行内容，如果读取失败返回 null
-   * @example $文件.读取指定行("config.json", 1)
-   */
-  function 读取指定行(文件路径: 字符串, 行号: 数字): 字符串 | null;
-  /**
-   * 读取文件所有行内容
-   * @param 文件路径
-   * @returns 行内容数组，如果读取失败返回 null
-   * @example $文件.读取所有行("config.json")
-   */
-  function 读取所有行(文件路径: 字符串): 数组<字符串> | null;
-  /**
-   * 文件或者文件夹是否存在
-   * @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;
-}
+/// <reference path="全局模块.d.ts" />
+/**
+ * 文件模块 包含文件操作、文件内容读写等功能
+ */
+declare namespace $文件 {
+  /**
+   * 获取应用内部目录
+   * @param 目录类型 documents 文档目录 library 库目录 temp 临时目录 libraryCaches 库缓存目录
+   * @description 一般使用documents目录，其他目录不常用 documents目录下的文件，会在我的文件中显示
+   * @returns 目录路径
+   * @example $文件.获取内部目录("documents")
+   */
+  function 获取内部目录(
+    目录类型: "documents" | "library" | "temp" | "libraryCaches"
+  ): 字符串;
+  /**
+   * 创建文件
+   * @param 文件路径
+   * @returns 是否创建成功
+   * @example $文件.创建文件("config.json")
+   */
+  function 创建文件(文件路径: 字符串): 布尔值;
+  /**
+   * 创建目录
+   * @param 目录路径
+   * @returns 是否创建成功
+   * @example $文件.创建目录("config")
+   */
+  function 创建目录(目录路径: 字符串): 布尔值;
+  /**
+   * 删除文件或目录
+   * @param 文件或目录路径
+   * @returns 是否删除成功
+   * @example $文件.删除所有文件("config")
+   */
+  function 删除所有文件(文件或目录路径: 字符串): 布尔值;
+  /**
+   * 读取文件内容
+   * @param 文件路径
+   * @returns 文件内容，如果读取失败返回 null
+   * @example $文件.读取文件("config.json")
+   */
+  function 读取文件(文件路径: 字符串): 字符串 | null;
+  /**
+   * 读取资源文件
+   * @param 文件名
+   * @returns 文件内容
+   * @example $文件.读取资源文件("test.txt")
+   */
+  function 读取资源文件(文件名: 字符串): 字符串 | null;
+  /**
+   * 获取 res 资源的本地文件路径
+   * @param 文件名 相对 res 目录的资源路径
+   * @returns 本地文件绝对路径，失败返回 null
+   * @example
+   * const 路径 = $文件.获取资源文件("model.bin");
+   * if (路径) {
+   *   $文件.清理资源文件(路径);
+   * }
+   */
+  function 获取资源文件(文件名: 字符串): 字符串 | null;
+  /**
+   * 清理由获取资源文件得到的本地文件
+   * @param 文件路径 获取资源文件返回的文件路径
+   * @example $文件.清理资源文件(路径)
+   */
+  function 清理资源文件(文件路径: 字符串): void;
+  /**
+   * 删除文件内容
+   * @param 文件路径 文件路径
+   * @param 行号 如果是-1 代表这个条件不生效
+   * @param 包含内容 如果是null 代表这个条件不生效
+   * @returns 是否删除成功
+   * @example $文件.删除指定行("config.json", 1, null)
+   */
+  function 删除指定行(文件路径: 字符串, 行号: 数字, 包含内容?: 字符串): 布尔值;
+  /**
+   * 列出目录下所有文件
+   * @param 目录路径
+   * @param 是否递归
+   * @returns 文件路径数组
+   * @example $文件.列出目录列表("config", true)
+   */
+  function 列出目录列表(目录路径: 字符串, 是否递归: 布尔值): 数组<字符串>;
+  /**
+   * 写入文件内容
+   * @param 文件路径
+   * @param 文件内容
+   * @returns 是否写入成功
+   * @example $文件.写入文件("config.json", "name=test")
+   */
+  function 写入文件(文件路径: 字符串, 文件内容: 字符串): 布尔值;
+  /**
+   * 追加文件内容
+   * @param 文件路径
+   * @param 文件内容
+   * @returns 是否追加成功
+   * @example $文件.追加行("config.json", "name=test")
+   */
+  function 追加行(文件路径: 字符串, 文件内容: 字符串): 布尔值;
+  /**
+   * 读取文件第N行内容
+   * @param 文件路径
+   * @param 行号
+   * @returns 行内容，如果读取失败返回 null
+   * @example $文件.读取指定行("config.json", 1)
+   */
+  function 读取指定行(文件路径: 字符串, 行号: 数字): 字符串 | null;
+  /**
+   * 读取文件所有行内容
+   * @param 文件路径
+   * @returns 行内容数组，如果读取失败返回 null
+   * @example $文件.读取所有行("config.json")
+   */
+  function 读取所有行(文件路径: 字符串): 数组<字符串> | null;
+  /**
+   * 文件或者文件夹是否存在
+   * @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//347/202/271/351/230/265OCR/346/250/241/345/235/227.d.ts

@@ -0,0 +1,64 @@
+/// <reference path="全局模块.d.ts" />
+
+/** 固定像素尺寸的点阵 OCR（`kuaijs-dot-font` 字库）。 */
+declare namespace $点阵OCR {
+  interface OCR字符 {
+    text: 字符串;
+    confidence: 数字;
+    x: 数字;
+    y: 数字;
+    ex: 数字;
+    ey: 数字;
+    width: 数字;
+    height: 数字;
+    centerX: 数字;
+    centerY: 数字;
+  }
+
+  /**
+   * 从资源路径加载字库并缓存。
+   * 常见路径如 `/fonts/default.json`；运行时会解析 `res` 目录。
+   * 字库 JSON 中每个字符自带前景色/偏色（`threshold`），识别时按各字颜色匹配。
+   * @returns 成功返回字库 ID，失败返回 `null`
+   */
+  function 加载字库(字库资源路径: 字符串): 字符串 | null;
+
+  /** 释放指定字库。未加载也视为成功。 */
+  function 释放(字库ID: 字符串): void;
+
+  /** 释放全部已加载的点阵字库。 */
+  function 释放全部(): void;
+
+  /**
+   * 识别文字并返回原图或全屏绝对坐标。
+   * 颜色按字库逐字自带的前景色/偏色匹配，无需额外传色。
+   * 结果按行从上到下、同行从左到右排列。
+   * @param 置信度阈值 相似度下限；`<=0` 时按 `0.8`；`>0.95` 时要求像素完全一致
+   */
+  function 识别绝对坐标(
+    字库ID: 字符串,
+    输入源: 字符串,
+    左?: 数字,
+    上?: 数字,
+    右?: 数字,
+    下?: 数字,
+    置信度阈值?: 数字,
+  ): 数组<OCR字符>;
+
+  /**
+   * 先识别再按行查找目标串，返回命中位置的绝对坐标。
+   * `完整匹配=false`：行内子串包含；`完整匹配=true`：整行文本必须完全等于目标。
+   * 每个目标最多返回一次命中（最先匹配到的行）。
+   */
+  function 查找文本绝对坐标(
+    字库ID: 字符串,
+    输入源: 字符串,
+    目标文本: 数组<字符串>,
+    左?: 数字,
+    上?: 数字,
+    右?: 数字,
+    下?: 数字,
+    置信度阈值?: 数字,
+    完整匹配?: 布尔值,
+  ): 数组<OCR字符>;
+}

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

@@ -8,7 +8,7 @@ declare function $创建节点选择器(params?: {
    */
   maxDepth?: number;
   /**
-   * 抓取模式：模式 1、模式 2，默认模式 1
+   * 抓取模式：模式 1、模式 2、模式 3，默认模式 1
    */
   mode?: number;
 }): $节点选择器;
@@ -102,6 +102,39 @@ declare interface $节点信息 {
    * 节点是否可接收事件 用于判断是否显示在屏幕上
    */
   hittable(): 布尔值;
+  /**
+   * 无障碍点击
+   */
+  tap(): 布尔值;
+  /**
+   * 无障碍双击
+   */
+  doubleTap(): 布尔值;
+  /**
+   * 无障碍长按
+   * @param duration 长按持续时间，单位毫秒
+   */
+  press(duration: 数字): 布尔值;
+  /**
+   * 将节点滚动到可见区域
+   */
+  scrollToVisible(): 布尔值;
+  /**
+   * 清空输入
+   */
+  clearInput(): 布尔值;
+  /**
+   * 追加输入（聚焦后输入）
+   * @param text 要输入的文本
+   */
+  input(text: 字符串): 布尔值;
+  /**
+   * 设置节点的值，按控件类型自动处理：
+   * - `XCUIElementTypePickerWheel`：传选项文案，如 `"1小时"`
+   * - 文本类控件（`TextField` / `SecureTextField` / `TextView` / `SearchField` 等）：传要输入的文本（先聚焦再输入，不清空已有内容）
+   * @param text 目标值
+   */
+  setValue(text: 字符串): 布尔值;
   /**
    * 获取父节点
    */