ms-types 0.0.64 → 0.0.65

package/package.json

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

package/types/zh/index.d.ts

@@ -1,2 +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

@@ -8,6 +8,9 @@ declare type 数组<T> = Array<T>;
 declare type 字典<T> = Record<字符串, T>;
 declare type 无返回值 = void;
 
+declare const $真: 布尔值;
+declare const $假: 布尔值;
+
 /**
  * 是否是调试模式
  */

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 删除配置(配置键: 字符串): 布尔值;
+}