ms-vite-plugin 1.4.21 → 1.4.22

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/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.21",
+  "version": "1.4.22",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {