Link to this sectionتكامل Label Studio#
عمليات الاستيراد المباشرة من Label Studio قادمة إلى Ultralytics Platform، بحيث يتم رفع تصدير اكتشاف أو تجزئة الصور الخام كما هو دون الحاجة لاختيار تنسيق.
حتى ذلك الحين، يوجد مسار قصير يعمل اليوم، لأن تصدير YOLO with Images من Label Studio يمثل تخطيطاً تقرؤه المنصة، متضمناً قائمة الفئات.
Link to this sectionالاستيراد من Label Studio اليوم#
- التصدير من Label Studio. افتح مشروعك وانقر فوق Export.
- اختر تنسيقاً يتضمن الصور. اختر YOLO with Images وانقر فوق Export.
- الرفع إلى المنصة. أنشئ مجموعة بيانات جديدة من ملف ZIP.
- التدريب. عدّل التعليقات التوضيحية، ودرب النموذج، وأنشره دون مغادرة مساحة العمل.
خيارات YOLO و COCO في Label Studio تكتب ملفات التسمية بدون الصور، لأن صورك عادة ما تتقاطع خلف عناوين URL التي أشار إليها Label Studio. رفع أحد تلك الأرشيفات إلى المنصة يمنحك مجموعة بيانات بدون صور. اختر بدلاً من ذلك البديل with Images.
Link to this sectionالتصدير باستخدام API#
يعيد export API الخاص بـ Label Studio نفس الأرشيف، مع اسم التنسيق في exportType:
curl -X GET "https://<your-label-studio>/api/projects/<project-id>/export?exportType=YOLO_WITH_IMAGES&download_all_tasks=true" \
-H "Authorization: Token <your-legacy-token>" \
-o dataset.zipCOCO_WITH_IMAGES و YOLO_OBB_WITH_IMAGES تعملان بنفس الطريقة. تتم مقايضة tokens الوصول الشخصية الأحدث بـ token حامل قصير العمر قبل الاستخدام، لذا تحقق من نوع الtoken الذي تصدره مثيلك. يجب أن تستخدم المشاريع الكبيرة نقاط نهاية اللقطات (snapshot endpoints) بدلاً من ذلك، والتي تنشئ التصدير كعملية في الخلفية وتنزله بالمعرف؛ يقوم مثال export_yolo_with_images.py الخاص بـ SDK تماماً بذلك.
يحمل تصدير YOLO من Label Studio قائمة فئاته بجانب التعليقات التوضيحية، وتقرؤها المنصة:
archive.zip/
├── classes.txt # class names Platform reads first
├── notes.json # fallback, used only when classes.txt is missing or empty
├── images/
└── labels/ارفع الأرشيف تماماً كما أنتجه Label Studio. تبحث المنصة عن classes.txt و notes.json في جذر الأرشيف، لذا فإن إعادة ضغط التصدير داخل مجلد آخر يؤدي إلى فقدان أسماء التسميات الخاصة بك ويتم استيراد الفئات كـ class0 و class1 وهكذا.
Link to this sectionاختيار تنسيق التصدير#
يقدم Label Studio عدة تنسيقات تصدير. لاكتشاف وتجزئة الصور:
| تنسيق Label Studio | يعمل | ملاحظات |
|---|---|---|
| YOLO with Images | الأفضل | يرسل classes.txt والورقة أو الصور، لذا يكفي رفع واحد |
| COCO with Images | نعم | يتم قراءته أيضاً؛ مزيج من المضلعات والصناديق يتم استيراده كتجزئة، مع إسقاط الصناديق فقط |
| YOLO / COCO | لا | ملفات التسميات التوضيحية فقط - يتم استيراد مجموعة البيانات بدون صور |
| Pascal VOC XML | لا | لا يمكن قراءة ملفات التسميات XML |
لا تقرأ المنصة تسميات Pascal VOC XML، ويفشل تصدير VOC بصمت بدلاً من بضجيج: يتم استيراد الصور ولا يتم استيراد التعليقات التوضيحية. اختر YOLO with Images أو COCO with Images بدلاً من ذلك.
Link to this sectionما سيضيفه التكامل#
اختيار تنسيق التصدير الصحيح هو الخطوة التي تزيلها عملية التكامل. بمجرد إطلاقها، ستصدر أي من تنسيقات اكتشاف وتجزئة الصور في Label Studio، وترفعها، وستقوم المنصة بربط التعليقات التوضيحية بمهمة YOLO المطابقة بنفسها.
- لا توجد حاجة لاختيار تنسيق — عمليات تصدير اكتشاف وتجزئة الصور في Label Studio ترتبط بمجموعة بيانات YOLO مع الاحتفاظ بأسماء التسميات
- مساحة عمل واحدة — التسمية، والتدريب، والنشر تتوقف عن امتدادها عبر أدوات منفصلة وبرنامج نصي للتحويل
- الاستمرار في التعليق — مجموعات البيانات المستوردة تفتح في محرر التعليقات التوضيحية الخاص بالمنصة، بما في ذلك التسميات الذكية المدعومة بواسطة SAM
- التدريب الفوري — مجموعات البيانات جاهزة للتدريب السحابي بمجرد إنهاء معالجتها
تعمل عمليات التكامل لـ Labelbox و Roboflow و Ultralytics HUB اليوم، وتستورد المنصة مجموعات بيانات YOLO و COCO و Ultralytics NDJSON مباشرة.