Triệu chứng: Click vào tool không có gì xảy ra, hoặc Windows Defender / Avast / Kaspersky báo virus và xoá file.

Khắc phục:

1. Mở Windows Security → Virus & threat protection → Manage settings → tắt tạm Real-time protection
2. Cài lại tool. Vào Exclusions → thêm folder cài tool vào whitelist
3. Bật lại Real-time protection
4. Avast/Kaspersky: cũng add folder tool vào exception list

💡 Tool an toàn 100% — bị flag là false positive do tool tự động hoá trình duyệt.

Triệu chứng: Vào tool, ấn tạo video → báo "chưa đăng nhập" hoặc Chrome mở trang login Google.

Khắc phục:

1. Vào tab Cài đặt → bấm Auto Login VEO hoặc Auto Login GROK
2. Cửa sổ Chrome mở ra → đăng nhập Google bằng tay
3. Sau khi vào dashboard thành công → đóng cửa sổ → tool tự lưu cookie
4. Có 2FA: tạm tắt khi setup, bật lại sau
5. Báo "Profile in use": đóng hết Chrome đang mở rồi thử lại

Triệu chứng: Tool dừng ở màn hình captcha hoặc báo Captcha solver timeout.

Khắc phục:

1. Spai Captcha Extension đã cài và enable trong chrome://extensions?
2. Tab Captcha Bridge → bấm Start Bridge — phải thấy đèn xanh "Running on :60526"
3. Báo port bận: tắt mọi instance tool, restart máy
4. Firewall: cho phép spai-bridge.exe qua firewall (Public + Private)
5. Vẫn fail: copy lại token bridge trong tab Cài đặt và paste vào extension

Triệu chứng: Đã ấn Bắt đầu, log "Submitted" nhưng không có file video, hoặc Generation failed.

Khắc phục:

1. Rate limit: Giảm Multi Video xuống 5–10
2. Content bị từ chối: prompt dính 18+/bạo lực/người nổi tiếng/trẻ em → đổi cách viết
3. Hết quota: Vào labs.google/fx hoặc grok.com check usage
4. Tài khoản trial hết: Cần upgrade lên gói trả phí
5. Retry job lỗi: Status panel bên phải → chuột phải vào job → Retry

Triệu chứng: Báo Cannot connect to localhost:60526 hoặc Bridge offline.

Khắc phục:

1. Tab Captcha Bridge → bấm Restart
2. Task Manager → kill mọi process spai-bridge.exe đang treo → bấm Start lại
3. Firewall: Allow an app → tìm spai-bridge.exe → tick Private + Public
4. Restart máy
5. Vẫn fail: gỡ tool, cài lại bản mới nhất

Triệu chứng: Profile is being used by another instance.

Khắc phục:

1. Đóng tất cả cửa sổ Chrome (kể cả Chrome cá nhân)
2. Task Manager → kill hết process chrome.exe
3. Vào folder profile của tool → xoá file SingletonLock + SingletonCookie
4. Khởi động lại tool
5. Vẫn lỗi: trong tool tạo profile mới, đăng nhập lại

💡 Tool có multi-profile. Tạo profile riêng cho tool, đừng dùng chung profile Chrome cá nhân.

Triệu chứng: Prompt có @hero nhưng video không có nhân vật đó.

Khắc phục:

1. Tên ảnh trong tool phải khớp 100% với tag — kể cả viết hoa/thường
2. Tránh dấu tiếng Việt / khoảng trắng — dùng underscore: @nu_chinh
3. Tab Tham chiếu → kiểm tra tên ảnh có đúng tag không
4. Refresh tool nếu vừa thêm ảnh mới

💡 Dùng Tiện ích Đồng bộ Prompt để tự động tạo @tag chuẩn.

Triệu chứng: Mỗi prompt mất 5–10 phút, hoặc tool đứng im.

Khắc phục:

1. Check tốc độ mạng: ping < 100ms, download > 20Mbps
2. Giảm Multi Video: máy yếu 5–10, máy mạnh 20–50
3. Đóng app nặng (game, Adobe, Premiere) để giải phóng RAM
4. Tắt Chrome cá nhân khi tool đang chạy
5. Restart tool sau mỗi 200 video để giải phóng memory

💡 Cấu hình tối thiểu: i5 + 8GB RAM. Tốt nhất: i9 + 32GB + GPU rời.

Triệu chứng: Đổi máy / cài lại Windows → tool báo License is bound to another device.

Khắc phục:

1. 1 key chỉ dùng được trên 1 máy (gắn theo HWID)
2. Inbox Zalo 0976.264.224 kèm: email mua key + lý do đổi máy
3. Admin reset HWID trong 5–15 phút (giờ HC), max 2h (ngoài giờ)
4. Reset miễn phí 1 lần/tháng cho gói tháng. Gói dài hạn linh hoạt hơn

Triệu chứng: Đóng tool xong mở lại mất hết prompt, ảnh tham chiếu.

Khắc phục:

1. Tool tự lưu data vào data_general/Workflows/<tên_project>/
2. Trước khi đóng tool, bấm Save (Ctrl+S) cho chắc
3. Mất data: vào folder data_general/Workflows/ → mở file .json để khôi phục
4. Backup: copy folder data_general/ ra ổ khác hàng tuần
5. Cài lại tool: không xoá folder data_general/

⚠ Uninstaller GIỮ folder data. Chỉ xoá tay folder cài thì data mới mất.

Triệu chứng: Chọn folder, ấn Bắt đầu nhưng video output vẫn còn logo.

Khắc phục:

1. Đảm bảo FFmpeg có trong PATH
2. Đánh lại vùng logo: bao trọn watermark, có buffer 5–10px mỗi phía
3. Toàn bộ video VEO trong folder phải có cùng vị trí logo — khác phải tách folder
4. Folder output có quyền ghi (không phải C:\Program Files)
5. Output bị đen vùng logo: vùng đánh quá lớn, thu nhỏ lại

Triệu chứng: Click Update → báo lỗi hoặc treo.

Khắc phục:

1. Đóng tool hoàn toàn
2. Inbox Zalo / Telegram admin xin link tải bản mới nhất
3. Cài đè lên bản cũ — không cần uninstall trước (data giữ nguyên)
4. Sau update bị bug: rollback bằng bản cũ admin gửi