دليل مستخدم CLI

ما هو NadouPro CLI؟

✈️ المحطة الوسيطة التي تُدخل الذكاء الاصطناعي إلى سير الإبداع

من فكرة واحدة وبضع صور مرجعية إلى لوحات القصة وعُقد الفيديو، يكفي أن تصف الهدف بلغة طبيعية. يستدعي المساعد الذكي القدرات الإبداعية المفتوحة عبر NadouPro CLI، ويطلب تأكيدك في الخطوات الحاسمة. يوفّر NadouPro اللوحة الحرة ومنصة العمل والوكيل وغيرها من مداخل الإبداع؛ ويُحدَّد النطاق الفعلي لـ CLI وفق الإصدار الحالي.

تخيّل الإنتاج السينمائي تعاونًا في موقع تصوير: أنت تطرح القصد الإبداعي وتتخذ الأحكام الحاسمة، والمساعد الذكي يفكك المهام ويستدعي الأدوات ويتابع النتائج، وNadouPro يوفّر النماذج والمواد والمساحات واللوحة الحرة. NadouPro CLI هو قناة العمل بين الثلاثة.

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

من يناسبه؟

• صنّاع الأفلام والمحتوى: يريدون تسليم تصميم الشخصيات ولوحات القصة وتوليد اللقطات وتنظيم المواد إلى المساعد الذكي.

• فرق الإبداع: يحتاجون وضع النتائج في مساحة فريق أو لوحة حرة لمواصلة المراجعة والتعاون والتكرار.

• مستخدمو أدوات الذكاء الاصطناعي مثل Claude Code وCursor: يريدون استدعاء NadouPro مباشرة في الحوار بدل التنقل المتكرر بين الصفحات ونسخ المواد.

1. 📦التثبيت السريع

الطريقة الأولى: تثبيت بنقرة عبر المساعد الذكي

أرسل الفقرة التالية إلى المساعد الذكي:

يرجى تثبيت NadouPro CLI: npm install -g @iqiyi-intl-nadoupro/nadou-cli. بعد التثبيت شغّل nadou version --json للتحقق (يتطلب Node.js 16 أو أحدث)

ينجز المثبّت ثلاثة أمور:

1. تثبيت Nadou CLI المطابق لنظام التشغيل الحالي وبنية المعالج.

2. التحقق من أن CLI يعمل بشكل صحيح وطباعة الإصدار وcommit ووقت البناء.

3. مزامنة Nadou Skill الرسمي لنفس الإصدار مع الوكلاء العامّين المدعومين على هذا الجهاز.

معيار نجاح التثبيت

يعيد nadou version --json معلومات الإصدار، ويتطابق إصدار Skill في nadou skill read --json مع إصدار CLI.

الطريقة الثانية: التثبيت اليدوي

خطوات التثبيت اليدوي

إذا فضّلت العمل بنفسك في الطرفية، نفّذ:

npm exec --yes --registry=https://registry.npmjs.org/ --package=@iqiyi-intl-nadoupro/nadou-cli@latest -- nadou-install
nadou version --json
nadou skill install --json
nadou skill read --json

إذا تأكدت أن الجهاز لم يسبق له تثبيت إصدار قديم من Nadou CLI، يمكنك تثبيت حزمة npm مباشرة:

npm install -g @iqiyi-intl-nadoupro/nadou-cli
nadou version --json
nadou skill install --json
nadou skill status --json

يدعم المثبّت الحالي Windows x64 وLinux x64/arm64 وmacOS x64/arm64. لا توجد حزمة مسبقة الترجمة لـ Windows arm64 حتى الآن.

التفويض وتسجيل الدخول لأول مرة

قبل تنفيذ عمليات تتطلب حسابًا، يجب أن يتحقق الوكيل من حالة تسجيل الدخول أولًا لتفادي فتح المتصفح مرارًا:

nadou auth status --no-interactive --json

إذا لم تكن مسجّل الدخول، نفّذ بعد ذلك:

nadou auth login --timeout 10m --json

1. يحاول CLI فتح المتصفح الافتراضي للنظام. إذا تعذّر الفتح التلقائي في البيئة الحالية، يُعرض عنوان التفويض نفسه في المخرجات.

2. في صفحة تسجيل الدخول الدولية المفتوحة، انقر «Continue to international sign in»، ثم أكمل تسجيل الدخول بحساب الموقع الدولي حسب توجيه النافذة.

3. بعد نجاح التفويض، يتحقق CLI تلقائيًا من حالة تسجيل الدخول. يمكن للوكيل متابعة المهمة الأصلية دون أن تشغّل أمر تسجيل دخول آخر.

يستخدم هذا الدليل إصدار CLI للشبكة العامة الدولية، ويتصل افتراضيًا ببيئة الإنتاج الدولية. يدعم هذا التوزيع بيئة الإنتاج فقط.

تسجيل الدخول على خادم أو داخل حاوية

إذا كانت CLI تعمل على خادم أو داخل حاوية Docker/Claw أو في بيئة بلا واجهة رسومية، وتعذّر استخدام متصفح النظام أو مخزن بيانات الاعتماد الخاص بالنظام، فنفّذ:

nadou auth login --server

تعرض CLI رابط تسجيل الدخول ورمز التحقق، ثم تنتظر نتيجة التفويض. افتح الرابط في متصفح على أي جهاز، وأدخل رمز التحقق، وأكمل تسجيل الدخول وأكّد الحساب الذي ستستخدمه مع CLI. لاستخدام حساب آخر، اختر «تبديل الحساب».

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

يستمر الأمر الافتراضي nadou auth login في استخدام آلية التفويض عبر المتصفح ومخزن بيانات الاعتماد الخاص بالنظام كما كان سابقًا.

2. 📹لماذا يناسب الإبداع السينمائي

يركّز NadouPro CLI حاليًا على النص والصورة والفيديو والمساحات واللوحة الحرة. يمكنه إنجاز توليد مستقل واحد، أو تنظيم سلسلة إبداع متعددة المواد والمراحل حول المشروع نفسه.

القدرة	العمل المناسب
النص	توسيع الأفكار، ومخطط السيناريو، ووصف لوحات القصة، والمطالبات والنصوص؛ تُعاد نتائج النص مباشرة.
الصورة	نص إلى صورة، وصورة من مرجع، وإعادة الرسم الجزئي، والصور البانورامية، والمساقط الثلاثة للعنصر.
الفيديو	نص إلى فيديو، وفيديو متعدد المراجع، وتوليد الإطار الأول/الأخير، والتحرير الدلالي للفيديو، والتحكم بالحركة.
اللوحة الحرة	إنشاء لوحة أو قراءتها، وتنظيم عُقد النص والصورة والفيديو والوصلات، والتوليد على عُقد محددة.
المساحات والتسليم	حفظ النتائج في المساحة الشخصية أو مساحة فريق محددة لمواصلة التعاون والإدارة.
معالجة الفيديو محليًا	فحص معلومات الفيديو، وحرق الترجمة، وضم المقاطع المتوافقة دون إعادة ترميز.

مزايا الإبداع

1. التوسع من مادة واحدة إلى سلسلة إنتاج كاملة

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

3. أدوار المواد المرجعية أوضح

4. مراجع الشخصية والزي والمشهد والأسلوب والإطار الأول والإطار الأخير والحركة تؤدي مهامًا مختلفة. ما إن توضح استخدام كل مادة بلغة طبيعية حتى يختار المساعد الذكي طريقة التوليد المناسبة، ويقلل أخطاء مثل معاملة صورة مرجعية عادية كإطار أول.

5. يمكن تأكيد العملية على مراحل

6. توليد الصور والفيديو يستهلك نقاطًا. يمكن للمساعد الذكي عرض النموذج والمواصفات والنقاط المقدّرة وموضع الحفظ قبل الإرسال، لتقرر الاتجاه أولًا ثم تقرر التوليد. ويمكن مراجعة نتائج مرحلية مثل لوحات القصة والصور المفتاحية قبل المتابعة.

7. اللوحة الحرة تحفظ علاقات المنبع والمصب

8. عندما تشمل المهمة عدة لوحات قصة أو عدة لقطات أو جولات تعديل، تعبّر اللوحة الحرة عن التبعيات بالعُقد والوصلات. يعمل المساعد الذكي في لوحة وعقدة محددتين، وتعود النتائج إلى العقدة المقابلة، فيسهل الضبط والتعاون لاحقًا.

3. 🫧البدء

أخبر الوكيل بلغة طبيعية مباشرة

بعد التثبيت وتسجيل الدخول، لا حاجة لحفظ معاملات CLI. يمكنك القول مباشرة:

• «ولّد لي ملصقًا سينمائيًا لشارع نيون في ليلة ممطرة.»

• «استخدم هذه الصورة المرجعية لتوليد فيديو من 5 ثوانٍ. أخبرني أولًا بالنموذج والمعاملات والاستهلاك المقدّر.»

• «ارفع هذه الصورة المحلية ثم ضعها في اللوحة التي أحددها.»

• «اقرأ البنية الحالية لهذه اللوحة، وأضف عقدة نص على اليمين وصلها بعقدة الصورة.»

• «الفيديو السابق لم يكتمل بعد. واصل انتظار معرّف المهمة الأصلي، ولا تعِد الإرسال.»

يجب أن يؤكد الوكيل أولًا المعلومات الغامضة التي لا يجوز تخمينها، مثل الحساب أو المساحة أو اللوحة أو العقدة الهدف أو أدوار الإطار الأول/الأخير أو نطاق الدفعة عالية التكلفة؛ ثم يستدعي NadouPro CLI.

4. ✏️سيناريوهات إبداع نموذجية

السيناريو 1: من فكرة واحدة إلى مسودات لقطات

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

يمكنك القول:

I want to make a cinematic Latin dance short set in a rainy night. First, I'll organize a brief creative overview, character, and scene settings, and then generate 4 storyboard drafts in 16:9. The overall vibe is high-contrast neon lighting, with character outfits matching the rainy night street. Let me know the model, quantity, and estimated points before generating.

السيناريو 2: الحفاظ على اتساق الشخصية والفن بالصور المرجعية

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

يمكنك القول:

استخدم الصور المرجعية الثلاث التي رفعتها مع هذه الرسالة لتوليد 3 لوحات قصة سينمائية متتالية بشكل مستقل: الصورة 1 ترجع ملامح البطلة وتسريحتها فقط، والصورة 2 ترجع قصة فستان الرقص الأحمر المهدّب وخامته فقط، والصورة 3 ترجع إضاءة النيون وألوان الشارع الليلي الممطر فقط. اللوحات الثلاث بنسبة 16:9 وتحافظ على الشخصية والزي والمشهد نفسهم، دون إضافة شخصيات جديدة. قبل التوليد أخبرني بالنموذج وتقسيم أدوار الصور المرجعية وعدد التوليد والنقاط المقدّرة؛ واحفظ النتائج في مساحتي الشخصية دون إنشاء لوحة حرة.

السيناريو 3: تحويل لوحة القصة إلى لقطة فيديو

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

يمكنك القول:

استخدم لوحة القصة التي رفعتها مع هذه الرسالة إطارًا أولًا، وولّد بشكل مستقل فيديو مدته 5 ثوانٍ وبنسبة 16:9 ودقة 720p. يكمل الراقصان في الإطار دورة رقص لاتيني واحدة، وتدفع الكاميرا ببطء من لقطة عامة إلى لقطة متوسطة؛ حافظ على ملامح الشخصيات وأزيائهم وشارع الليلة الممطرة ودرجات النيون في الإطار الأول، دون إضافة أشخاص جدد. قبل التوليد أخبرني بالنموذج ومعاملات الفيديو والنقاط المقدّرة؛ واحفظ النتائج في مساحتي الشخصية دون إنشاء لوحة حرة.

السيناريو 4: تنظيم فيلم قصير في اللوحة الحرة

عندما يشمل العمل موجزًا وتصميم شخصيات ومشاهد ولوحات قصة وعدة لقطات فيديو، استخدم اللوحة الحرة لتنظيم المواد وعلاقات المنبع والمصب. يؤكد المساعد الذكي موضع الحفظ وبنية اللوحة أولًا، ثم ينشئ العُقد وينفّذ التوليد.

يمكنك القول:

أريد تخطيط فيلم قصير بعنوان «مطاردة على طريق ساحلي» في اللوحة الحرة. اقرأ أولًا أدلة مساحتي الشخصية ودعني أؤكد موضع حفظ اللوحة؛ وبعد التأكيد أنشئ لوحة حرة بالاسم نفسه، وخطّط موجزًا إبداعيًا وتصميم البطل والبطلة ومشهد الطريق الساحلي و4 عُقد صور للوحات القصة وعُقد الفيديو المقابلة، مع ربط علاقات المنبع والمصب. اعرض أولًا بنية اللوحة وخطة توليد العُقد فقط، ولا تولّد فورًا؛ وبعد تأكيدي أرسل واحدة تلو الأخرى، وأخبرني قبل كل إرسال بالنموذج والمعاملات والنقاط المقدّرة.

السيناريو 5: تسليم النتائج إلى الموضع الصحيح

يمكن لمشاريع الفريق تعيين مساحة الفريق والدليل الهدف عند بدء الإبداع. يتحقق المساعد الذكي من المساحة والدليل الحقيقيين أولًا، ثم يولّد ويسلّم النتائج حتى لا تُحفظ المواد في موضع خاطئ.

يمكنك القول:

ولّد بشكل مستقل 3 لوحات قصة لإعلان علامة تجارية خارجي خريفي، بصورة سهب ذهبي وعارضة خارجية وإضاءة سينمائية دافئة، بنسبة 16:9. سلّم النتائج إلى دليل «حملة خريف 2026» في مساحة فريق «الهوية البصرية»، دون إنشاء لوحة حرة. إذا وُجدت عدة مساحات أو أدلة بنفس الاسم، اعرض الخيارات أولًا لأختار، ولا تبدّل من تلقاء نفسك. بعد تأكيد الموضع الهدف، أخبرني بالنموذج وعدد التوليد والنقاط المقدّرة؛ وأرسل التوليد بعد التأكيد فقط.

5. 💗أفضل الممارسات

• قل الهدف الإبداعي أولًا، ولا حاجة للبحث عن الأوامر أولًا صف مباشرة الصورة أو اللقطة أو المشروع الذي تريد إنجازه. يكتشف المساعد الذكي القدرات المتاحة وفق الإصدار الحالي.

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

• وضّح مواصفات الإخراج وموضع الحفظ معًا عدد الصور ونسبتها، ومدة الفيديو ووضوحه، ووجود صوت من عدمه، والمساحة الشخصية أو مساحة الفريق أو اللوحة الحرة، كلها يجب أن تُحدَّد قبل الإرسال.

• راجع النقاط وخطة التنفيذ قبل التوليد قبل توليد الصور والفيديو، يُفضَّل أن يعرض المساعد الذكي النموذج والمعاملات الأساسية والنقاط المقدّرة والرصيد الحالي وموضع الحفظ، وما إذا كان يلزم رفع مواد محلية أو تنزيل النتائج. التقدير لا يثبّت السعر، والخصم النهائي يتبع نتيجة الإرسال.

• واصل انتظار المهام الطويلة، ولا تعِد الإرسال قد يستغرق توليد الفيديو أو إعادة ملء العُقد وقتًا. انتهاء مهلة الانتظار أو عدم تحديث الصفحة لا يعني الفشل؛ واصل فحص المهمة الأصلية. إعادة الإرسال قد تستهلك النقاط مرة أخرى وتنتج نتائج مكررة.

• اعمل على اللوحة الحرة بمنطق «قراءة—تعديل—إعادة قراءة» عند تعديل عُقد أو وصلات في لوحة قائمة، يجب أن يقرأ المساعد الذكي البنية الحالية أولًا، ويكمل تعديلًا واحدًا وفق الخطة المؤكدة، ثم يعيد القراءة للتحقق. يقلل ذلك الكتابة فوق عمل الآخرين أو التوليد على العقدة الخطأ.

6. 🙋ملاحظات ضرورية وأسئلة شائعة

القدرات غير المفتوحة في CLI الحالي

لا تُوثَّق حاليًا قدرات CLI قابلة للاستخدام المباشر لتوليد صوت مستقل، أو مونتاج احترافي معقد، أو النسخ عبر المشاريع، أو تصدير/تصيير خط زمني غير مؤكد للمنصة. حتى إن وُجد مدخل مقابل في الويب، اعتبر القدرات التي يعيدها CLI حاليًا المرجع.

المتصفح صفحة فارغة أو داكنة بعد تسجيل الدخول

عد إلى حوار المساعد الذكي الأصلي وتحقق من حالة تسجيل الدخول. إذا كنت مسجّل الدخول، يمكنك إغلاق الصفحة والمتابعة. إذا لم تكن كذلك، تحقق مما إذا كانت صفحة تسجيل الدخول الدولية ما زالت تنتظر النقر على «Continue to international sign in»، أو تعرض خطأ تهيئة. أبقِ أمر تسجيل الدخول الأصلي قيد التشغيل وأكمل الدخول حسب توجيه الصفحة. لا تحكم بنجاح التفويض من لون الصفحة وحدها، ولا تعِد تشغيل أمر تسجيل الدخول.

اللوحة فيها عُقد بالفعل لكن بلا نتائج مولَّدة

يعني هذا عادة أن بنية اللوحة فقط أُنشئت. اطلب من المساعد الذكي فحص مطالبة كل عقدة والنموذج والمعاملات اللازمة، وعرض النقاط المقدّرة والحصول على التأكيد، ثم إرسال توليد العُقد.

رسالة بلا صلاحية أو الدليل الهدف غير موجود

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