قناة CLI

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

التصنيف

تصنيف قناة CLI الافتراضي هو INTERNAL. مستخدم الطرفية يُعامل دائماً كمالك -- لا يوجد إجراء إقران أو مصادقة لأنك تشغّل العملية مباشرة على جهازك.

لماذا INTERNAL؟ قناة CLI هي واجهة مباشرة ومحلية. فقط شخص لديه

وصول إلى طرفيتك يمكنه استخدامها. هذا يجعل INTERNAL هو الافتراضي المناسب -- وكيلك يمكنه مشاركة البيانات الداخلية بحرية في هذا السياق. :::

الميزات

إدخال الطرفية الخام

يستخدم CLI وضع الطرفية الخام مع تحليل كامل لتسلسلات ANSI. هذا يمنحك تجربة تحرير غنية مباشرة في طرفيتك:

• تحرير السطر -- التنقل بمفاتيح الأسهم، Home/End، حذف الكلمات بـ Ctrl+W
• سجل الإدخال -- اضغط أعلى/أسفل للتنقل بين المدخلات السابقة
• اقتراحات -- إكمال بمفتاح Tab للأوامر الشائعة
• إدخال متعدد الأسطر -- إدخال نصوص أطول بشكل طبيعي

عرض الأدوات المختصر

عندما يستدعي الوكيل أدوات، يعرض CLI ملخصاً مختصراً في سطر واحد افتراضياً:

tool_name arg  result

التبديل بين العرض المختصر والموسّع للأدوات بـ Ctrl+O.

مقاطعة العمليات الجارية

اضغط ESC لمقاطعة العملية الحالية. يرسل هذا إشارة إلغاء عبر المنسّق إلى مزوّد LLM، مما يوقف التوليد فوراً. لا تحتاج الانتظار حتى ينتهي رد طويل.

عرض التلوث

يمكنك اختيارياً عرض مستوى تلوث الجلسة الحالي في المخرجات من خلال تمكين showTaint في تكوين قناة CLI. يضيف هذا مستوى التصنيف قبل كل رد:

[CONFIDENTIAL] Here are your Q4 pipeline numbers...

شريط تقدم طول السياق

يعرض CLI شريط استخدام نافذة السياق في الوقت الفعلي في سطر الفاصل في أسفل الطرفية:

[████████████░░░░░░░░] 62% ctx  MCP 3/3

• يمتلئ الشريط مع استهلاك رموز السياق
• يظهر مؤشر أزرق عند عتبة 70% (حيث يبدأ الضغط التلقائي)
• يتحول الشريط إلى اللون الأحمر عند الاقتراب من الحد
• بعد الضغط (/compact أو تلقائي)، يُعاد ضبط الشريط

حالة خادم MCP

يعرض الفاصل أيضاً حالة اتصال خوادم MCP:

العرض	المعنى
MCP 3/3 (أخضر)	جميع الخوادم المُعدّة متصلة
MCP 2/3 (أصفر)	بعض الخوادم لا تزال تتصل أو فشلت
MCP 0/3 (أحمر)	لا توجد خوادم متصلة

تتصل خوادم MCP بشكل كسول في الخلفية بعد بدء التشغيل. تتحدث الحالة في الوقت الفعلي مع اتصال الخوادم.

سجل الإدخال

يتم حفظ سجل الإدخال عبر الجلسات في:

~/.triggerfish/data/input_history.json

يُحمّل السجل عند بدء التشغيل ويُحفظ بعد كل إدخال. يمكنك مسحه بحذف الملف.

إدخال غير TTY / موجّه

عندما لا يكون stdin طرفية (مثلاً، عند توجيه الإدخال من عملية أخرى)، ينتقل CLI تلقائياً إلى وضع التخزين المؤقت بالسطر. في هذا الوضع:

• ميزات الطرفية الخام (مفاتيح الأسهم، تنقل السجل) معطلة
• يُقرأ الإدخال سطراً بسطر من stdin
• يُكتب الإخراج إلى stdout بدون تنسيق ANSI

يتيح لك هذا كتابة سكربتات للتفاعل مع وكيلك:

echo "What is the weather today?" | triggerfish run

التكوين

تتطلب قناة CLI تكويناً بسيطاً. يتم إنشاؤها تلقائياً عند تشغيل triggerfish run أو استخدام REPL التفاعلي.

channels:
  cli:
    interactive: true
    showTaint: false

الخيار	النوع	الافتراضي	الوصف
interactive	boolean	true	تمكين وضع REPL التفاعلي
showTaint	boolean	false	عرض مستوى تلوث الجلسة في المخرجات

لا يحتاج إعداد تعمل قناة CLI مباشرة. لا تحتاج

تكوين أي شيء لبدء استخدام Triggerfish من طرفيتك. :::

اختصارات لوحة المفاتيح

الاختصار	الإجراء
Enter	إرسال الرسالة
أعلى/أسفل	التنقل في سجل الإدخال
Ctrl+V	لصق صورة من الحافظة (ترسل كمحتوى متعدد الوسائط)
Ctrl+O	التبديل بين عرض الأدوات المختصر/الموسّع
ESC	مقاطعة العملية الحالية
Ctrl+C	الخروج من CLI
Ctrl+W	حذف الكلمة السابقة
Home / End	الانتقال إلى بداية/نهاية السطر