Label Studio未展示标签与OCR文本问题求助

1. 验证标注配置与预测输出的字段匹配 #

标注配置中的组件名称（name属性）必须和后端预测结果里的from_name/to_name完全一致，否则前端无法映射。

示例正确标注配置（适配发票Layout+BIO标注） #

<View>
  <!-- 图片组件，name为"image"，对应任务数据中的$image字段 -->
  <Image name="image" value="$image"/>
  <!-- OCR文本展示组件，name为"ocr_text"，用于关联BIO标注 -->
  <Text name="ocr_text" value="$text" granularity="word"/>
  <!-- NER标签组件，name为"ner_labels"，对应BIO实体 -->
  <Labels name="ner_labels" toName="ocr_text">
    <Label value="InvoiceNumber" background="#FF5733"/>
    <Label value="TotalAmount" background="#33FF57"/>
    <!-- 其他业务实体标签 -->
    <Label value="O" background="#CCCCCC"/> <!-- 显式添加O标签，确保能识别 -->
  </Labels>
</View>

后端必须返回对应格式的预测结果 #

确保result数组中包含两类条目：

• OCR文本块：关联image和ocr_text组件，包含文本内容与坐标
• BIO标注：关联ner_labels和ocr_text组件，为每个文本片段标注O

示例正确返回格式：

{
  "result": [
    // OCR文本块示例
    {
      "id": "word_1",
      "from_name": "ocr_text",
      "to_name": "image",
      "type": "text",
      "value": {
        "bbox": [50, 100, 200, 130],
        "text": "发票号码",
        "page": 0
      }
    },
    {
      "id": "word_2",
      "from_name": "ocr_text",
      "to_name": "image",
      "type": "text",
      "value": {
        "bbox": [220, 100, 300, 130],
        "text": "NO.123456",
        "page": 0
      }
    },
    // BIO标注示例（每个文本块对应O标签）
    {
      "id": "tag_1",
      "from_name": "ner_labels",
      "to_name": "ocr_text",
      "type": "labels",
      "value": {
        "start": 0,
        "end": 4,
        "text": "发票号码",
        "labels": ["O"]
      }
    },
    {
      "id": "tag_2",
      "from_name": "ner_labels",
      "to_name": "ocr_text",
      "type": "labels",
      "value": {
        "start": 0,
        "end": 8,
        "text": "NO.123456",
        "labels": ["O"]
      }
    }
  ],
  "score": 0.95 // 可选，预测置信度
}

2. 检查任务数据的正确性 #

• 确认项目关联的存储中，图片文件路径正确，且Label Studio有权限访问（本地存储需路径可读写，云存储需密钥配置正确）
• 查看任务的Data字段，确保存在image（对应标注配置中的$image）和text（如果用$text变量）字段，且值为有效路径或内容

3. 查看Label Studio与ML后端日志 #

• Label Studio日志：在社区版界面进入「Settings」→「Logs」，搜索是否有预测结果解析错误、图片加载失败等报错
• ML后端日志：检查后端是否正确完成OCR，是否生成了符合格式的预测结果，有没有抛出未捕获的异常

4. 验证BIO标注的O标签配置 #

• 如果标注配置中未显式添加O标签，前端可能无法识别该类标注，需在<Labels>组件中添加<Label value="O" .../>
• 确保预测结果中的labels字段值为["O"]，而非字符串"O"或其他格式

内容的提问来源于stack exchange，提问作者Antônio Sousa