مسار الاستيراد

يحوّل الاستيراد مجلد ملفات إلى مدخل فهرس دقيق على مستوى الإصدار من دون تعديل بايت واحد من الملفات. هذه الصفحة هي المسار خلف التدفق الموصوف في دليل الاستخدام.

المسح

تُراقب المجلدات المراقبة عبر أحداث نظام الملفات في المنصة، وتُمهل ثم يُعاد مسحها عند التغيير؛ وتصالح عمليات المسح مع قائمة المرشحات الموجودة بدل البدء من جديد. يصنّف الماسح مجلدًا كإصدار واحد (صوت مباشرة بداخله، أو مجلدات فرعية بشكل أقراص مثل CD1/CD2)، أو يدخل فيه كمجموعة. تُصنّف الملفات حسب الامتداد إلى صوت، وأعمال فنية، ومستندات، ثم يُفحص الصوت: codec المهم هو ما يجده FFmpeg في البايتات، لا امتداد الملف. تُستبعد المجلدات التي تحتوي علامات تنزيل جزئي حتى ينتهي التنزيل.

تحوّل CUE sheet صورة صوتية واحدة إلى قائمة مسارات. يتعامل المحلل مع pregaps وpostgaps، والمؤدين وISRCs لكل مسار، وتخطيطات CUE ذات الصورة أحادية الملف وذات ملف لكل مسار. تتحول حدود المسارات من CUE frames (1/75 من الثانية) إلى مواضع عينات دقيقة، تصبح لاحقًا نوافذ البايت والعينة التي يستخدمها التشغيل.

أدلة، لا وسوم

يقرأ التعرف ثلاثة أنواع من الأدلة من المجلد في مرور واحد:

• disc ID، بصمة MusicBrainz لتخطيط مسارات CD الدقيق، محسوبة من سجل نسخ أو من CUE sheet؛
• barcodes، مفكوكة من مسوح الأعمال الفنية عبر إطار الرؤية في المنصة ومقروءة من حقول CUE catalog؛
• text: أرقام الفهرس والنص الحر من OCR الأعمال الفنية، وأسماء المجلدات والملفات، والملفات النصية في النسخة الصوتية.

وسوم الصوت المضمنة ليست دليلًا عمدًا: تصف ما اعتقده واسم، لا ما هي الطبعة. (تغذي البيانات الوصفية الاحتياطية عندما يستورد المستخدم إصدارًا كمجهول.)

يُبحث Disc ID وbarcode بالتوازي، Disc ID في MusicBrainz، وbarcode في MusicBrainz وDiscogs معًا، ثم تُطابق النتائج بين الإشارات: النتائج التي تتفق على مجموعة إصدار تتلاقى، ومطابقات رقم الفهرس تضيق قائمة الطبعات، والخلاف بين الإشارات يظهر للمستخدم كتعارض صريح لا كتخمين صامت. يحمل كل ناتج أصله (وُجد عبر Disc ID، أو barcode، أو مطابقة فهرس) حتى تستطيع الواجهة قول سبب عرض الصف.

المصادر

يُستعلم MusicBrainz بلا حساب، بوتيرة صارمة قدرها طلب واحد في الثانية. يصادق Discogs برمز المستخدم الشخصي من keyring، بوتيرة وإعادة محاولة داخل حدود معدله، ويُبلّغ عن الرمز المرفوض كذلك حتى تستطيع الواجهة تعليمه بدل أن تفشل عمليات البحث بصمت. تُخبأ الردود لكل جلسة، ويُؤرشف JSON الخام للمصدر الفائز في قاعدة البيانات لإعادة تفسير لاحقة.

التثبيت

تأكيد استيراد يعمل، بالترتيب:

1. Decode verification: يُفك ترميز كل مسار من البداية إلى النهاية؛ والنسخة الصوتية التي لا يمكن فك ترميزها بالكامل تفشل الاستيراد قبل كتابة أي شيء (يمكن تعطيل ذلك براية إعداد).
2. تحليل الجهارة: يُقاس الجهارة المتكاملة وtrue peak لكل مسار ولكل ألبوم أثناء مرور فك الترميز نفسه، ويُخزنان لاستخدام replay-gain.
3. Cover selection: يُعاد رسم الفن المختار (بعيد، أو صورة مجلد، أو مضمن) إلى صورة عرض مصغرة؛ ويبقى الأصل بين ملفات الإصدار إذا جاء من المجلد.
4. كتابة ذرية: يُثبت الإصدار، والمسارات، والاعتمادات، والهويات، والصيغ، والمقاطع، والملفات، والغلاف في معاملة واحدة. لا توجد حالة نصف مستوردة.

ينتهي الإصدار وهو يشير إلى ملفات المستخدم في مكانها. إذا اختار المستخدم إدارة سحابية، يحدث الرفع بعد التثبيت كانتقال تخزين، وتبقى بايتات الملفات الأصلية مصدر الحقيقة طوال الوقت؛ لا يُحذف أو يُعدّل أي شيء أعطاه المستخدم لـ bae.

التعرف على النسخ الصوتية

يسجل كل إصدار content hash على بنية مجلده المستورد (المسارات النسبية والأحجام، مستقلًا عن الموقع). تستخدمه إعادة المسح لتعليم المجلدات الموجودة أصلًا في المكتبة، وتستخدمه إعادة استيراد النسخة نفسها لإيجاد إصدارها السابق واستبداله بدل تكراره.