ms-vite-plugin 1.5.13 → 1.5.15

package/docs/api/jbpower.md

@@ -2,7 +2,7 @@
 
 仅越狱包可用。免越狱包没有 `jbpower`。
 
-`info` 读取电量百分比、电流、电压和充电状态。`stopCharging` 停止充电并保持，直到调用 `startCharging`。
+`info` 读取电量百分比、电流、电压和充电状态。`stopCharging` 停止充电并保持，直到调用 `startCharging`。`setSmartCharging` 到上限停止充电，降到下限再充，中间保持。
 
 电流单位是毫安，正数表示正在进电。电压单位是毫伏。
 
@@ -83,3 +83,52 @@ function startCharging(): boolean;
 ```javascript
 jbpower.startCharging();
 ```
+
+### setSmartCharging - 打开智能充电。
+
+电量到 `max` 停止充电，降到 `min` 再充。窗口中间保持上次的决定，不会在停充和充电之间来回切。
+
+上限会收到 2 到 100，下限至少为 1，并且必须小于上限。
+
+```typescript
+function setSmartCharging(min: number, max: number): boolean;
+```
+
+**参数:**
+
+| 参数  | 类型     | 描述                 |
+| ----- | -------- | -------------------- |
+| `min` | `number` | 再充下限，百分比     |
+| `max` | `number` | 停充上限，百分比     |
+
+**返回值:**
+
+| 类型      | 描述           |
+| --------- | -------------- |
+| `boolean` | 保存成功为 `true` |
+
+**示例:**
+
+```javascript
+jbpower.setSmartCharging(20, 80);
+```
+
+### clearSmartCharging - 关掉智能充电。
+
+如果当前正按窗口停充，会恢复充电。
+
+```typescript
+function clearSmartCharging(): boolean;
+```
+
+**返回值:**
+
+| 类型      | 描述           |
+| --------- | -------------- |
+| `boolean` | 保存成功为 `true` |
+
+**示例:**
+
+```javascript
+jbpower.clearSmartCharging();
+```

package/docs/api/node.md

@@ -144,9 +144,11 @@ selector.releaseNode();
 | `depth` | 层级 |
 | `childCount` | 子节点数，支持数字或如 `">0"` |
 | `bounds(x, y, width, height)` | 区域 |
-| `xpath` | XPath |
+| `xpath` | XPath 1.0 路径 |
 | `id` | 按节点 ID |
 
+`xpath` 只支持 [XPath 1.0](https://www.w3.org/TR/1999/REC-xpath-19991116/)。`matches()` 等 XPath 2.0 函数不可用；属性上的正则用 `identifierMatch` 等带 `Match` 的方法。
+
 ```typescript
 // 精确
 selector.label("确定").type("XCUIElementTypeButton").getOneNodeInfo(3000);

package/docs/api/ui.md

@@ -833,6 +833,58 @@ ms.setWebWindowSize({
 });
 ```
 
+#### closeWebWindow - 关闭当前网页窗口
+
+```typescript
+declare function closeWebWindow(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果关闭成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。关闭当前悬浮网页窗口，不影响悬浮球和日志窗口。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.closeWebWindow().then((ok) => {
+  console.log(ok);
+});
+```
+
+#### setWebWindowBlankClose - 是否允许点击空白处关闭
+
+```typescript
+declare function setWebWindowBlankClose(allowed: boolean): Promise<boolean>;
+```
+
+**参数：**
+
+| 参数名    | 类型    | 是否必填 | 默认值 | 描述                                              |
+| --------- | ------- | -------- | ------ | ------------------------------------------------- |
+| `allowed` | boolean | 是       |        | `true` 允许点空白关闭，`false` 点空白不关闭      |
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果设置成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。每次打开默认不允许点空白关闭，由网页按钮调用 `closeWebWindow`。传 `true` 后，点窗口外遮罩会关闭网页窗口，不影响悬浮球和日志窗口。关掉再打开会回到不允许。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.setWebWindowBlankClose(true);
+```
+
 ### 完整示例
 
 **完整的控制面板示例：**

package/docs/apicn/node.md

@@ -144,9 +144,11 @@ selector.释放内存();
 | `层级` | 层级 |
 | `子节点数量` | 子节点数，支持数字或如 `">0"` |
 | `范围(x, y, width, height)` | 区域 |
-| `xpath` | XPath |
+| `xpath` | XPath 1.0 路径 |
 | `id` | 按节点 ID |
 
+`xpath` 只支持 [XPath 1.0](https://www.w3.org/TR/1999/REC-xpath-19991116/)。`matches()` 等 XPath 2.0 函数不可用；属性上的正则用 `标识符匹配` 等带「匹配」的方法。
+
 ```typescript
 // 精确
 selector.标签("确定").类型("XCUIElementTypeButton").获取一个节点信息(3000);

package/docs/apicn/ui.md

@@ -821,6 +821,58 @@ ms.setWebWindowSize({
 });
 ```
 
+#### closeWebWindow() - 关闭当前网页窗口
+
+```typescript
+declare function closeWebWindow(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果关闭成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。关闭当前悬浮网页窗口，不影响悬浮球和日志窗口。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.closeWebWindow().then((ok) => {
+  console.log(ok);
+});
+```
+
+#### setWebWindowBlankClose() - 是否允许点击空白处关闭
+
+```typescript
+declare function setWebWindowBlankClose(allowed: boolean): Promise<boolean>;
+```
+
+**参数：**
+
+| 参数名    | 类型    | 是否必填 | 默认值 | 描述                                              |
+| --------- | ------- | -------- | ------ | ------------------------------------------------- |
+| `allowed` | boolean | 是       |        | `true` 允许点空白关闭，`false` 点空白不关闭      |
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果设置成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。每次打开默认不允许点空白关闭，由网页按钮调用 `closeWebWindow`。传 `true` 后，点窗口外遮罩会关闭网页窗口，不影响悬浮球和日志窗口。关掉再打开会回到不允许。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.setWebWindowBlankClose(true);
+```
+
 ### 完整示例
 
 **完整的控制面板示例：**

package/docs/apilua/jbpower.md

@@ -4,7 +4,7 @@
 
 仅越狱包可用。免越狱包没有 `jbpower`。
 
-`info` 读取电量百分比、电流、电压和充电状态。`stopCharging` 停止充电并保持，直到调用 `startCharging`。
+`info` 读取电量百分比、电流、电压和充电状态。`stopCharging` 停止充电并保持，直到调用 `startCharging`。`setSmartCharging` 到上限停止充电，降到下限再充，中间保持。
 
 电流单位是毫安，正数表示正在进电。电压单位是毫伏。
 
@@ -85,3 +85,52 @@ function startCharging()
 ```lua
 jbpower.startCharging()
 ```
+
+### setSmartCharging - 打开智能充电。
+
+电量到 `max` 停止充电，降到 `min` 再充。窗口中间保持上次的决定，不会在停充和充电之间来回切。
+
+上限会收到 2 到 100，下限至少为 1，并且必须小于上限。
+
+```lua
+function setSmartCharging(min, max)
+```
+
+**参数:**
+
+| 参数  | 类型      | 描述             |
+| ----- | --------- | ---------------- |
+| `min` | `integer` | 再充下限，百分比 |
+| `max` | `integer` | 停充上限，百分比 |
+
+**返回值:**
+
+| 类型      | 描述            |
+| --------- | --------------- |
+| `boolean` | 保存成功为 `true` |
+
+**示例:**
+
+```lua
+jbpower.setSmartCharging(20, 80)
+```
+
+### clearSmartCharging - 关掉智能充电。
+
+如果当前正按窗口停充，会恢复充电。
+
+```lua
+function clearSmartCharging()
+```
+
+**返回值:**
+
+| 类型      | 描述            |
+| --------- | --------------- |
+| `boolean` | 保存成功为 `true` |
+
+**示例:**
+
+```lua
+jbpower.clearSmartCharging()
+```

package/docs/apilua/node.md

@@ -155,9 +155,11 @@ selector:releaseNode()  -- 手动释放
 | `depth` | 层级 |
 | `childCount` | 子节点数，支持数字或如 `">0"` |
 | `bounds(x, y, width, height)` | 区域 |
-| `xpath` | XPath |
+| `xpath` | XPath 1.0 路径 |
 | `id` | 按节点 ID |
 
+`xpath` 只支持 [XPath 1.0](https://www.w3.org/TR/1999/REC-xpath-19991116/)。`matches()` 等 XPath 2.0 函数不可用；属性上的正则用 `identifierMatch` 等带 `Match` 的方法。
+
 ```lua
 -- 精确
 selector:label("确定"):type("XCUIElementTypeButton"):getOneNodeInfo(3000)

package/docs/apilua/ui.md

@@ -874,6 +874,58 @@ ms.setWebWindowSize({
 });
 ```
 
+#### closeWebWindow - 关闭当前网页窗口
+
+```typescript
+declare function closeWebWindow(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果关闭成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。关闭当前悬浮网页窗口，不影响悬浮球和日志窗口。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.closeWebWindow().then((ok) => {
+  console.log(ok);
+});
+```
+
+#### setWebWindowBlankClose - 是否允许点击空白处关闭
+
+```typescript
+declare function setWebWindowBlankClose(allowed: boolean): Promise<boolean>;
+```
+
+**参数：**
+
+| 参数名    | 类型    | 是否必填 | 默认值 | 描述                                              |
+| --------- | ------- | -------- | ------ | ------------------------------------------------- |
+| `allowed` | boolean | 是       |        | `true` 允许点空白关闭，`false` 点空白不关闭      |
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果设置成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。每次打开默认不允许点空白关闭，由网页按钮调用 `closeWebWindow`。传 `true` 后，点窗口外遮罩会关闭网页窗口，不影响悬浮球和日志窗口。关掉再打开会回到不允许。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.setWebWindowBlankClose(true);
+```
+
 ### 完整示例
 
 **完整的控制面板示例：**

package/docs/apipython/jbpower.md

@@ -2,7 +2,7 @@
 
 仅越狱包可用。免越狱包没有 `jbpower`。
 
-`info` 读取电量百分比、电流、电压和充电状态。`stopCharging` 停止充电并保持，直到调用 `startCharging`。
+`info` 读取电量百分比、电流、电压和充电状态。`stopCharging` 停止充电并保持，直到调用 `startCharging`。`setSmartCharging` 到上限停止充电，降到下限再充，中间保持。
 
 电流单位是毫安，正数表示正在进电。电压单位是毫伏。
 
@@ -82,3 +82,52 @@ def startCharging() -> bool
 ```python
 jbpower.startCharging()
 ```
+
+### setSmartCharging - 打开智能充电。
+
+电量到 `max` 停止充电，降到 `min` 再充。窗口中间保持上次的决定，不会在停充和充电之间来回切。
+
+上限会收到 2 到 100，下限至少为 1，并且必须小于上限。
+
+```python
+def setSmartCharging(min: int, max: int) -> bool
+```
+
+**参数:**
+
+| 参数  | 类型  | 描述             |
+| ----- | ----- | ---------------- |
+| `min` | `int` | 再充下限，百分比 |
+| `max` | `int` | 停充上限，百分比 |
+
+**返回值:**
+
+| 类型   | 描述              |
+| ------ | ----------------- |
+| `bool` | 保存成功为 `True` |
+
+**示例:**
+
+```python
+jbpower.setSmartCharging(20, 80)
+```
+
+### clearSmartCharging - 关掉智能充电。
+
+如果当前正按窗口停充，会恢复充电。
+
+```python
+def clearSmartCharging() -> bool
+```
+
+**返回值:**
+
+| 类型   | 描述              |
+| ------ | ----------------- |
+| `bool` | 保存成功为 `True` |
+
+**示例:**
+
+```python
+jbpower.clearSmartCharging()
+```

package/docs/apipython/node.md

@@ -157,7 +157,9 @@ xml = selector.xml()
 | --- | --- |
 | 文本 | `label` / `labelMatch`、`title` / `titleMatch`、`identifier` / `identifierMatch`、`value` / `valueMatch`、`placeholderValue` / `placeholderValueMatch` |
 | 类型状态 | `type` / `typeMatch`、`enabled` |
-| 结构位置 | `index`、`depth`、`childCount`（支持 `">0"`）、`bounds`、`xpath`、`id` |
+| 结构位置 | `index`、`depth`、`childCount`（支持 `">0"`）、`bounds`、`xpath`（XPath 1.0）、`id` |
+
+`xpath` 只支持 [XPath 1.0](https://www.w3.org/TR/1999/REC-xpath-19991116/)。`matches()` 等 XPath 2.0 函数不可用；属性上的正则用 `identifierMatch` 等带 `Match` 的方法。
 
 ```python
 selector.label("确定").type("XCUIElementTypeButton").getOneNodeInfo(3000)

package/docs/apipython/ui.md

@@ -825,6 +825,58 @@ ms.setWebWindowSize({
 });
 ```
 
+#### closeWebWindow - 关闭当前网页窗口
+
+```typescript
+declare function closeWebWindow(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果关闭成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。关闭当前悬浮网页窗口，不影响悬浮球和日志窗口。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.closeWebWindow().then((ok) => {
+  console.log(ok);
+});
+```
+
+#### setWebWindowBlankClose - 是否允许点击空白处关闭
+
+```typescript
+declare function setWebWindowBlankClose(allowed: boolean): Promise<boolean>;
+```
+
+**参数：**
+
+| 参数名    | 类型    | 是否必填 | 默认值 | 描述                                              |
+| --------- | ------- | -------- | ------ | ------------------------------------------------- |
+| `allowed` | boolean | 是       |        | `true` 允许点空白关闭，`false` 点空白不关闭      |
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果设置成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。每次打开默认不允许点空白关闭，由网页按钮调用 `closeWebWindow`。传 `true` 后，点窗口外遮罩会关闭网页窗口，不影响悬浮球和日志窗口。关掉再打开会回到不允许。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.setWebWindowBlankClose(true);
+```
+
 ### 完整示例
 
 **完整的控制面板示例：**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.5.13",
+  "version": "1.5.15",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {