# نظرة عامة (/ar/docs/verdent-for-vscode/core-features/overview)

> نظرة عامة على قدرات Verdent المدعومة بالذكاء الاصطناعي في التطوير



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

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

* قدرات سير العمل الأساسية (Professional Plan، Code Diff، Verify)
* إدراك السياق والوكلاء الفرعيون المتخصصون
* أوضاع التعاون وإمكانيات التوسّع

***

يُبنى سير عمل Verdent على ثلاث مراحل أساسية:

* **Plan** - توضيح المتطلبات مع Plan Mode
* **Code** - مراجعة وتنقيح باستخدام Code Diff لتسليم موثوق
* **Verify** - أتمتة الاختبار باستخدام أدوات Verify واكتشاف المشكلات مبكرًا

تعمل هذه الميزات معًا لضمان الدقة والتحكم طوال عملية التطوير.

***

## ميزات سير العمل الأساسية [#ميزات-سير-العمل-الأساسية]

<CardGroup cols="2">
  <Card title="سير عمل Plan-Code-Verify" icon="crosshairs" href="verdent-for-vscode/core-features/plan-code-verify-loop">
    تحكم دقيق في المتطلبات والتنفيذ والتحقق من خلال الوكيل الفرعي للتحقق وأدوات المتصفح
  </Card>

  <Card title="Professional Plan" icon="diagram-project" href="/docs/verdent-for-vscode/core-features/professional-plan">
    حوّل الأفكار إلى خطط تنفيذ جاهزة للإنتاج من خلال توضيح ذكي للمتطلبات
  </Card>

  <Card title="Code Diff" icon="code-compare" href="/docs/verdent-for-vscode/core-features/code-diff">
    مراجعة كود بمستوى المؤسسات مع ملخصات بلغة طبيعية وتحليل بمستوى مهندس أول
  </Card>

  <Card title="حلقة التوضيح" icon="message-dots" href="/docs/verdent-for-vscode/core-features/clarification-loop">
    تخطيط أذكى من خلال نقاش وتنقيح مستمرَّين للمتطلبات
  </Card>

  <Card title="قواعد التخطيط" icon="list-check" href="/docs/verdent-for-vscode/core-features/plan-rules">
    خصّص طريقة عرض التوضيحات والخطط بناءً على دورك وخلفيتك المهنية
  </Card>
</CardGroup>

***

## قدرات إضافية [#قدرات-إضافية]

### إدراك السياق: فهم عميق لقاعدة الكود [#إدراك-السياق-فهم-عميق-لقاعدة-الكود]

يُتيح نظام إدارة السياق في Verdent فهمًا شاملًا للمشروع:

#### نافذة سياق ضخمة [#نافذة-سياق-ضخمة]

* **سعة مليون رمز (Token)** - استيعاب قواعد كود متوسطة الحجم بالكامل (حوالي 750,000 كلمة أو أكثر من 3,000 ملف)
* **تحميل سياق ذكي** - يُعطي الأولوية تلقائيًا للملفات ذات الصلة بناءً على سياق المهمة
* **تحسين سياق الوكلاء الفرعيين** - تفويض المهام المتخصصة لوكلاء فرعيين مُركّزين

#### تعلّم تكيّفي [#تعلّم-تكيّفي]

* **اكتشاف الأعراف** - يتعلّم الأنماط الخاصة بالمشروع (التسمية، تنظيم الملفات، معالجة الأخطاء)
* **محاكاة الأسلوب** - يولّد كودًا يطابق الأسلوب الحالي (المسافات البادئة، وضع الأقواس، التعليقات)
* **إدراك المكتبات** - يتعرّف على الأطر المستخدمة، ويُفضّلها على إضافة تبعيات جديدة

#### تماسك عبر الملفات [#تماسك-عبر-الملفات]

* **تتبّع التبعيات** - يفهم الاستيرادات والتصديرات والعلاقات بين الوحدات
* **توقّع الأثر** - يحدّد المكوّنات المتأثرة بالتغييرات المقترحة
* **فرض الاتساق** - يضمن توافق التعديلات مع البنية الحالية

***

### الوكلاء الفرعيون المتخصصون: تقسيم العمل [#الوكلاء-الفرعيون-المتخصصون-تقسيم-العمل]

ينسّق Verdent وكلاء ذكاء اصطناعي متخصصين ومُحسّنين لمهام تطوير محددة:

<Tabs>
  <Tab title="وكيل الاستكشاف">
    **الغرض:** تصفّح وتحليل سريع ومبني على الأدلة لقاعدة الكود

    **القدرات:**

    * **مطابقة الأنماط** - تحديد موقع الملفات باستخدام أنماط glob (مثلًا كل ملفات TypeScript، ملفات API الخاصة بالخلفية)
    * **البحث الدلالي** - العثور على الكود حسب الوظيفة (مثلًا "أين تُنفَّذ طبقة مصادقة middleware؟")
    * **التجميع من مواقع متعددة** - تجميع المعلومات من ملفات متعددة

    **مستويات الدقة:**

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

    **حالات الاستخدام:** "ابحث عن جميع دوال استعلام قاعدة البيانات"، "حدد موقع منطق تحميل الإعدادات"، "كيف يعالج التطبيق الأخطاء؟"
  </Tab>

  <Tab title="وكيل التحقق">
    **الغرض:** فحوصات سريعة لجودة الكود والتحقق منها

    **القدرات:**

    * **فحوصات Lint** - ESLint وPylint وRubocop وغيرها
    * **التحقق من الأنواع** - فحص أنواع TypeScript وmypy وFlow
    * **تنفيذ اختبارات سريع** - اختبارات وحدة مستهدفة ضمن ميزانية زمنية أقل من 30 ثانية
    * **تحقق مُركّز على الفروقات (Diff)** - يتحقق بشكل أساسي من الكود المتغيّر لتحقيق الكفاءة

    **فلسفة الفشل السريع:** يُعيد تقارير أخطاء منظّمة عند أول مشكلة حقيقية، تجنبًا لهدر الوقت

    **حالات الاستخدام:** فحوصات ما قبل الـ commit، التحقق بعد الإصلاح، اختبارات سلامة سريعة
  </Tab>

  <Tab title="وكيل مراجعة الكود">
    **الغرض:** تدقيق شامل لجودة الكود والأمان وقابلية الصيانة

    **القدرات:**

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

    **عمق المراجعة:** أعمق من وكيل التحقق، مناسب لمراجعات طلبات السحب (PR) قبل الدمج

    **حالات الاستخدام:** مراجعة اكتمال الميزة، تدقيق أمني، التحقق من إعادة الهيكلة
  </Tab>
</Tabs>

***

### أوضاع تعاون مرنة [#أوضاع-تعاون-مرنة]

اختر مستوى الاستقلالية الذي يناسب سير عملك:

* **Auto Run Mode** - ينفّذ المهام بشكل مستقل مع إخطارك بالإجراءات التي قد تنطوي على مخاطر
* **Manual Accept Mode** - يتطلّب موافقتك على كل تغيير قبل تنفيذه
* **Skip Permissions Mode** - تنفيذ مستقل بالكامل، بما في ذلك العمليات المحفوفة بالمخاطر (للمستخدمين المتقدمين فقط)

راجع [أوضاع التنفيذ والصلاحيات](/docs/verdent-for-vscode/execution-modes/overview) للاطلاع على توثيق مفصّل للأوضاع.

***

### تكامل MCP (Model Context Protocol) [#تكامل-mcp-model-context-protocol]

يُتيح التشغيل البيني مع الأدوات والخدمات الخارجية:

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

راجع [التكامل والإضافات](/docs/verdent-for-vscode/advanced-features/integrations) للاطلاع على إعداد وتهيئة MCP.

***

### ميزات إضافية [#ميزات-إضافية]

<Tabs>
  <Tab title="اختيار النموذج تلقائيًا">
    **تحسين ذكي للنموذج:**

    يختار Verdent تلقائيًا أنسب نموذج ذكاء اصطناعي لكل مهمة بناءً على التعقيد ومتطلبات الأداء واعتبارات التكلفة.

    **الميزات:**

    * **تحليل المهمة** - تقييم تعقيد المهمة لتحديد النموذج الأمثل
    * **موازنة الأداء** - يوازن بين السرعة والدقة والتكلفة
    * **اختيار مراعٍ للسياق** - يعدّل اختيار النموذج بناءً على حجم المشروع ومتطلباته
    * **تحسين التكلفة** - يستخدم نماذج أخف للمهام البسيطة، ويخصص النماذج القوية للعمليات المعقدة

    **الفوائد:** يعظّم الكفاءة مع تقليل استهلاك الأرصدة، لضمان حصولك على أفضل النتائج دون إنفاق زائد.
  </Tab>

  <Tab title="الإشارة إلى السياق">
    **تحكم دقيق في السياق:**

    أرفق ملفات أو مجلدات أو أقسام كود محددة مباشرة في المحادثة باستخدام إشارات `@` لتوفير سياق مستهدف لمساعدة الذكاء الاصطناعي.

    **كيفية العمل:**

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

    **حالات الاستخدام:**

    * تركيز الذكاء الاصطناعي على وحدات محددة عند تصحيح الأخطاء
    * تضمين ملفات الإعدادات عند مناقشة الإعداد
    * الإشارة إلى المكوّنات ذات الصلة عند تنفيذ الميزات
    * توفير سياق التوثيق للحصول على إرشاد دقيق
  </Tab>

  <Tab title="الدعم البصري">
    **إدخال متعدد الوسائط:**

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

    **حالات الاستخدام المدعومة:**

    * **تصميم UI/UX** - ارفع نماذج أولية أو مخططات أو لقطات تصميم لتنفيذ دقيق بكسل بكسل
    * **تقارير الأخطاء** - شارك لقطات شاشة للأخطاء أو الخلل البصري لتشخيص أسرع
    * **تطوير الواجهة الأمامية** - قدّم مراجع تصميم للحصول على تنسيق وتخطيط دقيقين
    * **التوثيق** - أدرج مخططات أو رسوم بيانية أو تصورات معمارية

    **المواصفات التقنية:**

    * **الصيغ المدعومة:** PNG وJPG وJPEG وGIF وBMP وWebP
    * **أقصى دقة:** 2000×2000 بكسل
    * **حد حجم الملف:** 5 ميغابايت (يُضغط تلقائيًا في حال التجاوز؛ يظهر خطأ إذا تجاوز 5 ميغابايت بعد الضغط)

    **الفوائد:** يزيل الغموض في المتطلبات البصرية ويُسرّع سير عمل تطوير الواجهة الأمامية.
  </Tab>

  <Tab title="سجل المشروع">
    **إدارة الجلسات:**

    اطّلع على سجل محادثاتك وأدرها لمراجعة التفاعلات والقرارات وتفاصيل التنفيذ السابقة.

    **الميزات:**

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

    **الفوائد:** حافظ على الاستمرارية عبر الجلسات، دقّق توصيات الذكاء الاصطناعي، وتتبّع تطوّر المشروع بمرور الوقت.
  </Tab>

  <Tab title="مركز المستخدم">
    **إدارة الحساب:**

    مركز موحّد لإدارة حساب Verdent الخاص بك، والأرصدة، وإعدادات الإضافة.

    **عناصر التحكم المتاحة:**

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

    **الوصول:** متاح من خلال الشريط الجانبي لـ Verdent في VS Code.
  </Tab>

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

    أرسل ملاحظاتك وتقارير الأخطاء وطلبات الميزات مباشرة من VS Code للمساعدة في تحسين Verdent.

    **خيارات إرسال الملاحظات:**

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

    **ما الذي يجب الإبلاغ عنه:**

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

    **الأثر:** تؤثر ملاحظاتك مباشرة في خارطة طريق تطوير Verdent وتساعد في تحسين التجربة لجميع المستخدمين.
  </Tab>
</Tabs>

***

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

<CardGroup cols="3">
  <Card title="البدء" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    ابدأ استخدام Verdent خلال دقائق
  </Card>

  <Card title="إدارة الوكلاء الفرعيين" icon="users" href="/docs/verdent-for-vscode/agents-rules/subagent-management">
    قم بتهيئة الوكلاء الفرعيين المتخصصين
  </Card>
</CardGroup>