Xử lý lỗi

Các lỗi thường gặp khi cài đặt và sử dụng BA-kit.

Lỗi cài đặt

"Chưa cài GitHub CLI (gh)"

BA-kit cần GitHub CLI để tải content từ private repo.

# macOS
brew install gh

# Linux (Ubuntu/Debian)
sudo apt install gh

# Windows
winget install GitHub.CLI

"Chưa đăng nhập GitHub"

gh auth login
# Chọn: GitHub.com → HTTPS → Login with a web browser

"Chưa có quyền truy cập BA-kit"

Bạn chưa được cấp quyền vào repo BA-kit. Nguyên nhân:

1. Chưa mua — vào https://buy.polar.sh/polar_cl_7LR0ExZK2PPRyWyWfaia83ZxMDNuOymu4MvfQ0lAjAb để mua
2. Chưa connect GitHub — sau khi mua, mở email xác nhận → click "Access Purchase" → connect GitHub account
3. Chưa accept invite — kiểm tra email (cả spam) tìm "invited you to bakit-org/bakit", click Accept
4. Sai GitHub account — gh auth login phải dùng đúng account đã mua

"Không thể tải BA-kit"

# Kiểm tra kết nối mạng
gh api repos/bakit-org/bakit --jq '.private'

# Nếu trả về lỗi, thử:
gh auth login  # đăng nhập lại
ba-kit install # thử lại

"npm: command not found"

Cần cài Node.js (đã bao gồm npm):

• Tải từ nodejs.org (chọn LTS)
• Hoặc brew install node trên macOS

"Permission denied" khi npm install -g

# Cách 1: Dùng npx (không cần cài global)
npx @bakit-org/cli doctor

# Cách 2: Sửa quyền npm global
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @bakit-org/cli

Lỗi khi cập nhật

"BA-kit chưa được cài đặt"

Chạy ba-kit install trước khi ba-kit update.

"Không thể kiểm tra phiên bản mới"

gh auth status  # kiểm tra đăng nhập
ba-kit doctor    # kiểm tra toàn bộ (tất cả runtime đã cài)

Lỗi sau khi refund

"ba-kit update báo không có quyền"

Nếu bạn đã được hoàn tiền, quyền truy cập repo BA-kit đã bị thu hồi. Bạn không thể cập nhật được nữa. File đã cài trên máy vẫn dùng được nhưng không nhận được bản cập nhật mới.

Vẫn không giải quyết được?

Liên hệ hỗ trợ qua email hoặc tạo issue trên GitHub.