ms-vite-plugin 1.4.20 → 1.4.22

package/docs/api/config.md

@@ -12,57 +12,53 @@
 
 ## API 参考
 
-### 配置读取
-
-#### get - 读取配置项的值。
+### all - 获取所有配置的 JSON 格式数据。
 
 ```typescript
-function get(key: string): any | null;
+function all(): Record<string, any>;
 ```
 
-**参数:**
-
-| 参数名 | 类型   | 是否必填 | 默认值 | 描述     |
-| ------ | ------ | -------- | ------ | -------- |
-| `key`  | string | 是       | -      | 配置键名 |
-
 **返回值:**
 
-| 类型          | 描述   |
-| ------------- | ------ |
-| `any \| null` | 配置值 |
+| 类型                  | 描述               |
+| --------------------- | ------------------ |
+| `Record<string, any>` | 包含所有配置的对象 |
 
 **示例:**
 
 ```javascript
-const maxRetries = config.get("maxRetries");
-if (maxRetries !== null) {
-  logi(`最大重试次数: ${maxRetries}`);
-}
+const allConfigs = config.all();
+logi(`所有配置: ${JSON.stringify(allConfigs, null, 2)}`);
 ```
 
-### 配置管理
-
-#### all - 获取所有配置的 JSON 格式数据。
+### setAll - 设置所有配置项。
 
 ```typescript
-function all(): Record<string, any>;
+function setAll(config: Record<string, any>): boolean;
 ```
 
+**参数:**
+
+| 参数名   | 类型                  | 是否必填 | 默认值 | 描述             |
+| -------- | --------------------- | -------- | ------ | ---------------- |
+| `config` | `Record<string, any>` | 是       | -      | 完整配置对象     |
+
 **返回值:**
 
-| 类型                  | 描述               |
-| --------------------- | ------------------ |
-| `Record<string, any>` | 包含所有配置的对象 |
+| 类型      | 描述         |
+| --------- | ------------ |
+| `boolean` | 设置是否成功 |
 
 **示例:**
 
 ```javascript
-const allConfigs = config.all();
-logi(`所有配置: ${JSON.stringify(allConfigs, null, 2)}`);
+const success = config.setAll({ maxRetries: 5, debugEnabled: true });
+if (success) {
+  logi("所有配置已更新");
+}
 ```
 
-#### set - 更新或设置配置项的值。
+### set - 更新或设置配置项的值。
 
 ```typescript
 function set(key: string, value: any): boolean;
@@ -94,7 +90,53 @@ if (success1 && success2 && success3) {
 }
 ```
 
-#### remove - 删除指定的配置项。
+### get - 读取配置项的值。
+
+```typescript
+function get(key: string): any | null;
+```
+
+**参数:**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述     |
+| ------ | ------ | -------- | ------ | -------- |
+| `key`  | string | 是       | -      | 配置键名 |
+
+**返回值:**
+
+| 类型          | 描述   |
+| ------------- | ------ |
+| `any \| null` | 配置值 |
+
+**示例:**
+
+```javascript
+const maxRetries = config.get("maxRetries");
+if (maxRetries !== null) {
+  logi(`最大重试次数: ${maxRetries}`);
+}
+```
+
+### getKuiConfig - 获取 KUI 的配置。
+
+```typescript
+function getKuiConfig(): Record<string, any>;
+```
+
+**返回值:**
+
+| 类型                  | 描述                                                     |
+| --------------------- | -------------------------------------------------------- |
+| `Record<string, any>` | `KUI_CONFIG` 对应的对象，配置不存在或无法转换时返回空对象 |
+
+**示例:**
+
+```javascript
+const kuiConfig = config.getKuiConfig();
+logi(`KUI 配置: ${JSON.stringify(kuiConfig, null, 2)}`);
+```
+
+### remove - 删除指定的配置项。
 
 ```typescript
 function remove(key: string): boolean;

package/docs/apicn/config.md

@@ -12,55 +12,53 @@
 
 ## API 参考
 
-### 配置读取
-
-#### 获取
+### 所有配置
 
 ```typescript
-function 获取(配置键: 字符串): 任意类型 | null;
+function 所有配置(): 字典<任意类型>;
 ```
 
-**参数:**
-
-| 参数名   | 类型   | 是否必填 | 默认值 | 描述     |
-| -------- | ------ | -------- | ------ | -------- |
-| `配置键` | 字符串 | 是       | -      | 配置键名 |
-
 **返回值:**
 
-| 类型               | 描述   |
-| ------------------ | ------ |
-| `任意类型 \| null` | 配置值 |
+| 类型             | 描述               |
+| ---------------- | ------------------ |
+| `字典<任意类型>` | 包含所有配置的对象 |
 
 **示例:**
 
 ```javascript
-const maxRetries = $配置.获取("maxRetries");
-$打印信息日志(`最大重试次数: ${maxRetries}`);
+const allConfigs = $配置.所有配置();
+$打印信息日志(`所有配置: ${JSON.stringify(allConfigs, null, 2)}`);
 ```
 
-### 配置管理
-
-#### 所有配置
+### 设置所有
 
 ```typescript
-function 所有配置(): 字典<任意类型>;
+function 设置所有(config: 字典<任意类型>): 布尔值;
 ```
 
+**参数:**
+
+| 参数名   | 类型             | 是否必填 | 默认值 | 描述         |
+| -------- | ---------------- | -------- | ------ | ------------ |
+| `config` | 字典<任意类型>   | 是       | -      | 完整配置对象 |
+
 **返回值:**
 
-| 类型             | 描述               |
-| ---------------- | ------------------ |
-| `字典<任意类型>` | 包含所有配置的对象 |
+| 类型     | 描述         |
+| -------- | ------------ |
+| `布尔值` | 设置是否成功 |
 
 **示例:**
 
 ```javascript
-const allConfigs = $配置.所有配置();
-$打印信息日志(`所有配置: ${JSON.stringify(allConfigs, null, 2)}`);
+const 是否设置成功 = $配置.设置所有({ maxRetries: 5, debugEnabled: true });
+if (是否设置成功) {
+  $打印信息日志("所有配置已更新");
+}
 ```
 
-#### 设置
+### 设置
 
 ```typescript
 function 设置(配置键: 字符串, 配置值: 任意类型): 布尔值;
@@ -92,7 +90,51 @@ if (是否更新成功1 && 是否更新成功2 && 是否更新成功3) {
 }
 ```
 
-#### 删除
+### 获取
+
+```typescript
+function 获取(配置键: 字符串): 任意类型 | null;
+```
+
+**参数:**
+
+| 参数名   | 类型   | 是否必填 | 默认值 | 描述     |
+| -------- | ------ | -------- | ------ | -------- |
+| `配置键` | 字符串 | 是       | -      | 配置键名 |
+
+**返回值:**
+
+| 类型               | 描述   |
+| ------------------ | ------ |
+| `任意类型 \| null` | 配置值 |
+
+**示例:**
+
+```javascript
+const maxRetries = $配置.获取("maxRetries");
+$打印信息日志(`最大重试次数: ${maxRetries}`);
+```
+
+### 获取KUI配置 - 获取 KUI 的配置。
+
+```typescript
+function 获取KUI配置(): 字典<任意类型>;
+```
+
+**返回值:**
+
+| 类型             | 描述                                                     |
+| ---------------- | -------------------------------------------------------- |
+| `字典<任意类型>` | `KUI_CONFIG` 对应的对象，配置不存在或无法转换时返回空对象 |
+
+**示例:**
+
+```javascript
+const kuiConfig = $配置.获取KUI配置();
+$打印信息日志(`KUI 配置: ${JSON.stringify(kuiConfig, null, 2)}`);
+```
+
+### 删除
 
 ```typescript
 function 删除(配置键: 字符串): 布尔值;

package/docs/apipython/appleocr.md

@@ -28,12 +28,12 @@ AppleOCR 模块基于 Apple Vision 框架，提供原生的光学字符识别（
 
 ### OCRResult
 
-识别结果字典，包含以下键：
+识别结果对象，包含以下字段：
 
 ```python
-from typing import TypedDict
+from kuaijs._types import KuaiJSNamespace
 
-class OCRResult(TypedDict):
+class OCRResult(KuaiJSNamespace):
     text: str       # 识别的文本内容
     confidence: float # 识别置信度 (0-1)
     x: int          # 文本区域左上角 x 坐标

package/docs/apipython/config.md

@@ -12,61 +12,57 @@
 
 ## API 参考
 
-### 配置读取
-
-#### get - 读取配置项的值。
+### all - 获取所有配置的 JSON 格式数据。
 
 ```python
-from typing import Any, Optional, Dict
+from typing import Any, Dict
 
-def get(key: str) -> Any | None:
+def all() -> Dict[str, Any]:
 ```
 
-**参数:**
-
-| 参数名 | 类型   | 是否必填 | 默认值 | 描述     |
-| ------ | ------ | -------- | ------ | -------- |
-| `key`  | string | 是       | -      | 配置键名 |
-
 **返回值:**
 
-| 类型          | 描述   |
-| ------------- | ------ |
-| `Any \| None` | 配置值 |
+| 类型             | 描述               |
+| ---------------- | ------------------ |
+| `Dict[str, Any]` | 包含所有配置的对象 |
 
 **示例:**
 
 ```python
 from kuaijs import config
-maxRetries = config.get("maxRetries")
-if maxRetries:
-  print(f"最大重试次数: {maxRetries}")
+import json
+allConfigs = config.all()
+print(f"所有配置: {json.dumps(allConfigs, indent=2)}")
 ```
 
-### 配置管理
-
-#### all - 获取所有配置的 JSON 格式数据。
+### setAll - 设置所有配置项。
 
 ```python
-def all() -> Dict[str, Any]:
+def setAll(config: Dict[str, Any]) -> bool:
 ```
 
+**参数:**
+
+| 参数名   | 类型             | 是否必填 | 默认值 | 描述         |
+| -------- | ---------------- | -------- | ------ | ------------ |
+| `config` | `Dict[str, Any]` | 是       | -      | 完整配置字典 |
+
 **返回值:**
 
-| 类型             | 描述               |
-| ---------------- | ------------------ |
-| `Dict[str, Any]` | 包含所有配置的对象 |
+| 类型   | 描述         |
+| ------ | ------------ |
+| `bool` | 设置是否成功 |
 
 **示例:**
 
 ```python
 from kuaijs import config
-import json
-allConfigs = config.all()
-print(f"所有配置: {json.dumps(allConfigs, indent=2)}")
+success = config.setAll({"maxRetries": 5, "debugEnabled": True})
+if success:
+  print("所有配置已更新")
 ```
 
-#### set - 更新或设置配置项的值。
+### set - 更新或设置配置项的值。
 
 ```python
 def set(key: str, value: Any) -> bool:
@@ -98,7 +94,54 @@ if success1 and success2 and success3:
   print("配置更新成功")
 ```
 
-#### remove - 删除指定的配置项。
+### get - 读取配置项的值。
+
+```python
+def get(key: str) -> Any | None:
+```
+
+**参数:**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述     |
+| ------ | ------ | -------- | ------ | -------- |
+| `key`  | string | 是       | -      | 配置键名 |
+
+**返回值:**
+
+| 类型          | 描述   |
+| ------------- | ------ |
+| `Any \| None` | 配置值 |
+
+**示例:**
+
+```python
+from kuaijs import config
+maxRetries = config.get("maxRetries")
+if maxRetries:
+  print(f"最大重试次数: {maxRetries}")
+```
+
+### getKuiConfig - 获取 KUI 的配置。
+
+```python
+def getKuiConfig() -> Dict[str, Any]:
+```
+
+**返回值:**
+
+| 类型             | 描述                                                     |
+| ---------------- | -------------------------------------------------------- |
+| `Dict[str, Any]` | `KUI_CONFIG` 对应的字典，配置不存在或无法转换时返回空字典 |
+
+**示例:**
+
+```python
+from kuaijs import config
+kui_config = config.getKuiConfig()
+print(f"KUI 配置: {kui_config}")
+```
+
+### remove - 删除指定的配置项。
 
 ```python
 def remove(key: str) -> bool:

package/docs/apipython/device.md

@@ -7,9 +7,10 @@
 ### getBatteryInfo - 获取设备的电池信息。
 
 ```python
-from typing import TypedDict, Literal
+from typing import Literal
+from kuaijs._types import KuaiJSNamespace
 
-class BatteryInfo(TypedDict):
+class BatteryInfo(KuaiJSNamespace):
     level: int  # 电池电量（0-100）
     isCharging: bool  # 是否正在充电
 
@@ -38,9 +39,10 @@ if info.level < 20:
 ### getStorageSpace - 获取设备存储空间信息。
 
 ```python
-from typing import TypedDict, Literal
+from typing import Literal
+from kuaijs._types import KuaiJSNamespace
 
-class StorageSpaceInfo(TypedDict):
+class StorageSpaceInfo(KuaiJSNamespace):
     total: float  # 总存储空间（GB，十进制）
     free: float  # 剩余存储空间（GB，十进制）
     unit: Literal["GB"]  # 单位，固定 GB
@@ -198,7 +200,9 @@ print(device.getDeviceModel())
 - 返回尺寸为设备分辨率除以缩放比例计算结果；仅返回竖屏分辨率
 
 ```python
-class ScreenSize(TypedDict):
+from kuaijs._types import KuaiJSNamespace
+
+class ScreenSize(KuaiJSNamespace):
     width: float  # 屏幕宽度（像素）
     height: float  # 屏幕高度（像素）
 

package/docs/apipython/g.md

@@ -158,7 +158,7 @@ if g.getCpuAutoThrottle():
 设置 CPU 限流单次 sleep 延迟范围（毫秒）。默认 `min_ms=3`、`max_ms=30`。仅在 CPU 自动限流开启且触发限流时生效。
 
 ```python
-def setCpuThrottleDelay(min_ms: int, max_ms: int) -> dict
+def setCpuThrottleDelay(min_ms: int, max_ms: int) -> CpuThrottleDelay
 ```
 
 **参数:**
@@ -170,9 +170,10 @@ def setCpuThrottleDelay(min_ms: int, max_ms: int) -> dict
 
 **返回值:**
 
-| 类型   | 描述               |
-| ------ | ------------------ |
-| `dict` | `{"minMs": int, "maxMs": int}`，实际生效的延迟范围 |
+| 字段名  | 类型  | 描述           |
+| ------- | ----- | -------------- |
+| `minMs` | `int` | 实际最低延迟   |
+| `maxMs` | `int` | 实际最高延迟   |
 
 **示例:**
 
@@ -188,14 +189,15 @@ print(f"CPU 限流延迟: {delay['minMs']}~{delay['maxMs']}ms")
 获取 CPU 限流延迟范围（毫秒）。
 
 ```python
-def getCpuThrottleDelay() -> dict
+def getCpuThrottleDelay() -> CpuThrottleDelay
 ```
 
 **返回值:**
 
-| 类型   | 描述               |
-| ------ | ------------------ |
-| `dict` | `{"minMs": int, "maxMs": int}`，当前最低与最高延迟 |
+| 字段名  | 类型  | 描述         |
+| ------- | ----- | ------------ |
+| `minMs` | `int` | 当前最低延迟 |
+| `maxMs` | `int` | 当前最高延迟 |
 
 **示例:**
 

package/docs/apipython/hid.md

@@ -1109,15 +1109,22 @@ hid.takeMeToFront()
 获取当前打开应用的信息（仅 iOS 18.2+）。
 
 ```python
-def currentAppInfo() -> Optional[dict]
+from typing import Optional
+from kuaijs._types import KuaiJSNamespace
+
+class AppInfo(KuaiJSNamespace):
+    name: str
+    bundleId: str
+
+def currentAppInfo() -> Optional[AppInfo]
 ```
 
 **返回值:**
 | 类型 | 描述 |
 | ---- | ---- |
-| dict \| None | 当前应用信息或 None（如果不可用） |
+| AppInfo \| None | 当前应用信息或 None（如果不可用） |
 
-**返回字典属性:**
+**返回属性:**
 | 属性 | 类型 | 描述 |
 | ---- | ---- | ---- |
 | `name` | str | 应用程序名称 |

package/docs/apipython/hotUpdate.md

@@ -13,9 +13,10 @@
 服务器响应数据结构。
 
 ```python
-from typing import TypedDict, Optional
+from typing import Optional
+from kuaijs._types import KuaiJSNamespace
 
-class HotUpdateResponse(TypedDict):
+class HotUpdateResponse(KuaiJSNamespace):
     download_url: str      # 新包的下载地址
     version: int           # 新包的版本号
     download_timeout: int  # 下载超时时间（秒）
@@ -30,9 +31,10 @@ class HotUpdateResponse(TypedDict):
 热更新检查结果。
 
 ```python
-from typing import TypedDict, Optional
+from typing import Optional
+from kuaijs._types import KuaiJSNamespace
 
-class HotUpdateResult(TypedDict):
+class HotUpdateResult(KuaiJSNamespace):
     needUpdate: bool                   # 是否需要更新
     error: Optional[str]               # 错误信息（当检查失败时）
     data: Optional[HotUpdateResponse]  # 服务器返回的更新数据（当 needUpdate 为 True 时）
@@ -43,9 +45,10 @@ class HotUpdateResult(TypedDict):
 安装结果。
 
 ```python
-from typing import TypedDict, Optional
+from typing import Optional
+from kuaijs._types import KuaiJSNamespace
 
-class InstallResult(TypedDict):
+class InstallResult(KuaiJSNamespace):
     updated: bool         # 是否安装成功
     error: Optional[str]  # 安装失败时的错误信息
 ```

package/docs/apipython/image.md

@@ -182,9 +182,10 @@ if imageId:
 ### getSize - 获取图片尺寸。
 
 ```python
-from typing import TypedDict, Optional
+from typing import Optional
+from kuaijs._types import KuaiJSNamespace
 
-class Size(TypedDict):
+class Size(KuaiJSNamespace):
     width: int
     height: int
 

package/docs/apipython/mysql.md

@@ -45,12 +45,13 @@ class MySQLConfig(TypedDict):
 
 ### MySQLResult
 
-查询结果字典。
+查询结果。
 
 ```python
-from typing import TypedDict, List, Dict, Any, Optional
+from typing import Any, Dict, List, Optional
+from kuaijs._types import KuaiJSNamespace
 
-class MySQLResult(TypedDict):
+class MySQLResult(KuaiJSNamespace):
     rows: List[Dict[str, Any]] # 查询结果数据行
     affectedRows: int          # 受影响的行数
     insertId: Optional[int]    # 插入ID（仅适用于INSERT操作）
@@ -60,8 +61,8 @@ class MySQLResult(TypedDict):
 
 **参数说明:**
 
-| 参数名         | 类型                 | 描述                            |
-| -------------- | -------------------- | ------------------------------- |
+| 参数名         | 类型             | 描述                            |
+| -------------- | ---------------- | ------------------------------- |
 | `rows`         | List[Dict[str, Any]] | 查询结果数据行                  |
 | `affectedRows` | int                  | 受影响的行数                    |
 | `insertId`     | int                  | 插入 ID（仅适用于 INSERT 操作） |

package/docs/apipython/netCard.md

@@ -76,9 +76,10 @@ else:
 #### getCardInfo - 获取卡密信息
 
 ```python
-from typing import TypedDict, Optional
+from typing import Optional
+from kuaijs._types import KuaiJSNamespace
 
-class CardInfo(TypedDict):
+class CardInfo(KuaiJSNamespace):
     cardNo: str
     batchCard: str
     remark: str

package/docs/apipython/paddleocr.md

@@ -19,9 +19,9 @@ PaddleOCR 模块基于百度飞桨 PaddleOCR 技术，提供强大的光学字
 识别结果的数据结构，包含完整的文本信息和位置数据。
 
 ```python
-from typing import TypedDict, List
+from kuaijs._types import KuaiJSNamespace
 
-class OCRResult(TypedDict):
+class OCRResult(KuaiJSNamespace):
     text: str            # 识别的文本内容
     confidence: float    # 识别置信度 (0-1)
     x: int               # 文本区域左上角 x 坐标

package/docs/apipython/system.md

@@ -20,7 +20,9 @@
 前台应用信息结构。
 
 ```python
-class ActivateAppInfo(TypedDict):
+from kuaijs._types import KuaiJSNamespace
+
+class ActivateAppInfo(KuaiJSNamespace):
     bundleId: str
     name: str
     pid: int
@@ -31,7 +33,9 @@ class ActivateAppInfo(TypedDict):
 已安装应用信息结构。
 
 ```python
-class InstalledAppInfo(TypedDict):
+from kuaijs._types import KuaiJSNamespace
+
+class InstalledAppInfo(KuaiJSNamespace):
     bundleVersion: str
     appName: str
     bundleIdentifier: str
@@ -42,7 +46,9 @@ class InstalledAppInfo(TypedDict):
 内存信息结构。
 
 ```python
-class MemoryInfo(TypedDict):
+from kuaijs._types import KuaiJSNamespace
+
+class MemoryInfo(KuaiJSNamespace):
     used: int            # 当前应用占用（MB）
     available: int       # 系统可用内存（MB）
     total: int           # 系统总内存（MB）

package/docs/apipython/tomatoocr.md

@@ -20,9 +20,9 @@ TomatoOCR 模块提供基于 TomatoOCR 框架的文字识别和 YOLO 目标检
 初始化结果结构。
 
 ```python
-from typing import TypedDict, Optional
+from kuaijs._types import KuaiJSNamespace
 
-class TomatoInitResult(TypedDict):
+class TomatoInitResult(KuaiJSNamespace):
     deviceId: str     # 设备 ID
     expiryTime: str   # 过期时间
     message: str      # 消息

package/docs/apipython/tts.md

@@ -6,12 +6,12 @@ TTS（文本转语音）模块提供了语音合成、播放控制等功能，
 
 ### VoiceInfo - 语音信息结构
 
-语音信息字典。
+语音信息对象。
 
 ```python
-from typing import TypedDict
+from kuaijs._types import KuaiJSNamespace
 
-class VoiceInfo(TypedDict):
+class VoiceInfo(KuaiJSNamespace):
     identifier: str # 语音的唯一标识符，用于设置特定语音
     name: str       # 语音显示名称
     language: str   # 语言代码（如 "zh-CN", "en-US"）

package/docs/apipython/yolo.md

@@ -27,12 +27,12 @@ YOLO 模块基于 YOLOV8/YOLO11/YOLO26 算法和 NCNN 框架，提供高性能
 
 ### YoloResult
 
-YOLO 检测结果字典，包含检测到的物体的完整信息。
+YOLO 检测结果对象，包含检测到的物体的完整信息。
 
 ```python
-from typing import TypedDict
+from kuaijs._types import KuaiJSNamespace
 
-class YoloResult(TypedDict):
+class YoloResult(KuaiJSNamespace):
     x: int          # 检测框的左上角x坐标
     y: int          # 检测框的左上角y坐标
     ex: int         # 检测框的右下角x坐标

package/docs/apipython/yolocls.md

@@ -20,12 +20,13 @@ YOLO 图像分类模块基于 YOLOv8-cls / YOLO11-cls / YOLO26-cls 分类模型
 
 ### YoloClsProbs
 
-YOLO 分类概率结果字典，字段命名与 Ultralytics `Probs` 保持一致。
+YOLO 分类概率结果对象，字段命名与 Ultralytics `Probs` 保持一致。
 
 ```python
-from typing import List, Optional, TypedDict
+from typing import List, Optional
+from kuaijs._types import KuaiJSNamespace
 
-class YoloClsProbs(TypedDict):
+class YoloClsProbs(KuaiJSNamespace):
     data: List[float]         # 所有类别概率，下标即类别 ID
     top1: Optional[int]       # 概率最高的类别 ID
     top5: List[int]           # 概率最高的 5 个类别 ID

package/package.json

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