دليل البدء السريع

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

ما الذي ستتعلمه

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

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

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

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

الخطوة 1: تثبيت Verdent

زر صفحة امتداد Verdent وحدد Install.

افتح Visual Studio Code
اضغط Ctrl+Shift+X (أو Cmd+Shift+X على macOS)
ابحث عن "Verdent"
حدد Install

code --install-extension verdentai.verdent

الخطوة 2: ابدأ استخدام Verdent

افتح Visual Studio Code

افتح Visual Studio Code في مجلد مشروعك.

الوصول إلى Verdent

انقر على أيقونة Verdent في الشريط الجانبي أو اضغط Ctrl+L (على Windows/Linux) / Cmd+L (على macOS).

الخطوة 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 يستطيع الوصول إلى مساحة عملك ويفهم قاعدة الكود لديك.

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

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

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

Create a hello_world.txt file with a greeting message

ماذا يحدث:

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

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

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

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

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

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

الخطوة 5: استخدام Plan Mode للمهام المعقدة

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

بدّل إلى Plan Mode:

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

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

Suggest ways to build a website for my project

ماذا يحدث:

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

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

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

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

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

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

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

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

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

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

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

وضع إضافي:

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

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

الإجراءات الأساسية

فيما يلي الإجراءات الرئيسية التي ستستخدمها يوميًا في 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، والوكلاء الفرعيين، والقواعد

نصائح احترافية للمبتدئين

ابدأ بـ prompts استكشافية

قبل إجراء أي تغييرات، دع Verdent يفهم قاعدة الكود لديك:

Analyze the database schema

Explain the authentication flow

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

كن محددًا في طلباتك

بدلًا من: "أصلح الخطأ"

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

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

استخدم Plan Mode للكود غير المألوف

عند العمل مع كود لا تفهمه تمامًا، استخدم Plan Mode أولًا:

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

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

قسّم المهام المعقدة إلى خطوات

بالنسبة للميزات متعددة الخطوات، اعمل بشكل تدريجي:

1. Create a new database table for user profiles

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

2. Create an API endpoint to get and update profiles

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

استفد من @-mentions للسياق

أشر صراحةً إلى الملفات عند الحاجة:

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

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

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

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

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

مثال:

@Explorer find all API endpoints in this project

المشكلات الشائعة

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

الحل:

تحقق من أن اتصال الإنترنت فعّال
تحقق من أن إعدادات الجدار الناري/الوكيل تسمح باتصال HTTPS بخدمات Verdent
تأكد من وجود أرصدة متبقية في User Center
جرّب prompt أبسط لاختبار الاتصال

الحل: بدّل إلى Auto-Run Mode باستخدام زر "Switch Permission". يوافق هذا تلقائيًا على عمليات القراءة الآمنة بينما لا يزال يطلب الموافقة على تعديلات الملفات والأوامر.

الحصول على المساعدة

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

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

كيف أعرف وضع التنفيذ الحالي الذي أعمل به؟

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

ماذا يحدث إذا نفدت أرصدتي؟

تتوقف الطلبات القياسية القائمة على الأرصدة عندما يصل رصيدك إلى الصفر. انتظر تحديث دورة الفوترة التالية أو اشترِ شحن أرصدة لمرة واحدة للمتابعة.

هل يمكنني استخدام Verdent في عدة مشاريع في آن واحد؟

نعم، تعمل كل نافذة VS Code بشكل مستقل. يمكنك فتح Verdent في عدة مشاريع، ويحتفظ كل منها بسياق محادثة منفصل خاص به.

كيف أبدأ محادثة جديدة بسياق نظيف؟

انقر على زر "New Session" في الشريط العلوي. يؤدي هذا إلى مسح سجل المحادثة الحالي ومنح Verdent نافذة سياق جديدة لمهمتك التالية.