OpenMax
免费试用

更新日志

@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 许可证。