بناء مجموعة مرجعية

متقدم واختياري وخاص بالتقييم وحده. المجموعة المرجعية مرجع تحريري تبنيه بيدك. ومشاريع المونتاج الأولي العادية لا تقرأه أبدا، فلا شيء هنا يغيّر سير عملك اليومي، والخيار الآمن هو ألا تكون لديك مجموعة مرجعية أصلا. والخطر الحقيقي الوحيد هو إنفاق ضائع عند المزود من تشغيل تقييمات على مجموعة خاطئة — ولهذا يجب أن يكون التشغيل الأول تشغيلا سريعا دائما.

المتطلبات المسبقة

• مقاطع حررتها يدويا بالفعل، وما زال بإمكانك قراءة المدد التي أبقيت عليها من الخط الزمني في برنامج المونتاج لديك.
• مساحة على قرص محلي. فالمجلدات المتزامنة مع السحابة قد تكون بطيئة، وقد يمنع macOS القراءة منها تماما.
• مفاهيم التقييم الواردة في قيّم RoughCut مقابل مونتاجك اليدوي.

كيف يجب أن يبدو المجلد

مجلد جذر واحد. وملف eval_manifest.json واحد في جذره. ومجلد فرعي واحد لكل مقطع، باسم معرّف ذلك المقطع.

golden_set/
├── eval_manifest.json          ← which clips are in which run
├── my_clip_01/
│   ├── raw_audio.wav           ← the clip's audio
│   └── gold_v2.json            ← your reference edit
├── my_clip_02/
│   ├── source_media.mov        ← or video, if that is what you have
│   └── gold_v2.json
└── my_clip_03/
    ├── raw_audio.wav
    └── gold_v2.json

داخل مجلد المقطع يبحث RoughCut عن الوسائط بترتيب ثابت: raw_audio.wav إن وُجد، وإلا فأول ملف source_media.* بحسب الاسم. أما المونتاج المرجعي فيجب أن يكون باسم gold_v2.json.

الخطوات

1. أنشئ مجلد الجذر على قرص محلي — قرص SSD خارجي أو مجلد داخل مجلد المستخدم لديك مناسب، أما مجلد سحابي متزامن فغير منصوح به.
2. أنشئ مجلدا فرعيا لكل مقطع، باسم معرّف قصير وثابت للمقطع: حروف صغيرة، بلا مسافات، وبلا أسماء عملاء أو زبائن خاصة. interview_2026_03 معرّف جيد، أما Jane Doe final v3 FINAL فلا.
3. ضع وسائط ذلك المقطع في مجلده باسم raw_audio.wav، أو باسم source_media.mov (أو أي ملف source_media.* آخر).
4. اكتب المونتاج المرجعي لذلك المقطع في ملف gold_v2.json داخل المجلد نفسه، مسردا فيه المدد الزمنية التي أبقيت عليها.
5. اكتب ملف eval_manifest.json في الجذر، وحدد فيه أي المقاطع تنتمي إلى تشغيل smoke وأيها تنتمي إلى تشغيل full.
6. في RoughCut، افتح Settings → Models & Data، وانتقل إلى قسم المجموعة المرجعية (بيانات التقييم)، ثم اضغط اختيار مجلد المجموعة المرجعية.... اختر المجلد الذي يحتوي مباشرة على eval_manifest.json.
7. تأكد من أن المؤشر صار يقرأ «تم منح الإذن».
8. افتح التقييم من الشريط الجانبي واضغط Run smoke eval (5).
9. اقرأ قائمة المقاطع المتخطاة وأصلح ما تسمّيه، ثم أعد التشغيل السريع.

النتيجة المتوقعة

يعرض قسم المجموعة المرجعية (بيانات التقييم) عبارة «تم منح الإذن»، وتصبح أزرار التشغيل في لوحة التقييم فعّالة، ويعالج تشغيل سريع مقاطعك ويعرض جدولا لكل مقطع إضافة إلى المتوسطات.

وللملفين اللذين تكتبهما بيدك صفحة لكل منهما: إنشاء ملف eval_manifest.json لقوائم التشغيل، وإنشاء مونتاجات مرجعية بصيغة gold_v2.json للمونتاجات المرجعية لكل مقطع.

لماذا تمنح إذن المجلد بدل كتابة مسار

RoughCut تطبيق معزول من Mac App Store. واختيار المجلد من اللوحة هو ما ينشئ الإذن الذي يتيح له قراءة مقاطعك لاحقا، ويتذكر التطبيق ذلك الإذن عبر عمليات التشغيل المتتالية. كما أن اختيار المجلد يملأ حقل Eval dataset root نيابة عنك، فلا داعي أبدا لكتابة مسار في ذلك الحقل بيدك — فالمسار بلا إذن ليس وصولا.

وإذا نُقل المجلد أو أُعيدت تسميته، لم يعد الإذن قابلا للحل ويفشل التشغيل بالرسالة «فقد التطبيق إذن الوصول إلى المجموعة المرجعية. اختر المجلد مرة أخرى من الإعدادات.» اختره مرة أخرى وتعود الأمور إلى مجراها.

ما الذي يكتبه RoughCut داخل مجلدك

عند أول تقييم لمقطع، يخزّن RoughCut النص المفرغ للمقطع وردود محرر الذكاء الاصطناعي بجوار المقطع، ويكتب هناك تقريرا خاصا بالمقطع حين يُحتسب له تقييم. أما ملخصات التشغيل فتُكتب في جذر المجموعة.

وهذا مقصود ومفيد: إعادة التشغيل تعيد تشغيل تلك الملفات، فالمقطع الذي سبق أن قيّمته لا يكلفك شيئا عند مزودك وينتهي على الفور تقريبا. وتشغيلات التفريغ النصي السحابي تحتفظ بذاكرة مؤقتة منفصلة للنصوص، فلا تعيد أي من الذراعين تشغيل كلمات الأخرى.

والنتيجة أن المجموعة المرجعية تكبر مع الوقت ولم تعد ملفاتك أنت وحدها. ضع ذلك في حسبانك حين تنسخها أو تشاركها.

اختيار المقاطع

• ما بين خمسة مقاطع وبضع عشرات نطاق عملي: كثير بما يكفي ليكون للمتوسط معنى، وقليل بما يكفي لإعادة التشغيل.
• استخدم تسجيلات تشبه عملك الحقيقي. مجموعة مرجعية من لقطات استوديو مثالية لا تخبرك بشيء عن أداء التطبيق على مقطع صوّرته على طاولة المطبخ.
• غطِّ الحالات التي تهمك: مقطع فيه بدايات متعثرة كثيرة، وآخر فيه وقفات طويلة، وثالث فيه استطراد استبعدته، ورابع كان شبه نظيف.
• افصل بين اللغات إذا كنت تعمل بأكثر من لغة. قائمة مجموعة فرعية مخصصة أفضل من الخلط — راجع إنشاء ملف eval_manifest.json وضبط لغة التفريغ النصي.

كن متسقا في التعامل مع الوقفات والمحاولات

المونتاج المرجعي ادعاء بأن هذا هو المونتاج الصحيح. فإذا قصصت وقفات التنفس في مقطع وتركتها في التالي، صارت الدرجات تقيس عدم اتساقك بقدر ما تقيس سلوك التطبيق.

قرر مرة واحدة: هل تقص الوقفات أم لا؟ وهل تبقي جملة أولى متعثرة حين تكون إعادة التسجيل أسوأ منها؟ ثم طبّق ذلك القرار على كل مقطع في المجموعة.

انسخ المجموعة احتياطيا بشكل مستقل

المجموعة المرجعية مرجع تحريري ثمين. فالمونتاجات المرجعية تمثّل ساعات من حكمك أنت، ولا يمكن إعادة إنتاجها من أي شيء آخر — لا من الوسائط المصدر، ولا بالتأكيد من مخرجات RoughCut. انسخ المجلد احتياطيا كما تنسخ أي نتاج عمل، وبشكل مستقل عن التطبيق.

وتعامل معه على أنه حسّاس أيضا. فمجلدات المقاطع قد ينتهي بها الأمر وهي تحوي نصوصا مفرغة للتسجيلات، فمجموعة مرجعية مبنية على عمل عميل تحمل كلام ذلك العميل.

أخطاء شائعة

• الاحتفاظ بالمجموعة في مجلد متزامن مع السحابة. قد يمنع macOS التطبيق من الوصول، فيفشل التشغيل بخطأ أذونات صريح بدل أن يحتسب أي شيء.
• توجيه أداة الاختيار إلى المجلد الأب للمجموعة المرجعية. اختر المجلد الذي يحتوي مباشرة على eval_manifest.json.
• تسمية مجلدات المقاطع بأسماء تخالف مدخلات ملف البيان. فالمدخل في ملف البيان هو اسم المجلد، وأي اختلاف يعني تخطيا بسبب clip_dir_missing.
• وضع الوسائط في الجذر بدلا من مجلد المقطع. فالوسائط تُحل داخل كل مجلد مقطع فقط.
• تسمية الوسائط باسم آخر. فملف audio.wav ليس raw_audio.wav وليس source_media.*، ولن يُعثر عليه.
• استخدام أسماء العملاء معرّفات للمقاطع. فالمعرّفات تظهر في ملخصات التشغيل وفي التتبعات. أبقها محايدة.

استكشاف الأخطاء

والتخطي لا يحدث في صمت أبدا — فكل حالة تُسجَّل مع سببها لتصلح المجموعة تدريجيا. أما الإخفاقات الخاصة بمقطع بعينه فتُدرج على حدة مع نص الخطأ.

وإذا تعذّرت قراءة ملف البيان نفسه، راجع إنشاء ملف eval_manifest.json. ولأي شيء آخر، راجع استكشاف الأخطاء حسب العَرَض.