AI-translated from English; not yet reviewed by a fluent editor.

# نظّف أشجار عملاء VS Code غير النشطة من دون فقدان الجلسة

> دليل يستند إلى الوثائق لتنظيف أشجار العمل يدويًا في VS Code 1.141، ويشرح الاختيارات الافتراضية ووسائل الحماية والاستعادة وأتمتة Preview المنفصلة.

By BIG CHANGE Editorial

Published: 2026-10-08T06:14:55.344Z
Updated: 2026-10-08T06:14:55.344Z
Canonical: https://bigchange.ai/blog/vscode-agent-worktree-cleanup-guide

![Conceptual charcoal illustration of a developer at a monitor with a desktop computer tower under the workbench.](https://bigchange.ai/api/media/file/vscode-worktree-storage-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no VS Code interface or measured result is depicted.

يضيف Visual Studio Code 1.141 Stable، الذي صدر في 7 أكتوبر 2026، محررًا لتنظيف جلسات الوكلاء المعزولة في أشجار العمل. إذا تركت الجلسات القديمة أشجار عمل محلية على القرص، `Chat: Open Worktree Cleanup` يعرض الجلسات المؤهلة والحجم المقدّر لكل شجرة عمل. وأنت تختار ما تريد إزالته. يستند هذا الدليل إلى [ملاحظات إصدار Microsoft](https://code.visualstudio.com/updates/v1_141) و [وثائق إدارة الجلسات](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions)؛ لم تُجرِ BIG CHANGE عملية تنظيف ولم تقس مقدار المساحة الموفرة.

## راجع أشجار العمل المحددة قبل التأكيد

1. في VS Code 1.141، افتح لوحة الأوامر وشغّل `Chat: Open Worktree Cleanup`.
2. اختر عامل تصفية مدة عدم النشاط: 7 أو 15 أو 30 أو 60 أو 90 يومًا. فهو يحدد الجلسات المؤهلة، وليس مؤقتًا للعد التنازلي حتى الحذف التلقائي.
3. راجع كل جلسة والحجم المقدّر لشجرة عملها. تكون أشجار العمل المؤهلة **محددة افتراضيًا**. ألغِ تحديد أي جلسة تريد الاحتفاظ بها، بما في ذلك العمل الذي لم تتحقق بعد من فرعه أو ملفاته.
4. أكّد التنظيف للعناصر التي لا تزال محددة فقط.

يضع VS Code علامة الاكتمال على كل جلسة محددة ويجدول إزالة شجرة عملها. وقبل إزالة الشجرة، يحفظ التغييرات غير المثبتة في فرع الجلسة. إذا تعذّر عليه حفظ التغييرات أو إزالة شجرة العمل، فستظل موجودة. ويظل سجل الجلسة والفرع متاحًا. اعثر على الجلسة باستخدام عامل التصفية **Done** في نافذة Agents (أو **Archived** في عرض Chat)، ثم استعدها لإعادة إنشاء شجرة العمل من الفرع. تشرح الوثائق هذه الحماية، لكنها لا تضمن إزالة كل شجرة عمل مؤهلة أو استعادة مقدار محدد من المساحة.

لا يعرض محرر التنظيف الجلسات النشطة أو قيد التشغيل أو المنتظرة لإدخال أو المثبتة. كما يخفي الجلسات المكتملة أو المؤرشفة أو بلا عنوان أو التي بها خطأ، والجلسات الأحدث من الحد المختار، وأشجار العمل التي يتعذر على VS Code قياس حجمها. لذلك لا يثبت غياب جلسة عن المحرر أن شجرة عملها قد اختفت.

## ميّز بين التنظيف وحذف الجلسة

يحافظ التنظيف اليدوي لشجرة العمل على الجلسة وفرعها. **Delete** إجراء مختلف: توضح وثائق VS Code أن حذف الجلسة نهائي ولا يمكن التراجع عنه. وفي جلسات Copilot، يزيل ذلك أيضًا أشجار العمل المرتبطة، مع اختلاف السلوك لأشجار العمل المشتركة. وتحذر الوثائق من احتمال فقدان الملفات غير المثبتة الموجودة فقط في شجرة عمل أزيلت. استخدم محرر التنظيف للمسار القابل للاستعادة والموثق، وتحقق من العمل الذي تحتاج إليه قبل تحديده.

## الاقتراحات والتنظيف التلقائي في Preview

يعرض الإعداد الاختياري `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` اقتراحًا في نافذة Agents عندما تشغل أشجار العمل غير النشطة مساحة لا تقل عن 5 GiB أو عندما تكون 20 شجرة عمل مؤهلة. ويفتح الاقتراح محرر المراجعة نفسه، لكنه لا يزيل أي شجرة عمل. يمكنك إغلاقه للنافذة الحالية، أو اختيار **Don't Show Again**، أو تشغيل `Chat: Disable Session Storage Cleanup Suggestions`.

توثق VS Code أيضًا **التنظيف التلقائي للجلسات** بوصفه ميزة Preview. ويكون الإعدادان متوقفين افتراضيًا. `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` مدة عدم نشاط جلسة Agent Host المؤهلة قبل وضع علامة الاكتمال عليها. `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` فترة سماح منفصلة قبل أن يحذف VS Code نهائيًا جلسة وضع علامة الاكتمال عليها تلقائيًا. يقبل الإعدادان عددًا صحيحًا موجبًا من الأيام؛ ويؤدي `0` إلى تعطيل تلك المرحلة. توصي VS Code بـ `15` يومًا، لكن ذلك اقتراح لإعداد القيمة وليس عامل التصفية اليدوي ذي 7/15/30/60/90 يومًا.

لكي تكون الجلسة مؤهلة لأتمتة Preview، يجب أن تكون غير نشطة وأن تتجاوز المدة المضبوطة منذ آخر تعديل، وأن ترتبط بطلب سحب واحد مدمج على الأقل، وألا يكون هناك طلب سحب مرتبط ما زال مفتوحًا. تُستثنى الجلسات الخارجية. عند تفعيل الإعداد، يتحقق VS Code عند بدء التشغيل وكل ساعة. لا تُحذف تلقائيًا بهذه الطريقة جلسة تضع أنت علامة الاكتمال عليها؛ كما أن استعادة جلسة اكتملت تلقائيًا تلغي أهليتها للحذف. ولكي يزيل التنظيف التلقائي شجرة العمل، يجب أن يتتبع فرعها فرعًا علويًا وألا يتضمن أي إيداعات لم تُرسل أو تغييرات غير مثبتة. وإذا كانت حالة Git غير معروفة أو لم يتحقق شرط ما، فستظل شجرة العمل موجودة. وتوضح VS Code أن هذه العملية لا تزيل شجرة العمل بالقوة أبدًا.

إذا أردت مراجعة الأحجام واختيار أشجار العمل القديمة بنفسك، فاستخدم المحرر اليدوي. تتناول إعدادات Preview دورة حياة أضيق نطاقًا مرتبطة بطلبات السحب المدمجة، وقد تحذف في النهاية الجلسات المؤهلة نهائيًا. لا تذكر هذه الوثائق رسومًا إضافية منفصلة لميزة التنظيف. وتعتمد المساحة المستعادة فعليًا على أشجار العمل التي تستوفي الشروط وتُزال.

## التغيير الكبير

- يمكن للمطورين الذين يستخدمون جلسات وكلاء معزولة في أشجار العمل الآن رؤية الحجم المقدّر لكل شجرة عمل غير نشطة ومؤهلة في VS Code 1.141، واختيار ما يريدون تنظيفه.
- يضع التنظيف اليدوي علامة الاكتمال على الجلسات المحددة، ويحافظ على سجل الفرع، ويحفظ التغييرات غير المثبتة قبل إزالة شجرة العمل. وإذا تعذّر الحفظ أو الإزالة، فستظل شجرة العمل موجودة؛ وتؤدي استعادة الجلسة إلى إنشائها من جديد.
- تكون أشجار العمل المؤهلة محددة مسبقًا. راجع القائمة قبل التأكيد. يستثني VS Code الجلسات النشطة وقيد التشغيل والمنتظرة لإدخال والمثبتة، لكن هذه وسائل الحماية لا توضح ما إذا كنت لا تزال بحاجة إلى العمل في جلسة غير نشطة.
- يتبع التنظيف التلقائي في Preview قواعد منفصلة لطلبات السحب المدمجة، ويمكنه حذف الجلسات نهائيًا بعد فترة سماح مضبوطة. وتكون إعداداته متوقفة في البداية.

## المصادر ومواد إضافية للقراءة

تحدد ملاحظات إصدار VS Code 1.141 موعد وصول محرر التنظيف إلى Stable وتشرح الغرض منه. وتفصّل وثائق Microsoft بعنوان *Manage agent sessions in VS Code* عوامل التصفية والاختيارات الافتراضية ووسائل الحماية والاستعادة وقواعد أتمتة Preview المنفصلة. والوثيقتان مدرجتان في وحدة المصادر أدناه.

## Sources

- [ملاحظات إصدار Visual Studio Code 1.141](https://code.visualstudio.com/updates/v1_141) — تاريخ إصدار Stable والإعلان عن تنظيف أشجار العمل يدويًا.
- [Manage agent sessions in VS Code](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) — عوامل التصفية اليدوية والاختيار والحماية والاستثناءات والاستعادة والاقتراحات والتنظيف التلقائي في Preview.