ms-types 0.8.9 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.8.9",
+  "version": "0.9.0",
   "type": "module",
   "license": "MIT",
   "publishConfig": {

package/types/global.d.ts

@@ -161,6 +161,24 @@ declare function setAgentFastMode(enabled: boolean): boolean;
  */
 declare function getAgentFastMode(): boolean;
 
+/**
+ * 设置脚本 CPU 自动限流
+ * @param enabled 是否开启自动限流
+ * @returns 实际是否开启自动限流
+ * @description 默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险
+ * @example
+ * const enabled = setCpuAutoThrottle(true);
+ */
+declare function setCpuAutoThrottle(enabled: boolean): boolean;
+
+/**
+ * 获取脚本 CPU 自动限流当前状态，默认开启
+ * @returns 当前是否开启自动限流
+ * @example
+ * const enabled = getCpuAutoThrottle();
+ */
+declare function getCpuAutoThrottle(): boolean;
+
 /**
  * 打印调试日志 - 输出调试级别的日志
  * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪

package/types/system.d.ts

@@ -161,15 +161,16 @@ declare namespace system {
   function notify(msg: string, title?: string, id?: string): void;
   /**
    * 获取内存使用信息
-   * @returns 内存使用信息，包含已使用内存、可用内存、总内存和使用率（单位：MB）
+   * @returns 内存使用信息，包含应用占用、系统可用/总量、系统已用和系统占用率（单位：MB）
    * @example
    * const memInfo = system.getMemoryInfo()
-   * logi(`已使用: ${memInfo.used}MB, 可用: ${memInfo.available}MB, 总计: ${memInfo.total}MB, 使用率: ${memInfo.usagePercentage}%`)
+   * logi(`应用: ${memInfo.used}MB, 系统: ${memInfo.systemUsed}/${memInfo.total}MB, 占用: ${memInfo.usagePercentage}%`)
    */
   function getMemoryInfo(): {
     used: number;
     available: number;
     total: number;
+    systemUsed: number;
     usagePercentage: number;
   };
   /**
@@ -196,6 +197,22 @@ declare namespace system {
    * logi(`系统总内存: ${totalMemory}MB`)
    */
   function getTotalMemory(): number;
+  /**
+   * 获取系统已用内存
+   * @returns 系统已用内存大小（单位：MB，物理内存总量减去可用内存）
+   * @example
+   * const systemUsed = system.getSystemUsedMemory()
+   * logi(`系统已用内存: ${systemUsed}MB`)
+   */
+  function getSystemUsedMemory(): number;
+  /**
+   * 获取 CPU 使用率
+   * @returns 当前应用 CPU 使用率（百分比）
+   * @example
+   * const cpuUsage = system.getCpuUsage()
+   * logi(`CPU 使用率: ${cpuUsage}%`)
+   */
+  function getCpuUsage(): number;
 
   /**
    * 启动 Agent 服务

package/types/zh//345/205/250/345/261/200/346/250/241/345/235/227.d.ts

@@ -157,6 +157,24 @@ declare function $设置Agent快速模式(是否开启: 布尔值): 布尔值;
  */
 declare function $获取Agent快速模式(): 布尔值;
 
+/**
+ * 设置脚本 CPU 自动限流
+ * @param 是否开启 是否开启自动限流
+ * @returns 实际是否开启自动限流
+ * @description 默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险
+ * @example
+ * const 是否开启 = $设置CPU自动限流(true);
+ */
+declare function $设置CPU自动限流(是否开启: 布尔值): 布尔值;
+
+/**
+ * 获取脚本 CPU 自动限流当前状态，默认开启
+ * @returns 当前是否开启自动限流
+ * @example
+ * const 是否开启 = $获取CPU自动限流();
+ */
+declare function $获取CPU自动限流(): 布尔值;
+
 /**
  * 打印调试日志 - 输出调试级别的日志
  * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪

package/types/zh//347/263/273/347/273/237/346/250/241/345/235/227.d.ts

@@ -161,15 +161,16 @@ declare namespace $系统 {
   function 发送系统通知(消息: 字符串, 标题?: 字符串, 通知ID?: 字符串): 无返回值;
   /**
    * 获取内存使用信息
-   * @returns 内存使用信息，包含已使用内存、可用内存、总内存和使用率（单位：MB）
+   * @returns 内存使用信息，包含应用占用、系统可用/总量、系统已用和系统占用率（单位：MB）
    * @example
    * const 内存信息 = $系统.获取内存使用信息()
-   * $打印信息日志(`已使用: ${内存信息.used}MB, 可用: ${内存信息.available}MB, 总计: ${内存信息.total}MB, 使用率: ${内存信息.usagePercentage}%`)
+   * $打印信息日志(`应用: ${内存信息.used}MB, 系统: ${内存信息.systemUsed}/${内存信息.total}MB, 占用: ${内存信息.usagePercentage}%`)
    */
   function 获取内存使用信息(): {
     used: 数字;
     available: 数字;
     total: 数字;
+    systemUsed: 数字;
     usagePercentage: 数字;
   };
   /**
@@ -196,6 +197,22 @@ declare namespace $系统 {
    * $打印信息日志(`系统总内存: ${总内存}MB`)
    */
   function 获取系统总内存(): 数字;
+  /**
+   * 获取系统已用内存
+   * @returns 系统已用内存大小（单位：MB，物理内存总量减去可用内存）
+   * @example
+   * const 系统已用内存 = $系统.获取系统已用内存()
+   * $打印信息日志(`系统已用内存: ${系统已用内存}MB`)
+   */
+  function 获取系统已用内存(): 数字;
+  /**
+   * 获取 CPU 使用率
+   * @returns 当前应用 CPU 使用率（百分比）
+   * @example
+   * const CPU使用率 = $系统.获取CPU使用率()
+   * $打印信息日志(`CPU 使用率: ${CPU使用率}%`)
+   */
+  function 获取CPU使用率(): 数字;
 
   /**
    * 启动 Agent 服务