// ==================================================================== // IM 用户展示 utility // ==================================================================== // 职责:统一回答"某个用户在 UI 上应该如何展示",包含: // 1. 显示名(getFriendDisplayName / getMemberDisplayName / getGroupDisplayName / getSenderDisplayName 等) // 2. 上下文感知名(tryGetSenderDisplayName / getSenderRealNickname):渲染时按 conversation 上下文实时查 friendStore / groupStore / userStore,让备注 / 群昵称 / 真实昵称变更后所有历史消息立即响应式刷新 // 3. 性别图标 / 颜色(getGenderIcon / getGenderColor):男蓝、女粉,未知不展示,所有 UserInfo 卡片 / 列表行共用 // // 命名约定:显示名相关函数一律使用 displayName,与 friend.displayName / member.displayUserName 字段对齐 // ==================================================================== import { useUserStore } from '@/store/modules/user' import { ImConversationType, ImMessageType } from './constants' import { getCurrentUserId } from './storage' import { useFriendStore } from '../home/store/friendStore' import { useGroupStore } from '../home/store/groupStore' import type { Friend, Group } from '../home/types' /** * 私聊好友显示名:备注 > 真实昵称 * * displayName 是「我对这个人的私人称呼」属于我的数据,删好友(DISABLE)也保留;删了再加回来时备注自然延续,历史消息里仍以备注辨识 */ export function getFriendDisplayName(friend: Pick): string { return friend.displayName || friend.nickname } /** * 群成员显示名:好友备注 > 用户群备注(displayUserName) > 真实昵称 * * WeChat 优先级:好友备注是"我"对该成员的私人称呼,最高优先;其次是 ta 在群内自定义昵称;最后真实昵称兜底;调用方拿到 friend 才传入,没拿到(陌生人)就只用 member 字段降级 */ export function getMemberDisplayName( member: { displayUserName?: string; nickname: string }, friend?: Pick | null ): string { return friend?.displayName || member.displayUserName || member.nickname } /** 群显示名:当前用户对该群的备注(groupRemark) > 群名(name) */ export function getGroupDisplayName(group: Pick): string { return group.groupRemark || group.name } /** * 消息发送者显示名(严格版):算不出真名返回 undefined * * 1. 给需要"是否真名"信号的调用方用——比如 conversationStore 决定要不要写 lastSenderDisplayName 快照、要不要触发 fetchGroupMembers 兜底拉成员 * 2. GROUP 场景 member 缺失时所有 sender(含 self)都返回 undefined:self 在群里的"真名"是 displayUserName,members 没加载时不能拿 userStore.nickname 假装真名,否则 deriveLastSenderDisplayName 不会触发兜底拉成员,会一直显示真实昵称 */ export function tryGetSenderDisplayName( senderId: number, conversationType: number, conversationTargetId: number ): string | undefined { // GROUP 路径完全不查 userStore——member 在不在群直接决定结果 if (conversationType === ImConversationType.GROUP) { const group = useGroupStore().getGroup(conversationTargetId) const member = group?.members?.find((m) => m.userId === senderId) if (!member) { return undefined } const friend = useFriendStore().getFriend(senderId) return getMemberDisplayName(member, friend) } // PRIVATE / 未知会话类型:self 走 userStore,对方走 friend if (senderId === getCurrentUserId()) { return useUserStore().getUser?.nickname || undefined } if (conversationType === ImConversationType.PRIVATE) { const friend = useFriendStore().getFriend(senderId) return friend ? getFriendDisplayName(friend) : undefined } return undefined } /** * 消息发送者显示名:渲染时实时算,按 WeChat 优先级 * * - 自己:userStore.nickname * - 私聊对方:好友备注 > 真实昵称 * - 群聊对方:好友备注 > 群备注(displayUserName) > 真实昵称 * - 查不到:fallbackName || (self 走 userStore.nickname) || String(senderId) */ export function getSenderDisplayName( senderId: number, conversationType: number, conversationTargetId: number, fallbackName?: string ): string { const real = tryGetSenderDisplayName(senderId, conversationType, conversationTargetId) if (real) { return real } if (fallbackName) { return fallbackName } // self 在 GROUP members 没加载时,至少用真实昵称兜底渲染(比 String(senderId) 友好);兜底拉成员由 conversationStore 触发,回来后 try 版本能命中真名自然刷新 const userStore = useUserStore() if (senderId === getCurrentUserId()) { return userStore.getUser?.nickname || String(senderId) } return String(senderId) } /** * 消息发送者「真实昵称」:永远是 nickname,不掺备注 * * - 自己:userStore.nickname * - 私聊对方:friend.nickname * - 群聊对方:member.nickname * * 专给 UserAvatar 的 :name 用——色卡首字母 / alt 文本要保证同一个人在所有界面一致,不跟备注变 */ export function getSenderRealNickname( senderId: number, conversationType: number, conversationTargetId: number ): string { const userStore = useUserStore() const selfUserId = getCurrentUserId() // 群聊先走 member.nickname(self 也是 member),异常时再走 self / senderId 兜底 if (conversationType === ImConversationType.GROUP) { const group = useGroupStore().getGroup(conversationTargetId) const member = group?.members?.find((m) => m.userId === senderId) if (member?.nickname) { return member.nickname } if (senderId === selfUserId) { return userStore.getUser?.nickname || String(senderId) } return String(senderId) } if (conversationType === ImConversationType.PRIVATE) { if (senderId === selfUserId) { return userStore.getUser?.nickname || String(senderId) } const friend = useFriendStore().getFriend(senderId) return friend?.nickname || String(senderId) } if (senderId === selfUserId) { return userStore.getUser?.nickname || String(senderId) } return String(senderId) } /** * 群广播事件(GROUP_* 系列)的中文文案 * * 按 message.type 取 content payload 字段,昵称默认走 getSenderDisplayName(备注 / 群昵称 / 真实昵称兜底); * 管理后台无 store,可传入 resolveName 自定义 id → 名字(如 senderNickname + 用户(id) 兜底); * home 端 MessageItem.vue / ConversationItem.vue / MessageHistory.vue 与 admin 端 MessageContentPreview.vue 共用 */ export type GroupNotificationPayload = { operatorUserId?: number memberUserIds?: number[] newOwnerUserId?: number oldName?: string newName?: string oldNotice?: string newNotice?: string oldAvatar?: string newAvatar?: string displayUserName?: string messageId?: number mutedUserId?: number // 禁言目标用户 muteEndTime?: string // 禁言到期时间 banned?: boolean // 封禁状态 /** PIN 事件携带的完整被置顶消息对象 */ message?: { id: number clientMessageId?: string senderId: number groupId: number type: number content: string status: number sendTime: string atUserIds?: number[] receiverUserIds?: number[] receiptStatus?: number readCount?: number } } export function resolveGroupNotificationText( message: { type?: number; content?: string; targetId?: number }, resolveName?: (userId: number) => string, operatorNameOverride?: string ): string { let payload: GroupNotificationPayload = {} try { payload = JSON.parse(message.content || '{}') } catch { return '' } const resolve = resolveName || ((id: number) => getSenderDisplayName(id, ImConversationType.GROUP, message.targetId ?? 0)) const operatorName = payload.operatorUserId ? (operatorNameOverride ?? resolve(payload.operatorUserId)) : '' const memberNames = (payload.memberUserIds || []).map(resolve).join('、') const newOwnerName = payload.newOwnerUserId ? resolve(payload.newOwnerUserId) : '' switch (message.type) { case ImMessageType.GROUP_CREATE: return `${operatorName} 创建了群聊` case ImMessageType.GROUP_NAME_UPDATE: return `${operatorName} 将群名修改为 "${payload.newName ?? ''}"` case ImMessageType.GROUP_NOTICE_UPDATE: return `${operatorName} 更新了群公告` case ImMessageType.GROUP_INFO_UPDATE: // 兜底事件:按非 null 字段优先匹配特化文案,全部为空时降级为 "更新了群信息" 通用文案 if (payload.newAvatar) { return `${operatorName} 更换了群头像` } return `${operatorName} 更新了群信息` case ImMessageType.GROUP_DISSOLVE: return `${operatorName} 解散了群聊` case ImMessageType.GROUP_MEMBER_INVITE: return `${operatorName} 邀请 ${memberNames} 加入群聊` case ImMessageType.GROUP_MEMBER_QUIT: return `${operatorName} 退出了群聊` case ImMessageType.GROUP_MEMBER_KICK: return `${operatorName} 移出了 ${memberNames}` case ImMessageType.GROUP_MEMBER_NICKNAME_UPDATE: return `${operatorName} 修改群昵称为 "${payload.displayUserName ?? ''}"` case ImMessageType.GROUP_ADMIN_ADD: return `${operatorName} 将 ${memberNames} 设为管理员` case ImMessageType.GROUP_ADMIN_REMOVE: return `${operatorName} 撤销了 ${memberNames} 的管理员身份` case ImMessageType.GROUP_OWNER_TRANSFER: return `${operatorName} 已将群主转让给 ${newOwnerName}` case ImMessageType.GROUP_MESSAGE_PIN: return `${operatorName} 置顶了一条消息` case ImMessageType.GROUP_MESSAGE_UNPIN: return `${operatorName} 取消了一条置顶消息` case ImMessageType.GROUP_MEMBER_MUTED: { const mutedName = payload.mutedUserId ? resolve(payload.mutedUserId) : '' return `${operatorName} 将 ${mutedName} 禁言` } case ImMessageType.GROUP_MEMBER_CANCEL_MUTED: { const mutedName = payload.mutedUserId ? resolve(payload.mutedUserId) : '' return `${operatorName} 解除了 ${mutedName} 的禁言` } case ImMessageType.GROUP_MUTED: return `${operatorName} 开启了全群禁言` case ImMessageType.GROUP_CANCEL_MUTED: return `${operatorName} 关闭了全群禁言` case ImMessageType.GROUP_BANNED: return payload.banned ? `${operatorName} 封禁了该群` : `${operatorName} 解封了该群` default: return '' } } /** 会话内好友事件文案:FRIEND_ADD / FRIEND_DELETE 渲染成灰色提示气泡,文案固定不依赖 payload */ export function resolveFriendNotificationText(message: { type?: number }): string { switch (message.type) { case ImMessageType.FRIEND_ADD: return '你们已经是好友了,开始聊天吧' case ImMessageType.FRIEND_DELETE: return '你已删除好友' default: return '' } } /** 性别图标:男 1 / 女 2,0 / null / undefined 一律不展示,对齐微信留白 */ export function getGenderIcon(sex?: number): string { if (sex === 1) { return 'mdi:human-male' } if (sex === 2) { return 'mdi:human-female' } return '' } /** 性别图标主题色:男蓝、女粉 */ export function getGenderColor(sex?: number): string { if (sex === 1) { return '#5b97f5' } if (sex === 2) { return '#f56c92' } return '' }