تجاهل الملفات
تحكّم في الملفات التي يمكن لـ Bob Shell الوصول إليها عبر إنشاء ملف `.bobignore` في مشروعك.
نظرة عامة
| الميزة | الوصف | الفائدة |
|---|---|---|
| استبعاد المسارات | منع Bob Shell من الوصول إلى ملفات أو مجلدات محددة | حماية المعلومات الحساسة |
| مطابقة الأنماط | استخدام أنماط glob لمطابقة ملفات متعددة | استبعاد أنواع ملفات بكفاءة |
| دعم النفي | تجاوز الاستبعادات لملفات محددة | تحكم دقيق |
| خاص بالمشروع | يمكن لكل مشروع أن يمتلك قواعد استبعاد خاصة به | مخصص لاحتياجات المشروع |
لماذا تستخدم .bobignore؟
- حماية الخصوصية: احتفظ بسرية الملفات الحساسة مثل مفاتيح API وبيانات الاعتماد
- تحسين الأداء: استبعد الملفات الثنائية الكبيرة أو المجلدات التي تبطئ العمليات
- تقليل الضوضاء: احذف الملفات غير ذات الصلة من سياق Bob Shell
- التحكم في التركيز: وجّه انتباه Bob Shell نحو الأجزاء الأكثر صلة من قاعدة الكود
كيف يعمل .bobignore
عندما تضيف مسارات إلى ملف .bobignore، ستستبعد أدوات Bob Shell التي تحترم هذا الملف تلقائيًا الملفات والمجلدات المطابقة من عملياتها. على سبيل المثال، عند استخدام أمر read_many_files، ستُتخطى أي مسارات في ملف .bobignore.
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ Your project │────▶│ .bobignore │────▶│ Files Bob Shell │
│ files │ │ filter │ │ can access │
│ │ │ │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘التغييرات على ملف .bobignore تستلزم إعادة تشغيل جلسة Bob Shell لتصبح فعّالة.
صيغة الأنماط
يتبع ملف .bobignore نفس صيغة الأنماط كـ .gitignore:
| النمط | الوصف | مثال |
|---|---|---|
file.txt | يطابق ملفًا محددًا | apikeys.txt |
*.ext | يطابق جميع الملفات بالامتداد | *.log |
/dir/ | يطابق مجلدًا | /node_modules/ |
/path/to/file | يرسو المسار إلى الجذر | /src/config/secrets.json |
!pattern | ينفي نمطًا سابقًا | !important.md |
# | سطر تعليق | # API credentials |
البدء
إنشاء ملف .bobignore
- أنشئ ملفًا باسم
.bobignoreفي جذر مجلد مشروعك - أضف أنماطًا للملفات والمجلدات التي تريد استبعادها
- احفظ الملف وأعد تشغيل جلسة Bob Shell
# From your project root
touch .bobignore
echo "# Files to ignore" > .bobignore
echo "secrets/" >> .bobignoreأنماط الاستبعاد الشائعة
إليك بعض الأنماط الشائعة التي قد ترغب في إضافتها إلى ملف .bobignore:
# Sensitive information
.env
secrets/
*password*
*credential*
*apikey*
# Large directories
node_modules/
.git/
dist/
build/
# Binary and media files
*.zip
*.tar.gz
*.mp4
*.jpg
*.png
# Log files
*.log
logs/أمثلة على الأنماط
استبعاد مجلدات محددة
لاستبعاد مجلدات بأكملها ومحتوياتها:
# Exclude the packages directory and all its contents
/packages/
# Exclude all node_modules directories anywhere in the project
**/node_modules/
# Exclude the dist directory but only at the root level
/dist/استخدام أحرف البدل
تتيح لك أحرف البدل مطابقة ملفات متعددة بأنماط مشابهة:
# Exclude all markdown files
*.md
# Exclude all JavaScript files in the src directory
/src/**/*.js
# Exclude all files with "test" in their name
*test*استخدام النفي
يمكنك تجاوز الاستبعادات لملفات محددة:
# Exclude all markdown files
*.md
# But include README.md
!README.md
# And include all markdown files in the docs directory
!docs/*.mdالاستخدام المتقدم
دمج الأنماط
يمكنك إنشاء قواعد استبعاد متطورة بدمج الأنماط:
# Exclude all JavaScript files
*.js
# But include all files in the src directory
!src/**/*.js
# Except for test files in the src directory
src/**/*.test.jsتصحيح أخطاء ملف .bobignore
إذا بدا أن Bob Shell يتجاهل ملفات تريده أن يصل إليها، أو يصل إلى ملفات تريد تجاهلها:
- تحقق من ملف
.bobignoreللأنماط المتعارضة - تذكر أن الأنماط الأكثر تحديدًا (مثل النفي) يجب أن تأتي بعد الأنماط العامة
- أعد تشغيل جلسة Bob Shell بعد إجراء التغييرات
- استخدم المسارات المطلقة إذا كانت المسارات النسبية لا تعمل كما هو متوقع
أفضل الممارسات
- ابدأ بسيطًا: ابدأ بعدد قليل من الأنماط الأساسية وأضف المزيد حسب الحاجة
- علّق على أنماطك: أضف تعليقات لتوضيح سبب استبعاد ملفات معينة
- كن محددًا: استخدم أنماطًا دقيقة لتجنب الاستبعاد العرضي للملفات المهمة
- ضع الأمان في الاعتبار: استبعد دائمًا الملفات التي تحتوي على معلومات حساسة
- حافظ على التحديث: حدّث ملف
.bobignoreمع تطور مشروعك
شخصيات الوكلاء
أنشئ ملفات شخصية قابلة لإعادة الاستخدام تحدد دور الوكيل الفرعي وتركيزه ووصوله إلى الأدوات، وتحدد ما الذي يبحث عنه وكيف ينسق مخرجاته وما لا يُسمح له بفعله.
بيانات القياس عن بُعد
تعرّف على بيانات القياس عن بُعد التي يمكن لـ Bob Shell جمعها، وكيف تُستخدم لتحسين المنتج، وكيفية تفعيل أو تعطيل جمع البيانات.