الإعداد والتخصيص

يوفر Verdent for VS Code خيارات إعداد واسعة للتكيف مع سير عملك التطويري، وتفضيلاتك في كتابة الكود، ومعايير فريقك. اضبط الإعدادات من خلال واجهة الإعدادات الأصلية في VS Code، وخصص اختصارات لوحة المفاتيح، وأنشئ قواعد ووكلاء فرعيين لسلوكيات متخصصة.

ما ستتعلمه

• ضبط إعدادات امتداد VS Code الخاصة بـ Verdent
• تخصيص اختصارات لوحة المفاتيح لسير عمل أكثر كفاءة
• إنشاء القواعد وإدارتها لتخصيص سلوك الوكيل
• بناء وكلاء فرعيين مخصصين لمهام متخصصة

المتطلبات الأساسية

• تثبيت Verdent for VS Code وتسجيل الدخول
• إمكانية الوصول إلى إعدادات VS Code (Cmd+, أو Ctrl+,)
• فهم أساسي لصيغة JSON لملفات القواعد (اختياري)

إعدادات امتداد VS Code

يمكن الوصول إلى إعدادات Verdent for VS Code من مواقع متعددة حسب نوع الإعداد ونطاقه.

الوصول إلى الإعدادات

إعدادات الامتداد (أصلية في VS Code):

1. افتح إعدادات VS Code: Cmd+, (macOS) أو Ctrl+, (Windows/Linux)
2. ابحث عن "Verdent" في شريط بحث الإعدادات
3. عدّل إعدادات الامتداد (مثل verdent.enableCheckpoints)

إعدادات خاصة بـ Verdent:

انقر على زر الإعدادات في الشريط العلوي لـ Verdent للوصول إلى:

• القواعد - قواعد المستخدم، قواعد المشروع، قواعد الخطة
• خوادم MCP - إعدادات بروتوكول سياق النموذج (MCP)
• الوكلاء الفرعيون - إدارة الوكلاء الفرعيين المخصصين

عناصر التحكم داخل المحادثة:

يمكن تبديل العديد من الإعدادات مباشرة من مربع الإدخال أسفل لوحة Verdent:

• تبديل الصلاحية - قبول يدوي، تشغيل تلقائي، خطة، تجاوز الصلاحيات
• تبديل الوضع - أوضاع الوكيل، الخطة، المحادثة
• تبديل/تخصيص نموذج الذكاء الاصطناعي - إعدادات مسبقة للأداء، التوازن، الكفاءة
• Think Hard Mode - أقصى ميزانية تفكير للاستدلال المعقد
• إضافة سياق - إرفاق الملفات باستخدام الإشارات بـ @
• إضافة صور أو ملفات - تضمين لقطات شاشة أو مستندات
• إضافة وكيل فرعي - التفويض لوكلاء فرعيين متخصصين

تُطبَّق تغييرات الإعدادات فورًا دون الحاجة لإعادة تشغيل VS Code.

إعدادات الامتداد المتاحة

يوفر Verdent for VS Code إعدادين أساسيين للامتداد يمكن ضبطهما من خلال واجهة إعدادات VS Code:

مرجع عناصر تحكم مربع الإدخال

يوفر مربع الإدخال أسفل لوحة Verdent وصولاً سريعًا إلى عناصر التحكم في الإعداد:

أوضاع الصلاحيات

الإعدادات المسبقة للنموذج

تخصيص اختصارات لوحة المفاتيح

الاختصارات الافتراضية

الاختصار الأساسي:

• macOS: Cmd+L - فتح/تركيز لوحة Verdent
• Windows/Linux: Ctrl+L - فتح/تركيز لوحة Verdent
  • الأمر: verdent.addToChat
  • يعمل من لوحة الأوامر وسياق المحرر

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

أوامر إضافية:

متاحة عبر لوحة الأوامر (يمكن تخصيص الاختصارات الافتراضية):

• verdent.addFeedBack - تقديم ملاحظات
• verdent.addTerminalOutputToChat - إضافة مخرجات الطرفية إلى Verdent
• verdent.addToChatBySearch - الإضافة إلى Verdent عبر البحث
• verdent.centerButtonClicked - مركز المستخدم
• verdent.historyButtonClicked - سجل المشروع
• verdent.mcpButtonClicked - إضافة خادم MCP
• verdent.openInNewTabByParams - فتح في تبويب جديد
• verdent.plusButtonClicked - جلسة جديدة
• verdent.rulesButtonClicked - إعدادات القواعد
• verdent.SettingClicked - قائمة الإعدادات
• verdent.subagentButtonClicked - إضافة وكيل فرعي

تخصيص الاختصارات

يمكن تخصيص جميع اختصارات لوحة المفاتيح الخاصة بـ Verdent باستخدام نظام ربط المفاتيح القياسي في VS Code.

{
  "key": "cmd+shift+v",
  "command": "verdent.addToChat"
}

{
  "key": "ctrl+shift+v",
  "command": "verdent.addToChat"
}

نطاق التخصيص:

• يمكن إعادة ربط جميع أوامر Verdent
• يمكن تعيين اختصارات متعددة لنفس الأمر
• يمكن إزالة الاختصارات الافتراضية
• تتزامن التغييرات عبر الأجهزة مع مزامنة إعدادات VS Code

الاختصارات الخاصة بالمنصة

يتبع Verdent اتفاقيات لوحة المفاتيح الخاصة بمنصة VS Code:

أنماط شائعة:

• الإعدادات: Cmd+, (macOS) مقابل Ctrl+, (Windows/Linux)
• لوحة الأوامر: Cmd+Shift+P (macOS) مقابل Ctrl+Shift+P (Windows/Linux)
• اختصارات لوحة المفاتيح: Cmd+K Cmd+S (macOS) مقابل Ctrl+K Ctrl+S (Windows/Linux)

التعليمات المخصصة والشخصيات

يدعم Verdent for VS Code نظامين لتخصيص سلوك الذكاء الاصطناعي: القواعد للتفضيلات والإرشادات، والوكلاء الفرعيون لشخصيات المهام المتخصصة.

نظام القواعد

تحدد القواعد كيفية تصرف Verdent واستجابته أثناء جلسات البرمجة. تُخزَّن القواعد في ملفات Markdown وتُطبَّق باستمرار طوال المحادثات.

ثلاثة أنواع من القواعد

1. قواعد المستخدم (VERDENT.md):

• الموقع: ~/.verdent/ (دليل الإعداد العام)
• النطاق: تُطبَّق على جميع المحادثات عبر جميع المشاريع
• الغرض: تفضيلات البرمجة الشخصية، أسلوب التواصل، معايير التوثيق

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

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

3. قواعد الخطة (plan_rules.md):

• الموقع: ~/.verdent/ (دليل الإعداد العام)
• النطاق: تُطبَّق عند استخدام Plan Mode عبر جميع المشاريع
• الغرض: تخصيص محتوى الخطة وتنسيقها ومستوى تفاصيلها

إنشاء القواعد وتعديلها

مثال على قواعد المستخدم:

# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing code

مثال على قواعد المشروع:

## Testing instructions
- Run `pnpm turbo run test --filter <project_name>` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes

## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing

تخزين القواعد وتطبيقها

أولوية الإعداد:

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

1. قواعد المشروع (AGENTS.md) - الأولوية الأعلى (خاصة بالمشروع)
2. قواعد المستخدم (VERDENT.md) - تفضيلات المستخدم العامة
3. السلوك الافتراضي - الإعدادات الافتراضية المضمّنة في Verdent

الوكلاء الفرعيون

الوكلاء الفرعيون هم وكلاء ذكاء اصطناعي متخصصون بـ prompts نظام مخصصة ونوافذ سياق معزولة للتعامل مع مهام محددة.

الوكلاء الفرعيون المضمّنون

يتضمن Verdent ثلاثة وكلاء فرعيين افتراضيين متاحين فورًا دون إعداد:

إنشاء وكلاء فرعيين مخصصين

تنسيق ملف الوكيل الفرعي:

---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt

You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues

Invocation policy (strict): Only run security-reviewer if user explicitly requests it.

When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment

When NOT to use:
- General code review without security focus
- Opening or reading files without analysis

إدارة الوكلاء الفرعيين

الوصول عبر الإعدادات ← الوكلاء الفرعيون لـ:

• التعديل: تعديل prompts النظام، وأذونات الأدوات، والإعدادات
• النسخ: تكرار الوكلاء الفرعيين لإنشاء نسخ متغيرة أو قوالب
• الحذف: إزالة الوكلاء الفرعيين غير المستخدمين
• التفعيل/التعطيل: تبديل التوفر دون حذف

استخدام الوكلاء الفرعيين

الوكلاء الفرعيون المضمّنون:

• استخدمهم بالإشارة إليهم بـ @: @Verifier، @Explorer، @Code-reviewer
• يُستدعون تلقائيًا عند اكتشاف أنواع المهام المناسبة

الوكلاء الفرعيون المخصصون:

• انقر على زر إضافة وكيل فرعي في مربع الإدخال
• حدد من القائمة المنسدلة
• يفوّض الوكيل الرئيسي المهام المناسبة تلقائيًا

الوكيل الفرعي مقابل القواعد

مثال على سير عمل:

1. قاعدة المستخدم: "إنشاء اختبارات وحدة لجميع الدوال الجديدة"
2. الوكيل الرئيسي: يكتشف الحاجة إلى إنشاء اختبارات
3. التفويض إلى وكيل فرعي لإنشاء الاختبارات: نهج اختبار شامل متخصص
4. الوكيل الفرعي: يُنشئ مجموعة اختبارات كاملة بسياق معزول
5. الوكيل الرئيسي: يستلم النتائج ويواصل دون تلويث السياق

الأسئلة الشائعة

اطّلع أيضًا