@ray-js/api 1.7.81 → 1.7.82

package/@types/HealthKit.d.ts

@@ -1,11 +1,11 @@
 /**
  * HealthKit
  *
- * @version 7.2.2
+ * @version 7.9.4
  */
 declare namespace ty.health {
   /**
-   * health connect sdk状态获取[Android only]
+   * 获取 Health Connect SDK 可用与授权状态 [Android only]
    * @public
    * @since HealthKit 5.18.0
    * @platform Android
@@ -32,7 +32,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * health connect sdk状态获取[Android only]
+   * 获取 Health Connect SDK 可用与授权状态 [Android only]
    * @public
    * @since HealthKit 5.18.0
    * @platform Android
@@ -40,12 +40,7 @@ declare namespace ty.health {
   export function getHealthConnectStatusSync(): number
 
   /**
-   * 检测health connect读取权限[Android only]
-   * -2   服务不可用（需要提示用户去更改自启动和电源管理），建议面板收到-2直接跳转到授权页。授权页做弹窗提示
-   * -1   Health Connect不支持
-   * 0    已授权
-   * 1    未安装 Health Connect
-   * 2    未授权
+   * 检测 Health Connect 读取权限状态 [Android only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -72,12 +67,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 检测health connect读取权限[Android only]
-   * -2   服务不可用（需要提示用户去更改自启动和电源管理），建议面板收到-2直接跳转到授权页。授权页做弹窗提示
-   * -1   Health Connect不支持
-   * 0    已授权
-   * 1    未安装 Health Connect
-   * 2    未授权
+   * 检测 Health Connect 读取权限状态 [Android only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -85,15 +75,15 @@ declare namespace ty.health {
   export function checkHealthConnectReadStatusSync(): number
 
   /**
-   * 数据同步到health connect [Android only]
+   * 将健康记录批量写入 Health Connect [Android only]
    * @public
    * @since HealthKit 5.18.0
    * @platform Android
-   * @error {-1001} phone is not support
-   * @error {-1002} data conversion error
-   * @error {-1003} data is null
-   * @error {-1004} error when commit to Health Connect
-   * @error {-1005} service error,please check if Health Connect is set to auto-start and if power management has no restrictions
+   * @error {-1001} 手机版本不支持
+   * @error {-1002} 数据转换异常
+   * @error {-1003} 数据为空
+   * @error {-1004} 提交 Health Connect 失败
+   * @error {-1005} 服务异常，请检查 Health Connect 是否已开启自启动且电源管理无限制
    */
   export function insertRecords(params: {
     /**
@@ -122,20 +112,20 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 数据同步到health connect [Android only]
+   * 将健康记录批量写入 Health Connect [Android only]
    * @public
    * @since HealthKit 5.18.0
    * @platform Android
-   * @error {-1001} phone is not support
-   * @error {-1002} data conversion error
-   * @error {-1003} data is null
-   * @error {-1004} error when commit to Health Connect
-   * @error {-1005} service error,please check if Health Connect is set to auto-start and if power management has no restrictions
+   * @error {-1001} 手机版本不支持
+   * @error {-1002} 数据转换异常
+   * @error {-1003} 数据为空
+   * @error {-1004} 提交 Health Connect 失败
+   * @error {-1005} 服务异常，请检查 Health Connect 是否已开启自启动且电源管理无限制
    */
   export function insertRecordsSync(request?: RecordParams): boolean
 
   /**
-   * 读取health connect数据 [Android And iOS]
+   * 按条件查询 Health Connect 健康记录 [Android only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -193,7 +183,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 读取health connect数据 [Android And iOS]
+   * 按条件查询 Health Connect 健康记录 [Android only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -212,8 +202,7 @@ declare namespace ty.health {
   }
 
   /**
-   * 用户是否已经做过授权操作(针对Quantity类型数据)[iOS only]
-   * 需要参数为readPermissions,writePermissions
+   * 查询用户是否已对 Quantity 类型数据完成读写授权 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -244,7 +233,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -274,8 +263,7 @@ declare namespace ty.health {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * 1 代表传入的类型都申请过对应的读写权限
-       * 0 代表传入的类型至少有一个没有请求过对应的读写权限
+       * 授权状态：1 表示传入类型均已申请过对应读写权限；0 表示至少有一项未申请
        * @since HealthKit 5.18.4
        */
       value: number
@@ -297,8 +285,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 用户是否已经做过授权操作(针对Quantity类型数据)[iOS only]
-   * 需要参数为readPermissions,writePermissions
+   * 查询用户是否已对 Quantity 类型数据完成读写授权 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -306,16 +293,14 @@ declare namespace ty.health {
    */
   export function authStatusPermissionsSync(paramModel?: ParamModel): {
     /**
-     * 1 代表传入的类型都申请过对应的读写权限
-     * 0 代表传入的类型至少有一个没有请求过对应的读写权限
+     * 授权状态：1 表示传入类型均已申请过对应读写权限；0 表示至少有一项未申请
      * @since HealthKit 5.18.4
      */
     value: number
   }
 
   /**
-   * 用户是否有Quantity类型数据写入权限[iOS only]
-   * 需要参数为writePermission
+   * 查询用户是否拥有指定 Quantity 类型的写入权限 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -346,7 +331,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -376,8 +361,7 @@ declare namespace ty.health {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * 1 有写入权限
-       * 0 无写入权限
+       * 写入权限状态：1 有写入权限；0 无写入权限
        * @since HealthKit 5.18.4
        */
       value: number
@@ -399,8 +383,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 用户是否有Quantity类型数据写入权限[iOS only]
-   * 需要参数为writePermission
+   * 查询用户是否拥有指定 Quantity 类型的写入权限 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -408,16 +391,14 @@ declare namespace ty.health {
    */
   export function getSaveQuantityPermissionSync(paramModel?: ParamModel): {
     /**
-     * 1 有写入权限
-     * 0 无写入权限
+     * 写入权限状态：1 有写入权限；0 无写入权限
      * @since HealthKit 5.18.4
      */
     value: number
   }
 
   /**
-   * Quantity写入权限申请接口[iOS only]
-   * 需要参数为permissions
+   * 申请 Quantity 类型数据的写入权限 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -448,7 +429,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -476,7 +457,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -494,8 +475,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Quantity写入权限申请接口[iOS only]
-   * 需要参数为permissions
+   * 申请 Quantity 类型数据的写入权限 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -506,8 +486,7 @@ declare namespace ty.health {
   ): null
 
   /**
-   * Category写入权限申请接口[iOS only]
-   * 需要参数为permissions
+   * 申请 Category 类型数据的写入权限 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -538,7 +517,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -566,7 +545,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -584,8 +563,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Category写入权限申请接口[iOS only]
-   * 需要参数为permissions
+   * 申请 Category 类型数据的写入权限 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -596,8 +574,7 @@ declare namespace ty.health {
   ): null
 
   /**
-   * Quantity读取权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Quantity 类型数据的读取权限 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -628,7 +605,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -656,7 +633,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -674,8 +651,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Quantity读取权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Quantity 类型数据的读取权限 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -684,8 +660,7 @@ declare namespace ty.health {
   export function authQuantityReadPermissionsSync(paramModel?: ParamModel): null
 
   /**
-   * Category 读取权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Category 类型数据的读取权限 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -716,7 +691,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -744,7 +719,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -762,8 +737,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Category 读取权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Category 类型数据的读取权限 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -772,8 +746,7 @@ declare namespace ty.health {
   export function authCategoryReadPermissionsSync(paramModel?: ParamModel): null
 
   /**
-   * Characteristic 读取权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Characteristic 类型数据的读取权限 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -804,7 +777,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -832,7 +805,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -850,8 +823,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Characteristic 读取权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Characteristic 类型数据的读取权限 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -862,8 +834,7 @@ declare namespace ty.health {
   ): null
 
   /**
-   * Quantity Category Characteristic 读取权限申请[iOS only]
-   * 需要参数为permissions
+   * 批量申请 Quantity、Category、Characteristic 的读取权限 [iOS only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -871,29 +842,29 @@ declare namespace ty.health {
    */
   export function authiOSAllReadPermissions(params: {
     /**
-     * quantity类型的参数
+     * Quantity 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     quantityParam?: ParamModel
     /**
-     * category类型的参数
+     * Category 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     categoryParam?: ParamModel
     /**
-     * characteristic类型的参数
+     * Characteristic 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     characteristicParam?: ParamModel
     /**
-     * 运动记录
+     * 是否包含运动记录（Workout）相关权限或数据
      * @since HealthKit 7.1.5
      */
     workoutType: boolean
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -911,8 +882,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Quantity Category Characteristic 读取权限申请[iOS only]
-   * 需要参数为permissions
+   * 批量申请 Quantity、Category、Characteristic 的读取权限 [iOS only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -923,8 +893,7 @@ declare namespace ty.health {
   ): null
 
   /**
-   * Quantity Category Characteristic 查看读取权限[iOS only]
-   * 需要参数为permissions
+   * 批量查询 Quantity、Category、Characteristic 是否已完成读取授权 [iOS only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -932,22 +901,22 @@ declare namespace ty.health {
    */
   export function authiOSAllStatuPermissions(params: {
     /**
-     * quantity类型的参数
+     * Quantity 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     quantityParam?: ParamModel
     /**
-     * category类型的参数
+     * Category 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     categoryParam?: ParamModel
     /**
-     * characteristic类型的参数
+     * Characteristic 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     characteristicParam?: ParamModel
     /**
-     * 运动记录
+     * 是否包含运动记录（Workout）相关权限或数据
      * @since HealthKit 7.1.5
      */
     workoutType: boolean
@@ -956,8 +925,7 @@ declare namespace ty.health {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * 1 代表传入的类型都申请过对应的读写权限
-       * 0 代表传入的类型至少有一个没有请求过对应的读写权限
+       * 授权状态：1 表示传入类型均已申请过对应读写权限；0 表示至少有一项未申请
        * @since HealthKit 7.1.5
        */
       value: number
@@ -979,8 +947,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Quantity Category Characteristic 查看读取权限[iOS only]
-   * 需要参数为permissions
+   * 批量查询 Quantity、Category、Characteristic 是否已完成读取授权 [iOS only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -988,16 +955,14 @@ declare namespace ty.health {
    */
   export function authiOSAllStatuPermissionsSync(paramModel?: IOSParamModel): {
     /**
-     * 1 代表传入的类型都申请过对应的读写权限
-     * 0 代表传入的类型至少有一个没有请求过对应的读写权限
+     * 授权状态：1 表示传入类型均已申请过对应读写权限；0 表示至少有一项未申请
      * @since HealthKit 7.1.5
      */
     value: number
   }
 
   /**
-   * Quantity Category Characteristic 写入数据到iOS HealthKit [iOS only]
-   * 需要参数为permissions
+   * 将健康记录批量写入 iOS HealthKit [iOS only]
    * @public
    * @since HealthKit 7.1.5
    * @platform iOS
@@ -1030,8 +995,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Quantity Category Characteristic 写入数据到iOS HealthKit [iOS only]
-   * 需要参数为permissions
+   * 将健康记录批量写入 iOS HealthKit [iOS only]
    * @public
    * @since HealthKit 7.1.5
    * @platform iOS
@@ -1040,8 +1004,7 @@ declare namespace ty.health {
   export function insertiOSRecordsSync(request?: RecordIOSParams): boolean
 
   /**
-   * Quantity读写权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Quantity 类型数据的读写权限 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1072,7 +1035,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1100,7 +1063,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1118,8 +1081,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Quantity读写权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Quantity 类型数据的读写权限 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1128,8 +1090,7 @@ declare namespace ty.health {
   export function authQuantityRWPermissionsSync(paramModel?: ParamModel): null
 
   /**
-   * Category 读写权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Category 类型数据的读写权限 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1160,7 +1121,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1188,7 +1149,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1206,8 +1167,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * Category 读写权限申请[iOS only]
-   * 需要参数为permissions
+   * 申请 Category 类型数据的读写权限 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1216,8 +1176,7 @@ declare namespace ty.health {
   export function authCategoryRWPermissionsSync(paramModel?: ParamModel): null
 
   /**
-   * 写入Quantity类型的数据[iOS only]
-   * 需要参数为value,type,unitType,startTime,endTime
+   * 写入 Quantity 类型健康数据（含起止时间） [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1249,7 +1208,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1277,7 +1236,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1295,8 +1254,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 写入Quantity类型的数据[iOS only]
-   * 需要参数为value,type,unitType,startTime,endTime
+   * 写入 Quantity 类型健康数据（含起止时间） [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1306,8 +1264,7 @@ declare namespace ty.health {
   export function saveQuantityDataSync(paramModel?: ParamModel): null
 
   /**
-   * 写入Quantity类型的数据,不用传时间，开始时间和结束时间默认设置为当前时间[iOS only]
-   * 需要参数为value,type,unitType
+   * 写入 Quantity 类型健康数据（不传时间，起止时间默认为当前时刻） [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1339,7 +1296,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1367,7 +1324,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1385,8 +1342,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 写入Quantity类型的数据,不用传时间，开始时间和结束时间默认设置为当前时间[iOS only]
-   * 需要参数为value,type,unitType
+   * 写入 Quantity 类型健康数据（不传时间，起止时间默认为当前时刻） [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1396,7 +1352,7 @@ declare namespace ty.health {
   export function saveQuantityNoTimeWithDataSync(paramModel?: ParamModel): null
 
   /**
-   * 写入血压数据[iOS only]
+   * 写入血压数据（收缩压、舒张压及起止时间） [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1427,7 +1383,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1445,7 +1401,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 写入血压数据[iOS only]
+   * 写入血压数据（收缩压、舒张压及起止时间） [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1457,8 +1413,7 @@ declare namespace ty.health {
   ): null
 
   /**
-   * 读取 Quantity[iOS only]
-   * 需要参数为type,unitType,startTime,endTime
+   * 按类型与时间范围读取 Quantity 健康数据 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1489,7 +1444,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1525,7 +1480,7 @@ declare namespace ty.health {
        * endDate: Double 读取到的条目的截止时间戳
        * @since HealthKit 5.18.4
        */
-      value: Object[]
+      value: Record<string, any>[]
     }) => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
@@ -1544,8 +1499,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 读取 Quantity[iOS only]
-   * 需要参数为type,unitType,startTime,endTime
+   * 按类型与时间范围读取 Quantity 健康数据 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1559,12 +1513,11 @@ declare namespace ty.health {
      * endDate: Double 读取到的条目的截止时间戳
      * @since HealthKit 5.18.4
      */
-    value: Object[]
+    value: Record<string, any>[]
   }
 
   /**
-   * 删除QuantityData数据,基于起止时间删除[iOS only]
-   * 需要参数为type,startTime,endTime
+   * 按类型与时间范围删除 Quantity 健康数据 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1596,7 +1549,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1624,7 +1577,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1642,8 +1595,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 删除QuantityData数据,基于起止时间删除[iOS only]
-   * 需要参数为type,startTime,endTime
+   * 按类型与时间范围删除 Quantity 健康数据 [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1653,8 +1605,7 @@ declare namespace ty.health {
   export function deleteQuantityDataTypeSync(paramModel?: ParamModel): null
 
   /**
-   * 读取 Characteristic[iOS only]
-   * 需要参数为type
+   * 按类型读取 Characteristic 健康数据 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1685,7 +1636,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1721,7 +1672,7 @@ declare namespace ty.health {
        * endDate: Double 读取到的条目的截止时间戳
        * @since HealthKit 5.18.4
        */
-      value: Object[]
+      value: Record<string, any>[]
     }) => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
@@ -1740,8 +1691,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 读取 Characteristic[iOS only]
-   * 需要参数为type
+   * 按类型读取 Characteristic 健康数据 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1755,13 +1705,11 @@ declare namespace ty.health {
      * endDate: Double 读取到的条目的截止时间戳
      * @since HealthKit 5.18.4
      */
-    value: Object[]
+    value: Record<string, any>[]
   }
 
   /**
-   * 写入Category类型的数据[iOS only]
-   * 需要参数为value,type,startTime,endTime
-   * Category类型数据的写入参考苹果官方文档的定义
+   * 写入 Category 类型健康数据（含起止时间） [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1793,7 +1741,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1821,7 +1769,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1839,9 +1787,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 写入Category类型的数据[iOS only]
-   * 需要参数为value,type,startTime,endTime
-   * Category类型数据的写入参考苹果官方文档的定义
+   * 写入 Category 类型健康数据（含起止时间） [iOS only]
    * @public
    * @since HealthKit 5.18.3
    * @platform iOS
@@ -1851,8 +1797,7 @@ declare namespace ty.health {
   export function saveCategoryDataSync(paramModel?: ParamModel): null
 
   /**
-   * 写入Category类型的数据,不用传时间，开始时间和结束时间默认设置为当前时间[iOS only]
-   * 需要参数为value,type
+   * 写入 Category 类型健康数据（不传时间，起止时间默认为当前时刻） [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1884,7 +1829,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -1912,7 +1857,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1930,8 +1875,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 写入Category类型的数据,不用传时间，开始时间和结束时间默认设置为当前时间[iOS only]
-   * 需要参数为value,type
+   * 写入 Category 类型健康数据（不传时间，起止时间默认为当前时刻） [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1941,8 +1885,7 @@ declare namespace ty.health {
   export function saveCategoryNoTimeWithDataSync(paramModel?: ParamModel): null
 
   /**
-   * 读取 Category类型的数据[iOS only]
-   * 需要参数为type,startTime,endTime
+   * 按类型与时间范围读取 Category 健康数据 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -1973,7 +1916,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -2009,7 +1952,7 @@ declare namespace ty.health {
        * endDate: Double 读取到的条目的截止时间戳
        * @since HealthKit 5.18.4
        */
-      value: Object[]
+      value: Record<string, any>[]
     }) => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
@@ -2028,8 +1971,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 读取 Category类型的数据[iOS only]
-   * 需要参数为type,startTime,endTime
+   * 按类型与时间范围读取 Category 健康数据 [iOS only]
    * @public
    * @since HealthKit 5.18.0
    * @platform iOS
@@ -2043,44 +1985,44 @@ declare namespace ty.health {
      * endDate: Double 读取到的条目的截止时间戳
      * @since HealthKit 5.18.4
      */
-    value: Object[]
+    value: Record<string, any>[]
   }
 
   /**
-   * 获取体脂秤算法数据
+   * 根据体脂秤测量数据计算身体成分指标 [Android only]
    * @public
-   * @since HealthKit 5.18.6
+   * @since HealthKit 6.5.0
    * @platform Android
    */
   export function queryBodyFatScaleAlgorithm(params: {
     /**
-     * 性别（1-男、2-女）
-     * @since HealthKit 5.18.6
+     * 性别：1 男，2 女
+     * @since HealthKit 6.5.0
      */
     sex: number
     /**
      * 体重（单位kg）
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     weight: number
     /**
      * 阻抗
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     imp: number
     /**
      * 身高（单位cm）
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     height: number
     /**
      * 生日（13位、毫秒）
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     birthday: number
     /**
      * 测量时间（13位、毫秒）
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     time: number
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -2089,92 +2031,92 @@ declare namespace ty.health {
     success?: (params: {
       /**
        * bmi
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       bmi: string
       /**
        * 体脂率
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       fat: string
       /**
        * 水份率
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       water: string
       /**
        * 肌肉量
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       muscle: string
       /**
        * 蛋白率
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       protein: string
       /**
        * 骨量
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       bones: string
       /**
        * 基础代谢率
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       metabolism: string
       /**
        * 身体年龄
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       bodyAge: string
       /**
        * 身体得分
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       bodyScore: string
       /**
        * 内脂肪等级
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       visceralFat: string
       /**
        * 体型
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       bodyType: string
       /**
        * 去脂指数
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       ffm: string
       /**
        * 脂肪量
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       fatMass: string
       /**
        * 体脂指数
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       bodyFatIndex: string
       /**
        * 肥胖等级
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       fatLevel: string
       /**
        * 标准体重
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       standardWeight: string
       /**
        * 体重控制
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       weightControl: string
       /**
        * 肌肉率
-       * @since HealthKit 5.18.6
+       * @since HealthKit 6.5.0
        */
       muscleRatio: string
     }) => void
@@ -2195,106 +2137,106 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 获取体脂秤算法数据
+   * 根据体脂秤测量数据计算身体成分指标 [Android only]
    * @public
-   * @since HealthKit 5.18.6
+   * @since HealthKit 6.5.0
    * @platform Android
    */
   export function queryBodyFatScaleAlgorithmSync(request?: BodyScaleParam): {
     /**
      * bmi
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bmi: string
     /**
      * 体脂率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     fat: string
     /**
      * 水份率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     water: string
     /**
      * 肌肉量
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     muscle: string
     /**
      * 蛋白率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     protein: string
     /**
      * 骨量
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bones: string
     /**
      * 基础代谢率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     metabolism: string
     /**
      * 身体年龄
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bodyAge: string
     /**
      * 身体得分
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bodyScore: string
     /**
      * 内脂肪等级
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     visceralFat: string
     /**
      * 体型
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bodyType: string
     /**
      * 去脂指数
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     ffm: string
     /**
      * 脂肪量
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     fatMass: string
     /**
      * 体脂指数
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bodyFatIndex: string
     /**
      * 肥胖等级
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     fatLevel: string
     /**
      * 标准体重
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     standardWeight: string
     /**
      * 体重控制
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     weightControl: string
     /**
      * 肌肉率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     muscleRatio: string
   }
 
   /**
-   * 是否健康本地化数据设备
+   * 判断设备是否为健康本地化数据设备 [Android only]
    * @public
    * @since HealthKit 7.0.5
    * @platform Android
@@ -2332,7 +2274,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 是否健康本地化数据设备
+   * 判断设备是否为健康本地化数据设备 [Android only]
    * @public
    * @since HealthKit 7.0.5
    * @platform Android
@@ -2346,7 +2288,7 @@ declare namespace ty.health {
   }
 
   /**
-   * 健康本地化数据设备 - Post大数据通道数据
+   * 向本地化数据设备提交大数据通道数据 [Android only]
    * @public
    * @since HealthKit 7.0.5
    * @platform Android
@@ -2365,7 +2307,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2383,7 +2325,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 健康本地化数据设备 - Post大数据通道数据
+   * 向本地化数据设备提交大数据通道数据 [Android only]
    * @public
    * @since HealthKit 7.0.5
    * @platform Android
@@ -2393,7 +2335,7 @@ declare namespace ty.health {
   ): null
 
   /**
-   * 健康本地化数据设备 - 获取当前数据库版本号
+   * 获取健康本地化数据库当前版本号 [Android only]
    * @public
    * @since HealthKit 7.0.5
    * @platform Android
@@ -2426,7 +2368,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 健康本地化数据设备 - 获取当前数据库版本号
+   * 获取健康本地化数据库当前版本号 [Android only]
    * @public
    * @since HealthKit 7.0.5
    * @platform Android
@@ -2440,7 +2382,7 @@ declare namespace ty.health {
   }
 
   /**
-   * 健康本地化数据库信息获取和存储逻辑
+   * 健康本地化数据库的统一读写接口（按 apiName 路由） [Android only]
    * @public
    * @since HealthKit 7.0.5
    * @platform Android
@@ -2461,7 +2403,7 @@ declare namespace ty.health {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * 返回结果
+       * 业务返回数据（JSON 字符串，具体结构由 apiName 决定）
        * @since HealthKit 7.0.5
        */
       result: string
@@ -2483,21 +2425,21 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 健康本地化数据库信息获取和存储逻辑
+   * 健康本地化数据库的统一读写接口（按 apiName 路由） [Android only]
    * @public
    * @since HealthKit 7.0.5
    * @platform Android
    */
   export function requestLocalDataApiSync(param?: HealthDataLocalParams): {
     /**
-     * 返回结果
+     * 业务返回数据（JSON 字符串，具体结构由 apiName 决定）
      * @since HealthKit 7.0.5
      */
     result: string
   }
 
   /**
-   * 健康AI小程序本地化数据库初始化逻辑
+   * 初始化健康 AI 小程序本地化数据库 [Android only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -2506,7 +2448,7 @@ declare namespace ty.health {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2524,7 +2466,7 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 健康AI小程序本地化数据库初始化逻辑
+   * 初始化健康 AI 小程序本地化数据库 [Android only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -2532,7 +2474,7 @@ declare namespace ty.health {
   export function aiHealthInitSync(): null
 
   /**
-   * 健康AI小程序本地化数据库信息获取和存储逻辑
+   * 健康 AI 小程序本地化数据库的统一读写接口（按 apiName 路由） [Android only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
@@ -2553,17 +2495,17 @@ declare namespace ty.health {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * 返回结果
+       * 业务返回数据（JSON 字符串，具体结构由 apiName 决定）
        * @since HealthKit 7.1.5
        */
       result?: string
       /**
-       * 时间戳
+       * 响应时间戳（毫秒）
        * @since HealthKit 7.1.5
        */
       t: number
       /**
-       * 是否成功
+       * 接口调用是否成功
        * @since HealthKit 7.1.5
        */
       success: boolean
@@ -2585,31 +2527,225 @@ declare namespace ty.health {
   }): void
 
   /**
-   * 健康AI小程序本地化数据库信息获取和存储逻辑
+   * 健康 AI 小程序本地化数据库的统一读写接口（按 apiName 路由） [Android only]
    * @public
    * @since HealthKit 7.1.5
    * @platform Android
    */
   export function requestAiHealthDataApiSync(param?: AIHealthDataParams): {
     /**
-     * 返回结果
+     * 业务返回数据（JSON 字符串，具体结构由 apiName 决定）
      * @since HealthKit 7.1.5
      */
     result?: string
     /**
-     * 时间戳
+     * 响应时间戳（毫秒）
      * @since HealthKit 7.1.5
      */
     t: number
     /**
-     * 是否成功
+     * 接口调用是否成功
      * @since HealthKit 7.1.5
      */
     success: boolean
   }
 
   /**
-   * 同步到health connect的数据
+   * 面板自定义 DP 本地化数据库的统一读写接口
+   * 通过 apiName 路由到具体操作，支持建表/查表/记录增删改查及离线 DP 存储。
+   * 面板只能指定表名，列结构由 App 固定。
+   * apiName 枚举：
+   *   table.create        新建数据表
+   *   table.exist         判断表是否存在
+   *   table.list          查询已注册表列表
+   *   record.insert       写入 DP 记录（必填 devId、userId、time 毫秒时间戳）
+   *   record.query        查询 DP 记录（必填 startTime、endTime；devId 推荐；支持 readStatus 过滤）
+   *   record.update       更新 DP 记录（仅 dpValue / extra 可改）
+   *   record.delete       删除 DP 记录
+   *   record.readMark     修改已读/未读（离线表 is_read）
+   *   offline.init        首次建离线表 + 登记 (devId, dpCode) 映射
+   *   offline.bind.list   查询已登记 DP 映射
+   *   offline.unbind        移除映射（不停表、不删历史行）
+   *   offline.sync.pull     面板拉 BLE 大数据通道，批量写入离线表
+   * @public
+   * @since HealthKit 7.9.0
+   * @example Demo
+   * ```tsx
+   * function callCommonDataApi(apiName, request = {}) {
+   *   return new Promise((resolve, reject) => {
+   *     ty.health.requestCommonDataApi({
+   *       apiName,
+   *       request,
+   *       success: data => resolve(data),
+   *       fail: reject,
+   *     });
+   *   });
+   * }
+   *
+   * const tableName = "panel_step_data";
+   * const devId = "vdev123";
+   * const userId = "u001";
+   * const time = Date.now();
+   * const startTime = new Date().setHours(0, 0, 0, 0);
+   * const endTime = new Date().setHours(23, 59, 59, 999);
+   *
+   * const existRes = await callCommonDataApi("table.exist", { tableName });
+   * const existData = JSON.parse(existRes.result || "{}");
+   * if (!existData.exist) {
+   *   await callCommonDataApi("table.create", { tableName, enableExtra: false });
+   * }
+   *
+   * await callCommonDataApi("table.list", {});
+   *
+   * const insertRes = await callCommonDataApi("record.insert", {
+   *   tableName,
+   *   devId,
+   *   userId,
+   *   time,
+   *   dpCode: "step_count",
+   *   dpValue: "8000",
+   * });
+   * const recordId = JSON.parse(insertRes.result || "{}").id;
+   *
+   * await callCommonDataApi("record.query", {
+   *   tableName,
+   *   devId,
+   *   userId,
+   *   dpCode: "step_count",
+   *   startTime,
+   *   endTime,
+   *   pageSize: 50,
+   *   pageIndex: 0,
+   * });
+   *
+   * await callCommonDataApi("record.update", {
+   *   tableName,
+   *   id: recordId,
+   *   dpValue: "8500",
+   * });
+   *
+   * await callCommonDataApi("record.delete", {
+   *   tableName,
+   *   id: recordId,
+   * });
+   * ```
+   * @example Demo
+   * ```tsx
+   * function callCommonDataApi(apiName, request = {}) {
+   *   return new Promise((resolve, reject) => {
+   *     ty.health.requestCommonDataApi({
+   *       apiName,
+   *       request,
+   *       success: data => resolve(data),
+   *       fail: reject,
+   *     });
+   *   });
+   * }
+   *
+   * const tableName = 'offline_data';
+   * const devId = 'vdev123';
+   * const userId = 'u001';
+   * const panelDpCodes = ['step_count', 'calorie'];
+   * const startTime = new Date().setHours(0, 0, 0, 0);
+   * const endTime = new Date().setHours(23, 59, 59, 999);
+   *
+   * // 1. 查已有映射，只补新 dpCode
+   * const bindRes = await callCommonDataApi('offline.bind.list', { devId });
+   * const bindData = JSON.parse(bindRes.result || '{}');
+   * const existing = new Set((bindData.bindings || []).map(b => b.dpCode));
+   * const needRegister = panelDpCodes.filter(c => !existing.has(c));
+   *
+   * if (needRegister.length > 0) {
+   *   await callCommonDataApi('offline.init', {
+   *     userId,
+   *     deviceBindings: [{ devId, dpCodes: needRegister }],
+   *   });
+   * }
+   *
+   * // 拉设备端大批量历史 DP（进入面板时调用）
+   * const pullRes = await callCommonDataApi('offline.sync.pull', { devId });
+   * const pullData = JSON.parse(pullRes.result || '{}');
+   * console.log('sync.pull', pullData);
+   *
+   * // 2. 查未读
+   * const unreadRes = await callCommonDataApi('record.query', {
+   *   tableName,
+   *   devId,
+   *   userId,
+   *   readStatus: 0,
+   *   startTime,
+   *   endTime,
+   *   pageSize: 50,
+   *   pageIndex: 0,
+   * });
+   * const unread = JSON.parse(unreadRes.result || '{}');
+   *
+   * // 3. 标已读
+   * if ((unread.list || []).length > 0) {
+   *   await callCommonDataApi('record.readMark', {
+   *     tableName,
+   *     ids: unread.list.map(r => r.id),
+   *     readStatus: 1,
+   *   });
+   * }
+   *
+   * // 4. 面板手动补数据（可选）
+   * await callCommonDataApi('record.insert', {
+   *   tableName,
+   *   devId,
+   *   userId,
+   *   time: Date.now(),
+   *   dpCode: 'step_count',
+   *   dpValue: '8000',
+   * });
+   *
+   * // 5. 停止自动 sync（可选，保留历史）
+   * // await callCommonDataApi('offline.unbind', { devId });
+   *
+   * // 6. 清理历史数据（可选）
+   * // await callCommonDataApi('record.delete', { tableName, devId, startTime, endTime });
+   * ```
+   * @platform iOS Android
+   */
+  export function requestCommonDataApi(params: {
+    /**
+     * 接口名称，见 requestCommonDataApi 文档中的 apiName 枚举
+     * @since HealthKit 7.9.0
+     */
+    apiName: string
+    /**
+     * 业务参数，具体字段由各 apiName 定义
+     * @since HealthKit 7.9.0
+     */
+    request?: Record<string, any>
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * JSON 字符串，具体结构由各 apiName 定义
+       * @since HealthKit 7.9.0
+       */
+      result?: string
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * Health Connect 批量写入入参
    * @since HealthKit 5.18.0
    */
   export interface RecordParams {
@@ -2695,7 +2831,7 @@ declare namespace ty.health {
      */
     endTime?: number
     /**
-     * 常规字段
+     * 单值类型数据的测量值（如步数、心率等）
      * @since HealthKit 7.1.5
      */
     value?: number
@@ -2802,7 +2938,10 @@ declare namespace ty.health {
     count: number
   }
 
-  /** @since HealthKit 5.18.0 */
+  /**
+   * iOS HealthKit 通用入参（权限申请、数据读写）
+   * @since HealthKit 5.18.0
+   */
   export interface ParamModel {
     /**
      * 权限类型(申请读写权限的接口使用)，具体枚举值查看下文的枚举列表
@@ -2828,7 +2967,7 @@ declare namespace ty.health {
      */
     writePermission?: number
     /**
-     * 写入值
+     * 写入数值（Quantity 或 Category 类型数据的具体测量值）
      * @since HealthKit 5.18.3
      */
     value?: number
@@ -2855,52 +2994,59 @@ declare namespace ty.health {
     type?: number
   }
 
-  /** @since HealthKit 5.18.4 */
+  /**
+   * 授权状态查询结果
+   * @since HealthKit 5.18.4
+   */
   export interface StatusPermissionsResp {
     /**
-     * 1 代表传入的类型都申请过对应的读写权限
-     * 0 代表传入的类型至少有一个没有请求过对应的读写权限
+     * 授权状态：1 表示传入类型均已申请过对应读写权限；0 表示至少有一项未申请
      * @since HealthKit 5.18.4
      */
     value: number
   }
 
-  /** @since HealthKit 5.18.4 */
+  /**
+   * 写入权限查询结果
+   * @since HealthKit 5.18.4
+   */
   export interface GetWritePermissionResp {
     /**
-     * 1 有写入权限
-     * 0 无写入权限
+     * 写入权限状态：1 有写入权限；0 无写入权限
      * @since HealthKit 5.18.4
      */
     value: number
   }
 
-  /** @since HealthKit 7.1.5 */
+  /**
+   * iOS 多类型健康数据组合入参（Quantity / Category / Characteristic）
+   * @since HealthKit 7.1.5
+   */
   export interface IOSParamModel {
     /**
-     * quantity类型的参数
+     * Quantity 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     quantityParam?: ParamModel
     /**
-     * category类型的参数
+     * Category 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     categoryParam?: ParamModel
     /**
-     * characteristic类型的参数
+     * Characteristic 类型权限或数据参数
      * @since HealthKit 7.1.5
      */
     characteristicParam?: ParamModel
     /**
-     * 运动记录
+     * 是否包含运动记录（Workout）相关权限或数据
      * @since HealthKit 7.1.5
      */
     workoutType: boolean
   }
 
   /**
-   * 同步到hiOS HealthKit的数据
+   * iOS HealthKit 批量写入入参
    * @since HealthKit 7.1.5
    */
   export interface RecordIOSParams {
@@ -2938,10 +3084,10 @@ declare namespace ty.health {
     endTime: number
   }
 
-  /** @since HealthKit 5.18.4 */
-  export interface Object {}
-
-  /** @since HealthKit 5.18.4 */
+  /**
+   * 健康数据读取结果
+   * @since HealthKit 5.18.4
+   */
   export interface ReadDataResp {
     /**
      * 读取到的数据,是一个数组,数组中每一项是一个字典,具体定义如下
@@ -2950,133 +3096,139 @@ declare namespace ty.health {
      * endDate: Double 读取到的条目的截止时间戳
      * @since HealthKit 5.18.4
      */
-    value: Object[]
+    value: Record<string, any>[]
   }
 
-  /** @since HealthKit 5.18.6 */
+  /**
+   * 体脂秤算法计算入参
+   * @since HealthKit 6.5.0
+   */
   export interface BodyScaleParam {
     /**
-     * 性别（1-男、2-女）
-     * @since HealthKit 5.18.6
+     * 性别：1 男，2 女
+     * @since HealthKit 6.5.0
      */
     sex: number
     /**
      * 体重（单位kg）
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     weight: number
     /**
      * 阻抗
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     imp: number
     /**
      * 身高（单位cm）
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     height: number
     /**
      * 生日（13位、毫秒）
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     birthday: number
     /**
      * 测量时间（13位、毫秒）
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     time: number
   }
 
-  /** @since HealthKit 5.18.6 */
+  /**
+   * 体脂秤算法计算结果
+   * @since HealthKit 6.5.0
+   */
   export interface BodyScaleResponse {
     /**
      * bmi
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bmi: string
     /**
      * 体脂率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     fat: string
     /**
      * 水份率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     water: string
     /**
      * 肌肉量
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     muscle: string
     /**
      * 蛋白率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     protein: string
     /**
      * 骨量
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bones: string
     /**
      * 基础代谢率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     metabolism: string
     /**
      * 身体年龄
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bodyAge: string
     /**
      * 身体得分
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bodyScore: string
     /**
      * 内脂肪等级
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     visceralFat: string
     /**
      * 体型
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bodyType: string
     /**
      * 去脂指数
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     ffm: string
     /**
      * 脂肪量
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     fatMass: string
     /**
      * 体脂指数
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     bodyFatIndex: string
     /**
      * 肥胖等级
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     fatLevel: string
     /**
      * 标准体重
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     standardWeight: string
     /**
      * 体重控制
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     weightControl: string
     /**
      * 肌肉率
-     * @since HealthKit 5.18.6
+     * @since HealthKit 6.5.0
      */
     muscleRatio: string
   }
@@ -3157,14 +3309,14 @@ declare namespace ty.health {
    */
   export interface HealthDataLocalRequest {
     /**
-     * 返回结果
+     * 业务返回数据（JSON 字符串，具体结构由 apiName 决定）
      * @since HealthKit 7.0.5
      */
     result: string
   }
 
   /**
-   * 健康AI小程序本地化数据库信息获取和存储逻辑入参配置
+   * 健康 AI 小程序本地化数据库接口入参
    * @since HealthKit 7.1.5
    */
   export interface AIHealthDataParams {
@@ -3181,35 +3333,63 @@ declare namespace ty.health {
   }
 
   /**
-   * 健康AI小程序本地化数据库信息获取和存储逻辑返回结果
+   * 健康 AI 小程序本地化数据库接口返回结果
    * @since HealthKit 7.1.5
    */
   export interface AIHealthDataRequest {
     /**
-     * 返回结果
+     * 业务返回数据（JSON 字符串，具体结构由 apiName 决定）
      * @since HealthKit 7.1.5
      */
     result?: string
     /**
-     * 时间戳
+     * 响应时间戳（毫秒）
      * @since HealthKit 7.1.5
      */
     t: number
     /**
-     * 是否成功
+     * 接口调用是否成功
      * @since HealthKit 7.1.5
      */
     success: boolean
   }
 
-  /** @since HealthKit 5.18.4 */
+  /**
+   * 面板 DP 本地化数据库请求参数
+   * @since HealthKit 7.9.0
+   */
+  export interface CommonDataParams {
+    /**
+     * 接口名称，见 requestCommonDataApi 文档中的 apiName 枚举
+     * @since HealthKit 7.9.0
+     */
+    apiName: string
+    /**
+     * 业务参数，具体字段由各 apiName 定义
+     * @since HealthKit 7.9.0
+     */
+    request?: Record<string, any>
+  }
+
+  /**
+   * 面板 DP 本地化数据库返回结果
+   * @since HealthKit 7.9.0
+   */
+  export interface CommonDataResult {
+    /**
+     * JSON 字符串，具体结构由各 apiName 定义
+     * @since HealthKit 7.9.0
+     */
+    result?: string
+  }
+
+  /**
+   * Health Connect 状态码说明（与 getHealthConnectStatus、checkHealthConnectReadStatus 返回值对应）
+   * @since HealthKit 5.18.4
+   */
   export interface HealthConnectStatusCode {
     /**
-     * -2 服务不可用（需要提示用户去更改自启动和电源管理），建议面板收到-2直接跳转到授权页。授权页做弹窗提示
-     * -1 Health Connect不可用/不支持]
-     * 0 已授权
-     * 1 未安装Health Connect
-     * 2 未授权
+     * 状态码：-2 服务不可用；-1 不支持；0 已授权；1 未安装 Health Connect；2 未授权
      * @since HealthKit 5.18.4
      */
     value: number