VS Code Extension
الأدلة
إضافة VS Code
افحص مساحة العمل من داخل VS Code. تظهر النتائج في المحرر ولوحة Problems والشريط الجانبي لـ Scanverra، والكود لا يغادر جهازك أبدًا.
التثبيت
الإضافة منشورة في Visual Studio Marketplace باسم Scanverra.
- افتح عرض الإضافات (Ctrl+Shift+X، أو Cmd+Shift+X على macOS).
- ابحث عن Scanverra وانقر على تثبيت.
- تظهر أيقونة درع في شريط النشاط. هذا هو عرض Scanverra.
أو الصق هذا في Quick Open (Ctrl+P، أو Cmd+P على macOS)
ext install scanverra.scanverra-vscode
تسجيل الدخول
يحتاج الفحص إلى مفتاح API من Scanverra. أنشئ مفتاحًا من لوحة التحكم في صفحة API Keys.
- افتح عرض Scanverra. إذا لم تكن مسجّل الدخول، تظهر بطاقة تسجيل الدخول.
- الصق مفتاح API وانقر على Save API key. يتم التحقق من المفتاح مع Scanverra قبل حفظه.
- يمكنك أيضًا تشغيل Scanverra: Log In with API Key من لوحة الأوامر.
تستخدم الإضافة وScanverra CLI تسجيل الدخول المحفوظ نفسه. إذا شغّلت scanverra login من قبل، فالإضافة مسجّلة الدخول أيضًا، وتسجيل الدخول من VS Code يسجّل دخول CLI كذلك.
انقر على Log out في عرض Scanverra، أو شغّل Scanverra: Log Out. يؤدي ذلك إلى حذف المفتاح المحفوظ للإضافة وCLI على هذا الجهاز.
افحص مساحة العمل
- افتح مجلدًا في VS Code.
- انقر على Scan Workspace في عرض Scanverra، أو على الدرع في شريط الحالة، أو شغّل Scanverra: Scan Workspace.
- تظهر النتائج كخطوط متموجة في المحرر وفي لوحة Problems، ومجمعة حسب الملف في الشريط الجانبي.
- استخدم شارات الخطورة ومربع البحث لتضييق القائمة، ثم انقر على View للانتقال إلى النتيجة أو Fix لقراءة الإصلاح المقترح.
- انقر على Clear لمسح النتائج.
كيف تعمل
تشخيصات داخل الكود
تظهر كل نتيجة في سطرها في المحرر وتُدرج في لوحة Problems.
شريط جانبي للفرز
الدرجة وبوابة الجودة وفلاتر الخطورة والنتائج حسب الملف، وثغرات الاعتماديات في تبويب منفصل.
فحص محلي
المحرك نفسه المستخدم في CLI. تُقرأ الملفات وتُفحص على جهازك.
تتذكر آخر فحص
تُحفظ النتائج لكل مساحة عمل، فتبقى موجودة بعد إعادة تشغيل VS Code.
الأوامر
جميع الأوامر متاحة من لوحة الأوامر (Ctrl+Shift+P، أو Cmd+Shift+P على macOS).
| الأمر | الوصف |
|---|---|
Scanverra: Scan Workspace | افحص المجلد المفتوح واعرض النتائج |
Scanverra: Clear Scan Results | أزل النتائج من المحرر والشريط الجانبي |
Scanverra: Open Full View | افتح النتائج في تبويب محرر كامل |
Scanverra: Log In with API Key | الصق مفتاح API وتحقق منه |
Scanverra: Get an API Key | افتح صفحة API Keys في المتصفح |
Scanverra: Log Out | احذف مفتاح API المحفوظ |
ما الذي يغادر جهازك
تنزّل الإضافة قواعد الفحص الموقّعة من Scanverra وتتحقق منها وتشغّل كل فحص على جهازك. لا ترفع ملفاتك ولا أسطر الكود المكتشفة ولا أي تقرير. يُرسل مفتاح API فقط للتحقق من حسابك وخطتك.
القيود الحالية
- يعمل الفحص عند طلبه فقط. لا يوجد فحص عند الحفظ بعد.
- تُميَّز النتائج على السطر كاملًا، وليس على عمود محدد.
- في مساحة عمل متعددة الجذور، يُفحص المجلد الأول فقط.
استكشاف الأخطاء
| الرسالة | ما يجب فعله |
|---|---|
Log in to Scanverra | الصق مفتاح API في عرض Scanverra، أو شغّل Scanverra: Log In with API Key |
That API key was rejected | المفتاح خاطئ أو أُلغي. أنشئ مفتاحًا جديدًا في API Keys |
Your saved API key was rejected | المفتاح المحفوظ لم يعد يعمل. الصق مفتاحًا جديدًا في بطاقة تسجيل الدخول |
Requires a Pro, Team or Enterprise plan | رقِّ خطتك ثم أعد الفحص |
Open a folder to scan | افتح مجلدًا من ملف > فتح مجلد، ثم افحص |
No scannable files found | تحقق من المجلد ومن ملف .gitignore أو .scanverraignore |
جاهز للفحص من محررك؟
أنشئ مفتاح API، وثبّت الإضافة، وشغّل أول فحص.