تحويل HTML إلى فيديو مع HyperFrames هو ما يقترحه المستودع heygen-com/hyperframes: اكتب الفيديو كما تكتب صفحة ويب، ثم استخرج منه ملف MP4 متطابقًا في كل عملية تصيير (render). يصف المشروع نفسه بأنه إطار عمل مفتوح المصدر يحوّل HTML وCSS والوسائط والرسوم المتحركة القابلة للتموضع («seekable») إلى فيديوهات حتمية (deterministic)، ويُستخدم من سطر الأوامر، أو من وكيل برمجة عبر المهارات (skills)، أو كمحرك تصيير لأدوات مستضافة. وقد بلغ عدد نجومه نحو 69500 في أكتوبر 2026.
بالنسبة إلى فريق ينتج فيديوهات إطلاق أو شروحات pull request أو تقارير متحركة، الفائدة هي الحصول على تصيير قابل لإعادة الإنتاج داخل سلسلة CI، ومن ثمّ يمكن مراقبته كأي مهمة. يتبع هذا المقال README ووثائق المشروع: ما هو، وماذا يُظهر التصيير، والتثبيت، والحدود، وكيف تُراقَب سلسلة تصيير. وللإطار العام للوكلاء الذين ينتجون ملفات، راجع ضوابط حماية وكلاء الذكاء الاصطناعي في الإنتاج.
توضيح للأمانة: لم تثبّت span.observer أداة HyperFrames ولم تشغّلها. الأوامر مأخوذة من README ووثائق المستودع. الصورة الأولى معاينة منشورة في README؛ أما الصورتان الأخريان فمقتطفان من هذه الملفات صيّرناهما بأنفسنا.
تحويل HTML إلى فيديو مع HyperFrames: ما الذي يقوله المستودع
- الناشر: يستضيف المستودعَ منظمةُ GitHub المسماة
heygen-com. يذكر README أن الأداة تُستخدم في الإنتاج لدى HeyGen، مع أمثلة من المجتمع (tldraw وTanStack وغيرهما في ADOPTERS.md). ولا صلة لـ span.observer بهذه الشركات. - الترخيص: Apache-2.0 (الملف LICENSE). ويبرز README عبارة «لا رسوم على كل تصيير ولا حد لاستخدام تجاري».
- أرقام قُرئت يوم 22 أكتوبر 2026 من صفحة المستودع: نحو 69500 نجمة، ونحو 6300 فرع، و5817 commit في الفرع الرئيسي. وآخر إصدار معروض هو v0.8.185 بتاريخ 21 أكتوبر 2026؛ وحزمة CLI المسماة
hyperframesتحمل الإصدار نفسه. - اللغة: TypeScript بحسب محاور المستودع؛ ويتطلب CLI إصدار Node.js 22 أو أحدث وFFmpeg.
- المكونات: CLI، ومحرك (التقاط الصفحات بـ Puppeteer وFFmpeg)، و«producer» ينسّق الالتقاط والترميز ومزج الصوت، واستوديو في المتصفح للمعاينة، وكتالوج من نحو 450 كتلة ومكوّنًا، وتصيير موزّع على AWS Lambda.
يقارن README نفسه بين HyperFrames وRemotion: المبدأ نفسه (Chrome بدون واجهة وFFmpeg)، لكن HTML بسيط بدل مكونات React، وترخيص Apache-2.0 مقابل ترخيص «source-available» لدى Remotion. هذا عرض المشروع لنفسه وليس قياسًا مستقلًا.
ما الذي يُظهره التصيير
ينشر README نماذج تصميم («frame.md») تصلح نقطة انطلاق للوكيل. وهذا أحدها، Cobalt Grid: خلفية ورقية بشبكة رسّام، وعنوان بخط serif، وأعمدة زرقاء. هي صورة لما يمكن أن تنتجه تركيبة، وليست لقطة للأداة أثناء العمل.

التركيبة (composition) ملف HTML. تصف السمات data- الزمن والمسارات، ويمكن وضع الرسم المتحرك «seekable» (GSAP أو CSS أو Lottie أو Three.js أو Anime.js أو WAAPI) على أي إطار. وهذا مثال README:

قراءة الملف: تضع data-start وdata-duration كل عنصر في الزمن، ويسنده data-track-index إلى مسار، ويُنشأ الخط الزمني GSAP في حالة إيقاف مؤقت ثم يُسجَّل في window.__timelines، مما يسمح للمحرك بتموضعه دون الاعتماد على ساعة الجدار. وبحسب README، يتموضع المحرك على كل إطار في Chrome بدون واجهة ويرمّز النتيجة بـ FFmpeg: وهذا ما يجعل المخرج متطابقًا للمدخل نفسه.
التثبيت خطوة بخطوة
الخطوة 1: مع وكيل برمجة
مع Claude Code، يطلب README تثبيت الإضافة ذات الإصدارات:
claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframes
لمهارات مستقلة (بما فيها OpenCode):
npx skills add heygen-com/hyperframes
يقدّم المشروع 7 مهارات؛ وتضم المجموعة الأساسية /hyperframes و/hyperframes-cli و/hyperframes-registry و/media-use. المهارة تعطي الوكيل تعليمات من مزوّد: راجعها قبل التثبيت، كأي شيفرة تُنفَّذ بصلاحياتك.
الخطوة 2: يدويًا عبر CLI
المتطلبات المعلنة: Node.js 22+ وFFmpeg.
npx hyperframes init my-video
cd my-video
npx hyperframes preview # aperçu navigateur avec rechargement
npx hyperframes render # rendu MP4

الخطوة 3: اضبط التصيير
يوثّق دليل rendering الخيارات المفيدة لسلسلة آلية: --output (وبدونه تذهب النتيجة إلى renders/)، و--quality draft أو high، و--fps 60، و--format webm|mov|gif|png-sequence|hls، و--composition لاستهداف ملف آخر، و--docker حين يلزم Chrome وFFmpeg وخطوط مضبوطة، مثلًا في CI. وتوضح الوثائق أن Docker يضيف زمن إقلاع وأنه ليس إلزاميًا.
الحدود والنقاط المفتوحة
- وتيرة الإصدارات (v0.8.185 حتى الآن) تدل على مشروع نشيط جدًا، أي غير مستقر: ثبّت إصدار CLI في مسارات العمل لديك.
- يوصف الاستوديو في جدول README بأنه «متاح، متطور»؛ وCLI هو الجزء الأكثر استقرارًا.
- يستخدم المستودع Git LFS لنحو 240 ميغابايت من الفيديوهات المرجعية: يحسن أن تعرف ذلك قبل استنساخ المستودع كاملًا.
- على WSL2، تشير الوثائق إلى أن Chrome قد يعود إلى التصيير البرمجي، وهو أبطأ بعدة مرات؛ وتنصح بالتصيير من Windows إن لم يُستخدم GPU.
- تحمّل الأمثلة GSAP من CDN: للتصيير دون اتصال استضف المكتبة بنفسك.
- الوسائط التي تولّدها خدمات خارجية (أصوات وصور رمزية) تخضع لشروط تلك الخدمات، لا لترخيص المشروع.
مراقبة سلسلة تصيير HyperFrames
HyperFrames ليس خادمًا: هو أداة سطر أوامر، فتُراقَب كمهمة. وما يلي صالح مع Dynatrace SaaS ومع Dynatrace Managed، عبر بيانات CI لديك أو Collector من OpenTelemetry. ولا يوثّق المشروع نفسه أي تصدير OpenTelemetry.
- المدة والحالة: قِس مدة
npx hyperframes renderورمز الخروج في CI. ويوصي دليل الأداء بالقياس قبل تغيير أي شيء، باستخدام Chrome DevTools في المعاينة، ثم المقارنة. - إعدادات الجهاز: يقارن
npx hyperframes benchmarkعدة تركيبات من fps والجودة وعدد العمّال (workers) (من 1 إلى 20 جولة، 3 افتراضيًا)؛ ويتحققnpx hyperframes doctorمن قدرة الجهاز على التصيير. - جودة التصيير: تكشف
lintوcheckوsnapshotالمشكلات قبل التصيير الكامل. ولقيادة متصفح من وكيل، راجع Chrome DevTools MCP لوكلاء البرمجة. - المصدر (provenance): يحمل كل فيديو وسمين في الحاوية،
hyperframes_rendererوhyperframes_version، يُقرآن بالأمرffprobe -v error -show_entries format_tags -of json out.mp4. مفيد لمعرفة أي إصدار أنتج ملفًا. - قياس CLI عن بُعد (telemetry): يجمع CLI بيانات استخدام، منها أسماء الأوامر وأداء التصيير وبصمة تقريبية للبيئة (النظام والمعالج والذاكرة واسم وكيل البرمجة المكتشف). ولا يجمع محتوى الفيديوهات ولا أسماء المشاريع، بحسب الوثائق. ويُعطَّل بـ
npx hyperframes telemetry disableويُتحقق منه بـtelemetry status. - التكاليف: الوكيل الذي يكتب التركيبة يستهلك رموزًا (tokens)؛ تابعها كما في تكلفة وكيل الذكاء الاصطناعي بالرموز مع OpenTelemetry.
كيف تتحقق من أن كل شيء يعمل
- لا يبلّغ
npx hyperframes doctorعن أي نقص. - يعرض
npx hyperframes previewالتركيبة في المتصفح. - ينتج
npx hyperframes render --output final.mp4ملفًا؛ ويقرأffprobeمدته ووسوم المصدر. - يعطي تصييران متتاليان للتركيبة نفسها الفيديو نفسه، كما يعد المشروع؛ قارن بصماتهما قبل أن تبني عليه اختبار انحدار (regression).
أفضل الممارسات
- ثبّت إصدار
hyperframesوإصدار المهارات المثبَّتة. - صيّر في CI بـ
--dockerإن كانت قابلية إعادة الإنتاج أهم من السرعة. - احتفظ بالوسائط المصدر في مستودع الفيديو وأعدّها بدقة المخرج.
- قرّر بشأن القياس عن بُعد قبل النشر لا بعده.
- راجع المحتوى الذي يولّده الوكيل قبل النشر: النص والعلامات وحقوق الموسيقى والصور.
الأسئلة الشائعة
هل HyperFrames مجاني للاستخدام التجاري؟
المشروع بترخيص Apache-2.0 ويعلن README غياب رسوم على كل تصيير. وللخدمات الخارجية التي تستدعيها تركيباتك شروطها الخاصة.
هل أحتاج إلى معرفة React؟
لا: التركيبة ملف HTML مع سمات زمنية ورسم متحرك. وهذا هو خيار التصميم الذي يبرزه README في مواجهة Remotion.
هل التصيير متطابق فعلًا في كل مرة؟
هذا هو الهدف المعلن («المدخل نفسه، الإطارات نفسها، المخرج نفسه»). وتأتي الفروق عادة من البيئة: إصدار Chrome والخطوط وFFmpeg. ومن هنا أهمية الوضع --docker واختبار مقارنة.
الخلاصة
يلبي HyperFrames حاجة ملموسة: أن ينتج وكيل فيديوهات دون محرر رسومي، بتصيير تعيد سلسلة CI تشغيله وقياسه. احتفظ بثلاث عادات: تثبيت الإصدار، والقرار بشأن القياس عن بُعد، وقياس كل تصيير. المصادر: مستودع heygen-com/hyperframes.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.