# គោលគំនិត

cmux រៀបចំទែមីណលរបស់អ្នកក្នុងឋានានុក្រមបួនកម្រិត។ ការយល់ដឹងពីកម្រិតទាំងនេះជួយនៅពេលប្រើ socket API, CLI, និងផ្លូវកាត់ក្ដារចុច។

## ឋានានុក្រម

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

### បង្អួច

បង្អួច macOS។ បើកបង្អួចជាច្រើនជាមួយ ⌘⇧N។ បង្អួចនីមួយៗមានរបារចំហៀងផ្ទាល់ខ្លួនជាមួយ workspace ឯករាជ្យ។

### Workspace

ធាតុរបារចំហៀង។ workspace នីមួយៗមានបន្ទះបំបែកមួយ ឬច្រើន។ Workspace គឺជាអ្វីដែលអ្នកឃើញរាយក្នុងរបារចំហៀងឆ្វេង។

ក្នុង UI និងផ្លូវកាត់ក្ដារចុច, workspace ជារឿយៗត្រូវបានហៅថា "ផ្ទាំង" ព្រោះវាប្រព្រឹត្តដូចផ្ទាំងក្នុងរបារចំហៀង។ Socket API និងអថេរបរិស្ថានប្រើពាក្យ "workspace"។

| បរិបទ | ពាក្យដែលប្រើ |
| --- | --- |
| UI របារចំហៀង | ផ្ទាំង |
| ផ្លូវកាត់ក្ដារចុច | Workspace ឬផ្ទាំង |
| Socket API | `workspace` |
| អថេរបរិស្ថាន | `CMUX_WORKSPACE_ID` |

**ផ្លូវកាត់: ⌘N (ថ្មី), ⌘1–⌘9 (លោត), ⌘⇧W (បិទ), ⌃⌘\[ / ⌃⌘\] (មុន/បន្ទាប់)**

### បន្ទះ

តំបន់បំបែកក្នុង workspace។ បង្កើតដោយបំបែកជាមួយ ⌘D (ស្ដាំ) ឬ ⌘⇧D (ក្រោម)។ រុករករវាងបន្ទះជាមួយ ⌥⌘ + គ្រាប់ចុចទិសដៅ។

បន្ទះនីមួយៗអាចមាន surface ជាច្រើន (ផ្ទាំងក្នុងបន្ទះ)។

### Surface

ផ្ទាំងក្នុងបន្ទះ។ បន្ទះនីមួយៗមានរបារផ្ទាំងផ្ទាល់ខ្លួន ហើយអាចមាន surface ជាច្រើន។ បង្កើតជាមួយ ⌘T, រុករកជាមួយ ⌘\[ / ⌘\] ឬ ⌃1–⌃9។

Surface គឺជាវគ្គទែមីណល ឬកម្មវិធីរុករកម្នាក់ៗដែលអ្នកធ្វើអន្តរកម្មជាមួយ។ Surface នីមួយៗមានអថេរបរិស្ថាន CMUX\_SURFACE\_ID ផ្ទាល់ខ្លួន។

### Panel

មាតិកានៅក្នុង surface។ បច្ចុប្បន្នមានពីរប្រភេទ:

-   **ទែមីណល: វគ្គទែមីណល Ghostty**
-   **កម្មវិធីរុករក: web view ដែលបង្កប់**

Panel ភាគច្រើនជាគោលគំនិតខាងក្នុង។ នៅក្នុង socket API និង CLI, អ្នកធ្វើអន្តរកម្មជាមួយ surface ជាជាង panel ដោយផ្ទាល់។

## ក្រុមកន្លែងធ្វើការ

ដាក់ជាក្រុមនូវកន្លែងធ្វើការដែលពាក់ព័ន្ធគ្នាទៅជាផ្នែកមានឈ្មោះដែលអាចបង្រួមបានក្នុងរបារចំហៀង។ ក្រុមនីមួយៗត្រូវបានកាន់កាប់ដោយកន្លែងធ្វើការយុថ្កា ហើយអាចត្រូវបានខ្ទាស់ ប្ដូរឈ្មោះ និងផ្ដល់រូបតំណាង និងពណ៌ផ្ទាល់ខ្លួន។ កន្លែងធ្វើការថ្មីអាចត្រូវបានបង្កើតដោយផ្ទាល់នៅក្នុងក្រុមមួយ ចេញពីក្បាលក្រុមរបស់វា។

[អានមគ្គុទ្ទេសក៍ក្រុមកន្លែងធ្វើការពេញលេញ](https://cmux.com/km/docs/workspace-groups)

## ឧទាហរណ៍ដែលមើលឃើញ

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

ក្នុងឧទាហរណ៍នេះ:

-   បង្អួចមានរបារចំហៀងជាមួយ workspace បី (dev, server, logs)
-   Workspace "dev" ត្រូវបានជ្រើសរើស, បង្ហាញបន្ទះពីរនៅជាប់គ្នា
-   បន្ទះ 1 មាន surface ពីរ (\[S1\] និង \[S2\] ក្នុងរបារផ្ទាំង), ជាមួយ S1 កំពុងដំណើរការ
-   បន្ទះ 2 មាន surface មួយ
-   Surface នីមួយៗមាន panel (ទែមីណលក្នុងករណីនេះ)

## សង្ខេប

| កម្រិត | អ្វីដែលវាជា | បង្កើតដោយ | កំណត់អត្តសញ្ញាណដោយ |
| --- | --- | --- | --- |
| បង្អួច | បង្អួច macOS | `⌘⇧N` | — |
| Workspace | ធាតុរបារចំហៀង | `⌘N` | `CMUX_WORKSPACE_ID` |
| បន្ទះ | តំបន់បំបែក | `⌘D` / `⌘⇧D` | Pane ID (socket API) |
| Surface | ផ្ទាំងក្នុងបន្ទះ | `⌘T` | `CMUX_SURFACE_ID` |
| Panel | ទែមីណល ឬកម្មវិធីរុករក | ស្វ័យប្រវត្តិ | Panel ID (ខាងក្នុង) |

Canonical: https://cmux.com/km/docs/concepts

Documentation index: https://cmux.com/llms.txt