فيديو حوّل تسجيلاتك الخام إلى فيديو مرتب مع video-use

شاهد الفيديو على YouTube

سجّلت عدة محاولات لشرح فكرة، وبقي أمامك اختيار اللقطات وحذف الترددات وضبط الترجمة؟ video-use يجمع مهارة لوكيل برمجي مع أدوات مونتاج، لتصف ما تريد وتراجع خطة التحرير قبل تنفيذها. يستهدف العمل مع Claude Code، ويشرح المستودع ربط المهارة بوكلاء آخرين يملكون وصولًا إلى الطرفية. [1]

الفيديو أعلاه يقدم الفكرة باختصار. هذه مراجعة للوثائق والسكربتات الرسمية؛ لم ننفّذ مونتاجًا بهذا المشروع، ولم نرسل تسجيلات إلى خدمة تفريغ مدفوعة.

لمن هذا؟

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

يفيدك إذا كنت مرتاحًا مع الطرفية ومراجعة أوامر المساعد. المشروع أداة مفتوحة المصدر تتطلب إعدادًا، وليس واجهة جاهزة تتجاوز كل قرارات المونتاج. وفي النسخة المراجعة، يشير README إلى قائمة انتظار للنسخة السحابية، فلا نفترض أنها خدمة متاحة بالفعل. [1]

ماذا ستحتاج؟

وكيلًا برمجيًا يمكنه قراءة المهارة وتشغيل أدوات النظام. سنستخدم Claude Code في مثال الإعداد.
Python بإصدار 3.10 أو أحدث، مع تبعيات المشروع الموجودة في pyproject.toml.
ffmpeg لمعالجة الصوت والصورة، وffprobe لفحص الملفات.
مفتاح ElevenLabs لاستخدام Scribe، خدمة تحويل الصوت إلى نص مع توقيت لكل كلمة وتمييز المتحدثين.
مقاطع تملك حق استخدامها، ومساحة لملفات التفريغ والمعاينات والإخراج.

yt-dlp اختياري لتنزيل مصادر عبر الروابط. أما HyperFrames وRemotion وManim فهي خيارات للرسوم المتحركة، وليست شروطًا لأول تجربة قص وترجمة. لا تثبتها جميعًا قبل معرفة حاجتك. [2][3]

التكلفة والخصوصية: ترخيص المشروع MIT، لكن تفريغ ElevenLabs واستخدام نموذج الوكيل قد تكون لهما تكلفة. السكربت يستخرج الصوت من الفيديو ويرفع ملف WAV إلى ElevenLabs؛ هذا المسار ليس معالجة محلية بالكامل. اختر تسجيلًا غير حساس للتجربة، وراجع صلاحياتك وسياسة الخدمة قبل رفع محادثات عمل أو بيانات أشخاص. احفظ المفتاح محليًا، ولا ترسله في المحادثة أو تضعه في Git. [4]

النتيجة النهائية (صورة)

المخرج المستهدف هو ملف edit/final.mp4 بجانب مصادر الفيديو، مع ملفات التحرير داخل edit/. لكن لفهم كيف يختار الوكيل مواضع القص، انظر إلى الرسم الرسمي التالي:

رسم video-use الرسمي لعرض timeline_view: لقطات متتابعة وموجة صوتية وكلمات بتوقيتاتها ومناطق صمت مرشحة للقص؛ مثال توضيحي من المشروع، وليس نتيجة مونتاج نفّذناها.

مصدر الصورة: static/timeline-view.svg من المستودع، حُوّل إلى PNG مع الحفاظ على محتواه. هو رسم توضيحي لطريقة العرض، وليس لقطة لفيديو أنتجناه. [5]

يعتمد الوكيل أولًا على نص الكلام وتوقيتاته، ثم يطلب صورًا مركبة عند الحاجة لمراجعة وقفة أو مقارنة محاولتين أو التحقق من حدود القص. لذلك عبارة «يقرأ الفيديو» لا تعني أنه يستغني عن الصورة تمامًا؛ هو يجمع النص مع معاينات بصرية انتقائية. [1][6]

حجم 12KB للنص المضغوط المذكور في README يصف مثالًا، وليس حجمًا ثابتًا لكل مشروع ولا ضمانًا لاستهلاك النموذج. تتغير البيانات مع عدد المقاطع وطول الكلام.

خطوات 1-2-3

1. جهّز الأدوات واربط مجلد المهارة

الأوامر التالية مسار مقترح على macOS مع Homebrew وuv مثبتين مسبقًا، ومقتبسة من الإعداد الرسمي:

git clone https://github.com/browser-use/video-use ~/Developer/video-use
cd ~/Developer/video-use
uv sync
brew install ffmpeg
mkdir -p ~/.claude/skills
ln -s ~/Developer/video-use ~/.claude/skills/video-use

اربط مجلد المستودع كاملًا؛ SKILL.md يحتاج سكربتات helpers/ الموجودة بجانبه. الأمر ln -s هنا لا يفرض استبدال رابط موجود: إذا وجدت تثبيتًا سابقًا، راجعه أولًا بدل الكتابة فوقه. على Linux، استخدم مسار تثبيت FFmpeg الموافق لتوزيعتك في install.md، ولا تنسخ أمر Homebrew كما هو. [2]

في التثبيت الأول فقط، إذا لم يوجد ملف .env، جهّز نسخة القالب:

cp .env.example .env
chmod 600 .env

افتح الملف في محرر محلي وأدخل قيمة ELEVENLABS_API_KEY الخاصة بك. لا تكتبها داخل طلب للوكيل، ولا تضمّن .env في حزمة ترسلها للآخرين. وجود الملف وحده لا يثبت أن القيمة صحيحة.

قبل رفع صوت للتفريغ، افحص وجود الأدوات ومساعدة السكربت:

ffmpeg -version
ffprobe -version
uv run python helpers/timeline_view.py --help

هذه الفحوص تؤكد جوانب الإعداد فقط؛ لا تثبت نجاح تفريغ أو مونتاج كامل، ولا تحتاج تشغيل طلب Scribe مدفوع لمجرد تجربة الإعداد.

2. اطلب خطة قبل القص

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

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

المهارة توجّه إلى جرد المقاطع، وتفريغ الكلام، وتجميعه في takes_packed.md، ثم اقتراح استراتيجية وانتظار تأكيدها. طلب الموافقة على رفع الصوت حد إضافي مهم لأن الجرد والتفريغ قد يسبقان موافقة القص. [3][4]

بعد اعتماد الخطة، ينشئ الوكيل EDL، قائمة قرارات المونتاج: أي جزء من أي مصدر سيبقى، وبأي ترتيب، وما الإضافات المرتبطة به. تبقى ملفات العمل في <videos_dir>/edit/، لا داخل مجلد المهارة. [3]

3. راجع المعاينة قبل اعتماد الملف النهائي

يمكن لأداة الإخراج إنتاج معاينة من EDL. المثال التالي يفترض أنك داخل مجلد المقاطع، وأن الوكيل أنشأ edit/edl.json صالحًا:

~/Developer/video-use/.venv/bin/python \
  ~/Developer/video-use/helpers/render.py \
  edit/edl.json -o edit/preview.mp4 --preview

هذا أمر موثّق للمعاينة، وليس ملف مونتاج مكتملًا بحد ذاته. راجع النص والتوقيت ومصادر EDL قبل تنفيذه. [7]

شاهد بداية الفيديو ونهايته وحدود القص، واستمع للصوت. تأكد من اكتمال الكلمات، وتزامن الترجمة ووضوحها، وظهور الرسوم في الوقت الصحيح. اطلب تصحيح المشكلات قبل اعتماد final.mp4.

المهارة تطلب تقييمًا للناتج بعد الإخراج، لا للمصادر فقط، وتشمل قياس الصوت ومراجعة صور عند حدود القص. لكنها توجّه الوكيل إلى الإفصاح عندما لا يستطيع الاستماع؛ قياسات الصوت وصورة الموجة لا تعادل مراجعة بشرية سمعية كاملة. وإذا بقيت مشكلات بعد ثلاث جولات، فالتوجيه هو عرضها بدل الاستمرار بلا نهاية. [3]

مشاكل شائعة

الوكيل لا يجد الأدوات: تحقق من ربط المجلد كاملًا ومن وجود بيئة Python والتبعيات. نسخ SKILL.md وحده لا ينقل سكربتات المونتاج. [2]

التفريغ لا يبدأ رغم ضبط متغير البيئة: في السكربت المراجع، تُقرأ ملفات .env قبل متغير البيئة، وقد تُعاد قيمة فارغة من الملف إذا كان المفتاح موجودًا فيه بلا قيمة. تحقق محليًا من مصدر المفتاح والقيمة دون طباعتها أو مشاركتها. [4]

الفيديو له صوت، لكن المسار المختار صامت: تسجيلات OBS قد تحتوي عدة مسارات. transcribe.py يدعم --audio-track بأرقام تبدأ من الصفر، ويفحص الصمت قبل الرفع. تأكد من مسار الميكروفون بدل إعادة إرسال ملف صامت. [4]

ملف الترجمة مفقود أو لا يظهر: السكربت الحالي يرفض مسار ترجمة لا يجده بدل الإخراج بصمت دون الترجمة. راجع المسار في EDL. لا تستخدم --no-subtitles لإخفاء المشكلة إذا كان المطلوب فيديو مترجمًا. [7]

الترجمة العربية أو الأسماء غير صحيحة: راجع تفريغ الكلام يدويًا، واختبر الخط واتجاه النص والقراءة على الجوال. المشروع لا يثبت في المصادر التي راجعناها اختبارًا شاملًا للعربية، وأساليب الحروف الكبيرة الواردة في الأمثلة ليست تصميمًا مناسبًا تلقائيًا للنص العربي.

غيّرت المقطع وبقي التفريغ القديم: التخزين المؤقت في السكربت يعتمد على وجود ملف التفريغ باسمه، ولا يتحقق ببصمة من أن محتوى الفيديو لم يتغير. استخدم اسمًا أو مجلد عمل جديدًا للمصدر المعدّل، وراجع تكلفة التفريغ الجديد، بدل افتراض أن التغيير سيُكتشف تلقائيًا. [4]

مصطلحات

وكيل برمجي: مساعد يستطيع استخدام أدوات وملفات وأوامر، وليس مجرد توليد نص.
Scribe: خدمة ElevenLabs لتفريغ الصوت إلى نص.
توقيت الكلمات: بداية كل كلمة ونهايتها، للمساعدة في تجنب القص وسط الكلام.
تمييز المتحدثين: إسناد مقاطع الكلام إلى متحدثين مختلفين.
EDL: قائمة قرارات تحدد المقاطع وترتيبها ضمن الفيديو الناتج.
Render: تنفيذ قرارات التحرير وإنتاج ملف فيديو.
Overlay: رسم أو نص أو عنصر مرئي يوضع فوق اللقطات.
Timeline view: عرض يجمع صورًا من الفيديو ومعلومات الصوت والتوقيت للمراجعة.

ماذا بعد؟

ابدأ بمقطعين قصيرين غير حساسين. اطلب فيديو بسيطًا بلا رسوم متحركة، وراجع خطة القص ومعاينة الترجمة قبل إضافة تعقيد جديد. احتفظ بالمصادر الأصلية، ولا تعتبر وجود final.mp4 وحده دليلًا على جودة المونتاج.

وإذا كنت تريد ضبط طريقة تحقق وكيلك من إنجاز العمل عمومًا، اقرأ وكيلك البرمجي يقول «تم»؟ تحقّق من الكود مع Procoder. الفكرة المشتركة هي طلب دليل واضح على النتيجة؛ لكل أداة نطاقها المختلف.

المصادر وحقوق الصور

الغلاف مشتق من البانر الرسمي، مع الحفاظ على نسبته داخل غلاف 1200×630. حُوّل الرسم الرسمي إلى PNG؛ ليس تجربة مونتاج محلية أو إثباتًا لجودة ناتج. الأصول والوثائق من Browser Use تحت MIT، ونسخة الترخيص مرفقة بحزمة المراجعة.