استبعاد الملفات من استخدام Gemini Code Assist

يتيح Gemini Code Assist استبعاد الملفات من السياق لإنشاء التعليمات البرمجية وإكمالها وتحويلها والمحادثة. بالنسبة إلى مستخدمي Enterprise، يشمل ذلك أيضًا تخصيص التعليمات البرمجية.

في العديد من السيناريوهات، ستكون لديك ملفات أو أشجار فرعية معيّنة لا تريد تضمينها في السياق.

يمكنك استبعاد هذه الملفات باستخدام ملف ‎.aiexclude أو ملف ‎.gitignore. يمكن لمستخدمي Gemini CLI استبعاد الملفات باستخدام ملف .geminiignore.

ضبط إعدادات استبعاد السياق

يوضّح لك هذا القسم كيفية ضبط إعدادات ملفَي ‎.aiexclude و‎.gitignore.

تغيير ملف ‎ .aiexclude إلى الملف المفضّل

يتم ضبط استبعاد السياق تلقائيًا على استخدام ملف ‎.aiexclude. لتغيير هذا الإعداد في بيئة التطوير المتكاملة، اتّبِع الخطوات التالية:

VS Code

  1. في شريط الأنشطة، انقر على settings إدارة > الإعدادات.

  2. في نافذة الإعدادات ، انتقِل إلى الإضافات > Gemini Code Assist. انتقِل إلى أسفل الصفحة حتى يظهر لك ملف استبعاد السياق.

  3. في حقل النص، غيِّر .aiexclude إلى الموقع الجغرافي المفضّل.

تم الآن ضبط الملف المفضّل كملف استبعاد السياق.

IntelliJ

لا يتيح JetBrains IDEs ضبط إعدادات ملفَي ‎.aiexclude و‎.gitignore.

تغيير استبعاد سياق ملف ‎ .gitignore

يكون ملف ‎.gitignore مفعّلاً تلقائيًا لاستبعاد السياق. يجب أن يكون الملف في مجلد العمل الرئيسي لـ Gemini Code Assist. لن يتم أخذ ملفات ‎.gitignore الموجودة في الأدلة الفرعية في الاعتبار أو دمجها.

لإيقاف ملفات ‎.gitignore من استبعاد السياق، اتّبِع الخطوات التالية:

  1. في شريط الأنشطة، انقر على settings إدارة > الإعدادات.

  2. في نافذة الإعدادات ، انتقِل إلى الإضافات > Gemini Code Assist. انتقِل إلى أسفل الصفحة حتى يظهر لك استبعاد سياق ملف Gitignore.

  3. أزِل العلامة من مربّع الاختيار.

    تم الآن إيقاف ملفات ‎.gitignore لتحديد الملف الذي يجب أن يتجاهله Gemini Code Assist.

كتابة ملف ‎.aiexclude

يتّبع ملف ‎.aiexclude البنية نفسها لملف ‎.gitignore.

أمثلة

توضّح الأمثلة التالية كيفية ضبط ملف ‎.aiexclude:

  • حظر جميع الملفات المسماة apikeys.txt في الدليل الذي يحتوي على ملف ‎.aiexclude أو أدناه:

    apikeys.txt

  • حظر جميع الملفات التي تحتوي على امتداد الملف ‎.key في الدليل الذي يحتوي على ملف ‎.aiexclude أو أدناه:

    *.key

  • حظر ملف apikeys.txt فقط في الدليل نفسه الذي يحتوي على ملف ‎.aiexclude، ولكن ليس أي أدلة فرعية:

    /apikeys.txt

  • حظر جميع الملفات في الدليل my/sensitive/dir وجميع الأدلة الفرعية. يجب أن يكون المسار نسبيًا إلى الدليل الذي يحتوي على ملف ‎.aiexclude.

    my/sensitive/dir/

  • حظر جميع الملفات في الدليل foo والأدلة الفرعية باستثناء الملف المسمّى bar.txt في الدليل foo:

    foo/*
!foo/bar.txt

التحكّم في الوصول إلى الفهرس لتخصيص التعليمات البرمجية

تلقائيًا، يفهرس تخصيص التعليمات البرمجية جميع الـ ملفات التعليمات البرمجية المتوافقة في المستودعات المحدّدة.

لمنع عرض التعليمات البرمجية التي لا تريد استخدامها في السياق، يمكنك استخدام أنماط الفروع للتحكّم في الوصول إلى الفهرس واستخدام فرع ثابت، مثل main.

بدلاً من ذلك، يمكنك أيضًا استبعاد الملفات من السياق عن طريق إنشاء ملف .aiexclude.