ms-vite-plugin 1.5.12 → 1.5.14

package/docs/api/jbsystem.md

@@ -71,14 +71,14 @@ jbsystem.restartSelf();
 对应 `设置 > 隐私与安全性 > 跟踪 > 允许 App 请求跟踪`。
 
 ```typescript
-function getUserTracking(): boolean | null;
+function getUserTracking(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                             |
 | ------------------ | -------------------------------- |
-| `boolean \| null`  | 当前是否允许；读失败返回 `null`  |
+| `boolean \| undefined`  | 当前是否允许；读失败返回 `undefined`  |
 
 **示例:**
 
@@ -119,14 +119,14 @@ jbsystem.setUserTracking(false);
 对应 `设置 > 隐私与安全性 > Apple 广告 > 个性化广告`。
 
 ```typescript
-function getPersonalizedAdvertising(): boolean | null;
+function getPersonalizedAdvertising(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                             |
 | ------------------ | -------------------------------- |
-| `boolean \| null`  | 当前是否允许；读失败返回 `null`  |
+| `boolean \| undefined`  | 当前是否允许；读失败返回 `undefined`  |
 
 **示例:**
 
@@ -167,14 +167,14 @@ jbsystem.setPersonalizedAdvertising(false);
 对应 `设置 > 隐私与安全性 > 定位服务` 总开关。
 
 ```typescript
-function getLocationServices(): boolean | null;
+function getLocationServices(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                             |
 | ------------------ | -------------------------------- |
-| `boolean \| null`  | 当前是否开启；读失败返回 `null`  |
+| `boolean \| undefined`  | 当前是否开启；读失败返回 `undefined`  |
 
 **示例:**
 

package/docs/api/jbvpn.md

@@ -60,14 +60,14 @@ const ok = jbvpn.create({
 ### list - 列出当前系统 VPN 配置。
 
 ```typescript
-function list(): VpnItem[] | null;
+function list(): VpnItem[] | undefined;
 ```
 
 **返回值:**
 
 | 类型                 | 描述                               |
 | -------------------- | ---------------------------------- |
-| `VpnItem[] \| null`  | 配置列表；读失败返回 `null`        |
+| `VpnItem[] \| undefined`  | 配置列表；读失败返回 `undefined`        |
 
 没有配置时是空数组。每项含 `name`、`id`。
 
@@ -84,17 +84,17 @@ if (items) {
 
 ### current - 读取当前选中的 VPN 配置。
 
-没有选中配置返回 `null`。
+没有选中配置返回 `undefined`。
 
 ```typescript
-function current(): VpnItem | null;
+function current(): VpnItem | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                                      |
 | ------------------ | ----------------------------------------- |
-| `VpnItem \| null`  | `{ name, id }`；没有选中配置返回 `null`   |
+| `VpnItem \| undefined`  | `{ name, id }`；没有选中配置返回 `undefined`   |
 
 **示例:**
 
@@ -200,14 +200,14 @@ jbvpn.disconnect();
 ### status - 读取当前选中 VPN 的状态。
 
 ```typescript
-function status(): VpnStatus | null;
+function status(): VpnStatus | undefined;
 ```
 
 **返回值:**
 
 | 类型                 | 描述                             |
 | -------------------- | -------------------------------- |
-| `VpnStatus \| null`  | `{ text, connected }`；没有选中配置返回 `null` |
+| `VpnStatus \| undefined`  | `{ text, connected }`；没有选中配置返回 `undefined` |
 
 **示例:**
 

package/docs/api/mysql.md

@@ -50,9 +50,9 @@ interface MySQLConfig {
 interface MySQLResult {
   rows: Record<string, any>[]; // 查询结果数据行
   affectedRows: number; // 受影响的行数
-  insertId?: number; // 插入ID（仅适用于INSERT操作）
+  insertId: number | null; // 插入ID（仅适用于INSERT操作）；没有插入时为 null
   success: boolean; // 查询是否成功
-  error?: string; // 错误信息
+  error: string | null; // 错误信息；成功时为 null
 }
 ```
 
@@ -62,9 +62,9 @@ interface MySQLResult {
 | -------------- | --------------------- | -------- | ------ | ------------------------------- |
 | `rows`         | Record<string, any>[] | 否       |        | 查询结果数据行                  |
 | `affectedRows` | number                | 否       |        | 受影响的行数                    |
-| `insertId`     | number                | 否       |        | 插入 ID（仅适用于 INSERT 操作） |
+| `insertId`     | number \| null        | 否       |        | 插入 ID；没有插入时为 `null`            |
 | `success`      | boolean               | 否       |        | 查询是否成功                    |
-| `error`        | string                | 否       |        | 错误信息                        |
+| `error`        | string \| null        | 否       |        | 错误信息；成功时为 `null`               |
 
 ## API 参考
 

package/docs/api/netCard.md

@@ -1,17 +1,16 @@
 # 卡密模块 (NetCard)
 
-卡密模块提供了卡密验证、备注设置以及键值对存储功能，用于管理网络卡密相关的操作。
+卡密模块提供了卡密验证和备注设置功能，用于管理网络卡密相关的操作。
 
 ## 功能概览
 
 - **卡密验证**: 验证卡密的有效性
 - **备注管理**: 设置和管理卡密备注信息
-- **云变量存储**: 提供键值对形式的数据存储和读取功能
 
 ## 注意事项
 
 1. **卡密安全**: 卡密信息应当妥善保管，避免在日志中明文输出
-2. **普通卡密模式**: 需要先调用 `netCard.verify(cardNo)` 验证卡密，验证通过后才能调用获取卡密信息、备注和云变量等接口
+2. **普通卡密模式**: 需要先调用 `netCard.verify(cardNo)` 验证卡密，验证通过后才能调用获取卡密信息和备注等接口
 3. **授权卡密模式**: App 打开加密 UI 或运行脚本前会完成授权和卡密验证，脚本中不需要重复让用户输入卡密，也不需要重复调用 `netCard.verify`
 4. **兼容旧脚本**: 授权卡密模式下调用 `netCard.verify` 会直接返回 `true`，用于兼容原来已经写了 `verify` 的脚本
 
@@ -73,7 +72,7 @@ function verify(cardNo: string): boolean;
 
 **说明：**
 
-普通卡密模式下，该方法会请求普通卡密验证接口，验证成功后才能继续使用卡密信息、备注和云变量相关能力。
+普通卡密模式下，该方法会请求普通卡密验证接口，验证成功后才能继续使用卡密信息和备注相关能力。
 
 授权卡密模式下，App 层已经完成授权和卡密验证，脚本侧不需要重复调用该方法；如果旧脚本仍然调用，方法会直接返回 `true`。
 
@@ -110,7 +109,7 @@ if (!netCard.isAuthCardMode()) {
 #### getCardInfo - 获取卡密信息
 
 ```typescript
-function getCardInfo(): CardInfo | null;
+function getCardInfo(): CardInfo | undefined;
 ```
 
 **返回值：**
@@ -168,71 +167,3 @@ if (success) {
   logger.error("备注设置失败");
 }
 ```
-
-### 云变量
-
-#### setValue - 设置键值对
-
-```typescript
-function setValue(key: string, value: string): string;
-```
-
-**参数说明：**
-
-| 参数名  | 类型   | 是否必填 | 默认值 | 描述       |
-| ------- | ------ | -------- | ------ | ---------- |
-| `key`   | string | 是       |        | 存储的键名 |
-| `value` | string | 是       |        | 存储的值   |
-
-**返回值：**
-
-| 类型     | 描述                                          |
-| -------- | --------------------------------------------- |
-| `string` | 成功时返回设置的 value 值，失败时返回空字符串 |
-
-**示例：**
-
-```typescript
-// 设置键值对
-const key = "userConfig";
-const value = "enableNotification";
-const result = netCard.setValue(key, value);
-
-if (result === value) {
-  logi(`成功设置 ${key}: ${value}`);
-} else {
-  logger.error("设置失败");
-}
-```
-
-#### getValue - 获取键值对
-
-```typescript
-function getValue(key: string): string;
-```
-
-**参数说明：**
-
-| 参数名 | 类型   | 是否必填 | 默认值 | 描述         |
-| ------ | ------ | -------- | ------ | ------------ |
-| `key`  | string | 是       |        | 要获取的键名 |
-
-**返回值：**
-
-| 类型     | 描述                                             |
-| -------- | ------------------------------------------------ |
-| `string` | 成功时返回对应的值，失败或键不存在时返回空字符串 |
-
-**示例：**
-
-```typescript
-// 获取键值对
-const key = "userConfig";
-const value = netCard.getValue(key);
-
-if (value) {
-  logi(`获取到配置: ${key} = ${value}`);
-} else {
-  logw(`配置 ${key} 不存在或获取失败");
-}
-```

package/docs/api/node.md

@@ -100,9 +100,9 @@ const listPage = createNodeSelector({ mode: 2 });
 | `releaseNode()` | 释放内存 |
 | `loadNode(timeout?)` | 重新加载界面节点，默认超时 5000ms |
 | `clearSelector()` | 清除已设置的筛选条件 |
-| `xml(timeout?)` | 获取界面 XML，失败返回 `null` |
+| `xml(timeout?)` | 获取界面 XML，失败返回 `undefined` |
 | `getNodeInfo(timeout?)` | 获取所有匹配节点 |
-| `getOneNodeInfo(timeout?)` | 获取第一个匹配节点，没有则 `null` |
+| `getOneNodeInfo(timeout?)` | 获取第一个匹配节点，没有则 `undefined` |
 
 `timeout` 单位均为毫秒，默认 `5000`。
 
@@ -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);