Ignorowanie plików
Kontroluj, do których plików Bob Shell ma dostęp, tworząc plik `.bobignore` w swoim projekcie.
Przegląd
| Funkcja | Opis | Korzyść |
|---|---|---|
| Wykluczanie ścieżek | Zapobiega dostępowi Bob Shell do konkretnych plików lub katalogów | Chroni wrażliwe informacje |
| Dopasowywanie wzorców | Używaj wzorców glob do dopasowywania wielu plików | Efektywne wykluczanie typów plików |
| Obsługa negacji | Zastępuj wykluczenia dla konkretnych plików | Precyzyjna kontrola |
| Specyficzne dla projektu | Każdy projekt może mieć własne reguły wykluczeń | Dostosowane do potrzeb projektu |
Dlaczego warto używać .bobignore?
- Ochrona prywatności: Trzymaj wrażliwe pliki, takie jak klucze API i poświadczenia, w tajemnicy
- Poprawa wydajności: Wyklucz duże pliki binarne lub katalogi spowalniające operacje
- Redukcja szumu: Usuń nieistotne pliki z kontekstu Bob Shell
- Kontrola skupienia: Kieruj uwagę Bob Shell na najbardziej istotne części kodu
Jak działa .bobignore
Gdy dodasz ścieżki do pliku .bobignore, narzędzia Bob Shell, które respektują ten plik, automatycznie wykluczą pasujące pliki i katalogi ze swoich operacji. Na przykład podczas używania polecenia read_many_files wszelkie ścieżki w pliku .bobignore będą pomijane.
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ Pliki projektu │────▶│ Filtr │────▶│ Pliki dostępne │
│ │ │ .bobignore │ │ dla Bob Shell │
│ │ │ │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘Zmiany w pliku .bobignore wymagają ponownego uruchomienia sesji Bob Shell, aby weszły w życie.
Składnia wzorców
Plik .bobignore używa tej samej składni wzorców co .gitignore:
| Wzorzec | Opis | Przykład |
|---|---|---|
file.txt | Dopasowuje konkretny plik | apikeys.txt |
*.ext | Dopasowuje wszystkie pliki z rozszerzeniem | *.log |
/dir/ | Dopasowuje katalog | /node_modules/ |
/path/to/file | Zakotwicza ścieżkę do katalogu głównego | /src/config/secrets.json |
!pattern | Neguje poprzedni wzorzec | !important.md |
# | Wiersz komentarza | # API credentials |
Pierwsze kroki
Tworzenie pliku .bobignore
- Utwórz plik o nazwie
.bobignorew katalogu głównym projektu - Dodaj wzorce dla plików i katalogów, które chcesz wykluczyć
- Zapisz plik i uruchom ponownie sesję Bob Shell
# Z katalogu głównego projektu
touch .bobignore
echo "# Files to ignore" > .bobignore
echo "secrets/" >> .bobignoreTypowe wzorce wykluczeń
Oto kilka typowych wzorców, które możesz chcieć dodać do pliku .bobignore:
# Wrażliwe informacje
.env
secrets/
*password*
*credential*
*apikey*
# Duże katalogi
node_modules/
.git/
dist/
build/
# Pliki binarne i medialne
*.zip
*.tar.gz
*.mp4
*.jpg
*.png
# Pliki dziennika
*.log
logs/Przykłady wzorców
Wykluczanie konkretnych katalogów
Aby wykluczyć całe katalogi i ich zawartość:
# Wyklucz katalog packages i całą jego zawartość
/packages/
# Wyklucz wszystkie katalogi node_modules w dowolnym miejscu projektu
**/node_modules/
# Wyklucz katalog dist, ale tylko na poziomie głównym
/dist/Używanie symboli wieloznacznych
Symbole wieloznaczne pozwalają dopasowywać wiele plików o podobnych wzorcach:
# Wyklucz wszystkie pliki markdown
*.md
# Wyklucz wszystkie pliki JavaScript w katalogu src
/src/**/*.js
# Wyklucz wszystkie pliki z "test" w nazwie
*test*Używanie negacji
Możesz zastępować wykluczenia dla konkretnych plików:
# Wyklucz wszystkie pliki markdown
*.md
# Ale dołącz README.md
!README.md
# I dołącz wszystkie pliki markdown w katalogu docs
!docs/*.mdZaawansowane użycie
Łączenie wzorców
Możesz tworzyć zaawansowane reguły wykluczeń, łącząc wzorce:
# Wyklucz wszystkie pliki JavaScript
*.js
# Ale dołącz wszystkie pliki w katalogu src
!src/**/*.js
# Z wyjątkiem plików testowych w katalogu src
src/**/*.test.jsDebugowanie pliku .bobignore
Jeśli Bob Shell wydaje się ignorować pliki, do których chcesz mieć dostęp, lub uzyskuje dostęp do plików, które chcesz zignorować:
- Sprawdź plik
.bobignorepod kątem sprzecznych wzorców - Pamiętaj, że bardziej specyficzne wzorce (takie jak negacje) powinny znajdować się po ogólnych wzorcach
- Uruchom ponownie sesję Bob Shell po dokonaniu zmian
- Używaj ścieżek bezwzględnych, jeśli ścieżki względne nie działają zgodnie z oczekiwaniami
Najlepsze praktyki
- Zacznij prosto: Zacznij od kilku podstawowych wzorców i dodawaj więcej w razie potrzeby
- Komentuj wzorce: Dodawaj komentarze wyjaśniające, dlaczego określone pliki są wykluczone
- Bądź precyzyjny: Używaj dokładnych wzorców, aby uniknąć przypadkowego wykluczenia ważnych plików
- Rozważ bezpieczeństwo: Zawsze wykluczaj pliki zawierające wrażliwe informacje
- Utrzymuj regularnie: Aktualizuj plik
.bobignorew miarę rozwoju projektu
Persony agentów
Twórz wielokrotnego użytku pliki person, które definiują rolę, fokus i dostęp do tooli subagenta. Określ, czego szuka subagent, jak formatuje wyniki i czego nie może robić.
Dane telemetryczne
Dowiedz się o danych telemetrycznych, które Bob Shell może zbierać, jak są wykorzystywane do ulepszania produktu oraz jak włączyć lub wyłączyć zbieranie danych.