k2-im 0.1.57 → 0.2.0

package/dist/sdk.d.ts

@@ -9,8 +9,8 @@ interface MediaTransferProgress {
     phase?: 'transferring' | 'finalizing';
 }
 
-/** 会话类型。P0 只用 direct / group；`robot` 是独立私聊 sibling，不得并入 direct。 */
-type ConversationType = 'direct' | 'group' | 'channel' | 'supergroup' | 'robot';
+/** 会话类型；各类型分别处理权限、收发和历史。supergroup 仅预留类型，尚未提供业务实现。 */
+type ConversationType = 'direct' | 'group' | 'channel' | 'supergroup' | 'robot' | 'customerService';
 /**
  * 会话复合身份；`conversationId` 只在对应 `conversationType` 的领域内唯一。
  *
@@ -47,8 +47,8 @@ interface ConversationDraft$1 {
     attachments: readonly [];
     updatedAt: number;
 }
-/** 消息内容类型。sticker=表情/贴图（BMessage contentType=7）；call=单聊通话记录（contentType=10）；transfer=转账（contentType=16）；gift=礼品/刮刮卡（contentType=17）；robot=机器人卡片（contentType=18）；miniProgram=小程序分享卡（contentType=22）；redPacket=红包卡（contentType=25）；game=小游戏（contentType=27）；liveRoom=直播间分享（contentType=30）；未知 wire 正文统一归一为 unknown。 */
-type MessageContentType = 'text' | 'system' | 'image' | 'video' | 'voice' | 'file' | 'sticker' | 'contact' | 'miniProgram' | 'game' | 'transfer' | 'gift' | 'call' | 'redPacket' | 'mediaAlbum' | 'filesAlbum' | 'robot' | 'liveRoom' | 'unknown';
+/** 消息内容类型。sticker=表情/贴图（BMessage contentType=7）；call=单聊通话记录（contentType=10）；transfer=转账（contentType=16）；gift=礼品/刮刮卡（contentType=17）；robot=机器人卡片（contentType=18）；miniProgram=小程序分享卡（contentType=22）；redPacket=红包卡（contentType=25）；game=小游戏（contentType=27）；liveRoom=直播间分享（contentType=30）；未知 wire 正文统一转换为 unknown。 */
+type MessageContentType = 'text' | 'system' | 'image' | 'video' | 'voice' | 'file' | 'sticker' | 'contact' | 'miniProgram' | 'game' | 'transfer' | 'gift' | 'call' | 'redPacket' | 'mediaAlbum' | 'filesAlbum' | 'robot' | 'liveRoom' | 'customerService' | 'unknown';
 /**
  * 发送态（客户端态）：消息从本地创建到服务端确认的生命周期。
  * `uploading` 仅媒体消息使用：文件上传阶段（uploading→pending→sending→sent）；
@@ -88,10 +88,10 @@ interface ImSystemMessageBody {
     pinnedMessageAction?: ImPinnedMessageAction;
 }
 /**
- * 会话「最后一条」的语义摘要（持久化、经字段级 lastMessageSummaryEqual 参与判等）：取代中文预览串作为语义承重。
- * `system` 分支直接持归一后的 ImSystemMessageBody（供 formatLastMessageSummary 复用 formatSystemMessage，selfId 渲染时传入）。
- * EXPRESSION 协议家族按 `imageType` 投影为 `gif` 或静态 `sticker`，供会话列表保留产品差异。
- * 迁移期与 lastMessagePreview 双写并存（阶段 4）；判等**禁比对象引用**（否则 hydrate 回读值/重算值每次新建对象即永不相等）。
+ * 会话最后一条消息的语义摘要，供存储和 im-i18n 展示使用。
+ * `system` 保存解析后的 ImSystemMessageBody，formatSystemMessage 在展示时接收 selfId。
+ * EXPRESSION 按 imageType 区分 gif 与静态 sticker。
+ * 与 lastMessagePreview 同时保存；变化检查逐字段调用 lastMessageSummaryEqual，不比较对象引用。
  */
 type LastMessageSummary = {
     kind: 'text';
@@ -287,7 +287,7 @@ interface ImVoiceBody {
     teaKey?: Uint8Array;
     /** 文件加密类型：0=跟随消息，1=不加密，3=完整 TEA（BMessage.fileEncryptType；语音与图片/视频同走完整 TEA）。 */
     fileEncryptType?: number;
-    /** 录音振幅波形（0-255）：仅发送端本地展示缓存（随消息落盘、刷新后仍可画波形），**不写入 BMessage**（协议无波形字段）。 */
+    /** 录音振幅波形（0-255）：仅发送端本地展示缓存（随消息写入本地存储、刷新后仍可画波形），**不写入 BMessage**（协议无波形字段）。 */
     waveform?: number[];
 }
 /**
@@ -394,7 +394,7 @@ interface ImRobotImageGroupModule {
 /**
  * 机器人卡片倒计时。
  *
- * `endTimeMs` 已归一为 epoch 毫秒；wire 秒/毫秒混用只在 mapper 转换，宿主不要再猜单位。
+ * `endTimeMs` 已转换为 epoch 毫秒；wire 秒/毫秒混用只在 mapper 转换，宿主不要再猜单位。
  */
 interface ImRobotCountdownModule {
     type: 'countdown';
@@ -487,10 +487,10 @@ interface ImGiftBody {
     benCount?: string;
     fissionNumber?: string;
 }
-/** 领域通话媒体类型；已从各端 wire 0/1 对调口径归一，宿主禁止再读 raw callType。 */
+/** 通话媒体类型；各端 wire 0/1 的不同含义已转换成统一业务值，宿主无需读取 raw callType。 */
 type ImCallKind = 'audio' | 'video';
 /**
- * 通话结束结果。Android 跨端同步把未接与取消都写成 callStatus=0，只能归一为 missed。
+ * 通话结束结果。Android 跨端同步把未接与取消都写成 callStatus=0，只能转换为 missed。
  * `unknown` 仅表示该端 status 数字无法识别，不得猜成 completed。
  */
 type ImCallOutcome = 'missed' | 'rejected' | 'cancelled' | 'completed' | 'busy' | 'no-permission' | 'interrupted' | 'unknown';
@@ -498,7 +498,7 @@ type ImCallOutcome = 'missed' | 'rejected' | 'cancelled' | 'completed' | 'busy'
  * 单聊通话记录正文（contentType==='call'，协议 BMessage.contentType=10）。
  *
  * @remarks JSON 在 BMessage.content。Android 本地 / Android 跨端同步 / iOS 三套字段名与 0/1 含义不同，
- * 只在 mapping/call-record-body 归一。记录由各端本地插入，不能当普通聊天发出。
+ * 仅由 mapping/call-record-body 转换成统一业务值。记录由各端本地插入，不能当普通聊天发出。
  */
 interface ImCallRecordBody {
     callKind: ImCallKind;
@@ -525,7 +525,7 @@ type ImRedPacketType = 1 | 2 | 3 | 4;
  * @remarks 字段来自 proto 72-79 + 复用 34/35/38/49。领域名 `packetId` 对应 wire `rad_packet_id`。
  * 金额保持 proto string，单位是否微单位未证实，禁止默认套转账 ×1e6。
  * HTTP 详情状态与本地「自己已领」属于宿主投影，不进本 DTO（status 39 / state 53 未裁定）。
- * 本阶段不提供 `sendRedPacket`；出站字段仅用于 codec 往返闭合。
+ * 当前不提供 `sendRedPacket`；出站字段仅用于 codec 往返闭合。
  */
 interface ImRedPacketBody {
     packetId: string;
@@ -545,7 +545,7 @@ interface ImRedPacketBody {
 type ImContactKind = 'individual' | 'group' | 'channel' | 'robot' | 'unknown';
 /**
  * 名片消息内容体（contentType==='contact'）。字段来自 BMessage contentType=8，但使用领域友好命名：
- * id/icon/name 分别归一为 targetId/avatar/displayName；visitCardKey 归一为 kind，未知值放 rawKind。
+ * id/icon/name 分别转换为 targetId/avatar/displayName；visitCardKey 转换为 kind，未知值放 rawKind。
  */
 interface ImContactBody {
     /** 被分享对象 id：个人 userId、普通群 groupId、频道 id 或机器人 id。 */
@@ -577,7 +577,7 @@ interface UnknownMessageBody {
  * 若干项共享消息级的撤回、已读、引用与转发语义。
  */
 interface ImMediaAlbumItem {
-    /** 该项是图片还是视频；由协议 `mediaType` 归一而来，未知取值的项在解析阶段已被丢弃。 */
+    /** 该项是图片还是视频；由协议 mediaType 转换，无法识别的项会在解析时丢弃。 */
     kind: 'image' | 'video';
     /** 远端地址。加密项也是这个地址，解密用本项自己的 `teaKey`。 */
     url: string;
@@ -659,8 +659,28 @@ interface ImLiveRoomBody {
     /** 点赞数十进制字符串，保持协议原文，不在 Core 换算。 */
     liveRoomLikes?: string;
 }
+/** 客服正文保留一条消息内的全部附件；图片和文件各自保持服务端顺序。 */
+interface ImCustomerServiceBody {
+    /** 原始文字；空白不被当作不存在。 */
+    text: string;
+    /** 图片直达地址，不套用普通消息的加密文件结构。 */
+    images: readonly string[];
+    /** 文件与名称、大小按协议数组索引配对，不创建伪消息 ID。 */
+    files: readonly ImCustomerServiceFile[];
+}
+/** 客服文件元数据。大小是服务端展示文字，不能据此认定下载完整。 */
+interface ImCustomerServiceFile {
+    /** 服务端给出的资源地址。 */
+    url: string;
+    /** 服务端名称；缺省时从 URL 最后一个路径片段提取。 */
+    name: string;
+    /** 可缺省的原始大小描述，例如 1.5MB，并非精确字节数。 */
+    sizeLabel?: string;
+}
 interface ImMessageBody {
-    /** P0 文本内容（明文，解密后的结果）。 */
+    /** 客服专用复合正文；不能直接作为普通消息发送。 */
+    customerService?: ImCustomerServiceBody;
+    /** 文本内容（明文，解密后的结果）。 */
     text?: string;
     /** contentType==='system' 时的结构化系统提示体（群通知；text 忽略）。 */
     system?: ImSystemMessageBody;
@@ -710,7 +730,7 @@ interface MentionRange {
     end: number;
 }
 /**
- * 群消息 @ 提及（Android 三写载体的归一解析）：`atAll`(MESGrpChat.nNotifyCount=-1)、`atUserIds`(sNotifyUsers 被 @ 成员，
+ * 群消息 @ 提及（Android 三写载体的统一解析）：`atAll`(MESGrpChat.nNotifyCount=-1)、`atUserIds`(sNotifyUsers 被 @ 成员，
  * 含正文 token 读边界补全)、`ranges`(extend.atRange，可选、仅诊断/兼容——展示**不依赖其坐标**)。正文 `body.text` 保留 `[userId]` token 原样（真相不变）；
  * **展示权威来源 = 正文 token + atUserIds/atAll**，由纯函数 `resolveMentionSegments` 还原为高亮段（含 @昵称/@所有人/@我），UI 不自行解析。
  */
@@ -732,21 +752,21 @@ type ImMessageFailureReason = 'timeout' | 'rejected' | 'encrypt_failed' | 'netwo
  */
 type ImFailureDisplayCode = 'media.empty' | 'media.noCrypto' | 'media.previewFailed' | 'media.encryptFailed' | 'media.resumeUnavailable' | 'media.cleanupUnconfirmed' | 'media.uploadFailed' | 'media.uploadTimeout' | 'media.cancelled' | 'media.invalidDuration' | 'media.uploadInterrupted' | 'media.contentTooLarge' | 'contactRequired' | 'messageRefused' | 'forbiddenOrLeft' | 'contentRejected' | 'groupDismissed' | 'groupUnavailable' | 'channelDismissed' | 'channelMuted' | 'channelNotMember' | 'channelAdminRequired' | 'conversationUnsupported' | 'sendCanceled' | 'sessionLoggedOut' | 'timeout' | 'network' | 'unknown';
 interface ImMessageFailure {
-    /** 归一后的错误码（来自 MESChatAck.errcode 或本地失败码，本地码用负值）。 */
+    /** 转换后的错误码（来自 MESChatAck.errcode 或本地失败码，本地码用负值）。 */
     code: number;
     /** 失败机器分类（重试 / fail-fast / 统计消费）。 */
     reason: ImMessageFailureReason;
-    /** 失败展示语义码（强类型）：UI 经 im-i18n 按 locale 渲染；缺省表示无专门展示码（UI 回退 message）。不参与去重判等。 */
+    /** 失败展示语义码：UI 经 im-i18n 按语言渲染，缺省时使用 message；不单独触发消息状态更新。 */
     displayCode?: ImFailureDisplayCode;
-    /** 展示模板参数（如未支持会话类型的 type）；不参与去重判等。 */
+    /** 展示模板参数（如未支持会话类型的 type）；不单独触发消息状态更新。 */
     params?: Record<string, string | number>;
     /** 媒体失败的媒体类型（图片/视频/语音/文件）：供 displayCode 为 media.* 时渲染 label。 */
     mediaKind?: MediaKind;
-    /** 后端原文 / 诊断兜底文案；仅诊断/展示兜底用，不参与去重判等（见 merge.failureEqual）。 */
+    /** 后端原文或诊断文案；没有专门展示码时用于展示，不单独触发消息状态更新（见 merge.failureEqual）。 */
     message?: string;
     /**
      * 是否可重试（false=业务级不可重试）：如 direct 非好友或 GROUP 不在群(0x8201)、内容为空/违规(0x8202)、群已解散(0x8315)→ UI 隐藏「重发」。
-     * 缺省（undefined）视为可重试（向后兼容）。由 code 决定（classifyAckFailure），故不参与去重判等（同 code 必同 retryable）。
+     * 缺省（undefined）视为可重试（向后兼容）。由 code 决定（classifyAckFailure），不单独触发消息状态更新。
      */
     retryable?: boolean;
 }
@@ -789,7 +809,7 @@ interface MediaTaskUpdate {
     failure?: ImMessageFailure;
 }
 interface ImMessageEncryption {
-    /** P0 true=消息密文链路, false=明文链路（encrypt=0）。 */
+    /** true=消息密文链路, false=明文链路（encrypt=0）。 */
     encrypted: boolean;
     /** 扩展：加密方案标识，默认 'rsa-tea'。 */
     scheme?: 'rsa-tea';
@@ -798,16 +818,16 @@ interface ImMessageEncryption {
 }
 /** 单条消息领域模型（§4.1）。主键为客户端生成的 id（无 serverId）。 */
 interface ImMessage {
-    /** P0 客户端生成的稳定消息 ID（UUID），同时作幂等键；刷新后保持。 */
+    /** 客户端生成的稳定消息 ID（UUID），同时作幂等键；刷新后保持。 */
     id: string;
-    /** P0 归一化会话 ID。 */
+    /** 消息所属会话的字符串 ID；必须结合 conversationType 使用。 */
     conversationId: string;
     conversationType: ConversationType;
-    /** P0 归一化发送者 ID。 */
+    /** 发送者的字符串用户 ID。 */
     senderId: string;
     contentType: MessageContentType;
     body: ImMessageBody;
-    /** P0 统一毫秒 number（本地创建时间，乐观渲染用）。 */
+    /** 统一毫秒 number（本地创建时间，乐观渲染用）。 */
     createdAt: number;
     /** SDK 内部排序键；有效服务端时间优先，ACK 后可以更新。宿主不解析它，消息身份始终使用 id。 */
     sortKey: string;
@@ -816,7 +836,7 @@ interface ImMessage {
     failure?: ImMessageFailure;
     /** 服务端回传的 epoch 毫秒时间；有效时用于正式排序与展示，createdAt 仍保留创建记录。 */
     serverTime?: number;
-    /** P0 默认 'unread'。 */
+    /** 默认 'unread'。 */
     receipt: MessageReceipt;
     /** 离线单聊服务端标记当前账号已在其它端读过；仅用于本地未读投影，不改变对端回执 receipt。 */
     readBySelf?: boolean;
@@ -849,7 +869,7 @@ interface ImMessage {
     /** 扩展位：后端新增语义先落这里，避免污染核心字段。 */
     extensions?: Record<string, unknown>;
     /**
-     * 诊断快照（§4.1 诊断口径）：后端下发的原始协议字段（已归一为可 JSON 序列化形态）。
+     * 诊断快照（§4.1 诊断口径）：后端下发的原始协议字段（已转换为可 JSON 序列化形态）。
      * 默认不填充，仅当映射开启 keepRaw 时附带，便于联调、与后端核对原始下发；不参与任何业务逻辑。
      */
     raw?: ImMessageRaw;
@@ -966,17 +986,17 @@ type ChannelSessionState = 'active' | 'guest' | 'left' | 'removed' | 'dismissed'
 interface ImSession {
     id: string;
     type: ConversationType;
-    /** P0 由映射层从用户/群资料补齐。 */
+    /** 由映射层从用户/群资料补齐。 */
     title: string;
     avatar?: string;
     /**
-     * 会话最后一条的预览串（**已收窄**，阶段 4c）：仅承载 text 消息的正文（供会话列表 previewSegments 解析 @/表情，需原始正文串）；
+     * 会话最后一条的预览串（**已收窄**）：仅承载 text 消息的正文（供会话列表 previewSegments 解析 @/表情，需原始正文串）；
      * 媒体 / 加密 / 系统 / 撤回一律空串——其语义改由 lastMessageSummary 承载、UI 经 im-i18n 渲染。旧盘遗留的中文占位在 hydrate / projectSession 重算时清空。
      */
     lastMessagePreview: string;
     /**
-     * 最后一条消息的语义摘要（持久化）：取代中文 lastMessagePreview 作为语义承重，UI 经 im-i18n 按 locale 渲染。
-     * 迁移期与 lastMessagePreview 双写并存（阶段 4）；判等用字段级 lastMessageSummaryEqual（禁比对象引用）。旧会话无此字段时 UI 回退 lastMessagePreview。
+     * 最后一条消息的语义摘要，持久保存并由 im-i18n 按语言生成文案。
+     * 与 lastMessagePreview 同时保存，变化检查使用逐字段比较；旧会话缺此字段时可使用 lastMessagePreview。
      */
     lastMessageSummary?: LastMessageSummary;
     /** 最后一条消息发送者 id（群会话列表预览「发送者名: 内容」前缀用；`'system'`=系统提示、==自己=我发的，前缀策略由宿主定）。 */
@@ -1000,7 +1020,7 @@ interface ImSession {
      * 会话内容仍显示最新一条消息。收到别人 @我 +1、查看/已读该会话清零。投影自 ReadState.mentionUnreadCount，与 unreadCount 同源持久化。
      */
     mentionUnreadCount?: number;
-    /** P0 排序时间（毫秒 number）。 */
+    /** 排序时间（毫秒 number）。 */
     timestamp: number;
     /**
      * 用户手工添加的本地“稍后处理”提醒。
@@ -1016,7 +1036,7 @@ interface ImSession {
     topTime?: number;
     /**
      * 最新一条消息若为「己方且未完成发送」的态：'sending'（pending/uploading/sending 统一）/ 'failed'。
-     * 派生展示字段（随最新消息变化，会话列表据此显示发送中 loading / 失败图标）；运行期真相，不持久化（persistSession 落盘时剔除）。
+     * 派生展示字段（随最新消息变化，会话列表据此显示发送中 loading / 失败图标）；运行期真相，不持久化（persistSession 写入本地存储时剔除）。
      */
     lastMessageSendState?: 'sending' | 'failed';
     /**
@@ -1024,11 +1044,11 @@ interface ImSession {
      *
      * 只在自己发出且 `status='sent'` 时投影；发送中/失败、对端消息、撤回、全员删除和系统提示都不给。
      * `delivered` 与尚未回执一样投影为 `unread`；当前协议没有送达通知，不能把 `sent` 当作对端已收到。
-     * 该字段随最新消息变化，并随会话落盘，避免冷启动后
+     * 该字段随最新消息变化，并随会话写入本地存储，避免冷启动后
      * 因「盘中缺字段 / 内存有字段」反复广播；对端已读变化必须刷新会话行。
      */
     lastMessageReceipt?: 'unread' | 'read';
-    /** P0 我方已读游标（见 §4.3）。 */
+    /** 我方已读游标（见 §4.3）。 */
     readCursor?: string;
     /** 群受限状态（仅 group；来自 0x2204 群通知 side-effect）。缺省视为 'active'（可正常发送）。 */
     groupState?: GroupSessionState;
@@ -1059,12 +1079,12 @@ interface OutboxUpdate {
 }
 /** 发送队列项（§4.4）。id 复用对应 ImMessage.id 以保证重试幂等。 */
 interface OutboxMessage {
-    /** P0 == 对应 ImMessage.id（客户端生成，重试时复用以保证幂等）。 */
+    /** == 对应 ImMessage.id（客户端生成，重试时复用以保证幂等）。 */
     id: string;
     conversationId: string;
     conversationType: ConversationType;
     contentType: MessageContentType;
-    /** P0 待发送内容（明文；加密在发送管线内按 encryption 处理）。 */
+    /** 待发送内容（明文；加密在发送管线内按 encryption 处理）。 */
     body: ImMessageBody;
     /** 群 @ 提及（发送侧：宿主从输入框提取；正文 body.text 已含 [userId] token / @所有人 文字，本字段供群发送策略编码 sNotifyUsers/nNotifyCount/extend）。仅群 @ 消息有。 */
     mention?: ImMessageMention;
@@ -1078,7 +1098,7 @@ interface OutboxMessage {
     /**
      * 复发策略（生命周期 logout 语义）：`automatic`（默认，缺省视同）= onAuthenticated/断线重连时自动复发；
      * `manual` = 仅用户显式 retry 才发（logout 时把在途消息置 manual，避免退账号后下次登录无提示自动补发）。
-     * 持久化随账本落盘，故 logout(preserve)→重登后仍为 manual，不被自动复发；retry 会翻回 automatic。缺省（旧账本）按 automatic 处理（向后兼容）。
+     * 持久化随账本写入本地存储，故 logout(preserve)→重登后仍为 manual，不被自动复发；retry 会翻回 automatic。缺省（旧账本）按 automatic 处理（向后兼容）。
      */
     resumePolicy?: 'automatic' | 'manual';
 }
@@ -1131,7 +1151,7 @@ interface ContactRemarkPhone {
     countryCode: string;
     mobile: string;
 }
-/** 用户资料领域模型（§4.5）。由 ImProfilePort 拉取、映射层归一。 */
+/** 用户资料领域模型（§4.5）。由 ImProfilePort 拉取、映射层转换字段。 */
 interface UserProfile {
     id: string;
     /** 用户自设昵称（后端 `nick_name`）。 */
@@ -1156,7 +1176,7 @@ interface UserProfile {
     remarkPhones?: ContactRemarkPhone[];
     /** 扩展：消息加密公钥来源（§7 复用）。 */
     publicKey?: string;
-    /** 会话免打扰态（好友关系 `is_undisturb` 归一）：仅好友资料返回，供领域层回填 `ImSession.muted` 做多端/冷启动恢复；非好友无此字段（undefined，不覆盖本地）。 */
+    /** 会话免打扰态（好友关系 `is_undisturb` 转换为布尔值）：仅好友资料返回，供领域层回填 `ImSession.muted` 做多端/冷启动恢复；非好友无此字段（undefined，不覆盖本地）。 */
     muted?: boolean;
     extensions?: Record<string, unknown>;
 }
@@ -1172,11 +1192,11 @@ interface GroupProfile {
     verifyWay?: number;
     /** 普通群邀请码；仅 `verifyWay === 4` 时有业务意义。 */
     inviteCode?: string;
-    /** 群状态（后端 status，具体值语义待后端明确）：保留不丢弃，供「普通成员感知群解散」兜底（解散仅通知群主，Review F6）。 */
+    /** 群状态（后端 status，具体值语义待后端明确）：保留不丢弃，供「普通成员感知群解散」兜底（解散仅通知群主）。 */
     status?: number;
-    /** 当前用户是否在群（后端 is_ingroup：false=已不在群，被踢/退群的兜底禁发来源，Review F6）。 */
+    /** 当前用户是否在群（后端 is_ingroup：false=已不在群，被踢/退群的兜底禁发来源）。 */
     isInGroup?: boolean;
-    /** 当前用户对该群的免打扰态（`to_user.is_undisturb` 归一）：供领域层回填 `ImSession.muted` 恢复；缺省（undefined）表示后端未返回，不覆盖本地。 */
+    /** 当前用户对该群的免打扰态（`to_user.is_undisturb` 转换为布尔值）：供领域层回填 `ImSession.muted` 恢复；缺省（undefined）表示后端未返回，不覆盖本地。 */
     muted?: boolean;
     /** 扩展位：members[] 等明细留扩展。 */
     extensions?: Record<string, unknown>;
@@ -1288,9 +1308,9 @@ interface ChannelProfile {
     /** CHANNEL 独立访问限制事实；browser 新映射必须提供，legacy storage 可能缺失。 */
     accessSnapshot?: ChannelAccessSnapshot;
     muted?: boolean;
-    /** 服务端频道类型的归一业务值；不得用它把频道改路由到 `supergroup`。 */
+    /** 服务端频道类型转换后的业务值；不得用它把频道改路由到 `supergroup`。 */
     channelKind?: string;
-    /** 本地密钥缓存代际/服务端未来版本的非敏感标识；不承载 secret_key。 */
+    /** 本地密钥缓存操作编号/服务端未来版本的非敏感标识；不承载 secret_key。 */
     secretKeyVersion?: string;
     /** `/user_radio/list` 的资料增量版本；与 secretKeyVersion 无关。 */
     updateVersion?: string;
@@ -1320,7 +1340,7 @@ interface ChannelMemberPage {
 }
 /** CHANNEL @ 选择器返回的用户项；专用 UserInfo 协议不提供角色，不得写入 role-rich 成员缓存。 */
 interface ChannelMentionMember {
-    /** 归一化用户 ID；来自 `/user_radio/member/*` 的 `user_id`。 */
+    /** 用户 ID，以字符串表示；来自 `/user_radio/member/*` 的 `user_id`。 */
     userId: string;
     /** CHANNEL @ 面板展示名；按频道昵称、全局昵称、协议备用名、用户 ID 的顺序降级。 */
     displayName: string;
@@ -1353,7 +1373,7 @@ interface ImError {
  * 诊断日志钩子（§5.3，可选）：宿主注入以观察核心诊断（如 ACK 原始 errcode）。
  * core 不内置 console；不注入则不产生诊断输出。
  */
-/** 连接策略（§8.3）。P0 固定 'single'，'race'/'sequential' 留 P1。 */
+/** 当前连接策略固定为 single，只连接首个端点。 */
 type ConnectionStrategy = 'single' | 'race' | 'sequential';
 interface ImReconnectOptions {
     /** 退避基数毫秒，默认 1000。 */
@@ -1484,7 +1504,7 @@ interface ChannelJoinApplication {
     channelAvatar?: string;
     /** 申请人填写的入群说明，服务端允许为空。 */
     message: string;
-    /** 服务端创建时间归一为 Unix 毫秒；源字段缺失或非法时不提供。 */
+    /** 服务端创建时间转换为 Unix 毫秒；源字段缺失或非法时不提供。 */
     createdAt?: number;
 }
 /**
@@ -1549,7 +1569,7 @@ interface TransportEndpoint {
 }
 
 interface ImEndpointProvider {
-    /** WS 候选地址。P0 返回单元素数组；后端下发多 host 时返回多元素。 */
+    /** WS 候选地址。返回单元素数组；后端下发多 host 时返回多元素。 */
     getEndpoints: () => Promise<TransportEndpoint[]>;
     /** CM Protobuf HTTP 基址。 */
     getCmHttpBaseUrl: () => Promise<string>;
@@ -1956,7 +1976,7 @@ declare function extractSearchText(message: Pick<ImMessage, 'contentType' | 'bod
  *
  * @remarks 拉丁字母统一为 A-Z；中文按整段文本上下文取首字读音的首字母，多音字随词语变化；
  * 数字、符号和 emoji 归入 `#`。
- * 该工具只负责文本归一，不持有目录或 UI 状态，H5/PC 可以共享同一规则。
+ * 该工具只负责文本处理，不持有目录或 UI 状态，H5/PC 可以共享同一规则。
  */
 declare function getImTextSearchInitial(text: string): Promise<string>;
 /**
@@ -2030,7 +2050,7 @@ interface ResolveTextOptions<Extra = never> {
 }
 /**
  * 把消息正文解析为内联富文本展示段：内置 @ matcher（协议）+ 宿主注入 matcher（应用）各自产出命中区间，
- * SDK 统一**按位置合并、区间不重叠**（一个字符只归一个段）。空文本 → 单空段；无任何命中 → 整段文本。
+ * SDK 统一**按位置合并、区间不重叠**（一个字符只属于一个段）。空文本 → 单空段；无任何命中 → 整段文本。
  * **冲突/重叠优先级**（稳定）：① 起点靠前优先；② 同起点更长（更具体）优先；③ 仍相同按注册顺序——
  * 内置 @ 最先 push（协议安全类优先），其余按 `opts.matchers` 顺序。靠后的重叠区间在 assemble 中让位跳过。
  */
@@ -2122,7 +2142,7 @@ interface MessageWindowPage {
 
 /**
  * 全局总未读聚合规则（mute-aware · 通用）：默认排除免打扰会话（对齐主流 IM：静音会话不进 App 总角标）。
- * 免打扰会话的「@我未读」聚合待 `mentionUnreadCount` 落地后再加（P0 未填充）。
+ * 免打扰会话的「@我未读」聚合待 `mentionUnreadCount` 落地后再加（未填充）。
  * @param sessions 会话快照。
  * @param options 聚合选项。
  * @param options.includeMuted 是否把免打扰会话也计入总数（默认 false）。
@@ -2148,7 +2168,7 @@ interface ImGroupCallMeetingSnapshot {
  * 根据 CHANNEL 角色、生命周期和禁言事实计算稳定访问能力。
  *
  * 这是无副作用的权限投影：输入来自权威 profile/session，输出供发送和 UI 预检使用；服务端仍做最终
- * 权限裁决。未知或冲突状态不会借 GROUP 权限兜底，而是收敛到受限能力与明确原因。
+ * 权限裁决。未知或冲突状态不会借 GROUP 权限兜底，而是转换为受限能力与明确原因。
  */
 
 /** CHANNEL 有效访问解析入参；`nowMs` 显式传入，使 hydrate、发送门禁与 Web 时钟使用同一纯逻辑。 */
@@ -2402,6 +2422,14 @@ interface GroupMemberItem {
     joinType?: number;
 }
 
+/** 客服号公开展示资料；不携带后台发送者身份或网络路由参数。 */
+interface CustomerServiceProfile {
+    /** 当前语言的客服名称。 */
+    displayName: string;
+    /** 当前语言的头像地址；服务端未配置时为空。 */
+    avatarUrl: string;
+}
+
 /** 服务端对入群请求的最终裁决：已入群，或已提交并等待管理员审核。 */
 type MembershipJoinOutcome = 'joined' | 'waiting';
 /** Browser adapter 暴露给 SDK 的稳定入群结果，不携带具体 HTTP 响应结构。 */
@@ -2410,7 +2438,7 @@ interface MembershipJoinResult {
     outcome: MembershipJoinOutcome;
 }
 
-/** 服务端按逻辑桶签发的 S3 临时上传凭证（已归一为 SDK 合同字段）。 */
+/** 服务端按逻辑桶签发的 S3 临时上传凭证（已转换为 SDK 合同字段）。 */
 interface MediaUploadCredentials {
     /** STS access key id（服务端字段 `access_key_id`）。 */
     accessKeyId: string;
@@ -2426,7 +2454,7 @@ interface MediaUploadCredentials {
     region: string;
     /** 对象 key 前缀；STS 策略只允许写该前缀下的对象，SDK 生成的 key 必须以它开头。 */
     keyPrefix?: string;
-    /** 公开访问域名（已归一为带 scheme、无尾斜杠）；写进消息体的媒体 URL 以它为准。 */
+    /** 公开访问域名（已转换为带 scheme、无尾斜杠）；写进消息体的媒体 URL 以它为准。 */
     dnsPoint: string;
     /** 服务端身份标识；SDK 不使用，仅原样透出供宿主排查。 */
     identityId?: string;
@@ -2447,13 +2475,13 @@ interface MediaUploadCredentialsRequest {
  */
 type MediaUploadCredentialsProvider = (request: MediaUploadCredentialsRequest) => Promise<MediaUploadCredentials>;
 /**
- * 把服务端原始回包归一为 `MediaUploadCredentials`，同时兼容 snake_case 与 camelCase。
+ * 把服务端原始回包转换为 `MediaUploadCredentials`，同时兼容 snake_case 与 camelCase。
  *
  * 宿主可直接用它解析自己 BFF 的返回值，避免 PC 与 H5 各写一份宽松解析；SDK 在收到 provider
  * 结果后也会再跑一次本函数，因此绕过它自行构造的对象同样会被校验。
  *
  * @param raw 凭证对象本身（不含 code/msg 外层包装，由宿主先拆包）。
- * @returns 归一后的凭证；关键字段缺失或非法时抛 `MediaTransferError('credentials-invalid')`，不返回半份凭证。
+ * @returns 转换后的凭证；关键字段缺失或非法时抛 `MediaTransferError('credentials-invalid')`，不返回半份凭证。
  */
 declare function normalizeMediaUploadCredentials(raw: unknown): MediaUploadCredentials;
 
@@ -3045,7 +3073,7 @@ interface MentionCandidatePage {
 /**
  * CHANNEL role-free @候选产品 sibling。
  *
- * @remarks list/search 使用独立缓存与 token 上下文；token 只在创建它的账号 runtime、查询类型和频道代际内有效。
+ * @remarks list/search 使用独立缓存与 token 上下文；token 只在创建它的账号 runtime、查询类型和频道缓存版本号内有效。
  * 本 API 不读取 role-rich 成员 provider，也不包含已退场的 @消息索引/定位能力。
  * @example
  * ```ts
@@ -3059,13 +3087,13 @@ interface ImChannelMentionApi {
     peekFirstPage: (channel: ConversationRef<'channel'>) => MentionCandidatePage | null;
     /** 从已 hydrate 的常用候选快照做同步直接文本过滤；不发远端搜索请求。 */
     peekSearchCandidates: (channel: ConversationRef<'channel'>, keyword: string) => readonly MentionCandidate[];
-    /** hydrate 持久快照并返回本地首页或直接/拼音搜索结果；cache miss 返回 null，绝不回源。 */
+    /** hydrate 持久快照并返回本地首页或直接/拼音搜索结果；cache miss 返回 null，绝不请求服务端。 */
     getCachedPage: (channel: ConversationRef<'channel'>, keyword?: string) => Promise<MentionCandidatePage | null>;
     /** hydrate 持久快照，并在缺失/过期时按完整页预热约 200 人；同频道在途任务复用。 */
     prefetchFirstPage: (channel: ConversationRef<'channel'>) => Promise<void>;
     /** 强制从专用 mention provider 重建约 200 人常用候选快照。 */
     refreshFirstPage: (channel: ConversationRef<'channel'>) => Promise<MentionCandidatePage>;
-    /** 读取常用候选快照；内存 miss 时先读持久层，均未命中才回源。 */
+    /** 读取常用候选；内存未命中时先读本地存储，两处都没有才查询服务端。 */
     listFirstPage: (channel: ConversationRef<'channel'>) => Promise<MentionCandidatePage>;
     /** 使用 list 页产生的 token 继续分页；search token 会被拒绝。 */
     listNextPage: (pageToken: ImPageToken) => Promise<MentionCandidatePage>;
@@ -3124,7 +3152,7 @@ interface ImDirectorySearchApi {
     search: (keyword: string) => Promise<ImDirectorySearchResult>;
 }
 
-/** 回源失败的原因与能否重试。 */
+/** 服务端消息查询失败的原因，以及是否允许重试。 */
 interface MessagesByIdFailure {
     /**
      * 能否稍后重试。
@@ -3136,7 +3164,10 @@ interface MessagesByIdFailure {
     /** 原始错误，供诊断与上报。 */
     error: unknown;
 }
-/** 回源的汇总结果。三组 id 互不重叠，合起来覆盖调用方传入的全部有效 id。 */
+/**
+ * 服务端消息查询汇总。三组 ID 互不重叠，合起来覆盖调用方传入的全部有效 ID。
+ * @template TMessage 调用方需要的消息展示类型，由 projectMessage 从领域消息转换得到。
+ */
 interface ImMessagesByIdResult<TMessage> {
     /** 成功取回的消息。已经进了本地历史，后续本地查询就能命中。 */
     readonly messages: readonly TMessage[];
@@ -3158,7 +3189,7 @@ interface ImMessagesByIdResult<TMessage> {
  * SDK 内部 CHANNEL sibling：装配资料、成员、申请、置顶、历史限制与通知修复能力。
  *
  * 所有入口都要求精确 CHANNEL 身份，并把协议 I/O 结果提交到当前账号的同一 DomainState；不会复用
- * GROUP 端口或为 `supergroup` fallback。运行时 dispose 后，在途 HTTP/回源结果必须失效，不能广播旧账号事件。
+ * GROUP 端口或为 `supergroup` fallback。运行时 dispose 后，在途 HTTP 查询的结果必须失效，不能广播旧账号事件。
  */
 
 /** CHANNEL 资料、成员和申请门面；已退场的 Mention 历史定位不进入产品面。 */
@@ -3183,7 +3214,7 @@ interface ImChannelApi extends ImDirectoryApi<'channel'> {
         cursor?: string;
         limit?: number;
     }) => Promise<ChannelMemberPage>;
-    /** 进入 CHANNEL 时预热 role-rich 有界成员快照；缓存新鲜时不回源。 */
+    /** 进入 CHANNEL 时预取含成员角色的有限列表；缓存未过期时不重复请求服务端。 */
     prefetchMembers: (channelId: string) => Promise<void>;
     /** 读取 role-rich 有界快照或本地搜索命中；不触发远端请求。 */
     getCachedMembers: (input: {
@@ -3332,7 +3363,7 @@ interface ImContactApi extends ImDirectoryApi<'individual'> {
     getProfile: (userId: string, opts?: {
         forceRefresh?: boolean;
     }) => Promise<UserProfile | null>;
-    /** 仅读内存/持久化，不回源 HTTP；命中时显式返回 stale。 */
+    /** 只读内存或本地存储，不发 HTTP；命中时明确返回 stale，提醒调用方缓存可能已过期。 */
     peekProfile: (userId: string) => Promise<{
         value: UserProfile;
         stale: boolean;
@@ -3382,7 +3413,7 @@ interface ConversationPrefetchOptions {
  * skipped 表示当前类型、权限、存储或预算不允许预取；失败不改变正常打开会话的行为。
  */
 interface ConversationPrefetchResult {
-    ref: ConversationRef<'direct' | 'group' | 'channel' | 'robot'>;
+    ref: ConversationRef<'direct' | 'group' | 'channel' | 'robot' | 'customerService'>;
     status: 'ready' | 'skipped' | 'failed' | 'cancelled';
     reason?: 'unsupported' | 'unavailable' | 'storage-unavailable' | 'budget' | 'page-too-large' | 'decrypt-failed' | 'invalidated' | 'cancelled';
     error?: ImSdkErrorShape;
@@ -3390,7 +3421,7 @@ interface ConversationPrefetchResult {
 
 /**
  * 当前账号草稿的产品 DTO、跨组件 API 与 handle 绑定门面。
- * 草稿按复合会话身份串行持久化，SDK DomainState 是唯一真相；附件尚未闭合时非空输入明确拒绝。
+ * 草稿按会话类型和 ID 串行保存，统一由 SDK DomainState 管理；当前不支持保存附件，非空附件输入会被明确拒绝。
  */
 
 /** 当前产品草稿实体；只包含可持久化的 text/mention/reply，附件集合固定为空。 */
@@ -3453,7 +3484,7 @@ interface ImDraftsApi {
  */
 
 /** 当前兼容门面支持的精确会话 ref。 */
-type ImSupportedConversationRef = ConversationRef<'direct' | 'group' | 'channel' | 'robot'>;
+type ImSupportedConversationRef = ConversationRef<'direct' | 'group' | 'channel' | 'robot' | 'customerService'>;
 /**
  * 会话 API 的迁移期入参。优先传完整 ref；旧 string 仅在当前 session 中唯一命中时可用。
  *
@@ -3461,10 +3492,10 @@ type ImSupportedConversationRef = ConversationRef<'direct' | 'group' | 'channel'
  */
 type ImConversationInput = ImSupportedConversationRef | string;
 /**
- * 会话列表兼容读模型；草稿是当前账号本机即时投影，不进入 session durable 行，也不承诺跨端同步。
+ * 内部会话列表数据。草稿反映当前账号的本机输入，不写入会话持久记录，也不跨端同步。
  *
- * @remarks Phase 7 消费方迁移前保留 ImSession 展示字段；新代码应优先读取复合身份语义与 draft，不自行拼主键。
- * @example `client.conversations.list().find(item => item.draft !== null)` 可找到当前账号有未发送草稿的会话。
+ * 保留 ImSession 的展示字段供内部调用方使用；跨类型识别会话时必须使用会话类型 + ID，不自行拼接主键。
+ * @example client.conversations.list().find(item => item.draft !== null) 可找到当前账号有未发送草稿的会话。
  */
 interface ConversationListItem$1 extends ImSession {
     draft: ConversationDraft | null;
@@ -3491,7 +3522,7 @@ interface ImConversationsApi {
     markConversationRead: (conversation: ImConversationInput) => Promise<void>;
     /** 给已无真实未读的会话添加本地未读提醒；不回退消息已读状态，也不发网络请求。 */
     markConversationUnread: (conversation: ImConversationInput) => void;
-    /** 删除本机会话、消息、读态与草稿；立即发布对应本地事件，durable 删除失败经 storage error 暴露，离线历史受 tombstone 约束。 */
+    /** 删除本机会话、消息、已读状态和草稿并立即发布本地事件；存储删除失败会报告 storage error，本地删除标记阻止离线消息恢复已删除内容。 */
     deleteConversation: (conversation: ImConversationInput) => void;
 }
 
@@ -3591,16 +3622,16 @@ declare class ImPinnedMessageOperationError extends Error {
 }
 
 /**
- * SDK 内部普通群 sibling：装配群资料、成员名称、`@` 候选和群置顶主动操作。
+ * SDK 内部普通群模块：提供群资料、成员名称、@ 候选和群置顶操作。
  *
  * 本模块只接收 GROUP `ConversationRef`，使用普通群独立 HTTP/mapper，并回写当前账号唯一 DomainState。
- * CHANNEL 的角色、申请、成员治理和置顶协议不从这里兼容；dispose 会作废回源与协调器结果。
+ * CHANNEL 的角色、申请、成员管理和置顶协议由独立模块处理；dispose 后旧查询和协调任务的结果不再生效。
  */
 
 /**
  * GROUP 完整 @候选集合产品面。
  *
- * @remarks `listAll` 使用账号级产品缓存；`refreshAll` 显式绕过缓存回源。两者只消费普通群完整成员 provider，
+ * @remarks `listAll` 使用账号级产品缓存；`refreshAll` 绕过缓存重新请求服务端。两者只消费普通群完整成员 provider，
  * 不接受 CHANNEL 分页 cursor/provider。缺少 provider、远端失败或不完整结果会拒绝，不用空数组伪装失败。
  * @example
  * ```ts
@@ -3612,7 +3643,7 @@ declare class ImPinnedMessageOperationError extends Error {
 interface ImGroupMentionApi {
     /** 读取完整候选集合；同群并发读取复用请求，成功结果按 userId 稳定去重并缓存。 */
     listAll: (group: ConversationRef<'group'>) => Promise<readonly MentionCandidate[]>;
-    /** 显式回源刷新完整候选；并发刷新复用请求，失败保留此前成功缓存。 */
+    /** 显式向服务端重新查询完整候选；并发刷新复用请求，失败保留此前成功缓存。 */
     refreshAll: (group: ConversationRef<'group'>) => Promise<readonly MentionCandidate[]>;
 }
 /** GROUP 资料、成员缓存、@候选与单条置顶门面；不与 CHANNEL 合并。 */
@@ -3631,17 +3662,17 @@ interface ImGroupApi extends ImDirectoryApi<'group'> {
     getMemberNames: (groupId: string, opts?: {
         forceRefresh?: boolean;
     }) => Promise<Record<string, string> | null>;
-    /** 仅读普通群成员缓存，不回源。 */
+    /** 仅读普通群成员缓存，不请求服务端。 */
     peekMembers: (groupId: string) => Promise<{
         value: GroupMemberItem[];
         stale: boolean;
     } | null>;
-    /** 仅读普通群昵称缓存，不回源。 */
+    /** 仅读普通群昵称缓存，不请求服务端。 */
     peekMemberNames: (groupId: string) => Promise<{
         value: Record<string, string>;
         stale: boolean;
     } | null>;
-    /** 仅读普通群资料缓存，不回源。 */
+    /** 仅读普通群资料缓存，不请求服务端。 */
     peekProfile: (groupId: string) => Promise<{
         value: GroupProfile;
         stale: boolean;
@@ -3690,7 +3721,7 @@ interface ImGroupApi extends ImDirectoryApi<'group'> {
 }
 
 /**
- * SDK 资源轴与连接轴的稳定生命周期合同。
+ * SDK 账号资源和网络连接的稳定生命周期合同。
  * 账号准备、联网和 logout 保持可区分；快照不包含 token、transport、storage 句柄或宿主认证状态。
  */
 
@@ -3699,9 +3730,9 @@ interface ImClientSnapshot {
     connectionState: ImConnectionState;
     pendingOutbox: OutboxMessage[];
 }
-/** 会话资源生命周期；与连接状态轴正交。 */
+/** 账号资源的准备和释放状态；网络连接状态单独记录，二者互不替代。 */
 type ImSessionLifecycleState = 'empty' | 'preparing' | 'ready' | 'logging-out' | 'disposed';
-/** 会话资源轴、连接轴与常用派生状态。 */
+/** 账号资源状态、网络连接状态，以及由二者计算的便捷状态。 */
 interface ImLifecycleSnapshot {
     sessionState: ImSessionLifecycleState;
     connectionState: ImConnectionState;
@@ -3810,7 +3841,7 @@ type ImApplicationItem = (ApplicationItemBase<'contact-request', ContactApplicat
  * typed application inbox 产品面。
  *
  * @remarks `listPending` 只有在 contact/GROUP/CHANNEL 三个 provider 全部成功时才返回完整快照；审核动作按 ref.domain
- * 精确回到 sibling。CHANNEL invite type=5 不属于已闭合 provider，因此不会出现在结果中。
+ * 精确回到 sibling。CHANNEL invite type=5 不属于已确认 provider，因此不会出现在结果中。
  * @example
  * ```ts
  * const pending = await client.applications.listPending()
@@ -3880,13 +3911,13 @@ interface ImDirectCallsApi {
 }
 
 /**
- * 会话背景的产品选择、预设读取和持久化解析运行时。
+ * 管理会话背景选择、预设读取和本地保存。
  *
- * SDK 保存 builtin/preset/custom 的稳定选择及账号默认值，不保存 DOM、图片元素或 object URL；自定义图片
- * Blob 只经 storage 持久化。异步读取使用运行时代际防止切会话/切账号晚返回，宿主负责最终渲染与 URL 释放。
+ * SDK 保存 builtin/preset/custom 选择及账号默认值；自定义图片 Blob 经 storage 保存，不持有 DOM、图片元素或 object URL。
+ * 异步读取返回时核对运行环境版本，防止切会话或切账号后应用旧结果；宿主负责最终渲染和 URL 释放。
  */
 
-type ConversationBackgroundConversationType = 'direct' | 'group' | 'channel' | 'robot';
+type ConversationBackgroundConversationType = 'direct' | 'group' | 'channel' | 'robot' | 'customerService';
 interface ConversationBackgroundPreset {
     id: string;
     url: string;
@@ -3925,9 +3956,9 @@ interface ImConversationBackgroundApi {
 }
 
 /**
- * 联系人、普通群和 CHANNEL 资料的稳定产品 DTO 投影。
+ * 把联系人、普通群和 CHANNEL 资料转换为稳定产品数据。
  *
- * 本文件只做复制、权限归一化与错误收敛，不缓存资料，也不发 HTTP。GROUP/CHANNEL 各自保留业务字段，
+ * 本文件只复制字段、统一权限格式和转换错误，不缓存资料，也不发 HTTP。GROUP/CHANNEL 各自保留业务字段，
  * 公钥、访问快照、密钥版本、协议状态和 core extensions 都不会进入 default API。
  */
 
@@ -3950,14 +3981,14 @@ interface ImContactRemarkPhone {
     countryCode: string;
     mobile: string;
 }
-/** default GROUP 资料 DTO；后端未闭合的数值 status 与缓存扩展不进入产品面。 */
+/** default GROUP 资料 DTO；后端尚未确认的数值 status 与缓存扩展不进入产品面。 */
 interface ImGroupProfile {
     ref: ConversationRef<'group'>;
     name: string;
     avatar?: string;
     memberCount?: number;
     ownerId?: string;
-    /** 普通群入群验证方式（1/2/4 为当前可设置值；未知值不在产品层静默归一）。 */
+    /** 普通群入群验证方式（1/2/4 为当前可设置值）；未知值不能在产品层被自动改写。 */
     verifyWay?: number;
     /** 普通群邀请码；仅邀请码模式有意义。 */
     inviteCode?: string;
@@ -4048,7 +4079,7 @@ interface ImChannelProfile {
  */
 
 /** default 会话列表支持的精确类型；`supergroup` 继续受产品 Gate 约束。 */
-type ProductConversationListType = 'direct' | 'group' | 'channel' | 'robot';
+type ProductConversationListType = 'direct' | 'group' | 'channel' | 'robot' | 'customerService';
 /** GROUP 会话限制状态；与 CHANNEL 状态保持独立 sibling。 */
 type ImGroupConversationState = GroupSessionState;
 /**
@@ -4219,8 +4250,8 @@ interface ImConversationListSnapshot {
  * default 会话列表产品面。
  *
  * @remarks
- * `list()` 保留 Phase 5 已验证的同步本地读模型；`getSnapshot/subscribe` 为普通宿主提供原子列表和总未读。
- * 所有写动作只接受复合身份。`deleteLocal` 立即提交内存删除事件，但底层 durable 删除仍是异步 best-effort，
+ * `list()` 同步读取本机会话；`getSnapshot/subscribe` 为普通宿主提供同一时刻的列表和总未读。
+ * 所有写动作只接受复合身份。`deleteLocal` 立即提交内存删除事件，但底层存储删除仍异步执行，失败会报告错误，
  * 因此该方法不虚假返回代表“持久化已完成”的 Promise。
  *
  * @example
@@ -4282,6 +4313,17 @@ interface DirectConversationCapabilities {
     canUseMessageActions: CapabilityDecision;
     canManageRelationship: CapabilityDecision;
 }
+/** 客服只读能力；资料、发送和消息修改均不可用，历史读取仅限本机已接收消息。 */
+interface CustomerServiceConversationCapabilities {
+    /** 客服号不可发送消息。 */
+    canSendMessages: CapabilityDecision;
+    /** 客服号没有好友或成员资料页。 */
+    canOpenProfile: CapabilityDecision;
+    /** 客服号不开放消息修改与转发等动作。 */
+    canUseMessageActions: CapabilityDecision;
+    /** 允许读取客服本机历史。 */
+    canReadHistory: CapabilityDecision;
+}
 interface RobotConversationCapabilities {
     canSendMessages: CapabilityDecision;
     canOpenProfile: CapabilityDecision;
@@ -4356,6 +4398,8 @@ type ConversationCapabilitySnapshot = (ConversationCapabilityBase<'direct'> & {
     value: ChannelConversationCapabilities;
 }) | (ConversationCapabilityBase<'robot'> & {
     value: RobotConversationCapabilities;
+}) | (ConversationCapabilityBase<'customerService'> & {
+    value: CustomerServiceConversationCapabilities;
 });
 interface ImConversationCapabilitiesApi {
     /** 只读取 SDK 当前本机真相与已刷新过的资料/关系投影，不隐式联网。 */
@@ -4507,7 +4551,7 @@ interface ImExpressionsApi {
  */
 
 /** 当前已接线的产品 handle 会话类型；三者只在无会话语义原子层复用。 */
-type ProductHandleConversationType = 'direct' | 'group' | 'channel' | 'robot';
+type ProductHandleConversationType = 'direct' | 'group' | 'channel' | 'robot' | 'customerService';
 /**
  * 会话 handle 初始打开位置。
  *
@@ -4569,9 +4613,9 @@ interface ConversationHandleSnapshot<TType extends ProductHandleConversationType
     error?: ImSdkErrorShape;
 }
 /**
- * 单条消息本机删除结果。
+ * 单条消息的本机删除结果。
  *
- * @remarks `scope` 永远是 `local-only`；该动作不发送撤回/双删命令，也不建立远端墓碑，因此重新加载远端历史可能恢复同一消息。
+ * scope 固定为 local-only；该动作不发送撤回或双方删除命令，也不会让服务端标记删除，重新加载远端历史时可能再次出现同一消息。
  */
 interface LocalMessageDeletionResult {
     scope: 'local-only';
@@ -4844,8 +4888,8 @@ type ConversationMessageApiFor<TType extends ProductHandleConversationType> = TT
 /**
  * 绑定单个复合会话身份的产品级会话句柄。
  *
- * @remarks 每次打开都持有独立连续窗口；`close()` 只释放瞬时窗口和订阅，不删除领域消息。direct/GROUP/CHANNEL
- * 由各自 sibling 工厂接入；草稿属于 Phase 5。关闭后所有读取与动作均 fail-fast。
+ * @remarks 每次打开都持有独立连续窗口；`close()` 只释放瞬时窗口和订阅，不删除领域消息。各会话类型
+ * 使用各自工厂；草稿经 drafts API 维护。关闭后继续读取或执行动作都会立即报错。
  * @template TType 当前句柄绑定的精确会话类型。
  * @example
  * ```ts
@@ -4911,6 +4955,18 @@ interface ConversationHandle<TType extends ProductHandleConversationType = Produ
     close: () => void;
 }
 
+/** 只读客服号资料；账号由 SDK runtime 绑定，宿主只提供当前语言。 */
+interface ImCustomerServiceApi {
+    /** 下载当前账号客服消息的指定文件；返回真实字节，不使用展示大小判断完成。 */
+    downloadFile: (input: {
+        messageId: string;
+        itemIndex: number;
+        signal?: AbortSignal;
+    }) => Promise<Blob>;
+    /** 获取并更新已有会话的显示资料；并发请求按语言合并，过期语言不覆盖当前页面。 */
+    getProfile: (lang: number) => Promise<Readonly<CustomerServiceProfile>>;
+}
+
 /**
  * SDK 对外的结构化诊断投影、过滤与 sink 装配。
  *
@@ -4984,7 +5040,7 @@ interface ImDebugOptions {
 declare const IM_DIAGNOSTIC_CATEGORIES: readonly ImDiagnosticCategory[];
 /** SDK 默认控制台 sink；Core/Chat Kit/Pinia/Worker 不直接访问 console。 */
 declare function createImConsoleDiagnosticSink(): ImDiagnosticSink;
-/** 把产品 `debug` 配置归一成单 Runtime writer；自定义 sink 失败时仅由默认 sink 报告一次。 */
+/** 把产品 debug 配置转换为当前账号唯一的诊断输出器；自定义输出失败时由默认输出器报告一次。 */
 declare function createSdkDiagnosticWriter(debug: boolean | ImDebugOptions | undefined, getRuntimeContext: () => {
     accountId?: string;
     generation?: number;
@@ -5032,7 +5088,7 @@ interface ImMediaTask {
     direction: 'upload' | 'download';
     /** 终态 completed/failed/canceled 不会被同一尝试的迟到 progress 回退。 */
     state: 'queued' | 'running' | 'paused' | 'completed' | 'failed' | 'canceled';
-    /** 0-100 的归一化整数。 */
+    /** 范围为 0 到 100 的整数进度。 */
     percent: number;
     /**
      * upload 子阶段。
@@ -5215,7 +5271,7 @@ interface ImMediaTasksApi {
  * 可靠发送账本的产品查询、订阅、重试和取消门面。
  *
  * Core Outbox 是唯一发送真相；产品项只暴露消息身份、状态和安全错误，不泄漏尝试次数或恢复策略。
- * 控制动作始终回到当前账号 connection，dispose 后旧订阅和晚返回结果失效，取消 queued 不等价于远端撤回。
+ * 控制动作始终回到当前账号 connection，dispose 后旧订阅失效，随后返回的旧结果不再生效，取消 queued 不等价于远端撤回。
  */
 
 /** 产品可观察 Outbox 项；不包含正文、帧、ACK、attempts、加密信息或 resumePolicy。 */
@@ -5776,7 +5832,7 @@ interface ImMessageSearchApi {
     inDirect: (conversation: ConversationRef<'direct'>, keyword: string) => Promise<ProductMessageSearchPage<MessageContentType>>;
     /** 搜索 GROUP 本地历史；不得接受 CHANNEL ref 或回退 direct。 */
     inGroup: (conversation: ConversationRef<'group'>, keyword: string) => Promise<ProductMessageSearchPage<MessageContentType>>;
-    /** 搜索 CHANNEL 本地历史；当前不调用未闭合的远端 CHANNEL 搜索/定位协议。 */
+    /** 搜索 CHANNEL 本地历史；当前不调用尚未确认的远端 CHANNEL 搜索/定位协议。 */
     inChannel: (conversation: ConversationRef<'channel'>, keyword: string) => Promise<ProductMessageSearchPage<MessageContentType>>;
     /** 搜索 robot 本地历史；无远端历史，不得回退 direct。 */
     inRobot: (conversation: ConversationRef<'robot'>, keyword: string) => Promise<ProductMessageSearchPage<MessageContentType>>;
@@ -5909,7 +5965,7 @@ declare function resolveImEmojiToken(token: string): ImEmojiCatalogEntry | undef
  *
  * 上传凭证由业务后端按登录态签发（与 iOS、prod H5 同一个接口），回包同时给出**物理桶**、区域、`key_prefix` 和
  * 公开访问域名；SDK 据此拼 object key 与消息体 URL，宿主 env 里配的只是申请凭证用的逻辑桶名。凭证缓存（本地
- * 1 小时、按服务端过期时间提前 5 分钟失效）、同桶单飞与失败重签由 SDK 负责，宿主只需提供「打一次接口」的纯函数。
+ * 1 小时、按服务端过期时间提前 5 分钟失效）、同桶并发请求复用和失败后重新签发由 SDK 负责，宿主只需提供「打一次接口」的纯函数。
  *
  * 默认单次 PUT/GET；仅 multipartTransfer=true 才允许大资源分片上传、下载。
  * 各 bucket 需在对象存储侧配置 CORS 允许本站 origin 的 PUT + GET；开启分片后，超过 16MiB 的上传另需放行
@@ -6063,7 +6119,7 @@ interface ImContactsApi extends ImDirectoryApi<'individual'> {
      * 发送好友申请。
      *
      * @remarks `remark` 是当前账号对目标用户设置的私有备注，按后端申请合同作为
-     * `remark_nick_name` 提交。SDK 不另存待处理副本；关系建立后从当前账号的权威好友资料收敛展示。
+     * `remark_nick_name` 提交。SDK 不另存待处理副本；关系建立后从当前账号的权威好友资料读取并展示。
      */
     requestFriendship: (userId: string, options: {
         message: string;
@@ -6287,7 +6343,7 @@ interface AdvancedConversationsApi extends ImConversationsApi, ImConversationBac
      *
      * @internal
      */
-    ensureOpenableConversation: (ref: ConversationRef) => Promise<ConversationRef<'direct' | 'group' | 'channel' | 'robot'>>;
+    ensureOpenableConversation: (ref: ConversationRef) => Promise<ConversationRef<'direct' | 'group' | 'channel' | 'robot' | 'customerService'>>;
     /**
      * 读取已有会话或本次账号内已校验的目标资料；返回值不代表列表成员资格。
      * @internal
@@ -6317,6 +6373,8 @@ interface ImProductClient {
     /** 当前账号完整联系人、群组和社群目录的统一搜索。 */
     readonly directory: ImDirectorySearchApi;
     /** 机器人公开目录；通讯录查找与群/社群绑定列表共用分页合同。 */
+    /** 客服号只读资料能力。 */
+    readonly customerService: ImCustomerServiceApi;
     readonly robots: ImRobotsApi;
     readonly contacts: ImContactsApi;
     readonly groups: ImGroupsApi;
@@ -6368,6 +6426,7 @@ interface ImClient extends Omit<ImProductClient, 'capabilities' | 'channels' | '
         (ref: ConversationRef<'group'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'group'>>;
         (ref: ConversationRef<'channel'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'channel'>>;
         (ref: ConversationRef<'robot'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'robot'>>;
+        (ref: ConversationRef<'customerService'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'customerService'>>;
     };
     /** 当前账号草稿产品面；按复合身份持久化，handle.draft 委托同一状态源。 */
     drafts: ImDraftsApi;
@@ -6385,7 +6444,7 @@ interface ImClient extends Omit<ImProductClient, 'capabilities' | 'channels' | '
     contact: ImContactApi;
     /** 群域：群资料读取 + 修改群名/群头像/群内昵称。 */
     group: ImGroupApi;
-    /** CHANNEL 域：资料、成员治理与独立置顶能力；仍未闭合的动作不进入此门面。 */
+    /** CHANNEL 域：资料、成员管理与独立置顶能力；尚未确认的动作不进入此门面。 */
     channel: ImChannelApi;
     /** 可观察媒体任务与按精确消息引用下载。 */
     media: ImMediaTasksApi;
@@ -6549,4 +6608,4 @@ interface ImResourceUploader {
 declare function createImResourceUploader(config: ImResourceUploaderConfig): ImResourceUploader;
 
 export { EDIT_WINDOW_MS, IMAGE_MESSAGE_ACCEPT, IM_CHAT_FONT_SCALES, IM_DIAGNOSTIC_CATEGORIES, IM_EMOJI_CATALOG, ImPinnedMessageOperationError, MEDIA_ALBUM_CAPTION_MAX_LENGTH, MEDIA_ALBUM_MAX_ITEMS, MediaTransferError, REACTION_SUPPORTED_CONTENT_TYPES, buildSessionFavoritePlainBody, canReactToMessage, canTransmit, canTransmitByType, canTransmitContent, classifyStickerImageType, createFaceToFaceGroupQrPayload, createImClient, createImConsoleDiagnosticSink, createImDiagnosticMemoryBuffer, createImResourceUploader, createImTextSearchMatcher, createSdkDiagnosticWriter, createVoicePlayer, createVoiceRecordingSession, detectVoiceCapabilities, extractSearchText, getImTextSearchInitial, isSupportedImageFile, mediaTransferErrorCodeOf, migrateImCachePrefix, normalizeMediaUploadCredentials, parseSessionFavoriteAlbumItems, parseSessionFavoriteFileItems, requiresForwardTypeConfirmation, resolveChannelAccess, resolveImEmojiToken, resolveMediaAlbumSendContentType, resolveSessionFavoriteAlbumCaption, resolveSessionFavoriteAlbumItemPreviewUrl, resolveSessionFavoriteKindFromMessage, resolveTextSegments, sortSessions, sumSessionsUnread, voiceErrorCodeOf };
-export type { CapabilityAvailability, CapabilityDecision, CapabilityReason, ChannelAccessSnapshot, ChannelBaseSessionState, ChannelConversationCapabilities, ChannelConversationMessageApi, ChannelJoinApplication, ChannelJoinApplicationNotification, ChannelJoinApplicationPage, ChannelMember, ChannelMemberPage, ChannelMentionMember, ChannelMentionMemberPage, ChannelMiniProgramRel, ChannelMiniProgramRelConfigType, ChannelMuteReason, ChannelPermissionSet, ChannelProfile, ChannelRole, ChannelSessionState, ContactCardInput, ContactMessageOptions, ConversationBackgroundPreset, ConversationBackgroundSelection, ConversationCapabilitySnapshot, ConversationDraft, ConversationDraftApi, ConversationEntryUnreadNavigation, ConversationEntryUnreadSnapshot, ConversationHandle, ConversationHandleSnapshot, ConversationInitialPosition, ConversationLastMessageSummary, ConversationListItem, ConversationListMention, ConversationMessageApi, ConversationOpenOptions, ConversationPrefetchOptions, ConversationPrefetchResult, ConversationRef, ConversationSearchPage, ConversationSearchResult, ConversationSystemSummary, ConversationType, DirectConversationCapabilities, DirectConversationMessageApi, DraftInput, EditTextOptions, ExpressionMessageOptions, FileMessageOptions, ForwardFailReason, ForwardItemStatus, ForwardMessageFailure, ForwardMessagesInput, ForwardMessagesResult, ForwardTarget, ForwardedMessageRef, GameMessageOptions, GifMessageOptions, GiftMessageOptions, GroupConversationCapabilities, GroupConversationMessageApi, GroupMemberItem, GroupProfile, ImAppearanceSettingsApi, ImApplicationItem, ImApplicationRef, ImApplicationsApi, ImAuthIssue, ImAuthProvider, ImBlockedContact, ImCacheOptions, ImCachePrefixMigrationContext, ImCachePrefixMigrator, ImCallKind, ImCallOutcome, ImCallRecordBody, ImChannelConversationAccessSnapshot, ImChannelMentionApi, ImChannelMiniProgramRel, ImChannelPermissions, ImChannelPinnedMessage, ImChannelProfile, ImChannelRole, ImChannelState, ImChannelsApi, ImChatFontScale, ImClientOptions, ImConnectionState, ImContactBody, ImContactKind, ImContactProfile, ImContactRelationship, ImContactRemarkPhone, ImContactSearchResult, ImContactsApi, ImConversationBackgroundApi, ImConversationCapabilitiesApi, ImConversationListApi, ImConversationListSnapshot, ImConversationListState, ImConversationSearchApi, ImCoreApiOptions, ImCreateChannelInput, ImCreateChannelResult, ImCreateFaceToFaceGroupResult, ImCreateGroupInput, ImCreateGroupResult, ImCreatedChannel, ImCreatedGroup, ImDebugOptions, ImDiagnosticCategory, ImDiagnosticError, ImDiagnosticLayer, ImDiagnosticLevel, ImDiagnosticMemoryBuffer, ImDiagnosticMemoryBufferFilter, ImDiagnosticMemoryBufferOptions, ImDiagnosticMemoryBufferSnapshot, ImDiagnosticMessage, ImDiagnosticRecord, ImDiagnosticSink, ImDiagnosticWriter, ImDirectCallAnswerResult, ImDirectCallFailReason, ImDirectCallHangupInput, ImDirectCallHangupReason, ImDirectCallInviteInput, ImDirectCallNotifyAudioInput, ImDirectCallTargetInput, ImDirectCallsApi, ImDirectReadReceiptSettings, ImDirectoryApi, ImDirectoryFieldMatch, ImDirectoryItem, ImDirectoryKind, ImDirectoryPage, ImDirectorySearchApi, ImDirectorySearchItem, ImDirectorySearchResult, ImDraftsApi, ImEmojiCatalogEntry, ImEndpointProvider, ImEventsApi, ImExpressionAsset, ImExpressionAssetInput, ImExpressionEmojiRecentInput, ImExpressionFavoriteKind, ImExpressionOptions, ImExpressionRecentInput, ImExpressionRecentItem, ImExpressionRecentItemKind, ImExpressionsApi, ImFaceToFaceGroup, ImFileBody, ImFilesAlbumBody, ImFriendshipRequestResult, ImGameBody, ImGameType, ImGifAssetInput, ImGiftBody, ImGiftSessionType, ImGiftStatus, ImGiftType, ImGiphyAsset, ImGiphyPage, ImGiphyPageOptions, ImGroupCallAnswerInput, ImGroupCallBusyInput, ImGroupCallCreateInput, ImGroupCallJoinInput, ImGroupCallMeetingSnapshot, ImGroupCallMember, ImGroupCallMemberStatus, ImGroupCallStatusInput, ImGroupCallTargetInput, ImGroupCallsApi, ImGroupConversationState, ImGroupMentionApi, ImGroupPinnedMessage, ImGroupProfile, ImGroupsApi, ImImageBody, ImLifecycleSnapshot, ImLiveRoomBody, ImLiveRoomStatus, ImLiveRoomType, ImLocalDataApi, ImLocalDataInfo, ImLogoutOptions, ImMediaAlbumBody, ImMediaAlbumItem, ImMediaConfig, ImMediaTask, ImMediaTasksApi, ImMembershipJoinResult, ImMessageMention, ImMessageReactionAggregate, ImMessageReactions, ImMessageRef, ImMessageSearchApi, ImMessageView, ImMessageViewBody, ImMessagesByIdResult, ImMiniProgramBody, ImMiniProgramShowType, ImOutboxApi, ImOutboxItem, ImPageToken, ImPinnedMessageErrorKind, ImPinnedMessageOperation, ImProductApplicationUpdate, ImProductAuthInvalidReason, ImProductClient, ImProductEvent, ImProductEventError, ImProductEventMap, ImProductMessage, ImPushApi, ImPushSnapshot, ImReactionChangeAction, ImReactionChangeResult, ImReadReceiptSettingsApi, ImRedPacketBody, ImRedPacketType, ImRequestError, ImRequestErrorHandler, ImResourceKind, ImResourceUploadInput, ImResourceUploadProgress, ImResourceUploadResult, ImResourceUploader, ImResourceUploaderConfig, ImRobotBody, ImRobotChatMenuItem, ImRobotCommand, ImRobotConversationBindInput, ImRobotDirectoryItem, ImRobotDirectoryPage, ImRobotDirectoryScope, ImRobotMenuReplyInput, ImRobotModule, ImRobotProfile, ImRobotProfileInput, ImRobotsApi, ImSdkErrorCategory, ImSdkErrorShape, ImSearchApi, ImSessionApi, ImSessionFavoriteAlbumItem, ImSessionFavoriteFileItem, ImSessionFavoriteItem, ImSessionFavoriteKind, ImSessionFavoritesApi, ImSessionLifecycleState, ImSettingsApi, ImStickerAssetInput, ImStickerBody, ImStickerPack, ImSupportedConversationRef, ImTextSearchMatch, ImTextSearchMatchOptions, ImTextSearchMatcher, ImTextSearchRange, ImTransferBody, ImTransferSessionType, ImTransferStatus, ImVideoBody, ImVoiceBody, ImWebPushSubscription, ImageMessageOptions, ImagePreviewMetadata, LiveRoomMessageOptions, LocalConversationHistoryClearResult, LocalMessageDeletionResult, LocalVideoPreviewMetadata, MediaAlbumItemInput, MediaAlbumMessageOptions, MediaTransferErrorCode, MediaUploadCredentials, MediaUploadCredentialsProvider, MediaUploadCredentialsRequest, MentionCandidate, MentionCandidatePage, MentionInput, MessageContentType, MessageWindowInfo, MessageWindowPage, MessagesByIdFailure, MigrateImCachePrefixInput, MiniProgramMessageOptions, ProductConversationListType, ProductHandleConversationType, ProductMessageSearchPage, ProductMessageSearchPreviewPart, ProductMessageSearchResult, ResolveTextOptions, ResolvedConversationBackground, RobotConversationCapabilities, SegmentMatch, SegmentMatcher, SendMessageResult, StickerAssetKind, TextMessageOptions, TextSegment, TransferMessageOptions, UnknownMessageBody, UserProfile, VideoMessageOptions, VideoPreviewMetadata, VoiceCapabilities, VoiceErrorCode, VoiceMessageMetadata, VoicePlayer, VoicePlayerOptions, VoicePlayerState, VoiceRecordingResult, VoiceRecordingSession, VoiceRecordingSessionOptions, VoiceRecordingState, VoiceToggleOptions };
+export type { CapabilityAvailability, CapabilityDecision, CapabilityReason, ChannelAccessSnapshot, ChannelBaseSessionState, ChannelConversationCapabilities, ChannelConversationMessageApi, ChannelJoinApplication, ChannelJoinApplicationNotification, ChannelJoinApplicationPage, ChannelMember, ChannelMemberPage, ChannelMentionMember, ChannelMentionMemberPage, ChannelMiniProgramRel, ChannelMiniProgramRelConfigType, ChannelMuteReason, ChannelPermissionSet, ChannelProfile, ChannelRole, ChannelSessionState, ContactCardInput, ContactMessageOptions, ConversationBackgroundPreset, ConversationBackgroundSelection, ConversationCapabilitySnapshot, ConversationDraft, ConversationDraftApi, ConversationEntryUnreadNavigation, ConversationEntryUnreadSnapshot, ConversationHandle, ConversationHandleSnapshot, ConversationInitialPosition, ConversationLastMessageSummary, ConversationListItem, ConversationListMention, ConversationMessageApi, ConversationOpenOptions, ConversationPrefetchOptions, ConversationPrefetchResult, ConversationRef, ConversationSearchPage, ConversationSearchResult, ConversationSystemSummary, ConversationType, CustomerServiceConversationCapabilities, DirectConversationCapabilities, DirectConversationMessageApi, DraftInput, EditTextOptions, ExpressionMessageOptions, FileMessageOptions, ForwardFailReason, ForwardItemStatus, ForwardMessageFailure, ForwardMessagesInput, ForwardMessagesResult, ForwardTarget, ForwardedMessageRef, GameMessageOptions, GifMessageOptions, GiftMessageOptions, GroupConversationCapabilities, GroupConversationMessageApi, GroupMemberItem, GroupProfile, ImAppearanceSettingsApi, ImApplicationItem, ImApplicationRef, ImApplicationsApi, ImAuthIssue, ImAuthProvider, ImBlockedContact, ImCacheOptions, ImCachePrefixMigrationContext, ImCachePrefixMigrator, ImCallKind, ImCallOutcome, ImCallRecordBody, ImChannelConversationAccessSnapshot, ImChannelMentionApi, ImChannelMiniProgramRel, ImChannelPermissions, ImChannelPinnedMessage, ImChannelProfile, ImChannelRole, ImChannelState, ImChannelsApi, ImChatFontScale, ImClientOptions, ImConnectionState, ImContactBody, ImContactKind, ImContactProfile, ImContactRelationship, ImContactRemarkPhone, ImContactSearchResult, ImContactsApi, ImConversationBackgroundApi, ImConversationCapabilitiesApi, ImConversationListApi, ImConversationListSnapshot, ImConversationListState, ImConversationSearchApi, ImCoreApiOptions, ImCreateChannelInput, ImCreateChannelResult, ImCreateFaceToFaceGroupResult, ImCreateGroupInput, ImCreateGroupResult, ImCreatedChannel, ImCreatedGroup, ImCustomerServiceApi, ImDebugOptions, ImDiagnosticCategory, ImDiagnosticError, ImDiagnosticLayer, ImDiagnosticLevel, ImDiagnosticMemoryBuffer, ImDiagnosticMemoryBufferFilter, ImDiagnosticMemoryBufferOptions, ImDiagnosticMemoryBufferSnapshot, ImDiagnosticMessage, ImDiagnosticRecord, ImDiagnosticSink, ImDiagnosticWriter, ImDirectCallAnswerResult, ImDirectCallFailReason, ImDirectCallHangupInput, ImDirectCallHangupReason, ImDirectCallInviteInput, ImDirectCallNotifyAudioInput, ImDirectCallTargetInput, ImDirectCallsApi, ImDirectReadReceiptSettings, ImDirectoryApi, ImDirectoryFieldMatch, ImDirectoryItem, ImDirectoryKind, ImDirectoryPage, ImDirectorySearchApi, ImDirectorySearchItem, ImDirectorySearchResult, ImDraftsApi, ImEmojiCatalogEntry, ImEndpointProvider, ImEventsApi, ImExpressionAsset, ImExpressionAssetInput, ImExpressionEmojiRecentInput, ImExpressionFavoriteKind, ImExpressionOptions, ImExpressionRecentInput, ImExpressionRecentItem, ImExpressionRecentItemKind, ImExpressionsApi, ImFaceToFaceGroup, ImFileBody, ImFilesAlbumBody, ImFriendshipRequestResult, ImGameBody, ImGameType, ImGifAssetInput, ImGiftBody, ImGiftSessionType, ImGiftStatus, ImGiftType, ImGiphyAsset, ImGiphyPage, ImGiphyPageOptions, ImGroupCallAnswerInput, ImGroupCallBusyInput, ImGroupCallCreateInput, ImGroupCallJoinInput, ImGroupCallMeetingSnapshot, ImGroupCallMember, ImGroupCallMemberStatus, ImGroupCallStatusInput, ImGroupCallTargetInput, ImGroupCallsApi, ImGroupConversationState, ImGroupMentionApi, ImGroupPinnedMessage, ImGroupProfile, ImGroupsApi, ImImageBody, ImLifecycleSnapshot, ImLiveRoomBody, ImLiveRoomStatus, ImLiveRoomType, ImLocalDataApi, ImLocalDataInfo, ImLogoutOptions, ImMediaAlbumBody, ImMediaAlbumItem, ImMediaConfig, ImMediaTask, ImMediaTasksApi, ImMembershipJoinResult, ImMessageMention, ImMessageReactionAggregate, ImMessageReactions, ImMessageRef, ImMessageSearchApi, ImMessageView, ImMessageViewBody, ImMessagesByIdResult, ImMiniProgramBody, ImMiniProgramShowType, ImOutboxApi, ImOutboxItem, ImPageToken, ImPinnedMessageErrorKind, ImPinnedMessageOperation, ImProductApplicationUpdate, ImProductAuthInvalidReason, ImProductClient, ImProductEvent, ImProductEventError, ImProductEventMap, ImProductMessage, ImPushApi, ImPushSnapshot, ImReactionChangeAction, ImReactionChangeResult, ImReadReceiptSettingsApi, ImRedPacketBody, ImRedPacketType, ImRequestError, ImRequestErrorHandler, ImResourceKind, ImResourceUploadInput, ImResourceUploadProgress, ImResourceUploadResult, ImResourceUploader, ImResourceUploaderConfig, ImRobotBody, ImRobotChatMenuItem, ImRobotCommand, ImRobotConversationBindInput, ImRobotDirectoryItem, ImRobotDirectoryPage, ImRobotDirectoryScope, ImRobotMenuReplyInput, ImRobotModule, ImRobotProfile, ImRobotProfileInput, ImRobotsApi, ImSdkErrorCategory, ImSdkErrorShape, ImSearchApi, ImSessionApi, ImSessionFavoriteAlbumItem, ImSessionFavoriteFileItem, ImSessionFavoriteItem, ImSessionFavoriteKind, ImSessionFavoritesApi, ImSessionLifecycleState, ImSettingsApi, ImStickerAssetInput, ImStickerBody, ImStickerPack, ImSupportedConversationRef, ImTextSearchMatch, ImTextSearchMatchOptions, ImTextSearchMatcher, ImTextSearchRange, ImTransferBody, ImTransferSessionType, ImTransferStatus, ImVideoBody, ImVoiceBody, ImWebPushSubscription, ImageMessageOptions, ImagePreviewMetadata, LiveRoomMessageOptions, LocalConversationHistoryClearResult, LocalMessageDeletionResult, LocalVideoPreviewMetadata, MediaAlbumItemInput, MediaAlbumMessageOptions, MediaTransferErrorCode, MediaUploadCredentials, MediaUploadCredentialsProvider, MediaUploadCredentialsRequest, MentionCandidate, MentionCandidatePage, MentionInput, MessageContentType, MessageWindowInfo, MessageWindowPage, MessagesByIdFailure, MigrateImCachePrefixInput, MiniProgramMessageOptions, ProductConversationListType, ProductHandleConversationType, ProductMessageSearchPage, ProductMessageSearchPreviewPart, ProductMessageSearchResult, ResolveTextOptions, ResolvedConversationBackground, RobotConversationCapabilities, SegmentMatch, SegmentMatcher, SendMessageResult, StickerAssetKind, TextMessageOptions, TextSegment, TransferMessageOptions, UnknownMessageBody, UserProfile, VideoMessageOptions, VideoPreviewMetadata, VoiceCapabilities, VoiceErrorCode, VoiceMessageMetadata, VoicePlayer, VoicePlayerOptions, VoicePlayerState, VoiceRecordingResult, VoiceRecordingSession, VoiceRecordingSessionOptions, VoiceRecordingState, VoiceToggleOptions };