更新日志
@openmaxai 聊天包每个 3.0.0-beta 预发布版本改了什么。
更新日志
@openmaxai/chat-sdk、@openmaxai/chat、@openmaxai/chat-store 和 @openmaxai/chat-openmax 一起发布,版本号相同。所有导出都是 @experimental,预发布版本之间可能改动,请锁定精确版本(见安装)。
3.0.0-beta.5 (2026-11-08)
新增
- 弹出、拖出、拖回。 会话可以弹出成浮窗、从会话列表拖出来,也可以拖回主区域(需主动开启,只在宽布局下生效)。见浮出面。
- 布局由宿主存储保存。
createChatHost新增surfaceStorage和anchorStorage,把打开的窗口、偏好和阅读位置存进你提供的存储;<CwsConversationList>新增width/onWidthChange,列表宽度可由你的应用自己保存。 - 头像条。
<CwsConversationList>加compact后画成 64 px 宽的头像条,<ChatSplitLayout>也新增对应的一档。 - 头像带身份和在线状态:所有显示成员的地方都用同一个形状和几档尺寸。
- Agent 信息。 Agent 行和
@提及面板显示能力标签(适配器的capabilityTags),Agent 发送者旁显示模型名,计费停用的 Agent 显示为停用(billingSuspended、isBillingSuspended)。 - 引用消息中选中的一段,以及可选的分组
@提及列表。 - 主题输入变量
--omx-*,可以在聊天外部设置品牌色。见主题。 - 短时效的地址和令牌。 适配器
uploads上的resolveDownloadUrl,Markdown 里的artifact://链接在使用时才解析,getToken可以返回{ token, expiresAt }(OpenMaxToken)。见接入 OpenMax。 - 新的入站信号
connected和catchUp,按成员 id 给会话起名的resolveMembers,以及适配器上的agentGroupPolicy。 - 无障碍:
@提及面板是标准的 listbox,读屏会跟随高亮;输入框会提示输入时可能弹出建议。
变更
- 行为变更: 身份标识移到头像上。用
createChatHost创建的宿主上,列表行、成员行、@提及候选和会话头不再画「Agent」文字标签;宿主的角标嵌在头像的缺口里。 - 行为变更:
<CwsConversationList>不再列出已在浮窗或停靠栏里打开的会话;停靠栏也有了浮窗的最小化和关闭按钮。 - 在私聊里引用消息不再自动
@原作者。 - 按服务端 id 打开的深链接一次请求就能落位,也不会再把用户已经滚走的视图拉回去。
- 把
resolveDownloadUrl放在createChatHost顶层现在会报 TypeScript 错误;请放到适配器的uploads上。
修复
@openmaxai/chat-openmax:getToken一直不返回,或实时连接的票据交换、握手一直没有应答时,请求和实时连接不再永久卡住;只有真正重连后才发reconnected。- 纯文本里的链接保留成对的括号和结尾的
!、?,也不再把紧跟在主机名后面的文字吞进链接。 - 标签看起来像 CSS 函数的 Mermaid 图重新能画出来。
- 名字为空的成员显示「未知成员」;系统成员不显示状态点,并按界面语言显示。
- 深色模式下的小号品牌色文字清晰可读,中文界面不再出现英文角色名。
- 第一页加载失败时
<CwsConversationList>显示「加载失败 · 重试」;从搜索结果发起私聊会直接打开它。
3.0.0-beta.4 (2026-11-02)
新增
- Agent 运行进度(只读,过渡方案)。
@openmaxai/chat-openmax把 Agent 活动解码成消息区里的运行块和会话头里的一行摘要。暂时没有停止按钮;之后会被规划中的 Agent 运行能力取代。 useChatSdkConversationList()新增isFetching。- 新的实时信号
memberAdded,适配器可以借它告知有人加入了会话。
变更
- 行为变更: 在
<ChatShadowRoot>里,只要有浮出面,聊天自己的对话框也是非模态的。 - 行为变更: 在浮窗里打开的对话框只锁住这个浮窗,不再锁主区域。
- 行为变更: 一次触发只发一次会话列表请求(一个事件不会再把列表拉两次)。
useListRowDragOut可以拖动本身就是<button>的行。
修复
<ChatShadowRoot>里的键盘焦点:对话框、面板和抽屉会把焦点锁在里面并在关闭后归还;把拖动的行或窗口放到主区域或停靠栏上也能生效了。
3.0.0-beta.3 (2026-10-31)
新增
- 界面里的群组管理。 有
groupManagement能力时,会话列表有「新建群组」按钮,信息面板可以管理成员。见群组管理。 @openmaxai/chat-openmax新增openMaxSharedRealtime,用你的应用已有的实时连接给 SDK 供数据,不再另开一条。- 实时连接关闭记录:实时接收端新增可选的
closed回调。
变更
- 行为变更: 聊天组件可以在服务端渲染:服务端渲染时不发请求,也不调用
getToken。见接入 OpenMax。 @openmaxai/chat-openmax的baseUrl和wsUrl可以填以/开头的路径,创建宿主时也不再访问window。- 行为变更: 有浮出面时,聊天自己的对话框是非模态的。
- 行为变更: 浮窗的高度现在包含标题栏。
- 传给
createChatHost的无法识别的顶层键会被报告出来。
修复
- 在紧凑抽屉里打开群信息面板时,按 Esc 只关闭面板。
- 系统通知保留文字里的换行;系统成员的名片只显示名字。
安全
- Mermaid 图的 SVG 插入前先经过 DOMPurify 清理。
3.0.0-beta.2 (2026-10-30)
变更
- 破坏性变更:
@openmaxai/chat和@openmaxai/chat-store现在是@openmaxai/chat-sdk(以及@openmaxai/chat-openmax)的精确版本 peer 依赖。版本不一致会在安装时暴露:npm 报ERESOLVE失败,pnpm 和 yarn 给出警告。请对齐版本,不要用--force或--legacy-peer-deps绕过。 @openmaxai/chat不再依赖vaul;Radix UI 和 vaul 已编译进包内。
新增
- 浮出面在刷新后保留状态,
<ChatFloatingSurfaces>新增挂载级开关。 openConversation新增placement("primary"或"detached"),createChatHost新增routeConversation,决定会话在哪里打开。- 同一个宿主可以并排挂在多个
<ChatProvider>里。 @openmaxai/chat-openmax实现了全部groupManagement方法;新增成员被移除和会话被删除的成员关系信号。- 只读本地数据:
createChatHost的本地数据选项里给readOnly: true,宿主的消息仓库以只读方式打开本地数据,离线时显示设备上已有的内容。
移除
@openmaxai/chat-sdk包里不再带中文 README;包内 README 只有英文。
修复
CHAT_SDK_VERSION、CHAT_OPENMAX_VERSION和CHAT_STORE_VERSION现在等于所安装包的版本号。它们的类型改为string,不再是字符串字面量类型。
3.0.0-beta.1 (2026-10-28)
第一个公开预发布版本,以 @openmaxai 作用域发布。
@openmaxai/chat:带样式的 React 组件(会话列表、消息区、输入框、卡片、群组管理、名片、图片查看器、浮出面)和ChatHost契约。@openmaxai/chat-sdk:createChatHost,用适配器构建ChatHost;另有 React 绑定、消息展示插件和输入框插件、统一的ChatSdkError,以及测试用的内存适配器。@openmaxai/chat-store:本地消息存储,可选用 IndexedDB 持久化。@openmaxai/chat-openmax:对接 OpenMax 后端的适配器,含 REST 和实时连接。- 中英文文案、深色模式,MIT 许可证。
