首页
/ Hocuspocus v2.15.1-rc.0版本发布:协同编辑引擎的重要更新

Hocuspocus v2.15.1-rc.0版本发布:协同编辑引擎的重要更新

2025-06-28 13:13:40作者:卓炯娓

Hocuspocus是一个基于Y.js协议的实时协同编辑引擎,它为构建多人协作的富文本编辑器提供了强大的后端支持。该项目通过WebSocket协议实现文档的实时同步,并提供了丰富的扩展功能,如权限控制、历史记录和评论系统等。

核心功能改进

本次发布的v2.15.1-rc.0版本包含了多项重要改进和错误修复,主要涉及以下几个方面:

  1. WebSocket连接处理优化:修复了在应用意识更新(awareness update)时传递错误参数的问题,现在正确处理WebSocket连接对象而非Connection对象,这有助于提高多人协作时的状态同步准确性。

  2. 文档生命周期管理:解决了文档卸载后立即触发afterUnloadDocument钩子的问题,现在能够正确等待onLoadDocument完成后再触发卸载事件,使文档状态管理更加可靠。

  3. 评论系统修复:修正了删除评论时可能遇到的yArray不存在错误,增强了评论功能的稳定性。

  4. 连接计数优化:改进了服务器全局活跃连接计数器,现在能够正确考虑多路复用情况,提供更准确的连接统计。

依赖管理调整

  1. Transformer模块调整:将@tiptap/core从直接依赖改为peerDependencies,这为使用者提供了更大的灵活性,可以根据项目需求选择特定版本的Tiptap核心库。

  2. 构建工具更新

    • Rollup构建工具从2.79.0升级到2.79.2
    • GitHub Actions缓存工具从4.1.2升级到4.2.0

文档改进

  1. 修复了本地编辑文档示例中缺失的await关键字,确保异步操作的正确性。
  2. 修正了扩展列表中的链接错误,提高了文档的可用性。

技术细节解析

对于协同编辑系统而言,连接管理和状态同步是最核心的部分。本次更新中针对WebSocket连接处理的改进尤为重要:

  • 意识更新机制:Y.js协议中的意识(awareness)系统用于跟踪所有协作者的在线状态和选择范围。正确的连接对象传递确保了状态更新的可靠性。

  • 文档生命周期:通过修复文档加载和卸载的时序问题,避免了潜在的状态不一致风险,这对长时间运行的协作会话尤为重要。

  • 连接计数优化:在多路复用场景下准确统计连接数,为系统监控和资源分配提供了更准确的数据基础。

升级建议

对于正在使用Hocuspocus的开发团队,建议在测试环境中验证此候选版本,重点关注:

  1. 多人协作时的状态同步准确性
  2. 文档加载和卸载的生命周期事件触发顺序
  3. 评论系统的稳定性

这些改进将显著提升协作编辑体验的可靠性和稳定性,特别是在高并发或长时间运行的编辑会话中。

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

项目优选

收起
openHiTLS-examplesopenHiTLS-examples
本仓将为广大高校开发者提供开源实践和创新开发平台,收集和展示openHiTLS示例代码及创新应用,欢迎大家投稿,让全世界看到您的精巧密码实现设计,也让更多人通过您的优秀成果,理解、喜爱上密码技术。
C
54
468
kernelkernel
deepin linux kernel
C
22
5
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
7
0
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
879
517
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
336
1.1 K
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
180
264
cjoycjoy
一个高性能、可扩展、轻量、省心的仓颉Web框架。Rest, 宏路由,Json, 中间件,参数绑定与校验,文件上传下载,MCP......
Cangjie
87
14
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.08 K
0
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
359
381
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
612
60