البرنامج التعليمي 6: TUI — تجربة طرفية أفضل

مرحبًا بعودتكم إلى سلسلة دروس Hermes Agent! في الدروس السابقة، استكشفنا واجهة سطر الأوامر التقليدية (CLI) وكل الأشياء القوية التي يمكنها القيام بها. اليوم، نرتقي بالمستوى: تعرّفوا على TUI (واجهة المستخدم الطرفية) — الطريقة العصرية والموصى بها لتشغيل Hermes بشكل تفاعلي.

تخيّلوا أن TUI هو نفس وكيل Hermes الذي تعرفونه وتحبونه، لكن بطبقة جديدة كليًا وتحسينات جدية في سهولة الاستخدام. نفس الوكيل، نفس الجلسات، نفس أوامر الشرطة المائلة — فقط سطح أنظف وأكثر استجابة للتفاعل معها.

ما الذي يميز TUI؟

TUI ليس مجرد وجه جميل. إنه يقدّم عدة تحسينات عملية تجعل تجربتك الطرفية أفضل بشكل ملحوظ:

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

تشغيل TUI

البدء بسيط. إليك الطرق الأكثر شيوعًا للتشغيل:

# تشغيل TUI
hermes --tui

# استئناف أحدث جلسة
hermes --tui -c

# استئناف جلسة محددة بالمعرّف أو العنوان
hermes --tui -r 20260409_000000_aa11bb

# استئناف أحدث جلسة لمشروع محدد
hermes --tui --resume latest --in ./my-project

يمكنك أيضًا تفعيله عبر متغير بيئة:

export HERMES_TUI=1
hermes          # يستخدم الآن TUI

أو اجعله الخيار الافتراضي الدائم في ~/.hermes/config.yaml:

display:
  interface: tui   # "cli" (الافتراضي) أو "tui"

نصيحة احترافية: العلامات الصريحة تفوز دائمًا. حتى مع جعل TUI افتراضيًا، يمكنك تشغيل hermes --cli للعودة إلى REPL الكلاسيكي لتشغيل واحد.

أقسام اللافتة القابلة للطي

من أجمل ميزات TUI هي لافتة البدء القابلة للطي. إنها تجمّع معلومات وقت التشغيل في أربعة أقسام، كل قسم بسهم ▸ / ▾:

القسم	الحالة الافتراضية
الأدوات	مفتوح
المهارات	مطوي
موجه النظام	مطوي
خوادم MCP	مطوي

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

اختصارات لوحة المفاتيح وأوامر الشرطة المائلة

خبر جيد: جميع اختصارات لوحة المفاتيح مطابقة تمامًا لـ CLI الكلاسيكي. بعض الاختلافات السلوكية الجديرة بالملاحظة:

سحب الفأرة يميّز النص بخلفية تحديد موحّدة
Cmd+V / Ctrl+V يحاول لصق النص أولًا، ثم يتراجع إلى قراءة الحافظة، وأخيرًا إرفاق الصور
Ctrl+X يفتح محوّل الجلسات المباشر
Ctrl+G يفتح مخزن الإدخال الحالي في $EDITOR لتركيب الطلبات الطويلة

جميع أوامر الشرطة المائلة تعمل دون تغيير. بعضها يظهر كتراكبات أغنى في TUI — مثل /help، الذي يعرض لوحة أوامر مصنّفة.

المتطلبات

قبل أن تغوص في التجربة، تأكد من أن لديك:

Node.js ≥ 20 (يعمل TUI كعملية فرعية تُطلق من CLI الخاص بـ Python)
TTY — مثل CLI الكلاسيكي، البيئات غير التفاعلية تتراجع إلى وضع الاستعلام الفردي

عند أول تشغيل، يثبّت Hermes تبعيات Node الخاصة بـ TUI (مرة واحدة، تستغرق بضع ثوانٍ). التشغيلات اللاحقة سريعة.

نفس المظاهر، نفس الشخصيات

يحترم TUI نفس المظاهر والشخصيات مثل CLI الكلاسيكي. بدّل في منتصف الجلسة بـ /skin ares أو /personality pirate، وستُعاد رسم الواجهة مباشرة. يحترم TUI لوحة ألوان اللافتة، وألوان الواجهة، ورمز الموجه، وعرض الجلسة، وقائمة الإكمال، والمزيد.

TUI هو الطريقة الموصى بها لتشغيل Hermes تفاعليًا — والآن تعرفون السبب. جرّبوه مع hermes --tui واختبروا الفرق بأنفسكم. في درسنا القادم، سنستكشف ميزات أكثر تقدمًا. كتابة موفقة!