Facade CodeDokumentacja referencyjna konfiguracji
Sprawdź pola pliku facade.json, ich wartości domyślne i sposób, w jaki Facade je stosuje.
Pola najwyższego poziomu
Plik otwórz zgodnie z opisem w artykule Ustawienia agentów. Akceptuje komentarze w JSON i przecinki na końcu. Pusty obiekt oznacza użycie wartości domyślnych.
| Pole | Wartość | Wartość domyślna |
|---|---|---|
yolo | Wartość logiczna kontrolująca zatwierdzenia CLI i dostęp agentów. | true |
names | Lista niepustych proponowanych nazw agentów. | Wbudowana lista nazw |
clis | Obiekt z nadpisaniami wbudowanych CLI i dodatkowymi nazwanymi wpisami. | {}; wbudowane CLI pozostają dostępne |
$schema | Ciąg z metadanymi schematu dla edytora. | Pomijane |
Pola wpisu CLI
| Pole | Wartość | Wartość domyślna |
|---|---|---|
type | claude, codex, agy, muse, opencode, pi lub custom. | Niejawne dla dokładnych identyfikatorów wbudowanych; wymagane w dodanych wpisach. |
command | Jedna nazwa lub ścieżka pliku wykonywalnego. | Polecenie typu w PATH; wymagane dla custom. |
args | Tablica dosłownych ciągów argumentów. | [] |
env | Nazwy zmiennych przypisane do ciągów znaków lub wartości null. | {} |
model | Niepusty identyfikator modelu. | Decyduje CLI. Nieprzyjmowane dla OpenCode i custom. |
effort | Niepusty effort obsługiwany przez CLI i model. | Decyduje CLI. Nieprzyjmowane dla OpenCode i custom. |
enabled | Wartość logiczna kontrolująca przyszłe uruchomienia i przywracanie. | true |
icon | Identyfikator wbudowanego CLI lub obsługiwana ikona robota. | Ikona typu; facade-pearl dla custom. |
Aby skonfigurować wbudowany wpis, użyj dokładnego identyfikatora pisanego małymi literami, np. codex. Nazwa nowego wpisu musi różnić się od wszystkich wbudowanych identyfikatorów i nazw wyświetlanych także przy porównaniu bez uwzględniania wielkości liter. Zamiast Codex użyj na przykład Codex · work. Dodane wpisy nie dziedziczą ustawień od wbudowanego wpisu swojego typu.
enabled: false ukrywa prawidłowy wpis i blokuje przyszłe uruchomienia oraz przywracanie. Nie zatrzymuje agenta, który już działa.
Wartości środowiskowe
{
"clis": {
"codex": {
"env": {
"WORK_API_KEY": "${env:WORK_API_KEY}",
"OLD_TOKEN": null
}
}
}
}- Ciąg znaków ustawia zmienną. Wartość
nullusuwa ją. Pominięta zmienna jest dziedziczona. ${env:NAME}odczytuje środowisko hosta edytora. Nie odczytuje innego klucza z tego samego obiektu.- Brak zmiennej wskazanej w odwołaniu powoduje, że wpis staje się niedostępny. Odwołania są rozwijane jednokrotnie w wartościach
env, a nie wargs. - Wartość dosłowna pozostaje w pliku facade.json. Odwołanie do zmiennej środowiskowej pozwala trzymać tę wartość poza plikiem, ale CLI i tak otrzymuje rozwiniętą wartość.
Ustawienie zmiennej w już otwartym zintegrowanym terminalu nie zmienia środowiska hosta edytora. Udostępnij ją przed uruchomieniem edytora.
Kolejność pierwszeństwa i opcje uruchamiania
Facade najpierw używa modelu i effortu podanych dla nowego agenta, a potem wartości domyślnych wpisu. Jeśli wartości nie podano w żadnym z tych miejsc, decyduje CLI. OpenCode przechowuje oba wybory we własnej konfiguracji.
W przypadku typów wbudowanych używaj dedykowanych pól model i effort. Facade ustawia też uprawnienia, identyfikatory rozmów, foldery robocze i własne narzędzia. Odrzuca argumenty, które kolidują z tymi wyborami lub uniemożliwiają uruchomienie sesji interaktywnej.
Facade szuka pliku facade.json w katalogu Facade: najpierw w ustawieniu VS Code Facade: Home, potem w zmiennej FACADE_HOME, a na końcu w ~/.facade. Uruchom polecenie Open Settings w danym projekcie, aby znaleźć jego aktywny plik.
Błędy pliku i błędy wpisów
Błąd na poziomie pliku, np. nieprawidłowy JSON, zduplikowany klucz lub nieznane pole najwyższego poziomu, blokuje nowe uruchomienia i przywracanie. Błąd w jednym wpisie CLI powoduje, że niedostępny jest tylko ten wpis. Działający agenci nadal działają.
Odszukaj ustawienie wskazane w komunikacie błędu i popraw jego wartość. Facade nie podstawia po cichu starych ustawień. Typowe błędy uruchamiania i błędy dostawców opisuje artykuł Rozwiązywanie problemów.