Konfigurowanie
Możesz skonfigurować Bob Shell zgodnie z preferencjami swojego workflow'u.
Lokalizacje pliku ustawień
Bob Shell przechowuje ustawienia w dwóch miejscach:
| Zakres | Plik |
|---|---|
| Użytkownik (wszystkie obszary robocze) | ~/.bob/settings/settings.json |
| Projekt (bieżący obszar roboczy) | <workspace>/.bob/ |
Flagi CLI zawsze zastępują wartości pliku dla bieżącej sesji. Możesz też zmieniać ustawienia interaktywnie za pomocą polecenia slash /settings wewnątrz bob chat.
Schemat ustawień
{
"session": {
"maxTurns": 50,
"defaultMode": "agent",
"mcp": true,
"subagents": true
},
"logging": {
"logLevel": "warn"
},
"tasks": {
"retentionDays": 30
},
"telemetry": {
"enabled": true
}
}| Ustawienie | Typ | Domyślne | Opis |
|---|---|---|---|
session.maxTurns | number | 50 | Maksymalna liczba tur agentycznych na sesję (0 = nieograniczone) |
session.defaultMode | string | "agent" | Domyślny tryb przy uruchamianiu sesji |
session.mcp | boolean | true | Domyślnie włącz serwery Model Context Protocol (MCP) |
session.subagents | boolean | true | Domyślnie włącz uruchamianie subagentów |
logging.logLevel | string | "warn" | Szczegółowość logów (error, warn, info, debug, trace) |
tasks.retentionDays | number | 30 | Liczba dni przechowywania historii zadań. Ustaw wartość 0, aby wyłączyć automatyczne czyszczenie i zachować całą historię zadań. |
telemetry.enabled | boolean | true | Czy telemetria użytkowania jest wysyłana. Wyłączenie zapobiega zbieraniu danych o użytkowaniu. |
Ustaw tasks.retentionDays na 0 tylko w Bob Shell 2.0.1 lub nowszym. Ustawienie tej wartości na 0 we wcześniejszych wersjach może usunąć nieprzypięte zadania i ich historię.
| telemetry.excludePayload | boolean | — | Użytkownicy IBM: wyklucz payload konwersacji z telemetrii. Włączaj tylko dla zatwierdzonych wrażliwych projektów. |
Tokeny uwierzytelniające (OAuth) są przechowywane oddzielnie w ~/.bob/settings/auth-secrets.json.
Pliki dziennika
Dzienniki są zapisywane w ~/.bob/logs/shell/ przy użyciu rotacyjnych plików (bob-<timestamp>.log). Przechowywanych jest maksymalnie 10 plików dziennika; starsze pliki są automatycznie usuwane. Maksymalny rozmiar pliku dziennika przed rotacją wynosi 5 MB.
Użyj --log-level debug (lub BOB_LOG_LEVEL=debug), aby przechwytywać szczegółowe wyjście:
BOB_LOG_LEVEL=debug bob chat
bob run --log-level debug "Explain @app.js"Możesz też otworzyć najnowszy plik dziennika bezpośrednio z poziomu sesji za pomocą polecenia slash /logs.
Pliki kontekstu
Pliki kontekstu (takie jak AGENTS.md) dostarczają instrukcji do modelu AI. Pliki te są ładowane hierarchicznie:
- Kontekst globalny:
~/.bob/AGENTS.md(dotyczy wszystkich projektów) - Kontekst projektu:
AGENTS.mdw katalogu głównym projektu i katalogach nadrzędnych - Kontekst lokalny:
AGENTS.mdw podkatalogach (dla instrukcji specyficznych dla komponentów)
Przykładowy plik kontekstu
# Project: My TypeScript Library
## General instructions
- Follow existing coding style
- Add JSDoc comments to all functions
- Prefer functional programming patterns
- Target TypeScript 5.0 and Node.js 20+
## Coding style
- Use 2 spaces for indentation
- Interface names should be prefixed with `I`
- Private class members should be prefixed with `_`
- Use strict equality (`===` and `!==`)Statystyki użytkowania
Bob Shell zbiera anonimowe statystyki użytkowania w celu ulepszania produktu. Obejmuje to:
- Wzorce użycia narzędzi (nazwy, sukces/niepowodzenie, czas trwania)
- Metryki żądań API (model, czas trwania, sukces)
- Informacje o konfiguracji sesji
Żadne dane osobowe, treść zapytań ani zawartość plików nie są zbierane.
Aby zrezygnować, ustaw telemetry.enabled na false w pliku ustawień:
{
"telemetry": {
"enabled": false
}
}Narzędzia
Dowiedz się, jak Bob Shell używa specjalistycznych narzędzi do odczytywania plików, edytowania kodu, uruchamiania poleceń i interakcji ze środowiskiem deweloperskim z wiersza poleceń.
Skróty klawiszowe
Znajdź wszystkie dostępne skróty według funkcji, z wariantami specyficznymi dla platformy tam, gdzie mają zastosowanie.