نصيحة ممتازة لأمر fg : عندما ينقذ Ctrl+Z جلسة الطرفية الخاصة بك

$ ./gradlew build
> Building...

@startuml
skinparam backgroundColor #FEFEFE

actor Développeur as dev
participant "الطرفيه" as term
participant "Gradle\n( عملية )" as gradle

dev -> term : ./gradlew بناء
term -> gradle : نفّذ البناء
gradle -> term : يشغل الطرفية\n(بدون موجه)
dev -> term : يريد كتابة أمر
term --> dev : الطرفية محجوبة

note right of dev
المطور مشلول طوال مدة البناء
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
autonumber

actor Développeur as dev
participant "الطرافية" as term
participant "Gradle" as gradle
database "الحالة\nالعملية" as state

dev -> term : ./gradlew بناء
term -> gradle : تشغيل البِيلد
gradle -> state : قيد التنفيذ (FG)
dev -> term : Ctrl+Z
term -> state : معلق (وظيفة [1])
term --> dev : طلبٌ مفتوح $

dev -> term : حالة git
term --> dev : شجرة العمل نظيفة

dev -> term : فج
term -> state : استأنف (FG)
gradle --> dev : تم البناء بنجاح ✓

note right of state
العملية Gradle
لم يُقتل قط
تستأنف exactamente
حيث توقفت
end note
@enduml

# Dans vim, en mode commande :
:shell
$ cat /path/to/other/file.txt
$ exit
# Retour dans vim

# Dans vim, n'importe quel moment :
Ctrl+Z
[1]+  Stoppé    vim README.md

$ cat /path/to/other/file.txt
# ... lire le fichier ...

$ fg
vim README.md
# Retour exact là où on en était, curseur en place

@startuml
skinparam backgroundColor #FEFEFE
autonumber

actor Développeur as dev
participant "vim" as vim
participant "قشرة" as shell

dev -> vim : جارٍ التحرير
dev -> vim : Ctrl+ز
vim -> shell : معلق (عمل [1])
dev -> shell : قطة autre_fichier.txt
shell --> dev : محتوى الملف
dev -> shell : fg
shell -> vim : استأنف (job [1])
vim --> dev : المؤشر بدقة\nفي نفس الموقع

note right of vim
vim يستعيد
intالحالة بالكامل :
موضع المؤشر,
المؤقت, مكدس التراجع
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif
skinparam componentStyle rectangle

actor Développeur as dev
participant "opencode\n(LLM وكيل)" as agent
participant "غلاف" as shell
participant "git" as git

dev -> agent : جلسة نشطة
agent -> agent : Tour de parole\ndu LLM en cours

note over agent
Ctrl+Z يأتي في منتصف تحليل الكود
end note

dev -> agent : Ctrl+Z
agent -> shell : Suspendu (job [1])
dev -> git : الفرق git
git --> dev : التغيّرات المرئية
dev -> shell : fg
shell -> agent : استأنف (وظيفة [1])
agent --> dev : Reprend exactement\nl'analyse en cours

note right of agent
لا فقدان للسياق
LLM يستأنف إجابته
بالضبط حيث كان
end note
@enduml

$ opencode
# ... session en cours, LLM analyse le code ...
^Z
[1]+  Stoppé    opencode

$ git diff HEAD~1
# vérifier les changements récents

$ fg
opencode
# Le LLM reprend là où il s'était arrêté

$ vim config.yml
^Z
[1]+  Stoppé    vim config.yml

$ ./gradlew test
^Z
[2]+  Stoppé    ./gradlew test

$ htop
^Z
[3]+  Stoppé    htop

$ jobs
[1]   Stoppé    vim config.yml
[2]-  Stoppé    ./gradlew test
[3]+  Stoppé    htop

$ fg %2
./gradlew test
# Le build reprend en avant-plan

$ bg %3
[3] htop &
# htop reprend en arrière-plan

@startuml
skinparam backgroundColor #FEFEFE

rectangle "الوظائف المعلقة" as jobs #LightYellow {
  card "[1] vim config.yml" as j1
  card "[2] ./gradlew اختبار" as j2
  card "[3] htop" as j3
}

rectangle "الإجراءات" as actions #LightGreen {
  card "fg %2\n→ في المقدمة" as a1
  card "bg %3\n→ في الخلفية" as a2
  card "fg %1\n→ في المقدمة" as a3
}

jobs --> actions : fg/bg + رقم المهمة
actions --> j2 : استأنف
actions --> j3 : في الخلفية

note bottom of jobs
كل job يحتفظ
حالته الدقيقة
بين suspend/resume
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

rectangle "**Ctrl+Z**\nSIGTSTP" as ctrlz #LightYellow {
  card "إيقاف العملية\n(هو لا يزال في الذاكرة)\nيمكن استخدامه مع fg/bg" as c1
}

rectangle "**Ctrl+C**\nSIGINT" as ctrlc #LightCoral {
  card "قتل العملية\n(لا يمكن العودة)\nضياع الحالة" as c2
}

rectangle "**& **\n(في الخلفية)" as ampersand #LightGreen {
  card "ابدأ مباشرة\nفي الخلفية\nالطرفية متاحة فورًا" as c3
}

rectangle "**fg**\n(الواجهة الأمامية)" as fg_ #SkyBlue {
  card "استعادة المهمة\nمعلق في الواجهة الأمامية\nالطرفية مشغولة" as c4
}

rectangle "**bg**\n(في الخلفية)" as bg_ #Lavender {
  card "استئناف المهمة\nمعلقة في الخلفية\nالطرفية حرة" as c5
}

ctrlz -right-> fg_ : fg لاستئناف
ctrlz -right-> bg_ : bg للمتابعة\nفي الخلفية
ctrlc -right-> c2 : لا عودة\nالعملية قُتِلَت

note bottom of ctrlz
العملية **مجمّده** لكن **ليس مقتولًا**
end note

note bottom of ampersand
Alternative : تشغيل
./gradlew build &
مباشرة في الخلفية
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

title دورة حياة كاملة لعملية شِل
state "غير موجود" as none
state "الامامية\n(occupe le terminal)" as foreground #LightCoral
state "معلق\n(Ctrl+Z / SIGTSTP)" as suspended #LightYellow
state "الخلفية\n(bg ou &)" as background #LightGreen
state "منتهي\n(exit code 0)" as done #LightGray

[*] --> none
none --> foreground : اكتب أمرًا
foreground --> suspended : Ctrl+Z
foreground --> done : نهاية عادية

suspended --> foreground : fg
suspended --> background : bg
suspended --> done : kill %n

background --> foreground : فج
background --> done : النهاية الطبيعية\n(en arrière-plan)
background --> suspended : Ctrl+Z\n(si fg puis Ctrl+Z)

done --> [*]

note right of suspended
الحالة المعلقة هي
المحور الرئيسي
لكل نظام الوظائف
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif
skinparam ArrowColor #444444

title "fg — النصيحة التي تغير كل شيء"

rectangle "**المشكلة**" as problem #LightCoral {
  card "الـTerminal متوقف\nبسبب عملية" as p1
  card "فتح نهائية جديدة\nالطرفية = حل ثقيل" as p2
}

rectangle "**الحل**" as solution #LightGreen {
  card "Ctrl+Z → تعليق" as s1
  card "fg → استئناف" as s2
  card "bg → في الخلفية" as s3
  card "jobs → عرض المعلقين" as s4
}

rectangle "**المزايا**" as advantages #SkyBlue {
  card "لا فقدان للسياق" as a1
  card "لا إعادة تشغيل" as a2
  card "يكفي طرفية אחת" as a3
}

problem -right-> solution : "الحل الأصلي\nUnix منذ 40 سنة"
solution -right-> advantages : "النتيجة"

note bottom of advantages
fg ليست نصيحة غامضة
إنها آلية أساسية
في شيل يونكس
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

rectangle "لماذا يُقلَّل من قيمة fg؟" as why #LightCoral {
  card "بيئة تطوير متكاملة مع طرفية\nمتعددة التبويبات" as w1
  card "أدوات رسومية\nتحل محل واجهة سطر الأوامر (CLI)" as w2
  card "tmux/screen\nيحلّان المشكلة\nبطريقة أخرى" as w3
}

rectangle "لماذا fg هو\nأفضل؟" as superior #LightGreen {
  card "عالمي: bash،\nzsh، fish، sh..." as s1
  card "بدون تبعية:\nبدون تثبيت" as s2
  card "ضغطتان:\nCtrl+Z ثم fg" as s3
  card "السياق محفوظ:\nصفر فقدان للحالة" as s4
}

why -right-> superior : "البساطة\nتفوز دائمًا"
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

participant "مستخدِم" as user
participant "صدفة" as shell
participant "عملية" as proc

user -> shell : Ctrl+Z
shell -> proc : SIGTSTP (الإشارة 18)
note right of proc : العملية المتجمدة\n في الذاكرة

user -> shell : fg
shell -> proc : SIGCONT (إشارة 19)
note right of proc : العملية تستأنف\nفي المقدمة

user -> shell : bg
shell -> proc : SIGCONT (إشارة 19)
note right of proc : العملية تستأنف\n في الخلفية

user -> shell : Ctrl+C
shell -> proc : SIGINT (إشارة 2)
note right of proc : تم الانتهاء من العملية\nالحالة المفقودة
@enduml