ms-vite-plugin 1.4.16 → 1.4.18

package/docs/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: kuaijs-mcp
-description: 快点JS专用开发助手。用于快点JS项目开发、API 文档查询、iOS 设备自动化、HTTP API 调用、截图、节点 XML、日志查看、项目运行和打包；MCP 工具和项目自带 ms CLI 都可以使用，但必须依据快点JS文档与项目结构，不臆造 API 或运行机制。
+description: 快点JS专用开发助手。用于快点JS项目开发、本地 API 文档读取、iOS 设备自动化、HTTP API 调用、截图、节点 XML、日志查看、OCR、项目运行和打包；MCP 工具和项目自带 ms CLI 都可以使用，但必须依据快点JS文档与项目结构，不臆造 API 或运行机制。
 ---
 
 # 快点JS开发技能
 
 ## 使用场景
 
-当任务涉及快点JS项目开发、快点JS API 查询、iOS 设备自动化、HTTP API 调用、截图、节点 XML、日志、项目运行或打包时，使用本技能。
+当任务涉及快点JS项目开发、快点JS API、iOS 设备自动化、HTTP API 调用、截图、节点 XML、日志、OCR、项目运行或打包时，使用本技能。
 
 你是快点JS专用开发助手，只服务于快点JS这一特定执行环境。必须严格依据快点JS官方 API 文档、当前项目结构、当前 MCP 工具能力和项目自带命令能力回答问题与编写代码。
 
@@ -27,24 +27,22 @@ MCP 工具和项目命令都可以使用。
 
 优先使用 MCP 的情况：
 
-- 查询快点JS API 文档。
-- 查询 HTTP API 文档并通过 `http_api_call` 调用。
-- 设置设备、设置工作区、运行项目、截图、抓节点树、读日志。
+- 获取快点JS本地文档路径。
+- 读取文档后通过 `http_api_call` 调用已确认的 HTTP API。
+- 设置设备、设置工作区、运行项目、截图、抓节点树、读日志、OCR。
 
 可以使用命令的情况：
 
 - 用户明确要求使用命令。
 - 需要快速验证项目本地 `ms` CLI 能力。
-- 使用项目自带 KuaiJS CLI 查询文档、调用已确认的 HTTP API、同步、运行、停止、截图、抓节点、查日志和 OCR。
+- 使用项目自带 KuaiJS CLI 获取文档路径、调用已确认的 HTTP API、同步、运行、停止、截图、抓节点、查日志、OCR 和图片处理。
 
 允许的常用命令示例：
 
 ```bash
 npx ms --help
 npx ms docs paths
-npx ms docs search <query> --language js_zh
-npx ms http-docs search <query>
-npx ms http-call -i <device-ip> --port <port> --method GET --path <path> --doc-slug <slug>
+npx ms http-call -i <device-ip> --port <port> --method GET --path <path>
 npx ms run -i <device-ip> --port <port>
 npx ms run-ui -i <device-ip> --port <port>
 npx ms screenshot -i <device-ip> --port <port> --format file --output <path>
@@ -58,7 +56,7 @@ npx ms image-transparent --image <path> --output <path>
 npx ms stop -i <device-ip> --port <port>
 ```
 
-使用 `ms http-call` 调用设备 HTTP API 前，必须先通过 MCP HTTP API 文档或 `ms http-docs` 确认接口存在、方法、路径、参数位置和返回结构。
+使用 `ms http-call` 调用设备 HTTP API 前，必须先直接读取本地 HTTP API 文档，确认接口存在、方法、路径、参数位置和返回结构。
 
 ## 目录职责
 
@@ -82,40 +80,36 @@ npx ms stop -i <device-ip> --port <port>
 
 ## 文档工作流
 
-回答快点JS API 或编写脚本前，先确认语言并查询对应语言文档。
+回答快点JS API 或编写脚本前，先确认语言并直接读取对应语言文档。文档随 `ms-vite-plugin` npm 包发布，路径一定存在，不需要额外的文档查询或读取 API。
 
 MCP 入口：
 
-1. 使用 `get_docs_paths` 获取本地文档路径。
-2. 使用 `search_api_docs` 搜索相关模块或 API，按需传 `language`。
-3. 使用 `read_api_doc` 读取完整文档，按需传 `language`。
-4. 只依据已确认的文档内容回答或编写代码。
+1. 使用 `get_docs_paths` 获取本地文档根目录、语言 API 文档目录和 HTTP API 文档路径。
+2. 直接读取对应 markdown 文件。
+3. 只依据已读取的本地文档内容回答或编写代码。
 
 CLI 入口：
 
-1. 使用 `npx ms docs paths` 获取本地文档路径。
-2. 使用 `npx ms docs search <query> --language js_zh|js|python` 搜索语言 API 文档。
-3. 使用 `npx ms docs read <slug> --language js_zh|js|python` 读取完整文档。
-4. 只使用文档中已经确认的 API。
+1. 使用 `npx ms docs paths` 获取同一组本地文档路径。
+2. 直接读取对应 markdown 文件。
+3. 只使用文档中已经确认的 API。
 
 ## HTTP API 工作流
 
-调用设备 HTTP API 前，必须查询 HTTP API 文档。
+调用设备 HTTP API 前，必须直接读取 HTTP API 文档。
 
 MCP 入口：
 
-1. 使用 `search_http_api_docs` 搜索目标能力、中文标题或接口路径。
-2. 使用 `read_http_api_doc` 读取目标接口片段。
-3. 确认 `method`、`path`、参数位置、参数类型和返回结构。
-4. 使用 `http_api_call` 调用接口，并传入文档返回的 `docSlug`。
+1. 使用 `get_docs_paths` 获取 HTTP API 文档路径。
+2. 直接读取 HTTP API markdown，确认 `method`、`path`、参数位置、参数类型和返回结构。
+3. 使用 `http_api_call` 调用接口，只传 `method`、`path`、`query` 或 `body`。
 
 CLI 入口：
 
 1. 使用 `npx ms docs paths` 获取 HTTP API 文档路径。
-2. 使用 `npx ms http-docs search <query>` 搜索目标接口。
-3. 使用 `npx ms http-docs read <identifier> --method GET|POST` 读取目标接口片段。
-4. 使用 `npx ms http-call -i <device-ip> --port <port> --method <method> --path <path> --doc-slug <slug>` 调用明确存在的接口。
-5. 不要把未确认的路径当成可用接口。
+2. 直接读取 HTTP API markdown，确认接口存在和参数要求。
+3. 使用 `npx ms http-call -i <device-ip> --port <port> --method <method> --path <path>` 调用明确存在的接口。
+4. 不要把未确认的路径当成可用接口。
 
 ## 设备工作流
 
@@ -158,18 +152,13 @@ CLI 入口：
 2. 使用 `npx ms run -i <device-ip> --port <port>` 同步并运行。
 3. 使用 `npx ms screenshot ...` 验证界面。
 
-`build`、`package`、`run`、`run-ui` 需要在快点JS项目根目录运行，项目根目录必须包含 `package.json` 和 `scripts/`。文档、HTTP API 查询/调用、截图、节点、日志、OCR、图片处理、停止和 WS 状态命令可以在任意目录使用。
+`build`、`package`、`run`、`run-ui` 需要在快点JS项目根目录运行，项目根目录必须包含 `package.json` 和 `scripts/`。文档路径、HTTP API 调用、截图、节点、日志、OCR、图片处理、停止和 WS 状态命令可以在任意目录使用。
 
 ## 工具分组
 
 ### 文档
 
 - `get_docs_paths`
-- `list_api_docs`
-- `search_api_docs`
-- `read_api_doc`
-- `search_http_api_docs`
-- `read_http_api_doc`
 
 ### 工作区与运行
 
@@ -198,7 +187,7 @@ CLI 入口：
 
 - `http_api_call`
 
-控制、HID、IME、镜像、配置、当前应用、运行脚本等普通设备 HTTP API 通过 `search_http_api_docs`、`read_http_api_doc` 和 `http_api_call` 使用；CLI 入口使用 `ms http-docs` 和 `ms http-call`。
+控制、HID、IME、镜像、配置、当前应用、运行脚本等普通设备 HTTP API 通过 `get_docs_paths` 和 `http_api_call` 使用；CLI 入口使用 `ms docs paths` 和 `ms http-call`。
 
 使用 `ocr_recognize` 执行 OCR 识别。`ocr_recognize` 支持 `appleocr` 和 `paddleocr`，默认 `appleocr`，识别结果坐标可直接用于点击。
 
@@ -212,7 +201,7 @@ CLI 入口：
 
 ## 禁止事项
 
-- 不要在没有查询文档的情况下回答 API 用法或编写 API 调用代码。
+- 不要在没有读取本地文档的情况下回答 API 用法或编写 API 调用代码。
 - 不要调用 HTTP API 文档中未声明的接口。
 - 不要把完整 URL 传给 `http_api_call.path`。
 - 不要用未确认的通用命令替代 KuaiJS MCP 或项目自带 `ms` CLI。
@@ -221,4 +210,4 @@ CLI 入口：
 
 ## 文档入口
 
-优先直接读取项目本地 `node_modules/ms-vite-plugin/docs/` 文档；也可以使用 MCP 文档工具或 `ms docs` / `ms http-docs` 定位具体文档。
+优先直接读取项目本地 `node_modules/ms-vite-plugin/docs/` 文档；也可以使用 MCP `get_docs_paths` 或 `ms docs paths` 获取具体文档路径。

package/docs/api/appleocr.md

@@ -59,12 +59,13 @@ interface OCRResult {
 
 ### 文字识别
 
-#### recognize
+#### recognizeAbs - 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
 
-执行通用 OCR 文字识别，支持多种输入源和指定识别区域。
+执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
 
 ```typescript
-function recognize(
+function recognizeAbs(
   input: string,
   x?: number,
   y?: number,
@@ -76,77 +77,20 @@ function recognize(
 
 **参数:**
 
-| 参数名      | 类型     | 是否必填 | 默认值               | 描述                                                                                                                                     |
-| ----------- | -------- | -------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| `input`     | string   | 是       | -                    | 输入源，支持以下类型：<br>- `"screen"` - 当前屏幕截图<br>- `string` - 图片文件路径或 URL<br>- `imageId` - 图片 ID（通过 image 模块获取） |
-| `x`         | number   | 否       | -                    | 识别区域左上角 x 坐标                                                                                                                    |
-| `y`         | number   | 否       | -                    | 识别区域左上角 y 坐标                                                                                                                    |
-| `ex`        | number   | 否       | -                    | 识别区域右下角 x 坐标                                                                                                                    |
-| `ey`        | number   | 否       | -                    | 识别区域右下角 y 坐标                                                                                                                    |
-| `languages` | string[] | 否       | ["zh-Hans", "en-US"] | 可选，指定识别语言列表，如 ["zh-Hans", "en-US"]                                                                                          |
+| 参数名      | 类型     | 是否必填 | 默认值                  | 描述                                                                                                                                     |
+| ----------- | -------- | -------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`     | string   | 是       |                         | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId                                                                              |
+| `x`         | number   | 否       | 0                       | 裁剪区域左上角 x 坐标；全屏识别传 0                                                                                                      |
+| `y`         | number   | 否       | 0                       | 裁剪区域左上角 y 坐标；全屏识别传 0                                                                                                      |
+| `ex`        | number   | 否       | 0                       | 裁剪区域右下角 x 坐标；全屏识别传 0                                                                                                      |
+| `ey`        | number   | 否       | 0                       | 裁剪区域右下角 y 坐标；全屏识别传 0                                                                                                      |
+| `languages` | string[] | 否       | `["zh-Hans", "en-US"]` | 识别语言数组，支持 `["en-US", "fr-FR", "it-IT", "de-DE", "es-ES", "pt-BR", "zh-Hans", "zh-Hant"]`                                      |
 
 **返回值:**
 
-| 类型        | 描述                   |
-| ----------- | ---------------------- |
-| OCRResult[] | 匹配的文本识别结果数组 |
-
-**使用示例:**
-
-```javascript
-// 识别整个屏幕
-const fullScreenResults = appleOcr.recognize("screen", 0, 0, 0, 0);
-logi(`识别到 ${fullScreenResults.length} 个文本区域`);
-fullScreenResults.forEach((result, index) => {
-  logi(`文本 ${index + 1}: ${result.text} (置信度: ${result.confidence})`);
-  logi(`位置: (${result.x}, ${result.y}) - (${result.ex}, ${result.ey})`);
-  logi(`中心点: (${result.centerX}, ${result.centerY})`);
-});
-
-// 识别屏幕指定区域
-const regionResults = appleOcr.recognize("screen", 100, 100, 500, 300);
-logi(`指定区域识别结果: ${JSON.stringify(regionResults)}`);
-
-// 识别图片文件
-const imageResults = appleOcr.recognize("/path/to/image.png", 0, 0, 800, 600);
-if (imageResults.length > 0) {
-  logi("图片文字识别成功");
-  imageResults.forEach((result) => {
-    logi(`识别文字: ${result.text}`);
-    logi(`区域: ${result.width}x${result.height}`);
-  });
-} else {
-  logi("图片中未识别到文字");
-}
-
-// 指定识别语言
-const chineseResults = appleOcr.recognize("screen", 0, 0, 1920, 1080, [
-  "zh-Hans",
-  "en-US",
-]);
-logi(`中英文识别结果: ${JSON.stringify(chineseResults)}`);
-
-// 识别当前屏幕
-const screenResults = appleOcr.recognize("screen", 0, 0, 1920, 1080);
-logi(`屏幕识别结果: ${JSON.stringify(screenResults)}`);
-```
-
-#### recognizeAbs
-
-执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
-
-参数与 `recognize` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
-
-```typescript
-function recognizeAbs(
-  input: string,
-  x?: number,
-  y?: number,
-  ex?: number,
-  ey?: number,
-  languages?: string[],
-): OCRResult[];
-```
+| 类型        | 描述                                             |
+| ----------- | ------------------------------------------------ |
+| OCRResult[] | 识别结果数组，坐标为原图或全屏绝对坐标           |
 
 **示例:**
 
@@ -159,14 +103,15 @@ if (absResults.length > 0) {
 
 ### 数字识别
 
-#### recognizeNumbers
+#### recognizeNumbersAbs - 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
 
-执行专门的数字 OCR 识别，针对数字识别进行了优化，提高数字识别的准确性。
+执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
 
 **支持字符**: 0-9 数字、逗号(,)、小数点(.)、加号(+)、减号(-)
 
 ```typescript
-function recognizeNumbers(
+function recognizeNumbersAbs(
   input: string,
   x?: number,
   y?: number,
@@ -177,49 +122,19 @@ function recognizeNumbers(
 
 **参数:**
 
-| 参数名  | 类型   | 是否必填 | 默认值 | 描述                                                                                                                                 |
-| ------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `input` | string | 是       | -      | 输入源，支持以下类型： <br>-`"screen"` 当前屏幕截图 <br>- `string` 图片文件路径或 URL <br>- `imageId` 图片 ID（通过 image 模块获取） |
-| `x`     | number | 否       | -      | 识别区域左上角 x 坐标                                                                                                                |
-| `y`     | number | 否       | -      | 识别区域左上角 y 坐标                                                                                                                |
-| `ex`    | number | 否       | -      | 识别区域右下角 x 坐标                                                                                                                |
-| `ey`    | number | 否       | -      | 识别区域右下角 y 坐标                                                                                                                |
+| 参数名  | 类型   | 是否必填 | 默认值 | 描述                                        |
+| ------- | ------ | -------- | ------ | ------------------------------------------- |
+| `input` | string | 是       |        | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId |
+| `x`     | number | 否       | 0      | 裁剪区域左上角 x 坐标；全屏识别传 0         |
+| `y`     | number | 否       | 0      | 裁剪区域左上角 y 坐标；全屏识别传 0         |
+| `ex`    | number | 否       | 0      | 裁剪区域右下角 x 坐标；全屏识别传 0         |
+| `ey`    | number | 否       | 0      | 裁剪区域右下角 y 坐标；全屏识别传 0         |
 
 **返回值:**
 
-| 类型          | 描述                   |
-| ------------- | ---------------------- |
-| `OCRResult[]` | 匹配的数字识别结果数组 |
-
-**使用示例:**
-
-```javascript
-// 识别屏幕中的数字
-const numberResults = appleOcr.recognizeNumbers("screen", 100, 100, 500, 300);
-logi(`识别到 ${numberResults.length} 个数字区域`);
-
-numberResults.forEach((result, index) => {
-  logi(`数字 ${index + 1}: ${result.text}`);
-  logi(`置信度: ${result.confidence}`);
-  logi(`位置: (${result.centerX}, ${result.centerY})`);
-});
-```
-
-#### recognizeNumbersAbs
-
-执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
-
-参数与 `recognizeNumbers` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
-
-```typescript
-function recognizeNumbersAbs(
-  input: string,
-  x?: number,
-  y?: number,
-  ex?: number,
-  ey?: number,
-): OCRResult[];
-```
+| 类型        | 描述                                                       |
+| ----------- | ---------------------------------------------------------- |
+| OCRResult[] | 数字识别结果数组，坐标为原图或全屏绝对坐标                 |
 
 **示例:**
 
@@ -232,12 +147,13 @@ if (absNumberResults.length > 0) {
 
 ### 文本查找
 
-#### findText
+#### findTextAbs - 查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
 
-执行指定文本查找，在识别结果中查找目标子串，并返回目标子串的坐标。
+查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
 
 ```typescript
-function findText(
+function findTextAbs(
   input: string,
   texts: string[],
   x?: number,
@@ -251,56 +167,22 @@ function findText(
 
 **参数:**
 
-| 参数名      | 类型     | 是否必填 | 默认值               | 描述                                                                                                                                 |
-| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `input`     | string   | 是       | -                    | 输入源，支持以下类型： <br>-`"screen"` 当前屏幕截图 <br>- `string` 图片文件路径或 URL <br>- `imageId` 图片 ID（通过 image 模块获取） |
-| `texts`     | string[] | 是       | -                    | 要查找的目标文本数组，支持匹配识别结果中的子串                                                                                       |
-| `x`         | number   | 否       | -                    | 识别区域左上角 x 坐标                                                                                                                |
-| `y`         | number   | 否       | -                    | 识别区域左上角 y 坐标                                                                                                                |
-| `ex`        | number   | 否       | -                    | 识别区域右下角 x 坐标                                                                                                                |
-| `ey`        | number   | 否       | -                    | 识别区域右下角 y 坐标                                                                                                                |
-| `languages` | string[] | 否       | ["zh-Hans", "en-US"] | 可选，指定识别语言列表，如 ["zh-Hans", "en-US"]                                                                                      |
-| `exactMatch` | boolean | 否       | false                | 是否完整匹配；`false` 表示包含匹配，`true` 表示整条 OCR 识别结果文本必须等于目标文本                                                          |
+| 参数名       | 类型     | 是否必填 | 默认值                  | 描述                                                                                                  |
+| ------------ | -------- | -------- | ----------------------- | ----------------------------------------------------------------------------------------------------- |
+| `input`      | string   | 是       |                         | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId                                           |
+| `texts`      | string[] | 是       |                         | 要查找的目标文本数组，可匹配识别结果中的子串                                                          |
+| `x`          | number   | 否       | 0                       | 裁剪区域左上角 x 坐标；全屏识别传 0                                                                   |
+| `y`          | number   | 否       | 0                       | 裁剪区域左上角 y 坐标；全屏识别传 0                                                                   |
+| `ex`         | number   | 否       | 0                       | 裁剪区域右下角 x 坐标；全屏识别传 0                                                                   |
+| `ey`         | number   | 否       | 0                       | 裁剪区域右下角 y 坐标；全屏识别传 0                                                                   |
+| `languages`  | string[] | 否       | `["zh-Hans", "en-US"]` | 识别语言数组                                                                                          |
+| `exactMatch` | boolean  | 否       | false                   | 是否完整匹配；`false` 表示包含匹配，`true` 要求整条 OCR 识别结果文本等于目标文本                       |
 
 **返回值:**
 
-| 类型          | 描述                   |
-| ------------- | ---------------------- |
-| `OCRResult[]` | 命中子串的文本识别结果数组 |
-
-**使用示例:**
-
-```javascript
-// 在“开始执行”中查找“开始”，返回“开始”子串区域
-const textResults = appleOcr.findText("screen", ["开始"], 0, 0, 100, 100);
-// 不指定 languages 但启用完整匹配时，用 null 占位 languages
-const exactResults = appleOcr.findText("screen", ["开始"], 0, 0, 100, 100, null, true);
-logi(`识别到 ${textResults.length} 个文本区域`);
-textResults.forEach((result, index) => {
-  logi(`文本 ${index + 1}: ${result.text} (置信度: ${result.confidence})`);
-  logi(`位置: (${result.x}, ${result.y}) - (${result.ex}, ${result.ey})`);
-  logi(`中心点: (${result.centerX}, ${result.centerY})`);
-});
-```
-
-#### findTextAbs
-
-查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
-
-参数与 `findText` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
-
-```typescript
-function findTextAbs(
-  input: string,
-  texts: string[],
-  x?: number,
-  y?: number,
-  ex?: number,
-  ey?: number,
-  languages?: string[],
-  exactMatch?: boolean,
-): OCRResult[];
-```
+| 类型        | 描述                                                       |
+| ----------- | ---------------------------------------------------------- |
+| OCRResult[] | 命中子串的识别结果数组，坐标为原图或全屏绝对坐标           |
 
 **示例:**
 

package/docs/api/image.md

@@ -45,7 +45,7 @@ function captureScreen(
 **示例：**
 
 ```javascript
-// 截取全屏
+// 全屏截图
 const imageId = image.captureScreen();
 // 获取手机文档目录
 const dir = file.getInternalDir("documents");
@@ -70,74 +70,6 @@ if (imageId) {
 }
 ```
 
-### captureFullScreen - 截取设备全屏。
-
-```typescript
-function captureFullScreen(): string | null;
-```
-
-**返回值：**
-
-| 类型     | 描述                             |
-| -------- | -------------------------------- |
-| `string` | 截图的图片 ID，失败时返回 `null` |
-
-**示例：**
-
-```javascript
-const imageId = image.captureFullScreen();
-// 获取手机文档目录
-const dir = file.getInternalDir("documents");
-if (imageId) {
-  logi("截图成功");
-  image.saveTo(imageId, `${dir}/screenshot.jpg`);
-  image.release(imageId); // 记得释放内存
-} else {
-  logi("截图失败");
-}
-```
-
-### captureRect - 截取设备指定区域。
-
-```typescript
-function captureRect(
-  x: number,
-  y: number,
-  ex: number,
-  ey: number,
-): string | null;
-```
-
-**参数：**
-
-| 参数名 | 类型   | 是否必填 | 默认值 | 描述              |
-| ------ | ------ | -------- | ------ | ----------------- |
-| `x`    | number | 是       | -      | 区域左上角 X 坐标 |
-| `y`    | number | 是       | -      | 区域左上角 Y 坐标 |
-| `ex`   | number | 是       | -      | 区域右下角 X 坐标 |
-| `ey`   | number | 是       | -      | 区域右下角 Y 坐标 |
-
-**返回值：**
-
-| 类型     | 描述                             |
-| -------- | -------------------------------- |
-| `string` | 截图的图片 ID，失败时返回 `null` |
-
-**示例：**
-
-```javascript
-const imageId = image.captureRect(100, 100, 200, 200);
-// 获取手机文档目录
-const dir = file.getInternalDir("documents");
-if (imageId) {
-  logi("截图成功");
-  image.saveTo(imageId, `${dir}/screenshot.jpg`);
-  image.release(imageId); // 记得释放内存
-} else {
-  logi("截图失败");
-}
-```
-
 ### readImage - 从文件路径或imageId读取图片。
 
 ```typescript
@@ -191,7 +123,7 @@ function saveTo(imageId: string, filePath: string): boolean;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 // 获取手机文档目录
 const dir = file.getInternalDir("documents");
 if (imageId) {
@@ -241,7 +173,7 @@ function isRelease(imageId: string): boolean;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   logi(`释放前: ${image.isRelease(imageId)}`); // false
   image.release(imageId);
@@ -272,7 +204,7 @@ function getSize(imageId: string): { width: number; height: number } | null;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   const size = image.getSize(imageId);
   if (size) {
@@ -305,7 +237,7 @@ function pixel(imageId: string, x: number, y: number): number;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   const color = image.pixel(imageId, 100, 100);
   const colorHex = image.argb(color);
@@ -371,7 +303,7 @@ function findColor(
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   // 查找蓝色按钮
   const points = image.findColor(
@@ -435,7 +367,7 @@ function findMultiColor(
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   // 查找特定的颜色组合（如按钮的特征颜色）
   const points = image.findMultiColor(
@@ -495,7 +427,7 @@ function countColor(
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   const count = image.countColor(
     imageId,
@@ -535,7 +467,7 @@ function cmpColor(imageId: string, points: string, threshold: number): boolean;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   // 检查特定区域是否为预期颜色
   const isMatch = image.cmpColor(
@@ -664,7 +596,7 @@ function clip(
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 // 获取手机文档目录
 const dir = file.getInternalDir("documents");
 if (imageId) {
@@ -737,7 +669,7 @@ function gray(imageId: string): string;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 // 获取手机文档目录
 const dir = file.getInternalDir("documents");
 if (imageId) {
@@ -770,7 +702,7 @@ function binaryzation(imageId: string, threshold: number): string;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 // 获取手机文档目录
 const dir = file.getInternalDir("documents");
 if (imageId) {
@@ -811,7 +743,7 @@ function drawRect(
 // 获取手机文档目录
 const dir = file.getInternalDir("documents");
 
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   image.drawRect(imageId, 100, 100, 200, 100, "#FF0000", 2);
   image.saveTo(imageId, `${dir}/test.jpg`);
@@ -840,7 +772,7 @@ function scanCode(imageId: string): string | null;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   const result = image.scanCode(imageId);
   if (result) {
@@ -910,7 +842,7 @@ function toBase64Format(imageId: string, format: string, q: number): string;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   const base64 = image.toBase64Format(imageId, "jpg", 90);
   logi(`Base64 数据: ${base64.substring(0, 100)}...`);
@@ -943,7 +875,7 @@ function getBitmap(imageId: string): any;
 **示例：**
 
 ```javascript
-const imageId = image.captureFullScreen();
+const imageId = image.captureScreen();
 if (imageId) {
   const bitmap = image.getBitmap(imageId);
   logi(`Bitmap 对象: ${bitmap}`);