QuickTerminal - الدليل

البدء

1. تشغيل التطبيق — تصل إلى الشاشة الرئيسية التي تعرض جلساتك المحفوظة وزرًا لبدء اتصال جديد.
2. ابدأ صدفة محلية — اضغط على Local Shell لفتح جلسة طرفية على جهازك على الفور.
3. إنشاء جلسة عن بُعد — اضغط على New Session واختر بروتوكولاً (SSH أو Telnet أو Mosh أو Serial أو AWS SSM أو GCP IAP) وأدخل تفاصيل الاتصال.
4. احفظ الجلسة — امنحها اسمًا وعيّنها إلى مجموعة. أعد الاتصال بضغطة واحدة في أي وقت.
5. استكشف لوحة الأوامر — اضغط Ctrl + Shift + P للوصول إلى كل إجراء من قائمة واحدة قابلة للبحث.

نظرة عامة على الواجهة

الشريط الجانبي

ينظّم الشريط الجانبي القابل للطي مساحة عملك:

• Sessions — جميع الجلسات المحفوظة مجمّعة حسب المشروع أو البيئة
• SFTP — افتح متصفح الملفات الرسومي للاتصال النشط
• Snippets — مكتبة الأوامر المحفوظة الخاصة بك
• AI Agent — شغّل لوحة مساعد الذكاء الاصطناعي
• Settings / Help — في أسفل الشريط الجانبي

منطقة الطرفية

تعرض مساحة العمل المركزية:

• الطرفية النشطة مع الإدخال والإخراج الكامل
• شريط علامات التبويب للتبديل بين عدة جلسات مفتوحة
• شريط الحالة في الأسفل يعرض حالة الاتصال والبروتوكول ومؤقت الجلسة
• عرض اللوحة المقسّمة الاختياري لتشغيل عدة طرفيات جنبًا إلى جنب

Command Palette

اضغط Ctrl + Shift + P لفتح لوحة الأوامر. اكتب لتصفية الإجراءات ثم اضغط Enter للتنفيذ. يمكن الوصول إلى كل ميزة في QuickTerminal من خلال اللوحة.

Local Shell

يتضمن QuickTerminal صدفة محلية مدمجة تمامًا لتشغيل الأوامر على جهازك.

• الكشف عن الصدفة — يكتشف ويستخدم تلقائيًا الصدفة الافتراضية لديك (bash أو zsh أو fish أو PowerShell)
• تتبع دليل العمل — يعرض شريط الحالة دائمًا الدليل الحالي
• محفوظات الأوامر — محفوظات دائمة عبر الجلسات، قابلة للبحث باستخدام Ctrl + R
• متغيرات البيئة — يرث ملف تعريف الصدفة وبيئتك تلقائيًا

$ echo "Welcome to QuickTerminal"
Welcome to QuickTerminal
$ ssh user@server.example.com
# Or create a saved session for one-tap reconnection

اتصالات SSH

SSH هو البروتوكول الأساسي للوصول الآمن عن بُعد. يدعم QuickTerminal جميع ميزات SSH الحديثة.

المصادقة

• كلمة المرور — أدخل بيانات الاعتماد وقت الاتصال أو احفظها بأمان في الجلسة
• المصادقة المعتمدة على المفتاح — استخدم مفاتيح RSA أو Ed25519 أو ECDSA. استورد من ملف أو أنشئ أزواج مفاتيح جديدة
• إعادة توجيه الوكيل — أعد توجيه وكيل SSH المحلي إلى المضيف البعيد للوصول السلس عبر عدة قفزات
• تفاعلي عبر لوحة المفاتيح — يدعم المصادقة الثنائية ومطالبات التحدي والاستجابة

إعادة توجيه المنافذ

• إعادة التوجيه المحلي — أنشئ نفقًا لمنفذ بعيد إلى جهازك المحلي
• إعادة التوجيه عن بُعد — اكشف خدمة محلية للمضيف البعيد
• إعادة التوجيه الديناميكي — أنشئ وكيل SOCKS عبر نفق SSH

تكوين الجلسة

# Example session fields
Host:       server.example.com
Port:       22
Username:   deploy
Auth:       Key (Ed25519)
Forwarding: Local 8080 → remote 80

بروتوكولات أخرى

Telnet

قم بتكوين المضيف والمنفذ. اتصالات Telnet غير مشفّرة؛ استخدمها فقط على الشبكات الموثوقة أو للمعدات التي تتطلبها.

Mosh

يتطلب تثبيت خادم Mosh على المضيف البعيد. يتولى QuickTerminal مصافحة SSH الأولية وإعداد جلسة UDP تلقائيًا. مثالي لظروف الشبكة المتنقلة أو غير الموثوقة.

Serial

حدد المنفذ التسلسلي ومعدل الباود (9600، 19200، 38400، 57600، 115200، إلخ) وبتات البيانات وبتات التوقف والتكافؤ والتحكم في التدفق. تعرض الطرفية بيانات تسلسلية خام وتدعم إرسال إشارات الكسر.

AWS SSM

صادق باستخدام بيانات اعتماد AWS أو دور IAM. حدد الحالة المستهدفة بالمعرّف أو الاسم. يستدعي QuickTerminal مكوّن SSM session plugin لإنشاء الاتصال.

GCP IAP

صادق باستخدام حساب Google Cloud الخاص بك. حدد المشروع والمنطقة والحالة. ينفذ QuickTerminal النفق عبر IAP باستخدام أذونات IAM الخاصة بك.

متصفح SFTP

يوفر متصفح SFTP المدمج مدير ملفات رسوميًا لأي مضيف متصل عبر SSH.

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

AI Agents

يساعدك وكلاء AI في QuickTerminal في صياغة الأوامر وتحليل المخرجات وأتمتة المهام.

ما يمكن لوكلاء AI القيام به

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

استخدام لوحة الوكيل

1. افتح لوحة AI Agent من الشريط الجانبي أو اضغط Ctrl + Shift + A.
2. اكتب طلبك بلغة طبيعية.
3. راجع الأمر المقترح أو الشرح.
4. انقر Insert للصق الأمر في الطرفية أو Copy للحافظة.

Snippets

تتيح لك Snippets حفظ الأوامر المستخدمة بكثرة وتنظيمها وإدراجها بسرعة.

إنشاء Snippet

1. افتح لوحة Snippets من الشريط الجانبي.
2. اضغط New Snippet.
3. أدخل الأمر واسمًا ووصفًا اختياريًا.
4. استخدم صيغة ${variable_name} للقوالب المعلّمة.
5. احفظ في مكتبة Snippet الخاصة بك.

متغيرات القالب

# Snippet with variables
$ ssh ${user}@${host} -p ${port:22}
# ${port:22} uses 22 as default if not specified

عند إدراج snippet معلّم، يطلب منك QuickTerminal ملء كل متغير قبل إدراج الأمر النهائي.

تنظيم Snippets

• عيّن tags لتجميع snippets ذات الصلة (مثل deployment وmonitoring وdatabase)
• ابحث في snippets بالاسم أو المحتوى أو الوسم
• ثبّت snippets الأكثر استخدامًا للوصول السريع في أعلى القائمة

Command Palette

لوحة الأوامر هي مشغّل إجراءات شامل يمكن الوصول إليه من أي مكان في QuickTerminal.

• اضغط Ctrl + Shift + P لفتحها
• اكتب لتصفية الإجراءات — المطابقة التقريبية تجد ما تحتاجه بسرعة
• تشمل الإجراءات: إنشاء الجلسات وفتح SFTP وتبديل الإعدادات وتشغيل snippets وغيرها
• تظهر الإجراءات المستخدمة حديثًا في الأعلى للوصول المتكرر السريع

# Example palette actions
New SSH Session
Open SFTP Browser
Insert Snippet...
Toggle Split Pane
Open AI Agent
Manage Execution Policies

Execution Policies

تتيح لك سياسات التنفيذ تحديد قواعد أمان تحمي من الأوامر العرضية أو المدمّرة.

أنواع السياسات

تكوين السياسات

1. انتقل إلى Settings > Execution Policies.
2. اضغط New Policy.
3. حدد النمط — بادئة أمر أو تعبير نمطي أو كلمة مفتاحية للمطابقة.
4. اختر الإجراء (block أو confirm أو sandbox أو log).
5. عيّن النطاق — طبّق على جميع الجلسات أو مجموعات محددة أو جلسات فردية.

الإعدادات

المظهر

• Theme — أوضاع Light وDark مع الكشف عن تفضيلات النظام
• Font family — اختر الخط أحادي المسافة المفضل للطرفية
• Font size — حجم نص الطرفية قابل للتعديل
• Color scheme — اختر من لوحات ألوان الطرفية المدمجة أو استورد لوحات مخصصة

الطرفية

• Scrollback buffer — قم بتكوين عدد أسطر السجل للاحتفاظ بها في الذاكرة
• Cursor style — block أو underline أو bar
• Bell behavior — وميض مرئي أو صوت نظام أو صامت
• Copy on select — انسخ النص المحدد تلقائيًا إلى الحافظة

الاتصالات

• Default SSH port — عيّن منفذًا افتراضيًا مخصصًا لجلسات SSH الجديدة
• Keep-alive interval — أرسل حزمًا دورية لمنع انتهاء مهلة الاتصال
• Reconnect on disconnect — حاول تلقائيًا استعادة الاتصالات المقطوعة

Execution Policies

• إدارة قواعد block وconfirm وsandbox وlog
• تمكين أو تعطيل السياسات لكل مجموعة جلسات

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

نصائح & حيل

استكشاف الأخطاء

الخصوصية

• لا يتطلب QuickTerminal حسابًا أو تسجيل دخول.
• لا يتم جمع بيانات استخدام أو تحليلات أو قياس عن بُعد.
• جميع بيانات الاعتماد مشفّرة باستخدام سلاسل مفاتيح أصلية للمنصة.
• تعمل وكلاء AI بالكامل على الجهاز — لا يتم إرسال بيانات إلى خوادم خارجية.
• يتم تخزين محفوظات الجلسات وsnippets محليًا على جهازك.
• عمليات نقل SFTP مباشرة بين جهازك والمضيف البعيد.
• يعمل التطبيق كليًا دون اتصال بالإنترنت للصدفة المحلية والاتصالات التسلسلية.