ms-vite-plugin 1.5.13 → 1.5.14

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/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/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/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/package.json

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