ms-types 0.10.0 → 0.10.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -18,6 +18,6 @@
   "devDependencies": {
     "vitepress": "^1.6.4",
     "vitepress-theme-teek": "^1.6.2",
-    "wrangler": "^4.129.0"
+    "wrangler": "^4.129.1"
   }
 }

package/types/ai.d.ts

@@ -14,7 +14,7 @@ declare namespace ai {
     name: string;
     /** 接口协议 */
     protocol: "openai" | "anthropic" | "gemini";
-    /** 接口根地址，例如 https://api.openai.com/v1 */
+    /** 接口根地址，例如 https://api.deepseek.com */
     baseUrl: string;
     /** API Key；openai 协议连本机模型时可为空 */
     apiKey: string;
@@ -26,6 +26,11 @@ declare namespace ai {
     temperature?: number;
     /** 默认最大输出 token；不传则不发该字段，用模型自己的默认值（Anthropic 因接口必填仍默认 2048） */
     maxTokens?: number;
+    /**
+     * 思考级别，只对 openai 协议生效（请求字段 reasoning_effort）。
+     * 不传则不发，用服务商默认。
+     */
+    reasoningEffort?: "none" | "low" | "medium" | "high" | "xhigh";
     /** 是否支持图片输入，默认 true；为 false 时带图调用直接报错 */
     supportsVision: boolean;
     /** 是否为默认供应商 */

package/types/appleocr.d.ts

@@ -28,29 +28,6 @@ declare namespace appleOcr {
     centerY: number;
   }
 
-  /**
-   * 执行OCR识别（使用Apple Vision框架）
-   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param x 边界框左上角x坐标 默认 0
-   * @param y 边界框左上角y坐标 默认 0
-   * @param ex 边界框右下角x坐标 默认 0
-   * @param ey 边界框右下角y坐标 默认 0
-   * @param languages 识别语言数组，默认为["zh-Hans", "en-US"]
-   * @returns 识别结果数组，包含文本、置信度、坐标等信息
-   * @deprecated 请改用 recognizeAbs，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const results = appleOcr.recognizeAbs("screen", 0, 0, 100, 100, ["zh-Hans", "en-US"])
-   * logi(`识别数量: ${results.length}`)
-   */
-  function recognize(
-    input: string,
-    x?: number,
-    y?: number,
-    ex?: number,
-    ey?: number,
-    languages?: string[]
-  ): OCRResult[];
-
   /**
    * 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
    * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
@@ -75,27 +52,6 @@ declare namespace appleOcr {
     languages?: string[]
   ): OCRResult[];
 
-  /**
-   * 执行OCR识别（仅识别数字）0-9.,+-
-   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param x 边界框左上角x坐标
-   * @param y 边界框左上角y坐标
-   * @param ex 边界框右下角x坐标
-   * @param ey 边界框右下角y坐标
-   * @returns 识别结果数组，包含文本、置信度、坐标等信息
-   * @deprecated 请改用 recognizeNumbersAbs，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const results = appleOcr.recognizeNumbersAbs("screen", 0, 0, 100, 100)
-   * logi(`数字识别数量: ${results.length}`)
-   */
-  function recognizeNumbers(
-    input: string,
-    x?: number,
-    y?: number,
-    ex?: number,
-    ey?: number
-  ): OCRResult[];
-
   /**
    * 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
    * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
@@ -118,33 +74,6 @@ declare namespace appleOcr {
     ey?: number
   ): OCRResult[];
 
-  /**
-   * 执行OCR识别，在整段识别文本中查找指定子串
-   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param texts 要查找的目标文本数组，可匹配识别结果中的子串
-   * @param x 边界框左上角x坐标
-   * @param y 边界框左上角y坐标
-   * @param ex 边界框右下角x坐标
-   * @param ey 边界框右下角y坐标
-   * @param languages 识别语言数组，默认为["zh-Hans", "en-US"]
-   * @param exactMatch 是否完整匹配，默认 false 表示包含匹配；传 true 时要求整条 OCR 识别结果文本等于目标文本
-   * @returns 命中子串的识别结果数组，坐标对应目标子串区域
-   * @deprecated 请改用 findTextAbs，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const results = appleOcr.findTextAbs("screen", ["开始"], 0, 0, 100, 100, ["zh-Hans", "en-US"])
-   * logi(`命中数量: ${results.length}`)
-   */
-  function findText(
-    input: string,
-    texts: string[],
-    x?: number,
-    y?: number,
-    ex?: number,
-    ey?: number,
-    languages?: string[],
-    exactMatch?: boolean
-  ): OCRResult[];
-
   /**
    * 查找指定子串，并将子串结果坐标映射为原图/全屏绝对坐标。
    * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）

package/types/device.d.ts

@@ -72,21 +72,6 @@ declare namespace device {
    * @example device.getDeviceModel()
    */
   function getDeviceModel(): string;
-  /**
-   * 获取屏幕宽高
-   * @returns 获取屏幕宽高缩放后的，实际宽高，请使用`getScreenRealSize()`获取未缩放的宽高
-   * @example device.getScreenSize()
-   */
-  function getScreenSize(): {
-    /**
-     * 屏幕宽度
-     */
-    width: number;
-    /**
-     * 屏幕高度
-     */
-    height: number;
-  };
   /**
    * 获取屏幕实际大小
    * @returns 屏幕实际大小

package/types/image.d.ts

@@ -21,37 +21,6 @@ declare namespace image {
     ex?: number,
     ey?: number,
   ): string | null;
-  /**
-   * 截图
-   * @returns 截图的imageId ，如果截图失败则返回null
-   * @deprecated 请改用 captureScreen()。
-   * @example
-   * const imageId = image.captureScreen()
-   * if (imageId) {
-   *   image.saveTo(imageId, "screen.jpg")
-   * }
-   */
-  function captureFullScreen(): string | null;
-  /**
-   * 截图指定区域
-   * @param x 截图区域左上角x坐标
-   * @param y 截图区域左上角y坐标
-   * @param ex 截图区域右下角x坐标
-   * @param ey 截图区域右下角y坐标
-   * @returns 截图的imageId ，如果截图失败则返回null
-   * @deprecated 请改用 captureScreen(x, y, ex, ey)。
-   * @example
-   * const imageId = image.captureScreen(0, 0, 100, 100)
-   * if (imageId) {
-   *   image.saveTo(imageId, "screen.jpg")
-   * }
-   */
-  function captureRect(
-    x: number,
-    y: number,
-    ex: number,
-    ey: number,
-  ): string | null;
   /**
    * 保存图片
    * @param imageId 图片id 路径 http地址或者 screen 实时截屏

package/types/lua/ai.lua

@@ -6,12 +6,13 @@ local _Ai = {}
 ---@field id string 供应商 id，不传时自动生成
 ---@field name string 展示名，例如 "DeepSeek"，调用时可用它选模型
 ---@field protocol "openai"|"anthropic"|"gemini" 接口协议
----@field baseUrl string 接口根地址，例如 https://api.openai.com/v1
+---@field baseUrl string 接口根地址，例如 https://api.deepseek.com
 ---@field apiKey string API Key；openai 协议连本机模型时可为空
 ---@field model string 默认模型名
 ---@field headers table<string, string> 额外请求头，某些网关需要
 ---@field temperature number|nil 默认温度；不传则不发该字段，用模型自己的默认值
 ---@field maxTokens integer|nil 默认最大输出 token；不传则不发该字段，用模型自己的默认值（Anthropic 因接口必填仍默认 2048）
+---@field reasoningEffort "none"|"low"|"medium"|"high"|"xhigh"|nil 思考级别，仅 openai 协议；不传不发，用服务商默认
 ---@field supportsVision boolean 是否支持图片输入，默认 true
 ---@field isDefault boolean 是否为默认供应商
 

package/types/lua/appleocr.lua

@@ -14,25 +14,6 @@ local _AppleOCR = {}
 ---@field centerX integer 文本区域中心点 x 坐标
 ---@field centerY integer 文本区域中心点 y 坐标
 
---- 识别文本（兼容旧接口，请改用 recognizeAbs）
---- @deprecated 请改用 recognizeAbs，避免裁剪区域坐标和全屏坐标混用。
---- @param input string 图像ID或路径
---- @param x integer|nil 区域X，默认0
---- @param y integer|nil 区域Y，默认0
---- @param ex integer|nil 区域右下角 X，默认0
---- @param ey integer|nil 区域右下角 Y，默认0
---- @param langs string[]|nil 语言数组
---- @return AppleOCRResult[] 结果数组
-function _AppleOCR.recognize(input, x, y, ex, ey, langs)
-    x = x or 0;
-    y = y or 0;
-    ex = ex or 0;
-    ey = ey or 0
-    ---@type AppleOCRResult[]
-    local ret = {}
-    return ret
-end
-
 --- 识别文本，坐标映射为原图/全屏绝对坐标
 --- @param input string 图像ID或路径
 --- @param x integer|nil 区域X，默认0
@@ -47,24 +28,6 @@ function _AppleOCR.recognizeAbs(input, x, y, ex, ey, langs)
     return ret
 end
 
---- 识别数字（兼容旧接口，请改用 recognizeNumbersAbs）
---- @deprecated 请改用 recognizeNumbersAbs，避免裁剪区域坐标和全屏坐标混用。
---- @param input string 图像ID或路径
---- @param x integer|nil 区域X，默认0
---- @param y integer|nil 区域Y，默认0
---- @param ex integer|nil 区域右下角 X，默认0
---- @param ey integer|nil 区域右下角 Y，默认0
---- @return AppleOCRResult[] 结果数组
-function _AppleOCR.recognizeNumbers(input, x, y, ex, ey)
-    x = x or 0;
-    y = y or 0;
-    ex = ex or 0;
-    ey = ey or 0
-    ---@type AppleOCRResult[]
-    local ret = {}
-    return ret
-end
-
 --- 识别数字，坐标映射为原图/全屏绝对坐标
 --- @param input string 图像ID或路径
 --- @param x integer|nil 区域X，默认0
@@ -78,27 +41,6 @@ function _AppleOCR.recognizeNumbersAbs(input, x, y, ex, ey)
     return ret
 end
 
---- 查找文本（兼容旧接口，请改用 findTextAbs）
---- @deprecated 请改用 findTextAbs，避免裁剪区域坐标和全屏坐标混用。
---- @param input string 图像ID或路径
---- @param targets string[]|string 目标文本数组或逗号分隔字符串
---- @param x integer|nil 区域X，默认0
---- @param y integer|nil 区域Y，默认0
---- @param ex integer|nil 区域右下角 X，默认0
---- @param ey integer|nil 区域右下角 Y，默认0
---- @param langs string[]|nil 语言数组
---- @param exactMatch boolean|nil 是否完整匹配，默认 false
---- @return AppleOCRResult[] 结果数组
-function _AppleOCR.findText(input, targets, x, y, ex, ey, langs, exactMatch)
-    x = x or 0;
-    y = y or 0;
-    ex = ex or 0;
-    ey = ey or 0
-    ---@type AppleOCRResult[]
-    local ret = {}
-    return ret
-end
-
 --- 查找文本，坐标映射为原图/全屏绝对坐标
 --- @param input string 图像ID或路径
 --- @param targets string[]|string 目标文本数组或逗号分隔字符串

package/types/lua/device.lua

@@ -51,12 +51,6 @@ function _Device.getDeviceName() return '' end
 ---@return string
 function _Device.getDeviceModel() return '' end
 
---- 屏幕逻辑尺寸
----@return ScreenSize
-function _Device.getScreenSize()
-    return { width = 0, height = 0 }
-end
-
 --- 屏幕实际尺寸
 ---@return ScreenSize
 function _Device.getScreenRealSize()

package/types/lua/image.lua

@@ -37,20 +37,6 @@ local _Image = {}
 --- @return string|nil 图片ID
 function _Image.captureScreen(x, y, ex, ey) return '' end
 
---- 全屏截屏（兼容旧接口，请改用 captureScreen）
---- @deprecated 请改用 captureScreen()。
---- @return string|nil 图片ID
-function _Image.captureFullScreen() return '' end
-
---- 区域截屏（兼容旧接口，请改用 captureScreen）
---- @deprecated 请改用 captureScreen(x, y, ex, ey)。
---- @param x integer|nil
---- @param y integer|nil
---- @param ex integer|nil 右下角x
---- @param ey integer|nil 右下角y
---- @return string|nil 图片ID
-function _Image.captureRect(x, y, ex, ey) return '' end
-
 --- 读取图片
 --- @param path string 文件路径
 --- @return string 图片ID

package/types/lua/paddleocr.lua

@@ -16,13 +16,6 @@ local _PaddleOCR = {}
 ---@field angle number 文本旋转角度 (度)
 ---@field orientation integer 文本方向 (0=水平,1=垂直 等)
 
---- 加载 V5 模型（兼容旧接口，请改用 loadModel）
---- @deprecated 请改用 loadModel("ppocr-v5", useGpu)；检测长边请使用 setMaxSideLen 单独设置。
---- @param maxSideLen integer|nil 目标边长，默认 640
---- @param useGpu boolean|nil 是否启用 GPU，默认 false
---- @return boolean 成功
-function _PaddleOCR.loadV5(maxSideLen, useGpu) return true end
-
 --- 按内置模型 ID 加载
 --- @param modelId string `"ppocr-v6-tiny"` / `"ppocr-v6-small"` / `"ppocr-v5"`
 --- @param useGpu boolean|nil 是否启用 GPU，默认 false
@@ -34,21 +27,6 @@ function _PaddleOCR.loadModel(modelId, useGpu) return true end
 --- @return boolean 成功
 function _PaddleOCR.setMaxSideLen(maxSideLen) return true end
 
---- 识别文本（兼容旧接口，请改用 recognizeAbs）
---- @deprecated 请改用 recognizeAbs，避免裁剪区域坐标和全屏坐标混用。
---- @param input string 图像ID或路径
---- @param x integer|nil 默认0
---- @param y integer|nil 默认0
---- @param ex integer|nil 默认0
---- @param ey integer|nil 默认0
---- @param confidenceThreshold number|nil 置信阈值 默认0.6
---- @return PaddleOCRResult[] 结果数组
-function _PaddleOCR.recognize(input, x, y, ex, ey, confidenceThreshold)
-    ---@type PaddleOCRResult[]
-    local ret = {}
-    return ret
-end
-
 --- 识别文本，坐标映射为原图/全屏绝对坐标
 --- @param input string 图像ID或路径
 --- @param x integer|nil 默认0
@@ -63,23 +41,6 @@ function _PaddleOCR.recognizeAbs(input, x, y, ex, ey, confidenceThreshold)
     return ret
 end
 
---- 查找目标文本（兼容旧接口，请改用 findTextAbs）
---- @deprecated 请改用 findTextAbs，避免裁剪区域坐标和全屏坐标混用。
---- @param input string 图像ID或路径
---- @param targets string[]|string 目标文本数组或逗号分隔字符串
---- @param x integer|nil 默认0
---- @param y integer|nil 默认0
---- @param ex integer|nil 默认0
---- @param ey integer|nil 默认0
---- @param confidenceThreshold number|nil 置信阈值 默认0.6
---- @param exactMatch boolean|nil 是否完整匹配，默认 false
---- @return PaddleOCRResult[] 结果数组
-function _PaddleOCR.findText(input, targets, x, y, ex, ey, confidenceThreshold, exactMatch)
-    ---@type PaddleOCRResult[]
-    local ret = {}
-    return ret
-end
-
 --- 查找目标文本，坐标映射为原图/全屏绝对坐标
 --- @param input string 图像ID或路径
 --- @param targets string[]|string 目标文本数组或逗号分隔字符串

package/types/lua/yolo.lua

@@ -23,25 +23,6 @@ local _Yolo = {}
 --- @return string|nil 模型ID（失败返回 nil）
 function _Yolo.load(paramPath, binPath, nc, version, useGpu) return nil end
 
---- 加载 YOLOv11 模型（兼容旧接口，请改用 load）
---- @deprecated 请改用 load(paramPath, binPath, nc, 11, useGpu)。
---- @param paramPath string ncnn param 路径
---- @param binPath string ncnn bin 路径
---- @param nc integer|nil 标签数量；传 0 或省略时按模型输出推断
---- @param useGpu boolean|nil 是否启用 GPU，默认 false
---- @return string|nil 模型ID（失败返回 nil）
-function _Yolo.loadV11(paramPath, binPath, nc, useGpu) return nil end
-
---- 检测（兼容旧接口，请改用 detectAbs）
---- @deprecated 请改用 detectAbs，避免裁剪区域坐标和全屏坐标混用。
---- @param id string 模型ID
---- @param input string 图像ID或路径
---- @param target integer 目标边长（默认 640）
---- @param thr number 置信阈值（默认 0.4）
---- @param nms number NMS 阈值（默认 0.5）
---- @return YoloResult[] 结果数组
-function _Yolo.detect(id, input, target, thr, nms) return {} end
-
 --- 区域检测，坐标映射为原图/全屏绝对坐标
 --- @param id string 模型ID
 --- @param input string 图像ID或路径

package/types/paddleocr.d.ts

@@ -37,17 +37,6 @@ declare namespace paddleOcr {
     orientation: number;
   }
 
-  /**
-   * 手动切换到 PP-OCRv5 模型。PaddleOCR 默认自动加载 PP-OCRv6 small；同一时间只保留一个 active 模型，加载成功后会替换已加载的 PP-OCRv6 模型。
-   * @param maxSideLen 最大边长，默认768，可不传
-   * @param useGpu 是否使用GPU，默认false，可不传
-   * @returns 加载成功或模型已加载返回true
-   * @deprecated 请改用 loadModel("ppocr-v5", useGpu)；检测长边请使用 setMaxSideLen 单独设置。
-   * @example
-   * const results = paddleOcr.recognizeAbs("screen", 0, 0, 0, 0)
-   * logi(`识别数量: ${results.length}`)
-   */
-  function loadV5(maxSideLen?: number, useGpu?: boolean): boolean;
   /**
    * 按模型 ID 手动加载内置 PaddleOCR 模型。识别和查找方法默认自动加载 ppocr-v6-small；同一时间只保留一个 active 模型，加载成功后会替换已加载模型；检测长边请使用 setMaxSideLen 单独设置。
    * @param modelId 模型 ID，必须传入，支持 "ppocr-v6-tiny"、"ppocr-v6-small"、"ppocr-v5"
@@ -70,30 +59,6 @@ declare namespace paddleOcr {
    * const results = paddleOcr.recognizeAbs("screen", 0, 0, 0, 0)
    */
   function setMaxSideLen(maxSideLen?: number): boolean;
-  /**
-   * 执行OCR识别
-   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param x 裁剪区域左上角 x 坐标，全屏传 0，默认 0
-   * @param y 裁剪区域左上角 y 坐标，全屏传 0，默认 0
-   * @param ex 裁剪区域右下角 x 坐标，全屏传 0，默认 0
-   * @param ey 裁剪区域右下角 y 坐标，全屏传 0，默认 0
-   * @param confidenceThreshold 置信度阈值，默认 0.6
-   * @returns 识别结果数组，坐标相对于裁剪区域
-   * @deprecated 请改用 recognizeAbs，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const results = paddleOcr.recognize("screen", 100, 100, 500, 300)
-   * if (results.length > 0) {
-   *   logi(`区域坐标: ${results[0].centerX}, ${results[0].centerY}`)
-   * }
-   */
-  function recognize(
-    input: string,
-    x?: number,
-    y?: number,
-    ex?: number,
-    ey?: number,
-    confidenceThreshold?: number,
-  ): OCRResult[];
   /**
    * 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标
    * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
@@ -117,34 +82,6 @@ declare namespace paddleOcr {
     ey?: number,
     confidenceThreshold?: number,
   ): OCRResult[];
-  /**
-   * 查找目标文本并返回对应子串坐标
-   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param targetTexts 目标文本数组，例如 ["你好", "确定"]
-   * @param x 裁剪区域左上角 x 坐标，全屏传 0，默认 0
-   * @param y 裁剪区域左上角 y 坐标，全屏传 0，默认 0
-   * @param ex 裁剪区域右下角 x 坐标，全屏传 0，默认 0
-   * @param ey 裁剪区域右下角 y 坐标，全屏传 0，默认 0
-   * @param confidenceThreshold 置信度阈值，默认 0.6
-   * @param exactMatch 是否完整匹配，默认 false 表示包含匹配；传 true 时要求整条 OCR 识别结果文本等于目标文本
-   * @returns 匹配到的子串结果数组，坐标相对于裁剪区域
-   * @deprecated 请改用 findTextAbs，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const results = paddleOcr.findText("screen", ["确定"], 100, 100, 500, 300, 0.6)
-   * if (results.length > 0) {
-   *   logi(`命中: ${results[0].text}`)
-   * }
-   */
-  function findText(
-    input: string,
-    targetTexts: string[],
-    x?: number,
-    y?: number,
-    ex?: number,
-    ey?: number,
-    confidenceThreshold?: number,
-    exactMatch?: boolean,
-  ): OCRResult[];
   /**
    * 查找目标文本并返回对应子串的原图/全屏绝对坐标
    * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）

package/types/yolo.d.ts

@@ -65,43 +65,6 @@ declare namespace yolo {
     version?: number,
     useGpu?: boolean,
   ): string | null;
-  /**
-   * 加载YOLOv11模型 （兼容 yolov8 模型）
-   * @param paramPath ncnn模型的param文件的绝对路径
-   * @param binPath ncnn模型的bin文件绝对路径
-   * @param nc 模型的标签数量；传 0 或省略时根据模型输出自动推断，显式传入但不匹配时检测返回空数组
-   * @param useGpu 是否使用 GPU 加载
-   * @returns 加载成功返回模型ID字符串，失败返回null
-   * @deprecated 请改用 load(paramPath, binPath, nc, 11, useGpu)。
-   * @example
-   * const modelId = yolo.load("yolov11n.param", "yolov11n.bin", 0, 11, false)
-   */
-  function loadV11(
-    paramPath: string,
-    binPath: string,
-    nc?: number,
-    useGpu?: boolean,
-  ): string | null;
-
-  /**
-   * 目标检测
-   * @param modelId 模型ID
-   * @param img 图像ID，"screen"用当前屏幕检测，可以填入图像ID或者http图片地址或文件地址
-   * @param targetSize 图像进入后缩放的检测大小，模型训练一般都用640，因此这里的640一般不要改
-   * @param threshold 置信度，默认0.4，小于这个值的会被过滤掉
-   * @param nmsThreshold 重叠阈值，一般是0.5不需要更改
-   * @returns 检测结果数组
-   * @deprecated 请改用 detectAbs，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const results = yolo.detectAbs(modelId, "screen", 0, 0, 0, 0, 640, 0.4, 0.5)
-   */
-  function detect(
-    modelId: string,
-    img: string,
-    targetSize?: number,
-    threshold?: number,
-    nmsThreshold?: number,
-  ): YoloResult[];
 
   /**
    * 对指定区域执行目标检测，并将结果坐标映射为原图/全屏绝对坐标

package/types/zh/AI/346/250/241/345/235/227.d.ts

@@ -16,7 +16,7 @@ declare namespace $AI {
     name: 字符串;
     /** 接口协议 */
     protocol: "openai" | "anthropic" | "gemini";
-    /** 接口根地址，例如 https://api.openai.com/v1 */
+    /** 接口根地址，例如 https://api.deepseek.com */
     baseUrl: 字符串;
     /** API Key；openai 协议连本机模型时可为空 */
     apiKey: 字符串;
@@ -28,6 +28,11 @@ declare namespace $AI {
     temperature?: 数字;
     /** 默认最大输出 token；不传则不发该字段，用模型自己的默认值（Anthropic 因接口必填仍默认 2048） */
     maxTokens?: 数字;
+    /**
+     * 思考级别，只对 openai 协议生效（请求字段 reasoning_effort）。
+     * 不传则不发，用服务商默认。
+     */
+    reasoningEffort?: "none" | "low" | "medium" | "high" | "xhigh";
     /** 是否支持图片输入，默认 true */
     supportsVision: 布尔值;
     /** 是否为默认供应商 */

package/types/zh/PaddleOCR/346/250/241/345/235/227.d.ts

@@ -38,17 +38,6 @@ declare namespace $PaddleOCR {
     orientation: 数字;
   }
 
-  /**
-   * 手动切换到 PP-OCRv5 模型。PaddleOCR 默认自动加载 PP-OCRv6 small；同一时间只保留一个 active 模型，加载成功后会替换已加载的 PP-OCRv6 模型。
-   * @param 最大边长 最大边长，默认768，可不传
-   * @param useGpu 是否使用GPU，默认false，可不传
-   * @returns 加载成功或模型已加载返回true
-   * @deprecated 请改用 加载模型("ppocr-v5", useGpu)；检测长边请使用 设置最大边长 单独设置。
-   * @example
-   * const 识别结果数组 = $PaddleOCR.识别绝对坐标("screen", 0, 0, 0, 0)
-   * $打印信息日志(`识别数量: ${识别结果数组.length}`)
-   */
-  function 加载V5模型(最大边长?: 数字, useGpu?: 布尔值): 布尔值;
   /**
    * 按模型 ID 手动加载内置 PaddleOCR 模型。识别和查找方法默认自动加载 ppocr-v6-small；同一时间只保留一个 active 模型，加载成功后会替换已加载模型；检测长边请使用 设置最大边长 单独设置。
    * @param 模型ID 模型 ID，必须传入，支持 "ppocr-v6-tiny"、"ppocr-v6-small"、"ppocr-v5"
@@ -71,30 +60,6 @@ declare namespace $PaddleOCR {
    * const 识别结果数组 = $PaddleOCR.识别绝对坐标("screen", 0, 0, 0, 0)
    */
   function 设置最大边长(最大边长?: 数字): 布尔值;
-  /**
-   * 执行OCR识别
-   * @param 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param 图片边界框左上角x坐标 裁剪区域左上角 x，全屏传 0，默认 0
-   * @param 图片边界框左上角y坐标 裁剪区域左上角 y，全屏传 0，默认 0
-   * @param 图片边界框右下角x坐标 裁剪区域右下角 x，全屏传 0，默认 0
-   * @param 图片边界框右下角y坐标 裁剪区域右下角 y，全屏传 0，默认 0
-   * @param 置信度阈值 置信度阈值，默认 0.6
-   * @returns 识别结果数组，坐标相对于裁剪区域
-   * @deprecated 请改用 识别绝对坐标，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const 识别结果数组 = $PaddleOCR.识别("screen", 100, 100, 500, 300)
-   * if (识别结果数组.length > 0) {
-   *   $打印信息日志(`区域坐标: ${识别结果数组[0].centerX}, ${识别结果数组[0].centerY}`)
-   * }
-   */
-  function 识别(
-    输入源: 字符串,
-    图片边界框左上角x坐标?: 数字,
-    图片边界框左上角y坐标?: 数字,
-    图片边界框右下角x坐标?: 数字,
-    图片边界框右下角y坐标?: 数字,
-    置信度阈值?: 数字,
-  ): 数组<OCR识别结果>;
   /**
    * 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标
    * @param 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
@@ -118,34 +83,6 @@ declare namespace $PaddleOCR {
     图片边界框右下角y坐标?: 数字,
     置信度阈值?: 数字,
   ): 数组<OCR识别结果>;
-  /**
-   * 查找目标文本并返回对应子串坐标
-   * @param 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param 目标文本数组 例如 ["你好", "确定"]
-   * @param 图片边界框左上角x坐标 裁剪区域左上角 x，全屏传 0，默认 0
-   * @param 图片边界框左上角y坐标 裁剪区域左上角 y，全屏传 0，默认 0
-   * @param 图片边界框右下角x坐标 裁剪区域右下角 x，全屏传 0，默认 0
-   * @param 图片边界框右下角y坐标 裁剪区域右下角 y，全屏传 0，默认 0
-   * @param 置信度阈值 置信度阈值，默认 0.6
-   * @param 是否完整匹配 默认 false 表示包含匹配；传 true 时要求整条 OCR 识别结果文本等于目标文本
-   * @returns 匹配到的子串结果数组，坐标相对于裁剪区域
-   * @deprecated 请改用 查找文本绝对坐标，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const 结果 = $PaddleOCR.查找文本("screen", ["确定"], 100, 100, 500, 300, 0.6)
-   * if (结果.length > 0) {
-   *   $打印信息日志(`命中: ${结果[0].text}`)
-   * }
-   */
-  function 查找文本(
-    输入源: 字符串,
-    目标文本数组: 数组<字符串>,
-    图片边界框左上角x坐标?: 数字,
-    图片边界框左上角y坐标?: 数字,
-    图片边界框右下角x坐标?: 数字,
-    图片边界框右下角y坐标?: 数字,
-    置信度阈值?: 数字,
-    是否完整匹配?: 布尔值,
-  ): 数组<OCR识别结果>;
   /**
    * 查找目标文本并返回对应子串的原图/全屏绝对坐标
    * @param 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）

package/types/zh/YOLO/346/250/241/345/235/227.d.ts

@@ -69,44 +69,6 @@ declare namespace $YOLO {
     useGpu?: 布尔值,
   ): 字符串 | null;
 
-  /**
-   * 加载YOLOv11模型 （兼容 yolov8 模型）
-   * @param ncnn模型的param文件路径
-   * @param ncnn模型的bin文件路径
-   * @param 标签数量 模型的标签数量；传 0 或省略时根据模型输出自动推断，显式传入但不匹配时检测返回空数组
-   * @param useGpu 是否使用 GPU 加载
-   * @returns 加载成功返回模型ID字符串，失败返回null
-   * @deprecated 请改用 加载模型(paramPath, binPath, 标签数量, 11, useGpu)。
-   * @example
-   * const 模型ID = $YOLO.加载模型("yolov11n.param", "yolov11n.bin", 0, 11, false)
-   */
-  function 加载YOLOv11模型(
-    ncnn模型的param文件路径: 字符串,
-    ncnn模型的bin文件路径: 字符串,
-    标签数量?: 数字,
-    useGpu?: 布尔值,
-  ): 字符串 | null;
-
-  /**
-   * 目标检测
-   * @param 模型ID
-   * @param 图片ID 图像ID，"screen"用当前屏幕检测，可以填入图像ID或者http图片地址或文件地址
-   * @param 目标检测输入大小 图像进入后缩放的检测大小，模型训练一般都用640，因此这里的640一般不要改
-   * @param 置信度 置信度，默认0.4，小于这个值的会被过滤掉
-   * @param 重叠阈值 一般是0.5不需要更改
-   * @returns 检测结果数组
-   * @deprecated 请改用 目标检测绝对坐标，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const 结果数组 = $YOLO.目标检测绝对坐标(模型ID, "screen", 0, 0, 0, 0, 640, 0.4, 0.5)
-   */
-  function 目标检测(
-    模型ID: 字符串,
-    图片ID: 字符串,
-    目标检测输入大小?: 数字,
-    置信度?: 数字,
-    重叠阈值?: 数字,
-  ): 数组<Yolo检测结果>;
-
   /**
    * 对指定区域执行目标检测，并将结果坐标映射为原图/全屏绝对坐标
    * @param 模型ID

package/types/zh//345/233/276/347/211/207/346/250/241/345/235/227.d.ts

@@ -22,37 +22,6 @@ declare namespace $图片 {
     区域右下角X坐标?: 数字,
     区域右下角Y坐标?: 数字,
   ): 字符串 | null;
-  /**
-   * 截图
-   * @returns 截图的imageId ，如果截图失败则返回null
-   * @deprecated 请改用 截取屏幕()。
-   * @example
-   * const 图片ID = $图片.截取屏幕()
-   * if (图片ID) {
-   *   $图片.保存图片(图片ID, "screen.jpg")
-   * }
-   */
-  function 截取全屏(): 字符串 | null;
-  /**
-   * 截图指定区域
-   * @param 区域左上角X坐标
-   * @param 区域左上角Y坐标
-   * @param 区域右下角X坐标
-   * @param 区域右下角Y坐标
-   * @returns 截图的imageId ，如果截图失败则返回null
-   * @deprecated 请改用 截取屏幕(区域左上角X坐标, 区域左上角Y坐标, 区域右下角X坐标, 区域右下角Y坐标)。
-   * @example
-   * const 图片ID = $图片.截取屏幕(0, 0, 100, 100)
-   * if (图片ID) {
-   *   $图片.保存图片(图片ID, "screen.jpg")
-   * }
-   */
-  function 截取区域(
-    区域左上角X坐标: 数字,
-    区域左上角Y坐标: 数字,
-    区域右下角X坐标: 数字,
-    区域右下角Y坐标: 数字,
-  ): 字符串 | null;
   /**
    * 保存图片
    * @param imageId 图片id 路径 http地址或者 screen 实时截屏

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

@@ -30,29 +30,6 @@ declare namespace $苹果OCR {
     centerY: 数字;
   }
 
-  /**
-   * 执行OCR识别（使用Apple Vision框架）
-   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param 图片边界框左上角x坐标 默认 0
-   * @param 图片边界框左上角y坐标 默认 0
-   * @param 图片边界框右下角x坐标 默认 0
-   * @param 图片边界框右下角y坐标 默认 0
-   * @param 识别语言数组 识别语言数组，默认为["zh-Hans", "en-US"]
-   * @returns 识别结果数组，包含文本、置信度、坐标等信息
-   * @deprecated 请改用 识别绝对坐标，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const 检查结果数组 = $苹果OCR.识别绝对坐标("screen", 0, 0, 100, 100, ["zh-Hans", "en-US"])
-   * $打印信息日志(`识别数量: ${检查结果数组.length}`)
-   */
-  function 识别(
-    输入源: 字符串,
-    图片边界框左上角x坐标?: 数字,
-    图片边界框左上角y坐标?: 数字,
-    图片边界框右下角x坐标?: 数字,
-    图片边界框右下角y坐标?: 数字,
-    识别语言数组?: Array<字符串>
-  ): 数组<OCR识别结果>;
-
   /**
    * 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
    * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
@@ -77,27 +54,6 @@ declare namespace $苹果OCR {
     识别语言数组?: Array<字符串>
   ): 数组<OCR识别结果>;
 
-  /**
-   * 执行OCR识别（仅识别数字）0-9.,+-
-   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param 图片边界框左上角x坐标 默认 0
-   * @param 图片边界框左上角y坐标 默认 0
-   * @param 图片边界框右下角x坐标 默认 0
-   * @param 图片边界框右下角y坐标 默认 0
-   * @returns 识别结果数组，包含文本、置信度、坐标等信息
-   * @deprecated 请改用 识别数字绝对坐标，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const 检查结果数组 = $苹果OCR.识别数字绝对坐标("screen", 0, 0, 100, 100)
-   * $打印信息日志(`数字识别数量: ${检查结果数组.length}`)
-   */
-  function 识别数字(
-    输入源: 字符串,
-    图片边界框左上角x坐标?: 数字,
-    图片边界框左上角y坐标?: 数字,
-    图片边界框右下角x坐标?: 数字,
-    图片边界框右下角y坐标?: 数字
-  ): 数组<OCR识别结果>;
-
   /**
    * 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
    * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
@@ -120,33 +76,6 @@ declare namespace $苹果OCR {
     图片边界框右下角y坐标?: 数字
   ): 数组<OCR识别结果>;
 
-  /**
-   * 执行OCR识别，在整段识别文本中查找指定子串
-   * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
-   * @param 要查找的文本数组 要查找的目标文本数组，可匹配识别结果中的子串
-   * @param 图片边界框左上角x坐标 默认 0
-   * @param 图片边界框左上角y坐标 默认 0
-   * @param 图片边界框右下角x坐标 默认 0
-   * @param 图片边界框右下角y坐标 默认 0
-   * @param 识别语言数组 识别语言数组，默认为["zh-Hans", "en-US"]
-   * @param 是否完整匹配 默认 false 表示包含匹配；传 true 时要求整条 OCR 识别结果文本等于目标文本
-   * @returns 命中子串的识别结果数组，坐标对应目标子串区域
-   * @deprecated 请改用 查找文本绝对坐标，避免裁剪区域坐标和全屏坐标混用。
-   * @example
-   * const 检查结果数组 = $苹果OCR.查找文本绝对坐标("screen", ["开始"], 0, 0, 100, 100, ["zh-Hans", "en-US"])
-   * $打印信息日志(`命中数量: ${检查结果数组.length}`)
-   */
-  function 查找文本(
-    输入源: 字符串,
-    要查找的文本数组: 数组<字符串>,
-    图片边界框左上角x坐标?: 数字,
-    图片边界框左上角y坐标?: 数字,
-    图片边界框右下角x坐标?: 数字,
-    图片边界框右下角y坐标?: 数字,
-    识别语言数组?: 数组<字符串>,
-    是否完整匹配?: 布尔值
-  ): 数组<OCR识别结果>;
-
   /**
    * 查找指定子串，并将子串结果坐标映射为原图/全屏绝对坐标。
    * @param 输入源 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）

package/types/zh//350/256/276/345/244/207/346/250/241/345/235/227.d.ts

@@ -73,21 +73,6 @@ declare namespace $设备 {
    * @example $设备.获取设备型号()
    */
   function 获取设备型号(): 字符串;
-  /**
-   * 获取屏幕宽高
-   * @returns 获取屏幕宽高缩放后的，实际宽高，请使用`获取屏幕实际宽高()`获取未缩放的宽高
-   * @example $设备.获取屏幕宽高()
-   */
-  function 获取屏幕宽高(): {
-    /**
-     * 屏幕宽度
-     */
-    width: 数字;
-    /**
-     * 屏幕高度
-     */
-    height: 数字;
-  };
   /**
    * 获取屏幕实际大小
    * @returns 屏幕实际大小