Khắc phục sự cố
Chẩn đoán và sửa các sự cố phổ biến không cần hỗ trợ.
Mạng / hết thời gian kết nối
- •Tường lửa chặn HTTPS đến api.whisperx.ai
- •Vấn đề định tuyến VPN
- •Cấu hình DNS sai
Kiểm tra kết nối từng bước:
# 1. DNS resolution nslookup api.whisperx.ai # 2. TCP port 443 nc -zv api.whisperx.ai 443 # 3. HTTPS GET curl -v --max-time 5 "https://api.whisperx.ai/api/tags/trending"
Bước 1 thất bại: kiểm tra DNS. Bước 2 thất bại: tường lửa chặn cổng 443 — liên hệ quản trị mạng. Bước 3 thất bại: vấn đề TLS — cập nhật chứng chỉ gốc của hệ thống.
Kết quả trống
- •Truy vấn quá cụ thể hoặc quá hẹp
- •Bộ lọc thẻ quá hạn chế
- •Ngày since quá gần đây
- •Bộ lọc lĩnh vực loại trừ tình báo phù hợp
Thử truy vấn ngày càng rộng hơn:
# Remove tag filter curl "https://api.whisperx.ai/api/intel?q=OpenAI&limit=10" # Remove sector filter curl "https://api.whisperx.ai/api/intel?q=layoff&limit=10" # Extend time window (no since filter) curl "https://api.whisperx.ai/api/intel?q=funding&limit=10" # Try trending tags to see what's active curl "https://api.whisperx.ai/api/tags/trending?limit=20"
Kết quả trống không phải lỗi — nghĩa là hiện không có tình báo nào khớp bộ lọc. Nền tảng phát triển mỗi ngày; thử lại ngày mai hoặc mở rộng tìm kiếm.
429 — Giới hạn tốc độ
- •Hơn 60 lần gọi API mỗi phút từ cùng một IP
- •Vòng lặp tự động không có độ trễ giữa các yêu cầu
- •Nhiều agent dùng chung một kết nối
Giảm tốc và giảm tần suất:
- • Chờ 60 giây trước khi thử lại
- • Thêm sleep 2 giữa các yêu cầu trong script
- • Giảm tham số limit (thử 5–10 thay vì 50)
- • Cache các thẻ trending — chúng thay đổi chậm, không cần poll mỗi phút
Nếu cần giới hạn tốc độ cao hơn cho sản xuất, liên hệ chúng tôi.
5xx — Lỗi máy chủ
- •Lỗi upstream tạm thời
- •Worker khởi động lạnh khi tải cao
- •Cơ sở dữ liệu tạm thời không khả dụng
Chiến lược thử lại:
# Retry once after 10 seconds sleep 10 && curl "https://api.whisperx.ai/api/intel?q=test&limit=1" # If 5xx persists, fall back to trending tags (lighter endpoint) curl "https://api.whisperx.ai/api/tags/trending?limit=10"
Nếu lỗi kéo dài hơn 5 phút, kiểm tra whisperx.ai để cập nhật trạng thái. Hầu hết sự cố được giải quyết trong vài phút.
Phản hồi chậm / hết thời gian
- •Tìm kiếm ngữ nghĩa được bật (quét toàn bảng — rất tốn kém)
- •limit đặt quá cao (>50)
- •Độ trễ mạng đến Cloudflare edge
Đảm bảo tắt tìm kiếm ngữ nghĩa và giảm limit:
# Good: keyword search, compact mode, small limit curl "https://api.whisperx.ai/api/intel?q=OpenAI&mode=compact&limit=10" # Bad: semantic search (avoid — full-table scan) # /api/intel?semantic=... ← do NOT use this
WhisperX Skill tự động tắt tìm kiếm ngữ nghĩa. Nếu gọi API trực tiếp, đừng bao giờ dùng tham số semantic trong sản xuất.
Không tìm thấy Skill / công cụ không tải được
- •Skill cài đặt vào thư mục sai
- •SKILL.md bị thiếu hoặc trống
- •Shell script không có quyền thực thi
- •Biến môi trường WHISPERX_BASE_URL cài đặt sai
Xác minh cài đặt của bạn:
# Check skill files exist ls ~/.claude/skills/whisperx/ # Expected: SKILL.md tools/ ls ~/.claude/skills/whisperx/tools/ # Expected: search.sh get.sh trending.sh trends.sh connections.sh export.sh # Check scripts are executable ls -la ~/.claude/skills/whisperx/tools/*.sh # Should show -rwxr-xr-x permissions # Fix permissions if needed chmod +x ~/.claude/skills/whisperx/tools/*.sh # Quick smoke test bash ~/.claude/skills/whisperx/tools/trending.sh 5
Vẫn không hoạt động? Chạy lại cài đặt từ Hướng dẫn bắt đầu nhanh.
Tạo báo cáo chẩn đoán
Nếu vẫn bí, chạy lệnh này để tạo gói chẩn đoán có thể chia sẻ (không có dữ liệu nhạy cảm):
echo "=== WhisperX Diagnostic ===" && \
echo "Date: $(date -u)" && \
echo "OS: $(uname -a)" && \
echo " && \
echo "--- Connectivity ---" && \
curl -s -o /dev/null -w "HTTP %{http_code} | Time %{time_total}s" \
"https://api.whisperx.ai/api/tags/trending?limit=1" && \
echo " && \
echo "--- Skill files ---" && \
ls -la ~/.claude/skills/whisperx/tools/ 2>/dev/null || echo "Skill not installed"Dán kết quả khi yêu cầu hỗ trợ. Không bao gồm IP, truy vấn hoặc khóa của bạn.