Chuyển đến nội dung chính

​
Chạy nagare doctor

Bước đầu tiên luôn là:
Kết quả liệt kê từng mục kiểm tra kèm chi tiết. Xem ý nghĩa các mục tại Tham chiếu CLI.

​
Lỗi thường gặp

Thư mục $HOME/.local/bin chưa có trong PATH. Xem Thêm vào PATH.
Gateway chưa chạy. Mở một terminal và chạy nagare gateway start, giữ terminal đó mở.
Gateway không chạy hoặc đang dùng cổng khác. Kiểm tra biến NAGARE_GATEWAY_PORT và đảm bảo cổng 9832 không bị chương trình khác chiếm.
Nagare không truy cập được keyring của hệ điều hành. Trên Linux, cần có dịch vụ Secret Service (ví dụ GNOME Keyring hoặc KWallet) đang chạy và đã mở khóa.
Module bộ nhớ chưa được cài. Chạy lại script cài đặt.
Token đã hết hạn (60 giờ) hoặc khóa trong keyring đã đổi. Chạy nagare web để đăng nhập lại, hoặc tạo token mới bằng nagare auth token rồi dán vào trang đăng nhập.
  • Kiểm tra đã thêm nhà cung cấp mô hình và chọn Default model trong Settings → General.
  • Kiểm tra API key và Base URL. Dùng chức năng lấy danh sách mô hình để thử kết nối.
  • Xem log gateway tại ~/.nagare/logs/app.log.
Công cụ cần phê duyệt nhưng không có kênh nào nhận yêu cầu. Hãy mở cuộc trò chuyện trong giao diện web hoặc dùng Telegram để có thể phê duyệt.
  • Xem log tại ~/.nagare/logs/plugins/<package_name>.log.
  • Kiểm tra các biến môi trường plugin cần (ví dụ NAGARE_TELEGRAM_TOKEN) đã được đặt trước khi khởi động gateway.
  • Checksum tệp thực thi không khớp: cài lại gói plugin.
Gói đã bị sửa đổi sau khi ký, hoặc được ký bằng khóa khác với khóa trong ~/.nagare/trusted. Xem Ký số plugin.

​
Log

​
Báo lỗi

Mở issue tại github.com/smtdfc/nagare/issues, kèm kết quả nagare doctor và đoạn log liên quan.