# Label Studio YOLO 匯出會保留哪個標註結果？

查核日期：2026 年 11 月 18 日。當同一張影像的 2 筆有效方框標註進入 Label Studio SDK 2.1.2 YOLO 轉換器時，預設匯出保留了較舊標註的類別。反轉輸入標註陣列的順序，結果維持不變；交換 2 筆標註的建立時間，保留的類別則隨之改變。實驗使用 1 個虛構任務、1 個本機影像路徑及 2 個有效矩形。

轉換器依建立時間將有效標註由新到舊排序，並輸出兩筆標註。對同一張影像，預設 YOLO 寫入程式會為兩筆標註建立相同的標籤路徑。在此測試案例中，較舊標註結果的矩形第 2 個寫入，取代了第一個檔案。較新標註的類別仍列於 `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)

若交付內容應保留審核歷程，請在來源匯出資料與交付格式中比對一個已知有爭議的項目。單憑最終文字檔無法得知選用該標註結果的原因。如果團隊刻意選擇每張影像只保留 1 筆標註結果，應在扁平化為交付標籤之前記錄選擇或裁定規則。

啟用管線失敗檢查後執行 `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)記錄了輸入與處理順序、類別檔案，以及所有標籤路徑與內容行。2 次執行產生的結果紀錄逐位元組完全相同。這 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 測試案例使用 1 個影像路徑與固定的標籤詞彙，重現了該保留現象。控制條件將建立時間順序與輸入順序、執行者分組及空結果分開檢驗。另有報告討論不同影像的重複基本檔名，以及空白與未審核 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)
