سطر الأوامر (CLI)

استخدم PRX مباشرة من الطرفية عبر stdin/stdout لإجراء محادثات تفاعلية بدون أي اعتماد على خدمات خارجية.

المتطلبات المسبقة

• تثبيت PRX وتهيئته مع مزود LLM واحد على الأقل
• طرفية تدعم stdin/stdout

الإعداد السريع

1. التهيئة

قناة CLI مفعّلة افتراضيًا. لا تحتاج إلى إعداد إضافي.

[channels_config]
cli = true  # default, can be omitted

2. التشغيل

prx

سيبدأ PRX في الوضع التفاعلي، ويقرأ من stdin ويكتب الردود إلى stdout.

3. الاستخدام

اكتب رسالتك واضغط Enter. الأوامر الخاصة:

> Hello, how are you?
[PRX responds...]

> /quit    # Exit the session
> /exit    # Exit the session (alternative)

مرجع الإعدادات

الحقل	النوع	الافتراضي	الوصف
cli	bool	true	تفعيل أو تعطيل قناة CLI التفاعلية

الميزات

• بدون اعتماديات إضافية -- لا حاجة لحسابات خارجية أو tokens أو APIs خارج مزود LLM
• متاحة دائمًا -- مفعّلة افتراضيًا وتعمل مباشرة بعد التثبيت
• واجهة stdin/stdout -- إدخال/إخراج Unix قياسي لسهولة السكربتات وعمليات pipe
• تجاهل الأسطر الفارغة -- يتم تجاهل الأسطر الفارغة بصمت
• خروج سلس -- اكتب /quit أو /exit لإنهاء الجلسة بشكل نظيف
• وصول كامل للأدوات -- كل الأدوات المهيأة (shell وfile وbrowser وmemory وغيرها) متاحة

القيود

• مستخدم واحد وجلسة واحدة فقط
• لا يوجد سجل محادثة دائم بين الجلسات (إلا إذا فُعّلت استمرارية الجلسة عالميًا)
• لا يوجد دعم للوسائط أو مرفقات الملفات (إدخال نصي فقط)
• لا يوجد خرج تدريجي/متدفق (تُطبع الردود كاملة بعد التوليد)
• لا يمكن التشغيل بالتوازي مع قنوات أخرى في نفس العملية إلا إذا تم ضبط ذلك صراحة

استكشاف الأخطاء وإصلاحها

PRX لا يبدأ في وضع CLI

• تأكد أن cli = true (أو احذف السطر لأنه افتراضيًا true) ضمن [channels_config]
• إذا كانت قنوات أخرى مهيأة، قد يعطيها PRX أولوية؛ افحص سجلات الإقلاع
• تأكد من تهيئة مزود LLM واحد على الأقل

الإدخال لا يُعالج

• تأكد أنك تكتب في الطرفية التي يعمل فيها PRX (وليس عملية بالخلفية)
• يتم تجاهل الأسطر الفارغة؛ اكتب رسالة غير فارغة
• تأكد أن stdin متصل (وليس معاد توجيهه من /dev/null)

كيفية استخدام CLI مع pipes

• يقرأ PRX من stdin سطرًا بسطر، لذا يمكنك تمرير الإدخال عبر pipe:

  echo "What is 2 + 2?" | prx

• للمحادثات متعددة الأدوار عبر السكربتات، استخدم FIFO أو نهجًا مبنيًا على expect