Facade CodeKhắc phục sự cố
Xác định xem sự cố đến từ cấu hình khởi chạy, từ CLI hay từ nhà cung cấp mô hình.
Kiểm tra lần khởi chạy được yêu cầu
Chạy Show Agent Launch từ Command Palette và chọn vị trí làm việc. Báo cáo cho biết mỗi CLI sẽ khởi chạy tại đó như thế nào với cài đặt hiện tại: tệp thực thi, thư mục, đối số và tên biến môi trường. Các giá trị riêng tư được ẩn đi.
Báo cáo mô tả lần khởi chạy tiếp theo với cài đặt hiện tại, không mô tả một agent đang chạy. Nếu yêu cầu thành công, bản ghi mức sử dụng của nhà cung cấp có thể giúp xác nhận tài khoản nào đã xử lý nó.
Tìm triệu chứng
| Vấn đề | Cần kiểm tra |
|---|---|
| Không tìm thấy tệp cài đặt | Chọn Open Settings, rồi Edit in facade.json trong Facade: Home. Nếu cửa sổ từ xa mở Settings dưới dạng JSON, lệnh sẽ mở thẳng facade.json. |
| Một mục không xuất hiện trong New Agent | Kiểm tra tên và type của mục, và bảo đảm mục không bị tắt bằng enabled: false. Mục không hợp lệ hiện trong mục Unavailable kèm lý do. |
| Không tìm thấy tệp thực thi | Cài CLI ở nơi dự án chạy, hoặc đặt đường dẫn đầy đủ trong command. Với OpenCode, hãy dùng phiên bản 2 (@opencode/cli). |
| Thiếu tham chiếu môi trường | Môi trường của trình soạn thảo phải có biến đó trước khi agent khởi chạy. Xuất biến trong một terminal đang mở không cập nhật môi trường này. |
| Đối số xung đột với tùy chọn do Facade quản lý | Xóa tùy chọn đó khỏi args. Thay vào đó, hãy dùng trường model hoặc effort trong mục CLI, hoặc trường yolo ở cấp cao nhất. |
| Xác thực thất bại hoặc mô hình không khả dụng | Kiểm tra khóa, endpoint, khu vực, ID mô hình và quyền truy cập tài khoản của nhà cung cấp. |
| Nhà cung cấp Codex không phản hồi | Xác nhận endpoint của nó hỗ trợ Responses API. |
| Một agent không tìm thấy agent khác | Kiểm tra các dự án có được kết nối qua cùng Facade home không và cài đặt quyền truy cập có cho phép liên lạc không. |
| Chương trình custom không nhận tin nhắn | Hãy nhập lệnh trong terminal của nó. Mục custom không nhận tin nhắn hay công cụ của Facade. |
| Cài đặt đã lưu chưa thay đổi agent đang chạy | Hãy khởi chạy agent mới. Để giữ cuộc trò chuyện, kết thúc agent rồi dùng Resume Agent để khởi động lại với cài đặt mới. |
Về thiết lập SSH, xem Chạy agent trên máy từ xa. Với lỗi kết nối từ điện thoại, xem Tiếp tục từ điện thoại.
Báo cáo sự cố
Hãy ghi rõ những gì bạn đã thử, thông báo lỗi chính xác, hệ điều hành, phiên bản trình soạn thảo và tiện ích, phiên bản CLI và mục bạn đã chọn. Nếu có thể, kèm phần cài đặt liên quan đã ẩn khóa và các giá trị riêng tư.