المفاهيم

ينظم cmux طرفياتك في تسلسل هرمي من أربعة مستويات. فهم هذه المستويات يساعد عند استخدام واجهة المقابس وواجهة الأوامر واختصارات لوحة المفاتيح.

التسلسل الهرمي

Window
  └── Workspace (sidebar entry)
        └── Pane (split region)
              └── Surface (tab within pane)
                    └── Panel (terminal or browser content)

النافذة

نافذة macOS. افتح نوافذ متعددة باستخدام ⌘⇧N. كل نافذة لها شريطها الجانبي الخاص بمساحات عمل مستقلة.

مساحة العمل

عنصر في الشريط الجانبي. كل مساحة عمل تحتوي على لوح واحد أو أكثر من الألواح المقسمة. مساحات العمل هي ما تراه مدرجاً في الشريط الجانبي الأيسر.

في واجهة المستخدم واختصارات لوحة المفاتيح، غالباً ما تُسمى مساحات العمل "علامات تبويب" لأنها تتصرف كعلامات تبويب في الشريط الجانبي. تستخدم واجهة المقابس ومتغيرات البيئة مصطلح "مساحة العمل".

الاختصارات: ⌘N (جديد)، ⌘1–⌘9 (انتقال)، ⌘⇧W (إغلاق)، ⌃⌘[ / ⌃⌘] (السابق/التالي)

اللوح

منطقة مقسمة داخل مساحة العمل. يُنشأ بالتقسيم باستخدام ⌘D (يمين) أو ⌘⇧D (أسفل). تنقل بين الألواح بـ ⌥⌘ + مفاتيح الأسهم.

كل لوح يمكنه احتواء عدة أسطح (علامات تبويب داخل اللوح).

السطح

علامة تبويب داخل لوح. كل لوح له شريط علامات تبويب خاص ويمكنه احتواء عدة أسطح. يُنشأ بـ ⌘T، يُتنقل بـ ⌘[ / ⌘] أو ⌃1–⌃9.

الأسطح هي جلسات الطرفية أو المتصفح الفردية التي تتفاعل معها. كل سطح له متغير بيئة CMUX_SURFACE_ID خاص.

اللوحة

المحتوى داخل السطح. حالياً نوعان:

• طرفية: جلسة طرفية Ghostty
• متصفح: عرض ويب مدمج

اللوحة هي مفهوم داخلي في الغالب. في واجهة المقابس وواجهة الأوامر، تتفاعل مع الأسطح وليس مع اللوحات مباشرة.

مثال بصري

┌──────────────────────────────────────────────────────┐
│ ┌──────────┐ ┌─────────────────────────────────────┐ │
│ │ Sidebar  │ │ Workspace "dev"                     │ │
│ │          │ │                                     │ │
│ │          │ │ ┌───────────────┬─────────────────┐ │ │
│ │ > dev    │ │ │ Pane 1        │ Pane 2          │ │ │
│ │   server │ │ │ [S1] [S2]     │ [S1]            │ │ │
│ │   logs   │ │ │               │                 │ │ │
│ │          │ │ │  Terminal     │  Terminal       │ │ │
│ │          │ │ │               │                 │ │ │
│ │          │ │ └───────────────┴─────────────────┘ │ │
│ └──────────┘ └─────────────────────────────────────┘ │
└──────────────────────────────────────────────────────┘

في هذا المثال:

• تحتوي النافذة على شريط جانبي بثلاث مساحات عمل (dev, server, logs)
• مساحة العمل "dev" محددة، تعرض لوحين جنباً إلى جنب
• اللوح 1 له سطحان ([S1] و[S2] في شريط علامات التبويب)، مع S1 نشط
• اللوح 2 له سطح واحد
• كل سطح يحتوي على لوحة (طرفية في هذه الحالة)

ملخص