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

السبب الأكثر شيوعًا: مشكلة في إعدادات الوكيل (proxy)

الحل:

1. افتح إعدادات VS Code (Cmd+, على macOS أو Ctrl+, على Windows/Linux)
2. ابحث عن "useProxy" أو "verdent.enableProxy"
3. بدّل إعداد الوكيل (proxy) بين التفعيل والإيقاف (عكس الحالة الحالية)
4. حاول تسجيل الدخول مرة أخرى

الشرح: إذا كنت خلف جدار حماية للشركة، فقد تحتاج إلى تفعيل إعداد الوكيل. أما إذا كنت على شبكة منزلية، فحاول تعطيله.

الخطأ: لم يتم استلام أرصدة التجربة المجانية أو تم رفض الوصول إلى التجربة المجانية

السبب: تم اكتشاف مخالفة لشروط الخدمة أثناء التسجيل

الحل: تواصل مع support@verdent.ai للمساعدة في الوصول إلى التجربة المجانية. سيراجع فريق الدعم حسابك ويساعد في حل المشكلة.

الخطأ: تم رفض تسجيل الحساب أو تقييده

السبب: خالف التسجيل شروط خدمة Verdent، مما أدى إلى تقييد الوصول

الحل: تواصل مع support@verdent.ai للمساعدة. يمكن لفريق الدعم مراجعة تسجيلك وتقديم إرشادات لحل المشكلة.

المشكلة: تعذّر إيجاد بعض نماذج الذكاء الاصطناعي في قائمة اختيار النماذج

السبب: قيود مرتبطة بالموقع الجغرافي من مزوّدي النماذج

الشرح: بعض مزوّدي نماذج الذكاء الاصطناعي (Anthropic، OpenAI، Google) يفرضون قيودًا إقليمية تمنع توفر بعض النماذج في مواقع جغرافية معينة. عند حدوث ذلك:

• لن تظهر النماذج المقيَّدة في قائمة اختيار النماذج لديك
• يمكنك الاستمرار في استخدام جميع النماذج الأخرى المتاحة دون انقطاع
• لا يوجد أي تأثير على اشتراكك أو أرصدتك

التحقق من النماذج المتاحة: زر https://www.verdent.ai/regions للاطلاع على النماذج المتاحة في منطقتك

ملاحظة: القيود الإقليمية يفرضها مزوّدو نماذج الذكاء الاصطناعي، وليس Verdent. لا يمكن لـ Verdent تجاوز هذه القيود.

Visual Studio Code محرر أكواد مجاني ومفتوح المصدر طورته Microsoft. وهو بيئة تطوير خفيفة وقوية تدعم عدة لغات برمجة وتوفر ميزات مثل التصحيح (debugging) وتمييز بنية الكود (syntax highlighting) وإكمال الكود الذكي والتحكم المتكامل بالإصدارات. يندمج Verdent مباشرة في Visual Studio Code كامتداد، مضيفًا قدرات برمجة مدعومة بالذكاء الاصطناعي إلى سير عملك الحالي.

Verdent هو امتداد مساعد برمجة بالذكاء الاصطناعي لـ Visual Studio Code يساعد في توليد الكود وإعادة الهيكلة وتصحيح الأخطاء والتنقل داخل المشروع من خلال محادثات باللغة الطبيعية.

القدرات الرئيسية:

• توليد الكود وتعديله عبر أدوات الملفات
• استكشاف قاعدة الكود باستخدام وكلاء فرعيين متخصصين
• تنفيذ الأوامر عبر تكامل bash
• قابلية توسيع مخصصة عبر القواعد وخوادم MCP

الحد الأدنى من المتطلبات:

• Visual Studio Code الإصدار 1.90.0 أو أحدث
• اشتراك نشط في Verdent
• اتصال بالإنترنت

الأنظمة المدعومة: macOS وWindows وLinux وWSL

1. ثبّت امتداد Verdent من متجر VS Code
2. سجّل الدخول بحساب Verdent الخاص بك عند مطالبتك بذلك
3. افتح أي ملف كود أو مشروع
4. افتح عرض المحادثة (Chat View) وابدأ التفاعل مع Verdent

اقتراح للمهمة الأولى: اطلب من Verdent شرح بنية مشروعك أو مراجعة ملف معين.

افتح Visual Studio Code وانتقل إلى Help ← About (أو Code ← About Visual Studio Code على macOS). يظهر رقم الإصدار في مربع الحوار. يتطلب Verdent إصدار Visual Studio Code 1.90.0 أو أحدث.

يمكنك أيضًا التحقق عبر سطر الأوامر:

code --version

راجع الأرصدة والخطط للاطلاع على التعريف المشترك للأرصدة وفئات التسعير وأساسيات الاستخدام عبر منتجات Verdent.

راجع ماذا يحدث إذا نفدت أرصدتك للاطلاع على سياسة الحساب المشتركة وخيارات الاسترداد.

تُعالَج الصور الملصقة عبر الحافظة أو المشار إليها بمسار ملف ضمن جلسة المحادثة الخاصة بك. لا تُخزَّن الصور بشكل دائم، ويتم مسحها عند بدء محادثة جديدة. تقرأ الإشارات بمسار الملف الصورة محليًا دون رفعها.

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

لا. Plan Mode هو وضع للقراءة فقط بشكل صارم:

• يمكن لـ Verdent قراءة الملفات، والبحث في الكود، وتحليل قاعدة الكود لديك
• لا تحدث أي كتابة أو تعديل أو حذف للملفات أثناء Plan Mode
• تُعرض الخطط في عرض المحادثة فقط
• يبدأ تنفيذ الكود فقط بعد موافقتك الصريحة والتبديل إلى Agent Mode

ضمان السلامة: لا يمكن لـ Plan Mode تعديل الكود لديك عن طريق الخطأ. صُمّم هذا الوضع للاستكشاف الآمن ووضع الاستراتيجيات.

التبديل فوري عبر مربع الإدخال:

للدخول إلى Plan Mode:

• انقر على زر Switch Mode في مربع الإدخال
• اختر Plan Mode من القائمة المنسدلة
• أو قل: "Switch to Plan Mode"

للخروج من Plan Mode:

• انقر على زر Switch Mode في مربع الإدخال
• اختر Agent Mode من القائمة المنسدلة
• أو اختر Start Building بعد مراجعة الخطة

استمرارية الوضع:

• يستمر اختيار الوضع ضمن الجلسة الحالية
• تبدأ الجلسات الجديدة في Agent Mode الافتراضي
• يمكنك التبديل بين الأوضاع بحرية في أي وقت

سير العمل النموذجي: Plan Mode ← مراجعة ← Agent Mode ← تنفيذ ← العودة إلى Plan Mode لأجل الميزة المعقدة التالية.

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

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

نعم. يستخدم Verdent أوامر Git القياسية، لذا فهو يعمل مع أي مستودع Git بغض النظر عن منصة الاستضافة. لإنشاء طلبات السحب (pull requests)، يستخدم Verdent واجهة سطر الأوامر gh التي تتطلب GitHub، لكن جميع عمليات Git الأخرى تعمل بشكل عام.

المدعومة: جميع صيغ الملفات النصية، بما في ذلك:

• الكود المصدري (JavaScript وPython وTypeScript وJava وGo وغيرها)
• ملفات التهيئة (JSON وYAML وTOML وXML وENV)
• الوثائق (Markdown وHTML وLaTeX)
• ملفات البناء (package.json وMakefile وrequirements.txt)

غير المدعومة: الملفات الثنائية (الصور والفيديوهات وملفات PDF والبرمجيات المُجمَّعة ومستندات Office)

حل بديل: يمكن الإشارة إلى الملفات الثنائية في الكود، لكن تعديلها يتطلب أدوات خارجية.

دعم ممتاز:

• JavaScript وTypeScript وPython وReact وVue وAngular
• Node.js وGo وJava/Spring وC#/.NET
• Swift وKotlin وFlutter

دعم جيد جدًا: Rust وC/C++ وRuby وR

دعم جيد: PHP وAssembly وJulia

تحظى اللغات الشائعة بدعم أقوى بفضل بيانات التدريب الواسعة.

ثلاث أدوات لعمليات الملفات:

• file_read: قراءة الملفات كاملة أو نطاقات أسطر محددة
• file_edit: استبدال أنماط نصية محددة (تعديلات موجّهة)
• file_write: إنشاء ملفات جديدة أو إعادة كتابة الملف بالكامل

أفضل ممارسة: استخدم file_edit للتعديلات، وfile_write للملفات الجديدة فقط.

تشغيل أوامر الطرفية (terminal) أو نصوص shell عبر Verdent، بما في ذلك عمليات مثل تشغيل الاختبارات، أو تثبيت الحزم، أو تنفيذ أوامر البناء. يتطلب تنفيذ الأوامر موافقة في معظم أوضاع الأذونات لمنع أي تغييرات غير مقصودة في النظام.

نعم، باستخدام أداة bash. يمكن لـ Verdent تشغيل أوامر الطرفية مع:

• مهلة قصوى: 120 ثانية (دقيقتان)
• تسلسل الأوامر باستخدام &&
• دعم عبر المنصات (bash على Unix، وPowerShell على Windows)

السلامة: تُنفَّذ الأوامر بصلاحيات المستخدم لديك. استخدم Manual Accept Mode لمراجعتها قبل التنفيذ.

المهلة القصوى: 120 ثانية (دقيقتان)

سيتم إنهاء الأوامر التي تتجاوز دقيقتين تلقائيًا. بالنسبة للعمليات الأطول، ضع في اعتبارك:

البدائل:

• تقسيمها إلى أوامر أصغر: bash("task1") && bash("task2")
• تقسيمها إلى عمليات أصغر
• التشغيل في الخلفية والتحقق من النتائج بشكل منفصل

عملية تحقق تكرارية يتم فيها توليد الكود واختباره وإصلاحه حتى يجتاز اختبارًا شاملاً. يقوم Verdent تلقائيًا بتشغيل الاختبارات، وتحليل الإخفاقات، وإصلاح المشكلات، وإعادة الاختبار عبر عدة مراحل حتى يعمل الكود بشكل صحيح. يوفر ذلك كودًا جاهزًا للإنتاج، وليس مجرد اقتراحات. تتضمن كل نتيجة ملخصات تفصيلية وفروقات كود (diffs) توضح بدقة ما تغيّر.

الوكلاء الفرعيون هم وكلاء ذكاء اصطناعي متخصصون بنوافذ سياق معزولة لمهام محددة.

الوكلاء الفرعيون المدمجون:

• @Explorer: عمليات البحث في قاعدة الكود، وأسئلة البنية
• @Verifier: تحققات سريعة
• @Code-reviewer: مراجعات الأمان والجودة

متى نستخدمهم: فوّض مهام البحث أو التحقق أو المراجعة لتوفير سياق المحادثة الرئيسية.

كيفية إنشاء وكلاء فرعيين مخصصين:

أنشئ ملف Markdown في ~/.verdent/subagents/:

---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]

حالات الاستخدام: خبرة في مجالات محددة (المالية، الرعاية الصحية)، وسير عمل الفرق، ومتخصصو التقنية.

عندما تخلق الإجراءات والمعلومات السابقة في السياق أنماط سلوك غير مقصودة تؤثر على المهام المستقبلية. على سبيل المثال، إذا كنت تحدّث الكود بشكل متكرر ثم تنشره، فقد يبدأ الوكيل بربط جميع تحديثات الكود بالنشر الفوري، حتى عندما تكون بصدد التجربة فقط. يمنع الوكلاء الفرعيون تلوث السياق من خلال العمل بنوافذ سياق معزولة، مما يتيح لكل مهمة متخصصة أن تبدأ بسياق نظيف، ويتجنب التداخل بين أنواع العمل المختلفة.

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

Auto-Run Mode:

• تُنفَّذ عمليات الملفات تلقائيًا دون موافقة
• ما زالت الأوامر تتطلب إذنًا
• سير عمل أسرع لقواعد الكود الموثوقة
• الأنسب للمشاريع الفردية التي تستخدم التحكم بالإصدارات

Manual Accept Mode:

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

بدّل بين الأوضاع عبر الإعدادات أو لوحة الأوامر.

هي العمليات التي تقرأ البيانات فقط دون إجراء تغييرات: قراءة الملفات وعمليات البحث على الويب. تُعتمد هذه تلقائيًا في Auto-Run Mode، بينما لا تزال تعديلات الملفات وتنفيذ الأوامر تتطلب موافقة للحفاظ على السلامة.

لا، أوضاع الأذونات حصرية متبادلة - يمكنك استخدام وضع واحد فقط في كل مرة:

• Manual Accept - الافتراضي، أقصى قدر من التحكم
• Auto-Run - مبسّط للمشاريع الموثوقة
• Plan - وضع تخطيط للقراءة فقط
• Skip Permissions - استقلالية كاملة

يمكنك التبديل بين الأوضاع فورًا عبر زر Switch Permission في مربع الإدخال. يبدّل معظم المستخدمين بين الأوضاع حسب سياق المهمة (مثلًا Plan Mode للميزات المعقدة، وAuto-Run للإصلاحات السريعة).

استخدم وكيل Explorer لمهام الاكتشاف والبحث دون استهلاك السياق الرئيسي. حمّل الملفات مباشرة باستخدام إشارات @ فقط عندما تحتاج إلى تعديلها. يُعد Explorer مثاليًا لأسئلة من نوع "ابحث عن جميع الملفات التي..."، بينما تُستخدم إشارات @ لمهام "حدّث هذا الملف تحديدًا".

نعم! أنشئ وكلاء فرعيين مخصصين في ~/.verdent/subagents/:

---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]

حالات الاستخدام: خبرة في مجالات محددة (المالية، الرعاية الصحية)، وسير عمل الفرق، ومتخصصو التقنية.

نعم. يمكنك مقاطعة التنفيذ في أي وقت. سيكمل Verdent الخطوة الحالية التي يعمل عليها، ثم يتوقف. يُحفَظ التقدم المُحرَز حتى تلك اللحظة. يمكنك مراجعة ما تم إنجازه، وإجراء تعديلات، ثم إما المتابعة أو اتباع نهج مختلف.

راقب قائمة المهام (todo list). تعرض الحالة في الوقت الفعلي مع عنصر واحد يُشار إليه بـ "قيد التنفيذ" في أي لحظة. يعرض العنصر النشط بالضبط ما يعمل عليه Verdent حاليًا. تُعلَّم العناصر المكتملة بأنها "منجزة"، وتُظهر العناصر المعلّقة ما تبقى.

لا. ينشئ Verdent عمليات commit فقط عندما تطلبها صراحةً. تحتفظ بالتحكم الكامل في توقيت حفظ التغييرات. اطلب ببساطة "Stage all changes and create a commit" عندما تكون مستعدًا.

لا. يدفع Verdent إلى المستودعات البعيدة فقط عندما تطلب ذلك صراحةً. تتطلب جميع عمليات Git (commit وpush وmerge وrebase) تعليماتك الصريحة للسلامة.

ثلاث طرق للتخصيص:

1. VERDENT.md: تفضيلات شخصية عامة (~/.verdent/VERDENT.md)
2. AGENTS.md: معايير الفريق الخاصة بالمشروع (جذر المشروع، خاضع للتحكم بالإصدارات)
3. plan_rules.md: صيغة إخراج Plan Mode (~/.verdent/plan_rules.md)

يتفوّق AGENTS.md على VERDENT.md لضمان اتساق الفريق.

تُطبَّق معظم إعدادات Verdent فورًا دون الحاجة إلى إعادة التشغيل:

• أوضاع الأذونات: التبديل الفوري عبر مربع الإدخال
• إعدادات النماذج المسبقة: تُطبَّق على الطلب التالي
• ملفات القواعد: تُطبَّق على المحادثات الجديدة (يؤدي الحفظ إلى إعادة التحميل)
• الوكلاء الفرعيون: متاحون فورًا بعد الإنشاء
• اختصارات لوحة المفاتيح: تُطبَّق بعد الحفظ في VS Code

استثناء: تصبح إعدادات امتداد VS Code (مثل verdent.enableCheckpoints) سارية فورًا، لكنها قد تتطلب إعادة فتح الملفات أو الجلسات للتطبيق الكامل.

يوسّع بروتوكول سياق النموذج (Model Context Protocol، MCP) قدرات Verdent بأدوات وخدمات خارجية:

التهيئة: ~/.verdent/mcp.json عبر الإعدادات ← خوادم MCP

القدرات:

• اتصالات قواعد البيانات (PostgreSQL وMySQL وMongoDB)
• الخدمات السحابية (AWS وAzure وGCP)
• أدوات إدارة المشاريع (Jira وLinear)
• خطوط أنابيب CI/CD (Jenkins وGitHub Actions)

الحالة: وثائق تكامل MCP قيد التطوير. تواصل مع support@verdent.ai للمساعدة في الإعداد.

وحدة قياس نوافذ السياق. تمثل الرموز أجزاءً من النص (كلمات، أجزاء من كلمات، أو أحرف) يعالجها نموذج الذكاء الاصطناعي. تُقاس حدود السياق بالرموز وليس بالأحرف أو الكلمات، وتستهلك المحادثات النموذجية آلاف الرموز.

كل ما في جلستك: جميع الرسائل في المحادثة، ومحتويات الملفات المحمَّلة في السياق، ومخرجات الأدوات (نتائج grep/البحث، قراءات الملفات)، وتعليمات النظام (system prompts)، وتعريفات خوادم MCP. يستهلك كل عنصر من هذه العناصر رموزًا من إجمالي سعة السياق لديك.

تمتلك النماذج القياسية (Claude 4.5 Sonnet وHaiku وGPT-5 وGPT-5-Codex وMiniMax-M2) نوافذ سياق بحجم 200K رمزًا، وهي كافية لمعظم المهام. يوفر Claude Sonnet 4.5 سياقًا موسّعًا بحجم 1M رمزًا (أكبر بـ5 أضعاف) لقواعد الكود الكبيرة التي تحتوي على ملفات 1000+، وإعادة الهيكلة المعقدة متعددة الملفات، أو جلسات التطوير الطويلة. يُفعَّل السياق 1M تلقائيًا عندما يتجاوز الإدخال 200K رمزًا، أو يمكن اختياره صراحةً.

لا يوجد حد ثابت للملفات - يعتمد ذلك على أحجام الملفات وإجمالي عدد الرموز. بالنسبة لسياقات 200K، تجنّب تحميل 20+ ملفات كبيرة (>1000 سطرًا لكل منها). ركّز على الملفات ذات الصلة المباشرة بمهمتك الحالية. استخدم @-mentions بشكل انتقائي، واستفد من وثائق AGENTS.md بدلًا من تحميل ملفات أمثلة كثيرة. مع سياق 1M، يصبح اختيار الملفات أقل أهمية بكثير.

تشمل العلامات بطء أوقات الاستجابة، والجلسات التي تستمر عدة ساعات، أو تحميل ملفات كبيرة كثيرة. راقب طول جلستك وعدد الملفات. عندما تلاحظ تراجعًا في الأداء، أكمل مهمتك الحالية، واحفظ (commit) تقدمك، وابدأ جلسة جديدة بسياق نظيف.

الاستراتيجيات:

1. قراءة الملفات بشكل استراتيجي: استخدم نطاقات الأسطر للملفات الكبيرة
2. التفويض للوكلاء الفرعيين: Explorer/Verifier للبحث في الخلفية
3. البحث قبل القراءة: استخدم grep_file لتحديد الملفات ذات الصلة
4. تقسيم العمليات: استخدم todo_update لتتبع المهام متعددة الخطوات

قاعدة عامة: الملفات التي تتجاوز 500 سطر ينبغي أن تستخدم نطاقات الأسطر.

عليك بدء جلسة جديدة يدويًا لإعادة تعيين السياق - لا يقوم Verdent بمسح السياق تلقائيًا. أفضل ممارسة: أعد التعيين بعد إكمال وحدة عمل متكاملة، واختبارها، وحفظها (commit) في نظام التحكم بالإصدارات. بالنسبة لسياقات 1M رمزًا، تكون عمليات إعادة التعيين أقل تكرارًا بكثير.

لا - تقتصر إعادة تعيين السياق على مسح سجل المحادثة والملفات المحمَّلة من الذاكرة. تُحفظ تغييرات الكود الفعلية، وعمليات الـ commit، وتعديلات الملفات. احرص دائمًا على حفظ (commit) عملك في نظام التحكم بالإصدارات قبل إعادة تعيين السياق للسلامة. إعادة التعيين ← بدء جلسة جديدة ← متابعة العمل على المهمة التالية.

كن دقيقًا بما يكفي لإزالة أي غموض، لكن لا تُفرط في شرح التفاصيل الواضحة. أدرِج: مسارات الملفات الدقيقة، ونهج التنفيذ، والنتائج المتوقعة، والقيود. مثال سيئ: "أصلح الكود" - غامض جدًا. مثال جيد: "أضف التحقق من صحة الإدخال إلى حقل البريد الإلكتروني في ContactForm.js لرفض صيغ البريد الإلكتروني غير الصحيحة" - نطاق وهدف واضحان. عند الشك، اختر جانب مزيد من الدقة.

يحمّل Verdent تلقائيًا الملفات المذكورة بالاسم في الـ prompts والملفات ذات الصلة في المجلد نفسه. تضمن إشارات @-mentions (@filename.js) بشكل صريح أن ملفًا معينًا موجود في السياق، وهو أمر بالغ الأهمية عند العمل مع ملفات مترابطة بشكل وثيق، أو الرجوع إلى أنماط من ملف لتطبيقها في ملف آخر، أو عندما قد يفوت الاكتشاف التلقائي بعض السياق في قواعد الكود الكبيرة. استخدم دائمًا @-mentions عند طلب اتباع نفس النمط في Verdent لضمان إشارة دقيقة إلى الكود.

لا - يحافظ Verdent على سياق المحادثة ضمن الجلسة، لذا لست بحاجة إلى تكرار تفاصيل البنية أو الاتفاقيات التي سبق مناقشتها. لكن، بالنسبة للقيود الحرجة أو عندما تطول الجلسات (100+ رسالة)، أعد ذكر السياق المهم. نهج أفضل: استخدم قواعد المشروع (AGENTS.md) لتوثيق السياق الدائم مثل حزمة التقنيات، ومعايير الترميز، والأنماط - فلن تحتاج بعد ذلك إلى تكرارها أبدًا.

استخدم التنقيح التكراري: راجع المخرجات، وحدد ما هو خاطئ، ثم قدّم التصحيحات في prompt متابعة. مثال: "منطق التحقق جيد، لكن استخدم التحقق بنمط Joi schema بدلًا من الفحوصات اليدوية. طابِق نمط التحقق في ProductController.js." يمكنك أيضًا طلب توضيحات: "لماذا استخدمت Redux بدلًا من Context API؟" ثم نقّح بناءً على الفهم. لا تكرر نفس الـ prompt - اضبطه بناءً على ما فشل.

استخدم Plan Mode عند: إعادة الهيكلة الكبيرة أو التغييرات المعمارية، أو التعديلات متعددة الملفات حيث تريد مراجعة النطاق قبل التنفيذ، أو المهام المعقدة حيث لست متأكدًا من المتطلبات، أو عندما تريد أن يستوضح منك Verdent بأسئلة توضيحية قبل التنفيذ. تجاوز Plan Mode للمهام البسيطة والمحددة جيدًا، أو الإصلاحات السريعة للأخطاء، أو العمليات الروتينية. يضيف Plan Mode عبئًا إضافيًا لكنه يمنع الأخطاء المكلفة في الأعمال المعقدة.

طابِق الإعداد المسبق للنموذج مع تعقيد المهمة والميزانية:

استخدم Efficiency (أكفأ بـ3.2 مرة من Sonnet):

• إصلاحات الأخطاء السريعة وتوليد الكود البسيط
• العمليات الروتينية والمهام عالية التكرار
• عندما تكون السرعة أهم من العمق

استخدم Balance (خط الأساس 1x) - الافتراضي:

• التطوير العام والبرمجة اليومية
• تنفيذ الميزات ومراجعات الكود
• أداء متوازن لمعظم السيناريوهات

استخدم Performance (كفاءة 0.5x، تكلفة 2x):

• القرارات المعمارية المعقدة
• قواعد الكود الكبيرة التي تتطلب سياقًا واسعًا (200 ألف رمز فأكثر)
• التصحيح وإعادة الهيكلة المتقدمة

نصيحة احترافية: يحتفظ معظم المستخدمين بـ Balance كإعداد افتراضي، ويتحولون إلى Performance فقط عند بلوغ حدود السياق أو الحاجة إلى استدلال عميق.

إذا تعذّر على Verdent الاتصال بخدمات الذكاء الاصطناعي، تحقق من هذه المشكلات الشائعة:

اختبار الاتصال الأساسي:

• تحقق من أن لديك وصولًا نشطًا إلى الإنترنت
• حاول الوصول إلى خدمات HTTPS أخرى للتأكد من عمل الاتصالات الصادرة

بيئات الشركات/المؤسسات:

• تواصل مع مسؤول الشبكة لديك لإضافة نقاط نهاية API الخاصة بـ Verdent إلى القائمة البيضاء
• تأكد من السماح بمرور حركة HTTPS الصادرة عبر جدار الحماية لديك
• تحقق مما إذا كانت خوادم الوكيل (proxy) مهيأة بشكل صحيح للسماح بمرور طلبات API
• قد يتطلب فحص SSL/TLS استثناءات لنقاط نهاية Verdent

الأعراض الشائعة:

• يبدو أن الامتداد متجمد أو تنتهي مهلته
• إخفاقات المصادقة رغم صحة بيانات الاعتماد

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

تحقق من:

• الموقع: الملف موجود في جذر المشروع
• الصيغة: Markdown صحيحة
• الدقة: القواعد توجيهية ("استخدم دائمًا..." وليس "حاول...")
• اختبار جديد: ابدأ محادثة جديدة لاختبار التطبيق

الأولوية: يتفوّق AGENTS.md على VERDENT.md في السلوك الخاص بالمشروع.

الأسباب:

• تغيّر النص منذ آخر قراءة
• اختلافات في المسافات البيضاء (مسافات مقابل tabs)
• السلسلة النصية غير فريدة في الملف

الحلول:

• أعد قراءة الملف للحصول على المحتوى الحالي
• قدّم سلسلة سياق أكبر لضمان التفرد
• استخدم replace_all=true للسلاسل النصية المتطابقة المتعددة
• تحقق من صحة file_path

تحقق من:

• الموقع: الملف موجود في ~/.verdent/subagents/[name].md
• سياسة الاستدعاء: تتطلب السياسة الصارمة إشارة @ صريحة
• ترويسة YAML (frontmatter): صيغة صحيحة
• إرشادات "متى نستخدمه": تطابق نمط طلبك

اختبار: استخدم إشارة @ صريحة للتحقق من عمل الوكيل الفرعي: @your-subagent do task