أعطِ الوكيل المشروع وفكرتك
أرسل لوكيلك البرمجي رابط مشروع الفيديو العربي على GitHub، مع الجمهور واللهجة والرسالة وملفات علامتك إن وجدت. يمكنك البدء بهذا الطلب:
استخدم https://github.com/SawtakArabi/arabic-video-starter لإنشاء فيديو رأسي من ثلاثة مشاهد عن [المنتج أو الفكرة]، لجمهور [الجمهور] وباللهجة [اللهجة]. اقرأ README.md وAGENTS.md ودليل اللهجة المناسب. استخدم مهارة صوتك عربي، أو أدوات MCP المتصلة بحسابي، للتعليق الصوتي. حافظ على صوت واحد، واحفظ WAV لكل مشهد، ثم صدّر الفيديو باستخدام Remotion. سلّمني MP4 والمشروع القابل للتعديل.
يتبع الوكيل تعليمات المشروع ويعدّل مشاهده لتناسب فكرتك. توفّر مهارة صوتك عربي أو اتصال MCP الموجود لديك التعليق، ويتولى Remotion تصدير الفيديو. توليد الصوت يستهلك من رصيدك. حدد ميزانية في طلبك إذا أردت سقفاً للإنفاق، أو زوّد الوكيل بتسجيلات مقبولة ليعيد استخدامها.
اطلب تعديل مشهد واحد
بعد مراجعة النسخة الأولى، اطلب تعديلاً محدداً:
عدّل المشهد الثاني فقط ليركز على [الرسالة الجديدة]. حافظ على الراوي نفسه واستخدم تسجيلي الافتتاح والختام المقبولين. حدّث توقيت المشهد وصدّر MP4 جديداً. احتفظ بالنسختين والمصدر القابل للتعديل.
تحصل على الفيديو، وتسجيلات WAV منفصلة، ومشروع Remotion يمكنك تعديل نصوصه ورسومه وتوقيته. قد يطول الفيديو إذا كان التسجيل البديل أطول.
مثال: جمهور محدد وراوٍ واحد
مثال لوما إعلان خيالي لكوب خزفي، موجه لجمهور سعودي يحب القهوة وبساطة التفاصيل. ثلاثة مشاهد: لحظة هادئة، ثم تفاصيل الكوب، ثم ختام عن روتين الصباح. الرسوم والشعار ملفات SVG أصلية قابلة للتعديل.
افتح briefs/saudi-ad.md وdialects/saudi-najdi.md وconfigs/najdi.json في المحرر. هذه مسودة التعليق، وهي منفصلة عن العناوين والنصوص الظاهرة.
الافتتاح
وسط زحمة اليوم، خذ لك لحظة هادية مع كوب لوما.
التفاصيل
لون دافي وتفاصيل بسيطة، تخلي قهوتك أحلى.
الختام
اختر لحظتك، وخل صباحك على ذوقك.
يضم المشروع أيضاً مسودة فيديو شرح مصري ومثالاً عقارياً إماراتياً خيالياً. عدّل الفكرة لتناسب جمهورك. إذا اختلفت كلمات تسجيلك، عدّل script ليطابقها.
خيار إضافي: ركّب الفيديو بنفسك من ملفات WAV
تستخدم الخطوات التالية تسجيلات موجودة لديك ومسموحاً لك باستخدامها. اتبعها إذا أردت تشغيل المشروع بنفسك، أو زوّد بها الوكيل مع التسجيلات المقبولة.
تحتاج إلى Node.js 22+ وPython 3.10+ وسطر أوامر وجهاز يشغل Remotion. يمكن لوكيل برمجي تعديل المشروع وتنفيذ الأوامر. على Linux، ثبّت متطلبات Remotion على جهاز التصدير. قد يحتاج أول تصدير إلى تنزيل متصفح. راجع ترخيص Remotion والإشعارات المرفقة قبل الاستخدام التجاري.
1. استنسخ المشروع وثبّت المتطلبات
استنسخ المستودع العام على جهاز التصدير، واقرأ README، ثم نفّذ:
git clone https://github.com/SawtakArabi/arabic-video-starter.git
cd arabic-video-starter
npm ci
npm run typecheck
npm testيتضمن README معاينة صامتة لاختبار التصدير قبل إضافة التعليق. يستخدم المشروع حزم Remotion المثبتة إصداراتها مباشرة، ويشمل رسوماً أصلية ومسودات نصوص وأدلة لكتابة اللهجات.
2. أضف التسجيلات المقبولة
ضع ثلاثة ملفات WAV كاملة، بمعدل 24 kHz وقناة واحدة وترميز PCM16، في public/audio/: opening-v1.wav وdetail-v1.wav وclosing-v1.wav. استمع للتسجيل كاملاً وراجع نصه. للصوت المولّد عبر API، تحقق أيضاً من اكتمال البث.
ينشئ الأمر التالي ملف configs/najdi-import.json ويربط كل مشهد بتسجيله، ثم يصدّر الفيديو:
python3 - <<'PY_CONFIG'
import json
from pathlib import Path
source = Path("configs/najdi.json")
target = Path("configs/najdi-import.json")
config = json.loads(source.read_text(encoding="utf-8"))
config["voice"] = "my-accepted-narrator"
for scene in config["scenes"]:
scene["audio"] = "audio/" + scene["id"] + "-v1.wav"
with target.open("x", encoding="utf-8") as output:
json.dump(config, output, ensure_ascii=False, indent=2)
PY_CONFIG
python3 scripts/prepare.py configs/najdi-import.json --helper build/no-speech-helper
npm run render -- out/najdi-v1.mp4 --props=build/najdi-import.jsonقيمة voice هنا تسمية لراويك. حقول audio تختار الملفات الموجودة، لذلك لا يوجد طلب توليد أو حاجة لمفتاح API. يُفحص كل ملف مستورد قبل المتابعة. مسار المساعد غير الموجود يجعل نقص حقل صوت يوقف الخطوة بدل توليد صوت جديد.
النتيجة: build/najdi-import.json للتوقيت، وout/najdi-v1.mp4 للفيديو. تبقى الملفات الأصلية قابلة للتعديل. التصدير لا يستبدل MP4 موجوداً؛ اختر اسماً جديداً لكل مراجعة.
3. اجعل الصوت يحدد مدة المشهد
يبدأ كل مشهد بوقفة 0.2 ثانية وينتهي بوقفة 0.4 ثانية. تُقاس مدة WAV وتُقرّب لأعلى إلى إطارات كاملة، بحد أدنى أربع ثوانٍ للمشهد. عند 30 إطاراً في الثانية، يناسب تسجيل 3.36 ثانية مشهداً من 120 إطاراً. استبداله بتسجيل 3.52 ثانية يحتاج 124 إطاراً، فيطول الفيديو أربعة إطارات إذا ثبتت بقية المشاهد.
هذه أمثلة لقاعدة التوقيت، وليست ضماناً لمدة تسجيلك. راجع audio_seconds وduration_frames في ناتج التجهيز. الصوت الطويل يمدد المشهد؛ لا يُقص أو يُسرّع. النصوص الظاهرة ليست ترجمة متزامنة كلمة بكلمة. يستخدم Remotion وصل الحروف الطبيعي في المتصفح واتجاه RTL. راجع الحروف والأسطر والأسماء والأرقام على هاتف، واجعل العناوين قصيرة.
4. عدّل المشهد الأوسط وحده
احتفظ بتسجيلي الافتتاح والختام. سجّل أو ولّد الجملة الوسطى الجديدة بالراوي نفسه، واحفظها باسم public/audio/detail-v2.wav. مثلاً، استبدل وصف الكوب العام بجملة أدق عن لونه الدافئ، وراجعها قبل التسجيل.
انسخ configs/najdi-import.json إلى configs/najdi-import-v2.json. عدّل في النسخة الجديدة script والنص الظاهر للمشهد الأوسط، واجعل audio فيه audio/detail-v2.wav. حافظ على معرّفات المشاهد. تغيير النص لا يغيّر WAV المستورد؛ اختر ملف التسجيل الجديد.
python3 scripts/prepare.py configs/najdi-import-v2.json --helper build/no-speech-helper
npm run render -- out/najdi-v2.mp4 --props=build/najdi-import-v2.jsonكل الملفات المستوردة تظهر reused: true، حتى التسجيل الجديد: المعنى أن الملف موجود مسبقاً، لا أنه لم يتغير. قارن ملفي التوقيت: يبقى مسار ومدة الافتتاح والختام، ويتغير مسار الوسط. قارن بصمات WAV إذا احتجت إثبات التطابق. قد يبدأ الختام متأخراً إذا طال الوسط، مع بقاء تسجيله نفسه.
عندما تحتاج إلى تعليق صوتي جديد
تعمل مهارة صوتك عربي المنشورة مع الوكلاء البرمجيين وتحفظ الصوت بصيغة WAV. يشرح دليلها التثبيت ومفتاح API واختيار صوت جاهز. التوليد يستهلك من رصيدك. استخدم نصاً معتمداً، واستمع للنتيجة، ثم استورد WAV المكتمل بالخطوات أعلاه.
يشرح README أيضاً توليد التعليق مباشرة باستخدام المهارة. قبل استيراد تسجيل مولّد، اتبع فحوص اكتمال البث للتأكد من اكتمال العملية وتطابق عدد بايتات PCM مع الصوت المحفوظ. احتفظ بسجلات العملية الخاصة مع مشروعك، خارج أي محتوى تنشره.
حل المشكلة مع الاحتفاظ بالتسجيلات
- ملف مفقود: ضعه داخل
public/واستخدم مساراً نسبياً مثلaudio/detail-v2.wav. - WAV ناقص أو غير مناسب: استعد مصدراً كاملاً بالصيغة المطلوبة. تغيير امتداد MP3 أو PCM إلى WAV لا يحوّله.
- خطوط مفقودة: نفّذ
npm ci؛ ينسخ التجهيز Noto Sans Arabic وترخيص OFL محلياً. - نتيجة توليد غير مؤكدة: احتفظ بالصوت الجزئي وسجل العملية وافحصها قبل طلب مدفوع جديد. غياب العملية لا يثبت فشلها.
- نص يتجاوز المساحة أو فيديو طويل: اختصر النص الظاهر أو عدّل المشهد المعني، ثم راجع كل المشاهد. تغيير الصور لا يتطلب توليد صوت جديد.
راجع النتيجة وسلّم الملفات
شغّل النسختين كاملتين، وراجع الصوت عند القطع ونهاية كل جملة. اطلب من مراجع يعرف اللهجة تقييم الصياغة والنطق والأداء. نجاح التصدير وفحص WAV لا يغنيان عن الاستماع.
سلّم MP4 والتسجيلات المقبولة وملف الإعداد والرسوم ومصدر Remotion. استبعد المفاتيح والسجلات الخاصة والروابط المؤقتة والتسجيلات غير المستخدمة من أي محتوى عام. المصدر والرسوم الأصلية بترخيص MIT، وتحتفظ الحزم المثبتة بتراخيصها.
لاختيار التعليق، ابدأ بصفحة تحويل النص إلى صوت أو الأصوات السعودية أو الأصوات الإماراتية. لتجربة صوت بسرعة دون مشروع فيديو، استخدم التجربة المجانية.