# Kết quả gán nhãn nào được giữ lại khi xuất YOLO từ Label Studio?

Kiểm tra ngày 18 tháng 11 năm 2026. Khi 2 bản gán nhãn hộp đang hoạt động cho cùng một ảnh được đưa vào bộ chuyển đổi YOLO của Label Studio SDK 2.1.2, kết quả xuất mặc định giữ lại lớp của bản gán nhãn cũ hơn. Đảo thứ tự mảng gán nhãn đầu vào không làm thay đổi kết quả. Hoán đổi thời điểm tạo của 2 bản làm thay đổi lớp được giữ lại. Thí nghiệm sử dụng 1 tác vụ hư cấu, 1 đường dẫn ảnh cục bộ và 2 hình chữ nhật hợp lệ.

Bộ chuyển đổi sắp xếp các bản gán nhãn đang hoạt động theo thời điểm tạo từ mới nhất đến cũ nhất và trả về cả hai. Với cùng một ảnh, bộ ghi YOLO mặc định tạo cùng một đường dẫn tệp nhãn cho cả hai bản gán nhãn. Trong bộ dữ liệu thử nghiệm này, hình chữ nhật của kết quả gán nhãn cũ hơn được ghi sau và thay thế tệp đầu tiên. Lớp mới hơn vẫn được liệt kê trong `classes.txt` vì cả hai lớp đều được khai báo trong schema của dự án. Thẻ phát hành Label Studio 1.23.2 chỉ định SDK 2.1.2, và lệnh gọi chuyển đổi YOLO chung giữ `split_labelers` ở giá trị mặc định. [Phần phụ thuộc của ứng dụng](https://github.com/HumanSignal/label-studio/blob/df96d79183156e556d91825d15fa7721f1145e1a/pyproject.toml#L75) · [Lệnh gọi chuyển đổi của ứng dụng](https://github.com/HumanSignal/label-studio/blob/df96d79183156e556d91825d15fa7721f1145e1a/label_studio/data_export/models.py#L145-L170) · [Điều phối của SDK](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L294-L305) · [Sắp xếp theo thời điểm tạo](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L593-L626) · [Xử lý đường dẫn và kết quả trống](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L1074-L1109) · [Thay thế tệp](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/exports/yolo.py#L153-L171)

| Trường hợp | Kết quả |
| --- | --- |
| A cũ hơn B, với cả hai thứ tự mảng đầu vào | `sample.txt` chứa A |
| B cũ hơn A | `sample.txt` chứa B |
| Thư mục riêng cho từng người gán nhãn, 2 ID người thực hiện khác nhau | Tệp của người thực hiện 11 chứa A và tệp của người thực hiện 12 chứa B |
| Thư mục riêng cho từng người gán nhãn, cùng ID người thực hiện | Tệp của người thực hiện 11 chứa A |
| Kết quả cũ hơn trống và kết quả mới hơn là B | `sample.txt` chứa B |

Kết quả cũ hơn nhưng trống chỉ tạo một tệp rỗng nếu tệp đó chưa tồn tại. Nhánh xử lý này giới hạn kết luận về thứ tự thời gian ở 2 kết quả gán nhãn hợp lệ, không trống trong 3 lần chạy mặc định đầu tiên. Thư mục riêng cho từng người gán nhãn là một tùy chọn của SDK và không giữ được nhiều kết quả gán nhãn do cùng một người thực hiện ghi vào cùng một đường dẫn. Bộ dữ liệu thử nghiệm không xác lập cách dự án chọn các kết quả gán nhãn đầu vào hay hiệu năng của bất kỳ mô hình nào. [Tùy chọn và giá trị mặc định](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L966-L994)

Đối với một bộ dữ liệu bàn giao cần giữ lại lịch sử xem xét, hãy kiểm tra một mục đã biết là có bất đồng giữa bản xuất nguồn và định dạng bàn giao. Chỉ nhìn vào tệp văn bản cuối cùng thì không thể biết lý do chọn kết quả gán nhãn. Nếu một nhóm chủ ý muốn giữ 1 kết quả gán nhãn cho mỗi ảnh, hãy ghi lại quy tắc lựa chọn hoặc phân xử trước khi chuyển thành các nhãn bàn giao dạng phẳng.

Chạy `python3 check.py | cmp - observations.json` với chế độ kiểm tra lỗi của pipeline được bật. [Công cụ kiểm tra](https://sapien1.com/research/annotation-export-yolo-coco/check.py) dùng thư viện chuẩn để tính mã băm cho tổng cộng 92.423 byte trên 4 tệp SDK được ghim phiên bản. Công cụ chạy trình đọc tệp cho một tác vụ thực tế, phép chiếu dữ liệu gán nhãn, phép chuyển đổi hình chữ nhật và bộ ghi nhãn với một schema cố định và một đường dẫn cục bộ hư cấu có sẵn. Các [quan sát](https://sapien1.com/research/annotation-export-yolo-coco/observations.json) chính xác ghi lại thứ tự đầu vào và xử lý, tệp lớp cùng tất cả đường dẫn và dòng nhãn. Hai lần chạy tạo ra các bản ghi kết quả giống hệt nhau từng byte. 4 tệp nguồn cũng được đối chiếu và khớp từng byte với gói wheel PyPI 2.1.2 có dung lượng 1.066.859 byte, SHA-256 `8b95a4021f0bb4bd5a4cdce38d998cfbc0028d68681f0fd3e9907525967013c3`, được kiểm tra trong bộ nhớ mà không cài đặt. Thí nghiệm không chạy toàn bộ dịch vụ, bộ tuần tự hóa của dịch vụ hay bộ phân tích mảng tác vụ của SDK. [Gói phân phối PyPI](https://pypi.org/project/label-studio-sdk/2.1.2/#files)

Một báo cáo trước đó về Label Studio 1.11.0 mô tả kết quả gán nhãn cũ hơn được giữ lại sau khi một bản gán nhãn mới được thêm vào cùng tác vụ. Bộ dữ liệu thử nghiệm với SDK 2.1.2 này tái hiện hiện tượng giữ lại đó trên 1 đường dẫn ảnh với tập nhãn cố định. Các phép đối chứng tách biệt ảnh hưởng của thứ tự thời điểm tạo với thứ tự đầu vào, việc nhóm theo người thực hiện và kết quả trống. Các báo cáo riêng đề cập đến tên tệp cơ sở trùng nhau giữa các ảnh khác nhau và sự nhập nhằng giữa bản gán nhãn COCO trống và chưa được xem xét. Gói này chứa mã Python gốc và các quan sát được tạo ra cho thí nghiệm. Khi chạy, công cụ kiểm tra tải mã nguồn SDK công khai theo Apache-2.0 đã được ghim phiên bản. [Báo cáo YOLO trước đó](https://github.com/HumanSignal/label-studio/issues/5421) · [Báo cáo về tên tệp cơ sở trùng lặp](https://github.com/HumanSignal/label-studio/issues/7096) · [Báo cáo về COCO trống](https://github.com/HumanSignal/label-studio/issues/9774) · [Giấy phép SDK](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/LICENSE)
