Ignorar archivos
Controla a qué archivos puede acceder Bob Shell creando un archivo `.bobignore` en tu proyecto.
Descripción general
| Función | Descripción | Beneficio |
|---|---|---|
| Exclusión de rutas | Evita que Bob Shell acceda a archivos o directorios específicos | Protege información sensible |
| Coincidencia de patrones | Usa patrones glob para coincidir con múltiples archivos | Excluye tipos de archivos de forma eficiente |
| Soporte de negación | Anula exclusiones para archivos específicos | Control granular |
| Específico del proyecto | Cada proyecto puede tener sus propias reglas de exclusión | Adaptado a las necesidades del proyecto |
¿Por qué usar .bobignore?
- Protección de privacidad: Mantén privados los archivos sensibles como API keys y credenciales
- Mejora del rendimiento: Excluye archivos binarios grandes o directorios que ralentizan las operaciones
- Reducción de ruido: Elimina archivos irrelevantes del contexto de Bob Shell
- Control del enfoque: Dirige la atención de Bob Shell a las partes más relevantes de tu base de código
Cómo funciona .bobignore
Cuando agregas rutas a tu archivo .bobignore, las herramientas de Bob Shell que respetan este archivo excluirán automáticamente los archivos y directorios coincidentes de sus operaciones. Por ejemplo, al usar el comando read_many_files, se omitirán las rutas en tu archivo .bobignore.
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ Your project │────▶│ .bobignore │────▶│ Files Bob Shell │
│ files │ │ filter │ │ can access │
│ │ │ │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘Los cambios en tu archivo .bobignore requieren reiniciar la sesión de Bob Shell para que tengan efecto.
Sintaxis de patrones
El archivo .bobignore sigue la misma sintaxis de patrones que .gitignore:
| Patrón | Descripción | Ejemplo |
|---|---|---|
file.txt | Coincide con un archivo específico | apikeys.txt |
*.ext | Coincide con todos los archivos con la extensión | *.log |
/dir/ | Coincide con un directorio | /node_modules/ |
/path/to/file | Ancla la ruta a la raíz | /src/config/secrets.json |
!pattern | Niega un patrón anterior | !important.md |
# | Línea de comentario | # API credentials |
Primeros pasos
Crear un archivo .bobignore
- Crea un archivo llamado
.bobignoreen la raíz del directorio de tu proyecto - Agrega patrones para los archivos y directorios que quieres excluir
- Guarda el archivo y reinicia tu sesión de Bob Shell
# Desde la raíz de tu proyecto
touch .bobignore
echo "# Files to ignore" > .bobignore
echo "secrets/" >> .bobignorePatrones de exclusión comunes
Aquí hay algunos patrones comunes que podrías querer agregar a tu archivo .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/Ejemplos de patrones
Excluir directorios específicos
Para excluir directorios completos y su contenido:
# 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/Usar comodines
Los comodines te permiten coincidir con múltiples archivos con patrones similares:
# Exclude all markdown files
*.md
# Exclude all JavaScript files in the src directory
/src/**/*.js
# Exclude all files with "test" in their name
*test*Usar negación
Puedes anular exclusiones para archivos específicos:
# Exclude all markdown files
*.md
# But include README.md
!README.md
# And include all markdown files in the docs directory
!docs/*.mdUso avanzado
Combinar patrones
Puedes crear reglas de exclusión sofisticadas combinando patrones:
# 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.jsDepurar tu archivo .bobignore
Si Bob Shell parece estar ignorando archivos a los que quieres que acceda, o accediendo a archivos que quieres que ignore:
- Revisa tu archivo
.bobignoreen busca de patrones conflictivos - Recuerda que los patrones más específicos (como las negaciones) deben ir después de los patrones generales
- Reinicia tu sesión de Bob Shell después de hacer cambios
- Usa rutas absolutas si las rutas relativas no funcionan como se esperaba
Buenas prácticas
- Empieza simple: Comienza con unos pocos patrones esenciales y agrega más según sea necesario
- Comenta tus patrones: Agrega comentarios para explicar por qué se excluyen ciertos archivos
- Sé específico: Usa patrones precisos para evitar excluir accidentalmente archivos importantes
- Considera la seguridad: Siempre excluye los archivos que contienen información sensible
- Mantén regularmente: Actualiza tu archivo
.bobignorea medida que evoluciona tu proyecto
Personas de agentes
Crea archivos de persona reutilizables que definen el rol, el enfoque y el acceso a tools de un subagent. Define en qué se fija un subagent, cómo formatea su salida y qué no puede hacer.
Datos de telemetría
Conozca los datos de telemetría que Bob Shell puede recopilar, cómo se utilizan para mejorar el producto y cómo habilitar o deshabilitar la recopilación de datos.