首页
/ LiveBlocks v2.17.0 版本发布:WebSocket大消息处理与AI工具栏支持

LiveBlocks v2.17.0 版本发布:WebSocket大消息处理与AI工具栏支持

2025-06-14 23:23:57作者:殷蕙予

项目简介

LiveBlocks是一个为实时协作应用提供基础设施的JavaScript库集合,它使开发者能够轻松构建多人协作功能,如协同编辑、实时聊天等。该项目包含多个npm包,分别针对不同框架和场景提供支持。

核心更新内容

WebSocket大消息处理机制优化

在v2.17.0版本中,LiveBlocks对WebSocket消息处理机制进行了重要改进:

  1. 错误报告增强:当客户端尝试发送超过1MB的WebSocket消息时,现在会明确地在控制台报告错误,而不是像之前版本那样静默失败。

  2. 灵活的大消息处理策略:新增了largeMessageStrategy配置选项,开发者可以根据应用场景选择最适合的大消息处理方式:

    • default:默认策略,不发送大消息但会在控制台记录错误
    • split:将大消息分割成小块发送(牺牲原子性但保证送达)
    • experimental-fallback-to-http:实验性功能,自动改用HTTP协议发送大消息
  3. API调整:废弃了实验性的unstable_fallbackToHTTP标志,推荐使用新的largeMessageStrategy配置方式。

React集成改进

React开发者现在可以通过<LiveblocksProvider>组件直接配置大消息处理策略,保持与核心库一致的配置体验。

富文本编辑器AI工具栏(Beta)

本次更新为Tiptap富文本编辑器集成带来了AI功能支持,目前处于私有测试阶段:

  1. AI功能启用:通过useLiveblocksExtensionai选项可以配置并启用AI工具栏功能。

  2. 组件化AI工具栏:提供了<AiToolbar>系列组件,包括<AiToolbar.Suggestion><AiToolbar.SuggestionsSeparator>等,方便开发者定制AI交互界面。

  3. 默认集成:当启用AI功能后,ToolbarFloatingToolbar会自动包含AI相关按钮。

  4. 编程式调用:新增askAi编辑器命令,支持以编程方式打开AI工具栏,并可预置提示词直接发起AI请求。

其他改进

  • React-UI修复:解决了Composer组件在onComposerSubmit回调期间卸载导致的崩溃问题。
  • 图标库扩充:为<Icon.* />组件系列新增了多个常用图标。

技术实现建议

对于需要处理大消息的协作场景,建议根据业务需求选择合适的大消息策略:

  1. 实时性要求高但可接受非原子操作:选择split策略,确保消息及时送达。

  2. 数据完整性优先:使用experimental-fallback-to-http策略,虽然延迟稍高但保证消息完整。

  3. 简单调试场景:保留default策略,通过控制台错误快速发现大消息问题。

对于AI工具栏的使用,建议先在小范围测试其效果,特别是注意处理AI生成内容的准确性和适用性。

升级注意事项

  1. 使用过unstable_fallbackToHTTP的代码需要迁移到新的largeMessageStrategy配置方式。

  2. AI工具栏功能目前仍处于Beta阶段,API可能发生变化,不建议在生产环境大规模使用。

  3. 大消息分割策略(split)会牺牲消息的原子性,需要确保应用逻辑能够处理可能的消息分片情况。

LiveBlocks v2.17.0通过改进大消息处理和引入AI能力,进一步丰富了实时协作应用的开发体验,为构建更智能、更可靠的协作功能提供了更多可能性。

登录后查看全文
热门项目推荐
相关项目推荐