ms-types 0.8.8 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.8.8",
+  "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/pip.d.ts

@@ -1,51 +1,23 @@
 declare namespace pip {
-  interface LogViewParams {
-    /**
-     * 悬浮窗宽度，不能小于 100
-     */
-    width: number;
-    /**
-     * 悬浮窗高度，不能小于 100
-     */
-    height: number;
-    /**
-     * 日志的字体大小
-     */
-    textSize: number;
-    /**
-     * 日志的文字颜色，格式如 #FFFFFF
-     */
-    textColor: string;
-    /**
-     * 日志的背景颜色，格式如 #000000
-     */
-    backgroundColor: string;
-  }
-  /**
-   * 设置悬浮窗日志窗口的显示参数[显示日志窗口之前调用才会生效]
-   * @param params 包含显示参数的字典
-   */
-  function setLogViewParams(params: LogViewParams): void;
   /**
    * 判断悬浮窗是否打开
    * @returns true代表开启了悬浮窗，false代表没有开启
    */
   function isPipActive(): boolean;
   /**
-   * 显示日志窗口[App 必须在前台才可调用]
+   * 切换到日志模式[首次显示悬浮窗时 App 必须在前台]
    * 必须iOS设备支持悬浮窗功能，并且开启悬浮窗
-   * @returns true代表成功，false代表失败
+   * @returns true代表已提交切换请求
    */
-  function showLogWindow(): boolean;
+  function switchToLogMode(): boolean;
   /**
-   * 关闭日志窗口[App 必须在前台才可调用]
-   * @returns true代表成功，false代表失败
+   * 切换到保活模式[首次显示悬浮窗时 App 必须在前台]
+   * @returns true代表已提交切换请求
    */
-  function closeLogWindow(): boolean;
+  function switchToKeepAliveMode(): boolean;
   /**
-   * 设置是否允许悬浮窗控制脚本启停
-   * @param ctrl true代表允许，false代表不允许
-   * @returns true代表成功，false代表失败
+   * 切换到关闭模式
+   * @returns true代表已提交切换请求
    */
-  function setPipCtrlScript(ctrl: boolean): boolean;
+  function switchToOffMode(): 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//346/202/254/346/265/256/347/252/227/346/250/241/345/235/227.d.ts

@@ -1,55 +1,27 @@
 /// <reference path="全局模块.d.ts" />
 /**
- * 悬浮窗模块 包含悬浮窗日志窗口的显示、关闭、设置参数等功能
+ * 悬浮窗模块 包含悬浮窗日志窗口的显示、关闭、状态查询等功能
  */
 declare namespace $悬浮窗 {
-  interface 日志窗口参数 {
-    /**
-     * 悬浮窗宽度，不能小于 100
-     */
-    width: 数字;
-    /**
-     * 悬浮窗高度，不能小于 100
-     */
-    height: 数字;
-    /**
-     * 日志的字体大小
-     */
-    textSize: 数字;
-    /**
-     * 日志的文字颜色，格式如 #FFFFFF
-     */
-    textColor: 字符串;
-    /**
-     * 日志的背景颜色，格式如 #000000
-     */
-    backgroundColor: 字符串;
-  }
-  /**
-   * 设置悬浮窗日志窗口的显示参数[显示日志窗口之前调用才会生效]
-   * @param 参数 日志窗口参数
-   */
-  function 设置日志视图参数(参数: 日志窗口参数): 无返回值;
   /**
    * 判断悬浮窗是否打开
    * @returns true代表开启了悬浮窗，false代表没有开启
    */
   function 是否显示(): 布尔值;
   /**
-   * 显示日志窗口[App 必须在前台才可调用]
+   * 切换到日志模式[首次显示悬浮窗时 App 必须在前台]
    * 必须iOS设备支持悬浮窗功能，并且开启悬浮窗
-   * @returns true代表成功，false代表失败
+   * @returns true代表已提交切换请求
    */
-  function 显示日志窗口(): 布尔值;
+  function 切换到日志模式(): 布尔值;
   /**
-   * 关闭日志窗口[App 必须在前台才可调用]
-   * @returns true代表成功，false代表失败
+   * 切换到保活模式[首次显示悬浮窗时 App 必须在前台]
+   * @returns true代表已提交切换请求
    */
-  function 关闭日志窗口(): 布尔值;
+  function 切换到保活模式(): 布尔值;
   /**
-   * 设置是否允许悬浮窗控制脚本启停
-   * @param 是否允许 true代表允许，false代表不允许
-   * @returns true代表成功，false代表失败
+   * 切换到关闭模式
+   * @returns true代表已提交切换请求
    */
-  function 设置是否允许控制脚本启停(是否允许: 布尔值): 布尔值;
+  function 切换到关闭模式(): 布尔值;
 }

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 服务