متطلبات النظام والتوافق
الأنظمة الأساسية المدعومة وإصدارات بيئات التطوير ومتطلبات الشبكة
Verdent for VS Code هو امتداد أصلي لـ Visual Studio Code يرث توافق Visual Studio Code عبر الأنظمة الأساسية المختلفة دون الحاجة إلى عمليات تثبيت أو إعدادات منفصلة لأنظمة التشغيل المختلفة.
أنظمة التشغيل المدعومة
يدعم Verdent for VS Code جميع أنظمة التشغيل التي يتوفر عليها Visual Studio Code:
| نظام التشغيل | الإصدارات المدعومة | البنية المعمارية |
|---|---|---|
| macOS | macOS 11 (Big Sur) وما بعده | Intel وApple Silicon |
| Windows | Windows 10 (الإصدار 1607 وما بعده)، Windows 11، Windows Server 2016 وما بعده | 64-bit فقط |
| Linux | Ubuntu 20.04+، Debian 10+، Red Hat Enterprise Linux 8+، Fedora، CentOS 8+، openSUSE Leap 15.2+ | x64 وARM64 |
الأنظمة الأساسية المتوقفة: انتهى دعم macOS 10.15 (Catalina) مع إصدار Visual Studio Code 1.98 (فبراير 2025). لم يعد Windows 7 وWindows 8/8.1 مدعومَين اعتبارًا من Visual Studio Code 1.70 (يوليو 2022). لم تعد أنظمة Windows ذات 32 بت مدعومة اعتبارًا من Visual Studio Code 1.83 (سبتمبر 2023).
متطلبات Linux
بالنسبة لأنظمة Linux، تأكد من أن توزيعتك تفي بهذه المتطلبات:
- glibc 2.28 أو أحدث (اعتبارًا من Visual Studio Code 1.86.1، يناير 2024)
- إصدار GLIBCXX 3.4.25 أو أحدث
إصدارات بيئة التطوير/المحرر المطلوبة
Visual Studio Code:
- يتطلب الإصدار 1.90.0 أو أعلى
- يُنصح باستخدام أحدث إصدار مستقر لأفضل توافق
يعمل Verdent for VS Code مع Visual Studio Code والمحررات المبنية على Visual Studio Code (Cursor، VSCodium). ولا يدعم محررات مثل بيئات تطوير JetBrains، أو Sublime Text، أو Vim.
متطلبات الأجهزة
الحد الأدنى من المتطلبات
| المكوّن | المواصفات |
|---|---|
| ذاكرة الوصول العشوائي (RAM) | 1 جيجابايت (يُنصح بـ 4 جيجابايت أو أكثر للمشاريع الأكبر) |
| مساحة القرص | أقل من 500 ميجابايت لـ Visual Studio Code وامتداد Verdent |
| المعالج | أي معالج قادر على تشغيل Visual Studio Code |
المواصفات الموصى بها
للحصول على أداء مثالي، خاصة عند العمل مع قواعد أكواد كبيرة أو سير عمل متعدد الوكلاء:
- ذاكرة الوصول العشوائي (RAM): 8 جيجابايت أو أكثر
- المعالج: معالج متعدد النواة لتنفيذ الوكلاء الفرعيين بشكل متزامن
- مساحة القرص: 1 جيجابايت أو أكثر للتخزين المؤقت والفهرسة (إذا كانت مفعّلة)
يتوسع الأداء مع قدرات الجهاز. تستفيد سير العمل متعدد الوكلاء وإعادة الهيكلة على نطاق واسع من ذاكرة وصول عشوائي وقدرة معالجة إضافية.
المواصفات الموصى بها هي إرشادات عامة. لا تزال التوصيات الرسمية للأجهزة الخاصة بميزات Verdent (سير العمل متعدد الوكلاء، التخزين المؤقت، الفهرسة) قيد الإعداد من قِبل فريق Verdent.
متطلبات الشبكة
يتطلب Verdent for VS Code اتصالاً نشطًا بالإنترنت في جميع الأوقات للعمل.
متطلبات الاتصال
- نوع الاتصال: اتصال إنترنت واسع النطاق ومستقر
- البروتوكول: اتصالات HTTPS الصادرة إلى نقاط النهاية API الخاصة بـ Verdent
- النطاق الترددي: كافٍ لنقل سياق الكود وبث استجابات الذكاء الاصطناعي
اعتبارات جدار الحماية والوكيل (Proxy)
بالنسبة للبيئات المؤسسية أو المستخدمين خلف جدران الحماية:
الوصول المطلوب:
- حركة مرور HTTPS الصادرة إلى نطاقات API الخاصة بـ Verdent
- يتولى Verdent توجيه الطلبات إلى مزودي النماذج المتعددين (Claude، GPT-5، Gemini، MiniMax، وغيرها)
- لا حاجة إلى قواعد جدار حماية واردة أو إعادة توجيه منافذ
الإعداد المؤسسي:
- يجب أن تسمح جدران الحماية المؤسسية بحركة مرور HTTPS الصادرة إلى نقاط نهاية خدمة Verdent
- يجب أن تمرر خوادم الوكيل (proxy) طلبات API
- قد يتطلب فحص SSL/TLS استثناءات لنقاط نهاية Verdent
بدون الاتصال بالإنترنت، لا يمكن لـ Verdent for VS Code معالجة الطلبات أو تقديم أي وظيفة مدعومة بالذكاء الاصطناعي. لن يعمل الامتداد دون اتصال بالإنترنت.
الأسئلة الشائعة
كيف أتحقق من إصدار Visual Studio Code الخاص بي؟
افتح Visual Studio Code وانتقل إلى Help ← About (أو Code ← About Visual Studio Code على macOS). يظهر رقم الإصدار في مربع الحوار. يتطلب Verdent إصدار Visual Studio Code 1.90.0 أو أعلى.
يمكنك أيضًا التحقق عبر سطر الأوامر:
code --versionكيف أتحقق من أن نظام Linux الخاص بي يفي بالمتطلبات؟
تحقق من إصداري glibc وGLIBCXX باستخدام هذه الأوامر:
# Check glibc version (need 2.28 or later)
ldd --version
# Check GLIBCXX version (need 3.4.25 or later)
strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXXإذا كانت توزيعتك لا تفي بهذه المتطلبات، فقد تحتاج إلى الترقية إلى إصدار أحدث من توزيعة Linux الخاصة بك.
كيف أستكشف مشكلات جدار الحماية أو الاتصال وأصلحها؟
إذا تعذّر على Verdent الاتصال بخدمات الذكاء الاصطناعي، تحقق من هذه المشكلات الشائعة:
اختبار الاتصال الأساسي:
- تحقق من أن لديك وصولاً نشطًا إلى الإنترنت
- جرّب الوصول إلى خدمات HTTPS أخرى للتأكد من أن الاتصالات الصادرة تعمل
بيئات الشركات/المؤسسات:
- تواصل مع مسؤول الشبكة لديك لإدراج نقاط نهاية API الخاصة بـ Verdent في القائمة البيضاء
- تأكد من السماح بحركة مرور HTTPS الصادرة عبر جدار الحماية لديك
- تحقق مما إذا كانت خوادم الوكيل (proxy) مُهيأة بشكل صحيح لتمرير طلبات API
- قد يحتاج فحص SSL/TLS إلى استثناءات لنقاط نهاية Verdent
الأعراض الشائعة:
- يبدو أن الامتداد متجمد أو تنتهي مهلته
- فشل المصادقة رغم صحة بيانات الاعتماد
إذا استمرت المشكلات بعد ضبط إعدادات جدار الحماية، تواصل مع دعم Verdent للحصول على تفاصيل نقاط النهاية المحددة لإدراجها في القائمة البيضاء.