Cài đặt và đăng nhập RexAPF CLI

RexAPF CLI là tác tử lập trình chạy trong terminal, gọi bằng lệnh rexapf. Bài này hướng dẫn cài gói npm, đăng nhập tài khoản RexAPF và kiểm tra rằng máy đã sẵn sàng.

#Yêu cầu

• Node.js 22.19 trở lên trong nhánh 22, hoặc 24 trở lên. Gói khai báo engines là ^22.19 || >=24.
• Hệ điều hành: macOS hoặc Linux.
• Một tài khoản RexAPF. Nếu chưa có, xem Tài khoản & thanh toán.

Kiểm tra phiên bản Node trước khi cài:

$ node --version

#Cài đặt và đăng nhập

1. Cài gói npm

   Cài toàn cục để có lệnh rexapf trong PATH:

   bashSao chép

   $ npm install -g @rexllm/rexapf

   Kiểm tra lại bằng rexapf --version (hoặc rexapf -V). Lệnh in số phiên bản của gói đã cài.

2. Đăng nhập qua trình duyệt

   bashSao chép

   $ rexapf login

   CLI mở trình duyệt hệ thống tới trang đăng nhập RexAPF và in kèm đường dẫn ra terminal, phòng khi trình duyệt không tự mở.

3. Xác nhận trên trình duyệt

   Đăng nhập tài khoản và cho phép thiết bị. Khi xong, terminal in Đã đăng nhập RexAPF với … và lệnh kết thúc.

4. Kiểm tra tài khoản

   bashSao chép

   $ rexapf whoami

   Lệnh in tên tài khoản, email và số dư.

$ rexapf login
Mở trình duyệt để đăng nhập RexAPF. Nếu trình duyệt không tự mở, hãy truy cập:
  https://rexapf.com/native/authorize?...
Nếu trình duyệt ở máy khác: sau xác thực, sao chép toàn bộ URL http://127.0.0.1 đang báo lỗi và dán vào đây rồi Enter. Không chia sẻ URL này.
Đã đăng nhập RexAPF với ban@example.com.

$ rexapf whoami
Tài khoản: Nguyễn Văn A
Email: ban@example.com
Số dư: ...

#Đăng nhập khi trình duyệt ở máy khác

Khi bạn chạy rexapf login qua SSH (ví dụ trên VPS), CLI không tự mở trình duyệt. Làm như sau:

1. Sao chép đường dẫn CLI in ra và mở trên máy của bạn.
2. Đăng nhập và cho phép thiết bị. Trình duyệt sẽ chuyển tới một địa chỉ http://127.0.0.1:<cổng>/oauth/callback?... và báo lỗi không kết nối được. Đây là điều bình thường.
3. Sao chép toàn bộ địa chỉ đó trên thanh địa chỉ, dán vào terminal đang chờ rồi nhấn Enter.

CLI chỉ nhận địa chỉ khớp với cổng của lần đăng nhập hiện tại. Bạn không cần mở cổng công khai hay tạo SSH tunnel. Hướng dẫn đầy đủ cho máy chủ có ở Chạy trên VPS.

Lệnh rexapf login chờ tối đa 10 phút. Hết thời gian, CLI báo hết thời gian chờ đăng nhập và thoát với mã 1; bạn chạy lại lệnh là được.

#Xem tài khoản và đăng xuất

Khi chưa đăng nhập, mọi tác vụ và giao diện tương tác đều dừng với thông báo Chưa đăng nhập RexAPF. Chạy: rexapf login.

#Dùng chung với RexAPF Desktop

Thông tin đăng nhập được lưu trong ~/.dsh/.credentials.yaml, cùng tệp mà RexAPF Desktop dùng. Vì vậy đăng nhập ở CLI hay Desktop đều đăng nhập cho cả hai trên cùng máy, và đăng xuất ở một nơi cũng đăng xuất nơi còn lại. Chi tiết về tệp này ở Tệp cấu hình & thông tin đăng nhập.

#Khi gặp lỗi

• rexapf: đăng nhập thất bại: không kết nối được tới RexLLM: kiểm tra mạng hoặc proxy, rồi thử lại.
• rexapf: không ghi được thông tin đăng nhập vào máy: kiểm tra quyền ghi thư mục ~/.dsh.
• rexapf: URL không thuộc lần đăng nhập này.: bạn dán URL của một lần đăng nhập khác. Dán đúng URL vừa hiện sau khi xác thực.
• rexapf: không khởi động được (…): lỗi khởi động; thông báo kèm thư mục dữ liệu và phiên bản. Xem thêm Khắc phục sự cố.