عن المشروع

Reel هو أداة مفتوحة المصدر تُستخدم لإنشاء عروض توضيحية كودية للتطبيقات الويب وواجهات سطر الأوامر. يعمل على أساس مواصفات بسيطة بصيغة YAML، حيث يوجه التطبيق الفعلي — سواء داخل متصفح Chromium عبر Playwright أو في طرفية حقيقية — ويُسجل ما يحدث فعليًا. يتم بعد ذلك تحويل هذه التسجيلات إلى صور متحركة GIF أو ملفات MP4 أو WebM أو لوحة صور PNG أو مكونات HTML تفاعلية مدعومة بـ HyperFrames. تتم العملية من خلال ملف مواصفات: تكتب أو تسجل الملف، ثم تنفذ الأمر `reel check` للتحقق من أن كل خطوة لا تزال تعمل، ومن ثم `reel shoot` لإنتاج التسجيلات. كما يمكن استخدام الأمر `reel compose` لإنشاء مشروع HyperFrames، حيث يقوم المؤلفون بملء وصف المشاهد قبل التصنيع النهائي. الميزات الرئيسية: - **وضع التقاط**: يمكنك تشغيل التطبيق يدويًا وترك Reel يكتب المواصفات تلقائيًا، بما في ذلك محددات استجابة للوصولية المستقرة. - **قواعد المشاهد**: تشمل البطاقات العنوانية، والتنبيهات، والتركيز، والانتقالات، والرسوم البيانية (Mermaid)، والتكبير، والتمرير، وحركات السحب، وهي جميعها منظمة في تسلسلات موجهة وليس تسجيلات خام. - **إعدادات التسليم**: إخراجات محسنة لملفات README، ووسائل التواصل الاجتماعي، والوثائق، ومشاركة عالية الدقة. - **الصوت**: نصافر اختيارية عبر ElevenLabs أو OpenAI، وتأثيرات صوتية مُزَمَّنة، ومقطوعات موسيقية خلفية مع تقنية ducking، ومزامنة الصورة مع الصوت. - **الترجمة والتعليقات**: ملفات SRT/VTT جانبية مع نسخ مترجمة باستخدام الذكاء الاصطناعي لكل لغة. - **معالجة المصادقة**: تسجيل الدخول مرة واحدة خارج الكاميرا باستخدام جلسة Playwright محفوظة؛ بحيث تُعاد تشغيل العروض المصادقة دون كشف كلمات المرور في المواصفات. - **التأكد من التكرارية**: تجميد الساعات، وإيقاف الرسوم المتحركة، وتثبيت اللغة/المنطقة الزمنية لضمان إنتاج قابل للتكرار. - **إضافة Claude Code**: إنشاء وتحسين العروض عبر اللغة الطبيعية باستخدام مهارات `/reel` و `/reel-polish`. - **واجهة المستخدم للمشهد**: واجهة Next.js محلية لتحرير المواصفات، والتسجيل مع معاينة مباشرة، والكتابة بالذكاء الاصطناعي، والتحقق من التغيرات. - **دمج CI**: يُستخدم الأمر `reel check` كاختبار أولي يفشل في النفق عند تعطل تدفق العرض. - **دعم المحررات**: اكتمال تلقائي لملفات YAML في VS Code وJetBrains وNeovim. كل شيء يعمل محليًا — مرخص بموجب رخصة MIT بالكامل، ولا يتطلب أي خدمات سحابية أو استضافة. يتطلب Node.js الإصدار 22 فأكثر وTypeScript.