# Какая разметка сохраняется при экспорте Label Studio в YOLO?

Проверено 18 ноября 2026 года. Когда 2 активные аннотации с ограничивающими рамками для одного изображения поступили в конвертер YOLO из Label Studio SDK 2.1.2, экспорт с настройками по умолчанию сохранил класс более старой аннотации. Изменение порядка аннотаций во входном массиве на обратный не изменило результат. Когда время создания двух аннотаций поменяли местами, сохранился другой класс. В эксперименте использовались 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 запусках с настройками по умолчанию. Отдельные папки разметчиков — это настройка 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 wheel версии 2.1.2 размером 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. Пакет содержит оригинальный код Python и вымышленные наблюдения. Во время выполнения проверяющий скрипт получает закреплённый за версией общедоступный исходный код SDK по лицензии Apache-2.0. [Более ранний отчёт о 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)
