BlockNote协作编辑中光标标签显示配置解析

在BlockNote编辑器的协作功能使用过程中，开发者可能会遇到一个关于showCursorLabels配置项的类型定义问题。这个参数用于控制在多人协作编辑时，是否始终显示其他协作者的光标位置标签。

问题本质

在最新版本的BlockNote中，showCursorLabels配置项的正确位置应该位于collaboration配置对象内部，而不是作为根级配置参数。这是一个常见的配置项位置误解问题，主要由于API设计变更导致。

正确配置方式

以下是正确的配置示例：

const editor = useCreateBlockNote({
  collaboration: {
    provider,       // 协作服务提供者
    fragment,       // Yjs文档片段
    user: {         // 当前用户信息
      name: "user",
      color: "#FF0000"
    },
    showCursorLabels: "always"  // 正确的参数位置
  }
});

技术背景

BlockNote基于ProseMirror和Yjs构建协作编辑功能。光标标签显示属于协作功能的视觉反馈部分，因此逻辑上应该归属于协作配置对象。这种设计保持了配置项的逻辑分组清晰性：

1. 基础编辑器配置 - 根级别
2. 协作相关配置 - collaboration对象内
3. 主题/样式配置 - 其他专门对象

版本兼容性说明

该配置方式从BlockNote 0.23.0版本开始引入。开发者需要注意：

1. 老版本可能不支持此功能
2. TypeScript类型定义会严格校验参数位置
3. 错误的参数位置会导致类型错误而非运行时错误

最佳实践建议

1. 始终查阅对应版本的API文档
2. 使用TypeScript获取实时类型提示
3. 对于协作功能，所有相关配置应集中放置
4. 遇到类型错误时，首先检查配置项层级

通过正确配置，开发者可以充分利用BlockNote的协作功能，为用户提供清晰的多人编辑视觉反馈，提升协作体验。