التوثيق · VS Code

إضافة VS Code

اطّلع على أحدث نتائج تدقيق vetkit للمستودع المفتوح لديك مباشرة داخل VS Code، كتشخيصات وفي عرض شجري باسم Findings في شريط نشاط vetkit.

التثبيت

ثبّت vetkit (الناشر vetkit، المعرّف vetkit.vetkit-vscode) من Visual Studio Code Marketplace. يتطلب VS Code 1.85 أو أحدث.

شغّل vetkit: Sign In من لوحة الأوامر، أو انقر Sign in to vetkit في عرض Findings.

يفتح المتصفح تطبيق vetkit على /ide/connect ويعرض رمزًا للاستخدام مرة واحدة. تأكد من أنه يطابق الرمز المعروض في VS Code.
اختر المؤسسة ثم وافق. يلزم دور «عضو» أو أعلى؛ ولا يستطيع «المشاهدون» الموافقة.
تؤدي الموافقة إلى إنشاء مفتاح API للقراءة فقط (النطاقات repos:read وaudits:read وfindings:read وfindings:ai-fix) باسم «VS Code — اسم الجهاز» تنتهي صلاحيته بعد 90 يومًا. تخزّنه الإضافة في التخزين السري لـ VS Code (Secret Storage).

تنتهي صلاحية الرمز الذي يُستخدم مرة واحدة بعد 10 دقائق. إذا انتهت، فابدأ تسجيل الدخول من جديد.

تنبّهك الإضافة قبل نحو 7 أيام من انتهاء صلاحية المفتاح. وعند انتهاء صلاحية المفتاح أو إلغائه تطلب منك تسجيل الدخول مجددًا.

وكبديل، شغّل vetkit: Set API Key والصق مفتاحًا أنشأته بنفسك.

اكتشاف المستودع

تقرأ الإضافة الـ remotes في ملف .git/config الخاص بمساحة العمل (دون تشغيل git)، وتحوّلها إلى الصيغة host/owner/name، وتبحث عنها في المؤسسة المسجَّل الدخول إليها. وإذا وُجدت مطابقة واحدة فقط فتُحدَّد تلقائيًا.

وإلا يعرض vetkit: Select Repository قائمة اختيار تتضمن الخيار Connect this repository in vetkit الذي يفتح صفحة Repositories في vetkit مع تعبئة المستودع مسبقًا.

تأتي النتائج من أحدث تدقيق ناجح على الخادم، لا من محتوى المحرر غير المحفوظ. وتُوسَم بأنها قديمة عندما يختلف HEAD المحلي عن الـ commit الذي جرى تدقيقه.

قطع الاتصال

يلغي vetkit: Sign Out المفتاح على الخادم ويحذفه من جهازك. أما المفتاح الذي لصقته يدويًا فيُنسى محليًا فقط ولا يُلغى.
يمكنك أيضًا إلغاء الجهاز من تطبيق vetkit ضمن Settings → Security → Connected devices، ويستطيع مشرفو المؤسسة إلغاءه ضمن Settings → API keys.
تؤدي إزالة عضو من مؤسسة، أو تغيير دوره إلى «مشاهد»، إلى إلغاء مفاتيح VS Code الخاصة به في تلك المؤسسة تلقائيًا.

البيانات المُرسَلة

عند تسجيل الدخول: اسم الجهاز (المضيف) بعد تنقيته، ويُستخدم لتسمية مفتاح API.
عنوان git remote بعد توحيد صيغته (host/owner/name) للبحث عن المستودع.
طلبات API موثّقة لعرض المستودعات وعمليات التدقيق والنتائج.

لا ترفع الإضافة الشيفرة المصدرية أبدًا.

في التثبيتات المستضافة ذاتيًا، اضبط vetkit.apiUrl (يلزم HTTPS باستثناء localhost). لا يُرسَل المفتاح إلا إلى واجهة API التي أصدرته.