Waveterm

طرفية مفتوحة المصدر مدمجة مع الذكاء الاصطناعي مع جلسات مستمرة ورسومات مضمنة وإدارة الاتصالات عن بُعد.

التثبيت

التثبيت حسب المنصة

الأمر	الوصف
`brew install --cask wave`	التثبيت على macOS باستخدام Homebrew
التنزيل من `waveterm.dev`	التثبيت من الموقع الرسمي
تنزيل `.deb` أو `.rpm` من الإصدارات	التثبيت على Linux
تنزيل مثبت `.exe` من الإصدارات	التثبيت على Windows
`wsh version`	عرض إصدار CLI Wave
`wsh help`	عرض أوامر wsh المتاحة

الاستخدام الأساسي

إدارة التبويبات والنوافذ

الأمر	الوصف
`Cmd/Ctrl + N`	فتح تبويب طرفية جديد
`Cmd/Ctrl + T`	فتح تبويب مساحة عمل جديد
`Cmd/Ctrl + W`	إغلاق التبويب الحالي
`Cmd/Ctrl + Shift + N`	فتح نافذة جديدة
`Cmd/Ctrl + 1-9`	التبديل إلى تبويب حسب الرقم
`Cmd/Ctrl + Shift + ]`	التبويب التالي
`Cmd/Ctrl + Shift + [`	التبويب السابق
`Cmd/Ctrl + Shift + T`	إعادة فتح آخر تبويب مغلق

إدارة الكتل والألواح

الأمر	الوصف
`Cmd/Ctrl + Shift + D`	تقسيم الطرفية أفقياً
`Cmd/Ctrl + D`	تقسيم الطرفية عمودياً
النقر وسحب حدود الكتل	تغيير حجم ألواح الطرفية
`Alt + مفاتيح الأسهم`	التنقل بين الكتل
`Cmd/Ctrl + Enter`	تكبير/استعادة الكتلة الحالية
`Cmd/Ctrl + Shift + P`	فتح لوحة الأوامر
`Cmd/Ctrl + Backspace`	إغلاق الكتلة الحالية

ميزات الذكاء الاصطناعي

دردشة الذكاء الاصطناعي

الأمر	الوصف
`Cmd/Ctrl + Space`	فتح دردشة AI في الكتلة الحالية
كتابة سؤال في دردشة AI	سؤال AI عن الأوامر أو الكود
`/explain` في دردشة AI	شرح مخرجات الأمر السابق
`/fix` في دردشة AI	اقتراح إصلاح لآخر خطأ
`/summarize` في دردشة AI	تلخيص المخرجات الطويلة
النقر على “Apply” في اقتراح AI	إدراج الأمر المقترح في الطرفية
`Esc`	إغلاق لوحة دردشة AI

تكوين مزود الذكاء الاصطناعي

الأمر	الوصف
تكوين نموذج AI في الإعدادات	الاختيار بين OpenAI وAnthropic والنماذج المحلية
تعيين `ai:preset` في التكوين	التبديل بين مزودي AI
تعيين `ai:apitoken` في التكوين	تكوين مفتاح API لمزود AI
تعيين `ai:model` في التكوين	تحديد اسم النموذج (مثل gpt-4، claude-3)
تعيين `ai:baseurl` في التكوين	الإشارة إلى نقطة نهاية API مخصصة/محلية
تعيين `ai:maxtokens` في التكوين	تعيين الحد الأقصى لرموز الاستجابة

مثال على تكوين الذكاء الاصطناعي

{
  "ai:preset": "custom",
  "ai:apitoken": "sk-...",
  "ai:baseurl": "https://api.openai.com/v1",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

للنماذج المحلية باستخدام Ollama:

{
  "ai:preset": "custom",
  "ai:baseurl": "http://localhost:11434/v1",
  "ai:model": "llama3",
  "ai:maxtokens": 4096
}

اتصالات SSH

عمليات SSH

الأمر	الوصف
`wsh ssh user@hostname`	الاتصال بالمضيف البعيد عبر SSH
`wsh ssh user@host -i ~/.ssh/key`	SSH بمفتاح هوية محدد
`wsh ssh -p 2222 user@host`	SSH على منفذ مخصص
النقر على ”+” ثم “SSH Connection”	إنشاء اتصال SSH من الواجهة
الاتصالات تستمر عبر الجلسات	الجلسات تنجو من إعادة تشغيل التطبيق
`wsh ssh-import`	استيراد اتصالات من تكوين SSH
تكوين إدخالات `~/.ssh/config`	اكتشاف مضيفي SSH تلقائياً
النقر بزر الماوس الأيمن على الاتصال ثم إعادة الاتصال	إعادة اتصال جلسة SSH المنقطعة

تكامل SSH Config

يقرأ Wave تكوين SSH الخاص بك لاكتشاف المضيفين. قم بتكوين الإدخالات لاتصالات سلسة:

Host prod-web
    HostName 10.0.1.50
    User deploy
    IdentityFile ~/.ssh/deploy_key
    Port 22

Host staging-*
    HostName %h.staging.example.com
    User admin
    IdentityFile ~/.ssh/staging_key
    ForwardAgent yes

Host jump-box
    HostName bastion.example.com
    User ops
    IdentityFile ~/.ssh/ops_key

Host internal-*
    ProxyJump jump-box
    User admin
    IdentityFile ~/.ssh/internal_key

تصفح الملفات عن بُعد

الأمر	الوصف
`wsh view remote:file.txt`	عرض ملف على المضيف البعيد
`wsh edit remote:file.txt`	تحرير ملف على المضيف البعيد مباشرة
`wsh view remote:/var/log/syslog`	عرض ملف سجل بعيد
`wsh run --remote user@host -- command`	تنفيذ أمر على المضيف البعيد في كتلة جديدة

الأدوات والكتل

عرض الملفات والمحتوى

الأمر	الوصف
`wsh view file.png`	عرض صورة مضمنة في الطرفية
`wsh view file.jpg`	عرض صورة JPEG مضمنة
`wsh view file.svg`	عرض رسم SVG مضمن
`wsh view file.md`	عرض markdown مضمن
`wsh view file.csv`	عرض CSV كجدول
`wsh view file.json`	عرض JSON مع تلوين الصياغة
`wsh view file.pdf`	معاينة مستند PDF
`wsh view https://example.com`	تضمين صفحة ويب في كتلة

عمليات الكتل

الأمر	الوصف
`wsh edit file.txt`	فتح ملف في المحرر المضمن
`wsh edit --lang=python script.py`	فتح محرر بوضع اللغة
`wsh getmeta`	الحصول على بيانات الكتلة الوصفية الحالية
`wsh setmeta key=value`	تعيين بيانات الكتلة الوصفية
`wsh run -- command args`	تنفيذ أمر في كتلة جديدة
`wsh run --magnify -- htop`	تنفيذ أمر في كتلة مكبرة
`wsh createblock`	إنشاء كتلة فارغة
`wsh createblock --tabid=tab1`	إنشاء كتلة في تبويب محدد

أنماط استخدام الأدوات

الأمر	الوصف
`wsh view --magnify file.png`	عرض صورة في كتلة مكبرة
`wsh view --height=20 file.csv`	عرض بارتفاع كتلة محدد
سحب وإفلات الملفات على Wave	عرض الملفات مباشرة
`wsh view .`	تصفح الدليل الحالي
`wsh view ~/projects`	تصفح دليل محدد

التخصيص

إعدادات المظهر

الأمر	الوصف
فتح الإعدادات ثم المظهر	تغيير السمة والألوان
فتح الإعدادات ثم الطرفية	تكوين الخط والحجم والمؤشر
تعيين `term:fontsize` في التكوين	تعيين حجم خط الطرفية
تعيين `term:fontfamily` في التكوين	تعيين عائلة خط الطرفية
تعيين `term:theme` في التكوين	تعيين سمة ألوان الطرفية
تعيين `term:cursorstyle` في التكوين	تعيين نمط المؤشر (block، bar، underline)
تعيين `window:transparent` في التكوين	تفعيل شفافية النافذة
تعيين `window:blur` في التكوين	تفعيل ضبابية الخلفية
تعيين `window:opacity` في التكوين	تعيين مستوى شفافية النافذة
تعيين `telemetry:enabled = false`	تعطيل القياس عن بُعد

تكوين مظهر الطرفية

{
  "term:fontsize": 14,
  "term:fontfamily": "JetBrains Mono, Menlo, monospace",
  "term:theme": "dracula",
  "term:cursorstyle": "bar",
  "term:scrollback": 10000,
  "window:transparent": true,
  "window:blur": true,
  "window:opacity": 0.92
}

تكوين سمة مخصصة

{
  "term:theme": "custom",
  "term:localtheme": {
    "black": "#282a36",
    "red": "#ff5555",
    "green": "#50fa7b",
    "yellow": "#f1fa8c",
    "blue": "#bd93f9",
    "magenta": "#ff79c6",
    "cyan": "#8be9fd",
    "white": "#f8f8f2",
    "brightBlack": "#6272a4",
    "brightRed": "#ff6e6e",
    "brightGreen": "#69ff94",
    "brightYellow": "#ffffa5",
    "brightBlue": "#d6acff",
    "brightMagenta": "#ff92df",
    "brightCyan": "#a4ffff",
    "brightWhite": "#ffffff",
    "background": "#282a36",
    "foreground": "#f8f8f2",
    "cursor": "#f8f8f2",
    "selectionBackground": "#44475a"
  }
}

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

التنقل

الأمر	الوصف
`Cmd/Ctrl + Shift + P`	لوحة الأوامر
`Cmd/Ctrl + L`	مسح الطرفية
`Cmd/Ctrl + Shift + E`	تبديل الشريط الجانبي
`Cmd/Ctrl + K`	التركيز على البحث
`Cmd/Ctrl + Shift + F`	البحث الشامل
`Alt + مفاتيح الأسهم`	التنقل بين الكتل
`Cmd/Ctrl + Enter`	تكبير/استعادة الكتلة الحالية
`Cmd/Ctrl + ,`	فتح الإعدادات

التحرير والحافظة

الأمر	الوصف
`Cmd/Ctrl + Shift + C`	النسخ من الطرفية
`Cmd/Ctrl + Shift + V`	اللصق في الطرفية
`Cmd/Ctrl + A`	تحديد الكل في الكتلة
`Cmd/Ctrl + F`	البحث في الكتلة الحالية
`Shift + Page Up`	التمرير لأعلى في الطرفية
`Shift + Page Down`	التمرير لأسفل في الطرفية
`Cmd/Ctrl + Home`	التمرير إلى أعلى المخزن المؤقت
`Cmd/Ctrl + End`	التمرير إلى أسفل المخزن المؤقت

إدارة الكتل

الأمر	الوصف
`Cmd/Ctrl + D`	تقسيم عمودي
`Cmd/Ctrl + Shift + D`	تقسيم أفقي
`Cmd/Ctrl + Backspace`	إغلاق الكتلة الحالية
`Cmd/Ctrl + Enter`	تبديل تكبير الكتلة
`Alt + أعلى/أسفل/يسار/يمين`	نقل التركيز بين الكتل
`Cmd/Ctrl + Shift + سهم`	تغيير حجم الكتلة الحالية

التكوين

إدارة التكوين

الأمر	الوصف
`wsh getvar key`	الحصول على متغير التكوين
`wsh setvar key=value`	تعيين متغير التكوين
`wsh getvar --all`	عرض جميع متغيرات التكوين
التكوين مخزن في `~/.waveterm/`	دليل التكوين الافتراضي
تعيين `autoupdate:enabled` في التكوين	تفعيل/تعطيل التحديثات التلقائية
تعيين `conn:askbeforewshinstall` في التكوين	السؤال قبل تثبيت wsh على الجهاز البعيد
تعيين `editor:minimap` في التكوين	تبديل الخريطة المصغرة في المحرر المضمن
تعيين `web:openlinksinternally` في التكوين	فتح الروابط في كتلة متصفح Wave

مثال تكوين كامل

{
  "term:fontsize": 13,
  "term:fontfamily": "Fira Code, monospace",
  "term:theme": "one-dark",
  "term:cursorstyle": "block",
  "term:scrollback": 5000,
  "window:transparent": false,
  "window:blur": false,
  "telemetry:enabled": false,
  "autoupdate:enabled": true,
  "conn:askbeforewshinstall": true,
  "editor:minimap": false,
  "web:openlinksinternally": true,
  "ai:preset": "openai",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

متغيرات البيئة

الأمر	الوصف
`WAVETERM_HOME=~/.waveterm`	تجاوز دليل تكوين Wave
`WAVETERM_DEV=1`	تفعيل وضع التطوير
`TERM_PROGRAM=waveterm`	يتم تعيينه تلقائياً في جلسات Wave
`WAVETERM_BLOCKID`	معرف الكتلة الحالية (يتم تعيينه لكل كتلة)
`WAVETERM_TABID`	معرف التبويب الحالي (يتم تعيينه لكل تبويب)

إدارة مساحات العمل

مساحات العمل

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

استمرار الجلسة

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

أفضل الممارسات

استخدام الكتل لتعدد المهام — قسّم طرفيتك إلى كتل لمراقبة السجلات وتشغيل عمليات البناء وتحرير الكود جنباً إلى جنب.
الاستفادة من AI للأوامر غير المألوفة — اضغط Cmd/Ctrl + Space لسؤال مساعد AI عن الصياغة أو الخيارات أو استكشاف الأخطاء.
تكوين SSH config للوصول السريع — أضف جميع خوادمك إلى ~/.ssh/config حتى يكتشفها Wave تلقائياً في قائمة الاتصالات.
استخدام العارضات المضمنة للفحص السريع — wsh view يتيح لك معاينة الصور وملفات CSV وmarkdown دون مغادرة الطرفية.
تثبيت الكتل المهمة — كبّر الكتل المهمة بـ Cmd/Ctrl + Enter عند التركيز على مهمة، ثم استعد التخطيط عند الانتهاء.
تعطيل القياس عن بُعد إذا فضّلت — عيّن telemetry:enabled إلى false في تكوينك للخصوصية.
استخدام مساحات العمل للمشاريع — أنشئ مساحات عمل منفصلة لمشاريع مختلفة للحفاظ على تنظيم السياق.
استخدام لاحقة -dev لتكوين نموذج AI — وجّه ai:baseurl إلى مثيل Ollama أو LM Studio محلي للحصول على مساعدة AI خاصة وبدون اتصال.
تعلّم اختصارات الكتل — Alt + سهم للتنقل وCmd/Ctrl + Shift + D للتقسيم هما الاختصارات الأكثر استخداماً.
تخصيص السمة الخاصة بك — أعدّ سمة ألوان مخصصة باستخدام term:localtheme لتتوافق مع ألوان محررك المفضل لتجربة متسقة.