التثبيت
دليل خطوة بخطوة لتثبيت وإعداد Verdent
يشرح هذا الدليل كيفية تثبيت Verdent for VS Code من متجر Visual Studio Code وإتمام عملية المصادقة الأولية.
المتطلبات
قبل تثبيت Verdent، تأكد من أن نظامك يستوفي المتطلبات التالية:
متطلبات النظام
- Visual Studio Code: الإصدار 1.90.0 أو أحدث
- نظام التشغيل: macOS 11+، أو Windows 10+، أو Linux (Ubuntu 20.04+، Debian 10+، RHEL 8+)
- اتصال بالإنترنت: اتصال نشط مطلوب للتواصل مع خدمة الذكاء الاصطناعي
اختياري لكن موصى به
- Git: للتكامل مع نظام التحكم بالإصدارات وتتبع تغييرات الكود
راجع متطلبات النظام للاطلاع على معلومات التوافق التفصيلية.
تثبيت الإضافة
يُوزَّع Verdent for VS Code عبر متجر Visual Studio Code.
زيارة المتجر
انتقل إلى صفحة إضافة Verdent في متصفحك.
النقر على تثبيت
انقر فوق زر Install في صفحة المتجر.
الفتح في VS Code
سيفتح VS Code تلقائيًا ويبدأ عملية التثبيت.
فتح VS Code
شغّل Visual Studio Code على جهازك.
الوصول إلى الإضافات
حدد أيقونة الإضافات في الشريط الجانبي الأيسر (أيقونة المربعات الأربعة) أو اضغط:
- macOS:
Cmd+Shift+X - Windows/Linux:
Ctrl+Shift+X
البحث عن Verdent
اكتب "Verdent" في مربع البحث أعلى لوحة الإضافات. ابحث عن "Verdent" من Verdent AI ضمن النتائج.
التثبيت
انقر فوق زر Install بجانب إضافة Verdent. عادةً ما يستغرق التثبيت بضع ثوانٍ فقط.
code --install-extension verdentai.verdentتُعد هذه الطريقة مفيدة في الحالات التالية:
- نصوص الإعداد الآلي
- عمليات التثبيت على خوادم بعيدة عبر SSH
- إعداد بيئات CI/CD
- التثبيت على عدة أجهزة بسرعة
إذا كنت تستخدم ميزة Settings Sync في VS Code، فسيُثبَّت Verdent تلقائيًا على الأجهزة الجديدة عند مزامنة قائمة إضافاتك.
المصادقة والإعداد
بعد التثبيت، ستحتاج إلى المصادقة باستخدام حساب Verdent الخاص بك لبدء استخدام الإضافة.
المصادقة الأولية
فتح Verdent
بعد التثبيت، حدد أيقونة Verdent في الشريط الجانبي لـ VS Code. ستظهر لك خيارات تسجيل الدخول / إنشاء حساب.
تسجيل الدخول
حدد Sign In. ستعرض VS Code نافذة منبثقة تسأل "Do you want Code to open the external website?" - انقر فوق Open.
المصادقة عبر المتصفح
سيفتح متصفحك صفحة مصادقة Verdent. سجّل الدخول باستخدام بيانات اعتماد حساب Verdent الخاص بك (البريد الإلكتروني/كلمة المرور أو موفري OAuth مثل Google، GitHub، وغيرها).
تفويض VS Code
امنح VS Code صلاحية الوصول إلى حساب Verdent الخاص بك عند الطلب.
العودة إلى VS Code
عد إلى VS Code بعد اكتمال المصادقة. سيعرض لوحة Verdent الآن واجهة الإدخال.
الوقت الإجمالي: من 2 إلى 3 دقائق لإتمام التثبيت والإعداد بالكامل.
الإعداد الأولي (اختياري)
صُمم Verdent for VS Code للاستخدام الفوري بعد المصادقة مع الحد الأدنى من الإعدادات المطلوبة.
الإعدادات الافتراضية:
- وضع الأذونات: Auto-Run Mode (موافقة تلقائية للعمليات الآمنة)
- إعداد النموذج المسبق: Balance (مزيج مثالي بين الأداء والتكلفة)
- إدارة السياق: تلقائية
التخصيص الاختياري:
يمكنك تعديل هذه الإعدادات لاحقًا من خلال لوحة Verdent:
- وضع الأذونات - اختر Manual Accept أو Auto-Run أو Plan Mode أو Skip Permissions
- اختيار النموذج - حدد الإعدادات المسبقة Performance أو Balance أو Efficiency أو نماذج محددة
- إعدادات مساحة العمل - اضبط التفضيلات الخاصة بالمشروع
يمكن لمعظم المستخدمين البدء باستخدام Verdent فور تسجيل الدخول دون أي إعدادات إضافية. يمكن تعديل الإعدادات المتقدمة حسب الحاجة.
التحقق من التثبيت
تأكد من أن التثبيت يعمل بشكل صحيح من خلال هذه الفحوصات البسيطة:
التحقق البصري
- أيقونة الشريط الجانبي - ابحث عن أيقونة Verdent في الشريط الجانبي لـ VS Code (الجانب الأيسر)
- قائمة الإضافات - افتح لوحة الإضافات (
Cmd+Shift+X/Ctrl+Shift+X) وتأكد من ظهور "Verdent" كإضافة مُثبَّتة مع علامة صح
التحقق الوظيفي
فتح لوحة Verdent
حدد أيقونة Verdent في الشريط الجانبي أو اضغط Cmd+L (macOS) / Ctrl+L (Windows/Linux).
إرسال prompt تجريبي
جرّب طلبًا بسيطًا مثل "اشرح ما تحتويه مساحة العمل هذه" في مربع الإدخال.
تلقّي الرد
يجب أن يقوم Verdent بتحليل مساحة عملك وتقديم رد خلال ثوانٍ.
مؤشرات النجاح:
- ظهور أيقونة Verdent في الشريط الجانبي
- مصادقة الحساب بنجاح
- إمكانية إرسال prompts وتلقي الردود
استكشاف الأخطاء وإصلاحها
إذا فشل التحقق، جرّب هذه الحلول:
| المشكلة | الحل |
|---|---|
| أيقونة الشريط الجانبي مفقودة | أعد تشغيل VS Code أو تحقق من وجود تحديثات للإضافة |
| لا تستجيب الـ prompts | تحقق من اتصال الإنترنت وإعدادات جدار الحماية |
| الإضافة غير موجودة | تأكد من أن إصدار VS Code هو 1.90.0 أو أحدث |
يتطلب Verdent اتصالًا نشطًا بالإنترنت. إذا لم تستجب الـ prompts، تحقق من اتصال شبكتك ومن أن إعدادات جدار الحماية تسمح بالاتصالات الصادرة عبر HTTPS إلى نقاط نهاية API الخاصة بـ Verdent.