feat(staffchat): 通讯录(客户表+群表列对齐云客+批量勾选导出+分页)+朋友圈翻页失败内联重试

Co-Authored-By: Claude <noreply@anthropic.com>

yunkes/src/api/index.ts

@@ -49,6 +49,8 @@ export interface CustomerQuery {
   department_id?: string
   add_time_since?: number
   last_chat_since?: number
+  /** 文本搜索: 昵称/微信号/备注名/手机号子串匹配(通讯录搜索框)。 */
+  q?: string
 }
 
 export interface DeclaredTotals {
@@ -73,6 +75,7 @@ export function getCustomers(query: CustomerQuery = {}): Promise<Page<Customer>>
       department_id: query.department_id,
       add_time_since: query.add_time_since,
       last_chat_since: query.last_chat_since,
+      q: query.q,
     }),
   )
 }
@@ -162,6 +165,8 @@ export interface GroupQuery {
   user_id?: string
   /** 精确单行直查（群聊页群名解析）。 */
   room_id?: string
+  /** 群名称模糊搜索(通讯录群 tab 搜索框)。 */
+  q?: string
   page?: number
   page_size?: number
 }
@@ -174,6 +179,7 @@ export function getGroups(query: GroupQuery = {}): Promise<Page<Group>> {
       owner_account_id: query.owner_account_id,
       user_id: query.user_id,
       room_id: query.room_id,
+      q: query.q,
       page: query.page ?? 1,
       page_size: query.page_size ?? 20,
     }),

yunkes/src/api/types.ts

@@ -98,6 +98,15 @@ export interface Group {
   message_count?: number | null
   /** ms-epoch of most recent message */
   last_chat_time?: number | null
+  /** 群主/建群补充列(2026-08-25 对齐云客微信群 tab;scraper/回填脚本提取,可空)。 */
+  owner_name?: string | null
+  owner_wxid?: string | null
+  owner_alias?: string | null
+  owner_avatar?: string | null
+  /** 群成员中员工好友数 */
+  friend_count?: number | null
+  /** 建群时间 ms-epoch */
+  create_time?: number | null
   /**
    * Verbatim upstream chatroom record (camelCase keys: chatRoomId/chatRoomName,
    * memberCount/memberIds, headImageUrl, wechatId/wechatNickName, userName/