الـ Worktrees
الـ worktree يسحب فرعًا آخر من المستودع نفسه إلى مجلد خاص به. ومع worktree لكل وكيل، يمكن لعدة وكلاء العمل على المشروع نفسه في الوقت نفسه دون تعديل ملفات بعضهم. ينشئ PATerminal الـ worktree ويفتحه كجلسة جديدة في خطوة واحدة.
كُتب لـ PATerminal v1.8.3
إنشاء worktree
- في لوحة داخل المستودع، انقر Worktree في شريط اللوحة (وهو موجود أيضًا في قائمة الفروع).
- تحت الإنشاء من، اختر فرع أو طلب سحب.
- اختر الفرع الأساسي (أو طلب السحب) وأدخل اسمًا في فرع جديد.
- اختر مكان الإنشاء، وملاحظة للجلسة إن شئت.
- اضغط إنشاء. تُفتح جلسة جديدة في مجلد الـ worktree.
أين تُنشأ الـ worktrees
- خارج المستودع (الافتراضي)
- تُجمع الـ worktrees في مجلد يحمل اسم المستودع، مثل
~/worktrees/acme-app/feature-login. أدخل مسارًا مطلقًا أو~أو... لا يُمسّ ملف.gitignoreلديك. - داخل المستودع
- توضع الـ worktrees في مجلد داخل المستودع. إذا لم يكن ذلك المجلد متجاهَلًا بعد، فيُضاف إلى ملف
.gitignoreفي الجذر (كتغيير عادي في الشيفرة المصدرية).
نسخ الملفات المتجاهلة
لا يحتوي الـ worktree الجديد على أي من ملفاتك التي يتجاهلها git، لذا لا يمكن تشغيله عادةً بعد. مع الملفات المتجاهلة: النسخ من هذا الـ checkout (الافتراضي)، ينسخ PATerminal ملفات مثل .env وnode_modules و.venv من نسخة العمل الحالية إلى الـ worktree الجديد، مع مؤشر تقدم. اختر عدم النسخ لتخطي ذلك.
Worktree من طلب سحب
اختر طلب سحب كمصدر لسرد طلبات السحب المفتوحة (عبر gh لديك). ينشئ PATerminal worktree على فرع الـ PR ويفتحه كجلسة — مثالي لمراجعة PR أو إصلاحه بينما تواصل نسختك الرئيسية العمل. وإذا كان هناك worktree موجود لذلك الفرع فيُعاد استخدامه.
إدارة الـ worktrees
تعرض قائمة الـ worktrees في نافذة Git كل worktree مع فرعه وحالته (الحالي، الرئيسي، مقفل، مفقود). أزِل واحدًا، أو حدّد عدة worktrees واضغط حذف المحدد. إزالة الـ worktree تُبقي على فرعه، ولا يمكن إزالة الـ worktree الرئيسي أو الحالي. ويُعرض حذف إجباري عندما يرفض Git بسبب تغييرات محلية.
إعدادات الـ worktree الافتراضية
يضبط الإعدادات ← الموقع الافتراضي لـ Worktree الموقع الافتراضي وما إذا كانت الملفات المتجاهلة تُنسخ. فعّل Automatically fill in the branch name للحصول على اسم مكوَّن من التاريخ والوقت ولاحقة عشوائية قصيرة. تنطبق هذه الإعدادات الافتراضية أيضًا عند إنشاء worktree من issue أو بواسطة الوضع الزوجي.
ما زلت عالقًا؟
راجع الأسئلة الشائعة، أو راسلنا بالبريد مع نظام التشغيل وإصدار PATerminal وما جرّبته. نردّ على كل رسالة.