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

> دليل تفصيلي لتثبيت Verdent وإعداده



يرشدك هذا الدليل خلال تنزيل Verdent، وإتمام التثبيت الخاص بالنظام الأساسي، والمصادقة باستخدام حساب Verdent الخاص بك.

***

## المتطلبات [#المتطلبات]

قبل تثبيت Verdent، تأكد من أن نظامك يستوفي هذه المتطلبات الأساسية:

### متطلبات النظام [#متطلبات-النظام]

* **نظام التشغيل**: macOS 11+ أو Windows 10+ (64 بت). راجع [أنظمة التشغيل المدعومة](/docs/verdent-manager/getting-started/supported-operating-systems) للاطلاع على تفاصيل التوافق الكاملة.
* **Git**: الإصدار 2.20 أو أحدث. يستخدم Verdent أشجار عمل Git لعزل مساحات العمل. لا يلزم أن يكون مجلد مشروعك مستودع Git، لكن بعض الميزات تتطلب Git، وقد يرشدك Verdent إلى تهيئة مستودع عند الحاجة.
  * **macOS:** يأتي Git مع أدوات سطر أوامر Xcode. ثبّته باستخدام `xcode-select --install`، أو استخدم Homebrew: `brew install git`.
  * **Windows:** نزّل المثبّت الرسمي من [git-scm.com/download/win](https://git-scm.com/download/win) واقبل الخيارات الافتراضية.
  * تحقق من ذلك بتنفيذ `git --version` في الطرفية (terminal).
* **الاتصال بالإنترنت**: يلزم اتصال نشط للتواصل مع خدمة الذكاء الاصطناعي

### اختياري وموصى به [#اختياري-وموصى-به]

* **مساحة القرص**: 2 جيجابايت على الأقل من المساحة الحرة (يُوصى بمساحة أكبر للمستودعات الكبيرة وأشجار العمل والتخزين المؤقت)

***

## التنزيل [#التنزيل]

نزّل Verdent من الموقع الرسمي:

**[verdent.ai/download](https://verdent.ai/download)**

حدد نظام التشغيل الخاص بك لتنزيل المثبّت المناسب.

***

## التثبيت على macOS [#التثبيت-على-macos]

<Steps>
  <Step title="التنزيل">
    نزّل ملف `.dmg` من [verdent.ai/download](https://verdent.ai/download)
  </Step>

  <Step title="فتح ملف DMG">
    انقر نقرًا مزدوجًا على ملف `.dmg` الذي نزّلته لتحميله (mount)
  </Step>

  <Step title="التثبيت">
    اسحب أيقونة Verdent إلى مجلد Applications
  </Step>

  <Step title="التشغيل">
    افتح Applications وانقر نقرًا مزدوجًا على Verdent
  </Step>

  <Step title="الموافقة الأمنية">
    إذا طُلب منك ذلك، افتح **System Settings → Privacy & Security** (على macOS 13 وما بعده) أو **System Preferences → Security & Privacy** (على إصدارات macOS الأقدم) وحدد **Open Anyway**
  </Step>
</Steps>

**إصدارات macOS المدعومة:**

* macOS 11 (Big Sur) وما بعده
* دعم معالجات Intel وApple Silicon

***

## التثبيت على Windows [#التثبيت-على-windows]

<Steps>
  <Step title="التنزيل">
    نزّل مثبّت `.exe` من [verdent.ai/download](https://verdent.ai/download)
  </Step>

  <Step title="تشغيل المثبّت">
    انقر نقرًا مزدوجًا على ملف `.exe` الذي نزّلته
  </Step>

  <Step title="إشعار UAC">
    حدد **Yes** عند ظهور طلب من التحكم في حساب المستخدم (User Account Control)
  </Step>

  <Step title="خيارات التثبيت">
    اتبع تعليمات المثبّت (قد لا توفر بعض الإصدارات خيار تحديد دليل تثبيت مخصص)
  </Step>

  <Step title="الإكمال">
    حدد **Install** وانتظر حتى الانتهاء
  </Step>

  <Step title="التشغيل">
    حدد **Finish** لتشغيل Verdent، أو ابحث عنه في قائمة Start
  </Step>
</Steps>

**إصدارات Windows المدعومة:**

* Windows 10
* Windows 11
* 64 بت فقط

***

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

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

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

<Steps>
  <Step title="تشغيل Verdent">
    افتح Verdent من Applications (على macOS) أو من قائمة Start (على Windows). تظهر شاشة الترحيب.
  </Step>

  <Step title="تسجيل الدخول">
    حدد **Sign In**. سيفتح المتصفح صفحة مصادقة Verdent.
  </Step>

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

  <Step title="العودة إلى التطبيق">
    عد إلى Verdent بعد اكتمال المصادقة. سترى الواجهة الرئيسية.
  </Step>

  <Step title="فتح مشروع">
    اختر **Open Project** لتحديد دليل، أو **Recent Projects** إذا كنت عائدًا لمشروع سابق.
  </Step>
</Steps>

***

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

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

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

1. **أيقونة التطبيق** - يظهر Verdent في Applications (على macOS) أو في قائمة Start (على Windows)
2. **تسجيل الدخول** - يمكنك رؤية حالة حسابك في التطبيق بعد المصادقة (مثل الصورة الرمزية/البريد الإلكتروني)

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

<Steps>
  <Step title="فتح مشروع">
    افتح دليلًا في Verdent.
  </Step>

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

  <Step title="استلام الرد">
    ينبغي أن يحلل Verdent مشروعك ويقدّم ردًا في وقت قصير.
  </Step>
</Steps>

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

* يبدأ تشغيل Verdent دون أخطاء
* تمت المصادقة بنجاح على الحساب
* يمكنك إرسال prompts واستلام الردود

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

***

## استكشاف مشكلات التثبيت وإصلاحها [#استكشاف-مشكلات-التثبيت-وإصلاحها]

<Tabs>
  <Tab title="أمان macOS">
    **المشكلة:** "لا يمكن فتح Verdent لأنه من مطوّر غير معروف"

    **الحل:**

    1. افتح **System Settings → Privacy & Security** (على macOS 13 وما بعده) أو **System Preferences → Security & Privacy** (على إصدارات macOS الأقدم)
    2. اعثر على رسالة تحذير Verdent
    3. حدد **Open Anyway**
    4. أكّد بالنقر على **Open**
  </Tab>

  <Tab title="Windows Defender">
    **المشكلة:** يحظر Windows Defender التثبيت

    **الحل:**

    1. حدد **More info** في نافذة SmartScreen المنبثقة
    2. إذا نزّلت Verdent من الموقع الرسمي وتثق بالمصدر، حدد **Run anyway**
    3. أكمل التثبيت
  </Tab>
</Tabs>

***

## الأسئلة الشائعة [#الأسئلة-الشائعة]

<AccordionGroup>
  <Accordion title="هل يمكنني تثبيت Verdent بجانب امتداد VS Code؟">
    نعم. يُعد Verdent وامتداد VS Code تطبيقين مستقلين. يمكنك استخدام كليهما، وهما يتشاركان نفس مجموعة الأرصدة ونفس الحساب.
  </Accordion>

  <Accordion title="كيف أُحدّث Verdent؟">
    يتحقق Verdent من التحديثات تلقائيًا عند التشغيل. عند توفر تحديث:

    1. يظهر إشعار
    2. حدد **Update** لتنزيله وتثبيته
    3. أعد تشغيل التطبيق

    يمكنك أيضًا التحقق يدويًا من قائمة التطبيق (مثلًا: **Help → Check for Updates**).
  </Accordion>

  <Accordion title="كيف أزيل Verdent؟">
    **على macOS:** اسحب Verdent من Applications إلى Trash

    **على Windows:** استخدم **Settings → Apps → Verdent → Uninstall** أو **Control Panel → Programs and Features**
  </Accordion>
</AccordionGroup>

***

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

<CardGroup cols="2">
  <Card title="البدء السريع" icon="rocket" href="/docs/verdent-manager/getting-started/quick-start">
    أضف مشروعك الأول وخصّص مهمة
  </Card>

  <Card title="المدير (Manager)" icon="user-tie" href="/docs/verdent-manager/core-features/manager">
    تعرّف على كيفية تخطيط Manager للعمل وتوزيعه وتتبعه
  </Card>
</CardGroup>