ms-types 0.9.18 → 0.9.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.9.18",
+  "version": "0.9.20",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "vitepress": "^1.6.4",
-    "vitepress-theme-teek": "^1.6.0",
-    "wrangler": "^4.100.0"
+    "vitepress-theme-teek": "^1.6.2",
+    "wrangler": "^4.118.0"
   }
 }

package/types/dotocr.d.ts

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

package/types/file.d.ts

@@ -1,133 +1,137 @@
-/**
- * 文件模块 包含文件操作、文件内容读写等功能
- */
-declare namespace file {
-  /**
-   * 获取应用内部目录
-   * @param type 目录类型
-   * @returns 目录路径
-   * @example file.getInternalDir("documents")
-   */
-  function getInternalDir(
-    type: "documents" | "library" | "temp" | "libraryCaches"
-  ): string;
-  /**
-   * 获取应用数据目录
-   * @returns 目录路径
-   * @example file.getDataDir()
-   */
-  function getDataDir(): string;
-  /**
-   * 获取应用数据文件路径
-   * @param file 文件名
-   * @returns 文件路径
-   * @example file.getDataFile("config.json")
-   */
-  function getDataFile(file: string): string;
-  /**
-   * 创建文件
-   * @param path 文件路径
-   * @returns 是否创建成功
-   * @example file.create("config.json")
-   */
-  function create(path: string): boolean;
-  /**
-   * 创建目录
-   * @param path 目录路径
-   * @returns 是否创建成功
-   * @example file.mkdirs("config")
-   */
-  function mkdirs(path: string): boolean;
-  /**
-   * 删除文件或目录
-   * @param path 文件或目录路径
-   * @returns 是否删除成功
-   * @example file.deleteAllFile("config")
-   */
-  function deleteAllFile(path: string): boolean;
-  /**
-   * 读取文件内容
-   * @param path 文件路径
-   * @returns 文件内容，如果读取失败返回 null
-   * @example file.readFile("config.json")
-   */
-  function readFile(path: string): string | null;
-  /**
-   * 读取资源文件
-   * @param fileName 文件名
-   * @returns 文件内容
-   * @example
-   * file.readResFile("test.txt")
-   */
-  function readResFile(fileName: string): string | null;
-  /**
-   * 删除文件内容
-   * @param path 文件路径
-   * @param line 行号 如果是-1 代表这个条件不生效
-   * @param contains 包含内容 如果是null 代表这个条件不生效
-   * @returns 是否删除成功
-   * @example file.deleteLine("config.json", 1, null)
-   */
-  function deleteLine(path: string, line: number, contains?: string): boolean;
-  /**
-   * 列出目录下所有文件
-   * @param path 目录路径
-   * @param recursion 是否递归
-   * @returns 文件路径数组
-   * @example file.listDir("config", true)
-   */
-  function listDir(path: string, recursion: boolean): string[];
-  /**
-   * 写入文件内容
-   * @param path 文件路径
-   * @param content 文件内容
-   * @returns 是否写入成功
-   * @example file.writeFile("config.json", "name=agent")
-   */
-  function writeFile(path: string, content: string): boolean;
-  /**
-   * 追加文件内容
-   * @param path 文件路径
-   * @param content 文件内容
-   * @returns 是否追加成功
-   * @example file.appendLine("config.json", "name=agent")
-   */
-  function appendLine(path: string, content: string): boolean;
-  /**
-   * 读取文件第N行内容
-   * @param path 文件路径
-   * @param lineNo 行号
-   * @returns 行内容，如果读取失败返回 null
-   * @example file.readLine("config.json", 1)
-   */
-  function readLine(path: string, lineNo: number): string | null;
-  /**
-   * 读取文件所有行内容
-   * @param path 文件路径
-   * @returns 行内容数组，如果读取失败返回 null
-   * @example file.readAllLines("config.json")
-   */
-  function readAllLines(path: string): string[] | null;
-  /**
-   * 文件或者文件夹是否存在
-   * @param path 文件路径
-   * @returns 是否存在
-   * @example file.exists("config.json")
-   */
-  function exists(path: string): boolean;
-  /**
-   * 复制文件
-   * @param src 源文件路径
-   * @param dest 目标文件路径
-   * @returns 是否复制成功
-   * @example file.copy("config.json", "config2.json")
-   */
-  function copy(src: string, dest: string): boolean;
-  /**
-   * 获取文件MD5值
-   * @param path 文件路径
-   * @returns 文件MD5值
-   * @example file.fileMD5("config.json")
-   */
-  function fileMD5(path: string): string | null;
-}
+/**
+ * 文件模块 包含文件操作、文件内容读写等功能
+ */
+declare namespace file {
+  /**
+   * 获取应用内部目录
+   * @param type 目录类型
+   * @returns 目录路径
+   * @example file.getInternalDir("documents")
+   */
+  function getInternalDir(
+    type: "documents" | "library" | "temp" | "libraryCaches"
+  ): string;
+  /**
+   * 创建文件
+   * @param path 文件路径
+   * @returns 是否创建成功
+   * @example file.create("config.json")
+   */
+  function create(path: string): boolean;
+  /**
+   * 创建目录
+   * @param path 目录路径
+   * @returns 是否创建成功
+   * @example file.mkdirs("config")
+   */
+  function mkdirs(path: string): boolean;
+  /**
+   * 删除文件或目录
+   * @param path 文件或目录路径
+   * @returns 是否删除成功
+   * @example file.deleteAllFile("config")
+   */
+  function deleteAllFile(path: string): boolean;
+  /**
+   * 读取文件内容
+   * @param path 文件路径
+   * @returns 文件内容，如果读取失败返回 null
+   * @example file.readFile("config.json")
+   */
+  function readFile(path: string): string | null;
+  /**
+   * 读取资源文件
+   * @param fileName 文件名
+   * @returns 文件内容
+   * @example
+   * file.readResFile("test.txt")
+   */
+  function readResFile(fileName: string): string | null;
+  /**
+   * 获取 res 资源的本地文件路径
+   * @param fileName 相对 res 目录的资源路径
+   * @returns 本地文件绝对路径，失败返回 null
+   * @example
+   * const path = file.getResFile("model.bin");
+   * if (path) {
+   *   file.cleanupResFile(path);
+   * }
+   */
+  function getResFile(fileName: string): string | null;
+  /**
+   * 清理由 getResFile 得到的本地文件
+   * @param path getResFile 返回的文件路径
+   * @example file.cleanupResFile(path)
+   */
+  function cleanupResFile(path: string): void;
+  /**
+   * 删除文件内容
+   * @param path 文件路径
+   * @param line 行号 如果是-1 代表这个条件不生效
+   * @param contains 包含内容 如果是null 代表这个条件不生效
+   * @returns 是否删除成功
+   * @example file.deleteLine("config.json", 1, null)
+   */
+  function deleteLine(path: string, line: number, contains?: string): boolean;
+  /**
+   * 列出目录下所有文件
+   * @param path 目录路径
+   * @param recursion 是否递归
+   * @returns 文件路径数组
+   * @example file.listDir("config", true)
+   */
+  function listDir(path: string, recursion: boolean): string[];
+  /**
+   * 写入文件内容
+   * @param path 文件路径
+   * @param content 文件内容
+   * @returns 是否写入成功
+   * @example file.writeFile("config.json", "name=agent")
+   */
+  function writeFile(path: string, content: string): boolean;
+  /**
+   * 追加文件内容
+   * @param path 文件路径
+   * @param content 文件内容
+   * @returns 是否追加成功
+   * @example file.appendLine("config.json", "name=agent")
+   */
+  function appendLine(path: string, content: string): boolean;
+  /**
+   * 读取文件第N行内容
+   * @param path 文件路径
+   * @param lineNo 行号
+   * @returns 行内容，如果读取失败返回 null
+   * @example file.readLine("config.json", 1)
+   */
+  function readLine(path: string, lineNo: number): string | null;
+  /**
+   * 读取文件所有行内容
+   * @param path 文件路径
+   * @returns 行内容数组，如果读取失败返回 null
+   * @example file.readAllLines("config.json")
+   */
+  function readAllLines(path: string): string[] | null;
+  /**
+   * 文件或者文件夹是否存在
+   * @param path 文件路径
+   * @returns 是否存在
+   * @example file.exists("config.json")
+   */
+  function exists(path: string): boolean;
+  /**
+   * 复制文件
+   * @param src 源文件路径
+   * @param dest 目标文件路径
+   * @returns 是否复制成功
+   * @example file.copy("config.json", "config2.json")
+   */
+  function copy(src: string, dest: string): boolean;
+  /**
+   * 获取文件MD5值
+   * @param path 文件路径
+   * @returns 文件MD5值
+   * @example file.fileMD5("config.json")
+   */
+  function fileMD5(path: string): string | null;
+}

package/types/global.d.ts

@@ -35,6 +35,10 @@ declare const __bundleId__: string;
  * 当前线程名称
  */
 declare const __threadName__: string;
+/**
+ * 子线程启动参数；仅在线程脚本中可用，未传参数时为空对象
+ */
+declare const __threadParams__: Record<string, any>;
 /**
  * 脚本信息
  */

package/types/index.d.ts

@@ -4,6 +4,7 @@
 /// <reference path="config.d.ts" />
 /// <reference path="cryptoUtils.d.ts" />
 /// <reference path="device.d.ts" />
+/// <reference path="dotocr.d.ts" />
 /// <reference path="file.d.ts" />
 /// <reference path="global.d.ts" />
 /// <reference path="hid.d.ts" />
@@ -16,6 +17,7 @@
 /// <reference path="mysql.d.ts" />
 /// <reference path="netCard.d.ts" />
 /// <reference path="node.d.ts" />
+/// <reference path="opencv.d.ts" />
 /// <reference path="paddleocr.d.ts" />
 /// <reference path="pip.d.ts" />
 /// <reference path="system.d.ts" />

package/types/node.d.ts

@@ -7,7 +7,7 @@ declare function createNodeSelector(params?: {
    */
   maxDepth?: number;
   /**
-   * 抓取模式：模式 1、模式 2，默认模式 1
+   * 抓取模式：模式 1、模式 2、模式 3，默认模式 1
    */
   mode?: number;
 }): NodeSelector;