# تحسين الإعدادات (/ar/docs/verdent-for-vscode/configuration/tuning)

> تحسين Verdent لسير عملك



حسّن Verdent for VS Code لتحقيق التوازن بين السرعة والتكلفة والدقة وفقًا لمتطلبات سير عملك. اضبط الإعدادات المسبقة للنماذج، وأوضاع التنفيذ، واستراتيجيات إدارة السياق للحصول على أفضل أداء.

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

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

***

## ضبط الإعدادات وفقًا لسير عملك [#ضبط-الإعدادات-وفقًا-لسير-عملك]

### اختيار الإعداد المسبق للنموذج [#اختيار-الإعداد-المسبق-للنموذج]

اختر الإعداد المسبق المناسب للنموذج بناءً على تعقيد المهمة والميزانية:

| الإعداد المسبق        | التكلفة                       | كفاءة التكلفة                     | الأفضل لـ                                                  |
| --------------------- | ----------------------------- | --------------------------------- | ---------------------------------------------------------- |
| **الكفاءة**           | \~0.3x من التوازن (تخفيض 70%) | أكفأ بـ 3.2 مرة من Sonnet         | المهام البسيطة، الإصلاحات السريعة، النماذج الأولية السريعة |
| **التوازن** (افتراضي) | 1x كخط أساس                   | 1x كخط أساس                       | مهام التطوير العامة، البرمجة اليومية                       |
| **الأداء**            | 1-2x من التوازن               | 0.5x كفاءة (ضعف التكلفة، سياق 1M) | القرارات المعمارية المعقدة، إعادة الهيكلة الدقيقة          |

**نماذج إضافية:**

* **Claude-4.5-sonnet:** نموذج عام متوازن الأغراض (1x كخط أساس)
* **Claude-4.5-sonnet-1m:** سياق موسّع للمهام المعقدة (كفاءة 0.5x، ضعف التكلفة عندما يتجاوز الإدخال 200 ألف رمز)
* **Claude-4.5-haiku:** الأسرع والأكثر اقتصادًا (أكفأ بـ 3.2 مرة من Sonnet)
* **GPT-5 / GPT-5-codex:** يركّز على التفكير المنطقي والإبداع (تجريبي، أكفأ بـ 1.3 مرة من Sonnet)
* **Minimax-m2:** سريع وفعّال من حيث التكلفة (تجريبي، مجاني حتى 10 نوفمبر)

### ضبط وضع التنفيذ [#ضبط-وضع-التنفيذ]

<Tabs>
  <Tab title="تخطي الأذونات (السرعة)">
    * استقلالية تامة دون طلبات موافقة
    * لا انقطاعات بسبب الأذونات
    * أعلى درجة مخاطرة - استخدمه فقط في البيئات الآلية
  </Tab>

  <Tab title="التشغيل التلقائي (متوازن)">
    * الأوامر تتطلب موافقة، وعمليات الملفات تلقائية
    * تقليل طلبات الأذونات
    * مخاطرة أقل مع الحفاظ على الأمان للعمليات الخطرة
  </Tab>

  <Tab title="القبول اليدوي (الدقة)">
    * كل عملية تتطلب موافقة
    * رؤية وتحكم كاملان
    * الأبطأ لكن الأكثر أمانًا - الأفضل للتعلم وكود الإنتاج
  </Tab>

  <Tab title="التخطيط (المراجعة)">
    * تخطيط استراتيجي قبل التنفيذ
    * مرحلة تحليل للقراءة فقط
    * المراجعة والموافقة قبل إجراء أي تغييرات
  </Tab>
</Tabs>

### Think Hard Mode [#think-hard-mode]

فعّل هذا الخيار للمهام التي تتطلب استدلالًا معقدًا:

* **الدقة:** أقصى عمق للاستدلال في المسائل المعقدة
* **السرعة:** أبطأ بسبب زيادة موارد التفكير
* **الأفضل لـ:** القرارات المعمارية، التصحيح المعقد، التحليل الدقيق

***

## المفاضلة بين السرعة والدقة [#المفاضلة-بين-السرعة-والدقة]

وازن بين سرعة التنفيذ وعمق التحليل وفقًا لمتطلبات المهمة.

<Tabs>
  <Tab title="حالات تتطلب سرعة عالية">
    **التهيئة:**

    * **النموذج:** الإعداد المسبق للكفاءة (Claude-4.5-haiku)
    * **وضع الأذونات:** Auto-Run Mode
    * **وضع التنفيذ:** Agent Mode للتنفيذ المباشر
    * **حالات الاستخدام:** إصلاحات سريعة، عمليات روتينية، مهام بسيطة

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

    * أسرع أوقات استجابة
    * أقل انقطاعات
    * تخفيض التكلفة بنسبة 70% مقارنة بإعداد التوازن
  </Tab>

  <Tab title="حالات تتطلب دقة عالية">
    **التهيئة:**

    * **النموذج:** الإعداد المسبق للأداء (Claude-4.5-sonnet-1m)
    * **وضع الأذونات:** Manual Accept Mode
    * **وضع التنفيذ:** Plan Mode للمراجعة الاستراتيجية
    * **التفكير العميق:** مفعّل للاستدلال الدقيق
    * **حالات الاستخدام:** ميزات معقدة، كود الإنتاج، قرارات معمارية

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

    * أقصى نافذة سياق (1M رمز)
    * رؤية وتحكم كاملان
    * استدلال عميق للمسائل المعقدة
    * المراجعة قبل التنفيذ
  </Tab>

  <Tab title="النهج الهجين">
    يستفيد معظم المستخدمين من التبديل بين التهيئات حسب السياق:

    * **الإصلاحات السريعة:** الكفاءة + Agent Mode
    * **الميزات المعقدة:** التوازن/الأداء + Plan Mode
    * **الاستكشاف:** Plan Mode للاستراتيجية، ثم Agent Mode للتنفيذ

    **الاستراتيجية:** كيّف التهيئة حسب نوع المهمة بدلًا من استخدام نهج واحد يناسب الجميع.
  </Tab>
</Tabs>

<Tip>
  استخدم Auto-Run Mode للمشاريع الموثوقة لتقليل طلبات الأذونات مع الحفاظ على الأمان للعمليات الخطرة. هذا يبسّط سير العمل دون التضحية بالحماية الأساسية.
</Tip>

***

## التهيئة على مستوى مساحة العمل [#التهيئة-على-مستوى-مساحة-العمل]

يدعم Verdent التهيئة على مستوى كل مشروع وكل مساحة عمل لضمان الاتساق على مستوى الفريق.

### التهيئة الخاصة بالمشروع [#التهيئة-الخاصة-بالمشروع]

**قواعد المشروع (AGENTS.md):**

* **الموقع:** المجلد الجذر للمشروع أو مجلد مساحة العمل
* **النطاق:** يُطبَّق فقط على المشروع الحالي
* **التحكم في الإصدارات:** أضفه إلى git لتوحيد المعايير على مستوى الفريق
* **المحتوى:** معايير البرمجة، متطلبات الاختبار، الأنماط المعمارية

**مثال:**

```markdown filename="AGENTS.md"
# Project Rules

## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern

## Testing
- All endpoints require input validation
- Run tests before committing
```

### إعدادات مساحة عمل VS Code [#إعدادات-مساحة-عمل-vs-code]

اضبط إعدادات الامتداد على مستوى مساحة العمل:

**الموقع:** `.vscode/settings.json` في جذر مساحة العمل

**مثال:**

```json filename=".vscode/settings.json"
{
  "verdent.enableCheckpoints": true
}
```

### أولوية التهيئة [#أولوية-التهيئة]

عند تعارض التهيئات، يطبّق Verdent ترتيب الأولوية التالي:

1. **قواعد المشروع (AGENTS.md)** - الأولوية الأعلى (خاصة بالمشروع)
2. **إعدادات مساحة العمل** - إعدادات VS Code على مستوى مساحة العمل
3. **قواعد المستخدم (VERDENT.md)** - تفضيلات المستخدم العامة
4. **الإعدادات الافتراضية** - الإعدادات المدمجة في Verdent

***

## التخصيص الخاص بالمشروع [#التخصيص-الخاص-بالمشروع]

### إدارة السياق للمشاريع الكبيرة [#إدارة-السياق-للمشاريع-الكبيرة]

<Tabs>
  <Tab title="الوكلاء الفرعيون">
    * فوّض العمليات المعقدة لوكلاء فرعيين لهم نوافذ سياق منفصلة
    * فقط نتائج الوكيل الفرعي تستهلك من السياق الرئيسي، وليست العملية بأكملها
    * يمنع امتلاء السياق الرئيسي بتفاصيل التنفيذ
  </Tab>

  <Tab title="اختيار الملفات">
    * أضف صراحةً الملفات ذات الصلة فقط باستخدام `@filename`
    * تجنّب تحميل المشروع بأكمله إلى السياق دون داعٍ
    * استهدف مكونات محددة لتحليل مركّز
  </Tab>

  <Tab title="تقسيم المهام">
    * قسّم المهام الكبيرة إلى أجزاء أصغر قابلة للإنجاز
    * ابدأ جلسات جديدة للميزات أو المكونات المتمايزة
    * نقاط التوقف الطبيعية تمنع استنفاد السياق
  </Tab>

  <Tab title="Plan Mode">
    * راجع النهج قبل استهلاك سياق التنفيذ
    * يقلل من هدر السياق على تنفيذات خاطئة
    * لدى Plan Mode إدارة سياق منفصلة
  </Tab>
</Tabs>

### تحسين الأداء [#تحسين-الأداء]

**فعّل نقاط التحقق بشكل انتقائي:**

يستخدم إعداد `verdent.enableCheckpoints` نظام git للتحكم في الإصدارات:

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

<Tip>
  فعّل نقاط التحقق بشكل انتقائي للمهام الحرجة فقط، فالإفراط في استخدامها يبطئ سير العمل دون إضافة قيمة.
</Tip>

**اختيار النموذج:**

* استخدم الإعداد المسبق للكفاءة (Haiku) للمهام البسيطة والمعزولة
* خصّص الإعداد المسبق للأداء (Sonnet-1M) للعمليات كثيفة السياق
* استخدم إعداد التوازن للعمل العام

**وضع التنفيذ:**

* Auto-Run Mode يقلل السياق المستهلك بواسطة طلبات الأذونات
* Skip Permissions Mode يعظّم الكفاءة للبيئات الآلية

<Note>
  تُطبَّق قواعد المشروع المناسبة تلقائيًا في سيناريوهات مساحات العمل المتعددة عند التبديل بينها. لا حاجة لتبديل التهيئة يدويًا.
</Note>

<Tip>
  تتيح لك تهيئات مساحات العمل المتعددة تحسين الإعدادات وفقًا لنوع المشروع - بيئة تطوير مقابل إنتاج، أو مستودع أحادي (monorepo) مقابل خدمات مصغّرة (microservices).
</Tip>

***

## اطلع أيضًا على [#اطلع-أيضًا-على]

<CardGroup cols="2">
  <Card title="إعدادات التهيئة" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    خيارات التهيئة الكاملة واختيار النموذج
  </Card>

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