نسخة Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# دليل عملي إلى Rive CLI ووكلاء البرمجة

> دليل عملي لاستخدام Rive CLI وRML مع وكيل برمجي لإنشاء الرسوم التفاعلية وفحصها واختبارها، مع توضيح قيود الحساب والتوقيع والتصدير.

By BIG CHANGE Editorial

Published: 2026-09-27T00:12:27.556Z
Updated: 2026-09-27T00:17:31.324Z
Canonical: https://bigchange.ai/blog/rive-cli-rml-coding-agents-guide

![A designer holds a controller while viewing an orange jointed animation shape on a wall-mounted display, with a smaller screen of indented lines nearby.](https://bigchange.ai/api/media/file/rive-cli-animation-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

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

تستند قائمة التحقق هذه إلى [وثائق Rive](https://rive.app/docs/cli/overview). راجع BIG CHANGE الوثائق فقط؛ ولم نثبت CLI أو ننشئ ملفًا أو نختبر رسمًا أنتجه وكيل. ويعرض [الفيديو التوضيحي](https://youtu.be/Y3E33otHeLE) سير العمل المقصود الذي يجمع بين الإنسان والوكيل.

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

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

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

1. **تحقّق من الوصول وثبّت الأدوات.** تسرد Rive أنظمة macOS على أجهزة Apple Silicon وLinux بمعمارية x86\_64 وWindows ضمن الأنظمة المدعومة. ويوفر دليل [البدء](https://rive.app/docs/cli/getting-started) تعليمات تثبيت منفصلة لـWindows وmacOS/Linux؛ اتبع تعليمات Windows الحالية في الصفحة. شغّل `rive doctor` بعد التثبيت. ويوثق مرجع الأوامر أيضًا `rive --version`؛ سجّل الإصدار الذي ثبّتّه فعليًا لأن البرنامج ما يزال في مرحلة المعاينة. وقال إعلان Rive الصادر في 11 سبتمبر إن CLI كانت مجانية بلا حدود *أثناء المعاينة*. ولا يثبت هذا التصريح المؤرخ أن سعر CLI سيظل مجانيًا دائمًا. أما [جدول الخطط الحالي](https://rive.app/pricing) فيتعلق بحسابات Rive ووكيل المحرر المدمج، لذا تحقّق من الشروط السارية قبل النشر.
2. **أنشئ مشروعًا نصيًا وافتح المعاينة.** `rive create myproject` ينشئ الملفات التالية: `scene.rml`، `rive.yaml` وتعليمات الوكيل في `AGENTS.md` و `CLAUDE.md`، وملف `.gitignore`. شغّل `rive myproject` في نافذة طرفية. ووفقًا لـRive، تراقب الأداة المجلد وتعيد البناء عند حفظ التغييرات، وتكتب `myproject/build/myproject.riv`. يحتوي المشهد المبدئي على لوحة رسم وخط زمني وآلة حالات، لكنه لا يتضمن رسمًا بعد؛ لذا تبدو المعاينة الأولية مستطيلًا داكنًا.
3. **أعطِ وكيل البرمجة مجلد المشروع ومهمة تصميم محددة.** يذكر دليل [وكلاء الذكاء الاصطناعي](https://rive.app/docs/cli/agents) لدى 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](https://rive.app/docs/runtimes/advanced-topic/rml) من أن نجاح البناء وحده لا يثبت أن الرسم يبدو أو يعمل على النحو المقصود.
5. **التقط صورًا للحالات المهمة.** `rive myproject --screenshot=out.png` ينشئ صورة PNG من دون نافذة. وتضم وثائق Rive [الأمثلة](https://rive.app/docs/cli/examples) التي تستخدم `--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` قد يضيف علامة مائية. ويذكر [مرجع الأوامر](https://rive.app/docs/cli/reference/commands) أن إنشاء ملف `.riv` نظيف يتطلب ربط المشروع بملف حساب عبر الأمر `rive push`، وأن يكون هذا الملف في مساحة عمل من فئة Cadet أو أعلى. ويظل شرط العلامة المائية ساريًا حتى لو لم يتضمن المشهد نصوصًا برمجية. ويتطلب `--rev=<path>` أيضًا تسجيل الدخول، ويمكن استخدامه مع `--once` أو `--publish`؛ وهو يكتب ملف Editor لا بديلًا لملف وقت التشغيل. تحقّق من خطة الحساب الحالية ومن نتيجة التصدير الفعلية قبل النشر.

لدى Rive أيضًا [وكيل ذكاء اصطناعي مدمج في المحرر](https://rive.app/docs/editor/ai-agent). يمكن فتحه من الشريط الجانبي في Editor، ويخضع لشروط الخطة وأرصدة الذكاء الاصطناعي الخاصة بالمحرر. أما سير العمل في هذا الدليل، القائم على مجلد وطرفية، فيستخدم وكيل برمجة مع CLI؛ ولكل من المسارين واجهة وسياق فوترة مختلفان.

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

- [نظرة عامة على Rive CLI](https://rive.app/docs/cli/overview) تشرح سير العمل من الطرفية، وصيغ المخرجات، والمعاينة، وتبادل الملفات مع الحسابات البعيدة.
- [البدء](https://rive.app/docs/cli/getting-started) تعرض الأنظمة المدعومة والتثبيت ومحتويات هيكل المشروع والبناء المحلي وشروط تسجيل الدخول.
- [العمل مع وكلاء الذكاء الاصطناعي](https://rive.app/docs/cli/agents) توضح كيفية استخدام وكيل البرمجة لتعليمات المشروع التي أُنشئت تلقائيًا وملاحظات CLI. أما دليل [الوكيل المدمج في المحرر](https://rive.app/docs/editor/ai-agent) فيشرح واجهة Editor المنفصلة.
- [دليل RML](https://rive.app/docs/runtimes/advanced-topic/rml)، [مرجع الأوامر](https://rive.app/docs/cli/reference/commands) و[الأمثلة](https://rive.app/docs/cli/examples) تدعم شرح نموذج الملفات والأوامر الدقيقة والاختبارات والتقاط الصور وقيود النشر.
- [إعلان فريق Rive الصادر في 11 سبتمبر](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) يؤرخ للمعاينة التقنية والتصريح المؤقت بأن CLI مجانية خلالها. [التنزيلات](https://rive.app/downloads) تصنف CLI حاليًا ضمن الوصول المبكر؛ أما [الأسعار](https://rive.app/pricing) تسرد خطط الحساب. وشاهد [الفيديو التوضيحي لـRive](https://youtu.be/Y3E33otHeLE) لمعرفة سير العمل الذي يجمع بين الإنسان والوكيل.

## Sources

- [نظرة عامة على Rive CLI](https://rive.app/docs/cli/overview) — تحدد غرض CLI ومخرجات .riv المحلية و.rev الخاصة بـEditor، والمعاينة المباشرة، وقدرات الفحص والاختبار والتقاط الصور، وتبادل الملفات عن بُعد.
- [دليل البدء باستخدام Rive CLI](https://rive.app/docs/cli/getting-started) — يوثق المنصات المدعومة والتثبيت وهيكل المشروع ومخرجات المعاينة وملفات .rev والاستيراد عن بُعد ومتطلبات تسجيل الدخول وتوقيع النصوص البرمجية وشروط العلامة المائية.
- [العمل مع وكلاء الذكاء الاصطناعي](https://rive.app/docs/cli/agents) — يوثق العمل مع وكلاء برمجة خارجيين، وتعليماتهم المنشأة للمشروع، والبحث في المرجع، والتحقق والفحص والتوجيه البشري على مراحل.
- [لغة Rive Markup Language](https://rive.app/docs/runtimes/advanced-topic/rml) — تعرّف بنية RML وتجميع مشروع نصي والفحوص المنفصلة للتجميع والفحص البصري؛ وتنص صراحة على أن نجاح البناء لا يثبت المظهر أو السلوك المقصود.
- [مرجع أوامر Rive CLI](https://rive.app/docs/cli/reference/commands) — المرجع الأساسي للأوامر الدقيقة والخيارات وسلوك رموز الخروج وأوامر الدفع والسحب عن بُعد والمصادقة والتوقيع وتصدير .rev وشروط إنشاء .riv نظيف.
- [أمثلة Rive CLI](https://rive.app/docs/cli/examples) — تعرض لقطات الشاشة دون نافذة، وخيارات advance وviewport والبيانات ومدخلات المؤشر، واختبارات Luau وتقارير JSON؛ وهي أمثلة موثقة لم يشغّلها BIG CHANGE.
- [وكيل Rive للذكاء الاصطناعي](https://rive.app/docs/editor/ai-agent) — يصف وكيل Editor المدمج المنفصل من Rive وسياق خطته وأرصدة الذكاء الاصطناعي.
- [تنزيلات Rive](https://rive.app/downloads) — تدرج الصفحة الحالية Rive CLI ضمن الوصول المبكر.
- [أسعار Rive](https://rive.app/pricing) — تسرد شروط خطط الحساب ووكيل Editor الحالية؛ وتُعرض منفصلة عن التصريح المؤرخ بشأن سعر CLI خلال المعاينة.
- [تقديم Rive CLI وRML](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — يصف إعلان فريق Rive الإصدار بأنه معاينة تقنية، ويذكر أن CLI مجانية بلا حدود خلال تلك المعاينة. كما يشرح أدوار .riv و.rev وRML ويربط بالفيديو التوضيحي.
- [شرح Rive CLI بالفيديو](https://youtu.be/Y3E33otHeLE) — رابط فيديو قدّمه مالك المحتوى، وأُدرج في المتن والمصادر؛ ولا يتضمن أي ادعاء عن مشهد أو نتيجة خاصة بالفيديو.