# دليل البدء السريع (/ar/docs/verdent-for-vscode/getting-started/quick-start)

> ابدأ استخدام Verdent في دقائق



سيمكّنك دليل البدء السريع هذا من استخدام سير عمل Plan-Verify-Code في Verdent في أقل من 15 دقيقة. ستقوم بتثبيت الامتداد، وإتمام مهمتك الأولى، وفهم سير العمل الأساسي عند العمل مع Verdent for VS Code.

### ما الذي ستتعلمه [#ما-الذي-ستتعلمه]

* تثبيت Verdent for VS Code من المتجر
* المصادقة والتحقق من إعداداتك
* إتمام أول مهمة بمساعدة الذكاء الاصطناعي
* فهم أوضاع التنفيذ (القبول اليدوي، التشغيل التلقائي، Plan Mode)
* استخدام الميزات الأساسية للبرمجة اليومية

### المتطلبات الأساسية [#المتطلبات-الأساسية]

قبل البدء، تأكد من توفر ما يلي:

* تثبيت Visual Studio Code على جهازك
* اتصال إنترنت فعّال
* حساب اشتراك Verdent نشط (أو ابدأ بالتجربة المجانية لمدة 7 أيام)

***

## الخطوة 1: تثبيت Verdent [#الخطوة-1-تثبيت-verdent]

<Tabs>
  <Tab title="متجر Visual Studio Code">
    زر [صفحة امتداد Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) وحدد **Install**.
  </Tab>

  <Tab title="لوحة الامتدادات">
    1. افتح Visual Studio Code
    2. اضغط `Ctrl+Shift+X` (أو `Cmd+Shift+X` على macOS)
    3. ابحث عن "Verdent"
    4. حدد **Install**
  </Tab>

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

***

## الخطوة 2: ابدأ استخدام Verdent [#الخطوة-2-ابدأ-استخدام-verdent]

<Steps>
  <Step title="افتح Visual Studio Code">
    افتح Visual Studio Code في مجلد مشروعك.
  </Step>

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

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

***

## الخطوة 3: مهمتك الأولى [#الخطوة-3-مهمتك-الأولى]

لنبدأ بمهمة بسيطة وغير مدمّرة توضح مدى فهم Verdent لمساحة عملك.

**افتح مشروعًا في VS Code**، ثم جرّب أحد هذه الـ prompts في مربع إدخال Verdent:

```
What kind of project is this?
```

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

**ستشاهد:**

* Verdent يحلل الملفات في مساحة عملك
* ملخصًا لنوع مشروعك، والتقنيات المستخدمة، وبنيته
* عدم إجراء أي تعديلات على الملفات (تحليل للقراءة فقط)

**جرّب هذه الـ prompts التكميلية:**

```
Explain what this project does
```

```
What dependencies does this project have?
```

```
Show me the main entry point of this application
```

يساعدك كل prompt على التحقق من أن Verdent يستطيع الوصول إلى مساحة عملك ويفهم قاعدة الكود لديك.

<Tip>
  هذه الـ prompts الاستكشافية مثالية لفهم قواعد كود غير مألوفة. يقرأ Verdent الملفات حسب الحاجة دون أن يطلب منك إضافة السياق يدويًا.
</Tip>

***

## الخطوة 4: إجراء أول تعديل على الكود [#الخطوة-4-إجراء-أول-تعديل-على-الكود]

الآن دعنا نجعل Verdent ينشئ شيئًا ما. جرّب هذه المهمة البسيطة:

```
Create a hello_world.txt file with a greeting message
```

**ماذا يحدث:**

1. **يقترح Verdent التغيير** سترى معاينة تعرض الملف المراد إنشاؤه ومحتواه
2. **طلب الإذن**  في Auto Run Mode (الوضع الافتراضي)، سيقوم Verdent بالموافقة التلقائية عند إنشاء الملف
3. **توافق أنت** انقر على "Accept" أو وافق على التغيير
4. **إنشاء الملف** يقوم Verdent بإنشاء الملف ويؤكد إتمام المهمة

**فهم الأذونات:**

يضمن Manual Accept Mode عدم حدوث أي تعديلات غير مرغوب فيها دون موافقتك. ستظهر لك طلبات إذن عند:

* تعديل الملفات وإنشائها
* تنفيذ الأوامر
* استخدام الأدوات (عند أول استخدام لكل نوع أداة)

يمنحك هذا تحكمًا كاملًا ويساعدك على معرفة العمليات التي ينفذها Verdent لمهام مختلفة.

<Note>
  يُعد Manual Accept Mode نقطة البداية الموصى بها للمستخدمين الجدد. عند اعتيادك عليه، يمكنك التبديل إلى Auto-Run Mode أو Plan Mode لسير عمل مختلف.
</Note>

***

## الخطوة 5: استخدام Plan Mode للمهام المعقدة [#الخطوة-5-استخدام-plan-mode-للمهام-المعقدة]

Plan Mode هو وضع التخطيط للقراءة فقط في Verdent حيث يمكنك مراجعة الأساليب قبل التنفيذ. لنجرّبه:

**بدّل إلى Plan Mode:**

انقر على زر **Switch Mode** في مربع الإدخال وحدد **Plan Mode**

**جرّب مهمة تخطيط:**

```
Suggest ways to build a website for my project
```

**ماذا يحدث:**

1. **يحلل Verdent مشروعك** يقرأ الملفات ويفهم بنية مشروعك ومتطلباته
2. **إنشاء خطة مفصلة** تُظهر التقنيات المطلوب استخدامها، والصفحات المطلوب إنشاؤها، وكيفية هيكلة الموقع
3. **بدون تعديلات** Plan Mode للقراءة فقط. لا يستطيع Verdent تعديل الملفات حتى توافق صراحةً
4. **توضيح تفاعلي** قد يطرح Verdent أسئلة حول تفضيلات التصميم، أو الجمهور المستهدف، أو الميزات قبل وضع الخطة النهائية

**لماذا تستخدم Plan Mode:**

* **استكشاف آمن** - فهم قواعد كود غير مألوفة دون تغييرات غير مقصودة
* **مراجعة الكود** - تحليل الجودة والبنية قبل إجراء التعديلات
* **تخطيط استراتيجي** - تقسيم المهام المعقدة إلى خطوات قابلة للمراجعة
* **تقليل الغموض** - يطرح Verdent أسئلة توضيحية لإزالة الغموض

<Tip>
  استخدم Plan Mode لأي مهمة تريد مراجعة أسلوبها قبل الالتزام بالتنفيذ. يكون مفيدًا بشكل خاص عند تعلّم كيفية تعامل Verdent مع قاعدة الكود لديك.
</Tip>

**لتنفيذ الخطة:**

بعد مراجعة الخطة، يعرض Verdent خيارين:

* اختر **Edit** لطلب تعديلات أو طرح أسئلة توضيحية
* اختر **Start Building** للتبديل إلى Agent Mode وبدء التنفيذ

***

## الخطوة 6: فهم أوضاع التنفيذ [#الخطوة-6-فهم-أوضاع-التنفيذ]

يوفر Verdent عدة أوضاع تنفيذ لتلائم سير عمل مختلفة:

**أوضاع الأذونات:**

| الوضع                                 | الوصف                                                                                                                  | متى تستخدمه                                                            |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **القبول اليدوي**                     | يطلب الإذن عند أول استخدام لكل أداة                                                                                    | التعلّم والتطوير العام مع أقصى قدر من التحكم                           |
| **التشغيل التلقائي**(الوضع الافتراضي) | يقبل تلقائيًا العمليات الآمنة (قراءة الملفات، عمليات البحث على الويب)؛ لا تزال تعديلات الملفات والأوامر تتطلب الموافقة | المشاريع الموثوقة والنمذجة الأولية السريعة                             |
| **Plan Mode**                         | وضع للقراءة فقط للتحليل والتخطيط دون تعديل الملفات                                                                     | المهام المعقدة ومراجعة الكود                                           |
| **تجاوز الأذونات**                    | تشغيل مستقل بالكامل يتجاوز جميع الطلبات                                                                                | البيئات المعزولة والآمنة مثل الاختبار الآلي أو بيئات الاختبار المعزولة |

**وضع إضافي:**

* **Think Hard Mode** - أقصى قدر من ميزانية التفكير للتفكير المعقد وقرارات البنية المعمارية

<Warning>
  يلغي Skip Permissions Mode جميع فحوصات السلامة. استخدمه فقط في بيئات معزولة وقابلة للتخلص منها حيث لا تترتب على الأخطاء أي عواقب.
</Warning>

***

## الإجراءات الأساسية [#الإجراءات-الأساسية]

فيما يلي الإجراءات الرئيسية التي ستستخدمها يوميًا في Verdent for VS Code:

| الإجراء            | كيفية الوصول إليه                                     | الوصف                                         |
| ------------------ | ----------------------------------------------------- | --------------------------------------------- |
| فتح Verdent        | `Cmd+L` / `Ctrl+L` أو النقر على أيقونة الشريط الجانبي | يفتح لوحة Verdent                             |
| New Session        | انقر على "New Session" في الشريط العلوي               | بدء محادثة جديدة بسياق نظيف                   |
| Add Context        | انقر على زر "Add Context"                             | الإشارة إلى الملفات باستخدام @-mentions       |
| Add Images         | انقر على زر "Add Images or Files"                     | تحميل لقطات شاشة أو نماذج تصميم أو مخططات     |
| Switch Mode        | انقر على زر "Switch Mode"                             | التبديل بين أوضاع Agent/Plan/Chat             |
| Change Model       | انقر على محدد النموذج                                 | اختيار إعدادات الأداء/التوازن/الكفاءة الجاهزة |
| Think Hard         | انقر على زر "Think Hard Mode"                         | تفعيل التفكير الموسّع للمهام المعقدة          |
| Switch Permissions | انقر على زر "Switch Permission"                       | تغيير وضع الإذن                               |
| View History       | انقر على "Project History" في الشريط العلوي           | تصفح الجلسات السابقة                          |
| User Center        | انقر على "User Center" في الشريط العلوي               | التحقق من رصيد الأرصدة ومعلومات الحساب        |
| Settings           | انقر على "Settings" في الشريط العلوي                  | إعداد خوادم MCP، والوكلاء الفرعيين، والقواعد  |

***

## نصائح احترافية للمبتدئين [#نصائح-احترافية-للمبتدئين]

<Accordion title="ابدأ بـ prompts استكشافية">
  قبل إجراء أي تغييرات، دع Verdent يفهم قاعدة الكود لديك:

  ```
  Analyze the database schema
  ```

  ```
  Explain the authentication flow
  ```

  هذا يبني سياق Verdent حول مشروعك ويساعده على تقديم اقتراحات أفضل.
</Accordion>

<Accordion title="كن محددًا في طلباتك">
  بدلًا من: "أصلح الخطأ"

  جرّب: "أصلح خطأ تسجيل الدخول في `LoginForm.tsx` حيث يظهر للمستخدمين شاشة فارغة بعد إدخال بيانات اعتماد خاطئة"

  الـ prompts المحددة تؤدي إلى حلول أدق وعدد أقل من التكرارات.
</Accordion>

<Accordion title="استخدم Plan Mode للكود غير المألوف">
  عند العمل مع كود لا تفهمه تمامًا، استخدم Plan Mode أولًا:

  ```
  Refactor the authentication module to use async/await instead of callbacks
  ```

  راجع الخطة، واختر **Edit** لطرح أسئلة توضيحية وتحسينها، ثم اختر **Start Building** بمجرد أن تكون واثقًا.
</Accordion>

<Accordion title="قسّم المهام المعقدة إلى خطوات">
  بالنسبة للميزات متعددة الخطوات، اعمل بشكل تدريجي:

  ```
  1. Create a new database table for user profiles
  ```

  ثم بعد الإتمام:

  ```
  2. Create an API endpoint to get and update profiles
  ```

  هذا يحافظ على الوضوح ويتيح لك التحقق من كل خطوة.
</Accordion>

<Accordion title="استفد من @-mentions للسياق">
  أشر صراحةً إلى الملفات عند الحاجة:

  ```
  @components/UserProfile.tsx refactor this component to use hooks
  ```

  هذا يضمن تركيز Verdent على السياق الصحيح لمهمتك.
</Accordion>

<Accordion title="استخدم الوكلاء الفرعيين للمهام المتخصصة">
  يتضمن Verdent ثلاثة وكلاء فرعيين مدمجين:

  * `@Explorer` - استكشاف سريع لقاعدة الكود واكتشاف الملفات
  * `@Verifier` - تحقق وفحص سريع للكود
  * `@Code-reviewer` - مراجعة شاملة للأمان والجودة

  مثال:

  ```
  @Explorer find all API endpoints in this project
  ```
</Accordion>

***

## المشكلات الشائعة [#المشكلات-الشائعة]

<Tabs>
  <Tab title="الامتداد غير ظاهر في الشريط الجانبي">
    **الحل:** أعد تشغيل VS Code. إذا ظل غائبًا، تحقق من التثبيت في لوحة الامتدادات (`Cmd+Shift+X` / `Ctrl+Shift+X`) وتأكد من ظهور "Verdent" في القائمة.
  </Tab>

  <Tab title="لا يتم الرد على الـ prompts">
    **الحل:**

    1. تحقق من أن اتصال الإنترنت فعّال
    2. تحقق من أن إعدادات الجدار الناري/الوكيل تسمح باتصال HTTPS بخدمات Verdent
    3. تأكد من وجود أرصدة متبقية في User Center
    4. جرّب prompt أبسط لاختبار الاتصال
  </Tab>

  <Tab title="طلبات الإذن متكررة جدًا">
    **الحل:** بدّل إلى Auto-Run Mode باستخدام زر "Switch Permission". يوافق هذا تلقائيًا على عمليات القراءة الآمنة بينما لا يزال يطلب الموافقة على تعديلات الملفات والأوامر.
  </Tab>
</Tabs>

***

## الحصول على المساعدة [#الحصول-على-المساعدة]

* **مجتمع Discord**: [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq) - مجتمع نشط بدعم فوري
* **التوثيق**: تصفح الأدلة الأخرى في هذا التوثيق
* **الملاحظات**: استخدم زر Feedback في الشريط العلوي لـ Verdent للإبلاغ عن مشكلات أو اقتراح تحسينات

***

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

<Accordion title="كيف أعرف وضع التنفيذ الحالي الذي أعمل به؟">
  انظر إلى مربع الإدخال في أسفل لوحة Verdent. يعرض زر "Switch Permission" وضعك الحالي (مثل "Manual" أو "Auto" أو "Plan"). يمكنك النقر عليه لتبديل الأوضاع.
</Accordion>

<Accordion title="ماذا يحدث إذا نفدت أرصدتي؟">
  تتوقف الطلبات القياسية القائمة على الأرصدة عندما يصل رصيدك إلى الصفر. انتظر تحديث دورة الفوترة التالية أو اشترِ شحن أرصدة لمرة واحدة للمتابعة.
</Accordion>

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

<Accordion title="كيف أبدأ محادثة جديدة بسياق نظيف؟">
  انقر على زر "New Session" في الشريط العلوي. يؤدي هذا إلى مسح سجل المحادثة الحالي ومنح Verdent نافذة سياق جديدة لمهمتك التالية.
</Accordion>

***

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

لقد قمت بتثبيت Verdent، وأتممت مهمتك الأولى، وتعلمت سير العمل الأساسي. إليك الخطوات التالية:

<CardGroup cols="2">
  <Card title="المفاهيم الأساسية" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    فهم الوكلاء الفرعيين، وبنية الوكلاء المتعددة، وإدارة السياق
  </Card>

  <Card title="سير العمل الشائعة" icon="code" href="/docs/verdent-for-vscode/common-workflows/multi-step-tasks">
    أدلة تفصيلية للمهام متعددة الخطوات، وقواعد الكود الكبيرة، والتحكم في الإصدارات
  </Card>
</CardGroup>