تتيح واجهة Rive الجديدة لسطر الأوامر لوكيل البرمجة العمل على الرسوم التفاعلية بصفتها ملفات مشروع. يستطيع الوكيل كتابة لغة Rive Markup Language (RML) ونصوص Luau وتظليلات، ثم يطلب من الواجهة تجميع الناتج وفحصه واختباره وتصويره. ويمكن للشخص متابعة المعاينة المحلية ومراجعة التصميم. وقدّم فريق Rive الواجهة على أنها معاينة تقنية في 11 سبتمبر؛ صفحة التنزيلات لدى Rive، وقد روجعت في 27 سبتمبر، وتدرجها الصفحة ضمن الوصول المبكر.

تستند قائمة التحقق هذه إلى وثائق Rive. راجع BIG CHANGE الوثائق فقط؛ ولم نثبت CLI أو ننشئ ملفًا أو نختبر رسمًا أنتجه وكيل. ويعرض الفيديو التوضيحي سير العمل المقصود الذي يجمع بين الإنسان والوكيل.

التغيير الأبرز

  • ما الذي تغيّر: أصبح لمشاهد Rive مسار نصي يمكن لوكلاء البرمجة استخدامه. يستطيع الوكيل تعديل RML داخل مجلد المشروع، بينما تجمع CLI ملفًا .riv لوقت التشغيل، أو ملفًا .rev لمواصلة العمل في المحرر.
  • لماذا يهم ذلك: يستطيع المصممون ومطورو الواجهات والألعاب مراجعة تغييرات المصدر مع بقية ملفات المشروع، والاستفادة من فحوص CLI أثناء التطوير. ومع ذلك، عليهم تقييم التصميم المعروض والتفاعلات قبل استخدام الأصل في منتج.
  • ما الذي ينبغي متابعته: نقل نموذج أولي محلي إلى الويب قرار منفصل. والملفات التي تتضمن نصوصًا برمجية تحتاج إلى بناء موقّع باستخدام الأمر --publish؛ ويحتاج ملف .riv سليم أيضًا إلى ربطه بملف حساب وإلى مساحة عمل من فئة Cadet أو أعلى. تحقّق من هذه الشروط ومن الرسم النهائي قبل النشر.

قائمة المهام الموثقة

  1. تحقّق من الوصول وثبّت الأدوات. تسرد Rive أنظمة macOS على أجهزة Apple Silicon وLinux بمعمارية x86_64 وWindows ضمن الأنظمة المدعومة. ويوفر دليل البدء تعليمات تثبيت منفصلة لـWindows وmacOS/Linux؛ اتبع تعليمات Windows الحالية في الصفحة. شغّل rive doctor بعد التثبيت. ويوثق مرجع الأوامر أيضًا rive --version؛ سجّل الإصدار الذي ثبّتّه فعليًا لأن البرنامج ما يزال في مرحلة المعاينة. وقال إعلان Rive الصادر في 11 سبتمبر إن CLI كانت مجانية بلا حدود أثناء المعاينة. ولا يثبت هذا التصريح المؤرخ أن سعر CLI سيظل مجانيًا دائمًا. أما جدول الخطط الحالي فيتعلق بحسابات Rive ووكيل المحرر المدمج، لذا تحقّق من الشروط السارية قبل النشر.
  2. أنشئ مشروعًا نصيًا وافتح المعاينة. rive create myproject ينشئ الملفات التالية: scene.rml، rive.yaml وتعليمات الوكيل في AGENTS.md و CLAUDE.md، وملف .gitignore. شغّل rive myproject في نافذة طرفية. ووفقًا لـRive، تراقب الأداة المجلد وتعيد البناء عند حفظ التغييرات، وتكتب myproject/build/myproject.riv. يحتوي المشهد المبدئي على لوحة رسم وخط زمني وآلة حالات، لكنه لا يتضمن رسمًا بعد؛ لذا تبدو المعاينة الأولية مستطيلًا داكنًا.
  3. أعطِ وكيل البرمجة مجلد المشروع ومهمة تصميم محددة. يذكر دليل وكلاء الذكاء الاصطناعي لدى Rive أسماء مثل Claude Code وCursor أو أي وكيل آخر يستطيع قراءة الملفات وكتابتها وتشغيل أوامر shell. وتشرح التعليمات التي ينشئها المشروع للوكيل كيفية استخدام rive docs و rive schema للتعرّف إلى الكائنات والخصائص المدعومة. وRML صيغة XML: تمثل العناصر أنواع Rive، وتمثل السمات خصائصها، ويحدد التعشيق علاقات الكائنات. ويمكن للوكيل أيضًا تعديل .luau نصوصًا برمجية، .wgsl تظليلات وأصول المشروع. اطلب منه العمل على مراحل حتى تتمكن من توجيه التخطيط والسلوك بينما تتجدد المعاينة.
  4. تحقّق من عملية البناء ومحتوياتها. اطلب من الوكيل تشغيل rive myproject --verify، الذي يجمع المشروع دون كتابة ملف .riv، وتشغيل rive inspect myproject --summary، الذي يعرض المشكلات وعدد الكائنات. أما المشهد المحلول بالكامل فيمكن فحصه باستخدام rive inspect myproject --json. وإذا احتاج المشروع إلى ملف محلي قابل للتوزيع دون فتح المعاينة، فإن rive myproject --once ينشئ ملف .riv غير موقّع. يمكن لهذه الفحوص العثور على أخطاء التجميع والكائنات المفقودة أو غير المتوقعة. ويحذّر دليل RML من Rive من أن نجاح البناء وحده لا يثبت أن الرسم يبدو أو يعمل على النحو المقصود.
  5. التقط صورًا للحالات المهمة. rive myproject --screenshot=out.png ينشئ صورة PNG من دون نافذة. وتضم وثائق Rive الأمثلة التي تستخدم --advance=1s لالتقاط إطار بعد بدء الحركة، والخيار --viewport=390x844 لتحديد أبعاد العرض، والخيار --data=battery/level=100 لتزويد البيانات المرتبطة، والخيار --pointer=click@120,60 --advance=20 لمحاكاة نقرة. اختر القيم والإحداثيات من مشهدك، وقارن اللقطات بين الحالات وأحجام العرض، ثم افحصها بنفسك. واللقطة التي لا تستخدم --advance تعرض وضع السكون الذي صُمم عليه المشهد، ولا تعرض بالضرورة إطار بدء الحركة.
  6. شغّل اختبارات النصوص البرمجية إذا كان المشروع يتضمنها. rive myproject --test يشغّل Tests نصوص المشروع. وتوثق Rive --verify --format=json و --test --format=json لإجراء الفحوص آليًا؛ وتُرجع حالات فشل البناء والاختبارات رموز خروج غير صفرية. ويمكن للوكيل استخدام التقارير لمراجعة المصدر. لكن الاختبارات لا تغطي إلا التأكيدات المكتوبة فعلًا، لذا راجع التفاعلات التي لا تشملها.
  7. اختر مسار الحساب عندما يصبح النموذج الأولي المحلي جاهزًا. ملف .riv هو أصل وقت التشغيل؛ أما ملف .rev يُفتح للتحرير في Rive Editor. وتقول Rive إن الإنشاء المحلي والمعاينة والتحقق والاختبارات ولقطات الشاشة تعمل دون اتصال بالإنترنت؛ rive login هو أمر تسجيل الدخول اللازم لاستخدام --publish، --rev، rive push، rive pull وكذلك استيراد ملف حساب بعيد. وللبدء من نسخة احتياطية مصدّرة من Editor، استخدم rive create myproject --from-rev=myfile.rev يعمل دون تسجيل دخول. أما للبدء من ملف حساب، فاستخدم rive create myproject --from-remote-file بعد تسجيل الدخول. ويربط هذا الأمر المشروع بملف الحساب: rive push myproject يرفع مراجعة؛ rive pull myproject يجلب تغييرات Editor إلى المشروع، ويستبدل المشهد المحلي ونصوصه البرمجية وأصوله بعد التأكيد. راجع تغييراتك المحلية قبل السحب.
  8. تحقّق من حدود التوقيع والتصدير قبل النشر. rive myproject --publish ينشئ ملفًا موقّعًا بصيغة .riv ويتطلب تسجيل الدخول. وتقول Rive إن أوقات تشغيل الويب وشبكة CDN ترفض النصوص غير الموقّعة، لذا يجب استخدام هذا المسار لأي ملف يحتوي نصوصًا برمجية للويب. --publish قد يضيف علامة مائية. ويذكر مرجع الأوامر أن إنشاء ملف .riv نظيف يتطلب ربط المشروع بملف حساب عبر الأمر rive push، وأن يكون هذا الملف في مساحة عمل من فئة Cadet أو أعلى. ويظل شرط العلامة المائية ساريًا حتى لو لم يتضمن المشهد نصوصًا برمجية. ويتطلب --rev=<path> أيضًا تسجيل الدخول، ويمكن استخدامه مع --once أو --publish؛ وهو يكتب ملف Editor لا بديلًا لملف وقت التشغيل. تحقّق من خطة الحساب الحالية ومن نتيجة التصدير الفعلية قبل النشر.

لدى Rive أيضًا وكيل ذكاء اصطناعي مدمج في المحرر. يمكن فتحه من الشريط الجانبي في Editor، ويخضع لشروط الخطة وأرصدة الذكاء الاصطناعي الخاصة بالمحرر. أما سير العمل في هذا الدليل، القائم على مجلد وطرفية، فيستخدم وكيل برمجة مع CLI؛ ولكل من المسارين واجهة وسياق فوترة مختلفان.

المصادر ومزيد من القراءة