ms-types 0.0.14 → 0.0.16

package/package.json

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

package/types/{appleocr.d.ts → appleOcr.d.ts}

@@ -1,7 +1,7 @@
 /**
  * Apple OCR模块 使用Apple Vision框架进行文本识别
  */
-declare namespace appleocr {
+declare namespace appleOcr {
   /**
    * 执行OCR识别（使用Apple Vision框架）
    * @param input 输入源（imageId、URL字符串、文件路径或"screen"，null表示使用当前屏幕）
@@ -12,7 +12,7 @@ declare namespace appleocr {
    * @param languages 识别语言数组，默认为["zh-Hans", "en-US"]
    * @returns 识别结果数组，包含文本、置信度、坐标等信息
    * @example
-   * const results = appleocr.recognize("screen", 0, 0, 100, 100, ["zh-Hans", "en-US"])
+   * const results = appleOcr.recognize("screen", 0, 0, 100, 100, ["zh-Hans", "en-US"])
    * results.forEach(result => {
    *   console.log(`文本: ${result.text}, 置信度: ${result.confidence}`)
    * })
@@ -34,10 +34,12 @@ declare namespace appleocr {
    * @param ex 边界框右下角x坐标
    * @param ey 边界框右下角y坐标
    * @param languages 识别语言数组
-   * @returns 识别到的文本字符串（多行文本用换行符分隔）
+   * @returns 识别到的文本字符串数组
    * @example
-   * const text = appleocr.recognizeText("screen", 0, 0, 100, 100)
-   * console.log("识别到的文本:", text)
+   * const texts = appleOcr.recognizeText("screen", 0, 0, 100, 100)
+   * for (const text of texts) {
+   *   logger.info(text)
+   * }
    */
   function recognizeText(
     input: string | null,
@@ -46,7 +48,7 @@ declare namespace appleocr {
     ex: number,
     ey: number,
     languages?: string[]
-  ): string;
+  ): string[];
 
   /**
    * OCR识别结果接口

package/types/device.d.ts

@@ -23,6 +23,12 @@ declare namespace device {
    * @example device.getDeviceID()
    */
   function getDeviceID(): string;
+  /**
+   * 获取服务器设备ID
+   * @returns 服务器设备ID
+   * @example device.getServerDeviceId()
+   */
+  function getServerDeviceId(): string;
   /**
    * 获取设备名称
    * @returns 设备名称

package/types/http.d.ts

@@ -288,7 +288,7 @@ declare namespace http {
    * const ws = http.newWebsocket("ws://www.baidu.com")
    * ws.connect()
    * ws.onText((data) => {
-   *   console.log(data)
+   *   logger.info(data)
    * })
    * ws.sendText("hello")
    * ws.close()

package/types/image.d.ts

@@ -54,7 +54,7 @@ declare namespace image {
    * @example
    * const size = image.getSize(imageId)
    * if (size) {
-   *   console.log(size.width, size.height)
+   *   logger.info(size.width, size.height)
    * }
    */
   function getSize(imageId: string): { width: number; height: number } | null;
@@ -101,7 +101,7 @@ declare namespace image {
    * if (imageId) {
    *   const isSame = image.cmpColor(imageId, "1|2|#6DD1E6-#101010", 10, 0, 0, 100, 100)
    *   if (isSame) {
-   *     console.log("颜色相同")
+   *     logger.info("颜色相同")
    *   }
    * }
    */
@@ -131,7 +131,7 @@ declare namespace image {
    * if (imageId) {
    *   const points = image.findColor(imageId, "0x6DD1E6-0x101010", 10, 0, 0, 100, 100, 1, 1)
    *   if (points.length > 0) {
-   *     console.log("找到颜色")
+   *     logger.info("找到颜色")
    *   }
    * }
    * image.release(imageId)
@@ -165,7 +165,7 @@ declare namespace image {
    * if (imageId) {
    *   const points = image.findMultiColor(imageId, "0x6DD1E6-0x101010", 10, "1|2|#6DD1E6-#101010", 0, 0, 100, 100, 1, 1)
    *   if (points.length > 0) {
-   *     console.log("找到颜色")
+   *     logger.info("找到颜色")
    *   }
    * }
    * image.release(imageId)
@@ -201,7 +201,7 @@ declare namespace image {
    *   if (templateImageId) {
    *     const points = image.findImage(imageId, templateImageId, 0, 0, 100, 100, 0.8, 1, 0)
    *     if (points.length > 0) {
-   *       console.log("找到图片")
+   *       logger.info("找到图片")
    *     }
    *   }
    *   image.release(templateImageId)
@@ -238,7 +238,7 @@ declare namespace image {
    * if (imageId) {
    *   const clipImageId = image.clip(imageId, 0, 0, 100, 100)
    *   if (clipImageId) {
-   *     console.log("裁剪成功")
+   *     logger.info("裁剪成功")
    *   }
    * }
    * image.release(imageId)
@@ -260,7 +260,7 @@ declare namespace image {
    * const imageId = image.readImage("screen.png")
    * if (imageId) {
    *   const color = image.pixel(imageId, 0, 0)
-   *   console.log(color)
+   *   logger.info(color)
    * }
    * image.release(imageId)
    */
@@ -274,7 +274,7 @@ declare namespace image {
    * const imageId = image.readImage("screen.png")
    * if (imageId) {
    *   const color = image.pixel(imageId, 0, 0)
-   *   console.log(image.argb(imageId, color))
+   *   logger.info(image.argb(imageId, color))
    * }
    * image.release(imageId)
    */
@@ -289,7 +289,7 @@ declare namespace image {
    * if (imageId) {
    *   const binaryzationImageId = image.binaryzation(imageId, 128)
    *   if (binaryzationImageId) {
-   *     console.log("二值化成功")
+   *     logger.info("二值化成功")
    *   }
    * }
    * image.release(imageId)
@@ -304,7 +304,7 @@ declare namespace image {
    * if (imageId) {
    *   const grayImageId = image.gray(imageId)
    *   if (grayImageId) {
-   *     console.log("灰度化成功")
+   *     logger.info("灰度化成功")
    *   }
    * }
    * image.release(imageId)
@@ -317,7 +317,7 @@ declare namespace image {
    * @example
    * const imageId = image.base64ToImage("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+P+/HgAFhAJ/wlseKgAAAABJRU5ErkJggg==")
    * if (imageId) {
-   *   console.log("base64转图片成功")
+   *   logger.info("base64转图片成功")
    * }
    * image.release(imageId)
    */
@@ -332,7 +332,7 @@ declare namespace image {
    * const imageId = image.readImage("screen.png")
    * if (imageId) {
    *   const base64 = image.toBase64Format(imageId, "png", 100)
-   *   console.log(base64)
+   *   logger.info(base64)
    * }
    * image.release(imageId)
    */

package/types/ime.d.ts

@@ -7,7 +7,7 @@ declare namespace ime {
    * @returns {boolean} 如果输入法键盘是否已弹出返回 true，否则返回 false
    * @example
    * if (ime.isOk()) {
-   *   console.log("输入法已启动")
+   *   logger.info("输入法已启动")
    * }
    */
   function isOk(): boolean;
@@ -16,7 +16,7 @@ declare namespace ime {
    * @returns {string} 当前输入框的完整文本
    * @example
    * const text = ime.getText()
-   * console.log(text)
+   * logger.info(text)
    */
   function getText(): string;
   /**
@@ -31,7 +31,7 @@ declare namespace ime {
    * @returns {string} 输入后的文本内容 失败返回空字符串
    * @example
    * const text = ime.input("hello")
-   * console.log(text)
+   * logger.info(text)
    */
   function input(text: string): string;
   /**
@@ -40,7 +40,7 @@ declare namespace ime {
    * @returns {string} 粘贴后的文本内容 失败返回空字符串
    * @example
    * const text = ime.paste("hello")
-   * console.log(text)
+   * logger.info(text)
    */
   function paste(text: string): string;
   /**
@@ -48,7 +48,7 @@ declare namespace ime {
    * @returns {string} 如果为空，代表输入框无数据，如果不为空，代表输入框剩余数据
    * @example
    * const text = ime.pressDel()
-   * console.log(text)
+   * logger.info(text)
    */
   function pressDel(): string;
   /**
@@ -56,7 +56,7 @@ declare namespace ime {
    * @returns {boolean} 如果成功返回 true，否则返回 false
    * @example
    * if (ime.pressEnter()) {
-   *   console.log("回车键按下")
+   *   logger.info("回车键按下")
    * }
    */
   function pressEnter(): boolean;
@@ -65,7 +65,7 @@ declare namespace ime {
    * @returns {boolean} 如果成功返回 true，否则返回 false
    * @example
    * if (ime.dismiss()) {
-   *   console.log("键盘已隐藏")
+   *   logger.info("键盘已隐藏")
    * }
    */
   function dismiss(): boolean;
@@ -74,7 +74,7 @@ declare namespace ime {
    * @returns {string} 剪贴板内容
    * @example
    * const text = ime.getClipboard()
-   * console.log(text)
+   * logger.info(text)
    */
   function getClipboard(): string;
   /**
@@ -83,7 +83,7 @@ declare namespace ime {
    * @returns {boolean} 如果成功返回 true，否则返回 false
    * @example
    * if (ime.setClipboard("hello")) {
-   *   console.log("剪贴板内容已设置")
+   *   logger.info("剪贴板内容已设置")
    * }
    */
   function setClipboard(text: string): boolean;
@@ -92,7 +92,7 @@ declare namespace ime {
    * @returns {boolean} 如果成功返回 true，否则返回 false
    * @example
    * if (ime.switchKeyboard()) {
-   *   console.log("键盘已切换")
+   *   logger.info("键盘已切换")
    * }
    */
   function switchKeyboard(): boolean;

package/types/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference path="action.d.ts" />
-/// <reference path="appleocr.d.ts" />
+/// <reference path="appleOcr.d.ts" />
 /// <reference path="config.d.ts" />
 /// <reference path="device.d.ts" />
 /// <reference path="file.d.ts" />
@@ -9,9 +9,11 @@
 /// <reference path="ime.d.ts" />
 /// <reference path="logger.d.ts" />
 /// <reference path="media.d.ts" />
-/// <reference path="paddleocr.d.ts" />
+/// <reference path="mysql.d.ts" />
+/// <reference path="paddleOcr.d.ts" />
 /// <reference path="system.d.ts" />
 /// <reference path="thread.d.ts" />
+/// <reference path="tomatoOcr.d.ts" />
 /// <reference path="ui.d.ts" />
 /// <reference path="utils.d.ts" />
 /// <reference path="yolo.d.ts" />

package/types/media.d.ts

@@ -11,7 +11,7 @@ declare namespace media {
    * if (imageId) {
    *   const saved = media.saveImageToAlbum(imageId)
    *   if (saved) {
-   *     console.log("保存成功")
+   *     logger.info("保存成功")
    *   }
    * }
    */
@@ -24,7 +24,7 @@ declare namespace media {
    * @example
    * const saved = media.saveVideoToAlbumPath("video.mp4")
    * if (saved) {
-   *   console.log("保存成功")
+   *   logger.info("保存成功")
    * }
    */
   function saveVideoToAlbumPath(path: string): boolean;
@@ -35,7 +35,7 @@ declare namespace media {
    * @example
    * const deleted = media.deleteAllPhotos()
    * if (deleted) {
-   *   console.log("删除成功")
+   *   logger.info("删除成功")
    * }
    */
   function deleteAllPhotos(): boolean;
@@ -46,7 +46,7 @@ declare namespace media {
    * @example
    * const deleted = media.deleteAllVideos()
    * if (deleted) {
-   *   console.log("删除成功")
+   *   logger.info("删除成功")
    * }
    */
   function deleteAllVideos(): boolean;
@@ -59,7 +59,7 @@ declare namespace media {
    * @example
    * const played = media.playMp3("music.mp3", true)
    * if (played) {
-   *   console.log("播放成功")
+   *   logger.info("播放成功")
    * }
    */
   function playMp3(path: string, loop: boolean): boolean;
@@ -70,7 +70,7 @@ declare namespace media {
    * @example
    * const stopped = media.stopMp3()
    * if (stopped) {
-   *   console.log("停止成功")
+   *   logger.info("停止成功")
    * }
    */
   function stopMp3(): boolean;
@@ -83,7 +83,7 @@ declare namespace media {
    * @example
    * const played = media.playMp3WaitEnd("music.mp3", true)
    * if (played) {
-   *   console.log("播放成功")
+   *   logger.info("播放成功")
    * }
    */
   function playMp3WaitEnd(path: string, loop: boolean): boolean;

package/types/mysql.d.ts

@@ -0,0 +1,181 @@
+/**
+ * MySQL 数据库模块 - 提供 MySQL 数据库连接和操作功能
+ */
+declare namespace mysql {
+  /**
+   * MySQL 连接配置接口
+   */
+  interface MySQLConfig {
+    /** 数据库主机地址 */
+    host: string;
+    /** 数据库端口，默认 3306 */
+    port?: number;
+    /** 用户名 */
+    username: string;
+    /** 密码 */
+    password: string;
+    /** 数据库名 */
+    database: string;
+    /** 字符集，默认 utf8mb4 */
+    charset?: string;
+  }
+
+  /**
+   * MySQL 查询结果接口
+   */
+  interface MySQLResult {
+    /** 查询结果数据行 */
+    rows: Array<Record<string, any>>;
+    /** 受影响的行数 */
+    affectedRows: number;
+    /** 插入ID（仅适用于INSERT操作） */
+    insertId?: number;
+    /** 查询是否成功 */
+    success: boolean;
+    /** 错误信息 */
+    error?: string;
+  }
+
+  /**
+   * 创建全局 MySQL 连接
+   * @param config 连接配置对象
+   * @returns 是否创建成功
+   * @example
+   * mysql.createConnection({
+   *   host: "localhost",
+   *   port: 3306,
+   *   username: "root",
+   *   password: "password",
+   *   database: "test_db",
+   *   charset: "utf8mb4"
+   * })
+   */
+  function createConnection(config: MySQLConfig): boolean;
+
+  /**
+   * 连接到数据库
+   * @returns 是否连接成功
+   * @example
+   * const connected = mysql.connect()
+   * if (connected) {
+   *   logger.info("数据库连接成功")
+   * }
+   */
+  function connect(): boolean;
+
+  /**
+   * 断开数据库连接
+   * @example
+   * mysql.disconnect()
+   */
+  function disconnect(): void;
+
+  /**
+   * 检查连接状态
+   * @returns 是否已连接
+   * @example
+   * if (mysql.isConnected()) {
+   *   logger.info("数据库已连接")
+   * }
+   */
+  function isConnected(): boolean;
+
+  /**
+   * 执行查询操作（SELECT）
+   * @param sql SQL 查询语句
+   * @param params 查询参数数组，可选
+   * @returns 查询结果对象
+   * @example
+   * // 简单查询
+   * const result = mysql.query("SELECT * FROM users")
+   *
+   * // 带参数查询
+   * const result = mysql.query("SELECT * FROM users WHERE id = ?", [1])
+   *
+   * // 处理结果
+   * if (result.success) {
+   *   logger.info("查询到 " + result.rows.length + " 条记录")
+   *   result.rows.forEach(row => {
+   *     logger.info(row)
+   *   })
+   * } else {
+   *   console.error("查询失败: " + result.error)
+   * }
+   */
+  function query(sql: string, params?: any[]): MySQLResult;
+
+  /**
+   * 执行更新操作（INSERT、UPDATE、DELETE）
+   * @param sql SQL 语句
+   * @param params 参数数组，可选
+   * @returns 执行结果对象
+   * @example
+   * // 插入数据
+   * const result = mysql.execute(
+   *   "INSERT INTO users (name, email) VALUES (?, ?)",
+   *   ["张三", "zhangsan@example.com"]
+   * )
+   *
+   * // 更新数据
+   * const result = mysql.execute(
+   *   "UPDATE users SET name = ? WHERE id = ?",
+   *   ["李四", 1]
+   * )
+   *
+   * // 删除数据
+   * const result = mysql.execute("DELETE FROM users WHERE id = ?", [1])
+   *
+   * // 处理结果
+   * if (result.success) {
+   *   logger.info("影响了 " + result.affectedRows + " 行")
+   *   if (result.insertId) {
+   *     logger.info("新插入记录的ID: " + result.insertId)
+   *   }
+   * } else {
+   *   console.error("执行失败: " + result.error)
+   * }
+   */
+  function execute(sql: string, params?: any[]): MySQLResult;
+
+  /**
+   * 开始事务
+   * @returns 是否成功开始事务
+   * @example
+   * if (mysql.beginTransaction()) {
+   *   try {
+   *     mysql.execute("INSERT INTO users (name) VALUES (?)", ["用户1"])
+   *     mysql.execute("INSERT INTO users (name) VALUES (?)", ["用户2"])
+   *     mysql.commit()
+   *     logger.info("事务提交成功")
+   *   } catch (error) {
+   *     mysql.rollback()
+   *     console.error("事务回滚")
+   *   }
+   * }
+   */
+  function beginTransaction(): boolean;
+
+  /**
+   * 提交事务
+   * @returns 是否成功提交
+   * @example
+   * mysql.beginTransaction()
+   * mysql.execute("INSERT INTO users (name) VALUES (?)", ["测试用户"])
+   * if (mysql.commit()) {
+   *   logger.info("事务提交成功")
+   * }
+   */
+  function commit(): boolean;
+
+  /**
+   * 回滚事务
+   * @returns 是否成功回滚
+   * @example
+   * mysql.beginTransaction()
+   * mysql.execute("INSERT INTO users (name) VALUES (?)", ["测试用户"])
+   * if (mysql.rollback()) {
+   *   logger.info("事务回滚成功")
+   * }
+   */
+  function rollback(): boolean;
+}

package/types/{paddleocr.d.ts → paddleOcr.d.ts}

@@ -1,13 +1,13 @@
 /**
  * 飞桨OCR模块 包含OCR识别、OCR模型加载等功能
  */
-declare namespace paddleocr {
+declare namespace paddleOcr {
   /**
    * 初始化PP-OCRv5模型
    * @param useGpu 是否使用GPU，默认false
    * @returns 初始化是否成功
    * @example
-   * const loaded = paddleocr.loadV5(true)
+   * const loaded = paddleOcr.loadV5(true)
    * if (loaded) {
    *   console.log("加载成功")
    * }
@@ -22,7 +22,7 @@ declare namespace paddleocr {
    * @param ey 边界框右下角y坐标
    * @returns 识别结果数组
    * @example
-   * const results = paddleocr.recognize("screen", 0, 0, 100, 100)
+   * const results = paddleOcr.recognize("screen", 0, 0, 100, 100)
    * if (results.length > 0) {
    *   console.log("识别到文本")
    * }

package/types/system.d.ts

@@ -11,7 +11,7 @@ declare namespace system {
    * @example
    * const started = system.startApp("cn.magicnode.script, [], {})
    * if (started) {
-   *   console.log("启动成功")
+   *   logger.info("启动成功")
    * }
    */
   function startApp(
@@ -26,7 +26,7 @@ declare namespace system {
    * @example
    * const stopped = system.stopApp("cn.magicnode.script")
    * if (stopped) {
-   *   console.log("关闭成功")
+   *   logger.info("关闭成功")
    * }
    */
   function stopApp(bundleId: string): boolean;
@@ -37,7 +37,7 @@ declare namespace system {
    * @example
    * const activated = system.activateApp("cn.magicnode.script")
    * if (activated) {
-   *   console.log("激活成功")
+   *   logger.info("激活成功")
    * }
    */
   function activateApp(bundleId: string): boolean;
@@ -47,7 +47,7 @@ declare namespace system {
    * @example
    * const info = system.activateAppInfo()
    * if (info) {
-   *   console.log(info.name)
+   *   logger.info(info.name)
    * }
    */
   function activateAppInfo(): {
@@ -65,7 +65,7 @@ declare namespace system {
    * @example
    * const locked = system.isLocked()
    * if (locked) {
-   *   console.log("锁屏")
+   *   logger.info("锁屏")
    * }
    */
   function isLocked(): boolean;
@@ -75,7 +75,7 @@ declare namespace system {
    * @example
    * const locked = system.lock()
    * if (locked) {
-   *   console.log("锁屏成功")
+   *   logger.info("锁屏成功")
    * }
    */
   function lock(): boolean;
@@ -85,7 +85,7 @@ declare namespace system {
    * @example
    * const unlocked = system.unlock()
    * if (unlocked) {
-   *   console.log("解锁成功")
+   *   logger.info("解锁成功")
    * }
    */
   function unlock(): boolean;
@@ -96,7 +96,7 @@ declare namespace system {
    * @example
    * const set = system.setClipboard("hello")
    * if (set) {
-   *   console.log("设置成功")
+   *   logger.info("设置成功")
    * }
    */
   function setClipboard(text: string): boolean;
@@ -106,7 +106,7 @@ declare namespace system {
    * @example
    * const text = system.getClipboard()
    * if (text) {
-   *   console.log(text)
+   *   logger.info(text)
    * }
    */
   function getClipboard(): string | null;
@@ -117,7 +117,7 @@ declare namespace system {
    * @example
    * const opened = system.openURL("https://www.baidu.com")
    * if (opened) {
-   *   console.log("打开成功")
+   *   logger.info("打开成功")
    * }
    */
   function openURL(url: string): boolean;
@@ -135,7 +135,7 @@ declare namespace system {
    * @returns 内存使用信息，包含已使用内存、可用内存和总内存（单位：MB）
    * @example
    * const memInfo = system.getMemoryInfo()
-   * console.log(`已使用: ${memInfo.used}MB, 可用: ${memInfo.available}MB, 总计: ${memInfo.total}MB`)
+   * logger.info(`已使用: ${memInfo.used}MB, 可用: ${memInfo.available}MB, 总计: ${memInfo.total}MB`)
    */
   function getMemoryInfo(): {
     used: number;
@@ -147,7 +147,7 @@ declare namespace system {
    * @returns 已使用内存大小（单位：MB）
    * @example
    * const usedMemory = system.getUsedMemory()
-   * console.log(`已使用内存: ${usedMemory}MB`)
+   * logger.info(`已使用内存: ${usedMemory}MB`)
    */
   function getUsedMemory(): number;
   /**
@@ -155,7 +155,7 @@ declare namespace system {
    * @returns 可用内存大小（单位：MB）
    * @example
    * const availableMemory = system.getAvailableMemory()
-   * console.log(`可用内存: ${availableMemory}MB`)
+   * logger.info(`可用内存: ${availableMemory}MB`)
    */
   function getAvailableMemory(): number;
 }

package/types/thread.d.ts

@@ -10,7 +10,7 @@ declare namespace thread {
    * @returns 线程名称
    * @example
    * thread.execCodeAsync("thread.js", "callback", (data) => {
-   *   console.log(data)
+   *   logger.info(data)
    *   return "1111"
    * })
    *
@@ -19,7 +19,7 @@ declare namespace thread {
    *   // 通知主线程并传递数据
    *   const data = thread.invokeCallback("callback", "hello world")
    *   // 主线程返回数据
-   *   console.log(data)
+   *   logger.info(data)
    *   sleep(1000)
    * }
    */
@@ -35,7 +35,7 @@ declare namespace thread {
    * @returns 回调返回值
    * @example
    * const data = thread.invokeCallback("callback", "hello world")
-   * console.log(data)
+   * logger.info(data)
    */
   function invokeCallback(name: string, data?: any): any;
   /**
@@ -45,7 +45,7 @@ declare namespace thread {
    * @example
    * const newThread = thread.newThread("thread.js")
    * newThread.addCallback("callback", (data) => {
-   *   console.log(data)
+   *   logger.info(data)
    *   return "1111"
    * })
    */
@@ -72,7 +72,7 @@ declare namespace thread {
    * @example
    * const newThread = thread.newThread("thread.js")
    * newThread.addCallback("callback", (data) => {
-   *   console.log(data)
+   *   logger.info(data)
    *   return "1111"
    * })
    * thread.cancelThread(newThread.name)
@@ -85,7 +85,7 @@ declare namespace thread {
    * @example
    * const newThread = thread.newThread("thread.js")
    * newThread.addCallback("callback", (data) => {
-   *   console.log(data)
+   *   logger.info(data)
    *   return "1111"
    * })
    * thread.isCancelled(newThread.name)

package/types/tomatoOcr.d.ts

@@ -0,0 +1,199 @@
+/**
+ * TomatoOCR 模块
+ * 提供基于 TomatoOCR 框架的文字识别和 YOLO 目标检测功能
+ */
+declare namespace tomatoOcr {
+  /**
+   * 初始化TomatoOCR并设置基本配置
+   * @param mode 运行模式 debug：调试模型；删除或传别的任何值为正式模式
+   * @param licenseData 许可证数据
+   * @param remark 备注信息（可选）
+   * @returns 设置结果
+   * @example
+   * ```typescript
+   * // 不带备注
+   * const result1 = tomatoOcr.initializeWithConfig("online", "your_license_data");
+   * // 带备注
+   * const result2 = tomatoOcr.initializeWithConfig("online", "your_license_data", "测试环境");
+   * logger.info(result1, result2);
+   * ```
+   */
+  function initializeWithConfig(
+    mode: string,
+    licenseData: string,
+    remark?: string
+  ): {
+    deviceId: string;
+    expiryTime: string;
+    message: string;
+    status: string;
+    versionName: string;
+  } | null;
+
+  /**
+   * 设置 HTTP 请求间隔时间
+   * @param second 间隔秒数 设置网络请求间隔时间，非必设置。0-86400
+   * @example
+   * ```typescript
+   * tomatoOcr.setHttpIntervalTime(3600);
+   * ```
+   */
+  function setHttpIntervalTime(second: number): void;
+
+  /**
+   * 设置识别类型
+   * @param recType 识别类型 模型类型,默认 ch-3.0,除此之外还有 ch-2.0, ch, cht, japan, korean, number
+   * @example
+   * ```typescript
+   * // 普通中英文识别，3.0版模型
+   * tomatoOcr.setRecType("ch-3.0");
+   * // 普通中英文识别，2.0版模型
+   * tomatoOcr.setRecType("ch-2.0");
+   * // 普通中英文识别，1.0版模型
+   * tomatoOcr.setRecType("ch");
+   * // 繁体
+   * tomatoOcr.setRecType("cht");
+   * // 日语
+   * tomatoOcr.setRecType("japan");
+   * // 韩语
+   * tomatoOcr.setRecType("korean");
+   * // 数字模型
+   * tomatoOcr.setRecType("number");
+   * ```
+   */
+  function setRecType(recType: string): void;
+
+  /**
+   * 设置检测框类型
+   * @param detBoxType 检测框类型 默认"rect": 由于手机上截图文本均为矩形文本；"quad"：可准确检测倾斜文本
+   * @example
+   * ```typescript
+   * // 矩形文本
+   * tomatoOcr.setDetBoxType("rect");
+   * // 倾斜文本
+   * tomatoOcr.setDetBoxType("quad");
+   * ```
+   */
+  function setDetBoxType(detBoxType: string): void;
+
+  /**
+   * 设置检测框展开比例
+   * @param detUnclipRatio 设置检测模型框选文本范围大小的参数，非必设置，默认为1.9。值范围1.6-2.5之间，值越大框选范围越大，值越小框选范围越小；当框选到了，但识别得分较低，就可以调整该参数改善准确率。
+   * @example
+   * ```typescript
+   * tomatoOcr.setDetUnclipRatio(1.9);
+   * ```
+   */
+  function setDetUnclipRatio(detUnclipRatio: number): void;
+
+  /**
+   * 设置识别分数阈值
+   * @param recScoreThreshold 设置识别模型过滤得分的参数，非必设置，默认0.1。由于返回的识别结果数据太多太乱，可以通过设置该参数，过滤一些得分较低不准的数据，使得结果看起来更加简练。
+   * @example
+   * ```typescript
+   * tomatoOcr.setRecScoreThreshold(0.1);
+   * ```
+   */
+  function setRecScoreThreshold(recScoreThreshold: number): void;
+
+  /**
+   * 设置返回类型
+   * @param returnType 设置调用插件识别返回格式的参数，非必设置，默认为json。默认"json": 包含得分、坐标和文字；"text"：纯文字；"num"：纯数字；自定义输入想要返回的文本：".￥1234567890"，仅只返回这些内容
+   * @example
+   * ```typescript
+   * tomatoOcr.setReturnType("json");
+   * ```
+   */
+  function setReturnType(returnType: string): void;
+
+  /**
+   * 设置二值化阈值
+   * @param binaryThresh 设置图像二值化的参数，非必设置，默认0，不进行二值化。 二值化设定0-255，常规情况下不需要设置，可配合中调试应用使用。
+   * @example
+   * ```typescript
+   * tomatoOcr.setBinaryThresh(0);
+   * ```
+   */
+  function setBinaryThresh(binaryThresh: number): void;
+
+  /**
+   * 设置运行模式
+   * @param runMode 运行模式
+   * @example
+   * ```typescript
+   * tomatoOcr.setRunMode("fast");
+   * ```
+   */
+  function setRunMode(runMode: string): void;
+
+  /**
+   * 设置图像滤色参数，非必设置，默认""，对图片中的文字进行颜色过滤，可以是单色也可以为多色，配合调试工具使用，如下图：
+   * @param filterColor 颜色过滤，通过逗号相互连，第一个是颜色值，第二个是负偏色，第三个是正偏色；不同颜色之间以"|"连接
+   * @param backgroundColor 滤色后的背景色，传""或black的时候，背景是黑色，传“white”的时候，背景是白色
+   * @example
+   * ```typescript
+   * tomatoOcr.setFilterColor("#41917A,38,38", "black");
+   * tomatoOcr.setFilterColor("#41917A,38,38|#E091A8,50,50", "white");
+   * ```
+   */
+  function setFilterColor(filterColor: string, backgroundColor: string): void;
+
+  /**
+   * 对图像执行 OCR 识别
+   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，null表示使用当前屏幕）
+   * @param type 识别类型 默认3: 检测 + 识别；0: 只检测；1: 方向分类+识别；2: 只识别；3: 检测+识别
+   * @param x 边界框左上角x坐标
+   * @param y 边界框左上角y坐标
+   * @param ex 边界框右下角x坐标
+   * @param ey 边界框右下角y坐标
+   * @returns OCR识别结果JSON字符串
+   * @example
+   * ```typescript
+   * // 识别屏幕
+   * const result1 = tomatoOcr.ocrImage(null, 0, 0, 0, 0, 0);
+   * logger.info(`识别屏幕结果：${result1}`);
+   *
+   * // 识别文件
+   * const result2 = tomatoOcr.ocrImage("/path/to/image.png", 0);
+   * logger.info(`识别文件结果：${result2}`);
+   *
+   * // 识别指定屏幕区域
+   * const result3 = tomatoOcr.ocrImage("screen", 0);
+   * logger.info(`识别指定屏幕区域结果：${result3}`);
+   * ```
+   */
+  function ocrImage(
+    input: string | null,
+    type: number,
+    x: number,
+    y: number,
+    ex: number,
+    ey: number
+  ): string;
+
+  /**
+   * 查找点击点
+   * @param data 要找的文字
+   * @returns 找“要找的文字”的中心点 没有找到返回空字符串
+   * @example
+   * ```typescript
+   * const result = tomatoOcr.findTapPoint('{"text": "确定"}');
+   * const tapPoint = JSON.parse(result);
+   * logger.info(tapPoint);
+   * ```
+   */
+  function findTapPoint(data: string): string;
+
+  /**
+   * 查找多个点击点
+   * @param data 要找的文字
+   * @returns 找“要找的文字”的所有相匹配的中心点 没有找到返回空字符串
+   * @example
+   * ```typescript
+   * const result = tomatoOcr.findTapPoints('{"texts": ["确定", "取消"]}');
+   * const tapPoints = JSON.parse(result);
+   * logger.info(tapPoints);
+   * ```
+   */
+  function findTapPoints(data: string): string;
+}

package/types/ui.d.ts

@@ -3,14 +3,17 @@
  * @param name 函数名称
  * @param func 函数
  */
-declare function registerUIFunc(name: string, func: (data: any) => void): void;
+declare function registerUIFunc(
+  name: string,
+  func: (data: Record<string, any>) => void
+): void;
 
 /**
  * 发送事件 网页页面使用 给主进程发送事件
  * @param event 事件名称
  * @param data 事件参数
  */
-declare function emitEvent(event: string, data: any): void;
+declare function emitEvent(event: string, data: Record<string, any>): void;
 
 /**
  * UI模块 包含加载html文件、调用js方法等功能
@@ -34,9 +37,11 @@ declare namespace ui {
      * @param key 方法名
      * @param data 方法参数
      * @example
-     * webview.call("jsMethod", "hello world")
+     * webview.call("jsMethod", {
+     *   name: "magicscript",
+     * })
      */
-    call(key: string, data: any): void;
+    call(key: string, data: Record<string, any>): void;
   }
   /**
    * 创建WebView
@@ -47,21 +52,23 @@ declare namespace ui {
    * const webview = ui.newWebView("index.html", (event, data) => {
    *   // 接收网页发送的事件
    *   if(event === "page.loaded") {
-   *     console.log("页面加载完成")
+   *     logger.info("页面加载完成")
    *   } else if(event === "page.close") {
-   *     console.log("页面关闭")
+   *     logger.info("页面关闭")
    *   } else if(event === "console.log") {
-   *     console.log("网页调用console.log", data)
+   *     logger.info("网页调用console.log:" + data)
    *   } else {
    *     // 自定义事件
-   *     console.log(event, data)
+   *     logger.info(event, data)
    *   }
    * })
    * webview.show()
-   * webview.call("jsMethod", "hello world")
+   * webview.call("jsMethod", {
+   *   name: "magicscript",
+   * })
    */
   function newWebView(
     file: string,
-    onEvent: (event: string, data: any) => void
+    onEvent: (event: string, data: string | Record<string, any>) => void
   ): WebView;
 }