ms-vite-plugin 1.4.38 → 1.4.40

package/docs/api/pip.md

@@ -7,7 +7,7 @@
 - **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认保活
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
-- **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
+- **尺寸设置**：日志模式和自定义模式支持设置内容宽高比（实际显示尺寸由系统决定），并按模式分别持久化
 - **日志显示**：日志模式支持设置日志文字大小
 - **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
@@ -129,14 +129,14 @@ const success = pip.closeWindow();
 function setContentSize(width: number, height: number): boolean;
 ```
 
-设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+设置日志模式或自定义模式的悬浮窗内容尺寸。传入的宽高表示宽高比，不是最终像素尺寸；悬浮窗实际显示的宽高由系统决定。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
 
 **参数：**
 
 | 参数     | 类型             | 必填 | 描述                                           |
 | -------- | ---------------- | ---- | ---------------------------------------------- |
-| `width`  | `number` | 是   | 目标内容宽度 |
-| `height` | `number` | 是   | 目标内容高度 |
+| `width`  | `number` | 是   | 宽度方向比例值（与 `height` 共同决定宽高比，不是像素） |
+| `height` | `number` | 是   | 高度方向比例值（与 `width` 共同决定宽高比，不是像素） |
 
 **返回值：**
 

package/docs/apicn/dotocr.md

@@ -0,0 +1,161 @@
+# 点阵 OCR 模块（$点阵OCR）
+
+`$点阵OCR` 使用图色工具生成的固定像素点阵字库识别文字。字库保存在项目的 `res/fonts` 目录，使用方式与 YOLO 模型一致：先加载资源取得字库 ID，再复用该 ID 进行识别，使用完毕后释放。
+
+点阵模板按照制作时的原始像素尺寸匹配，不会自动缩放到其他分辨率。目标文字的字号、缩放比例或像素形状发生变化时，应制作对应的字库特征。
+
+## 功能概览
+
+- **字库管理**：加载、缓存和释放项目字库
+- **文字识别**：返回按阅读顺序排列的识别结果数组
+- **文本查找**：先识别再按行定位目标串，返回命中位置的绝对坐标
+- **多源输入**：支持 `"screen"`、图片文件路径、URL 或 imageId
+- **绝对坐标**：裁剪区域内的结果会映射回原图或全屏坐标
+
+## 数据类型
+
+### OCR字符
+
+```typescript
+interface OCR字符 {
+  text: 字符串;
+  confidence: 数字;
+  x: 数字;
+  y: 数字;
+  ex: 数字;
+  ey: 数字;
+  width: 数字;
+  height: 数字;
+  centerX: 数字;
+  centerY: 数字;
+}
+```
+
+| 字段名               | 类型   | 描述                                   |
+| -------------------- | ------ | -------------------------------------- |
+| `OCR字符.text`       | 字符串 | 识别文本；查找结果中为命中的目标字符串 |
+| `confidence`         | 数字   | 置信度，范围为 0-1                     |
+| `x`, `y`             | 数字   | 结果区域左上角绝对坐标                 |
+| `ex`, `ey`           | 数字   | 结果区域右下角绝对坐标                 |
+| `width`, `height`    | 数字   | 结果区域宽度和高度                     |
+| `centerX`, `centerY` | 数字   | 结果区域中心点绝对坐标                 |
+
+## API 参考
+
+### 字库管理
+
+#### 加载字库 - 加载并缓存字库
+
+```typescript
+function 加载字库(字库资源路径: 字符串): 字符串 | null;
+```
+
+| 参数名         | 类型   | 是否必填 | 默认值 | 描述                                                                        |
+| -------------- | ------ | -------- | ------ | --------------------------------------------------------------------------- |
+| `字库资源路径` | 字符串 | 是       |        | 资源路径，运行时会自动处理 `res` 目录解析；常见写法如 `/fonts/default.json` |
+
+**返回值：**加载成功返回字库 ID，失败返回 `null`。加载后的字库 ID 会复用到后续识别与释放流程。
+
+```javascript
+const 字库ID = $点阵OCR.加载字库("/fonts/default.json");
+if (!字库ID) throw new Error("字库加载失败");
+```
+
+建议在脚本初始化时加载一次并保存字库 ID，后续识别时复用，不要每次识别都重新加载。
+
+### 文字识别
+
+#### 识别绝对坐标 - 识别文字并返回绝对坐标
+
+```typescript
+function 识别绝对坐标(
+  字库ID: 字符串,
+  输入源: 字符串,
+  左?: 数字,
+  上?: 数字,
+  右?: 数字,
+  下?: 数字,
+  置信度阈值?: 数字,
+): 数组<OCR字符>;
+```
+
+| 参数名       | 类型   | 是否必填 | 默认值 | 描述                                                                                         |
+| ------------ | ------ | -------- | ------ | -------------------------------------------------------------------------------------------- |
+| `字库ID`     | 字符串 | 是       |        | `加载字库` 返回的字库 ID                                                                     |
+| `输入源`     | 字符串 | 是       |        | 输入源，支持 `"screen"`、图片文件路径、URL 或 imageId                                        |
+| `左`, `上`   | 数字   | 否       | 0      | 裁剪区域左上角坐标                                                                           |
+| `右`, `下`   | 数字   | 否       | 0      | 裁剪区域右下角坐标；`右` 或 `下` 为 0 时分别使用图像宽度或高度                               |
+| `置信度阈值` | 数字   | 否       | 0.8    | 相似度下限；`<=0` 时按 `0.8`；低于阈值的字符会被过滤；`>0.95` 时要求模板与图像像素完全一致 |
+
+**返回值：**`数组<OCR字符>`。按行从上到下、同一行从左到右排列。颜色按字库各字自带的前景色/偏色匹配，无需额外传色。
+
+```javascript
+const 结果 = $点阵OCR.识别绝对坐标(字库ID, "screen", 100, 200, 600, 280, 0.8);
+$打印信息日志(结果[0]?.text);
+$打印信息日志(`坐标: ${结果[0]?.x}, ${结果[0]?.y}`);
+```
+
+### 文本查找
+
+#### 查找文本绝对坐标 - 查找指定字符串并返回绝对坐标
+
+```typescript
+function 查找文本绝对坐标(
+  字库ID: 字符串,
+  输入源: 字符串,
+  目标文本: 数组<字符串>,
+  左?: 数字,
+  上?: 数字,
+  右?: 数字,
+  下?: 数字,
+  置信度阈值?: 数字,
+  完整匹配?: 布尔值,
+): 数组<OCR字符>;
+```
+
+| 参数名       | 类型          | 是否必填 | 默认值 | 描述                                                                  |
+| ------------ | ------------- | -------- | ------ | --------------------------------------------------------------------- |
+| `字库ID`     | 字符串        | 是       |        | `加载字库` 返回的字库 ID                                              |
+| `输入源`     | 字符串        | 是       |        | 输入源，支持 `"screen"`、图片文件路径、URL 或 imageId                 |
+| `目标文本`   | 数组<字符串>  | 是       |        | 要查找的字符串数组，例如 `["商店", "背包"]`                           |
+| `左`, `上`   | 数字          | 否       | 0      | 裁剪区域左上角坐标                                                    |
+| `右`, `下`   | 数字          | 否       | 0      | 裁剪区域右下角坐标；`右` 或 `下` 为 0 时分别使用图像宽度或高度        |
+| `置信度阈值` | 数字          | 否       | 0.8    | 单字符识别相似度下限；语义同 `识别绝对坐标`                           |
+| `完整匹配`   | 布尔值        | 否       | false  | `false` 为行内子串包含匹配；`true` 要求某一整行文本完全等于目标字符串 |
+
+**返回值：**命中结果数组。每个目标最多返回一次命中（最先匹配到的行）；每项的 `text` 是目标字符串。
+
+```javascript
+const 命中 = $点阵OCR.查找文本绝对坐标(
+  字库ID,
+  "screen",
+  ["商店", "背包"],
+  100,
+  200,
+  600,
+  280,
+  0.8,
+  false,
+);
+if (命中.length > 0) $动作.点击(命中[0].centerX, 命中[0].centerY);
+```
+
+### 资源管理
+
+#### 释放 - 释放指定字库
+
+```typescript
+function 释放(字库ID: 字符串): void;
+```
+
+#### 释放全部 - 释放全部点阵字库
+
+```typescript
+function 释放全部(): void;
+```
+
+```javascript
+$点阵OCR.释放(字库ID);
+// 或在需要清理全部已加载的点阵字库时：
+$点阵OCR.释放全部();
+```

package/docs/apicn/file.md

@@ -47,50 +47,6 @@ $打印信息日志(`文档目录: ${文档目录}`);
 $打印信息日志(`临时目录: ${临时目录}`);
 ```
 
-#### 获取数据目录
-
-```typescript
-function 获取数据目录(): 字符串;
-```
-
-**返回值:**
-
-| 类型     | 描述             |
-| -------- | ---------------- |
-| `字符串` | 应用数据目录路径 |
-
-**示例:**
-
-```javascript
-const 数据目录 = $文件.获取数据目录();
-$打印信息日志(`数据目录: ${数据目录}`);
-```
-
-#### 获取数据文件路径
-
-```typescript
-function 获取数据文件路径(文件名称: 字符串): 字符串;
-```
-
-**参数:**
-
-| 参数名     | 类型   | 是否必填 | 默认值 | 描述         |
-| ---------- | ------ | -------- | ------ | ------------ |
-| `文件名称` | 字符串 | 是       | -      | 文件名或路径 |
-
-**返回值:**
-
-| 类型     | 描述         |
-| -------- | ------------ |
-| `字符串` | 文件完整路径 |
-
-**示例:**
-
-```javascript
-const 配置文件路径 = $文件.获取数据文件路径("config.json");
-$打印信息日志(`配置文件路径: ${配置文件路径}`);
-```
-
 #### 创建目录 - 创建目录（支持递归创建）。
 
 ```typescript
@@ -331,6 +287,54 @@ if (配置文件内容) {
 }
 ```
 
+#### 获取资源文件 - 获取 `res` 资源的本地文件路径。
+
+适用于需要真实文件路径的场景（如模型文件、音视频）。用完后应调用 `清理资源文件`。
+
+```typescript
+function 获取资源文件(文件名: 字符串): 字符串 | null;
+```
+
+**参数:**
+
+| 参数名   | 类型   | 是否必填 | 默认值 | 描述                  |
+| -------- | ------ | -------- | ------ | --------------------- |
+| `文件名` | 字符串 | 是       | -      | 相对 `res` 目录的路径 |
+
+**返回值:**
+
+| 类型           | 描述                                       |
+| -------------- | ------------------------------------------ |
+| `字符串\|null` | 本地文件绝对路径；失败或不存在时返回 null |
+
+**示例:**
+
+```javascript
+const 路径 = $文件.获取资源文件("model.bin");
+if (路径) {
+  // 使用 路径 ...
+  $文件.清理资源文件(路径);
+}
+```
+
+#### 清理资源文件 - 清理由 `获取资源文件` 得到的本地文件。
+
+```typescript
+function 清理资源文件(文件路径: 字符串): void;
+```
+
+**参数:**
+
+| 参数名     | 类型   | 是否必填 | 默认值 | 描述                         |
+| ---------- | ------ | -------- | ------ | ---------------------------- |
+| `文件路径` | 字符串 | 是       | -      | `获取资源文件` 返回的文件路径 |
+
+**示例:**
+
+```javascript
+$文件.清理资源文件(路径);
+```
+
 #### 写入文件 - 写入文件内容（覆盖原有内容）。
 
 ```typescript

package/docs/apicn/pip.md

@@ -7,7 +7,7 @@
 - **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认保活
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
-- **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
+- **尺寸设置**：日志模式和自定义模式支持设置内容宽高比（实际显示尺寸由系统决定），并按模式分别持久化
 - **日志显示**：日志模式支持设置日志文字大小
 - **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
@@ -129,14 +129,14 @@ const 是否成功 = $悬浮窗.关闭悬浮窗();
 function 设置内容尺寸(宽度: 数字, 高度: 数字): 布尔值;
 ```
 
-设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+设置日志模式或自定义模式的悬浮窗内容尺寸。传入的宽高表示宽高比，不是最终像素尺寸；悬浮窗实际显示的宽高由系统决定。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
 
 **参数：**
 
 | 参数   | 类型          | 必填 | 描述                                           |
 | ------ | ------------- | ---- | ---------------------------------------------- |
-| `宽度` | `数字` | 是   | 目标内容宽度 |
-| `高度` | `数字` | 是   | 目标内容高度 |
+| `宽度` | `数字` | 是   | 宽度方向比例值（与高度共同决定宽高比，不是像素） |
+| `高度` | `数字` | 是   | 高度方向比例值（与宽度共同决定宽高比，不是像素） |
 
 **返回值：**
 

package/docs/apipython/dotocr.md

@@ -0,0 +1,148 @@
+# 点阵 OCR 模块（dotocr）
+
+`dotocr` 使用图色工具生成的固定像素点阵字库识别文字。字库保存在项目的 `res/fonts` 目录，使用方式与 YOLO 模型一致：先加载资源取得字库 ID，再复用该 ID 进行识别，使用完毕后释放。
+
+点阵模板按照制作时的原始像素尺寸匹配，不会自动缩放到其他分辨率。目标文字的字号、缩放比例或像素形状发生变化时，应制作对应的字库特征。
+
+## 数据类型
+
+### OCRChar
+
+```python
+from kuaijs._types import KuaiJSNamespace
+
+class OCRChar(KuaiJSNamespace):
+    text: str
+    confidence: float
+    x: int
+    y: int
+    ex: int
+    ey: int
+    width: int
+    height: int
+    centerX: int
+    centerY: int
+```
+
+| 字段名               | 类型  | 描述                                   |
+| -------------------- | ----- | -------------------------------------- |
+| `OCRChar.text`       | str   | 识别文本；查找结果中为命中的目标字符串 |
+| `confidence`         | float | 置信度，范围为 0-1                     |
+| `x`, `y`             | int   | 结果区域左上角绝对坐标                 |
+| `ex`, `ey`           | int   | 结果区域右下角绝对坐标                 |
+| `width`, `height`    | int   | 结果区域宽度和高度                     |
+| `centerX`, `centerY` | int   | 结果区域中心点绝对坐标                 |
+
+## API 参考
+
+### 字库管理
+
+#### `loadFont` - 加载并缓存字库
+
+```python
+def loadFont(fontPath: str) -> Optional[str]
+```
+
+| 参数名     | 类型 | 是否必填 | 默认值 | 描述                                                                        |
+| ---------- | ---- | -------- | ------ | --------------------------------------------------------------------------- |
+| `fontPath` | str  | 是       |        | 资源路径，运行时会自动处理 `res` 目录解析；常见写法如 `/fonts/default.json` |
+
+**返回值：**加载成功返回 `fontId`，失败返回 `None`。加载后的字库 ID 会复用到后续识别与释放流程。
+
+```python
+from kuaijs import dotocr
+
+font_id = dotocr.loadFont("/fonts/default.json")
+if not font_id:
+    raise RuntimeError("字库加载失败")
+```
+
+建议在脚本初始化时加载一次并保存 `font_id`，后续识别时复用，不要每次识别都重新加载。
+
+### 文字识别
+
+#### `recognizeAbs` - 识别文字并返回绝对坐标
+
+```python
+def recognizeAbs(
+    fontId: str,
+    input: str,
+    x: int = 0,
+    y: int = 0,
+    ex: int = 0,
+    ey: int = 0,
+    confidenceThreshold: float = 0.8,
+) -> List[OCRChar]
+```
+
+| 参数名                | 类型  | 是否必填 | 默认值 | 描述                                                                                         |
+| --------------------- | ----- | -------- | ------ | -------------------------------------------------------------------------------------------- |
+| `fontId`              | str   | 是       |        | `loadFont` 返回的字库 ID                                                                     |
+| `input`               | str   | 是       |        | 输入源，支持 `"screen"`、图片文件路径、URL 或 imageId                                        |
+| `x`, `y`              | int   | 否       | 0      | 裁剪区域左上角坐标                                                                           |
+| `ex`, `ey`            | int   | 否       | 0      | 裁剪区域右下角坐标；`ex` 或 `ey` 为 0 时分别使用图像宽度或高度                               |
+| `confidenceThreshold` | float | 否       | 0.8    | 相似度下限；`<=0` 时按 `0.8`；低于阈值的字符会被过滤；`>0.95` 时要求模板与图像像素完全一致 |
+
+**返回值：**`List[OCRChar]`。按行从上到下、同一行从左到右排列。颜色按字库各字自带的前景色/偏色匹配，无需额外传色。
+
+```python
+chars = dotocr.recognizeAbs(font_id, "screen", 100, 200, 600, 280, 0.8)
+if chars:
+    print(chars[0].text, chars[0].x, chars[0].width)
+```
+
+### 文本查找
+
+#### `findTextAbs` - 查找指定字符串并返回绝对坐标
+
+```python
+def findTextAbs(
+    fontId: str,
+    input: str,
+    targetTexts: List[str],
+    x: int = 0,
+    y: int = 0,
+    ex: int = 0,
+    ey: int = 0,
+    confidenceThreshold: float = 0.8,
+    exactMatch: bool = False,
+) -> List[OCRChar]
+```
+
+| 参数名                | 类型      | 是否必填 | 默认值 | 描述                                                                  |
+| --------------------- | --------- | -------- | ------ | --------------------------------------------------------------------- |
+| `fontId`              | str       | 是       |        | `loadFont` 返回的字库 ID                                              |
+| `input`               | str       | 是       |        | 输入源，支持 `"screen"`、图片文件路径、URL 或 imageId                 |
+| `targetTexts`         | List[str] | 是       |        | 要查找的字符串数组，例如 `["商店", "背包"]`                           |
+| `x`, `y`              | int       | 否       | 0      | 裁剪区域左上角坐标                                                    |
+| `ex`, `ey`            | int       | 否       | 0      | 裁剪区域右下角坐标；`ex` 或 `ey` 为 0 时分别使用图像宽度或高度        |
+| `confidenceThreshold` | float     | 否       | 0.8    | 单字符识别相似度下限；语义同 `recognizeAbs`                           |
+| `exactMatch`          | bool      | 否       | false  | `false` 为行内子串包含匹配；`true` 要求某一整行文本完全等于目标字符串 |
+
+**返回值：**命中结果数组。每个目标最多返回一次命中（最先匹配到的行）；每项的 `text` 是目标字符串。
+
+```python
+hits = dotocr.findTextAbs(font_id, "screen", ["商店", "背包"], 100, 200, 600, 280, 0.8, False)
+if hits:
+    action.click(hits[0].centerX, hits[0].centerY)
+```
+
+### 资源管理
+
+#### `free` - 释放指定字库
+
+```python
+def free(fontId: str) -> None
+```
+
+#### `freeAll` - 释放全部点阵字库
+
+```python
+def freeAll() -> None
+```
+
+```python
+dotocr.free(font_id)
+# 或在需要清理全部已加载的点阵字库时：
+dotocr.freeAll()
+```

package/docs/apipython/file.md

@@ -48,52 +48,6 @@ print(documents_dir)
 print(temp_dir)
 ```
 
-#### getDataDir - 获取应用数据目录路径
-
-```python
-def getDataDir() -> str
-```
-
-**返回值:**
-
-| 类型  | 描述             |
-| ----- | ---------------- |
-| `str` | 应用数据目录路径 |
-
-**示例:**
-
-```python
-from kuaijs import file
-data_dir = file.getDataDir()
-print(data_dir)
-```
-
-#### getDataFile - 获取应用数据文件的完整路径
-
-```python
-def getDataFile(file: str) -> str
-```
-
-**参数:**
-
-| 参数名 | 类型 | 是否必填 | 描述         |
-| ------ | ---- | -------- | ------------ |
-| `file` | str  | 是       | 文件名或路径 |
-
-**返回值:**
-
-| 类型  | 描述         |
-| ----- | ------------ |
-| `str` | 文件完整路径 |
-
-**示例:**
-
-```python
-from kuaijs import file
-config_path = file.getDataFile("config.json")
-print(config_path)
-```
-
 #### mkdirs - 创建目录（支持递归创建）
 
 ```python
@@ -281,7 +235,7 @@ def readFile(path: str) -> Optional[str]
 
 ```python
 from kuaijs import file
-p = file.getDataFile("read.txt")
+p = file.getInternalDir("documents") + "/read.txt"
 file.writeFile(p, "line1\nline2")
 print(file.readFile(p))
 ```
@@ -315,6 +269,55 @@ if config:
     print(config)
 ```
 
+#### getResFile - 获取 res 资源的本地文件路径
+
+适用于需要真实文件路径的场景（如模型文件、音视频）。用完后应调用 `cleanupResFile`。
+
+```python
+def getResFile(fileName: str) -> Optional[str]
+```
+
+**参数:**
+
+| 参数名     | 类型 | 是否必填 | 描述                  |
+| ---------- | ---- | -------- | --------------------- |
+| `fileName` | str  | 是       | 相对 `res` 目录的路径 |
+
+**返回值:**
+
+| 类型          | 描述                                     |
+| ------------- | ---------------------------------------- |
+| `str \| None` | 本地文件绝对路径；失败或不存在时返回 None |
+
+**示例:**
+
+```python
+from kuaijs import file
+path = file.getResFile("model.bin")
+if path:
+    # 使用 path ...
+    file.cleanupResFile(path)
+```
+
+#### cleanupResFile - 清理由 getResFile 得到的本地文件
+
+```python
+def cleanupResFile(path: str) -> None
+```
+
+**参数:**
+
+| 参数名 | 类型 | 是否必填 | 描述                       |
+| ------ | ---- | -------- | -------------------------- |
+| `path` | str  | 是       | `getResFile` 返回的文件路径 |
+
+**示例:**
+
+```python
+from kuaijs import file
+file.cleanupResFile(path)
+```
+
 #### writeFile - 写入文件内容（覆盖）
 
 ```python

package/docs/apipython/pip.md

@@ -7,7 +7,7 @@
 - **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认保活
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
-- **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
+- **尺寸设置**：日志模式和自定义模式支持设置内容宽高比（实际显示尺寸由系统决定），并按模式分别持久化
 - **日志显示**：日志模式支持设置日志文字大小
 - **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
@@ -133,7 +133,7 @@ success = pip.closeWindow()
 
 ### setContentSize - 设置内容尺寸
 
-设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+设置日志模式或自定义模式的悬浮窗内容尺寸。传入的宽高表示宽高比，不是最终像素尺寸；悬浮窗实际显示的宽高由系统决定。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
 
 ```python
 def setContentSize(width: float, height: float) -> bool
@@ -143,8 +143,8 @@ def setContentSize(width: float, height: float) -> bool
 
 | 参数     | 类型             | 必填 | 描述                          |
 | -------- | ---------------- | ---- | ----------------------------- |
-| `width`  | `float` | 是   | 目标内容宽度 |
-| `height` | `float` | 是   | 目标内容高度 |
+| `width`  | `float` | 是   | 宽度方向比例值（与 `height` 共同决定宽高比，不是像素） |
+| `height` | `float` | 是   | 高度方向比例值（与 `width` 共同决定宽高比，不是像素） |
 
 **返回值：**