Facade CodeTham chiếu cấu hình
Tra cứu các trường trong facade.json, giá trị mặc định và cách Facade áp dụng chúng.
Trường cấp cao nhất
Mở tệp qua Cài đặt agent. Tệp chấp nhận chú thích JSON và dấu phẩy ở cuối. Một đối tượng rỗng sẽ dùng giá trị mặc định.
| Trường | Giá trị | Mặc định |
|---|---|---|
yolo | Giá trị boolean điều khiển phê duyệt của CLI và quyền truy cập agent. | true |
names | Danh sách tên gợi ý cho agent; từng tên không được để trống. | Danh sách tên tích hợp |
clis | Đối tượng chứa các cài đặt ghi đè cho mục tích hợp sẵn và các mục bổ sung có tên riêng. | {}; các CLI tích hợp vẫn khả dụng |
$schema | Chuỗi metadata schema cho trình soạn thảo. | Không đặt |
Các trường của mục CLI
| Trường | Giá trị | Mặc định |
|---|---|---|
type | claude, codex, agy, muse, opencode, pi hoặc custom. | Ngầm định với ID tích hợp chính xác; bắt buộc với mục thêm mới. |
command | Một tên hoặc đường dẫn tệp thực thi. | Lệnh theo loại, tìm trong PATH; bắt buộc với custom. |
args | Mảng các chuỗi đối số nguyên văn. | [] |
env | Tên biến ánh xạ tới chuỗi hoặc null. | {} |
model | ID mô hình, không để trống. | CLI quyết định. Không chấp nhận trường này cho OpenCode hoặc custom. |
effort | Mức effort không để trống, được CLI và mô hình hỗ trợ. | CLI quyết định. Không chấp nhận trường này cho OpenCode hoặc custom. |
enabled | Giá trị boolean điều khiển các lần khởi chạy sau và việc khôi phục. | true |
icon | ID CLI tích hợp hoặc biểu tượng robot được hỗ trợ. | Biểu tượng theo loại; facade-pearl với custom. |
Dùng đúng ID chữ thường để cấu hình một mục tích hợp, như codex. Mục mới phải có tên khác với mọi ID tích hợp và tên hiển thị, kể cả khi không phân biệt chữ hoa chữ thường. Ví dụ, hãy dùng Codex · work thay vì Codex. Mục thêm mới không kế thừa cài đặt từ mục tích hợp cùng loại.
enabled: false ẩn một mục hợp lệ và từ chối các lần khởi chạy hay khôi phục sau này. Nó không dừng một agent đang chạy.
Giá trị môi trường
{
"clis": {
"codex": {
"env": {
"WORK_API_KEY": "${env:WORK_API_KEY}",
"OLD_TOKEN": null
}
}
}
}- Một chuỗi sẽ đặt biến.
nullsẽ xóa biến. Biến không được khai báo sẽ được kế thừa. ${env:NAME}đọc các biến môi trường mà trình soạn thảo nhận được. Nó không đọc khóa khác trong cùng đối tượng.- Tham chiếu bị thiếu khiến mục đó không dùng được. Tham chiếu chỉ được mở rộng một lần trong giá trị
env, không mở rộng trongargs. - Giá trị ghi trực tiếp vẫn được lưu trong facade.json. Tham chiếu môi trường giúp giá trị đó không nằm trong tệp, nhưng CLI vẫn nhận giá trị đã mở rộng.
Đặt biến trong một terminal tích hợp đang mở sẽ không cập nhật môi trường của trình soạn thảo. Hãy đặt biến trước khi khởi chạy trình soạn thảo.
Thứ tự ưu tiên và tùy chọn khởi chạy
Facade ưu tiên mô hình và effort được chỉ định cho agent mới, sau đó mới đến mặc định của mục. Với mỗi trường, nếu cả hai nguồn này đều không cung cấp giá trị, CLI sẽ quyết định. OpenCode giữ cả hai lựa chọn trong cấu hình riêng của nó.
Với các loại tích hợp sẵn, hãy dùng các trường riêng cho mô hình và effort. Facade cũng đặt quyền, ID cuộc trò chuyện, thư mục làm việc và công cụ của chính nó. Nó từ chối những đối số xung đột với các lựa chọn này hoặc khiến phiên tương tác không khởi chạy được.
Facade tìm facade.json trong Facade home: cài đặt Facade: Home của VS Code nếu có, sau đó FACADE_HOME, rồi ~/.facade. Hãy dùng Open Settings từ dự án để tìm tệp đang có hiệu lực.
Lỗi tệp và lỗi mục
Lỗi ở cấp tệp, như JSON không hợp lệ, khóa trùng hoặc trường cấp cao nhất không xác định, sẽ chặn việc khởi chạy mới và khôi phục. Lỗi bên trong một mục CLI chỉ khiến mục đó không dùng được. Các agent đang chạy vẫn tiếp tục chạy.
Hãy làm theo đường dẫn cài đặt trong thông báo lỗi và sửa giá trị đó. Facade không tự động thay bằng cài đặt cũ. Xem Khắc phục sự cố để biết các lỗi khởi chạy và lỗi nhà cung cấp thường gặp.