Phiên bản
Ngôn ngữ
Người đóng góp Sửa (28/05/2026)
Avatar

Cài Đặt Chi Tiết

Hướng dẫn từng bước cài đặt Antigravity SEO Kit, bao gồm cài Antigravity, tạo project, và kích hoạt SEO Kit.

Bước 1: Cài Đặt Google Antigravity

Antigravity là nền tảng AI agent của Google DeepMind. SEO Kit chạy bên trong Antigravity.

  1. Truy cập antigravity.google/download
  2. Tải và cài đặt Antigravity cho hệ điều hành của bạn (Windows, macOS, Linux)
  3. Đăng nhập bằng tài khoản Google

Bước 2: Tạo Project Mới Trong Antigravity

Sau khi cài đặt Antigravity, bạn cần tạo một project (dự án) để chứa SEO Kit:

  1. Mở Antigravity
  2. Nhấn "Open Folder" (Nên tạo thư mục trống và mở thư mục đó)

📁 Ghi nhớ: Đây là thư mục gốc mà SEO Kit sẽ tạo file seo-projects/ bên trong.

Bước 3: Mở Terminal Trong Antigravity

Antigravity có terminal tích hợp để chạy lệnh:

  1. Trong giao diện Antigravity, tìm phần Terminal (thường ở phía dưới)
  2. Hoặc sử dụng phím tắt (thường là Ctrl+` hoặc Cmd+J trên macOS)
  3. Terminal sẽ mở ra với đường dẫn đến thư mục project của bạn

Bước 4: Cài Đặt SEO Kit (Hai phương pháp)

Kể từ phiên bản v2.0.0, bạn có hai lựa chọn để cài đặt SEO Kit:

Phương pháp 1: Cài đặt dạng Global Antigravity Plugin (Khuyên dùng)

Phương pháp này giúp cài đặt SEO Kit toàn cục một lần duy nhất vào hệ thống Antigravity, sau đó chia sẻ tài nguyên cho tất cả các workspace mà không bị nhân bản thừa dữ liệu.

  1. Cài đặt Plugin toàn cục: Mở terminal trong Antigravity và chạy lệnh: 

    npx antigravity-seo-kit install-plugin --key=SK-XXXX-XXXX-XXXX

    Quá trình này sẽ tải SEO Kit về thư mục plugin toàn cầu của hệ thống (~/.gemini/config/plugins/antigravity-seo-kit), giải nén và đăng ký với hệ thống Antigravity.

  2. Kích hoạt Workspace hiện tại: Di chuyển vào thư mục dự án của bạn và chạy lệnh setup cục bộ: 

    npx antigravity-seo-kit setup-workspace

    Cơ chế thông minh của SEO Kit sẽ tự động sao chép các tệp cấu hình (config/), kịch bản chạy (scripts/) và workflows thiết yếu cục bộ vào .agent/. Đồng thời, các tài liệu hướng dẫn (skills/*.md và agents/) sẽ được giữ lại toàn cục để tránh làm phình to thư mục dự án và giảm tải cho bộ nhớ đệm AI (giảm tới 90% kích thước local).

Phương pháp 2: Cài đặt trực tiếp vào Workspace (Cục bộ)

Nếu bạn chỉ muốn thử nghiệm trên một dự án đơn nhất mà không ảnh hưởng đến hệ thống: 

npx antigravity-seo-kit install --key=SK-XXXX-XXXX-XXXX

Thay SK-XXXX-XXXX-XXXX bằng license key bạn đã mua tại antigravityseokit.solann.io.

Các tính năng cốt lõi đi kèm phiên bản v2.0.0

🛡️ Cơ chế mã hóa che giấu License Key

Khi bạn cài đặt thành công, license key của bạn sẽ được lưu giữ tại file .seo-kit-license ở dạng mã hóa XOR bảo mật dựa trên Salt lấy từ tên thiết bị (os.hostname()) và hệ điều hành (os.platform()). Cơ chế này giúp ngăn chặn hoàn toàn việc sao chép bất hợp pháp hoặc vô tình rò rỉ key khi chia sẻ code qua các hệ thống git công cộng.

🔄 Cơ chế Smart Deep Merge bảo vệ cấu hình

Khi bạn nâng cấp dự án hoặc chạy lại lệnh setup-workspace, SEO Kit tích hợp sẵn thuật toán Smart Deep Merge JSON:

  • Tự động phát hiện và hợp nhất các trường cấu hình mới của phiên bản v2.0.0 từ bản cài đặt gốc.
  • Bảo toàn 100% các tùy biến cá nhân của bạn, chẳng hạn như API Keys (DataForSEO, Semrush...), trọng số tối ưu hóa hoặc thông tin xác thực Google Search Console đã cấu hình trước đó.
  • Nếu tệp tin cấu hình cục bộ bị lỗi cú pháp JSON do sửa tay, hệ thống sẽ tự động sao lưu sang <tên_file>.bak và đưa ra cảnh báo an toàn trên console thay vì ghi đè làm mất dữ liệu.

Bước 5: Xác nhận cài đặt:

npx antigravity-seo-kit status

Kết quả mẫu: 

SEO Kit Installation Status

  Version:      2.0.0
  License Key:  SK-****-****-XXXX
  Device ID:    abc123...
  Device Name:  DESKTOP-ABC
  Installed:    2026-04-15T09:00:00Z
  Plan:         pro

  Files:        156/156 present

Bước 5: Bắt Đầu Sử Dụng

Sau khi cài đặt thành công, bạn sử dụng SEO Kit bằng cách chat với AI agent trong Antigravity. Không cần mở terminal nữa — chỉ cần gõ lệnh vào khung chat: 

/seo-run yourdomain.com

SEO Kit sẽ tự phát hiện đây là dự án mới và hướng dẫn bạn từng bước.

💡 Xem tiếp: Dự án đầu tiên để được hướng dẫn chi tiết cách setup dự án SEO đầu tiên.

Cập Nhật

npx antigravity-seo-kit update

Xem chi tiết tại Cập nhật & Phiên bản.

Gỡ Cài Đặt

npx antigravity-seo-kit uninstall --confirm

⚠️ Lệnh này xóa toàn bộ SEO Kit files. Dữ liệu dự án trong seo-projects/ KHÔNG bị xóa.

Cài Đặt Python

Antigravity SEO Kit sử dụng Python để chạy các script phân tích (audit, scoring, crawler). Bạn cần cài Python trước hoặc sau khi cài SEO Kit:

Cách 1: Cài trực tiếp

Tải và cài đặt Python tại python.org/downloads (≥ 3.11).

✅ Khi cài, nhớ tick ☑ "Add Python to PATH" để terminal nhận diện được lệnh python.

Cách 2: Cài extension Python trong Antigravity

  1. Mở Antigravity
  2. Nhấn Ctrl + Shift + X để mở Extensions
  3. Tìm và cài Python (by Microsoft)

Extension sẽ tự tải Python nếu chưa có.

Extension Khuyên Dùng

Mở panel Extensions (Ctrl + Shift + X) trong Antigravity và cài các extension sau:

ExtensionMục đích
Python (Microsoft)Chạy script phân tích SEO
Markdown Preview EnhancedXem preview báo cáo markdown
AG Auto Click & ScrollTự động retry khi lỗi + tự động duyệt

Xử Lý Lỗi Khi Cài Đặt

Lỗi: "npx is not recognized"

npx : The term 'npx' is not recognized as the name of a cmdlet,
function, script file, or operable program.

Nguyên nhân: Chưa cài Node.js hoặc chưa thêm vào PATH.

Cách giải quyết:

  1. Tải và cài đặt Node.js tại nodejs.org (chọn bản LTS)
  2. Khi cài, giữ nguyên tùy chọn "Add to PATH"
  3. Đóng và mở lại Antigravity (hoặc terminal) để nhận PATH mới
  4. Chạy lại lệnh npx antigravity-seo-kit install --key=...

Lỗi: "Running scripts is disabled on this system"

npx : File C:\Program Files\nodejs\npx.ps1 cannot be loaded because
running scripts is disabled on this system.

Nguyên nhân: Windows PowerShell mặc định chặn chạy script bên ngoài.

Cách giải quyết (khuyên dùng):

  1. Đóng cửa sổ terminal/PowerShell hiện tại
  2. Mở Start Menu, gõ PowerShell
  3. Click chuột phải vào Windows PowerShell → chọn Run as Administrator
  4. Dán lệnh sau và nhấn Enter:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  1. Gõ Y (hoặc A) và nhấn Enter để xác nhận
  2. Đóng cửa sổ Admin, quay lại Antigravity và chạy lại lệnh cài đặt

💡 Việc này chỉ cần làm một lần duy nhất. Sau khi cấp quyền, tất cả lệnh npx, npm sẽ hoạt động bình thường.

Trong tài liệu này