# إدارة السياق (/ar/docs/verdent-for-vscode/best-practices/context)

> إدارة السياق بفعالية للحصول على نتائج أفضل



***

تضمن إدارة السياق الفعالة حصول Verdent على المعلومات الصحيحة في الوقت المناسب مع تجنب تراجع الأداء الناتج عن زيادة السياق.

### ما ستتعلمه [#ما-ستتعلمه]

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

***

## فهم نوافذ السياق [#فهم-نوافذ-السياق]

يعتمد حجم نافذة السياق لدى Verdent for VS Code على النموذج المستخدم.

<Tabs>
  <Tab title="النماذج القياسية (200 ألف)">
    تستخدم معظم النماذج نوافذ سياق `200K` قياسية:

    * **Claude 4.5 Sonnet** - متوازن للمهام المعقدة
    * **Claude 4.5 Haiku** - سريع وفعّال
    * **GPT-5** - ممتاز للاستدلال (تجريبي)
    * **GPT-5-Codex** - محسّن للبرمجة (تجريبي)

    **السعة:**

    * نحو `200,000` رمز (token) من سعة الذاكرة الإجمالية
    * كافية لمعظم مهام التطوير والمشاريع متوسطة الحجم

    **ما يتضمنه السياق:**

    * جميع الرسائل في المحادثة
    * محتوى الملفات المحمّلة في السياق
    * مخرجات واستجابات الأدوات
    * الـ prompts والتعليمات الخاصة بالنظام
    * تعريفات خادم MCP

    **الأداء:**

    * يتراجع بشكل ملحوظ عند الاقتراب من الحدود
    * انتبه لعلامات زيادة السياق (استجابات أبطأ، مخرجات أقل دقة)
    * أعد ضبط السياق بشكل أكثر تكرارًا للحصول على أداء مثالي
  </Tab>

  <Tab title="السياق الموسّع (مليون)">
    يوفر Claude Sonnet 4.5 سياقًا موسّعًا (`1M` رمز) عند تحديده صريحًا أو عندما يتجاوز المدخل `200K` رمز.

    **السعة:**

    * `1,000,000` رمز من الذاكرة الإجمالية
    * أكبر بخمس مرات من النماذج القياسية

    **الفوائد:**

    * مثالي لتحميل قواعد كود كبيرة كاملة دون تجزيئها
    * يزيل معظم مخاوف إدارة السياق للمشاريع الكبيرة
    * يمكن العمل لفترة أطول قبل الوصول إلى حدود السياق
    * حاجة أقل لإعادة ضبط الجلسات

    **متى تستخدمه:**

    * قواعد كود كبيرة تحتوي على ملفات `1000+`
    * إعادة هيكلة معقدة متعددة الملفات عبر مشاريع كاملة
    * جلسات تطوير طويلة تمتد عبر مهام مرتبطة متعددة
    * عندما تريد تقليل عبء إدارة السياق
  </Tab>
</Tabs>

***

## اختيار الملفات بشكل استراتيجي [#اختيار-الملفات-بشكل-استراتيجي]

كن استراتيجيًا في اختيار الملفات لتحسين استخدام السياق وتجنب الوصول إلى الحدود.

<Tip>
  ابدأ بعدد أقل من الملفات وأضف المزيد فقط عند الحاجة، إذ يمكن لـ Verdent دائمًا قراءة ملفات إضافية خلال المحادثة.
</Tip>

### استخدام الإشارات بـ @ للإدراج الصريح [#استخدام-الإشارات-بـ--للإدراج-الصريح]

```
@filename.js
```

يحمّل Verdent الملفات المرتبطة تلقائيًا، لكن `@-mentions` يضمن سياقًا دقيقًا. كن انتقائيًا - أدرج فقط الملفات المرتبطة مباشرة بالمهمة الحالية.

### راقب استخدام السياق [#راقب-استخدام-السياق]

* راقب تراجع الأداء مع طول الجلسات
* كن على دراية بطول المحادثة وعدد الملفات
* أزل الملفات غير الضرورية من السياق عند الإمكان

### تجنب زيادة السياق [#تجنب-زيادة-السياق]

* قسّم المهام الكبيرة إلى أجزاء أصغر مع عدد أقل من الملفات لكل مهمة
* ركّز فقط على الملفات المرتبطة - لا تحمّل قاعدة الكود كاملة دفعة واحدة
* استخدم إدارة خادم MCP لتعطيل التكاملات غير المستخدمة

### أفضل الممارسات [#أفضل-الممارسات]

* أدرج فقط الملفات التي تحتاج إلى تعديل أو مرجعية
* استخدم الأنماط الموجودة كمرجع بدلًا من تحميل ملفات أمثلة
* بالنسبة لقواعد الكود الكبيرة، اعمل على وحدة واحدة في كل مرة
* استخدم وثائق المشروع (`AGENTS.md`) بدلًا من تحميل ملفات كثيرة
* تجنب الخُمس الأخير من نافذة السياق للمهام كثيفة استخدام الذاكرة

### للسياق الموسّع (مليون رمز) [#للسياق-الموسّع-مليون-رمز]

يصبح اختيار الملفات أقل أهمية بكثير - يمكنك غالبًا تحميل مستودعات المشروع كاملة دون الوصول إلى الحدود.

***

## التعرف على زيادة السياق [#التعرف-على-زيادة-السياق]

<Tabs>
  <Tab title="جودة الاستجابة">
    **العلامات:**

    * استجابات أقل دقة أو غير مكتملة
    * غياب تفاصيل مهمة من بداية المحادثة
    * صعوبة في الحفاظ على الاتساق عبر الجلسات الطويلة
    * ارتباك حول التغييرات الأخيرة أو السياق

    **أمثلة ملموسة:**

    * يقترح حلولًا رفضتها بالفعل سابقًا في الجلسة
    * يتجاهل قواعد البرمجة التي حددتها قبل `20` رسالة
    * يولّد كودًا يتعارض مع تغييرات تمت سابقًا في المحادثة
    * يقترح تنفيذات لا تتطابق مع بنية مشروعك التي نُوقشت سابقًا

    **المؤشر الأساسي:** تصبح استجابات Verdent أقل دقة أو غير متسقة
  </Tab>

  <Tab title="مشاكل السرعة">
    **العلامات:**

    * أوقات استجابة أبطأ بشكل ملحوظ
    * تأخيرات معالجة أطول قبل بدء الاستجابات
    * زيادة التأخير بين الرسائل

    **أمثلة ملموسة:**

    * الاستجابات التي تستغرق عادة `5-10` ثانية تستغرق الآن `30+` ثانية
    * تأخير واضح قبل ظهور مؤشر الكتابة بعد إرسال رسالتك
    * تبدأ الاستجابات المتدفقة أبطأ بكثير من المعتاد
    * يستغرق تنفيذ الأدوات (قراءة الملفات، البحث) وقتًا أطول بشكل ملحوظ

    **المؤشر الأساسي:** تستغرق الاستجابات وقتًا أطول بشكل ملحوظ من المعتاد
  </Tab>

  <Tab title="التغييرات السلوكية">
    **العلامات:**

    * طلب توضيح معلومات مُقدَّمة مسبقًا
    * نسيان الأنماط أو القواعد المحددة سابقًا
    * عدم القدرة على الإشارة إلى ملفات أو كود نُوقش سابقًا
    * أسئلة متكررة حول بنية المشروع

    **أمثلة ملموسة:**

    * يسأل "ما إطار العمل الذي تستخدمه؟" بعد أن حددت React قبل `30` رسالة
    * يطلب مسارات ملفات قدّمتها بالفعل `@-mentioned` مرات عديدة
    * لا يتذكر اصطلاح التسمية الذي حددته في بداية الجلسة
    * يعيد شرح مفاهيم أو أساليب رفضتها بالفعل مع الأسباب

    **المؤشر الأساسي:** يسأل Verdent عن أمور نُوقشت بالفعل
  </Tab>

  <Tab title="المؤشرات التقنية">
    **العلامات:**

    * الاقتراب من الخُمس الأخير من حد رمز `200K` (نحو `160K+` رمز مستخدَم)
    * محادثات طويلة مع قراءات ملفات ومخرجات أدوات كثيرة
    * تفعيل خوادم MCP متعددة مع تعريفات أدوات كثيفة
    * تحميل ملفات كبيرة في السياق بشكل متكرر

    **أمثلة ملموسة:**

    * الجلسة مستمرة منذ `2+` ساعة مع `100+` رسالة
    * قمت بتحميل `20+` ملف مع `@-mentions` خلال المحادثة
    * توجد ملفات كبيرة متعددة (كل منها `>1000` سطر) في السياق
    * لديك `5+` خادم MCP مفعّل مع تعريفات أدوات موسّعة
    * تتضمن المحادثة نتائج بحث/grep وقراءات ملفات كثيرة

    **المؤشر الأساسي:** جلسات طويلة جدًا مع استخدام مكثف للملفات/الأدوات
  </Tab>
</Tabs>

**متى تتخذ إجراءً:** تراجع الأداء هو المؤشر الأساسي لديك. إذا أصبحت استجابات Verdent أقل دقة أو أبطأ أو غير متسقة - ابدأ جلسة جديدة أو استخدم استراتيجيات إدارة السياق.

<Warning>
  إذا أصبحت استجابات Verdent غامضة أو متكررة، فقد تكون زيادة السياق حادثة. أعد ضبط المحادثة لاستعادة الأداء الكامل.
</Warning>

**ملاحظة:** مع سياق رمز `1M` (Claude Sonnet 4.5)، تكون هذه المشاكل أقل شيوعًا بكثير.

***

## متى تعيد ضبط السياق [#متى-تعيد-ضبط-السياق]

<Tabs>
  <Tab title="مؤشرات الأداء">
    * أوقات استجابة أبطأ بشكل ملحوظ
    * استجابات أقل دقة أو غير متسقة
    * نسيان Verdent للسياق أو الأنماط السابقة
    * الاقتراب من حدود نافذة السياق (انتبه لعلامات التراجع)

    **الإجراء:** ابدأ جلسة جديدة عندما تتراجع الجودة
  </Tab>

  <Tab title="الانتقال بين المهام">
    * التبديل بين ميزات أو وحدات غير مرتبطة
    * إنهاء عنصر مهمة والانتقال إلى التالي
    * بعد المهام كثيفة استخدام الذاكرة (إعادة هيكلة كبيرة، عمل معماري)
    * الانتقال من مرحلة البحث إلى مرحلة التنفيذ

    **الإجراء:** جلسة جديدة لكل مهمة رئيسية جديدة
  </Tab>

  <Tab title="بعد الالتزامات (Commits)">
    * بعد تسجيل الميزات المكتملة في نظام التحكم بالإصدارات
    * بين نقاط التحقق المنطقية في سير عمل التطوير
    * بعد دورات الاختبار والتحقق والالتزام

    **الإجراء:** التزام (commit) ← اختبار ← جلسة جديدة
  </Tab>

  <Tab title="إدارة الجلسات">
    * قبل بدء ميزات جديدة كبيرة
    * عندما يصبح سجل المحادثة طويلًا جدًا
    * بعد إنهاء تغييرات متعددة الملفات
    * بين أنواع مختلفة من العمل (تصحيح الأخطاء ← تطوير الميزات)

    **الإجراء:** ابدأ جلسة جديدة بشكل استباقي قبل أن يتراجع السياق
  </Tab>
</Tabs>

**سير عمل موصى به:** إنهاء وحدة عمل متكاملة ← اختبار ← التزام (commit) ← مسح السياق ← بدء جلسة جديدة للمهمة التالية.

**ملاحظة:** ابدأ جلسة جديدة لإعادة ضبط السياق. بالنسبة لسياقات رمز `1M`، الحاجة إلى المسح أقل تكرارًا بكثير.

***

## تأثير تنظيم مساحة العمل [#تأثير-تنظيم-مساحة-العمل]

يؤثر تنظيم مساحة العمل بشكل مباشر على كفاءة استخدام السياق وسهولة تنقّل Verdent في قاعدة الكود الخاصة بك.

<Tabs>
  <Tab title="تنظيم جيد">
    **ملفات أصغر ومركّزة:**

    * العديد من الملفات الصغيرة تستهلك السياق بكفاءة أكبر من قلة من الملفات الكبيرة
    * أسهل في تحميل الوحدات المرتبطة فقط
    * تحكم أدق في ما يوجد في السياق
    * يقلل الحاجة إلى تحميل ملفات كبيرة كاملة

    **بنية دليل واضحة:**

    * التنظيم المنطقي يساعد Verdent على تحديد الملفات المرتبطة
    * التنظيم القائم على الميزة أو الوحدة يحسّن استهداف السياق
    * يقلل الحاجة إلى تحميل كود غير مرتبط

    **`Documentation in AGENTS.md:`**

    * وثائق المشروع تحل محل الحاجة إلى تحميل ملفات أمثلة كثيرة
    * الأنماط المعمارية موصوفة مرة واحدة ويُشار إليها بشكل متكرر
    * معايير البرمجة موثّقة مركزيًا
    * يقلل عبء السياق الناتج عن قراءات الملفات الاستكشافية

    **الفوائد:**

    * العمل على وحدات منعزلة دون تحميل قاعدة الكود كاملة
    * حدود واضحة تتيح جلسات مركّزة
    * تقسيم العمل يصبح طبيعيًا حسب حدود الوحدات
  </Tab>

  <Tab title="تنظيم ضعيف">
    **المشاكل:**

    * الملفات الضخمة تفرض تحميل سياقات كبيرة كاملة
    * البنية غير الواضحة تتطلب تحميل ملفات كثيرة لفهم البنية المعمارية
    * المفاهيم المختلطة في الملفات نفسها تهدر السياق على كود غير مرتبط

    **الأثر:**

    * مشاكل متكررة تتعلق بحدود السياق
    * رموز مهدرة على كود غير مرتبط
    * صعوبة في حصر العمل على وحدات محددة
    * حاجة أكثر تكرارًا لإعادة ضبط الجلسات

    **أنماط سلبية شائعة:**

    * ملف واحد بعدد أسطر `5000+` يحتوي على مفاهيم متعددة
    * بنية دليل مسطّحة مع ملفات `100+` في الجذر
    * غياب فصل واضح بين الميزات/الوحدات
    * نقص الوثائق المركزية
  </Tab>

  <Tab title="استراتيجيات التحسين">
    **مناهج إعادة الهيكلة:**

    * قسّم الملفات الكبيرة إلى وحدات أصغر ومركّزة
    * نظّم حسب الميزة أو المجال (لا حسب نوع الملف)
    * أنشئ تسلسل دليل واضح
    * استخرج الكود المشترك إلى وحدات منفصلة

    **الوثائق:**

    * أنشئ `AGENTS.md` بالأنماط المعمارية
    * وثّق معايير البرمجة مركزيًا
    * حافظ على ملفات `README` لكل وحدة
    * احتفظ بقرارات التصميم موثّقة

    **أثر السياق:** بالنسبة لسياقات رمز `200K` القياسية، تنظيم مساحات العمل يشكّل الفارق بين الوصول إلى الحدود بشكل متكرر أو نادر. بالنسبة لسياقات رمز `1M`، يقل أهمية التنظيم لكنه لا يزال يحسّن الكفاءة.
  </Tab>
</Tabs>

***

## استراتيجيات تحسين السياق [#استراتيجيات-تحسين-السياق]

يجمع التحسين الفعّال للسياق بين المراقبة والتخطيط الاستراتيجي والتهيئة التقنية.

<Tabs>
  <Tab title="المراقبة">
    **راقب علامات الأداء:**

    * راقب جودة الاستجابة وسرعتها طوال الجلسات
    * لاحظ عندما تصبح الاستجابات أبطأ أو أقل دقة
    * تابع طول المحادثة وعدد الملفات يدويًا
    * كن استباقيًا في بدء جلسات جديدة

    **ما يجب مراقبته:**

    * دقة الاستجابة واتساقها
    * الوقت اللازم لأول استجابة (تأخير مؤشر الكتابة)
    * إجمالي وقت إنهاء الاستجابة
    * تذكّر تفاصيل المحادثة السابقة

    **إدارة الوكلاء الفرعيين (Subagents):**

    * عطّل الوكلاء الفرعيين المخصّصين غير المستخدمين عند عدم الحاجة إليهم
    * كل وكيل فرعي مفعّل يضيف تعريفات إلى عبء النظام
    * احتفظ فقط بالوكلاء الفرعيين المستخدَمين فعليًا مفعّلين
    * أعد تفعيلهم عند الحاجة لمهام محددة

    **حد اتخاذ الإجراء:** عندما تلاحظ إشارات تراجع `2-3`، فقد حان وقت بدء جلسة جديدة.

    <Tip>
      راقب جودة الاستجابة كمؤشر مبكّر على صحة السياق، فالاستجابات المتراجعة تشير إلى حاجة إعادة الضبط.
    </Tip>
  </Tab>

  <Tab title="تخطيط المهام">
    **نهج التقسيم:**

    * قسّم المهام الكبيرة إلى أجزاء أصغر
    * أنهِ الأعمال المرتبطة في جلسات مركّزة
    * تجنّب خلط أنواع مهام مختلفة في محادثات طويلة
    * تجنّب الخُمس الأخير من نافذة السياق للعمل كثيف استخدام الذاكرة

    **إدارة الجلسات:**

    * ابدأ جلسات جديدة بين المهام الرئيسية
    * مسح السياق بعد الالتزامات (commits): اختبار ← تحقق ← التزام ← جلسة جديدة
    * استخدم قوائم المهام (todos) للتخطيط متعدد الخطوات
    * أنجز عناصر قائمة المهام في جلسات منفصلة ومركّزة

    **نمط أفضل الممارسات:**

    1. خطّط للمهمة في Plan Mode
    2. نفّذ التنفيذ المركّز في جلسة جديدة
    3. اختبر التغييرات وتحقّق منها
    4. سجّل الالتزام في نظام التحكم بالإصدارات
    5. ابدأ جلسة جديدة للمهمة التالية

    **عزل المهام:** حافظ على تصحيح الأخطاء منفصلًا عن تطوير الميزات، والبحث منفصلًا عن التنفيذ.
  </Tab>

  <Tab title="إدارة الملفات">
    **الإدراج الاستراتيجي:**

    * استخدم `@-mentions` للإدراج الصريح للملفات فقط عند الضرورة
    * استفد من وثائق `AGENTS.md` بدلًا من تحميل ملفات كثيرة
    * اعمل على وحدة واحدة في كل مرة للمشاريع الكبيرة
    * قسّم الملفات الكبيرة إلى مكوّنات أصغر ومركّزة

    **مبادئ اختيار الملفات:**

    * أدرج فقط الملفات التي تحتاج إلى تعديل أو مرجعية مباشرة
    * فضّل الوثائق على تحميل ملفات الأمثلة
    * أزل الملفات من السياق عندما لا تعود ضرورية
    * حمّل الملفات في وقتها المناسب، لا بشكل استباقي

    **معالجة الملفات الكبيرة:**

    * فكّر في تقسيم الملفات التي تتجاوز `500` سطر
    * استخرج الأدوات المساعدة إلى ملفات منفصلة
    * استخدم حدود وحدات واضحة
    * وثّق علاقات الملفات في `AGENTS.md`
  </Tab>

  <Tab title="سير العمل">
    **سير عمل التحسين:**

    راقب الأداء ← حدّد تضخم الجلسة ← عطّل الوكلاء الفرعيين غير المستخدَمين ← ابدأ جلسات جديدة بشكل استباقي ← ركّز على جودة المهمة

    **الممارسة اليومية:**

    * ابدأ كل ميزة رئيسية بسياق جديد
    * سجّل الالتزامات بشكل متكرر وأعد الضبط بينها
    * حافظ على تركيز الجلسات على أهداف مفردة
    * راجع استخدام السياق عند نقاط التوقف الطبيعية

    **`For Extended Context (1M tokens):`** مع نافذة السياق الأكبر لـ Claude Sonnet 4.5، يصبح التحسين أقل أهمية - ركّز على جودة المهمة بدلًا من إدارة السياق المكثّفة. مع ذلك، تظل الممارسات الجيدة تحسّن الكفاءة والتنظيم.
  </Tab>
</Tabs>

***

## الأسئلة الشائعة [#الأسئلة-الشائعة]

<Accordion title="ما الفرق بين نافذتَي سياق 200 ألف ومليون؟">
  تتمتع النماذج القياسية (Claude 4.5 Sonnet، Haiku، GPT-5، GPT-5-Codex، MiniMax-M2) بنوافذ سياق تحتوي `200K` رمز، وهي كافية لمعظم المهام. يوفّر Claude Sonnet 4.5 سياقًا موسّعًا بحجم `1M` رمز (أكبر بخمس مرات) لقواعد الكود الكبيرة التي تحتوي على ملفات `1000+`، أو إعادة الهيكلة المعقدة متعددة الملفات، أو جلسات التطوير الطويلة. يُفعَّل السياق `1M` تلقائيًا عندما يتجاوز المدخل `200K` رمز، أو يمكن تحديده صريحًا.
</Accordion>

<Accordion title="هل يجب أن أعيد ضبط السياق يدويًا أم يقوم Verdent بذلك تلقائيًا؟">
  يجب عليك بدء جلسة جديدة يدويًا لإعادة ضبط السياق - لا يقوم Verdent بمسح السياق تلقائيًا. أفضل الممارسات: أعد الضبط بعد إنهاء وحدة عمل متكاملة، واختبارها، وتسجيل الالتزام في نظام التحكم بالإصدارات. بالنسبة لسياقات رمز `1M`، تكون الحاجة إلى إعادة الضبط أقل تكرارًا بكثير.
</Accordion>

<Accordion title="كم عدد الملفات التي يمكنني تحميلها بأمان في السياق؟">
  لا يوجد حد ثابت للملفات - يعتمد ذلك على حجم الملفات وإجمالي عدد الرموز. بالنسبة لسياقات `200K`، تجنّب تحميل `20+` ملف كبير (كل منها `>1000` سطر). ركّز على الملفات المرتبطة مباشرة بمهمتك الحالية. استخدم `@-mentions` بشكل انتقائي، واستفد من وثائق `AGENTS.md` بدلًا من تحميل ملفات أمثلة كثيرة. مع سياق `1M`، يصبح اختيار الملفات أقل أهمية بكثير.
</Accordion>

<Accordion title="ما الذي يُحتسب ضمن نافذة السياق الخاصة بي؟">
  كل شيء في جلستك: جميع الرسائل في المحادثة، محتوى الملفات المحمّلة في السياق، مخرجات الأدوات (نتائج grep/البحث، قراءات الملفات)، الـ prompts والتعليمات الخاصة بالنظام، وتعريفات خادم MCP. كل واحد من هذه العناصر يستهلك رموزًا من سعة السياق الإجمالية لديك.
</Accordion>

<Accordion title="هل إعادة ضبط السياق ستُفقدني عملي؟">
  لا - إعادة ضبط السياق تمسح فقط سجل المحادثة والملفات المحمّلة من الذاكرة. تغييرات الكود الفعلية والالتزامات وتعديلات الملفات محفوظة. سجّل عملك دائمًا في نظام التحكم بالإصدارات قبل إعادة ضبط السياق للأمان. أعد الضبط ← ابدأ جلسة جديدة ← استمر في العمل على المهمة التالية.
</Accordion>

***

## انظر أيضًا [#انظر-أيضًا]

<CardGroup cols="3">
  <Card title="هندسة الـ Prompt" icon="message" href="/docs/verdent-for-vscode/best-practices/prompts">
    أفضل الممارسات لكتابة prompts فعّالة
  </Card>

  <Card title="أنماط التنفيذ" icon="toggle-on" href="/docs/verdent-for-vscode/execution-modes/overview">
    فهم أنماط التنفيذ وآثارها على الموارد
  </Card>

  <Card title="إدارة الموارد" icon="chart-line" href="/docs/verdent-for-vscode/resource-management/monitoring">
    مراقبة استخدام الرموز والأرصدة والأداء
  </Card>
</CardGroup>