المفاهيم الأساسية
فهم بنية Verdent والمصطلحات الرئيسية
يمنح Verdent for VS Code الدقة والتحكم للتطوير المدعوم بالذكاء الاصطناعي. تعتمد أدوات البرمجة بالذكاء الاصطناعي التقليدية على تخمين نيتك. أما Verdent فيتيح لك رؤية ما سيفعله الذكاء الاصطناعي بالضبط قبل تنفيذه، والتحقق من صحة عمله، وتسليم كود موثوق في كل مرة.
خطّط أولًا، تحقّق مبكرًا، وسلّم كودًا موثوقًا
يقوم سير عمل Verdent على ثلاث مراحل أساسية:
- التخطيط - قبل تنفيذ أي شيء، تجري حلقة توضيح مع الذكاء الاصطناعي. يمكنك تخصيص سلوكه عبر قواعد التخطيط، واستخدام التخطيط التفاعلي للبنية، والمخططات المرئية، وتقسيم المهام لجعل متطلباتك واضحة تمامًا
- الكود - راجع التغييرات بتحليل Code Diff بمستوى المؤسسات، وسلّم نتائج جاهزة للإنتاج بثقة
- التحقق - ضمان الجودة عبر الوكيل الفرعي Verify وإجراءات المتصفح. كرّر دورات الإصلاح متعددة المراحل حتى يجتاز الكود التحقق الشامل
فهم هذه المفاهيم الأساسية وبنية Verdent سيساعدك على العمل بفعالية أكبر مع الامتداد.
لمعرفة المزيد: سير عمل التخطيط-الكود-التحقق
نظرة عامة على البنية
يتم تفكيك المهام المعقدة وتفويضها إلى وكلاء ذكاء اصطناعي متخصصين مُحسّنين لأغراض محددة. يعمل كل وكيل فرعي بموجه نظام مخصص خاص به ونافذة سياق منفصلة، معزولة عن الوكيل الرئيسي الذي استدعاه.
يحافظ هذا الفصل على أعلى مستويات الأداء ويمنع تلوث السياق، مما يسمح لكل وكيل فرعي بالتركيز على مهمته المتخصصة دون إثقال الوكيل الرئيسي بكل تفصيل تنفيذي.
الوكلاء الفرعيون الافتراضيون المدمجون:
يتضمن Verdent ثلاثة وكلاء فرعيين افتراضيين متاحين فورًا:
| الوكيل الفرعي | الغرض | متى يُستخدم |
|---|---|---|
| @Verifier | فحوصات سريعة للكود والتحقق منه | أثناء مهام البرمجة لضمان جودة الكود وصحته |
| @Explorer | استكشاف سريع لقاعدة الكود | العثور على الملفات والإجابة عن أسئلة حول بنية قاعدة الكود لديك |
| @Code-reviewer | تقييم فوري لجودة الكود | الفحص الاستباقي للأمان وقابلية الصيانة ومشكلات الأداء |
الوكلاء الفرعيون المخصصون:
يمكنك إنشاء وكلاء فرعيين مخصصين يلبّون احتياجاتك المحددة. يعمل كل وكيل فرعي مخصص بموجه نظام خاص به، مما يتيح لك تحديد سلوك متخصص لمهام أو سير عمل معينة.
يمكن استدعاء الوكلاء الفرعيين المخصصين تلقائيًا بناءً على أنماط المهام أو يدويًا باستخدام إشارات @-mention. تشمل حالات الاستخدام الشائعة:
- متخصصو المكدس التقني - محسّن أداء React، محسّن استعلامات SQL، مراجع تهيئة Docker
- ضمان الجودة - محلّل تغطية الاختبارات، مراجع معالجة الأخطاء، تطبيق معايير التسجيل (logging)
- سير عمل خاص بالفريق - تطبيق معايير أسلوب الكود، مدقق اتساق التوثيق، مدقق التبعيات
- احتياجات خاصة بالمشروع - تحديث الكود القديم، مساعد الترحيل، تطبيق ميزانية الأداء
لمعرفة المزيد: إدارة الوكلاء الفرعيين
أوضاع التنفيذ
يدعم Verdent أوضاع تنفيذ متعددة تتحكم في كيفية تعامل الذكاء الاصطناعي مع الأذونات والتفاعلات:
أوضاع الأذونات:
- Manual Accept Mode - يطلب الإذن عند أول استخدام لكل أداة. الأنسب للتعلّم والتطوير العام مع أقصى قدر من التحكم.
- Auto-Run Mode (افتراضي) - يقبل الأذونات تلقائيًا للعمليات الآمنة (قراءة الملفات، عمليات البحث على الويب). لا تزال تعديلات الملفات وتنفيذ الأوامر تتطلب الموافقة. مثالي للمشاريع الموثوقة والنماذج الأولية السريعة.
- Skip Permissions Mode - تشغيل مستقل بالكامل يتجاوز جميع الطلبات. للبيئات المعزولة والآمنة فقط مثل الاختبار الآلي أو بيئات الاختبار المعزولة (sandboxes).
للتبديل بين أوضاع الأذونات، حدد زر Switch Permission في مربع الإدخال (يعرض الوضع الحالي مثل "Manual" أو "Auto") واختر الوضع المطلوب من القائمة المنسدلة.
تبديل الوضع (يتحكم في أسلوب التفاعل):
- Agent Mode - سلوك وكيلي كامل مع تنفيذ مستقل للمهام وعمليات على الملفات
- Plan Mode - تفاعل يركّز على التخطيط لمراجعة الأساليب قبل التنفيذ
- Chat Mode - تفاعل حواري بدون عمليات مستقلة على الملفات
للتبديل بين أساليب التفاعل، حدد زر Switch Mode في مربع الإدخال (يعرض الوضع الحالي مثل "Agent" أو "Plan") واختر الوضع المطلوب من القائمة المنسدلة.
أوضاع إضافية:
- Think Hard Mode - يخصص أقصى قدر من الموارد الحاسوبية لتحليل المشكلات بعمق، واستكشاف أساليب متعددة، وتقديم حلول أكثر شمولية. مثالي لقرارات البنية المعمارية، والتصحيح المعقد، والمهام التي تتطلب استدلالًا متطورًا.
لتفعيل Think Hard Mode، حدد زر Think Hard في مربع الإدخال قبل إرسال طلبك.
لمعرفة المزيد: نظرة عامة على أوضاع التنفيذ
إدارة السياق
تتحكم إدارة السياق في المعلومات التي يمكن لـ Verdent الوصول إليها أثناء جلستك. نافذة السياق هي حد ذاكرة الوكيل، وتُقاس بالرموز (tokens) وتُشارَك بين عدة مكونات: تعليمات النظام، ومحتويات الملفات، ورسائل المحادثة، واستجابات الوكيل.
كيف يعمل السياق:
- إشارات @-Mention - أضف الملفات إلى السياق صراحةً باستخدام
@filename.jsللتحكم الدقيق - التحميل التلقائي - يُدرج Verdent تلقائيًا الملفات ذات الصلة بناءً على المهمة
- سياق منفصل للوكيل الفرعي - يعمل كل وكيل فرعي بنوافذ سياق معزولة، مما يمنع تلوث ذاكرة الوكيل الرئيسي
- حدود نافذة السياق - سياق محدود يُقاس بالرموز. مع نمو المحادثات، تتقلص المساحة المتاحة ويتراجع أداء النموذج
أفضل الممارسات:
- قسّم المهام الكبيرة إلى أجزاء أصغر بنقاط توقف طبيعية
- استخدم Plan Mode للمهام المعقدة لمراجعة الأساليب قبل التنفيذ
- أكمل المكونات الفردية قبل الدمج لتجنب استنفاد السياق
- ابدأ محادثة جديدة عند بدء مهمة جديدة لمسح السياق والحفاظ على الأداء الأمثل
لمعرفة المزيد: أفضل ممارسات إدارة السياق
اختيار النموذج
ينسّق Verdent نماذج من عدة مزوّدي ذكاء اصطناعي (Claude، GPT-5، Gemini، MiniMax) ضمن سير عمل واحد. يمكن لكل وكيل متخصص الاستفادة من النموذج الأمثل لمهمته المحددة.
النماذج المُعدّة مسبقًا:
- الأداء - أقصى سياق، أحدث النماذج المتطورة (استهلاك أرصدة 1-2x)
- التوازن - مزيج مثالي بين الأداء والتكلفة (استهلاك أرصدة 1x)
- الكفاءة - مهام سريعة وسريعة الاستجابة وفعالة من حيث التكلفة (استهلاك أرصدة ~0.3x)
النماذج الفردية المتاحة:
| المزوّد | النموذج | الأنسب لـ | كفاءة التكلفة |
|---|---|---|---|
| Anthropic | Claude 4.5 Opus | ممتاز لمهام البرمجة العميقة وحل المشكلات. | تكلفة 1.5x |
| Anthropic | Claude 4.5 Sonnet | مهام معقدة متوازنة | خط أساس 1x |
| Anthropic | Claude 4.5 Sonnet 1M | مهام طويلة أو معقدة (>200 ألف مُدخل) | كفاءة 0.5x (تكلفة 2x) |
| Anthropic | Claude 4.5 Haiku | مهام سريعة وبسيطة | أكفأ 3.2 مرة من Sonnet |
| OpenAI | GPT-5 (تجريبي) | الاستدلال والإبداع | أكفأ 1.3 مرة من Sonnet |
| OpenAI | GPT-5 Codex (تجريبي) | البرمجة والتصحيح | أكفأ 1.3 مرة من Sonnet |
| Gemini 3 Pro | استدلال متقدم ومتعدد الوسائط | متغيرة | |
| Kimi | Kimi 2 Turbo (تجريبي) | نموذج فائق السرعة للبرمجة | أكفأ 3.1 مرة من Sonnet |
لمعرفة المزيد: إعدادات التهيئة
الأسئلة الشائعة
ما هو تلوث السياق؟
عندما تُنشئ الإجراءات والمعلومات السابقة في السياق أنماط سلوك غير مقصودة تؤثر على المهام المستقبلية. على سبيل المثال، إذا قمت مرارًا بتحديث الكود ثم نشره، فقد يبدأ الوكيل بربط كل تحديثات الكود بالنشر الفوري، حتى عندما تكون مجرد تجرّب أمرًا ما. تمنع الوكلاء الفرعيون تلوث السياق من خلال العمل بنوافذ سياق معزولة، مما يسمح لكل مهمة متخصصة بالبدء بسياق نظيف وتجنّب التلوث المتبادل بين أنواع العمل المختلفة.
ما هي العمليات الآمنة؟
عمليات تقرأ البيانات فقط دون إجراء تغييرات: قراءة الملفات والبحث على الويب. تُعتمد هذه تلقائيًا في Auto-Run Mode، بينما لا تزال تعديلات الملفات وتنفيذ الأوامر تتطلب الموافقة للحفاظ على الأمان.
ما هو تنفيذ الأوامر؟
تشغيل أوامر الطرفية أو نصوص shell عبر Verdent، بما في ذلك عمليات مثل تشغيل الاختبارات، أو تثبيت الحزم، أو تنفيذ أوامر البناء. يتطلب تنفيذ الأوامر موافقة في معظم أوضاع الأذونات لمنع تغييرات غير مقصودة في النظام.
ما هو الرمز (token)؟
وحدة قياس نوافذ السياق. تمثل الرموز أجزاء من النص (كلمات، أجزاء من كلمات، أو أحرف) التي يعالجها نموذج الذكاء الاصطناعي. تُقاس حدود السياق بالرموز وليس بالأحرف أو الكلمات، حيث تستهلك المحادثات النموذجية آلاف الرموز.
ما هي الأرصدة؟
عملة الاستخدام في Verdent. تختلف كفاءة التكلفة بين النماذج (مثلًا، Haiku أكفأ 3.2 مرة من خط أساس Sonnet، وSonnet هو خط الأساس 1x). تتضمن خطة اشتراكك مخصصات شهرية من الأرصدة (مثلًا، 640 رصيدًا لخطة Starter، و2,000 لخطة Pro، و6,000 لخطة Max).
ما هي دورة التوليد-الاختبار-الإصلاح متعددة المراحل؟
عملية تحقق تكرارية يُولَّد فيها الكود ويُختبر ويُصلح حتى يجتاز الاختبار الشامل. يقوم Verdent تلقائيًا بتشغيل الاختبارات، وتحليل الإخفاقات، وإصلاح المشكلات، وإعادة الاختبار عبر مراحل متعددة حتى يعمل الكود بشكل صحيح. يوفّر ذلك كودًا جاهزًا للإنتاج، وليس مجرد اقتراحات. تتضمن كل نتيجة ملخصات مفصّلة وفروقات كود (diffs) توضح بالضبط ما تغيّر.