Lỗi cài đặt

Dùng trang này khi trình cài đặt dừng, không tìm thấy ak, chạy nhầm binary hoặc kiểm tra sức khỏe đầu tiên thất bại.

Trình cài đặt dừng trước khi hoàn tất

Giữ endpoint protection và xác minh TLS hoạt động. Thử lại một lần bằng trình cài đặt đã xác minh từ host phát hành nếu domain chính bị lọc:

curl -fsSL https://releases.agentkit.best/install.sh | sh

Trên Windows:

irm https://releases.agentkit.best/install.ps1 | iex

Từ cmd.exe, gọi cùng trình cài đặt PowerShell một cách rõ ràng:

powershell -NoProfile -Command "irm https://releases.agentkit.best/install.ps1 | iex"

Host dự phòng dùng cùng chuỗi xác minh. Nếu proxy, phần mềm antivirus hoặc bộ lọc mạng tiếp tục từ chối release object, hãy dừng thử lại và nhờ quản trị viên kiểm tra block. Không thêm security exclusion hoặc tắt xác minh checksum.

Các nền tảng được hỗ trợ là macOS, Linux và Windows trên amd64 hoặc arm64. OS, kiến trúc, kênh hoặc phiên bản không được hỗ trợ làm trình cài đặt thoát lỗi trước khi cài binary. Các thiết lập của trình cài đặt như AK_CHANNEL, AK_VERSION và AK_INSTALL_DIR là biến môi trường, không phải flag; AK_CHANNEL mặc định là stable.

Shell không tìm thấy ak

Thư mục cài mặc định là ~/.local/bin trên macOS và Linux, và %USERPROFILE%\bin trên Windows. Mở terminal mới rồi kiểm tra cách lệnh được resolve:

command -v ak
ak --version

Trên Windows:

Get-Command ak -All
ak --version

Nếu binary tồn tại nhưng không có trên PATH, chỉ thêm thư mục cài của nó vào PATH người dùng. Không di chuyển hoặc xóa trạng thái AgentKit. Kết quả thành công là chỉ một binary dự kiến được resolve và ak --version in phiên bản.

Chạy nhầm phiên bản

Nhiều binary cũ trên PATH có thể che bản vừa cài. So sánh mọi đường dẫn từ Get-Command ak -All trên Windows hoặc công cụ tra lệnh của shell với thư mục mà trình cài đặt đã in. Đổi thứ tự PATH để binary dự kiến được resolve trước, sau đó mở terminal mới và chạy:

ak --version
ak doctor --check binary_version

Tên --check không tồn tại là lỗi lệnh và thoát 1; dùng ak doctor --list để xem các tên mà phiên bản đang cài hỗ trợ.

Binary chạy nhưng setup không khỏe

ak doctor --offline
ak doctor --json

Bắt đầu với --offline khi nghi ngờ mạng, rồi chạy kiểm tra đầy đủ. Nhớ rằng báo cáo doctor mặc định không khỏe vẫn thoát 0. Dùng status và hành động được đề xuất trong báo cáo, hoặc thêm --exit-on-fail khi cần mã thoát thất bại.

Khôi phục an toàn

Chạy lại cùng trình cài đặt đã xác minh là cách sửa binary tại chỗ được hỗ trợ. Giữ nguyên kênh trừ khi bạn chủ động muốn chuyển. Không xóa ~/.agentkit hoặc home của runtime; chúng chứa authentication, cấu hình, nội dung đã cài và dữ liệu khôi phục mà việc cài lại binary không cần thay thế.

Trang liên quan

• Cài đặt
• Cập nhật và khôi phục
• Lỗi cấu hình