Chuyển tới nội dung chính

Hướng dẫn di chuyển lên @aquaringlab/aidk

Do chúng tôi đã chuyển giao và đổi tên package từ @caeruxlab/aidk sang @aquaringlab/aidk (đồng thời chuyển registry từ GitLab sang GitHub Packages), tất cả người dùng hiện tại cần thực hiện các bước di chuyển dưới đây để tiếp tục sử dụng và cập nhật công cụ AIDK.

Các bước thực hiện di chuyển​

Bước 1: Gỡ bỏ phiên bản cũ @caeruxlab/aidk​

Chạy lệnh sau để gỡ bỏ phiên bản cũ đã cài đặt toàn cục trên máy tính của bạn:

npm uninstall -g @caeruxlab/aidk

Nếu trước đó bạn sử dụng npm link để phát triển, hãy gỡ liên kết:

npm unlink -g @caeruxlab/aidk

Bước 2: Tạo GitHub Personal Access Token (PAT) mới​

Vì @aquaringlab/aidk được phát hành trên GitHub Packages dưới dạng private package, bạn cần có một token xác thực có quyền đọc package:

  1. Truy cập github.com/settings/tokens → Generate new token (Classic).
  2. Đặt tên gợi nhớ (ví dụ: AIDK-Read-Token).
  3. Chọn scope read:packages.
  4. Nhấn Generate token và sao chép mã token hiển thị.

Bước 3: Cập nhật file .npmrc toàn cục​

Mở file cấu hình npm toàn cục (~/.npmrc) trên máy của bạn và:

  1. Xóa bỏ cấu hình cũ liên quan đến GitLab (nếu có): 
    # Xóa hai dòng này (nếu có)
    @caeruxlab:registry=https://git.caerux.com/api/v4/...
    //git.caerux.com/api/v4/...:_authToken=...
  2. Thêm cấu hình xác thực GitHub Packages mới, thay thế YOUR_GITHUB_PAT bằng token bạn vừa tạo ở Bước 2: 
    @aquaringlab:registry=https://npm.pkg.github.com
    //npm.pkg.github.com/:_authToken=YOUR_GITHUB_PAT

Bước 4: Cài đặt package mới @aquaringlab/aidk​

Sau khi đã lưu cấu hình .npmrc, chạy lệnh dưới đây để cài đặt phiên bản mới nhất của AIDK CLI:

npm install -g @aquaringlab/aidk

Bước 5: Kiểm tra cài đặt và sử dụng​

Xác nhận cài đặt thành công bằng cách kiểm tra phiên bản mới nhất:

aidk --version

Từ bây giờ, tất cả các dự án mới hoặc dự án hiện tại của bạn sẽ sử dụng công cụ CLI được quản lý thông qua GitHub Packages dưới scope @aquaringlab.