# איזו קביעה נשמרת בייצוא YOLO של Label Studio?

נבדק ב־18 בנובמבר 2026. כאשר שתי אנוטציות פעילות של תיבות לאותה תמונה הגיעו לממיר YOLO של Label Studio SDK 2.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 |
| תיקיות מתייגים נפרדות, שני מזהי מבצעים שונים | הקובץ של מבצע 11 מכיל את A והקובץ של מבצע 12 מכיל את B |
| תיקיות מתייגים נפרדות, אותו מזהה מבצע | הקובץ של מבצע 11 מכיל את A |
| התוצאה הישנה יותר ריקה והחדשה יותר היא B | `sample.txt` מכיל את B |

התוצאה הישנה והריקה יוצרת קובץ ריק רק אם עדיין לא קיים קובץ. ענף זה מגביל את הטענה לגבי גיל הקביעה לשתי הקביעות התקינות והלא ריקות בשלוש ההרצות הראשונות עם הגדרות ברירת המחדל. תיקיות מתייגים נפרדות הן אפשרות ב־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), המשתמש בספרייה הסטנדרטית, מחשב ערכי גיבוב ל־92,423 בתים על פני 4 קובצי SDK מוצמדים. הוא מפעיל את קורא הקבצים בפועל למשימה יחידה, את השלכת האנוטציות, את המרת המלבנים ואת רכיב כתיבת התוויות, עם סכמה קבועה ונתיב מקומי בדיוני קיים. [התצפיות](https://sapien1.com/research/annotation-export-yolo-coco/observations.json) המדויקות מתעדות את סדר הקלט והעיבוד, את קובץ המחלקות ואת כל נתיבי ושורות התוויות. שתי ההרצות הפיקו רשומות תוצאה זהות ברמת הבתים. כמו כן, 4 קובצי המקור הושוו ברמת הבתים ונמצאו זהים לאלה שבחבילת ה־wheel של PyPI 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)
