更新日志
本页内容与仓库根 CHANGELOG.md 保持单一数据源,构建时由脚本自动拆分为各包的更新日志(一期暂不含 @easemob-community/uikit-chatroom);发版时只需更新根 CHANGELOG,本页无需手动修改版本段。
版本说明
- 重大版本:包含破坏性变更,需要迁移
- 次要版本:新增功能和优化,向下兼容
- 补丁版本:问题修复,向下兼容
@easemob-community/uikit-im 3.13.0 (2026-11-12)
新增
- 聊天页顶部横幅配置:
chatConfig.messageList.groupAnnouncementBar.visible可控制聊天页群公告横幅,默认显示且不影响群信息抽屉中的公告;demo 同步补充置顶消息与群公告横幅开关。
修复
- H5 全屏页面可视高度:聊天宿主可消费 Provider 提供的可视视口高度,跟随浏览器底栏与软键盘变化,避免固定
100vh造成底部遮挡。 - H5 输入区与草稿恢复:输入区和表情/更多面板不再重复叠加键盘高度或底部安全区;切换会话恢复草稿时仅还原文本,不再自动聚焦弹起键盘。
@easemob-community/uikit-im 3.12.1 (2026-11-10)
修复
- 群管理员角色重查同步:升级双 SDK 适配器依赖,设置管理员后重新调用
fetchGroupMembers可返回最新admin角色,避免缓存被 SDK 原始member覆盖。
@easemob-community/uikit-im 3.12.0 (2026-11-06)
新增
- SDK 5.2
multi_body复合消息:新增EmMultiBodyMessage与sendMultiBodyMessage,支持 2~20 个有序 text/image/file/voice/video/location/custom 分段;复合摘要、逐段搜索、引用、置顶、复制、下载与数组持久化保持同一父消息语义,H5 保留接收渲染与逐段下载。 - PC simple/rich 复合编辑与草稿:
input.features.multiBody开启后,rich 支持图片 inline 混排及视频/文件卡片,simple 支持按文本光标位置组织附件与前后文字;切换会话可保存并恢复文字、图片、视频、文件、@提及及顺序,单附件无文字仍发送普通消息。 - 复合复制粘贴与发送安全:结构化剪贴板可还原文本、图片、视频、文件及顺序,不支持的数据走纯文本兜底;发送绑定原会话、草稿版本与引用,避免跨会话误发、上传中新输入误清和预览 URL 提前回收。
- 表情包业务扩展:
input.stickerExt支持按 sticker 与 packId 追加业务自定义 ext,不改变 UIKit 既有消息编码约定。
文档
- 新增复合消息组件/发送指南、Nuxt 式 Vue API 参考与文档示例签名校验,修正进阶指南中的公开 API 示例。
@easemob-community/uikit-im 3.11.0 (2026-10-09)
新增
UIKitProvider支持 App ID 初始化(SDK 5.1+):新增appIdprop(与appKey二选一);sdkConfig类型同步放开loginTimeoutMs等中立字段(Omit<CoreUIKitInitConfig, 'appKey' | 'appId'>)。auto-init 判定改为「已提供 appKey 或 appId」。
@easemob-community/uikit-im 3.10.0 (2026-10-08)
新增
- H5 长按消息操作面板改造(对齐飞书交互):高频操作(默认引用/复制/转发/下载)收拢到顶部图标网格区横排展示,其余操作保持整行列表;面板支持 drag handle 半屏(50dvh)↔ 展开(78dvh)拖拽/轻点切换,展开后列表区纵向滚动。新增
messageAction.gridActionTypes配置自定义高频集合(传[]关闭网格分区)。 - H5 输入框发送按钮图标化:有文本时的「发送」文字按钮替换为 plane 图标按钮,与工具条其余图标按钮视觉一致。
修复
- H5 表情面板右侧大量空白:core
EmEmojiPicker固定 320px 宽度与 h5-input 的width: 100%覆盖同为 class+attr 优先级、产物内顺序不定导致覆盖失效;改为高特异性选择器全宽(含max-width: none),表情网格改grid + auto-fill均匀铺满。 - H5 语音/表情按钮选中态不互斥:语音模式下打开表情/更多面板前未退出语音态,两个按钮同时高亮;现开面板前先退出语音模式。
- H5 点击消息区空白无法收起软键盘:
h5-input/message-input暴露blur()(失焦并收起表情/更多面板),chat.vue聊天内容区点击时调用(仅移动端)。 - H5 长按气泡菜单只剩「取消」:
message-bubble-wrapper的message-action-menu/message-action-extra插槽无条件转发,导致message-interactive判定插槽恒被接管、ActionSheet 默认动作列表恒为空;改为v-if="$slots[...]"条件转发。 - H5 输入框删除文本后高度不回落:
autoGrow在浏览器默认 content-box 下把含 padding 的scrollHeight直接赋给height,padding 双重计入(空内容也保持约 2 行高);现按盒模型换算(border-box 直接用、content-box 减去 padding),且赋值前先取scrollHeight避免被clientHeight污染。
@easemob-community/uikit-im 3.9.0 (2026-09-28)
新增
- 选人弹窗 H5 全屏化重构与弹窗收敛(D133 部分):创建群弹窗迁移到共享
EmContactTransferModal;已选成员改为顶部头像横条;移动端确认键改为单通栏计数样式;字母索引条支持触摸滑动扫字;备注弹窗迁移至EmModal。
修复
- H5 下钻抽屉全屏接管:
ChatDrawer的fullscreen在移动端升级为 fixed 视口级覆盖(100dvh + safe-top + z-index 1000),消除宿主双层 header;群管理二级抽屉同步补齐。
@easemob-community/uikit-im 3.8.0 (2026-09-23)
新增
- 群组默认头像:群未设置头像时,默认头像由原来的「群名前 2 字 + 随机色块」文字占位统一替换为内置默认图(紫底白「群」,构建时内联为 data URI,无额外资源请求)。覆盖会话列表、群列表、群详情、群名片(含弹窗)、聊天页头部、转发会话列表全部群头像渲染点;已设置头像的群不受影响,用户头像维持原文字占位。
@easemob-community/uikit-im 3.7.11 (2026-09-22)
新增
- 主入口透出基座核心符号:重新导出
useUserInfoStore/isKeyboardShortcutsEnabled/setKeyboardShortcutsEnabled与类型UiContact/UiContactInvite/UiGroup/UiPresence/UserInfoStore(均来自@easemob-community/uikit-core),消费者无需再直接依赖 core 包。
@easemob-community/uikit-im 3.7.10 (2026-09-22)
修复
EmChatContainer#watermark水印覆盖层收窄到聊天内容区:覆盖层由挂在.chat根级(inset: 0铺满整个聊天区、连同输入框一起覆盖)改为挂在新划出的.chat__content内容区容器(header / 通知条 / 置顶与群公告横幅 / 消息列表),输入框与多选操作栏区域不再被水印覆盖;插槽名与:conversation作用域不变。行为变化:无会话空状态(.chat__empty分支)下不再渲染水印。
@easemob-community/uikit-im 3.7.9 (2026-09-21)
新增
simple 输入框粘贴图片预览发送(PC):截图/复制的图片 Cmd/Ctrl+V 粘贴时弹出
EmModal预览确认框(单图按宽高比等比缩放居中,复用消息气泡 displaySize 算法;多图双列网格),确认后逐张走既有handleSendFile链路发送(beforeSend 钩子、引用 ext、群已读回执配置自动继承),取消/ESC/遮罩关闭自动回收 Blob URL;新增input.pasteImagePreview配置(默认true,传false关闭后粘贴图片静默丢弃);新增文案chat.input.pasteImageTitle(core locale)。EmChatContainer新增#notice聊天区通知条插槽:位于聊天 header 与消息列表之间(置顶横幅、群公告横幅之上),作用域为{ conversation },供业务注入自定义通知内容(如防诈骗提示条)。
修复
- 会话列表行尾未读徽标对齐:
EmBadge行尾(unreadPlacement="inline")用法此前按头像角标绝对定位渲染,徽标右边缘比时间右边缘右移约半个徽标宽;现EmBadge新增inline模式按文档流渲染,徽标右边缘与时间右边缘对齐、垂直居中于消息摘要行(对齐 Figma 设计稿unraedarea right 0 / top 1 / h 16)。
@easemob-community/uikit-im 3.7.8 (2026-09-21)
变更
enableReadReceipt关闭时隐藏全部「已读未读」状态指示:此前仅隐藏单聊已读 icon 与群已读数,己方消息的 SENT / DELIVERED / READ 状态图标(空心圆 / 已读对勾等已读未读状态的 UI 载体)仍会残留展示;现开关关闭时这三类状态图标整体不渲染,气泡旁不再出现任何状态指示。发送中 spinner 与失败重试属本地操作反馈,不受影响。
@easemob-community/uikit-im 3.7.7 (2026-09-21)
新增
- 全局已读回执开关
enableReadReceipt(Provider prop,默认 true):关闭后接收方不再发送消息级已读回执,且 UIKit 不展示已读状态——单聊己方消息隐藏「已读」icon、群聊不显示已读数 / 已读详情入口;不影响本机未读数同步(clearConversationUnreadMessageCount保留)。群聊发送方的回执请求仍由ChatConfig.groupReadReceipt独立控制(sdk-contract 1.3.1 / core 2.8.6 / websdk5 1.3.3)。
@easemob-community/uikit-im 3.7.6 (2026-09-20)
变更
- 好友列表在线状态默认关闭:
EmContactList(含通讯录容器好友子视图与EmContactListContainer)即使 Provider 全局开启enablePresence,默认也不再展示联系人在线状态点,也不再为列表发起 presence 订阅;需要展示时显式传:enable-presence="true"。 - 消息气泡头像在线状态点默认关闭:
config.messageList新增presence开关(默认false,微信/QQ 式消息流不带状态点);开启后仅对方头像展示状态点,且需全局enablePresence链路可用。原先「store 有数据即被动显示」的默认行为移除,恢复方式::chat-config="{ messageList: { presence: true } }"。
新增
EmContactDetail/EmUserCardModal/EmGroupMemberList新增enablePresenceprop:名片、联系人详情、群成员列表(主动查看场景)默认仍跟随 Provider 全局enablePresence展示在线状态,现可组件级覆盖(传false单独关闭)。
@easemob-community/uikit-im 3.7.5 (2026-09-18)
修复
- 修复删除消息后刷新页面消息「复活」的问题(严重):消息删除原先只移除前端内存列表、未调用 SDK,刷新后历史消息从服务端漫游重新拉取导致被删消息重新出现。现删除 / 批量删除会先调用 SDK 删除当前用户的服务端漫游历史(本账号各端经多端事件同步移除),成功后才移除本地消息,删除失败保留消息并 toast 提示;仅本地未送达消息(无服务端 ID)只本地移除(sdk-contract 1.3.0 / websdk5 1.3.1 / webim4 1.3.1)。
- 修复重发失败消息时窄窗口丢消息:原实现「先删旧消息再发送」,发送前校验同步抛错会导致该条消息从列表静默消失;改为发送失败时回补旧失败消息。
- 图片消息防闪烁:己方发送成功 body 回填远程地址时先预载新图再切换 src,避免气泡白屏重载「闪一下」;发送中气泡用已加载图片自然尺寸撑住容器,避免回填真实尺寸时跳动;消息列表 :key 稳定性修复(本地 ID 优先),发送成功替换气泡不再整树销毁重建(含已加载图片)。
变更
- 好友申请通知列表改版(对齐 Figma「新-Demo」):新增「对方拒绝了你的好友申请」通知(粉色失望图标头像),列表去除头部 / 时间 / 附言独立行,副文案按场景展示附言 / 群名 / 设计稿固定文案;接受 / 拒绝操作补成功 toast(sdk-contract 1.3.0)。
- 输入占位文字统一 13px(core 2.8.5);会话列表 header / 搜索槽 / 状态横幅 / 分栏 tab 左缘统一 16px 对齐(列表项头像左缘同口径);群成员移除菜单文案收敛为「移除」。
新增
EmAddressBookContainer/EmContactContainer新增showNoticeAddButton:「新请求」子视图头部展示添加好友按钮,默认false。
@easemob-community/uikit-im 3.7.4 (2026-09-18)
变更
- 侧栏列表容器宽度默认随宿主容器弹性伸缩:会话 / 联系人 / 群组 / 通讯录 / 黑名单列表容器与聊天区等兄弟组件并排时,宽度由固定
360px改为按--uikit-sidebar-width基准弹性取值(clamp(240px, 25%, 480px),宿主容器约 1440px 处为 360px),窗口变宽 / 变窄时列表随之伸缩;宿主覆写该 token 为100%或固定 px 的行为不变(core 2.8.4)。
新增
EmResizable新增fluid弹性模式:开启后未拖拽过且无受控值时不写内联尺寸,宽度交由 CSS(如侧栏基准 token)决定;首次拖拽以当前实际渲染尺寸为起点,拖拽后内联 px 接管,适合「默认弹性 + 可拖拽定宽」的侧栏(core 2.8.4)。
@easemob-community/uikit-im 3.7.3 (2026-09-17)
新增
- 新增聊天页消息昵称展示特性开关
showNicknameInSingleChat/showNicknameInGroupChat:单聊消息列表默认不展示对方昵称(微信风格),<UIKitProvider :show-nickname-in-single-chat="true">可打开;群聊默认展示发送者昵称,:show-nickname-in-group-chat="false"可关闭。消息气泡外壳按消息自身的conversationType判定(合并转发弹窗、搜索结果等独立场景同样生效),运行时切换即刻生效。
@easemob-community/uikit-im 3.7.2 (2026-09-17)
修复
- 修复生产构建中 core 组件(按钮等)失去全部样式的问题(严重):配套 core 2.8.2 的 scopeId 稳定性修复——theme 内联的 core dist scoped 样式 hash 与 core 运行时 scopeId 重新对齐;同时构建接入
check-theme-scope-ids.mjs守卫,core dist 过期导致的 theme 失配会在构建期直接报错。修复前典型症状:消费者仅import '@easemob-community/uikit-im/theme'时,页面中所有 EmButton 渲染为无样式原生按钮。
@easemob-community/uikit-im 3.7.1 (2026-09-16)
修复
- 修复会话列表 card 变体屏蔽全局 hover 风格开关:
.conversation-list--card不再硬编码--uikit-item-hover-radius/--uikit-item-active-radius(原固定 8px),改由全局hoverStyle主题开关驱动;默认档同为 8px,card 设计视觉不变,「方正」档直角、「圆角」档左右缩进在 PC 默认 card 会话列表上恢复生效(联系人 / 群组列表此前已生效)。
@easemob-community/uikit-im 3.7.0 (2026-09-16)
变更
- 新增全局 header 底部分隔线开关(默认关闭,视觉变更):
theme.headerBorder(Provider prop)/useTheme().setHeaderBorder()一键控制会话列表、通讯录、聊天、会话抽屉、EmModal 及建群弹窗 header 底部的 1px 分隔线,默认false不再显示分隔线(此前整改后默认显示);宽度经新 token--uikit-header-border-width(0px/1px)下发,各 header 颜色 token 不变。header 总高由 border-box + 固定高保证,开关不影响布局高度。配套 core 2.8.0。
@easemob-community/uikit-im 3.6.1 (2026-09-16)
变更
- 二次确认弹窗宽度对齐设计稿:11 处
type="warning"确认弹窗(删除会话/消息、解散/退出群、移除成员、设置/移除管理员、移出黑名单、取消禁言、名片操作等)宽度由 540 校准为 719,与设计稿 pop 组件统一宽度一致;视觉跟随 core 2.7.1 的 EmModal 新度量(header 60px / 标题 18px·500 / body 48·56 / footer 80px)。 - 会话容器对齐「新-Demo」设计稿(视觉变更,无 API 变更):header 加底部 1px 分隔线、总高 48 → 65px(上下 12.5px),标题 16px/600 → 18px/500;搜索框改 36px 胶囊(
pill),搜索槽/分栏/标题水平边界统一 12px;card 变体会话项总高 72 → 64px(项内容水平内边距 12px、垂直 8px),两行摘要间距 6 → 4px。 - 修复会话项无最后一条消息时标题下移:会话项两行高度固定(20 + 4 + 18 = 42px),消息摘要为空时信息区不再塌陷,标题位置恒定。
- 「没有更多历史消息」改为随消息流滚动(行为变更 + 新插槽):历史加载状态提示(加载中 / 失败重试 / 没有更多)由常驻顶部条改为消息列表首项,仅上翻到顶(或下拉到底)时可见,随消息一起滚动;下拉刷新模式历史加载完后同样显示「没有更多历史消息」。新增
#history-tip插槽整块接管该提示,scope{ state: 'loading' | 'failed' | 'no-more', retry },链路EmChatContainer → EmChat → EmMessageList插槽自动透传,文案仍可用 locale keyconversation.noMoreHistory覆盖。
@easemob-community/uikit-im 3.6.0 (2026-09-16)
变更
- Provider 能力开关默认对齐产品化形态(行为变更):
enableContact/enableBlocklist/enablePresence默认由false改为true(双 Demo 共识配置下沉)。好友/黑名单/在线状态开箱即用;presence 订阅会带来额外查询/订阅请求,低频场景请显式:enable-presence="false"。 - 输入框发送按钮条件默认(行为变更):
config.input.showSendButton未配置时由「一律显示」改为按端型取默认——PC 隐藏(回车发送,对齐桌面 IM 形态)、移动端显示(触屏无回车键);显式 true/false 仍优先。此前 PC 上依赖默认发送按钮的接入方需显式showSendButton: true。 - 会话列表下拉刷新增回落链(能力补齐):
EmConversationContainer的pull-refresh未配置(undefined)时回落 Providerh5.pullRefresh(默认'auto':触屏设备自动开启),不再写死false;显式 true/false 仍优先。 - ChatContainer 容器风格条件默认(行为变更):
variant未配置时由一律'compact'改为按端型取默认——PC'card'(圆角卡片壳由容器自绘)、移动端'compact'(平铺全屏形态);显式传入仍优先。此前 PC 上未传 variant 的接入方视觉会变为卡片壳,如需平铺请显式variant="compact"。
@easemob-community/uikit-im 3.5.1 (2026-09-15)
变更
- 「新会话」弹窗宽度调宽:
new-chat-modal弹窗宽度由 360px 调整为 480px(PC 端内联width),移动端(<768px)全屏分支不受影响。
@easemob-community/uikit-im 3.5.0 (2026-09-04)
变更
- 文件消息气泡整改(设计规范):文件图标改为左侧固定展示的彩色底色块(双方气泡一致),按扩展名归类取图标——pdf / xls / doc / ppt / md 明确格式各用明确图标,图片 / 视频 / 音频按类别用
file/img/file/video/file/audio,未识别类型回落file/empty;图标底色为类型品牌色 token(见 core 2.6.0),图标本体白色。文件标题改用EmText(body 14px / medium / 单行 ellipsis),颜色跟随气泡文字色(对方#171A1C、己方#FFFFFF)。气泡圆角沿用 round 16px / square 8px 两档,但文件卡片默认 square(8px,设计约定),可经config.messageList.bubbleShape切 round。
@easemob-community/uikit-im 3.4.0 (2026-09-03)
新增
- ChatContainer 容器风格档位
variant:compact(默认;平铺无圆角,--uikit-chat-bg铺满,保持现状不破坏存量接入)/card(圆角卡片:圆角跟随--uikit-components-radius,细边框--uikit-border-light,overflow 裁剪内部直角;灰底与间距由宿主布局提供),与ConversationContainer的 card/compact 同口径——此前卡片壳需接入方在宿主布局手搓,现收回容器内。 EmText排版原子组件 re-export:与 core 2.5.0 对齐,@easemob-community/uikit-im侧同步导出EmText及TextProps/TextLevel/TextWeight/TextColor类型(见 core 2.5.0)。- 中性气泡样式档位
config.messageList.bubbleStyle:'filled'(默认,对方气泡带底色)/'plain'(对方气泡无底色纯文字,message-list 根作用域覆写--uikit-bubble-bg-other: transparent,组件级变体范式,不影响全局主题)。 - 对方语音消息未播放红点
config.messageList.voiceUnreadDot:默认true。本会话实时收到的对方语音未点击时,气泡外侧右侧、相对气泡垂直居中显示红点,点击播放后隐藏;历史/漫游消息无播放状态不打标,刷新页面即复位(运行时态,不落盘)。设为false全局关闭;单条消息级覆盖可在消息项插槽内对INJECTION_KEY.VOICE_UNREAD_DOT深一层 provide。
变更
- 消息气泡圆角档位校准(设计规范):
bubbleShape两档取值由 12px/4px 校准为 round=16px(默认)/ square=8px,新增 token--uikit-bubble-radius/--uikit-bubble-radius-square(见 core 2.5.0);文本/语音/图片/视频气泡与引用卡片(0.75 倍圆角:round 档 12px 更椭圆、square 档 6px 保持原样)跟随档位,文件/位置/合并/自定义气泡补齐bubbleShape消费(此前未接线)。 - 气泡默认色校准(设计规范):对方气泡
#E4E6E7/ 文字#171A1C,己方气泡#009EFF/ 文字#FFFFFF;己方气泡背景不再跟随主色(运行时仍可用setBubbleBg/ 主题预设覆盖)。 - 译文 / 语音转文字并入原气泡:不再以独立卡片吸顶气泡下方,改为同一气泡内 1px 分割线分隔(新 token
--uikit-bubble-divider-other/--uikit-bubble-divider-self);语音气泡展示转写时宽度由按时长固定改为随内容自适应;己方气泡内译文链接与加载态配色同步修正。 - 消息状态默认位置改为气泡末尾:
messageStatus.position默认由'below'(气泡下方)改为'inline'(气泡末尾、多行气泡与底部对齐),'below'仍可显式配置。
修复
- ChatContainer card 档外侧出现滚动条:
.chat-container补box-sizing: border-box,card 档 1px 边框不再把height: 100%撑出 2px 导致宿主溢出(顺带消除 H5 safe-bottom padding 的同类撑高隐患)。 - inline 消息状态落在引用卡上 / 跟随引用卡宽度:带引用的消息在
statusPosition: 'inline'下,状态列此前相对「气泡 + 引用卡」整体居中/沉底,视觉上贴在引用卡左侧;现将引用卡移出 message-row,且 message-row 内 body 宽度由100%改为随气泡内容收缩(fit-content),状态列只相对气泡本体对齐(多行沉底检测同步只量气泡),不再被引用卡宽度顶到远处。 - 译文 / 语音转写缺少完成态标签:译文展示时气泡底部新增「已翻译 / Translated」标签(icon
rect/hanzinalpha/slash),语音转写新增同款「已转文字 / Transcribed」标签(iconrect/hanzi),双方气泡均居右对齐;locale 新增message.translated/message.voiceToText.done(中英双语)。引用卡片去掉左侧竖杠装饰。
@easemob-community/uikit-im 3.3.0 (2026-09-03)
新增
- 被踢下线识别与差异化提示:会话列表连接横幅新增「被踢」最高优先级分支(不可点击重连),按 SDK 错误码差异化文案(其他设备登录 / 密码已修改 / 设备数超限 / 被迫下线,新增 4 个 locale key
status.kicked*,中英双语),修复账号被踢后误显示「网络异常/断开」的问题。
变更
- 菜单项圆角与 hover 档位联动:消息操作菜单、会话右键菜单的菜单项圆角统一由
--uikit-components-radius改为--uikit-item-hover-radius,随hoverStyle三档联动(square 档为直角)。
@easemob-community/uikit-im 3.2.0 (2026-09-02)
新增
- 会话列表风格变体:
ConversationContainer/ConversationList新增variant(card默认:圆角白卡、无分割线、项间距 4px /compact:无圆角、无分割线、零间距,列表根作用域覆写 Cell 变量实现,不影响全局主题)、showAvatar(false = 仅会话信息模式)、unreadPlacement(avatar时未读徽标带白描边挂在头像右上角);badgePlacement三层透传统一未读徽标位置。 - 会话项扩展与事件:新增
#name-suffix插槽(名字后企业/官方 tag,list 层#item-name-suffix、container 层#itemNameSuffix透传,scope 含会话数据);新增search事件(去空格关键字,埋点/远程搜索用)。 - 会话列表自带底色:
--uikit-conversation-list-bg(浅#FAFAFA/ 深#111827),card 变体下头部/分栏/搜索与卡片项边界对齐、头部与项内容线对齐。 - 空状态规格化:会话列表空态启用新图标
list/bullet(100×100 占位色 + 16px 文案 + 垂直居中,规格走--uikit-empty-*token);聊天区无会话空态图标换bubble/rect/2,默认文案「选择一个会话」。
变更
- 会话项排版对齐设计规范:用户名 16px/600、时间 12px tertiary、消息预览 14px,两行行距 6px;置顶底色与 hover 同值(
--uikit-bg-hover);置顶/免打扰图标换面性图标(filled/pin/filled/bell/slash,--uikit-icon-muted同色)且置顶补齐与免打扰一致的摇动动画;免打扰/dot 模式未读点校准为 8×8、#FF7070(去除免打扰染灰的历史行为)。
破坏性行为变更
EmBadge的size枚举由'normal' | 'small'改为'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl'(默认'l'),旧值不再合法(见 core 2.3.0)。
@easemob-community/uikit-im 3.1.0 (2026-09-02)
新增
- 会话消息内存淘汰(opt-in):
MessageStoreOptions新增maxCachedConversations,开启后按 LRU 淘汰超额会话的消息缓存(联动清理合并消息/已读成员/@我/发送中缓存,并重置历史翻页游标),最近活跃会话受保护;默认不开启,Web 行为完全不变。面向 Electron/桌面端长期挂机场景,为本地持久化专项预留衔接点(淘汰后回访经 fetchHistory 漫游回源,DB 阶段由 repository 本地回源无缝接管)。
性能
- 消息 store 热路径优化:单条消息插入改「尾序快路径 + 二分插入」,去除每消息全量拷贝排序;
_findMessageById维护 msgId→会话索引(未命中回退全表扫描并自愈),回执/撤回/编辑/删除等按 ID 定位从「全会话全表扫描」降为单会话内定位。 - presence 全链路默认关闭:
usePresencecomposable 层增加开关硬门(见 websdk5/webim4 行为变更);会话列表 presence 订阅改无条件 watch + 空数组源,修复运行时再开启不生效的问题。
修复
- 会话右键菜单锚点节点、消息定位高亮定时器补充卸载清理;消息气泡缩略图加
loading="lazy"。
@easemob-community/uikit-im 3.0.0 (2026-09-02)
新增
- 双 SDK 适配架构落地(D122):SDK 层收敛为「中立契约 + 双 adapter」——新增契约包
@easemob-community/uikit-sdk-contract与两个适配器包@easemob-community/uikit-sdk-websdk5(5.x)/@easemob-community/uikit-sdk-webim4(4.x,经 npm aliaseasemob-websdk-4引入 4.24.2)。一套 UI 产物可按 SDK 版本切换,UI 层零重写。 - 子路径入口:新增
@easemob-community/uikit-im/websdk5与@easemob-community/uikit-im/webim4(import 即自注册默认 adapter);主入口保持零 adapter 值级静态引用,4.x 下游产物不含 5.x 符号,反之亦然(摇树隔离已双消费者工程验收)。 - Provider 新能力:新增
adapterprop(注入模式:业务自带 adapter 实例,UIKit 不转发 login/logout);sdkConfig.repositories数据入口注入(message/conversation/contact/group/presence/userInfo 全域可接管);useUIKit()暴露capabilities(adapter 上报的 SDK 客观能力矩阵,与 features 取交集决定能力入口);core 新增模块级getUIKitAdapter()支持非 Vue 上下文访问。 - 4.x 适配补齐:登录后按 features 预取联系人/群组(对齐 5.x 同步体感);漫游坏消息容错(单条解码失败跳过不拖垮整页)。
修复
- 群主转让状态校准:4.x
changeOwner事件 payload 不携带新群主,经 pending 标记识别真正的 newOwner,同步校准群资料 owner、当前用户角色与新旧群主成员角色,避免角色闪回与权限残留。 - 建群成员数偏差:创建群后用本地已知的创建成员数兜底校准
memberCount,避免服务端/事件导致的短暂计数偏差。
破坏性行为变更
- SDK 层值级导出迁移:
UIKitClient/createClient/ adapter / domain /registerEventHandlers等值级导出从主入口移除,迁至子路径入口@easemob-community/uikit-im/websdk5(4.x 场景用@easemob-community/uikit-im/webim4);主入口仅保留 type-only re-export。迁移方式:入口文件import '@easemob-community/uikit-im/websdk5'(import 即注册默认 adapter),原先从主入口导入的 SDK 值级符号改从子路径入口导入。 UIKitDataSource维持@deprecated(本版本不移除):已收口为 repository 注入的薄别名(core 装配时逐项翻译,显式repositories优先);searchUsers等无 repository 对应项的接管面迁移目标尚未设计,移除调整至 4.0.0。
@easemob-community/uikit-im 2.8.6 (2026-08-28)
修复
- 数据同步「有数据但 UI 空」:SDK 自动同步完成后好友/群组列表仍可能为空——通讯录计数、列表容器挂载等路径在同步完成前读 SDK 内存(尚未同步的空快照)并锁定
loaded,导致onSyncDataFinished的回填被if (!loaded)跳过(日志呈现contact 回填 {loaded: true, sdkCount: N, storeCount: 0})。修复三层配合:① 计数改为只读(getLocalCount()不写 store 不锁定 loaded);② 回填兜底(loaded为真但列表为空时仍回填 SDK 数据);③ 消费onSyncDataFinished的status字段——同步失败输出日志,conversation 失败且可重试时自动refreshSessionList()重试一次。 - 新增
useSyncStatus()hook:暴露 conversation / contact / group 三类数据的同步阶段(idle / syncing / success / failed)与isSyncing/allFinished,业务方可感知同步进度并在失败后自行补偿(contact/group 无 SDK 主动同步接口,失败后只能等待下次连接/登录自动同步)。
@easemob-community/uikit-im 2.8.5 (2026-08-28)
修复
- GIF / 表情包发送后动图不播放(服务端返回静态图地址):
sendImage发送图片消息时未给 SDK 传createImageMessage的isGif标记,SDK 把 GIF 当普通图片上传,返回的chatfiles/*地址是静态图。现按 MIME(image/gif)或文件名/URL 后缀(.gif)自动判定并传isGif: true,SDK 按 GIF 动图处理,配合 2.8.4 的渲染修复(isGif消息展示动画原图)动图可正常播放。
@easemob-community/uikit-im 2.8.4 (2026-08-28)
修复
- GIF / 表情包消息展示为静态缩略图、不播放动图:
image-message.vue的displayUrl对图片消息统一优先thumbnailUrl(SDK 生成的静态缩略图),当消息体isGif为真(或ext.isSticker表情包)时改为优先展示动画原图(originalImageUrl/bigImageUrl/localUrl),恢复 gif 动图播放。
@easemob-community/uikit-im 2.8.3 (2026-08-28)
修复
- 表情包(sticker)发送失败:本地打包资源(如 demo 的 gif 资产路径)作为 sticker
url时,SDK 无法按 URL 上传(Attachment file is required)。现onStickerSelect先fetch该地址转成File再以图片消息发送;远程 URL 能 fetch 也走 File,跨域失败则回落为原 URL 字符串(保持按 URL 引用)。
@easemob-community/uikit-im 2.8.2 (2026-08-28)
调整
- 表情面板「常用」区仅在有最近使用时显示:从未选过表情不展示「常用」空态占位;
emoji.recentEmpty文案随之移除。 - 移除内置 emoji 悬停放大预览:删除
ChatConfig.input.emoji.emojiPreview配置,表情视图不再弹放大预览小窗;sticker 的 hover 预览图 → gif 切换保留不变。
@easemob-community/uikit-im 2.8.1 (2026-08-28)
调整
- 表情面板「常用」与「Emoji」合并为单一视图:不再分「常用 / Emoji」两个 tab,改为在表情视图顶部展示「常用」最近使用区、下方为完整 Emoji 列表,同一滚动区(与设计稿对齐);底部 tab 只区分表情视图与表情包。
recentIcon配置随之移除(无消费方);recent/recentCount/emojiIcon/emojiPreview等其余配置语义不变。
@easemob-community/uikit-im 2.8.0 (2026-08-28)
新增
- 表情面板重构与配置化(
EmEmojiPicker/ChatConfig.input.emoji):- 「常用」改为动态最近使用:默认开启、localStorage 按
appKey + userId隔离持久化、保留最近 5 个(recentCount可配);关闭recent后不展示常用 tab 也不再记录; - 新增独立「Emoji」完整列表 tab;表情包(
stickerPacks)注入的 tab 默认不自动选中(打开时常用有内容优先常用,否则回落到 Emoji); - 新增配置:
recent/recentCount/tabsPosition(top | bottom | left | right,默认bottom)/stickerHover/recentIcon/emojiIcon/emojiPreview; - sticker 支持
thumbUrl预览图 +url动图 +name标题:默认展示预览图,悬停切换 gif、移出恢复(触屏不启用);内置 emoji 悬停放大预览(emojiPreview可关); - 每个 tab 项均可配预览小图:表情包取
iconUrl(缺省自动回落包内第一个 sticker 预览图),内置「常用 / Emoji」tab 走recentIcon/emojiIcon。
- 「常用」改为动态最近使用:默认开启、localStorage 按
修复
- 登出后重新登录,会话列表误展示「网络异常」横幅(D123):登出时 dispose 的事件处理器(连接级 + 各 manager + user-info 监听)在重新登录时未重建,导致
stores.client.connected恒为 false、会话列表误命中网络异常分支;现login()在登出后先恢复注册再连接(根因修复见@easemob-community/uikit-core1.5.0)。
@easemob-community/uikit-im 2.7.0 (2026-08-27)
破坏性变更
- 输入框风格枚举更名(
ChatConfig.input.style/InputStyle):'feishu' | 'wechat'替换为'toolbar-top' | 'toolbar-bottom'(脱离厂牌话术,改为工具栏方向语义),默认值由'wechat'变为'toolbar-top'。迁移映射:wechat(工具栏在上)→toolbar-top,feishu(工具栏在下)→toolbar-bottom;旧值直接移除,下游调用方需同步替换。
新增
- 消息列表隐藏自己头像(
ChatConfig.messageList.showSelfAvatar):新增showSelfAvatar配置(默认true),设为false时隐藏己方消息头像、对方头像照常显示(微信/QQ 式「隐藏我的头像」);showAvatar: false仍作为总开关同时隐藏双方头像。
@easemob-community/uikit-im 2.6.0 (2026-08-26)
破坏性变更
- 图标体系旧库清零,全面切换 V2:删除
packages/uikit-core/src/assets/icons/旧库目录;业务代码中所有空状态插画(empty/*)改用 V2 功能图标:empty/contact→person/single、empty/chat/empty/conversation→bubble/rect/empty、empty/group/empty/members→person/double、empty/mutelist→bell/slash、empty/blocklist→circle/slash、empty/files→folder、empty/search→search。empty/mentions、files-media/doc_on_doc、status/info也已分别替换为at、rects、circle/bang。 - 若业务侧此前通过
EmIcon直接引用旧库 name(如empty/contact),需按上述映射切换到 V2 name。
重构
check-icon-refs.mjs扩展为同时校验旧库与 V2 目录,旧库删除后仅校验assets/icons-v2/;构建期缺失图标引用会硬失败。
@easemob-community/uikit-im 2.5.0 (2026-08-25)
新增
- 单聊抽屉拉黑(
EmChatContainer/ChatInfoDrawer):单聊信息抽屉「通用操作」区新增「拉黑 / 取消拉黑」按钮(随 ProviderenableBlocklist显隐,黑名单关闭时隐藏),确认后调用黑名单能力并同步 store,抽屉新增block-changed事件。 - 黑名单选人拉黑:通讯录黑名单列表右上角新增「+」入口(
EmAddressBookContainer黑名单子视图头部 +EmBlockList自身 header),点击弹出EmBlockListAddModal选人弹窗(好友全量多选 + 搜索框,排除自己与已拉黑者),确定后批量加入黑名单并即时刷新列表;EmContactContainer内置接线,业务零配置。新增showBlocklistAddButtonprop 与blocklist-add事件。
类型导出
- 新增
BlockListAddModalProps公开类型。
@easemob-community/uikit-im 2.4.0 (2026-08-25)
新增
- 通讯录黑名单同级入口(
EmContactContainer/EmAddressBookContainer):- 新增
showBlocklist/blocklistLabel/blocklistIconprops、blocklist-click事件与goBlocklist()命令式方法;黑名单入口在 ProviderenableBlocklist=true时展示,与「群组 / 通讯录(好友)」同级; - 新增黑名单列表组件
EmBlockList/EmBlockListContainer:空态占位、列表项复用EmContactItem并遵循头像形状主题配置,行右键菜单「移出黑名单」(确认后removeBlock并同步 store),对外事件click/contextmenu/unblock,容器层透传blocklist-item-click/blocklist-item-contextmenu/blocklist-unblock; - 新增 i18n
contact.entryBlocklist与contact.blocklist.*文案(zh-CN / en)。
- 新增
类型导出
- 新增
BlockListContainerProps公开类型。
2.3.0 (2026-08-20)
新增
- 会话列表接管能力(
EmConversationList/EmConversationContainer):#item插槽完全接管会话项渲染,作用域提供{ conversation, active, keyboardFocus, select, pin, mute, delete, read, customAction }(对齐 contact/group 列表的#item惯例);menuItemsprop 注入 Header+菜单自定义项(ConversationHeaderMenuItem[]),传空数组隐藏菜单入口;#header-menu插槽整块接管菜单区域;未提供 handler 的自定义项触发header-menu-action事件;#new-chat/#add-contact/#create-group三个插槽分别接管「新建会话 / 添加联系人 / 创建群组」弹窗(作用域{ show, open, close }),客户可接自己的选人器 / 好友体系 / 企业通讯录。
- 聊天页弹窗接管能力(
EmChat/EmChatContainer):#user-card/#group-card插槽接管用户 / 群名片弹窗,#invite-member/#forward/#message-search/#multi-select-bar插槽分别接管邀请成员 / 转发 / 搜索 / 多选栏渲染,默认内容 = 内置实现,不传插槽行为不变;#message-action-menu插槽完全接管消息操作菜单内容(PC 右键 Popup 与 H5 长按 ActionSheet 双端生效),作用域提供{ message, actions, select, close },支持插入自定义主菜单项(举报 / 收藏 / 业务菜单)。
- 群组模块接管能力:群管理五个二级页新增
#mute-list/#block-list/#allow-list/#shared-files/#join-requests插槽(EmGroupManagementSection);成员操作菜单新增#member-menu插槽(EmGroupMemberList,作用域{ member, actions, select, close })。
类型导出
- 新增
ConversationHeaderMenuItem/ConversationItemSlotScope/GroupManagementKey/GroupManagementSectionSlotScope/GroupMemberMoreAction公开类型。
2.2.0 (2026-08-20)
新增
- Chat 抽屉三种接管能力:
EmChatContainer/EmChat新增#drawer整块接管插槽;ChatInfoDrawer新增drawer-header/drawer-profile/drawer-remark/drawer-announcement/drawer-members/drawer-admin-actions/drawer-management/drawer-actions/drawer-footer/drawer-member-detail十处 section 插槽;导出通用抽屉壳EmChatDrawer与ChatDrawerProps/ChatDrawerSlotScope/ChatInfoDrawerSlotScope类型。业务方可从整体替换、局部定制、自绘壳三个层级接管聊天信息抽屉。
破坏性变更
- 移除
ChatConfig.header.customSlot字段(该字段此前未被代码读取,属于历史残留)。如需关闭默认抽屉入口,请改用新增的ChatConfig.header.showDrawerEntry。
2.1.0 (2026-08-19)
新增
- Skeleton 骨架屏组件:
@easemob-community/uikit-core新增EmSkeleton,支持头像 + 文字行变体;会话/联系人/群组列表首次加载接入骨架屏,减少空白等待感。 - Modal danger 变体:
EmModal新增type?: 'default' | 'danger',危险操作确认按钮自动切换为 danger 语义;同步限制最大宽度与正文溢出滚动。 - Toast 能力补全:
EmToast/useToast新增closable、position、actionText、#action插槽与duration=0不自动关闭;show方法通过重载兼容旧签名与新签名。 - Input error / readonly 态:
EmInput新增error/error-message/readonlyprops,支持表单校验失败视觉反馈与只读可复制状态。 - Empty 空状态模板:
EmEmpty扩展illustration/title/description/actionslot,统一会话/通讯录/群组/搜索无结果四类模板。
视觉与主题
- 全局焦点环:
:focus-visible焦点环覆盖所有可交互元素,键盘导航可见,满足 WCAG 2.4.7。 - 间距阶梯:新增
--uikit-spacing-1~7(4/8/12/16/24/32/48px),高频组件 padding/gap 映射到阶梯变量。 - Type Scale 排版规范:补齐
--uikit-font-lineheight-*/--uikit-font-weight-*/--uikit-font-family,文档输出 10 级排版层级表。 - 暗色对比度验证:9 组文字×背景暗色组合按 WCAG 2.1 AA 验证通过,
text-tertiary由#6b7280提亮为#8a92a0。 - 移动端触摸热区扩展:
EmIconButton在触屏设备下扩展最小触摸区域至 44×44px,视觉尺寸保持不变。
文档站
- Design Tokens 总览页:新增
guide/design-tokens.md,按 Color/Type/Spacing/Radius/Elevation/Motion/Z-Index 分类展示全部--uikit-*变量。 - 图标总览:
components/icon.md新增图标网格,支持分类筛选、搜索、点击复制 name。 - z-index 设计层级表:
guide/theme.md定义 Toast/Modal/Drawer/Popover/Sticky/内容层级区间。 - 动效可视化面板:
guide/theme.md新增交互式动效演练场,演示 fade-scale 过渡、四种 easing 曲线、Ripple 与 scale-press。 - H5 适配文档增强:
guide/h5-adaptation.md补充断点系统、双栏布局规则、手势映射表、横屏/折叠屏适配、输入区布局规范。 - 组件使用建议:Button/Input/IconButton/Cell/Modal 文档新增 Do/Don't 对比表。
- 设计原则:
guide/theme.md提炼 5 条核心设计原则(变量优先、层级清晰、无障碍默认、移动端优先、一致优于花哨)。 - 图标与时间戳规范:
guide/icons.md补充图标设计规范;components/message-list.md补充时间戳策略建议。 - 更新日志三包拆分:
guide/changelog.md改用自定义ChangelogTabs组件,按@easemob-community/uikit-im/@easemob-community/uikit-core/@easemob-community/uikit-chatroom三 tab 展示各包更新日志;构建时由根CHANGELOG.md自动拆分生成。 - 文档站导航重构:顶部导航收敛为「首页 / 指南 / 组件 / GitHub」;左侧边栏按「开始 / 功能指南 / 设计系统 / H5 适配 / Demo 规划 / 更新日志」板块聚合,同一板块内只展示当前板块导航,消除 mix 感。
- 图标总览默认展开:
IconGallery分类默认展开,进入图标/Design Tokens 页即可直接浏览全部图标。
关联技术债
- 已于
TECH-DEBT.md登记 D104-D113 并勾选归档。
2.0.0 (2026-08-15)
视觉
- 线性图标集全新替换为设计师约定命名(v2):新增
packages/uikit-core/src/assets/icons-v2/图标库,命名与设计师 svg 文件名 1:1(如chevron/down、file/pdf、person/single);EmIcon支持通过name自动索引,业务代码已完成 300+ 处 name 替换。旧库仅保留空状态插画等少量缺口图标,待设计师补图后清理。 - 面性图标集接入:新增
packages/uikit-core/src/assets/icons-filled/图标库,在线状态PresenceSelector/Avatar已从旧presence/*切换为filled/circle/*图标。 IconGallery文档画廊改为展示 V2 + Filled 全部图标,并在apps/docs/guide/icons.md同步命名规则与业务映射。
重构
- 三包架构落地(P0.5 改名 + P1 抽核,里程碑级内部重构):
- 包改名:
@easemob/uikit→@easemob-community/uikit-im(纯改名,安装命令同步更新,为聊天室场景包让位命名空间) - 新增共享基座
@easemob-community/uikit-core(1.0.0,独立版本线):- SDK 基座层:
UIKitClient/ManagerHost(含ChatRoomManager注册,为聊天室场景包预留)/ wire 类型 / user-info & presence domain / 连接级事件 / notice 工具 - Pinia stores:client / theme / user-info / presence
- 共享 composables:
useClient/useTheme/useUserInfo/useOwnUserInfo/usePresence/useToast/useNotification/ H5 通用(useH5Adaptation/useKeyboard/useLongPress/usePullRefresh/useViewport/useBottomSheet/useRipple)/ 通用交互(useKeyBindings/useResizable/useUIKitStorage) - 24 个原子组件(Em* 基础组件集,含 story)+ theme CSS 变量(539 行)+ locale(含
mergeLocaleMessages,供场景包合并 i18n keys)+ constants + 通用 utils(logger / log-store / sdk-error / download / z-index / format-time / linkify) - core 版
EmUIKitProvider+useCoreUIKitProvider/useProviderSideEffects(场景无关共享副作用)
- SDK 基座层:
@easemob-community/uikit-im全量 re-export core 符号:对外 API 零回归(原 416 个公共导出名全部保留,组件 props/emits、主题、文案、行为不变)- resolver / auto-imports 参数化生成(
gen-aux-entries.mjs,各包一份产物,build 前置--check卡漂移) - 构建规则固化:所有包 external
vue/pinia/easemob-websdk,场景包再 external core(消费端单 SDK 实例);im UMD 产物补 core 全局映射(CDN 直引可用) - 版本同步:
changelog:check升级为 im / core 双版本校验(根 CHANGELOG 单一数据源不变);im 依赖 core 采用workspace:^(发布转^1.0.0) - 日志导出文件名前缀参数化(
setLogFilePrefix),im 既有easemob-uikit-im-logs-*语义不变
- 包改名:
- 面向下游:安装包名由
@easemob/uikit变更为@easemob-community/uikit-im;除此之外无任何 API / 行为变更,可直接替换依赖名升级。
1.9.0 (2026-08-14)
新增
- 流式消息(Stream Message)内核接入:
onStreamMessage按msgServerId幂等合并分片,body.content以stream.fullText覆盖更新、不产生新气泡(分片先到时自动建气泡)- 纯文本流式状态内置:传输中尾部打字机光标、完成态收敛、异常态提示(
customType='text'或缺省) - 丢片补偿:离线/断连期间错过分片时,同步到达的完整消息自动覆盖未完成的流式副本,不留半截内容
- 流式内容增长时消息列表在用户位于底部时自动跟随滚动;当前会话摘要随内容响应式更新
UiMessage扩展可选stream?字段(复用 SDKStreamMessageMeta);新增STREAM_MESSAGE_STATUS/STREAM_CUSTOM_TYPE常量- markdown 等富格式流式内容由
#message-txt插槽插件接管渲染(内核不引入 markdown 依赖)
- 消息定位高亮增强:点击 @名字定位该用户最近一条消息(
ChatConfig.textMessage.locateOnMentionClick,默认开启),未找到时 toast 提示;定位高亮改为主题色边框 + 发光 + 背景着染,脉冲 3 次后静态保持再平滑淡出(2.4s),覆盖引用卡 / 置顶 / 搜索 / @我自动定位等全部入口 - demo:AI 流式消息演示:
- 新增 markdown 流式气泡插件参考实现(
#message-txt接管customType='markdown',markdown-it 渲染 + 打字机光标 / 终态 / 异常) - 聊天工具栏新增「AI 流式演示」入口;设置抽屉新增「AI」分类面板(AI 应答 mock 开关、手动注入 markdown / 异常流式演示)
- 新增流式分片模拟器与 mock AI 回复生成器(直接驱动 messageStore,完整走内核覆盖更新链路)
- 新增 markdown 流式气泡插件参考实现(
- 文档:新增「AI 流式消息」章节(SDK 语义 / 内核能力 / markdown 插件接管示例 / AI 接入三模式与安全建议),
chat-container组件文档补充流式消息小节
1.8.0 (2026-08-13)
新增
- 二期配置演练场矩阵(docs 交互式演示,6 个方向全部落地):
- 会话列表配置演练场:
EmConversationContainer覆盖showSenderName/unreadMode(count|dot)/showHeader/ 分栏 Tabs(五类预设)/showStatusBanner/showSearch/showScrollToTop/headerAlign/bodySticky,mock 会话直灌免登录渲染 - 输入框配置演练场:
EmMessageInput覆盖mode(simple|rich)/style(feishu|wechat)/ features 六开关 /autoFocus/focusBorderColor/caretColor/selectionColor/showSendButton/resizable/expandable,输入回车或点发送可在下方消息列表回显 - 单条消息气泡演练场:
EmMessageBubbleWrapper覆盖多选态(自建进入/退出驱动)、引用卡片(ext.msgQuote + 定位闪烁)、状态组合(classic|capsule × inline|below × showText / direction)+ 群已读圆圈三态 - 群已读回执 / 群管理演练场:
ChatConfig.groupReadReceipt(enabled / maxGroupSize)+EmGroupManagementSection(drawer|modal 双形态 + 六入口开关),mock 群角色 owner/admin/member 实时切换视角 - 原子组件交互 demo 增强:Avatar(shape 主题联动 / size / presence 实时切换)与 Badge(count / max / dot / 状态颜色 / 尺寸 / 风格)升级为交互式配置演示
- 主题 token 演练场:实时调整品牌色相 / 组件圆角 / 字号档位(适老)/ 密度档位,会话列表即改即看;通过舞台局部 CSS 变量 +
data-uikit-density生效,不写入全局主题
- 会话列表配置演练场:
- 在线代码演练场规模化(VuePlayground,@vue/repl 可编辑代码实时预览):
- 基础设施增强:多文件模板约定(
App.vue主编辑区 +mock.tsmock 数据分离);编辑内容按uikit-playground:<id>:v1本地持久化(刷新/切页自动恢复,「重置代码」清除缓存);工具条新增「全屏」与「新标签打开」(serialize()→public/playground.html独立页,全量走本地 vendor 产物) - 配置演练场与在线代码演练场合并:DocsConfigPanel 面板式演练场全部并入在线代码演练场(config.vue 移除),页面只保留一个「在线代码演练场」小节;原面板配置项(会话容器 props / 输入框 config / 群管理配置 / Avatar / Badge 等)全部体现在模板的「可编辑配置」区,改代码即改即看
- 演练场覆盖扩展至 8 个组件页:Avatar(shape 主题联动 / size / presence)、Badge(count/max/dot/状态色/尺寸/风格)、Button(type/size/disabled/loading/block)、Cell(title/meta/箭头/边框/尺寸/状态)、Input(形态/type/disabled/maxlength/clearable)、会话列表(容器 props + mock 会话)、聊天容器(
config.input配置 + mock 消息回显)、群能力(群管理入口 + 群已读回执三态,角色视角可切换) - 演练场预览样式修复:预览 iframe 改注入 uikit dist 构建产物 CSS(
dist/theme/index.css,含全部组件样式),此前仅注入:root主题变量导致 iframe 内组件无样式
- 基础设施增强:多文件模板约定(
修复
config.input.focusBorderColor配置接线:该配置此前为孤儿配置(输入框聚焦边框一直使用主题主色),现经 v-bind 接通聚焦边框颜色,config 优先、未配置回落主题值- 在线演练场「新标签打开」独立页白屏:
sync:vendor将 @vue/repl 本体与 codemirror 编辑器分别打包成两个 bundle,共享 chunk 中的injectKeyPropsSymbol 在两处各求值一次,编辑器inject失配导致 setup 崩溃白屏;现合并为单一vendor/repl.js(共享 chunk 单例),headless Chrome 实测无 hash / 带 hash(真实 serialize 格式)双链路均正常渲染
1.7.0 (2026-08-13)
新增
- 系统通知文案自定义与开关能力(noticeConfig):
- 新增
NOTICE_EVENT_TYPE事件枚举(19 类通知事件)与NoticeContext/NoticeConfig公开类型,所有群系统通知(群创建/成员进出/群主变更/禁言/公告等)统一流经结构化事件管线 EmUIKitProvider新增notice-configprop:renderText自定义文案(回调接收事件类型 + 结构化参数 + 已本地化内置文案)、filter条件过滤(返回 false 不上屏)、disabledEvents直接禁用事件- 通知消息
body携带eventType/params结构化元数据(字段可选,旧消息完全兼容) EmMessageRenderer新增#message-notice插槽,业务可完全接管通知渲染- 新增文档页「系统通知文案定制」;demo 设置面板新增「系统通知文案」验收开关(内置/俏皮话术/关闭入群通知)
- 新增
- demo 恢复源码直连模式:vite alias 直连 packages/uikit-im 源码,依赖声明改回 workspace 模式
- 消息列表演练场(docs 交互式配置演示):
- 新增 DocsConfigPanel 声明式配置面板(互斥选项组 / 布尔开关 / 数字输入三类控件,问号 tip 浮层),docs 站点全局注册
- 新增「消息列表 MessageList」演练场页面:mock 注入免登录渲染全类型消息,开关实时切换
layout/showAvatar/showTime/bubbleShape/avatarSize/messageGap/messagePadding/messageStatus等配置
- 业务模块 API 文档自动生成:
gen-api-docs.mjs扩展 MODULES 白名单(chat-container / conversation-container / group-container / message-list),容器 Props 表格由生成器维护不再手写ChatConfig等嵌套配置类型递归展开为子表格(深度上限 3 层 + 去重,函数/联合/泛型类型显示原文);成员说明取完整 JSDoc(多行说明不再截断)- 三个业务模块页手写 Props 段落替换为
@include生成表格,后续改 API 重跑pnpm gen:api即可同步
优化
- 消息翻译 / 语音转文字交互重构:
- 操作菜单按状态切换:已有译文/转写时显示「取消翻译 / 显示译文」「收起文字 / 显示文字」,目标语言不一致时重新翻译;翻译/转写进行中禁用并显示 loading 文案
- ActionSheet 支持
disabled/icon透传;disabled 项点击统一弹「操作不可用」提示 - 移除 toggleTranslation / toggleVoiceText 全局事件链,译文卡片隐藏/显示入口收敛到操作菜单;译文 loading 图标改用 spin 动画
- Resizable 拖拽光标优化:拖拽全程注入全局光标锁(
*+!important),指针移出手柄或到达 min/max 边界时光标不再回落默认箭头,移除边界光标回落逻辑
修复
config.messageList.bubbleShape配置接线:该配置此前为孤儿配置(气泡一直读主题全局bubbleShape),现经注入键接通文本/图片/语音/视频四个气泡组件,config 优先、未配置回落主题值
1.6.0 (2026-08-13)
重大变更
- SDK 引入模式支持双模式:
- 默认(生产/发布)子包依赖
easemob-websdk声明为 npm registry 版本^5.0.0-beta.1(跟随 5.x 正式版与 beta 线,pnpm sdk:up一键更新到 range 内最新),不再使用本地 tgz 相对路径(修复发布后消费者无法解析file:依赖的问题) - 本地 dev 联调可切换为仓库根目录
easemob-websdk-5.0.0.tgz:pnpm sdk:use-tgz/pnpm sdk:use-npm/pnpm sdk:status(切换后需pnpm install),通过根package.json的pnpm.overrides实现,仅影响本地安装/构建,不影响发布
- 默认(生产/发布)子包依赖
新增
- Icon 内置动画能力:
animprop 支持 spin(旋转)/ pulse(脉冲)/ shake(摇摆)/ flash(闪烁)四种内置动画- 动画时长与曲线跟随主题动画 token(
--uikit-anim-duration/--uikit-anim-easing),全局动画开关与prefers-reduced-motion自动生效
- 消息输入框展开/收起:
- PC 端输入框工具栏新增展开按钮,点击后输入区原地撑高至聊天容器 50% 高度(240~600px),Esc 或再次点击收起,内容与光标保留
- 展开态自动隐藏拖拽手柄并关闭 emoji / @提及 锚点弹层(避免布局变化错位)
ChatConfig.input新增expandable配置(默认 true),业务方可关闭
- demo 设置面板说明增强:新增 DemoSettingLabel 组件,10 个设置面板的选项补充用途说明文案
- 组件文档补充:icon 组件页新增「动画」章节与演示 demo
优化
- loading 图标统一收敛:图片查看器 / 状态横幅 / 合并消息解析 / 消息搜索 / 会话列表同步 5 处 loading 统一改用 Icon
anim="spin",删除重复 keyframes,动画时长随主题 - 图标切换过渡:消息状态图标(发送中→已读)、免打扰铃铛徽标、操作菜单图标切换增加淡入淡出过渡
- 免打扰铃铛动画主题化:摇铃动画迁移到 Icon
anim="shake",全局动画关闭(theme.animationEnabled)时不再触发
工程
- agent skills 补录:新增 9 个开发协作 skill(消息渲染 / 聊天交互 / 插件与会话分栏 / Provider 配置 / 通知系统 / 打包发布 / demo 开发 / 文档站写作 / skill 编写规范),AGENTS.md 路由表同步登记
- 依赖升级:vue 3.5 / vite 5.4 / vitepress 1.6.4 / typescript 5.9 等
1.5.1 (2026-08-07)
新增
- 图片预览组件 ImageViewer:
- 新增
EmImageViewer图片预览组件:全屏浮层、loading 加载态、双击/滚轮/双指缩放(1~5 倍)、拖拽平移、90° 旋转、适应屏幕复位、下载与多图相册能力 - 图片消息预览接入该组件:保留三级图片策略(缩略图/中图/原图)与失败降级编排,通过
#footer插槽放置中图/原图切换按钮 - 支持键盘操作(ESC 关闭、←/→ 切图)与
v-model:show/v-model:index受控模式
- 新增
修复
- 群消息已读详情自动翻页聚合全部已读成员,修复大群已读列表只返回首页的问题;已读回执按 50 条分批发送,规避 SDK 单次数量上限
- 群名补全增加去重与本地缓存,避免 SDK 定时同步会话列表时重复请求群信息;修复空群名回退导致的循环请求
- 群成员列表不再返回 admin 角色时,首屏单独拉取管理员列表并合并角色
1.5.0 (2026-08-06)
重大变更
- 同步
easemob-websdk至0.20.32(5.0.0 线):- 适配
onMembersJoined事件groupName参数类型变更 - 完整迁移说明见 1.4.0 版本的 SDK 5.0.0 升级记录
- 适配
新增
- 会话分栏 tabs 能力:会话列表支持按「全部 / 未读 / @我 / 单聊 / 群组」分栏展示
ConversationContainer/ConversationList新增tabs(自定义 tab 集合,顺序即渲染优先级,空数组隐藏)与activeTab(支持v-model:active-tab)props- 新增
#tabs插槽:作用域提供tabs/activeTab/selectTab,可完全接管 tab 栏渲染 - 新增
useConversationTabshook,半接管(绑定 props)与完全接管(插槽自绘)两种用法 - 导出
ConversationTabKey/DEFAULT_CONVERSATION_TABS/ConversationTabsSlotScope类型与常量
- 状态横幅 StatusBanner:
- 新增
EmStatusBanner状态横幅组件:info / warning / error / success 四种类型、loading 旋转图标、可关闭(v-model:show)、自定义图标与插槽 - 会话列表接入连接/同步状态横幅:断网(可点击,触发 reconnect 事件)、连接中、同步中自动展示,
show-status-banner可关闭,#status-banner插槽可自定义
- 新增
- 消息通知组件补齐:
- 新增
EmNotification/EmNotificationContainer桌面端消息通知组件与useNotification状态单例 - 同一会话短时间窗口内连续消息自动合并为一张卡片,unreadCount 累计展示
- 容器支持 position(右上/左上/顶部居中)与 maxVisible(同时展示上限)配置
- 新增
- 主题:字号 token 体系与适老版(Phase 2):
- 新增
--uikit-font-size-*字号 token 体系与--uikit-font-scale全局缩放 setFontSize()/setFontSizeScale()支持标准 / 大 / 特大(适老版)切换- Phase 2.5 完成低频文件字号 token 化,Badge 适配字号缩放
- 新增
- 主题:高频语义 token:
- 新增气泡色 / 聊天背景 / 输入区背景语义 token:
setBubbleBg/setChatBg/setInputBg(ProviderbubbleColor/chatBg/inputBg声明式配置) setBubbleBg(null)支持重置为默认主题色
- 新增气泡色 / 聊天背景 / 输入区背景语义 token:
- 主题:密度(density)能力:
- 新增 Density 三档:compact 紧凑 / normal 标准 / comfortable 宽松
useTheme新增 density 状态与setDensity();Provider 支持theme.density声明式配置- 密度变量覆盖 Cell 高度、内边距、列表间距、Header、输入区、气泡、抽屉与按钮
优化
- 时间分隔线与系统提示不再跟随气泡色,保持独立视觉层级
- 旧版 localStorage 缺少 fontSizeScale 时默认标准字号,避免迁移后异常放大
- 清理 D3 / D4 / D12 主题 token 漂移技术债
- Demo 外观面板增加语义 token 调试控件与单项恢复按钮
- 全仓库枚举字符串统一提取为 constants 常量,禁止业务代码硬编码
文档
- 新增 StatusBanner、Notification 组件文档页,文档站导航同步更新
- 会话容器文档增补分栏 tabs 能力、状态横幅与新增 props / 插槽说明
- 主题定制指南增补密度能力与语义 token 重置说明
- 沉淀三份预研文档(Electron 持久化、主题能力审查、Demo 开发者模式)
1.4.0 (2026-08-05)
重大变更
- 升级
easemob-websdk至5.0.0:- 移除已废弃的
GroupManager.getPublicGroupList调用 - 新增错误码 222(单聊被拉黑)映射与多语言文案
- 修复
vite.config.ts中 SDK 版本读取,兼容新版包入口布局 - 调整语音消息为 WAV 格式并优化语音转文字参数透传
- 移除已废弃的
新增
- 图片消息三级展示优化:
- 气泡统一优先展示缩略图最小图,点击展开中图,点击原图按钮再展示原图
- 预览层中图/原图切换入口统一为底部按钮,文案明确点击结果(查看原图/查看中图)
- 修复提示条与徽标点击穿透误关预览的问题(
pointer-events优先级)
- 消息引用卡片增强:
- 引用卡片去掉 emoji icon,图片/视频直接展示缩略图
- 无图时兜底中文标签(由中文方括号【】改为英文方括号 [])
- 消息操作增强:
- 附件消息右键/长按菜单支持下载
- 复制菜单仅对文本消息展示
- 群公告展示优化:
- 群描述弱化 + 群公告突出(横幅/历史/发布者)
- 切换群聊会话时预拉群公告,避免必须展开抽屉才显示横幅
- 移除本地缓存的公告历史/发布者/时间(SDK 5.0.0 无历史接口)
- ID 一键复制能力:全量支持 ID 一键复制
- Chat header 优化:群聊标题支持成员数后缀并优化单聊/群聊对齐配置
- 好友与群组事件通知:在聊天页插入中性灰色通知
- Plugin 扩展点补齐:
- 新增
input-panel、message-action-extra、custom-message-action、useChatPlugin扩展点 - 新增
lastMessageTextResolver支持自定义最后一条消息文本 - Demo 增加快捷回复与名片选择示例
- 新增
- Cell 组件增强:支持
insetHover=false卡片内操作项模式,群管理入口与群主操作行统一收敛到 EmCell - 国际化增强:
- 新增
findLocaleKey调试函数,支持单个/批量文案反查 locale key - 支持
mergeLocaleMessages扩展业务语言包 - 补齐名片消息多语言 key(sendCard/myCard/contactCard/noCardAvailable)
- 新增
- SDK 错误处理优化:
- 基于 SDK error code 优化核心 toast 错误提示
- 使用
isSDKError+formatSdkError统一 SDK 错误日志输出
- 字体统一:在
:root添加--uikit-font-family统一跨浏览器字体表现 - 邀请持久化增强:修复通知入口不显示及默认值异常,增强邀请持久化与消息搜索能力
- 群已读回执:点击会话批量补发群已读回执,统一置顶/引用展示链与按钮规范
- UIKit 配置继承:继承 SDK
deleteConversationOnGroupDestroyed初始化配置
优化
- 群管理 UI 统一:
- 群成员列表操作菜单改用 EmCell 卡片内操作项规范
- 群管理入口改用 action 按钮,与群管理操作视觉完全对齐
- 群管理入口 Cell 增加图标并与群管理操作样式对齐
- 群信息抽屉「群管理操作」更名为「群主操作」
- 移除群信息抽屉成员卡片的 hover 背景
- 群成员列表优化:
- 群成员二级列表卡片高度跟随内容,避免大面积留白
- 群聊抽屉二级成员列表外层卡片圆角与一级一致
- 语音消息修复:修复语音消息群已读圆圈位置异常,将
max-width从根元素移至气泡本身 - Demo 对齐:群聊 header 不再展示头像,与 UIKit 默认行为一致
文档
- 新增 Demo 第一期 UIKIT 层能力评估规划文档
- 完善 VitePress 文档站与工程化细节
- 在图标页增加图标一览画廊,方便设计师查看全部内置图标
- 新增 ChatContainer Plugin 扩展点 Histoire story 文档
- 补全 VitePress 文档站点并修复 preview 启动失败
1.3.1 (2026-07-21)
变更
- 升级
easemob-websdk至0.14.227(本地包easemob-websdk-next-0.14.227.tgz),迁移说明见 websdk2 仓库migration-guide-0.14.203-to-0.14.227.md。 - 适配 SDK 0.14.224 事件行为变更:
recallMessage()/modifyMessage()成功后 SDK 不再在当前设备伪造onMessageRecalled/onMessageUpdated,撤回与编辑改为在 await 成功后直接更新本地消息状态(use-message-actions.ts、use-chat.ts);对端与多设备事件监听保持不变。 - 适配 SDK 0.14.223 事件行为变更:
pinMessage()/unpinMessage()成功后 SDK 不再在当前设备伪造onPinnedMessageChanged,置顶操作后本地主动刷新置顶列表,保证 PinnedBar 同步(use-message-actions.ts)。
修复
- 适配 SDK 会话删除 API 变更:
DeleteConversationParams.deleteLocal已移除(SDK 删除会话成功后总会清理本地缓存);deleteConversationLocally已不存在,removeConversation(删除会话保留漫游消息)改为deleteConversation({ deleteRoamingMessages: false })并异步化(conversation-domain.ts、use-conversation.ts)。 - 适配 SDK 0.14.203 下载返回类型变更:群共享文件下载回调统一处理
Blob | ArrayBuffer,无 Blob 环境自动包装为Blob(group-domain.ts)。
新增
- 群禁言列表项展示禁言到期时间(SDK 0.14.225 修复 v3 解析后返回
muteExpire):永久 / 已到期 / 禁言至具体时间(mute-list-item.vue)。
1.3.0 (2026-07-07)
新增
- 接入 Presence 在线状态能力:
- 新增
PresenceDomain封装 SDKPresenceManager的订阅、查询、发布能力。 - 新增
usePresence组合式函数,提供subscribePresence、fetchPresence、publishPresence、watch等 API。 - 新增
PresenceStore用于缓存在线状态,支持update/updateBatch/get。
- 新增
- 新增 Presence 相关组件:
EmPresenceSelector:在线状态选择器(在线 / 忙碌 / 离开 / 自定义)。EmPresenceSelectorModal:弹窗形态的在线状态选择器,内部调用publishPresence。EmPresenceAvatar:传入userId即可自动订阅/拉取并展示在线状态,支持editable触发发布弹窗。
EmAvatar扩展:- 新增
presenceprop,支持展示online/away/busy/offline/custom指示器。 - 新增
presenceSizeprop 自定义指示器尺寸。 - 新增
editableprop 与presence-click事件,支持点击指示器触发状态编辑。
- 新增
- 联系人/会话/群成员等列表组件接入在线状态展示:
ContactList/ContactItem/ContactDetail支持在线状态点。ConversationList/ConversationItem单聊头像支持在线状态点。GroupMemberList支持懒加载可见成员的在线状态。UserCard/UserCardModal支持展示当前用户在线状态。MessageBubbleWrapper支持消息气泡头像展示发送者在线状态。
- 组件级 Presence 开关:
ConversationContainer/ConversationList新增enablePresenceprop。ContactContainer/ContactListContainer/ContactList新增enablePresenceprop。- 优先级:组件 prop > Provider 全局
features.enablePresence。
- Provider 全局开关:
UIKitProvider新增enablePresenceprop,默认false。UIKitFeatures新增enablePresence、presenceStrangerMode、fetchGroupMemberPresenceOnVisible。
- Demo 集成:
- 默认开启
enablePresence: true。 - 左侧导航栏顶部头像使用
EmPresenceAvatar,点击可发布在线状态。
- 默认开启
- 新增 Histoire stories:
Avatar新增Presence Sizesvariant。- 新增
PresenceSelector、PresenceSelectorModal、PresenceAvatarstories。 ContactList/ConversationContainer新增 Presence 开启/关闭示例。
修复
- 修复
Avatar方形模式下内部图片/文字缺少圆角的问题。 - 修复
PresenceDomain.subscribe/fetchStatus成功后未写入PresenceStore的问题。 - 修复
use-presence.ts中fetchPresence对 SDKPresenceInfo.statusList的错误映射。 - 修复会话列表默认不主动获取在线状态的问题:进入会话列表时自动按可见单聊用户订阅 Presence。
1.2.0 (2026-07-04)
新增
新增群成员列表组件
GroupMemberList(公开名EmGroupMemberList):- 支持搜索、分页加载、角色标签(群主/管理员/成员)。
- 支持对成员发起单聊、移除成员、设置/取消管理员(按当前用户角色自动判断权限)。
- 通过
Chat.vue的「查看全部成员」入口承接群信息抽屉,打开右侧抽屉展示成员列表。
Chat.vue新增showMemberList状态与成员列表抽屉,点击群信息抽屉的「查看全部成员」后可直接打开GroupMemberList。GroupDomain/useGroup新增群管理员能力:addGroupAdmin(groupId, userId)/removeGroupAdmin(groupId, userId)- 操作成功后同步更新
GroupStore中对应成员角色。
GroupStore新增updateGroupMemberRole(groupId, userId, role),用于本地即时更新成员角色。新增好友申请通知列表组件
ContactNoticeList(公开名EmContactNoticeList):- 同时支持好友申请与群组邀请两种通知类型。
- 针对已加入的群组或已成为好友的待处理邀请,会按「已接受」展示,避免无效操作。
- 支持接受 / 拒绝操作,好友申请调用
ContactManager,群邀请调用GroupManager。 - 优化 item hover 与按钮边界:拒绝按钮使用白底描边,hover 时保持可见边界。
UiContactInvite类型扩展:新增id、type、groupId、groupName、inviterId、inviterName字段,统一描述好友申请与群组邀请。ContactStore新增inviteList缓存与addInvite / removeInvite / updateInviteStatus / clearInvites方法,并新增pendingCount计算属性。ContactDomain与contact-events.ts扩展好友申请事件处理:onContactInvited将申请存入inviteList;若对方已是好友,则直接标记为accepted。onContactAgreed/onContactRefuse/onContactAdded/onContactDeleted同步联系人及申请状态。
GroupDomain/useGroup新增群邀请处理能力:acceptGroupInvitation(groupId)/declineGroupInvitation(groupId)
group-events.ts新增群邀请事件处理:onInvitationReceived/onInvitationAccepted/onInvitationDeclined/onAutoAcceptInvitationFromGroup/onMembersJoined自动维护inviteList状态。
ContactNoticeList新增persist配置:persist支持true/ 'local' / 'session',开启后未处理通知自动持久化,刷新页面后仍可恢复。
AddressBookContainer新增noticePersistInvites配置:- 在容器层统一开启通知持久化,确保首页「通知」hot 红点在刷新后也能立即显示,无需先打开通知列表。
新增
useInvitePersistence组合式函数,基于appKey + userId生成隔离存储 key,恢复时自动过滤已接受 / 已加入的邀请。AddressBookContainer默认通知视图:- 通知徽标数未传入时自动取 pending 数量(
pendingCount),仅统计未处理的好友申请与群邀请。 - 「通知」入口徽标使用 hot 红点徽章(红底白字圆点),联系人 / 群组入口保持原有默认数字样式。
- 徽标数字超过 99 显示
99+。 notice视图默认渲染ContactNoticeList,业务仍可通过#notice插槽覆盖。
- 通知徽标数未传入时自动取 pending 数量(
修复聊天消息列表三个问题:
- 左侧边距消失(虚拟列表模式):
MessageVirtualList增加padding: 16px,并给非最后一项增加padding-bottom: 12px,与正常滚动列表的内外边距保持一致,避免消息贴边。 - 顶部加载完成后边距消失:PC 顶部加载指示器在
!hasMoreHistory时显示「没有更多历史消息」,保持顶部占位,避免加载指示器消失后布局下沉导致边距为 0 的错觉。 - 加载历史消息时新消息计数增加:
messages.lengthwatch 改为通过lastMsgId区分「前置历史消息」和「底部追加新消息」,前置历史不再增加unreadNewCount。 - 登录后只有几条新消息时无法触发加载历史:进入会话后新增
ensureHistoryFill,当非虚拟列表且消息未撑满视口时自动加载历史,直到可滚动或没有更多历史。 - 加载历史触发时机:普通滚动与虚拟滚动的
reach-top阈值统一为scrollTop <= 0,只在真正触顶时加载。
- 左侧边距消失(虚拟列表模式):
群聊输入框 @提及自动调起群内成员列表:
Chat.vue在群聊会话下自动预加载群成员(本地为空时拉取第一页)。- 将当前群成员(排除自己)映射为
MentionContact[]透传给MessageInput。 MessageInput新增mentionContactsprop,传入后优先于config.input.mention.contacts使用。- 用户输入
@时,MentionPicker现在能展示群内成员并支持搜索、选中。
群信息抽屉「添加成员」按钮按群组邀请权限动态显示:
- 群主/管理员始终显示。
- 普通成员仅在
group.allowInvites === true时显示。 - 无权限时不展示按钮,避免触发 403。
邀请失败时增加
group.inviteMember.forbidden文案:遇到forbidden/access forbidden错误提示「当前群组不允许邀请成员,请联系群主或管理员」。群信息抽屉「添加成员」按钮样式修复:增加
justify-content: center、line-height: 1与水平 padding,解决文案/图标不居中的问题。新增
InviteMemberModal组件,实现从联系人列表选择并邀请成员入群:邀请弹窗内联系人列表关闭字母导航与分组标题,改为平铺列表,避免右侧字母条溢出/挤压弹窗。
弹窗居中展示(移动端底部抽屉),支持多选联系人。
已在群中的成员和当前登录用户自动禁用,避免重复邀请。
支持搜索联系人,底部显示「取消 / 邀请」按钮。
Chat.vue在群信息抽屉点击「添加成员」时打开该弹窗,邀请成功后提示并刷新成员列表。
GroupMemberList新增allow-chat配置('all' | 'contact' | 'none'):'all':对所有成员(除自己外)显示「发消息」按钮。'contact':仅对联系人列表中的成员显示「发消息」按钮。'none':不显示「发消息」按钮。ChatConfig新增groupMember.allowChat,Chat.vue会自动透传给成员列表弹窗。
新增
GroupMemberListStorybook 示例:「仅联系人可发消息」与「禁止发消息」。新增
contact.*与group.memberList.*系列国际化文案(好友申请、群邀请、群成员列表、管理员操作等)。新增
ContactNoticeList、GroupMemberList与AddressBookContainer的 Storybook 示例。
优化
- 群信息抽屉的成员预览区交互升级:
- 点击成员头像区域或「查看全部成员」按钮,改为居中 Modal 弹窗展示完整成员列表,避免抽屉套抽屉。
GroupMemberList新增closable属性与close事件,支持在弹窗标题栏显示关闭按钮。- 弹窗宽度 480px、高度 70vh(移动端 90vw×80vh),内部列表独立滚动,保留搜索、角色标签、发消息/设管理员/移除等操作。
修复
- 修复会话列表切换/更新时名称先显示 ID 再显示名称的闪烁问题:
onConversationListUpdate改为合并更新,优先保留本地已补全的名称/头像,避免 SDK 把conversationName回退成conversationId。onSyncDataFinished的 conversation 分支也使用合并策略保留已补全名称。
- 修复会话列表中群聊只显示群组 ID 的问题:
- 在
onSyncDataFinished(conversation / contact / group)和onConversationListUpdate之后,使用群组列表、联系人备注/名称、用户资料昵称补全会话名称。 - 若本地没有对应群组信息,会主动调用
groupManager.getGroupInfoList拉取群详情,进一步兜底补全群名称。
- 在
- 修复会话列表搜索不支持中文备注 / 群名 / 昵称的问题:
- 默认搜索现在会同时匹配会话 ID、会话名、最后一条消息、单聊联系人备注/名称/用户资料昵称、群聊群名称。
- 仍可通过
filterFn自定义搜索逻辑。
- 修复发送视频消息失败的问题:
- 原实现调用
sendVideoMessage(file, 0, ...)时 duration 为 0,触发 websdk2ValidationError: duration must be positive。 - 现在通过
<video>元素读取本地视频真实时长,读取失败时兜底为 1 秒,确保 duration 始终为正整数。
- 原实现调用
1.1.3 (2026-07-03)
新增
- 群信息抽屉(
ChatInfoDrawer)从 mock 数据升级为真实群信息入口:- 展示群名称、头像、描述、公告、成员数。
- 拉取并展示群成员列表(首页),区分群主/管理员/普通成员角色。
- 提供「清空聊天记录」「退出群聊」「解散群聊(仅群主)」操作,并带二次确认弹窗。
- 预留「查看全部成员」「添加成员」事件入口,下一期可接入群成员管理。
GroupDomain/useGroup新增群成员、群公告、转让群主、移除成员、邀请入群能力:fetchGroupMembers/fetchGroupAnnouncement/updateGroupAnnouncementchangeGroupOwner/removeGroupMembers/inviteUsersToGroup
GroupStore新增群成员与群公告缓存,group-events.ts事件已可自动同步更新。ConversationDomain/useConversation新增clearChatHistory,支持清空本地聊天记录并可选删除服务端漫游消息。MessageStore新增clearConversationMessages用于清理指定会话本地消息缓存。- 新增
UiGroupMember类型与toUiGroupMember适配器。 - 新增
chat.info.*系列国际化文案(群公告、群介绍、群主、管理员、成员、查看全部成员、添加成员、清空/退出/解散群聊等)。 - 新增
ChatInfoDrawerStorybook 示例(Group / SingleChat 两种 Variant)。
1.1.2 (2026-07-02)
新增
UIKitProvider新增enableUserInfo与enableUserInfoSubscriptionprops,业务可显式控制用户资料展示与陌生人资料变更订阅。enableUserInfo:是否启用自动拉取/展示用户资料(昵称/头像),默认true。enableUserInfoSubscription:是否启用陌生人资料变更订阅,默认true;服务端未开通时自动熔断并提示。
- 用户资料订阅无权限或服务未开通时,UIKIT 现在会通过内置 Toast 提示用户:
- 中文:"用户资料实时订阅未开通,陌生人资料变更不会自动更新,请联系管理员开通"。
- 英文:"User profile real-time subscription is not enabled. Stranger profile changes will not update automatically. Please contact the admin."。
- 提示仅触发一次,避免刷屏。
- 撤回消息失败时增加分类 Toast 提示:
message recall disabled/ 服务未开通:提示"消息撤回功能未开通,请联系管理员开通"。- 超过可撤回时间:提示"已超过可撤回时间,无法撤回"。
- 其他失败:提示"撤回失败,请稍后重试"。
- 失败仍会通过
recall-failed事件透传,业务层可继续自定义处理。
文档
- 为
UIKitProviderStorybook 补充用户资料订阅配置示例(开启 / 关闭订阅两种 Variant)。
1.1.1 (2026-07-02)
新增
- 新增
useOwnUserInfo()组合式函数,外层业务可方便地获取当前登录用户自己的昵称/头像:const { userInfo, displayName, avatarUrl } = useOwnUserInfo()。- 自动拉取当前用户资料并复用 UIKit 内部缓存。
- 不调用陌生人资料订阅,避免在 demo 等未开通订阅权限的环境下产生额外请求。
修复
- 修复用户资料订阅在服务端未开通/无权限时产生大量 403 控制台警告的问题。
UserInfoDomain.subscribeUserInfos现在会合并同一事件循环内的订阅请求,减少并发。- 检测到
code === 210/httpStatus === 403/reason === 'service_forbidden'时自动熔断,后续不再发起订阅请求。 - 失败用户 ID 会被缓存,避免反复重试;权限类错误仅 warn 一次,避免刷屏。
- 新增
UIKitFeatures.enableUserInfoSubscription开关,业务可主动关闭订阅。
- 修复聊天信息抽屉中备注编辑未接入 SDK 的问题。
- 点击保存后调用
contactManager.setContactRemark同步到服务端。 - 备注保存成功后抽屉内名称、联系人列表、聊天 header、会话列表、消息气泡等使用
remark的位置会自动刷新。 - 修复联系人 store 备注更新未触发响应式的问题(
updateContactRemark改为生成新对象并替换数组项)。 - 保存过程中按钮禁用并显示“保存中...”。
- 新增
chat.info.remarkSaveFailed/chat.info.saving国际化文案。
- 点击保存后调用
- 统一 UIKit 内用户昵称/头像展示优先级:
- 单聊场景下统一按 联系人备注(remark)> 用户资料昵称/头像(UserInfo)> 业务兜底名称/头像(会话/消息自带)> 用户 ID 的顺序展示。
useUserInfo()与useOwnUserInfo()的displayName/avatarUrl已纳入contact.remark/contact.avatar。- 已覆盖位置:会话列表(
conversation-item)、聊天窗口顶部 header(chat)、消息气泡发送者(message-bubble-wrapper)、聊天信息抽屉(chat-info-drawer)。 - 群聊仍使用会话自身名称/头像,不受单聊资料优先级影响。
1.1.0 (2026-07-01)
新增
- H5 适配核心能力:新增
useH5Adaptation()与UIKitProvider的h5配置,集中管理 viewport、安全区、软键盘高度、下拉刷新开关与字号缩放预留。 - 安全区接入:自动为
chat-container、chatheader、address-book-containerheader/footer、popupbottom、scroll-to-top、message-inputemoji sheet、conversation-listheader/footer 增加安全区内边距。 - 键盘适配:
chat输入框 focus 时自动滚动消息列表到底部,避免软键盘遮挡最新消息。 - 下拉刷新:
<UIKitProvider :h5="{ pullRefresh: 'auto' }">可在触屏设备上自动开启。 - 长按交互:
useLongPress统一改用 vueuseonLongPress,增加 touchmove 阈值与长按时禁止 body 滚动,解决 H5 长按与页面滚动冲突。 - 动画 token 接入:
message-inputemoji sheet 等 H5 高频路径的过渡时长改接--uikit-anim-*CSS 变量。
文档
- 新增 H5 适配指南。
- 更新根
README.md、apps/docs/index.md与apps/docs/.vitepress/config.ts。 - 新增
.agent/skills/uikit-h5-adaptation/SKILL.md,并更新AGENTS.md、相关 skill 与TECH-DEBT.md。
@easemob-community/uikit-core 2.13.0 (2026-11-12)
新增
- 可视视口公开状态:
useH5Adaptation/useViewport新增visibleHeight与viewportOffsetTop,Provider 向子树提供--uikit-visible-height和--uikit-viewport-offset-top,不支持visualViewport时回退到innerHeight与零偏移。
修复
- H5 图片预览适配:预览层挂载到
body,脱离宿主裁剪与层叠上下文,并跟随 Provider 的可视高度和顶部偏移;Provider 外使用保持兼容。
@easemob-community/uikit-core 2.12.0 (2026-11-06)
新增
- 复合消息共享基座:透出
MultiBody/MultiBodySegment/MultiBodySegmentInput、附件下载结果与对应类型守卫;toUiMessage保留复合分段顺序并以markRaw避免无用深响应式包装。 - 能力缺省兼容:新增
multiBodyMessage能力位,旧自定义 adapter 未上报时默认关闭,避免暴露不存在的复合发送入口。
@easemob-community/uikit-core 2.11.0 (2026-10-09)
新增
- 初始化配置支持
appId与loginTimeoutMs(D143/D144):normalizeInitConfig将二者纳入标准字段(不再下沉 adapterConfig);auto-init 与延迟初始化判定、client store 应用身份记账(setAppKey)均兼容 appId 模式。
@easemob-community/uikit-core 2.10.0 (2026-10-08)
新增
EmActionSheet高频网格区与拖拽扩档:ActionSheetItem新增zone('grid'顶部图标 tile 横排、超出横向滚动 /'list'默认整行列表,select 事件 index 语义保持原数组下标);新增expandable(默认 false):顶部 drag handle,半屏档 50dvh ↔ 展开档 78dvh(受 EmPopup bottom 80dvh 上限约束),拖拽跟随、松手按方向吸附、轻点切换档位,展开后列表区纵向滚动。未开启时行为完全不变。
修复
EmPopup遮罩点击关闭回归:core 2.8.0 引入的「点击落在其它弹层内不视为外部点击」豁免未区分弹层实例,本弹层自身遮罩也在.uikit-popup根内被一并豁免,导致closeOnClickOverlay全面失效(H5 底部弹窗场景最明显);收窄为仅豁免其它弹层实例,自身遮罩点击恢复关闭。
@easemob-community/uikit-core 2.9.0 (2026-09-28)
新增
EmModal/EmPopup移动端体验优化:H5 下 footer 按钮等宽铺满且顺序翻转为取消左/确认右;语义类弹窗(success/warning/error 等)H5 保持居中;新增fullscreen/mobileFullscreen全屏档位;弹层高度补dvh兜底。
@easemob-community/uikit-core 2.8.7 (2026-09-21)
修复
- core
login()同步提前记账currentUser:同 websdk5 1.3.4,消除「REST 消息先于 login resolve 到达」的空currentUserId竞态窗口,登录失败回滚清空。
@easemob-community/uikit-core 2.8.6 (2026-09-21)
新增
EmBadge新增inlineprop:徽标不占位覆盖、按文档流渲染(如会话列表行尾未读数),默认false行为不变;开启后placement不生效。- defaultFeatures 新增
enableReadReceipt: true:全局已读回执开关默认值,经 features 响应式链路下发 adapter 与 UIKit(sdk-contract 1.3.1)。
@easemob-community/uikit-core 2.8.5 (2026-09-18)
变更
- 输入占位文字字号统一为 13px(
EmInput及聊天输入框),比正文(15px)小一档,对齐抽屉搜索框观感。 - 群成员移除文案收敛:
group.memberList.remove由「从群组移除」改为「移除」。
新增
- icons-v2 新增
dspntd(失望)图标:好友申请被对端拒绝的通知条目使用。 - locale 新增
contact.inviteRequestReceived/contact.inviteDeclinedByPeer:好友申请副文案与「拒绝了你的好友申请」通知文案。
@easemob-community/uikit-core 2.8.4 (2026-09-18)
变更
--uikit-sidebar-width默认值由固定360px改为弹性clamp(240px, 25%, 480px):新增边界 token--uikit-sidebar-min-width(默认 240px)/--uikit-sidebar-max-width(默认 480px),侧栏列表容器随宿主容器宽度伸缩;宿主覆写为100%或固定 px 的用法不受影响。
新增
EmResizable新增fluidprop:fluid 且未拖拽过、无受控值时不写内联尺寸(由 CSS 决定),首次拖拽时测量根元素当前实际尺寸作为拖拽起点,拖拽后经update:model-value/ 内联 px 接管。
@easemob-community/uikit-core 2.8.3 (2026-09-17)
新增
- defaultFeatures 补齐昵称展示开关默认值:
showNicknameInSingleChat默认 false、showNicknameInGroupChat默认 true(契约字段定义见 uikit-sdk-contract 1.2.1)。
@easemob-community/uikit-core 2.8.2 (2026-09-17)
修复
- 修复生产构建中 core 组件(按钮等)样式随 SFC 源码改动漂移失配的问题(严重):
@vitejs/plugin-vue4.x 生产构建的 scopeddata-vhash =hash(文件路径 + SFC 源码),任何 SFC 内容修改都会生成新 scopeId;而@easemob-community/uikit-im的 theme 内联的是 core dist 构建期固化的 scoped 样式,core 单独重构建(如 2.8.0 → 2.8.1 修改 EmButton)会使已发布的 im theme 里的data-v选择器全部失配,表现为消费方生产构建中按钮等 core 组件失去全部样式。修复:升级@vitejs/plugin-vue至 ^5.2.4 并统一启用features.componentIdGenerator: 'filepath',scoped hash 仅由文件路径决定、与源码内容无关,重复构建保持稳定;新增构建守卫scripts/check-theme-scope-ids.mjs(core / uikit-im / uikit-chatroom 构建链接入),theme CSS 中出现运行时无法匹配的 scoped hash 时立即构建失败,杜绝再次静默产坏包。
@easemob-community/uikit-core 2.8.1 (2026-09-16)
变更
componentsShape方正档改为真直角(视觉变更):square档--uikit-components-radius由 4px 改为 0px(--uikit-components-radius-hover同步 10px → 0px)。原 4px 与圆润档 8px 在卡片 / 弹窗 / 按钮上肉眼几乎无差别,实测用户感知为开关失效;方正档现在呈现明确的直角风格(business 预设同步受影响)。同时清理 EmButton 中无人设置data-uikit-components-radius属性的失效 legacy 选择器(pill 按钮保持胶囊不受开关影响)。
@easemob-community/uikit-core 2.8.0 (2026-09-16)
变更
- 新增全局 header 底部分隔线开关
headerBorder:themeStore.headerBorder(持久化,默认false)驱动新 token--uikit-header-border-width(0px/1px);ProviderThemeConfig新增headerBorder?: boolean,useTheme()新增headerBorder/setHeaderBorder()。 - EmModal
showHeaderDivider默认行为变化:默认值由true改为「不传时跟随全局headerBorder开关(默认关闭)」,显式传true/false仍优先(沿用 Avatarshape回落主题的惯例)。此前依赖默认显示 header 分割线的弹窗,需开启全局开关或显式:show-header-divider="true"。
@easemob-community/uikit-core 2.7.1 (2026-09-16)
变更
- EmModal 度量对齐设计稿(视觉变更,无 API 变更):header 高 60px(
padding 13px 12px 13px 16px,标题 18px/Medium);body 默认 padding 24px → 56px 48px、默认字号 14 → 18px(bodyFlush贴边形态不变,承接表单/穿梭/列表场景);正文语义图标 56 → 72px;footer 高 80px(padding 16px 22px,按钮间距 16 → 12);外壳移除 1px 描边(设计稿仅阴影),圆角仍跟随--uikit-components-radius、阴影走--uikit-shadow。移动端 bottom-sheet 分支保持原有紧凑度量不受影响。
@easemob-community/uikit-core 2.7.0 (2026-09-16)
变更
- 能力开关默认对齐产品化形态(行为变更):
defaultFeatures与 coreUIKitProvider的enableContact/enableBlocklist/enablePresence默认由false改为true(此前 Provider 保守默认与 defaultFeatures 故意不一致,现对齐);usePresence关闭告警文案同步更新。presence 订阅有额外请求成本,低频场景显式关闭。
@easemob-community/uikit-core 2.6.0 (2026-09-04)
新增
- 文件类型图标底色 token:
--uikit-file-icon-{pdf,xls,doc,ppt,md,img,video,audio,file}品牌识别色(pdf#E5252A/ xls#1D7044/ doc#2B5797/ ppt#D24625/ md#424242/ img#00897B/ video#E91E63/ audio#7B1FA2/ 未识别普通文件#4CAF50),明暗模式通用。
@easemob-community/uikit-core 2.5.0 (2026-09-03)
新增
EmText排版原子组件(TECH-DEBT D127):level对齐设计师 Value.tokens.json 9 档(h0=34 / h1=28 / h2=22 / h3=18 / body-lg=16 / body=14 / caption=12 / small=10 / mini=8)并补body-sm(13px);每档内置「字号 + 行高」配对(行高按稿值换算为calc(Npx × --uikit-font-scale),跟随适老缩放)与默认字重;weight(regular / medium / semibold / bold)可覆盖默认字重,color(primary / secondary / tertiary / inverse)走语义 token,ellipsis单行截断,tag默认span。新增后不全库回改,新代码用、老代码渐进迁移。- 字号 token 补两档大标题:
--uikit-font-size-28/--uikit-font-size-34(明暗两段,×--uikit-font-scale)。 - 字体族栈首声明设计规范字体:
--uikit-font-family栈首加'Inter'(拉丁字形)/'Noto Sans SC'(中文),本机未安装时自动回落 PingFang SC / 雅黑 / 思源黑体等系统字体栈;库不内置网络字体加载,需要精确字形时由接入方自行引入 webfont。 - 气泡语义 token 扩展与默认值校准(设计规范):新增
--uikit-bubble-radius(round 档 16px,默认)/--uikit-bubble-radius-square(square 档 8px)与气泡内分割线--uikit-bubble-divider-other/--uikit-bubble-divider-self(明暗两段);气泡默认色校准为对方#E4E6E7/#171A1C、己方#009EFF/#FFFFFF(暗色段:对方沿用表面色与文字色,己方保持品牌蓝#009EFF)。 INJECTION_KEY.VOICE_UNREAD_DOT注入键:语音未读红点开关的 provide/inject 通道(ComputedRef<boolean | undefined>,undefined 回落默认 true),支持消息项级深一层 provide 覆盖。
@easemob-community/uikit-core 2.4.0 (2026-09-03)
新增
- 连接状态「被踢」账号态:client store 新增
kicked/kickCode/setKicked(code)(setConnected(true)与clearClient自动清除),供 UI 区分账号终态与网络异常。 - 列表项 hover 风格第三档
square:HoverStyle扩为'default' | 'rounded' | 'square'(直角整行高亮,radius 归零);business预设默认改为square;theme/index.css:root补齐--uikit-item-hover-radius/--uikit-item-active-radius/--uikit-item-hover-margin-x/--uikit-item-hover-padding-x静态默认(8px,与default档一致),未接 themeStore 的场景不再缺变量。 - Input
pill椭圆档:显式 prop(border-radius 9999px、整体高度 36px、垂直 padding 8px),优先级高于主题componentsShape;默认false保持圆角矩形。新增语义 token--uikit-input-border-color(default 变体边框,浅#F5F5F5/ 深#374151)。 - locale 新增
status.kickedAnotherDevice/status.kickedPasswordChanged/status.kickedDeviceLimit/status.kickedOffline(中英双语)。
修复
- Input 带前缀图标比例校准:search/filled 变体下前缀图标左缩进 8px、文字
padding-left28px(图标 8 + 图标宽 16 + 间距 4 的设计规格),修复图标过于靠左的问题(删除两条老的left: 4px覆盖)。
@easemob-community/uikit-core 2.3.0 (2026-09-02)
新增
- Badge 档位体系:尺寸扩为六档
xs(仅 8px 圆点)/s/m/l(默认)/xl/xxl(单位数正圆、多位数药丸按规格表);新增placement(top-right默认 /bottom-right)与bordered(2px 描边与头像分界,box-shadow外环实现、随背景色自适应、不与 stroked 描边冲突);新增导出类型BadgePlacement。 - 语义 token:
--uikit-cell-bg(Cell 项背景,默认透明,会话列表 card 变体覆写为浮层色)、--uikit-conversation-list-bg、--uikit-empty-icon-color/--uikit-empty-text-color、--uikit-badge-bg(徽标默认背景#FF7070,独立于 danger 语义色);新增图标list/bullet,filled/pin更换新版资源。
变更
- token 默认值校准(对齐设计色板):
--uikit-bg-hover浅#e5e7eb→#F5F5F5;--uikit-bg-active浅色 alpha 0.08 → 0.12(≈ 主色 12% 叠白,视觉对齐#E5F5FF且保持跟随主色);--uikit-icon-muted浅#B6B8BF→#949A9E。 - locale 默认文案:
conversation.empty「暂无会话」→「没有会话」,chat.empty「请选择会话」→「选择一个会话」(en 同步为Select a conversation)。
破坏性行为变更
BadgeSize枚举重定义:'normal' | 'small'→'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl',sizeprop 默认值'l';Badge 默认色由--uikit-danger-color改为--uikit-badge-bg(#FF7070)。
@easemob-community/uikit-core 2.2.0 (2026-09-02)
新增
SdkConfig.persistence透传槽:旁路写库钩子(SdkPersistenceHooks)随repositories同路经 core 归一化下沉adapterConfig下发 adapter(resolved.persistence ?? adapterConfig.persistence归一),未注入时行为零变化。
@easemob-community/uikit-core 2.1.0 (2026-09-02)
性能
- 日志持久化空闲零唤醒:log-store 落库定时器由常驻
setInterval改为setTimeout链,缓冲清空即停表,消除 Electron/长会话场景每 2s 空转唤醒。
行为变更
usePresence增加开关硬门:subscribePresence/unsubscribePresence/fetchPresence/publishPresence/watch在features.enablePresence === false时全部 no-op(fetch 返回空数组),不再依赖各调用点自觉 gate;开启时行为不变。
@easemob-community/uikit-core 2.0.0 (2026-09-02)
破坏性行为变更
- SDK 装配改 adapter 驱动:移除
createClient/UIKitClient/ManagerHost/registerEventHandlers老路;useCoreUIKitProvider重写为纯 adapter 驱动(init/login/logout/subscribe),业务 store 经adapterConfig.stores注入,事件依赖(i18n/通知)经adapterConfig.eventDeps注入;onClientSetup替换为onAdapterReady(logout/重初始化/卸载三处 dispose)。 - 引擎层隔离门禁:core 引擎层(sdk/constants/utils)禁止 vue/pinia/@vueuse 与
easemob-websdk的值 + 类型依赖(check-engine-isolation.mjs,构建前置)。
新增
- dataSource 薄别名收口:新增
composables/data-source-repositories.ts,把dataSource逐项翻译为SdkRepositoryOverrides注入 adapter Domain(惰性 getter 保持运行时切换语义,显式repositories按域整体优先)。 useSyncStatus下沉 core(onSyncStatus 桥接);formatSdkError/parsePresenceStatus/toUiMessage去 websdk5 依赖(鸭子类型判定)。
@easemob-community/uikit-core 1.5.2 (2026-08-28)
调整
- EmojiPicker「常用」区空时隐藏:仅当有最近使用 emoji 时展示「常用」区;移除
emoji.recentEmptyi18n key。 - 移除
emojiPreviewprop:删除内置 emoji 悬停放大预览气泡(逻辑 + 样式);sticker 的stickerHover预览切换不受影响。
@easemob-community/uikit-core 1.5.1 (2026-08-28)
调整
- EmojiPicker「常用」与「Emoji」合并为单一视图:常用最近使用区置于视图顶部、完整 Emoji 列表在下,同一滚动区;移除已无用的
recentIconprop(emojiIcon改为表情视图 tab 图标),其余 props(recent/recentCount/tabsPosition/stickerHover/emojiPreview)语义不变。
@easemob-community/uikit-core 1.5.0 (2026-08-28)
新增
- EmojiPicker 组件重构:
- 「常用」改为动态最近使用:
useUIKitStorage按appKey + userId隔离持久化(无<UIKitProvider>时降级内存),默认保留最近 5 个(recentCount可配); - 独立「Emoji」完整列表 tab(新增
EMOJI_ALL常量);表情包注入 tab 默认不自动选中; - 新增 props:
recent/recentCount/tabsPosition(默认bottom)/stickerHover/recentIcon/emojiIcon/emojiPreview;支持 sticker hover 预览图 ↔ gif 切换、内置 emoji 悬停放大预览、每个 tab 项预览小图(表情包缺省自动回落包内第一个 sticker 预览图); - 新增公开类型
EmojiTabsPosition;新增 i18nemoji.full/emoji.recentEmpty(zh-CN / en)。
- 「常用」改为动态最近使用:
修复
- 重登后事件处理器未恢复注册(D123):
useCoreUIKitProvider抽取registerClientSetup()(幂等重建onClientSetup场景挂钩 + user-info 监听),setupClient与login()共用;登出后重新登录先恢复注册再连接,连接事件不再无人消费;client新增isConnected访问器。
@easemob-community/uikit-core 1.4.0 (2026-08-26)
破坏性变更
- 图标资源目录整合:
assets/icons-filled/下 7 个面性 SVG 迁移到assets/icons-v2/filled/,icon-map.ts移除独立 filled 注册表,面性图标 name 仍保持filled/前缀;assets/icons/旧库整目录删除,V2 成为唯一图标库。 - 修复 3 个 V2 资源拼写错误:
singal→signal、rect/personnclock→rect/person-clock、rectnarrowreturn→rect/narrow-return。
修复
icons:check脚本覆盖assets/icons-v2/(含filled/)与assets/icons/,旧库删除后自动仅校验 V2;支持无src/目录的包扫描。
@easemob-community/uikit-core 1.3.0 (2026-08-25)
新增
- 黑名单选人 i18n 文案:新增
contact.blocklist.add/contact.blocklist.emptySelectable/contact.blocklist.addSuccess/contact.blocklist.addFailed(zh-CN / en),供黑名单「添加」选人弹窗使用。
@easemob-community/uikit-core 1.2.0 (2026-08-25)
新增
- 通讯录黑名单 i18n 文案:新增
contact.entryBlocklist与contact.blocklist.empty/contact.blocklist.remove/contact.blocklist.removeConfirmTitle/contact.blocklist.removeConfirm/contact.blocklist.removeSuccess/contact.blocklist.removeFailed(zh-CN / en),供 uikit-im 黑名单列表使用。
@easemob-community/uikit-core 1.1.0 (2026-08-19)
新增
- Skeleton 骨架屏组件:新增
EmSkeleton组件,支持头像 + 文字行变体,动画 shimmer 跟随--uikit-anim-*并尊重prefers-reduced-motion。 - Modal danger 变体:
EmModal新增type?: 'default' | 'danger'。 - Toast 能力补全:
EmToast/useToast新增closable/position/actionText/#action插槽;duration=0表示不自动关闭。 - Input error / readonly 态:
EmInput新增error/error-message/readonlyprops。 - Empty 空状态模板:
EmEmpty扩展illustration/title/description/actionslot。
视觉与主题
- 全局焦点环:
theme/index.css新增--uikit-focus-ring-color与全局:focus-visible样式。 - 间距阶梯:新增
--uikit-spacing-1~7与密度档映射。 - Type Scale 排版规范:新增
--uikit-font-lineheight-*/--uikit-font-weight-*/--uikit-font-family。 - 暗色对比度:
text-tertiary暗色值提亮为#8a92a0。 - 动画系统完善:新增
data-uikit-anim-level(subtle/normal/expressive)与data-uikit-anim-enabled覆盖。
修复
- 图标 color 行为统一:描边/填充图标均通过
colorprop 改色,无需:style特例。 - 移动端触摸热区:
EmIconButton在触屏设备下扩展最小触摸区域至 44×44px。
@easemob-community/uikit-core 1.0.0 (2026-08-15)
新增
- 图标体系:
EmIcon支持多注册表(assets/icons+assets/icons-v2+assets/icons-filled),icon-map.ts新增getV2IconNames()/getFilledIconNames(),为线性/面性图标库提供自动索引;colorprop 对fill="currentColor"的填充式图标同样生效。 - 共享基座首版(P1 抽核自
@easemob-community/uikit-im迁出):- SDK 基座层:
UIKitClient/ManagerHost(含ChatRoomManager注册,为聊天室场景包预留)/ wire 类型 / user-info & presence domain / 连接级事件 / notice 工具 - Pinia stores:
useClientStore/useThemeStore/useUserInfoStore/usePresenceStore - 共享 composables:
useClient/useTheme/useUserInfo/useOwnUserInfo/usePresence/useToast/useNotification/ H5 通用(useH5Adaptation/useKeyboard/useLongPress/usePullRefresh/useViewport/useBottomSheet/useRipple)/ 通用交互(useKeyBindings/useResizable/useUIKitStorage)/ Provider 装配(useCoreUIKitProvider/useCoreUIKit/useProviderSideEffects) - 24 个原子组件(Em* 基础组件集,含 story)+ theme CSS 变量(539 行)+ locale(含
mergeLocaleMessages,供场景包合并 i18n keys)+ constants + 通用 utils(logger / log-store / sdk-error / download / z-index / format-time / linkify) - core 版
EmUIKitProvider容器(props 子集 + 场景无关共享副作用) - resolver / auto-imports 参数化生成(
gen-aux-entries.mjs):EasemobUIKitCoreResolver/EasemobUIKitCoreImports
- SDK 基座层:
- 对外 API 零回归:
@easemob-community/uikit-im全量 re-export core 符号,原 416 个公共导出名全部保留。
@easemob-community/uikit-sdk-contract 1.5.1 (2026-11-10)
修复
- 群资料中立字段补齐:
UiGroup新增可选ext、inviteNeedConfirm与joinedAt,统一群扩展信息、邀请确认配置及入群时间的跨 SDK 数据契约。
@easemob-community/uikit-sdk-contract 1.5.0 (2026-11-06)
新增
- 复合消息中立契约:新增
multi_body类型、七类分段输入与 body、类型守卫、附件下载结果、发送/重试/下载 domain 接口及multiBodyMessage能力位;发送创建限制 2~20 段,接收侧不截断历史消息。 - 共享摘要与记录工具:
resolveMultiBodyPreview统一会话、引用、置顶和搜索摘要,记录工具支持复合消息数组安全读写。
@easemob-community/uikit-sdk-contract 1.4.0 (2026-10-09)
新增
SdkConfig新增appId与loginTimeoutMs(D143/D144):appKey由必填放宽为与appId二选一(类型层保持双可选、由 adapter 运行时校验,向后兼容既有 appKey 调用方);loginTimeoutMs仅 websdk5(SDK 5.1.2+)生效,webim4 忽略。
@easemob-community/uikit-sdk-contract 1.3.1 (2026-09-21)
新增
UIKitFeatures新增enableReadReceipt?: boolean:是否启用消息已读回执,默认 true;类型面供 core / adapter / uikit-im 共享。
@easemob-community/uikit-sdk-contract 1.3.0 (2026-09-18)
新增
SdkMessageDomain新增removeMessages:删除当前用户的服务端漫游历史(本账号各端同步生效),补齐消息删除的契约面(双 adapter 实现见 websdk5 1.3.1 / webim4 1.3.1)。UiContactInvite新增outgoing字段:标记「我发出的申请被对方拒绝」的通知方向,用于通知列表展示。
@easemob-community/uikit-sdk-contract 1.2.1 (2026-09-17)
新增
UIKitFeatures新增两个可选开关:showNicknameInSingleChat(单聊消息列表是否展示对方昵称,默认 false)、showNicknameInGroupChat(群聊消息列表是否展示发送者昵称,默认 true)。
@easemob-community/uikit-sdk-contract 1.2.0 (2026-09-03)
新增
- 被踢错误码契约:
KICK_ERROR_CODE(206 多端互踢 / 207 账号注销 / 214 设备数超限 / 216 修改密码 / 217 被其他设备踢下线,websdk 两代同码)与类型守卫isKickErrorCode()。
@easemob-community/uikit-sdk-contract 1.1.0 (2026-09-02)
新增
- 旁路持久化契约(D122 Phase 3.2/3.4 前置):新增入库 DTO
MessageRecord(SdkMessage+ 墓碑字段recalled/deleted/tombstoneTime)与ConversationRecord;新增清洗函数toMessageRecord/toConversationRecord(纯 TS,剥离 File/Blob/函数、combinemessageList递归、ext限深防循环引用);新增SdkPersistenceHooks(message/conversation两域钩子,全部可选、fire-and-forget 语义);SdkConfig新增persistence槽(旁路写库,与repositories数据入口接管语义分立)。
@easemob-community/uikit-sdk-contract 1.0.0 (2026-09-02)
新增
- 首次发布:SDK 中立契约包——中立 wire 类型(
SdkMessage/UiMessage/UiConversation/UiGroup/UserInfo等)、常量、事件集、repository 数据入口接口、domains 业务域接口(Domain Port)、SdkCapabilities能力矩阵(boolean 能力位 +contractVersion/meta.reason/minContractVersion协商机制)、SdkAdapter组合接口与初始化配置,及少量中立纯工具(logger / normalizeUserId / message-preview / stream-message)。零 SDK、零 UI 框架依赖。
@easemob-community/uikit-sdk-websdk5 1.6.2 (2026-11-10)
修复
- 群成员角色缓存一致性:
fetchGroupMembers按当前页合并缓存成员角色,首页重查与游标追加均保留已同步的admin,避免设置管理员后仍返回member;分页顺序、cursor与hasMore语义不变。
@easemob-community/uikit-sdk-websdk5 1.6.1 (2026-11-10)
修复
- 群资料字段完整同步:群详情与摘要映射、创建快照、更新回写及群资料事件均保留
ext、inviteNeedConfirm与joinedAt;旧版顶层稀疏事件过滤undefined,避免覆盖已有群资料缓存。
@easemob-community/uikit-sdk-websdk5 1.6.0 (2026-11-06)
新增
- 适配 easemob-websdk 5.2.0 复合消息:支持七类有序分段创建发送、原消息对象重试与全附件按序下载;接收转换、事件旁路持久化保留数组及顺序,blob URL 与 File 不落库。
- 复合摘要与本地会话重算:按分段顺序生成文本/文件名/地址等摘要,支持
refreshPreviews仅重算现有会话预览,不覆盖其他本地字段。
@easemob-community/uikit-sdk-websdk5 1.5.0 (2026-10-09)
新增
- 支持 App ID 初始化(SDK 5.1+):
SdkConfig.appKey与appId二选一,两者都未提供且非注入模式时 init 明确报错;adapterConfig透传槽中的身份字段剥离,以契约顶层为准。 - 支持自定义登录超时(SDK 5.1.2+):
SdkConfig.loginTimeoutMs透传至login({ userId, token, timeoutMs }),缺省走 SDK 默认 30s。
@easemob-community/uikit-sdk-websdk5 1.4.0 (2026-10-09)
新增
- SDK 日志捕获接入官方
onLog通道(SDK 5.1+):sdk-log-capture探测链新增最高优先级分支——检测到 SDK 根导出LogEventName且 client 单例已初始化时,经addEventHandler注册onLog回调,接收 SDK 已脱敏的结构化日志(timestamp/level/message/args),不再依赖 console 拦截;旧版 SDK(5.0.x)或未初始化场景自动回退原有 console patch 方案。探测链优先级:onLog > setLogger 注入 > console 拦截。
适配 easemob-websdk 5.1.x
ClientConfig适配InitConfig联合类型:SDK 5.1 起InitConfig变为appKey / appId二选一联合,ClientConfig由 interface extends 改为交叉类型,单例一致性校验同时比对appKey/appId;adapterConfig透传槽剥离appId(中立契约SdkConfig.appKey仍为必填,App ID 初始化的契约支持另行评估)。
@easemob-community/uikit-sdk-websdk5 1.3.4 (2026-09-21)
修复
currentUser记账提前到 login 发起前:SDK 连接建立瞬间即可推送消息(典型:服务端 REST 下发的欢迎语在 login resolve 前经onMessage到达),此前setCurrentUser在await login()resolve 后才执行,窗口期内toUiMessage打currentUserId is empty告警且isSelf/ 自动清未读 / @我 / 通知过滤不可靠;现同步提前记账、失败回滚清空。
@easemob-community/uikit-sdk-websdk5 1.3.3 (2026-09-21)
新增
enableReadReceipt能力开关落地:onMessage实时回执(queueMessageReadReceipt)与进入会话补发(sendPendingReadReceipts钩子)在开关关闭时整体跳过,不再调用sendMessageReadReceipts。
@easemob-community/uikit-sdk-websdk5 1.3.2 (2026-09-20)
新增
- 联系人关系变更全局通知:通知引擎新增
notifyContactEvent,onContactRefuse(我发出的好友申请被对方拒绝)与onContactDeleted(被好友删除)除既有 store 写入 / 会话内通知外,同时投递全局通知(页内右上角弹窗 / 页面隐藏时浏览器系统通知优先、失败降级页内)。好友关系变更属低频高优事件,跳过免打扰 / 当前会话 / triggerMode 判定,仅尊重通知总开关;送达回调通道语义与消息通知一致。
@easemob-community/uikit-sdk-websdk5 1.3.1 (2026-09-18)
新增
- 实现契约
removeMessages:透传 SDKchatManager.removeHistoryMessages删除服务端漫游历史,成功后触发persistence.message.deleteMessages删除墓碑(多端移除事件路径另有落库)。
修复
onContactRefuse补「我发出的申请被对方拒绝」通知:无本地 pending 申请时落一条outgoing: true的拒绝通知,UI 展示「拒绝了你的好友申请」。
@easemob-community/uikit-sdk-websdk5 1.3.0 (2026-09-16)
变更
getDefaultFeatures()的enablePresence默认由false改为true:adapter 独立运行或未传 features 时与 UIKit Provider 3.6.0 默认对齐(在线状态为产品化默认形态);注意订阅/查询会带来额外请求,低频场景应显式关闭。
@easemob-community/uikit-sdk-websdk5 1.2.2 (2026-09-03)
新增
- 语音未播放打标:
onMessage实时收到对方语音消息时调用stores.message.markVoiceUnplayed?.(msgId)(MessageStoreLike新增可选方法,chatroom 等场景 store 可缺省),支撑 UI 层语音未读红点;历史/漫游路径不打标。
修复
- 被踢误报网络异常:
onDisconnected按错误码识别被踢/账号失效(取payload.errorCode),命中KICK_ERROR_CODE时调用client.setKicked(code)标记账号终态,而非仅置 disconnected;内置 client store 的EventStores结构补setKicked;新增connection-events回归测试。
@easemob-community/uikit-sdk-websdk5 1.2.1 (2026-09-02)
修复
- 免打扰状态被会话快照冲掉:
mergeWithExistingConversations合并重叠会话时isMuted/remindType以本地为准(SDK 会话快照恒 DEFAULT 不携带该状态),修复设置/解除免打扰后来新消息即被重置的问题;权威同步通道(setMuted回写 /CONVERSATION_MUTE_INFO_CHANGED/patchConversationMuteStates)语义不变,合并回归测试补isMuted保留断言。
@easemob-community/uikit-sdk-websdk5 1.2.0 (2026-09-02)
新增
- 旁路写库钩子接线:发送成功 / SDK 漫游回流 / 收消息 / 撤回(含本端主动撤回即落墓碑)/ 编辑 / 送达与单聊已读回执 / 多设备删除 / 会话列表回填,逐点触发
persistence钩子(fire-and-forget,失败仅告警不阻塞);repository 注入路径(数据来自本地库)不写回;流式分片不落库(完整消息经 onMessage/漫游路径落库)。
修复
- 会话覆盖竞争(D122 3.3):
mergeWithExistingConversations升级为并集合并——本地独有会话(如 DB 预填)不再被 SDK 快照冲掉,重叠会话保留本地draft/draftTime/remindType字段;patch.removed显式删除通道不受影响。
@easemob-community/uikit-sdk-websdk5 1.1.0 (2026-09-02)
性能
- 用户资料拉取合批:
fetchUserInfos同 tick 多次调用经微任务合并为一次底层请求(userIds 去重、attributes 取并集),消除大列表首渲染 N+1;防重与失败标记语义不变。
破坏性行为变更
- presence 独立运行默认关闭:
getDefaultFeatures()的enablePresence由true改为false——adapter 独立运行或未传 features 时不再默认启用在线状态,仅 Provider 显式enablePresence开启才启用(Provider 路径默认本为 false,无影响)。
@easemob-community/uikit-sdk-websdk5 1.0.0 (2026-09-02)
新增
- 首次发布:easemob-websdk 5.x 适配器——
Websdk5Adapter(内置 / 注入双模式)+ 六域 Domain(message/conversation/contact/group/presence/userInfo)+ 事件层 + 中立字段映射 + 六 repository 代理 + 新消息通知引擎,实现@easemob-community/uikit-sdk-contract全部接口;SdkRepositoryOverrides全域可注入。
@easemob-community/uikit-sdk-webim4 1.4.3 (2026-11-10)
修复
- 群成员角色缓存一致性:
fetchGroupMembers按当前页合并缓存成员角色,首页重查与游标追加均保留已同步的admin,避免设置管理员后仍返回member;分页顺序、cursor与hasMore语义不变。
@easemob-community/uikit-sdk-webim4 1.4.2 (2026-11-10)
修复
- 群扩展信息同步:将 4.x 群资料
custom映射为中立字段ext,并在创建快照、更新回写及群资料事件中保留ext与inviteNeedConfirm。
@easemob-community/uikit-sdk-webim4 1.4.1 (2026-11-06)
变更
- 明确复合消息能力边界:上报
multiBodyMessage: false及原因,保留中立 domain 契约兼容占位;websdk 4.x 不提供复合发送、接收转换、转发、下载或兼容渲染。
@easemob-community/uikit-sdk-webim4 1.4.0 (2026-10-09)
新增
- 消费 4.24.3 群事件
userId字段(D145):changeOwner直接以payload.userId定位新群主(不再依赖 pending 转让标记/本地启发式,旧包无该字段时自动回落);removeMember可区分「自己被移出」(移除群+删会话)与「其他成员被移出」(仅减成员数+通知);removeAdmin角色更新在 4.24.3 下生效(此前载荷无 userId 只能跳过);unblockMember日志补 userId。
变更
- appKey 缺失时明确报错:4.x 仅支持 appKey 初始化,仅传
appId(SDK 5.1+ 能力)且非注入模式时 init 抛出清晰错误。
@easemob-community/uikit-sdk-webim4 1.3.4 (2026-10-09)
变更
- 4.x SDK 依赖由
easemob-websdk@4.24.2升至4.24.3(群事件 payload 新增userId字段,本包暂不消费)。
@easemob-community/uikit-sdk-webim4 1.3.3 (2026-09-21)
修复
currentUser记账提前到 login 发起前:同 websdk5 1.3.4,4.x 线对称修复。
@easemob-community/uikit-sdk-webim4 1.3.2 (2026-09-20)
新增
- 联系人关系变更全局通知:与 websdk5 1.3.2 对齐,
onContactRefuse/onContactDeleted同步投递全局通知。
@easemob-community/uikit-sdk-webim4 1.3.1 (2026-09-18)
新增
- 实现契约
removeMessages:4.x SDK 无单条删除服务端漫游历史的公开 API,降级为本地删除语义(仅落删除墓碑),UI 本地移除行为与旧版一致。
修复
onContactRefuse补「我发出的申请被对方拒绝」通知:与 websdk5 1.3.1 对齐。
@easemob-community/uikit-sdk-webim4 1.3.0 (2026-09-16)
变更
- 同 websdk5 1.3.0:
getDefaultFeatures()的enablePresence默认由false改为true。
@easemob-community/uikit-sdk-webim4 1.2.2 (2026-09-03)
新增
- 语音未播放打标(与 websdk5 同口径):
onMessage实时收到对方语音消息时调用stores.message.markVoiceUnplayed?.(msgId)(MessageStoreLike新增可选方法)。
修复
- 被踢误报网络异常(与 websdk5 同口径):
onDisconnected按error.type识别被踢/账号失效并client.setKicked(code);内置 client store 的EventStores结构补setKicked;新增connection-events回归测试。
@easemob-community/uikit-sdk-webim4 1.2.1 (2026-09-02)
修复
- 免打扰状态被会话回填冲掉:
mergeIncomingConversations同 websdk5 1.2.1 口径,共有项保留本地isMuted(回填项恒 false 不携带);权威同步通道(setMuted回写 /patchMuteStates)语义不变,回归测试同步补断言。
@easemob-community/uikit-sdk-webim4 1.2.0 (2026-09-02)
新增
- 旁路写库钩子接线(与 websdk5 同构对齐):同一套
persistence语义点按 4.x 事件模型接入(含 4.x 特有的onModifiedMessage编辑、deleteRoaming多设备删除按会话粒度展开为消息 ID 集)。
修复
- 会话回填并集合并:
applyServerItems/注入路径refresh不再冲掉本地独有会话,共有项继承本地draft/draftTime/remindType;顺带修复 4.x 收到deleteRoaming多设备删除事件时本地 store 未清理的问题。
@easemob-community/uikit-sdk-webim4 1.1.0 (2026-09-02)
性能
- 用户资料拉取合批:同 websdk5 1.1.0,4.x 侧同构对齐(底层走
fetchUserInfoById,attributes 经 wire 映射)。
破坏性行为变更
- presence 独立运行默认关闭:同 websdk5 1.1.0。
@easemob-community/uikit-sdk-webim4 1.0.0 (2026-09-02)
新增
- 首次发布:easemob-websdk 4.x(4.24.2)适配器——
Webim4Adapter(内置 / 注入双模式)+ 六域 Domain + 单addEventHandler事件层归一化(批量 onMessage 逐条展开、read/delivery/channel 回执归一、流式增量、群事件 operation 分发)+ 字段/API 映射(合并/置顶/流式/已读回执全支持)+ 登录预取(对齐 5.x 同步体感)+ 漫游 pb 容错(坏消息跳过不拖垮整页)。4.x SDK 经 npm aliaseasemob-websdk-4引入,与 5.x 同工程共存互不干扰。
