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

> كيف ترتّب مجلد المقاطع والمونتاجات المرجعية الذي يقارن نظام التقييم في RoughCut قراراته به.
>
> جرى التحقق من المحتوى مقابل تطبيق RoughCut الحالي بتاريخ 28 أغسطس 2026
> https://www.roughcuteditor.com/ar/docs/golden-set

المجموعة المرجعية مجلد جذر واحد يضم ملف eval_manifest.json ومجلدا فرعيا لكل مقطع. ويحتاج كل مجلد مقطع إلى وسائط مصدر — ملف raw_audio.wav، أو أول ملف source_media — إضافة إلى مونتاج مرجعي باسم gold_v2.json. احتفظ بالمجموعة على قرص محلي، لأن المجلدات المتزامنة مع السحابة قد تكون بطيئة أو يمنعها macOS بأذوناته، واربطها من قسم Models & Data في الإعدادات عبر اختيار مجلد المجموعة المرجعية بدلا من كتابة مسار، لأن ذلك الإذن هو ما يتيح للتطبيق المعزول قراءة المجلد أصلا. استخدم معرّفات مقاطع قصيرة وثابتة بلا أسماء عملاء خاصة، واجعل مونتاجاتك المرجعية متسقة في التعامل مع الوقفات والمحاولات. وعند أول تقييم يكتب RoughCut ملفات النص المفرغ والذاكرة المؤقتة للذكاء الاصطناعي بجوار كل مقطع، فتصبح إعادة التشغيل مجانية وفورية. وأي شيء ناقص يُتخطى بسبب مذكور، لا في صمت.

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

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

- مقاطع حررتها يدويا بالفعل، وما زال بإمكانك قراءة المدد التي أبقيت عليها من الخط الزمني في برنامج المونتاج لديك.
- مساحة على **قرص محلي**. فالمجلدات المتزامنة مع السحابة قد تكون بطيئة، وقد يمنع macOS القراءة منها تماما.
- مفاهيم التقييم الواردة في [قيّم RoughCut مقابل مونتاجك اليدوي](/ar/docs/evaluation-overview).

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

مجلد جذر واحد. وملف `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](/ar/docs/eval-manifest) لقوائم التشغيل، و[إنشاء مونتاجات مرجعية بصيغة gold_v2.json](/ar/docs/gold-reference-edit) للمونتاجات المرجعية لكل مقطع.

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

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

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

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

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

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

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

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

- **ما بين خمسة مقاطع وبضع عشرات** نطاق عملي: كثير بما يكفي ليكون للمتوسط معنى، وقليل بما يكفي لإعادة التشغيل.
- **استخدم تسجيلات تشبه عملك الحقيقي.** مجموعة مرجعية من لقطات استوديو مثالية لا تخبرك بشيء عن أداء التطبيق على مقطع صوّرته على طاولة المطبخ.
- **غطِّ الحالات التي تهمك**: مقطع فيه بدايات متعثرة كثيرة، وآخر فيه وقفات طويلة، وثالث فيه استطراد استبعدته، ورابع كان شبه نظيف.
- **افصل بين اللغات** إذا كنت تعمل بأكثر من لغة. قائمة مجموعة فرعية مخصصة أفضل من الخلط — راجع [إنشاء ملف eval_manifest.json](/ar/docs/eval-manifest) و[ضبط لغة التفريغ النصي](/ar/docs/language).

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

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

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

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

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

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

## أخطاء شائعة

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

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

| سبب التخطي | المعنى | الحل |
|---|---|---|
| `clip_dir_missing` | ملف البيان يسمّي مجلدا ليس في المجموعة، أو المدخل بلا معرّف صالح | صحّح المدخل، أو أنشئ المجلد |
| `missing_media` | لا يوجد `raw_audio.wav` ولا `source_media.*` في مجلد المقطع | أضف الوسائط بأحد هذين الاسمين |
| `missing_gold` | لا يوجد `gold_v2.json` في مجلد المقطع | اكتب المونتاج المرجعي |

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

وإذا تعذّرت قراءة ملف البيان نفسه، راجع [إنشاء ملف eval_manifest.json](/ar/docs/eval-manifest). ولأي شيء آخر، راجع [استكشاف الأخطاء حسب العَرَض](/ar/docs/troubleshooting).