# 哪条标注结果会在 Label Studio YOLO 导出后保留？

核查于 2026 年 11 月 18 日。当同一张图片的 2 条有效框标注进入 Label Studio SDK 2.1.2 YOLO 转换器时，默认导出保留了较早标注的类别。反转输入标注数组的顺序，结果保持不变。交换两条标注的创建时间后，保留的类别发生变化。实验使用了 1 个虚构任务、1 个本地图像路径和 2 个有效矩形框。

转换器按创建时间从新到旧排序有效标注，并依次输出两条标注。对于同一张图片，默认 YOLO 写入器为两条标注生成相同的标签路径。在此测试样例中，较早标注结果的矩形框第二个写入，并替换了第一个文件。由于项目模式声明了两个类别，较新的类别仍列在 `classes.txt` 中。Label Studio 1.23.2 发布标签指定使用 SDK 2.1.2，通用 YOLO 转换调用让 `split_labelers` 保持默认值。[应用依赖](https://github.com/HumanSignal/label-studio/blob/df96d79183156e556d91825d15fa7721f1145e1a/pyproject.toml#L75) · [应用转换调用](https://github.com/HumanSignal/label-studio/blob/df96d79183156e556d91825d15fa7721f1145e1a/label_studio/data_export/models.py#L145-L170) · [SDK 分派](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L294-L305) · [按创建时间排序](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L593-L626) · [路径和空结果处理](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L1074-L1109) · [文件替换](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/exports/yolo.py#L153-L171)

| 情况 | 结果 |
| --- | --- |
| A 比 B 早，输入数组为任一顺序 | `sample.txt` 包含 A |
| B 比 A 早 | `sample.txt` 包含 B |
| 使用独立标注者文件夹，2 个不同的操作者 ID | 操作者 11 的文件包含 A，操作者 12 的文件包含 B |
| 使用独立标注者文件夹，相同的操作者 ID | 操作者 11 的文件包含 A |
| 较早结果为空，较新结果为 B | `sample.txt` 包含 B |

较早的空结果仅在文件不存在时才创建空文件。因此，关于创建时间先后的结论仅适用于前 3 次默认运行中的 2 条有效、非空标注结果。独立标注者文件夹是 SDK 的一个选项，不能保留同一操作者写入同一路径的多条标注结果。此测试样例不能说明项目如何选择输入标注结果，也不能说明任何模型的表现。[选项和默认值](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L966-L994)

如果交付物应保留审核历史，请在源导出和交付格式中检查一个已知存在争议的项目。最终文本文件本身无法说明选择该标注结果的原因。如果团队有意为每张图片只保留一条标注结果，应在将结果合并为交付标签前记录选择或裁决规则。

启用流水线失败检查后运行 `python3 check.py | cmp - observations.json`。基于标准库的[检查程序](https://sapien1.com/research/annotation-export-yolo-coco/check.py)对 4 个固定版本的 SDK 文件共 92,423 字节计算哈希。程序使用固定模式和一个已存在的虚构本地路径，执行实际的单任务文件读取器、标注投影、矩形框转换和标签写入器。精确的[观察记录](https://sapien1.com/research/annotation-export-yolo-coco/observations.json)记录了输入和处理顺序、类别文件以及所有标签路径和内容行。两次运行生成的结果记录逐字节一致。这 4 个源文件还与 PyPI 2.1.2 wheel 逐字节比对一致；该 wheel 为 1,066,859 字节，SHA-256 为 `8b95a4021f0bb4bd5a4cdce38d998cfbc0028d68681f0fd3e9907525967013c3`，在内存中检查，未安装。实验未运行完整服务、其序列化器或 SDK 的任务数组解析器。[PyPI 发行包](https://pypi.org/project/label-studio-sdk/2.1.2/#files)

一份关于 Label Studio 1.11.0 的早期报告描述了向同一任务添加新标注后，较早标注结果仍被保留的情况。这个 SDK 2.1.2 测试样例在一个图像路径和固定标签词汇表上复现了这种保留现象。对照测试区分了创建时间顺序、输入顺序、操作者分组和空结果的影响。另有报告分别讨论不同图片的重复基本文件名，以及空 COCO 标注与未审核 COCO 标注之间的歧义。此包包含原创 Python 代码和虚构的观察记录。检查程序在运行时获取固定版本的公开 Apache-2.0 SDK 源代码。[早期 YOLO 报告](https://github.com/HumanSignal/label-studio/issues/5421) · [重复基本文件名报告](https://github.com/HumanSignal/label-studio/issues/7096) · [空 COCO 报告](https://github.com/HumanSignal/label-studio/issues/9774) · [SDK 许可证](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/LICENSE)
