# التثبيت (/ar/docs/verdent-for-vscode/getting-started/installation)

> دليل خطوة بخطوة لتثبيت وإعداد 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**: للتكامل مع نظام التحكم بالإصدارات وتتبع تغييرات الكود

راجع [متطلبات النظام](/docs/verdent-for-vscode/getting-started/system-requirements) للاطلاع على معلومات التوافق التفصيلية.

***

## تثبيت الإضافة [#تثبيت-الإضافة]

يُوزَّع Verdent for VS Code عبر متجر Visual Studio Code.

<Tabs>
  <Tab title="متجر VS Code">
    <Steps>
      <Step title="زيارة المتجر">
        انتقل إلى [صفحة إضافة Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) في متصفحك.
      </Step>

      <Step title="النقر على تثبيت">
        انقر فوق زر **Install** في صفحة المتجر.
      </Step>

      <Step title="الفتح في VS Code">
        سيفتح VS Code تلقائيًا ويبدأ عملية التثبيت.
      </Step>
    </Steps>
  </Tab>

  <Tab title="لوحة الإضافات">
    <Steps>
      <Step title="فتح VS Code">
        شغّل Visual Studio Code على جهازك.
      </Step>

      <Step title="الوصول إلى الإضافات">
        حدد أيقونة الإضافات في الشريط الجانبي الأيسر (أيقونة المربعات الأربعة) أو اضغط:

        * **macOS**: `Cmd+Shift+X`
        * **Windows/Linux**: `Ctrl+Shift+X`
      </Step>

      <Step title="البحث عن Verdent">
        اكتب "Verdent" في مربع البحث أعلى لوحة الإضافات. ابحث عن "Verdent" من Verdent AI ضمن النتائج.
      </Step>

      <Step title="التثبيت">
        انقر فوق زر **Install** بجانب إضافة Verdent. عادةً ما يستغرق التثبيت بضع ثوانٍ فقط.
      </Step>
    </Steps>
  </Tab>

  <Tab title="سطر الأوامر">
    ```bash
    code --install-extension verdentai.verdent
    ```

    تُعد هذه الطريقة مفيدة في الحالات التالية:

    * نصوص الإعداد الآلي
    * عمليات التثبيت على خوادم بعيدة عبر SSH
    * إعداد بيئات CI/CD
    * التثبيت على عدة أجهزة بسرعة
  </Tab>
</Tabs>

<Tip>
  إذا كنت تستخدم ميزة Settings Sync في VS Code، فسيُثبَّت Verdent تلقائيًا على الأجهزة الجديدة عند مزامنة قائمة إضافاتك.
</Tip>

***

## المصادقة والإعداد [#المصادقة-والإعداد]

بعد التثبيت، ستحتاج إلى المصادقة باستخدام حساب Verdent الخاص بك لبدء استخدام الإضافة.

### المصادقة الأولية [#المصادقة-الأولية]

<Steps>
  <Step title="فتح Verdent">
    بعد التثبيت، حدد أيقونة Verdent في الشريط الجانبي لـ VS Code. ستظهر لك خيارات تسجيل الدخول / إنشاء حساب.
  </Step>

  <Step title="تسجيل الدخول">
    حدد **Sign In**. ستعرض VS Code نافذة منبثقة تسأل "Do you want Code to open the external website?" - انقر فوق **Open**.
  </Step>

  <Step title="المصادقة عبر المتصفح">
    سيفتح متصفحك صفحة مصادقة Verdent. سجّل الدخول باستخدام بيانات اعتماد حساب Verdent الخاص بك (البريد الإلكتروني/كلمة المرور أو موفري OAuth مثل Google، GitHub، وغيرها).
  </Step>

  <Step title="تفويض VS Code">
    امنح VS Code صلاحية الوصول إلى حساب Verdent الخاص بك عند الطلب.
  </Step>

  <Step title="العودة إلى VS Code">
    عد إلى VS Code بعد اكتمال المصادقة. سيعرض لوحة Verdent الآن واجهة الإدخال.
  </Step>
</Steps>

**الوقت الإجمالي:** من 2 إلى 3 دقائق لإتمام التثبيت والإعداد بالكامل.

### الإعداد الأولي (اختياري) [#الإعداد-الأولي-اختياري]

صُمم Verdent for VS Code للاستخدام الفوري بعد المصادقة مع الحد الأدنى من الإعدادات المطلوبة.

**الإعدادات الافتراضية:**

* **وضع الأذونات**: Auto-Run Mode (موافقة تلقائية للعمليات الآمنة)
* **إعداد النموذج المسبق**: Balance (مزيج مثالي بين الأداء والتكلفة)
* **إدارة السياق**: تلقائية

**التخصيص الاختياري:**

يمكنك تعديل هذه الإعدادات لاحقًا من خلال لوحة Verdent:

* **وضع الأذونات** - اختر Manual Accept أو Auto-Run أو Plan Mode أو Skip Permissions
* **اختيار النموذج** - حدد الإعدادات المسبقة Performance أو Balance أو Efficiency أو نماذج محددة
* **إعدادات مساحة العمل** - اضبط التفضيلات الخاصة بالمشروع

<Note>
  يمكن لمعظم المستخدمين البدء باستخدام Verdent فور تسجيل الدخول دون أي إعدادات إضافية. يمكن تعديل الإعدادات المتقدمة حسب الحاجة.
</Note>

***

## التحقق من التثبيت [#التحقق-من-التثبيت]

تأكد من أن التثبيت يعمل بشكل صحيح من خلال هذه الفحوصات البسيطة:

### التحقق البصري [#التحقق-البصري]

1. **أيقونة الشريط الجانبي** - ابحث عن أيقونة Verdent في الشريط الجانبي لـ VS Code (الجانب الأيسر)
2. **قائمة الإضافات** - افتح لوحة الإضافات (`Cmd+Shift+X` / `Ctrl+Shift+X`) وتأكد من ظهور "Verdent" كإضافة مُثبَّتة مع علامة صح

### التحقق الوظيفي [#التحقق-الوظيفي]

<Steps>
  <Step title="فتح لوحة Verdent">
    حدد أيقونة Verdent في الشريط الجانبي أو اضغط `Cmd+L` (macOS) / `Ctrl+L` (Windows/Linux).
  </Step>

  <Step title="إرسال prompt تجريبي">
    جرّب طلبًا بسيطًا مثل "اشرح ما تحتويه مساحة العمل هذه" في مربع الإدخال.
  </Step>

  <Step title="تلقّي الرد">
    يجب أن يقوم Verdent بتحليل مساحة عملك وتقديم رد خلال ثوانٍ.
  </Step>
</Steps>

**مؤشرات النجاح:**

* ظهور أيقونة Verdent في الشريط الجانبي
* مصادقة الحساب بنجاح
* إمكانية إرسال prompts وتلقي الردود

### استكشاف الأخطاء وإصلاحها [#استكشاف-الأخطاء-وإصلاحها]

إذا فشل التحقق، جرّب هذه الحلول:

| المشكلة                      | الحل                                              |
| ---------------------------- | ------------------------------------------------- |
| أيقونة الشريط الجانبي مفقودة | أعد تشغيل VS Code أو تحقق من وجود تحديثات للإضافة |
| لا تستجيب الـ prompts        | تحقق من اتصال الإنترنت وإعدادات جدار الحماية      |
| الإضافة غير موجودة           | تأكد من أن إصدار VS Code هو 1.90.0 أو أحدث        |

<Warning>
  يتطلب Verdent اتصالًا نشطًا بالإنترنت. إذا لم تستجب الـ prompts، تحقق من اتصال شبكتك ومن أن إعدادات جدار الحماية تسمح بالاتصالات الصادرة عبر HTTPS إلى نقاط نهاية API الخاصة بـ Verdent.
</Warning>

***

## الخطوات التالية [#الخطوات-التالية]

<CardGroup cols="2">
  <Card title="البدء السريع" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    أكمل مهمتك الأولى باستخدام Verdent خلال 5 دقائق
  </Card>

  <Card title="المفاهيم الأساسية" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    تعرّف على الوكلاء الفرعيين وأوضاع التنفيذ ومعمارية تعدد الوكلاء
  </Card>
</CardGroup>