Facade CodeReferensi konfigurasi
Cari field di facade.json, nilai default-nya, dan cara Facade menerapkannya.
Field tingkat atas
Buka berkasnya lewat Pengaturan agen. Berkas ini menerima komentar JSON dan koma di akhir. Objek kosong berarti memakai semua default.
| Field | Nilai | Default |
|---|---|---|
yolo | Boolean yang mengendalikan persetujuan CLI dan akses agen. | true |
names | Daftar nama agen yang disarankan, tanpa entri kosong. | Daftar nama bawaan |
clis | Objek berisi penggantian setelan CLI bawaan dan entri bernama tambahan. | {}; CLI bawaan tetap tersedia |
$schema | String untuk metadata skema editor. | Tidak diisi |
Field entri CLI
| Field | Nilai | Default |
|---|---|---|
type | claude, codex, agy, muse, opencode, pi, atau custom. | Implisit untuk ID bawaan yang tepat; wajib untuk entri tambahan. |
command | Satu nama atau path executable. | Perintah tipe tersebut di PATH; wajib untuk custom. |
args | Array string argumen literal. | [] |
env | Nama variabel yang dipetakan ke string atau null. | {} |
model | ID model yang tidak kosong. | Ditentukan CLI. Tidak diterima untuk OpenCode atau custom. |
effort | Effort yang tidak kosong dan didukung CLI serta modelnya. | Ditentukan CLI. Tidak diterima untuk OpenCode atau custom. |
enabled | Boolean yang mengendalikan peluncuran dan pemulihan berikutnya. | true |
icon | ID CLI bawaan atau ikon robot yang didukung. | Ikon tipe tersebut; facade-pearl untuk custom. |
Gunakan ID huruf kecil yang tepat untuk mengonfigurasi entri bawaan, misalnya codex. Nama entri baru harus berbeda dari semua ID dan nama tampilan bawaan, bahkan saat huruf besar/kecil diabaikan. Misalnya, gunakan Codex · work, bukan Codex. Entri tambahan tidak mewarisi pengaturan dari tipe bawaannya.
enabled: false menyembunyikan entri yang valid dan menolak peluncuran atau pemulihan berikutnya. Agen yang sedang berjalan tidak ikut dihentikan.
Nilai lingkungan
{
"clis": {
"codex": {
"env": {
"WORK_API_KEY": "${env:WORK_API_KEY}",
"OLD_TOKEN": null
}
}
}
}- String menetapkan variabel.
nullmenghapusnya. Variabel yang tidak disebutkan akan diwarisi. ${env:NAME}membaca lingkungan host editor. Ia tidak membaca kunci lain di objek yang sama.- Referensi yang tidak ada membuat entri tersebut tidak tersedia. Referensi diperluas sekali di nilai
env, bukan diargs. - Nilai literal tetap tersimpan di facade.json. Referensi lingkungan membuat nilai itu tidak tersimpan di berkas, tetapi CLI tetap menerima nilai hasil perluasannya.
Menyetel variabel di terminal terintegrasi yang sudah terbuka tidak memperbarui lingkungan host editor. Sediakan variabel itu sebelum memulai editor.
Prioritas dan opsi peluncuran
Facade lebih dulu memakai model dan effort yang ditentukan untuk agen baru, lalu default entrinya. Jika keduanya tidak memberi nilai, CLI yang menentukan. OpenCode menyimpan kedua pilihan itu di konfigurasinya sendiri.
Untuk tipe bawaan, gunakan field khusus untuk model dan effort. Facade juga menetapkan izin, ID percakapan, folder kerja, dan alatnya sendiri. Facade menolak argumen yang bertentangan dengan pilihan ini atau yang menghalangi sesi interaktif untuk dimulai.
Facade mencari facade.json di home Facade, yaitu pengaturan Facade: Home di VS Code Settings bila diisi, lalu FACADE_HOME, lalu ~/.facade. Buka Open Settings dari proyeknya untuk menemukan berkas yang aktif.
Kesalahan berkas dan kesalahan entri
Kesalahan tingkat berkas, seperti JSON tidak valid, kunci duplikat, atau field tingkat atas yang tidak dikenal, menghalangi peluncuran dan pemulihan baru. Kesalahan di dalam satu entri CLI hanya membuat entri itu tidak tersedia. Agen yang sedang berjalan tetap berjalan.
Ikuti path pengaturan yang disebut dalam kesalahan dan perbaiki nilainya. Facade tidak diam-diam memakai pengaturan lama sebagai gantinya. Lihat Pemecahan masalah untuk kesalahan peluncuran dan penyedia yang umum.