المشاريع والجلسات
كيف ينظّم Zshell عملك في مشاريع بالشريط الجانبي وجلسات بعلامات تبويب، وما يبقى بعد إعادة التشغيل.
المشاريع
المشروع هو وحدة عمل واحدة، أي مستودع واحد عمليًا، لها طرفياتها وعلامات تبويبها وحالة لوحاتها الخاصة.
ينشئ Cmd+N مشروعًا يحتوي طرفية واحدة. تبدأ الطرفية في مجلد الجلسة الحالية، أو مجلدك الرئيسي إن لم توجد جلسة، لذلك تكون الخطوة التالية عادةً استخدام cd للانتقال إلى المكان المطلوب. يتولى Zshell الباقي: ترتبط شجرة الملفات ولوحة Git بالمستودع الذي يحتوي ذلك المجلد.
لتجاوز خطوة cd، انقر بزر الفأرة الأيمن على مجلد في Finder واختر الخدمات ← مشروع Zshell جديد هنا. يُفتح كمشروع، وتكون طرفيته قد بدأت داخله بالفعل.
المشاريع هي الوحدات التي يتنقل بينها Zshell:
| الإجراء | الاختصار |
|---|---|
| مشروع جديد | Cmd+N |
| الانتقال إلى المشروع 1–9 | Cmd+1–9 |
| المشروع التالي / السابق | Opt+Cmd+] / [ |
| إخفاء الشريط الجانبي للمشاريع | Cmd+B |
يُسمّى المشروع باسم جلسته المحددة، فيتبع الطرفية بالطريقة نفسها التي يتبعها عنوان علامة التبويب. انقر عليه بزر الفأرة الأيمن في الشريط الجانبي للوصول إلى إعادة تسمية… واستخدام العنوان التلقائي للتراجع عنها، وتعيين مجلد المشروع…، وإغلاق المشروع. يؤدي إغلاق المشروع إلى إنهاء جلساته، ولا يغيّر أي شيء على القرص.
في الجلسات البعيدة المشتركة، إغلاق جزء أو مشروع يفصل هذا العميل فقط؛ وتستمر الصدفة ومهامها على المضيف.
مشاريع SSH المحفوظة
افتح لوحة الأوامر (Cmd+P) واختر مشروع SSH جديد…. أضف المضيف والمستخدم والمنفذ الاختياريين، والمجلد البعيد المراد فتحه. اختر وكيل SSH أو كلمة المرور أو ملف المفتاح الخاص أو نص المفتاح الخاص للمصادقة، ثم احفظ الاتصال واختر اتصال.
تبقى الاتصالات المحفوظة متاحة بعد إعادة التشغيل. استخدم حقل المجموعة الاختياري لتنظيم قائمة الاتصالات، وزري التحرير والحذف لإدارة العناصر. تُحفظ كلمات المرور والمفاتيح الخاصة الملصقة في سلسلة مفاتيح macOS؛ أما إدخال ملف المفتاح الخاص فيتذكر مسار المفتاح الموجود لديك.
لتشغيل أمر أو اتصال SSH مع خيارات إضافية، راجع التشغيل السريع.
مجموعات الشريط الجانبي
استخدم مجموعة جديدة أسفل الشريط الجانبي لإنشاء مجموعة عادية أو مجموعة مجلد…. تبدأ المجموعات العادية الطرفيات الجديدة في مجلدك الرئيسي؛ وتستخدم مجموعات المجلد المجلد المحدد كافتراضي. يظل لمجلد المشروع المعيّن صراحةً الأولوية. لا يغيّر نقل المشروع بين المجموعات الطرفيات الجارية ولا يستبدل مجلده المثبّت.
اسحب المشروع إلى عنوان مجموعة أو مشروع آخر لتنظيمه. واسحبه إلى + (مشروع جديد) أسفل الشريط الجانبي لإخراجه من مجموعته. يمكنك أيضًا سحب عناوين المجموعات لإعادة ترتيبها. انقر على العنوان لطي المجموعة أو توسيعها، أو انقر مرتين لإعادة تسميتها، أو استخدم قائمتها السياقية. اختر تعيين علامة لونية… لإعطاء المجموعة لونًا، أو إزالة العلامة اللونية لمسحه. يُبقي إزالة المجموعة جميع مشاريعها مفتوحة. تتبع اختصارات الأرقام صفوف المشاريع الظاهرة حاليًا؛ ويمكن للتنقل إلى المشروع التالي أو السابق إظهار أعضاء مجموعة مطوية.
يمكنك إسقاط مجلدات من Finder في أي موضع ضمن قائمة المشاريع بالشريط الجانبي. إذا كان المجلد مفتوحًا بالفعل، يُنقل التركيز إليه بدلًا من إنشاء مشروع مكرر.
مجلد المشروع
تحتاج لوحتان إلى معرفة المجلد الذي تعرضانه: شجرة الملفات ولوحة Git. يحدده Zshell افتراضيًا بأخذ المجلد الحالي للطرفية والصعود منه إلى أقرب مستودع Git يحتويه.
لهذا لا تقفز شجرة الملفات عندما تتنقل باستخدام cd داخل مستودع: يبقى جذر المستودع هو الجذر. أما خارج المستودعات فتتبع اللوحتان الطرفية ببساطة.
عندما ينتقل البرنامج الأمامي إلى نسخة عمل أخرى، مثل وكيل يدخل إلى Git worktree خاص به، تتبع لوحات الملفات وGit والمعلومات تلك النسخة. وتعود عندما تعود المهمة الأمامية. تكون الأولوية دائمًا لمجلد المشروع المثبّت يدويًا، ويعطّل هذا الانتقال التلقائي للجذر.
لتثبيت المجلد، انقر بزر الفأرة الأيمن على المشروع واختر تعيين مجلد المشروع…. يُحفظ المجلد المثبّت عبر عمليات إعادة التشغيل، ويعيد استخدام المجلد التلقائي التحكم إلى Zshell.
تعرض لوحة المعلومات (Cmd+Shift+I) كليهما: المجلد الحالي الفعلي للصدفة عندما يختلف، ومجلد المشروع المرتبط باللوحات، مع علامة (AUTO) عندما يكون مستنتجًا تلقائيًا.
الجلسات
يمكن لكل مشروع أن يحتوي العدد الذي تريده من الجلسات، وتظهر كعلامات تبويب في الأعلى. الجلسة صدفة تسجيل دخول حقيقية، مثل zsh أو fish أو bash بحسب إعداد حسابك، ولها مجلد عمل وسجل مخرجات خاصان بها.
| الإجراء | الاختصار |
|---|---|
| جلسة جديدة | Cmd+T |
| الانتقال إلى علامة التبويب 1–9 | Ctrl+1–9 |
| مبدّل علامات التبويب حسب الاستخدام الأخير | Ctrl+Tab |
| علامة التبويب التالية / السابقة | Cmd+Shift+] / [ |
| إغلاق الجزء ذي التركيز | Cmd+W |
تبدأ الجلسة المحلية الجديدة في مجلد المشروع المثبّت إن وُجد، وإلا تستخدم المجلد الافتراضي لمجموعتها في الشريط الجانبي. إذا لم يوجد أي منهما، ترث مجلد الجلسة الحالية، ثم ترجع إلى مجلدك الرئيسي عند الحاجة.
مجموعات علامات التبويب
انقر بزر الفأرة الأيمن على علامة تبويب واختر نقل إلى مجموعة ← مجموعة علامات تبويب جديدة. تنضم علامة التبويب إلى المجموعة الجديدة، التي تظهر كسهم ملوّن دون اسم. تبقى الجلسات الجديدة المفتوحة من علامة تبويب مجمّعة في المجموعة نفسها؛ انقر بزر الفأرة الأيمن على سهم المجموعة واختر جلسة جديدة في المجموعة لإنشاء جلسة داخلها مباشرةً.
اسحب علامة التبويب إلى سهم مجموعة أو علامة تبويب أخرى لنقلها. تسرد القائمة السياقية المجموعات وخيار إزالة من المجموعة أيضًا. انقر على السهم لطي المجموعة أو توسيعها. يُبقي طي المجموعة الطرفية النشطة جارية ومرئية؛ والانتقال إلى عضو مخفي يوسّع المجموعة. تُبقي إزالة المجموعة علامات تبويبها وجلساتها مفتوحة. يؤدي تثبيت علامة تبويب مجمّعة إلى نقلها إلى القسم الثابت خارج المجموعات. انقر بزر الفأرة الأيمن على سهم المجموعة لاختيار تعيين علامة لونية… أو إزالة العلامة اللونية. تُستعاد ألوان المجموعات وحالة طيّها بعد إعادة تشغيل Zshell.
يمكن أيضًا إسقاط علامة تبويب على مشروع في الشريط الجانبي، أو على عنوان مجموعة لإنشاء مشروع جديد داخلها. يؤدي الإسقاط على + (مشروع جديد) أسفل الشريط الجانبي إلى إنشاء مشروع خارج جميع مجموعات الشريط الجانبي. يصل خيار نقل علامة التبويب إلى مشروع في قائمتها إلى النوافذ الأخرى أيضًا. تحافظ هذه النقلات على الطرفيات الجارية وتخطيط الأجزاء. يجب أن تكون المشاريع في الموقع المحلي أو موقع SSH نفسه؛ ويحافظ إنشاء مشروع من علامة تبويب على موقعها الأصلي. تبقى علامات التبويب التي تحتوي فروقًا في مشروعها الحالي.
عناوين علامات التبويب
تأخذ علامات التبويب عناوينها مما ترسله الطرفية، سواءً تسلسل الهروب في محث الصدفة أو البرنامج الجاري. انقر بزر الفأرة الأيمن على علامة تبويب واختر إعادة تسمية… لتسميتها يدويًا، واستخدام العنوان التلقائي للعودة إلى متابعة الطرفية.
تضم بقية القائمة الخيارات المعتادة: إغلاق وإغلاق الأخرى وإغلاق علامات التبويب إلى اليمين وإغلاق الكل، إضافةً إلى إظهار في Finder ونسخ المسار المطلق لمجلد الجلسة. يغلق إغلاق الملفات وإغلاق الفروق هذه الأنواع من المحتوى في المشروع كله، مع إبقاء الطرفيات وأجزاء المتصفح مفتوحة.
النوافذ
يفتح Cmd+Shift+N نافذة أخرى. النوافذ مستقلة، ولكل منها مشاريعها وحالة شريطها الجانبي، وتُستعاد كل نافذة منفردة.
ما يبقى بعد إعادة التشغيل
يحفظ Zshell لقطات لتخطيطك أثناء العمل، لذلك يعيد لك الإنهاء وإعادة الفتح:
- جميع المشاريع بالترتيب نفسه
- جميع علامات التبويب، بما فيها الأسماء المخصصة والتثبيت والعلامات اللونية
- مجموعات الشريط الجانبي بأسمائها وألوانها وترتيبها وأعضائها وحالة طيّها
- مجموعات علامات التبويب بألوانها وترتيبها وأعضائها وحالة طيّها
- مجلدات المشاريع المثبّتة والمشاريع الفارغة
- تخطيط الأجزاء داخل كل علامة تبويب
- الأشرطة الجانبية التي كانت مفتوحة واللوحة اليمنى المحددة
إذا لم يعد PTY الأصلي متاحًا وكانت استئناف محادثات الوكلاء ودعم الذكاء الاصطناعي مفعّلين، يستأنف Zshell محادثة Claude Code أو Codex أو Pi أو OpenCode الموثقة. تفتح اللوحات الأخرى صُدَفًا جديدة في مجلداتها السابقة. تحتفظ المحادثة بهويتها؛ ولا يستعيد Zshell بناءً جاريًا بإعادة الأوامر.
يُستعاد سجل المخرجات السابق عند تفعيل terminal.restore-history. يكون مفعّلًا افتراضيًا في الإعدادات الجديدة؛ ويُخزّن السجل المستعاد على القرص.
بيئة الطرفية والتهيئة
حدّد مشروعًا، ثم استخدم الطرفية ← بيئة طرفية المشروع… لتعيين متغيرات البيئة وأمر التهيئة. استخدم الطرفية ← بيئة طرفية علامة التبويب… لتعيين تجاوزات علامة التبويب الحالية.
| النطاق | السلوك |
|---|---|
| المشروع | ترث الطرفيات الجديدة في المشروع متغيراته وأمر تهيئته |
| علامة التبويب | تتجاوز المتغيرات قيم المشروع ذات الاسم نفسه؛ ويمكن للأمر أن يرث أمر المشروع أو يستبدله أو يعطّله |
تؤثر التغييرات فقط في الطرفيات المُنشأة بعد الحفظ. تحتفظ العمليات الموجودة ببيئتها. تعمل التهيئة مع صدفة تسجيل الدخول العادية، وليس مع برنامج بدء مخصص أو argv صريح.
يدير Zshell المتغيرات ZSHELL_* وTERM وCOLORTERM وTERM_PROGRAM وTERM_PROGRAM_VERSION، ولا يمكن تجاوزها.