ms-vite-plugin 1.4.9 → 1.4.10

package/dist/mcp/device-log.js

@@ -350,10 +350,9 @@ function formatRuntimeStatusEntry(entry) {
                 ? "运行中"
                 : "未运行"
             : "未知"}`,
-        `总内存: ${formatRuntimeMetricText(memory.total, " MB")}`,
-        `可用: ${formatRuntimeMetricText(memory.available, " MB")}`,
-        `已用: ${formatRuntimeMetricText(memory.used, " MB")}`,
-        `占用: ${formatRuntimeMetricText(memory.usagePercentage, "%")}`,
+        `系统: ${formatRuntimeMetricText(memory.systemUsed, " MB")}/${formatRuntimeMetricText(memory.total, " MB")}`,
+        `系统占用: ${formatRuntimeMetricText(memory.usagePercentage, "%")}`,
+        `应用: ${formatRuntimeMetricText(memory.used, " MB")}`,
     ].join(" | ");
 }
 /**

package/docs/api/global.md

@@ -342,6 +342,55 @@ if (getAgentFastMode()) {
 }
 ```
 
+### setCpuAutoThrottle
+
+设置脚本 CPU 自动限流。默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险。
+
+```typescript
+function setCpuAutoThrottle(enabled: boolean): boolean;
+```
+
+**参数:**
+
+| 参数名    | 类型      | 是否必填 | 默认值 | 描述             |
+| --------- | --------- | -------- | ------ | ---------------- |
+| `enabled` | `boolean` | 是       | -      | 是否开启自动限流 |
+
+**返回值:**
+
+| 类型      | 描述                 |
+| --------- | -------------------- |
+| `boolean` | 实际是否开启自动限流 |
+
+**示例:**
+
+```javascript
+const enabled = setCpuAutoThrottle(true);
+logi(`CPU 自动限流: ${enabled}`);
+```
+
+### getCpuAutoThrottle
+
+获取脚本 CPU 自动限流当前状态。默认开启。
+
+```typescript
+function getCpuAutoThrottle(): boolean;
+```
+
+**返回值:**
+
+| 类型      | 描述                 |
+| --------- | -------------------- |
+| `boolean` | 当前是否开启自动限流 |
+
+**示例:**
+
+```javascript
+if (getCpuAutoThrottle()) {
+  logi("CPU 自动限流已开启");
+}
+```
+
 ### setStopCallback
 
 设置停止回调函数（仅主线程调用）。

package/docs/api/ime.md

@@ -35,31 +35,6 @@ if (ime.isOk()) {
 }
 ```
 
-### autoSwitchApiKeyboard - 自动切换到 API 键盘。
-
-```typescript
-function autoSwitchApiKeyboard(): boolean;
-```
-
-**返回值：**
-
-| 类型      | 描述                                       |
-| --------- | ------------------------------------------ |
-| `boolean` | 是否成功切换并连接到 API 键盘，成功为 true |
-
-- 该方法仅在系统设置中添加了快点JS API键盘 并且已授权完全访问权限时有效。
-
-**示例：**
-
-```typescript
-// 自动切换到 API 键盘（如未弹出会尝试切换）
-if (ime.autoSwitchApiKeyboard()) {
-  logi("已切换到 API 键盘");
-} else {
-  logi("切换失败，请检查键盘设置和完全访问权限");
-}
-```
-
 ## 文本获取和清除
 
 ### getText - 获取当前输入框的文本内容。

package/docs/api/system.md

@@ -10,6 +10,7 @@
 - **URL 操作**: 打开网页链接或应用 URL Scheme
 - **系统通知**: 发送系统通知消息
 - **内存管理**: 获取内存使用信息
+- **CPU 管理**: 获取 CPU 使用率
 - **Agent 服务**: 启动 快点 Agent 服务
 
 ## API 参考
@@ -427,37 +428,35 @@ function getMemoryInfo(): {
   used: number;
   available: number;
   total: number;
+  systemUsed: number;
   usagePercentage: number;
 };
 ```
 
 **返回值:**
 
-| 类型              | 描述                   |
-| ----------------- | ---------------------- |
-| `used`            | 已使用内存（单位：MB） |
-| `available`       | 可用内存（单位：MB）   |
-| `total`           | 总内存（单位：MB）     |
-| `usagePercentage` | 内存使用率（百分比）   |
+| 类型              | 描述                         |
+| ----------------- | ---------------------------- |
+| `used`            | 当前应用占用（单位：MB）     |
+| `available`       | 系统可用内存（单位：MB）     |
+| `total`           | 系统总内存（单位：MB）       |
+| `systemUsed`      | 系统已用内存（单位：MB）     |
+| `usagePercentage` | 系统内存占用率（百分比）     |
 
 **说明:**
 
-该方法返回设备的完整内存使用信息，包括已使用内存、可用内存、总内存和使用率。
+该方法返回当前应用占用和系统内存概况。`usagePercentage` 表示系统整体占用率。
 
 **示例:**
 
 ```javascript
-// 获取完整内存信息
 const memInfo = system.getMemoryInfo();
-logi(`内存使用情况:`);
-logi(`已使用: ${memInfo.used}MB`);
-logi(`可用: ${memInfo.available}MB`);
-logi(`总计: ${memInfo.total}MB`);
-logi(`使用率: ${memInfo.usagePercentage}%`);
+logi(`应用占用: ${memInfo.used}MB`);
+logi(`系统内存: ${memInfo.systemUsed}/${memInfo.total}MB`);
+logi(`系统占用: ${memInfo.usagePercentage}%`);
 
-// 检查内存使用率
 if (memInfo.usagePercentage > 80) {
-  logw("内存使用率过高，建议清理内存");
+  logw("系统内存占用较高");
 }
 ```
 
@@ -552,6 +551,59 @@ const memoryInfo = system.getMemoryInfo();
 logi(`内存信息: 已使用 ${memoryInfo.used}MB / 总计 ${memoryInfo.total}MB`);
 ```
 
+#### getSystemUsedMemory - 获取系统已用内存。
+
+```typescript
+function getSystemUsedMemory(): number;
+```
+
+**返回值:**
+
+| 类型     | 描述                       |
+| -------- | -------------------------- |
+| `number` | 系统已用内存大小（单位：MB） |
+
+**说明:**
+
+该方法返回系统物理内存的已使用量，计算方式为系统总内存减去可用内存，与 `getMemoryInfo()` 返回的 `systemUsed` 一致。
+
+**示例:**
+
+```javascript
+// 获取系统已用内存
+const systemUsed = system.getSystemUsedMemory();
+logi(`系统已用内存: ${systemUsed}MB`);
+
+// 与 getMemoryInfo 对比
+const memoryInfo = system.getMemoryInfo();
+logi(`系统已用: ${systemUsed}MB, getMemoryInfo: ${memoryInfo.systemUsed}MB`);
+```
+
+### CPU 管理
+
+#### getCpuUsage - 获取 CPU 使用率。
+
+```typescript
+function getCpuUsage(): number;
+```
+
+**返回值:**
+
+| 类型     | 描述                         |
+| -------- | ---------------------------- |
+| `number` | 当前应用 CPU 使用率（百分比） |
+
+**示例:**
+
+```javascript
+const cpuUsage = system.getCpuUsage();
+logi(`CPU 使用率: ${cpuUsage}%`);
+
+if (cpuUsage > 80) {
+  logw("CPU 使用率较高，建议降低脚本负载");
+}
+```
+
 ### 快点 Agent 服务
 
 #### startAgent - 启动 快点 Agent 服务。

package/docs/apicn/global.md

@@ -343,6 +343,55 @@ if ($获取Agent快速模式()) {
 }
 ```
 
+### $设置CPU自动限流
+
+设置脚本 CPU 自动限流。默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险。
+
+```typescript
+declare function $设置CPU自动限流(是否开启: 布尔值): 布尔值;
+```
+
+**参数:**
+
+| 参数名     | 类型     | 是否必填 | 默认值 | 描述             |
+| ---------- | -------- | -------- | ------ | ---------------- |
+| `是否开启` | `布尔值` | 是       | -      | 是否开启自动限流 |
+
+**返回值:**
+
+| 类型     | 描述                 |
+| -------- | -------------------- |
+| `布尔值` | 实际是否开启自动限流 |
+
+**示例:**
+
+```javascript
+const 是否开启 = $设置CPU自动限流(true);
+$打印信息日志(`CPU 自动限流: ${是否开启}`);
+```
+
+### $获取CPU自动限流
+
+获取脚本 CPU 自动限流当前状态。默认开启。
+
+```typescript
+declare function $获取CPU自动限流(): 布尔值;
+```
+
+**返回值:**
+
+| 类型     | 描述                 |
+| -------- | -------------------- |
+| `布尔值` | 当前是否开启自动限流 |
+
+**示例:**
+
+```javascript
+if ($获取CPU自动限流()) {
+  $打印信息日志("CPU 自动限流已开启");
+}
+```
+
 ### $设置停止回调
 
 设置停止回调函数（仅主线程调用）。

package/docs/apicn/ime.md

@@ -35,31 +35,6 @@ if ($输入法.是否可用()) {
 }
 ```
 
-### 自动切换到API键盘 - 自动切换到 API 键盘。
-
-```typescript
-function 自动切换到API键盘(): 布尔值;
-```
-
-**返回值：**
-
-| 类型     | 描述                                       |
-| -------- | ------------------------------------------ |
-| `布尔值` | 是否成功切换并连接到 API 键盘，成功为 true |
-
-- 该方法仅在系统设置中添加了快点JS API键盘 并且已授权完全访问权限时有效。
-
-**示例：**
-
-```typescript
-// 自动切换到 API 键盘（如未弹出会尝试切换）
-if ($输入法.自动切换到API键盘()) {
-  $打印信息日志("已切换到 API 键盘");
-} else {
-  $打印信息日志("切换失败，请检查键盘设置和完全访问权限");
-}
-```
-
 ## 文本获取和清除
 
 ### 获取文本 - 获取当前输入框的文本内容。

package/docs/apicn/system.md

@@ -10,6 +10,7 @@
 - **URL 操作**: 打开网页链接或应用 URL Scheme
 - **系统通知**: 发送系统通知消息
 - **内存管理**: 获取内存使用信息
+- **CPU 管理**: 获取 CPU 使用率
 - **快点 Agent 服务**: 启动 Agent 服务
 
 ## API 参考
@@ -427,37 +428,35 @@ function 获取内存使用信息(): {
   used: 数字;
   available: 数字;
   total: 数字;
+  systemUsed: 数字;
   usagePercentage: 数字;
 };
 ```
 
 **返回值:**
 
-| 参数名            | 类型 | 描述                   |
-| ----------------- | ---- | ---------------------- |
-| `used`            | 数字 | 已使用内存（单位：MB） |
-| `available`       | 数字 | 可用内存（单位：MB）   |
-| `total`           | 数字 | 总内存（单位：MB）     |
-| `usagePercentage` | 数字 | 内存使用率（百分比）   |
+| 参数名            | 类型 | 描述                         |
+| ----------------- | ---- | ---------------------------- |
+| `used`            | 数字 | 当前应用占用（单位：MB）     |
+| `available`       | 数字 | 系统可用内存（单位：MB）     |
+| `total`           | 数字 | 系统总内存（单位：MB）       |
+| `systemUsed`      | 数字 | 系统已用内存（单位：MB）     |
+| `usagePercentage` | 数字 | 系统内存占用率（百分比）     |
 
 **说明:**
 
-该方法返回设备的完整内存使用信息，包括已使用内存、可用内存、总内存和使用率。
+该方法返回当前应用占用和系统内存概况。`usagePercentage` 表示系统整体占用率。
 
 **示例:**
 
 ```javascript
-// 获取完整内存信息
 const memInfo = $系统.获取内存使用信息();
-$打印信息日志(`内存使用情况:`);
-$打印信息日志(`已使用: ${memInfo.used}MB`);
-$打印信息日志(`可用: ${memInfo.available}MB`);
-$打印信息日志(`总计: ${memInfo.total}MB`);
-$打印信息日志(`使用率: ${memInfo.usagePercentage}%`);
+$打印信息日志(`应用占用: ${memInfo.used}MB`);
+$打印信息日志(`系统内存: ${memInfo.systemUsed}/${memInfo.total}MB`);
+$打印信息日志(`系统占用: ${memInfo.usagePercentage}%`);
 
-// 检查内存使用率
 if (memInfo.usagePercentage > 80) {
-  $打印警告日志("内存使用率过高，建议清理内存");
+  $打印警告日志("系统内存占用较高");
 }
 ```
 
@@ -554,6 +553,61 @@ $打印信息日志(
 );
 ```
 
+#### 获取系统已用内存 - 获取系统物理内存已使用量。
+
+```typescript
+function 获取系统已用内存(): 数字;
+```
+
+**返回值:**
+
+| 参数名       | 类型 | 描述                       |
+| ------------ | ---- | -------------------------- |
+| `systemUsed` | 数字 | 系统已用内存大小（单位：MB） |
+
+**说明:**
+
+该方法返回系统物理内存的已使用量，计算方式为系统总内存减去可用内存，与 `获取内存使用信息()` 返回的 `systemUsed` 一致。
+
+**示例:**
+
+```javascript
+// 获取系统已用内存
+const 系统已用内存 = $系统.获取系统已用内存();
+$打印信息日志(`系统已用内存: ${系统已用内存}MB`);
+
+// 与 获取内存使用信息 对比
+const 内存信息 = $系统.获取内存使用信息();
+$打印信息日志(
+  `系统已用: ${系统已用内存}MB, 内存信息: ${内存信息.systemUsed}MB`,
+);
+```
+
+### CPU 管理
+
+#### 获取CPU使用率 - 获取 CPU 使用率。
+
+```typescript
+function 获取CPU使用率(): 数字;
+```
+
+**返回值:**
+
+| 类型   | 描述                         |
+| ------ | ---------------------------- |
+| `数字` | 当前应用 CPU 使用率（百分比） |
+
+**示例:**
+
+```javascript
+const CPU使用率 = $系统.获取CPU使用率();
+$打印信息日志(`CPU 使用率: ${CPU使用率}%`);
+
+if (CPU使用率 > 80) {
+  $打印警告日志("CPU 使用率较高，建议降低脚本负载");
+}
+```
+
 ### 快点 Agent 服务
 
 #### 启动 快点 Agent 服务

package/docs/apipython/g.md

@@ -101,6 +101,58 @@ if g.getAgentFastMode():
     print("Agent 快速模式已开启")
 ```
 
+#### `setCpuAutoThrottle` - 设置脚本 CPU 自动限流
+
+默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险。
+
+```python
+def setCpuAutoThrottle(enabled: bool) -> bool
+```
+
+**参数:**
+
+| 参数名    | 类型   | 是否必填 | 默认值 | 描述             |
+| --------- | ------ | -------- | ------ | ---------------- |
+| `enabled` | `bool` | 是       | -      | 是否开启自动限流 |
+
+**返回值:**
+
+| 类型   | 描述                 |
+| ------ | -------------------- |
+| `bool` | 实际是否开启自动限流 |
+
+**示例:**
+
+```python
+from kuaijs import g
+
+enabled = g.setCpuAutoThrottle(True)
+print(f"CPU 自动限流: {enabled}")
+```
+
+#### `getCpuAutoThrottle` - 获取脚本 CPU 自动限流
+
+默认开启。
+
+```python
+def getCpuAutoThrottle() -> bool
+```
+
+**返回值:**
+
+| 类型   | 描述                 |
+| ------ | -------------------- |
+| `bool` | 当前是否开启自动限流 |
+
+**示例:**
+
+```python
+from kuaijs import g
+
+if g.getCpuAutoThrottle():
+    print("CPU 自动限流已开启")
+```
+
 #### `restartScript` - 重启脚本
 
 ```python

package/docs/apipython/ime.md

@@ -36,32 +36,6 @@ else:
     # 可能需要重新初始化或检查权限
 ```
 
-### autoSwitchApiKeyboard - 自动切换到 API 键盘
-
-```python
-def autoSwitchApiKeyboard() -> bool
-```
-
-**返回值：**
-
-| 类型   | 描述                                       |
-| ------ | ------------------------------------------ |
-| `bool` | 是否成功切换并连接到 API 键盘，成功为 True |
-
-- 该方法仅在系统设置中添加了快点JS API键盘 并且已授权完全访问权限时有效。
-
-**示例：**
-
-```python
-from kuaijs import ime
-
-# 自动切换到 API 键盘（如未弹出会尝试切换）
-if ime.autoSwitchApiKeyboard():
-    print("已切换到 API 键盘")
-else:
-    print("切换失败，请检查键盘设置和完全访问权限")
-```
-
 ## 文本获取和清除
 
 ### getText - 获取当前输入框的文本内容

package/docs/apipython/system.md

@@ -10,6 +10,7 @@
 - **URL 操作**: 打开网页链接或应用 URL Scheme
 - **系统通知**: 发送系统通知消息
 - **内存管理**: 获取内存使用信息
+- **CPU 管理**: 获取 CPU 使用率
 - **快点 Agent 服务**: 启动 快点 Agent 服务
 
 ## 类型定义
@@ -42,10 +43,11 @@ class InstalledAppInfo(TypedDict):
 
 ```python
 class MemoryInfo(TypedDict):
-    used: int            # 已使用内存（MB）
-    available: int       # 可用内存（MB）
-    total: int           # 总内存（MB）
-    usagePercentage: float # 内存使用率（百分比）
+    used: int            # 当前应用占用（MB）
+    available: int       # 系统可用内存（MB）
+    total: int           # 系统总内存（MB）
+    systemUsed: int      # 系统已用内存（MB）
+    usagePercentage: float # 系统占用率（百分比）
 ```
 
 ## API 参考
@@ -387,25 +389,26 @@ def getMemoryInfo() -> MemoryInfo
 
 **返回值:**
 | 类型 | 描述 |
-| ----------------- | ---------------------- |
-| `used` | 已使用内存（单位：MB） |
-| `available` | 可用内存（单位：MB） |
-| `total` | 总内存（单位：MB） |
-| `usagePercentage` | 内存使用率（百分比） |
+| ----------------- | ---------------------------- |
+| `used` | 当前应用占用（单位：MB） |
+| `available` | 系统可用内存（单位：MB） |
+| `total` | 系统总内存（单位：MB） |
+| `systemUsed` | 系统已用内存（单位：MB） |
+| `usagePercentage` | 系统内存占用率（百分比） |
 
 **说明:**
 
-该方法返回设备的完整内存使用信息，包括已使用内存、可用内存、总内存和使用率。
+该方法返回当前应用占用和系统内存概况。`usagePercentage` 表示系统整体占用率。
 
 **示例:**
 
 ```python
 from kuaijs import system
 mem = system.getMemoryInfo()
-print(mem.used, mem.available, mem.total, mem.usagePercentage)
+print(f"应用: {mem.used}MB, 系统: {mem.systemUsed}/{mem.total}MB, 占用: {mem.usagePercentage}%")
 
 if mem.usagePercentage > 80:
-    print("内存使用率过高，建议清理内存")
+    print("系统内存占用较高")
 ```
 
 #### getUsedMemory - 获取已使用内存。
@@ -465,6 +468,58 @@ usage = (used / total) * 100 if total else 0
 print(f"使用率: {usage:.1f}%")
 ```
 
+#### getSystemUsedMemory - 获取系统已用内存。
+
+```python
+def getSystemUsedMemory() -> int
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ------------ |
+| `int`| 系统已用内存（MB） |
+
+**说明:**
+
+该方法返回系统物理内存的已使用量，计算方式为系统总内存减去可用内存，与 `getMemoryInfo()` 返回的 `systemUsed` 一致。
+
+**示例：**
+
+```python
+from kuaijs import system
+
+system_used = system.getSystemUsedMemory()
+print(f"系统已用内存: {system_used}MB")
+
+mem = system.getMemoryInfo()
+print(f"getMemoryInfo systemUsed: {mem['systemUsed']}MB")
+```
+
+### CPU 管理
+
+#### getCpuUsage - 获取 CPU 使用率。
+
+```python
+def getCpuUsage() -> float
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| `float` | 当前应用 CPU 使用率（百分比） |
+
+**示例:**
+
+```python
+from kuaijs import system
+
+cpu_usage = system.getCpuUsage()
+print(f"CPU 使用率: {cpu_usage}%")
+
+if cpu_usage > 80:
+    print("CPU 使用率较高，建议降低脚本负载")
+```
+
 ### 快点 Agent 服务
 
 #### startAgent - 启动 快点 Agent 服务。

package/package.json

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