@ray-js/api 1.7.83-beta.0 → 1.7.84

package/@types/WearKit.d.ts

@@ -1,7 +1,7 @@
 /**
  * WearKit
  *
- * @version 3.2.4
+ * @version 3.3.2
  */
 declare namespace ty.wear {
   /**
@@ -3985,6 +3985,16 @@ declare namespace ty.wear {
        * @since WearKit 1.9.1
        */
       linkShared: number
+      /**
+       * 转写是否已编辑，0未编辑、1已编辑
+       * @since WearKit 3.3.0
+       */
+      transcriptEdited?: number
+      /**
+       * 总结是否已编辑，0未编辑、1已编辑
+       * @since WearKit 3.3.0
+       */
+      summaryEdited?: number
       /**
        * 离线文件上传进度，默认0，范围0-100
        * @since WearKit 1.9.1
@@ -4005,6 +4015,11 @@ declare namespace ty.wear {
        * @since WearKit 3.0.0
        */
       summaryImageStatus?: number
+      /**
+       * 文件夹id
+       * @since WearKit 7.10.0
+       */
+      folderId?: string
     }) => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
@@ -5699,6 +5714,227 @@ declare namespace ty.wear {
     }) => void
   }): void
 
+  /**
+   * 文件夹操作（新建 / 重命名 / 删除 / 移动），按 type 分发对应 ATOP 并同步本地库
+   * @description.en Folder operation (add / rename / delete / move). Dispatches to the corresponding ATOP by type and syncs the local DB.
+   * @public
+   * @since WearKit 3.3.0
+   * @example 基础用法
+   * ```tsx
+   * ty.wear.operateFolder({
+   *   type: 'add',
+   *   folderName: '培训资料',
+   *   success: (r) => {
+   *     console.log('operateFolder success', r.folderId, r.folderName);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @see https://developer.tuya.com/
+   * @platform iOS Android
+   * @error {10001} 内部错误
+   * @error {10012} 记录不存在
+   */
+  export function operateFolder(params: {
+    /**
+     * 操作类型
+     * 'add': 新建
+     * 'rename': 重命名
+     * 'delete': 删除
+     * 'move': 移动
+     * @since WearKit 3.3.0
+     */
+    type: string
+    /**
+     * 文件夹名称（add / rename 必填）
+     * @since WearKit 3.3.0
+     */
+    folderName?: string
+    /**
+     * 文件夹业务 id（rename / delete 必填）
+     * @since WearKit 3.3.0
+     */
+    folderId?: string
+    /**
+     * 移动的录音 id 列表（move 必填，长度 1~100）
+     * @since WearKit 3.3.0
+     */
+    recordIds?: string[]
+    /**
+     * 目标文件夹 id（move；不传/空 = 移回未分类）
+     * @since WearKit 3.3.0
+     */
+    targetFolderId?: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 文件夹业务 id
+       * @since WearKit 3.3.0
+       */
+      folderId: string
+      /**
+       * 文件夹名称
+       * @since WearKit 3.3.0
+       */
+      folderName: string
+      /**
+       * delete / move 时为 true
+       * @since WearKit 3.3.0
+       */
+      result?: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 分类总览（纯本地聚合，无 ATOP），返回状态三分组 / 文件夹分组（含未分类）/ 来源四类目计数
+   * @description.en Category overview. Pure local aggregation (no ATOP). Returns status / folder (incl. unfiled) / source counts.
+   * @public
+   * @since WearKit 3.3.0
+   * @example 基础用法
+   * ```tsx
+   * ty.wear.categoryOverview({
+   *   success: (r) => {
+   *     console.log('categoryOverview success', r.statusGroup, r.folders, r.sourceGroup);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @see https://developer.tuya.com/
+   * @platform iOS Android
+   * @error {10001} 内部错误
+   */
+  export function categoryOverview(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 状态三分组（固定 3 项，建议顺序：ALL → PENDING_SUMMARY → SUMMARIZED）
+       * @since WearKit 3.3.0
+       */
+      statusGroup: CategoryOverviewStatusCountItem[]
+      /**
+       * 文件夹列表（含未分类，首项 folderId='UNFILED' 为未分类，其后为自建夹）
+       * @since WearKit 3.3.0
+       */
+      folders: CategoryOverviewFolderCountItem[]
+      /**
+       * 来源四类目（固定 4 项：PHONE / PC / HEADPHONE / RECORDER_CARD）
+       * @since WearKit 3.3.0
+       */
+      sourceGroup: CategoryOverviewSourceCountItem[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 按范围查询文件列表（纯本地 files，无 ATOP），状态 / 文件夹 / 来源三选一，至多一组有值
+   * @description.en Query files by category (pure local, no ATOP). Returns RecordTransferResult[]. One of statuses / folderIds / sourceCategories at most. Supports orderBy / asc / pageSize.
+   * @public
+   * @since WearKit 3.3.0
+   * @example 基础用法
+   * ```tsx
+   * ty.wear.queryFilesByCategory({
+   *   folderIds: ['f_8f3a...'],
+   *   orderBy: 1, // 0: fileId, 1: recordTime, 2: updateAt
+   *   asc: 0, // 0: desc, 1: asc
+   *   pageSize: 20,
+   *   success: (list) => {
+   *     console.log('queryFilesByCategory success', list);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @see https://developer.tuya.com/
+   * @platform iOS Android
+   * @error {10001} 内部错误
+   */
+  export function queryFilesByCategory(params: {
+    /**
+     * 状态筛选（'PENDING_SUMMARY'=未总结+总结中 / 'SUMMARIZED'）；「所有文件」不要传
+     * @since WearKit 3.3.0
+     */
+    statuses?: string[]
+    /**
+     * 文件夹筛选（自建 folderId 或字面量 'UNFILED'）
+     * @since WearKit 3.3.0
+     */
+    folderIds?: string[]
+    /**
+     * 来源筛选（'PHONE' / 'PC' / 'HEADPHONE' / 'RECORDER_CARD'）
+     * @since WearKit 3.3.0
+     */
+    sourceCategories?: string[]
+    /**
+     * 排序规则  0: fileId,  1: recordTime, 2: updateAt
+     * @since WearKit 7.10.0
+     */
+    orderBy: number
+    /**
+     * 0: desc, 1: asc
+     * @since WearKit 7.10.0
+     */
+    asc: number
+    /**
+     * 限制的长度
+     * @since WearKit 7.10.0
+     */
+    pageSize: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: RecordTransferResult[]) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
   /**
    * 监听微信授权代理事件
    * @description.en Get WeChat authorization information.
@@ -5726,7 +5962,7 @@ declare namespace ty.wear {
    * @since WearKit 1.0.0
    * @remarks 注意:WearKit(2.1.0)起下该方法已过时,请使用ThirdAuthKit下同名方法
    * @remarksEn Note: Deprecated since WearKit 2.1.0, use the same method in ThirdAuthKit.
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onWechatAuthAgentEvent(listener)
@@ -5762,7 +5998,7 @@ declare namespace ty.wear {
    * @description.en Stock sync status update event.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onStockSyncUpdate(listener)
@@ -5798,7 +6034,7 @@ declare namespace ty.wear {
    * @description.en Progress callback for gain publishing.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onPublishGainsProgress(listener)
@@ -5834,7 +6070,7 @@ declare namespace ty.wear {
    * @description.en File transfer progress.
    * @public
    * @since WearKit 1.1.3
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onOfflineFilesProgressEvent(listener)
@@ -5870,7 +6106,7 @@ declare namespace ty.wear {
    * @description.en Recording finished callback.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordFinishEvent(listener)
@@ -5906,7 +6142,7 @@ declare namespace ty.wear {
    * @description.en Recording amplitude event.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordAmplitudeUpdateEvent(listener)
@@ -5950,7 +6186,7 @@ declare namespace ty.wear {
    * @description.en Recording status change event.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordStatusUpdateEvent(listener)
@@ -5986,7 +6222,7 @@ declare namespace ty.wear {
    * @description.en Active input source switch event.
    * @public
    * @since WearKit 1.3.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordSwitchAudioSourceEvent(listener)
@@ -6022,7 +6258,7 @@ declare namespace ty.wear {
    * @description.en Quick entry add/set result event.
    * @public
    * @since WearKit 2.1.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onQuickEntryAddEvent(listener)
@@ -6058,7 +6294,7 @@ declare namespace ty.wear {
    * @description.en Recording transcription finish error callback.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordTransferFinishEvent(listener)
@@ -6094,7 +6330,7 @@ declare namespace ty.wear {
    * @description.en Recording transcription amplitude update event.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordTransferAmplitudeUpdateEvent(listener)
@@ -6130,7 +6366,7 @@ declare namespace ty.wear {
    * @description.en Recording transcription status change event.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordTransferStatusUpdateEvent(listener)
@@ -6166,7 +6402,7 @@ declare namespace ty.wear {
    * @description.en Recording transcription file upload progress event.
    * @public
    * @since WearKit 1.2.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordTransferFileUploadEvent(listener)
@@ -6202,7 +6438,7 @@ declare namespace ty.wear {
    * @description.en Text translation TTS complete event.
    * @public
    * @since WearKit 1.4.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onTextTranslateTtsCompleteEvent(listener)
@@ -6241,7 +6477,7 @@ declare namespace ty.wear {
    * @description.en Recording real-time transcription status change event.
    * @public
    * @since WearKit 1.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordTransferRealTimeRecognizeStatusUpdateEvent(listener)
@@ -6277,7 +6513,7 @@ declare namespace ty.wear {
    * @description.en Recording scene battery change event.
    * @public
    * @since WearKit 1.7.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordBatteryChangeEvent(listener)
@@ -6313,7 +6549,7 @@ declare namespace ty.wear {
    * @description.en Real-time transcription/simultaneous interpretation recording quality (SNR) change event.
    * @public
    * @since WearKit 1.7.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onRecordQualityChangeEvent(listener)
@@ -6352,7 +6588,7 @@ declare namespace ty.wear {
    * @description.en Classic Bluetooth device/Pro earphone connection status change event.
    * @public
    * @since WearKit 1.8.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onEarPhoneBTConnectedStatusChangeEvent(listener)
@@ -6388,7 +6624,7 @@ declare namespace ty.wear {
    * @description.en Cloud sync switch status event.
    * @public
    * @since WearKit 1.5.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onCloudSyncSwitchStatusEvent(listener)
@@ -6424,7 +6660,7 @@ declare namespace ty.wear {
    * @description.en Sync status event.
    * @public
    * @since WearKit 1.6.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onPartialRecordUpdate(listener)
@@ -6460,7 +6696,7 @@ declare namespace ty.wear {
    * @description.en File list status refresh event.
    * @public
    * @since WearKit 1.5.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onFileListUpdateStatusEvent(listener)
@@ -6496,7 +6732,7 @@ declare namespace ty.wear {
    * @description.en File details status refresh event.
    * @public
    * @since WearKit 1.5.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onFileDetailUpdateStatusEvent(listener)
@@ -6532,7 +6768,7 @@ declare namespace ty.wear {
    * @description.en Mini-program push refresh event.
    * @public
    * @since WearKit 1.6.23
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onPushRouteInfoEvent(listener)
@@ -6568,7 +6804,7 @@ declare namespace ty.wear {
    * @description.en File import status event.
    * @public
    * @since WearKit 1.7.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onFileImportStatusEvent(listener)
@@ -6604,7 +6840,7 @@ declare namespace ty.wear {
    * @description.en File merge status event.
    * @public
    * @since WearKit 2.0.0
-   * @example Demo
+   * @example
    * ```tsx
    * const listener = function (res) { console.log(res) }
    * ty.wear.onFileMergeStatusEvent(listener)
@@ -6617,6 +6853,42 @@ declare namespace ty.wear {
     listener: (params: FileMergeStatusEvent) => void
   ): void
 
+  /**
+   * 文件夹变更事件（delete / update）
+   * @description.en Folder change event. type=delete removes a folder; type=update renames and/or changes associated files. folderIds lists all affected folders.
+   * @public
+   * @since WearKit 3.3.0
+   * @example 基础用法
+   * ```tsx
+   * ty.wear.onFolderChangeEvent((response) => {
+   *   console.log('onFolderChangeEvent', response.type, response.folderIds, response.folderName);
+   * });
+   * ```
+   * @see https://developer.tuya.com/
+   * @platform iOS Android
+   */
+  export function onFolderChangeEvent(
+    listener: (params: FolderChangeEvent) => void
+  ): void
+
+  /**
+   * 文件夹变更事件（delete / update）
+   * @description.en Folder change event. type=delete removes a folder; type=update renames and/or changes associated files. folderIds lists all affected folders.
+   * @public
+   * @since WearKit 3.3.0
+   * @example
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.wear.onFolderChangeEvent(listener)
+   * ty.wear.offFolderChangeEvent(listener)
+   * ```
+   * @see https://developer.tuya.com/
+   * @platform iOS Android
+   */
+  export function offFolderChangeEvent(
+    listener: (params: FolderChangeEvent) => void
+  ): void
+
   /**
    * QQ音乐授权请求参数
    * @since WearKit 0.0.5
@@ -8484,6 +8756,16 @@ declare namespace ty.wear {
      * @since WearKit 3.0.0
      */
     businessType: number
+    /**
+     * 业务类型 0: 主动暂停, 1: 应用内暂停  2: 应用外暂停
+     * @since WearKit 7.10.0
+     */
+    pauseType: number
+    /**
+     * 当前任务第几次录音启动：首次启动为 0，每次恢复成功递增（App 端维护）
+     * @since WearKit 7.10.0
+     */
+    recordingStartCount: number
   }
 
   /**
@@ -8729,6 +9011,16 @@ declare namespace ty.wear {
      * @since WearKit 1.0.0
      */
     isStoping: boolean
+    /**
+     * 暂停类型 0: 主动暂停, 1: 应用内暂停, 2: 应用外暂停
+     * @since WearKit 7.10.0
+     */
+    pauseType: number
+    /**
+     * 当前任务第几次录音启动：首次启动为 0，每次恢复成功递增（App 端维护）
+     * @since WearKit 7.10.0
+     */
+    recordingStartCount: number
   }
 
   /**
@@ -9388,6 +9680,16 @@ declare namespace ty.wear {
      * @since WearKit 1.9.1
      */
     linkShared: number
+    /**
+     * 转写是否已编辑，0未编辑、1已编辑
+     * @since WearKit 3.3.0
+     */
+    transcriptEdited?: number
+    /**
+     * 总结是否已编辑，0未编辑、1已编辑
+     * @since WearKit 3.3.0
+     */
+    summaryEdited?: number
     /**
      * 离线文件上传进度，默认0，范围0-100
      * @since WearKit 1.9.1
@@ -9408,6 +9710,11 @@ declare namespace ty.wear {
      * @since WearKit 3.0.0
      */
     summaryImageStatus?: number
+    /**
+     * 文件夹id
+     * @since WearKit 7.10.0
+     */
+    folderId?: string
   }
 
   /**
@@ -10323,6 +10630,16 @@ declare namespace ty.wear {
      * @since WearKit 3.0.0
      */
     summaryImageUrl?: string
+    /**
+     * 转写是否已编辑，0未编辑、1已编辑
+     * @since WearKit 3.3.0
+     */
+    transcriptEdited?: number
+    /**
+     * 总结是否已编辑，0未编辑、1已编辑
+     * @since WearKit 3.3.0
+     */
+    summaryEdited?: number
   }
 
   /**
@@ -10399,6 +10716,213 @@ declare namespace ty.wear {
     extraInfo: string
   }
 
+  /**
+   * 文件夹操作入参（operateFolder）
+   * @since WearKit 3.3.0
+   */
+  export interface OperateFolderParams {
+    /**
+     * 操作类型
+     * 'add': 新建
+     * 'rename': 重命名
+     * 'delete': 删除
+     * 'move': 移动
+     * @since WearKit 3.3.0
+     */
+    type: string
+    /**
+     * 文件夹名称（add / rename 必填）
+     * @since WearKit 3.3.0
+     */
+    folderName?: string
+    /**
+     * 文件夹业务 id（rename / delete 必填）
+     * @since WearKit 3.3.0
+     */
+    folderId?: string
+    /**
+     * 移动的录音 id 列表（move 必填，长度 1~100）
+     * @since WearKit 3.3.0
+     */
+    recordIds?: string[]
+    /**
+     * 目标文件夹 id（move；不传/空 = 移回未分类）
+     * @since WearKit 3.3.0
+     */
+    targetFolderId?: string
+  }
+
+  /**
+   * 文件夹操作结果（add / rename）
+   * @since WearKit 3.3.0
+   */
+  export interface FolderOperateResult {
+    /**
+     * 文件夹业务 id
+     * @since WearKit 3.3.0
+     */
+    folderId: string
+    /**
+     * 文件夹名称
+     * @since WearKit 3.3.0
+     */
+    folderName: string
+    /**
+     * delete / move 时为 true
+     * @since WearKit 3.3.0
+     */
+    result?: boolean
+  }
+
+  /**
+   * 状态计数项
+   * @since WearKit 3.3.0
+   */
+  export interface CategoryOverviewStatusCountItem {
+    /**
+     * 状态 id
+     * 'ALL': 所有文件
+     * 'PENDING_SUMMARY': 待总结（含未总结、总结中）
+     * 'SUMMARIZED': 已总结
+     * @since WearKit 3.3.0
+     */
+    statusId: string
+    /**
+     * 文件数量
+     * @since WearKit 3.3.0
+     */
+    count: number
+  }
+
+  /**
+   * 文件夹计数项
+   * @since WearKit 3.3.0
+   */
+  export interface CategoryOverviewFolderCountItem {
+    /**
+     * 文件夹业务 id（未分类为字面量 'UNFILED'）
+     * @since WearKit 3.3.0
+     */
+    folderId: string
+    /**
+     * 文件夹名称
+     * @since WearKit 3.3.0
+     */
+    folderName: string
+    /**
+     * 文件数量
+     * @since WearKit 3.3.0
+     */
+    count: number
+  }
+
+  /**
+   * 来源计数项
+   * @since WearKit 3.3.0
+   */
+  export interface CategoryOverviewSourceCountItem {
+    /**
+     * 来源 id
+     * 'PHONE': 手机
+     * 'PC': PC
+     * 'HEADPHONE': 耳机
+     * 'RECORDER_CARD': 录音卡
+     * @since WearKit 3.3.0
+     */
+    sourceGroupId: string
+    /**
+     * 文件数量
+     * @since WearKit 3.3.0
+     */
+    count: number
+  }
+
+  /**
+   * 分类总览结果（categoryOverview，纯本地聚合）
+   * @since WearKit 3.3.0
+   */
+  export interface CategoryOverviewResult {
+    /**
+     * 状态三分组（固定 3 项，建议顺序：ALL → PENDING_SUMMARY → SUMMARIZED）
+     * @since WearKit 3.3.0
+     */
+    statusGroup: CategoryOverviewStatusCountItem[]
+    /**
+     * 文件夹列表（含未分类，首项 folderId='UNFILED' 为未分类，其后为自建夹）
+     * @since WearKit 3.3.0
+     */
+    folders: CategoryOverviewFolderCountItem[]
+    /**
+     * 来源四类目（固定 4 项：PHONE / PC / HEADPHONE / RECORDER_CARD）
+     * @since WearKit 3.3.0
+     */
+    sourceGroup: CategoryOverviewSourceCountItem[]
+  }
+
+  /**
+   * 按范围查询文件列表入参（queryFilesByCategory，纯本地）
+   * @since WearKit 3.3.0
+   */
+  export interface QueryFilesByCategoryParams {
+    /**
+     * 状态筛选（'PENDING_SUMMARY'=未总结+总结中 / 'SUMMARIZED'）；「所有文件」不要传
+     * @since WearKit 3.3.0
+     */
+    statuses?: string[]
+    /**
+     * 文件夹筛选（自建 folderId 或字面量 'UNFILED'）
+     * @since WearKit 3.3.0
+     */
+    folderIds?: string[]
+    /**
+     * 来源筛选（'PHONE' / 'PC' / 'HEADPHONE' / 'RECORDER_CARD'）
+     * @since WearKit 3.3.0
+     */
+    sourceCategories?: string[]
+    /**
+     * 排序规则  0: fileId,  1: recordTime, 2: updateAt
+     * @since WearKit 7.10.0
+     */
+    orderBy: number
+    /**
+     * 0: desc, 1: asc
+     * @since WearKit 7.10.0
+     */
+    asc: number
+    /**
+     * 限制的长度
+     * @since WearKit 7.10.0
+     */
+    pageSize: number
+  }
+
+  /**
+   * 文件夹变更事件
+   * 仅处理 delete / update；add 走全量 folder.file.list，不派发本事件
+   * @since WearKit 3.3.0
+   */
+  export interface FolderChangeEvent {
+    /**
+     * 变更类型
+     * delete: 删除当前文件夹
+     * update: 更新文件夹名称，和/或更新关联文件列表
+     * @since WearKit 3.3.0
+     */
+    type: string
+    /**
+     * 涉及变更的文件夹 id 列表（必填）
+     * delete: 被删夹 id
+     * update: 所有受影响夹 id（改名仅当前夹；移动含 from/to）
+     * @since WearKit 3.3.0
+     */
+    folderIds: string[]
+    /**
+     * 改名后的最新名称（update 且含改名时建议带）
+     * @since WearKit 3.3.0
+     */
+    folderName?: string
+  }
+
   /**
    * 频率
    * @since WearKit 0.0.2