Khắc phục sự cố
Hướng dẫn này bao gồm các sự cố thường gặp khi sử dụng Neotask và cách giải quyết chúng.
Giấy phép & Kích hoạt
"Khóa giấy phép không hợp lệ"
- Xác minh định dạng khóa:
SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX - Kiểm tra khoảng trắng thừa hoặc ký tự bị thiếu
- Đảm bảo bạn có kết nối internet đang hoạt động
- Thử nhập lại khóa một cách cẩn thận
"Giấy phép bị thu hồi"
- Giấy phép của bạn đã bị thu hồi bởi máy chủ
- Kiểm tra trạng thái thanh toán tại neotask.ai
- Liên hệ hỗ trợ nếu bạn tin đây là lỗi
"Giấy phép hết hạn"
- Đăng ký của bạn đã hết hạn
- Gia hạn gói qua cổng thanh toán
- Ứng dụng vào chế độ chỉ đọc khi hết hạn
"Thời gian ân hạn ngoại tuyến hết hạn"
- Bạn đã ngoại tuyến hơn 72 giờ
- Kết nối internet để xác thực lại tự động
- Ứng dụng sẽ tiếp tục hoạt động bình thường sau khi kết nối
"Phiên bản bị chặn"
- Phiên bản ứng dụng của bạn đã bị chặn vì lý do bảo mật
- Cập nhật lên phiên bản mới nhất ngay lập tức
- Cập nhật tự động sẽ nhắc bạn; nếu không, hãy tải xuống từ trang web
Sự cố cổng kết nối
"Cổng kết nối không khởi động được"
- Kiểm tra xem cổng 18789 có sẵn không (không được sử dụng bởi ứng dụng khác)
- Thử khởi động lại ứng dụng
- Kiểm tra sức khỏe cổng kết nối từ bảng điều khiển
- Nếu trên macOS, đảm bảo ứng dụng có các quyền cần thiết trong Tùy chọn hệ thống → Quyền riêng tư & Bảo mật
"Khóa 3 lần thất bại"
- Sau 3 lỗi cổng kết nối liên tiếp, các hoạt động bị chặn
- Khởi động lại ứng dụng để đặt lại bộ đếm khóa
- Nếu vẫn tiếp tục, kiểm tra nhật ký để tìm lỗi cơ bản
"Cổng kết nối bị ngắt kết nối"
- Thời gian chạy cục bộ mất kết nối
- Nhấp vào "Kết nối lại" trong bảng cổng kết nối
- Nếu tiếp tục ngắt kết nối, khởi động lại ứng dụng
- Kiểm tra xem không có tường lửa nào đang chặn kết nối localhost
Sự cố giọng nói
"Không phát hiện được đầu vào âm thanh"
- Cấp quyền microphone:
- macOS: Tùy chọn hệ thống → Quyền riêng tư & Bảo mật → Microphone → Bật cho Neotask
- Windows: Cài đặt → Quyền riêng tư → Microphone → Cho phép ứng dụng truy cập
- Kiểm tra xem microphone của bạn không bị tắt tiếng
- Xác minh thiết bị đầu vào chính xác được chọn trong cài đặt hệ thống
"Từ đánh thức không kích hoạt"
- Đảm bảo kích hoạt giọng nói được bật trong Cài đặt
- Kiểm tra xem chế độ đánh thức được đặt thành "Porcupine" (không phải "Shortcut" hoặc "Off")
- Nói rõ cụm từ đánh thức: "Hey Neotask"
- Thử phím tắt bàn phím thay thế (Cmd+Shift+Space / Ctrl+Shift+Space)
- Kiểm tra xem ứng dụng khác có đang sử dụng microphone không
"Âm thanh TTS bị gián đoạn hoặc chậm trễ"
- Kiểm tra kết nối internet của bạn (TTS yêu cầu API ElevenLabs)
- ElevenLabs có thể đang gặp giới hạn tốc độ
- Thử giọng nói khác từ Cài đặt
- Giảm hoạt động mạng nền
"Phím tắt giọng nói không hoạt động"
- Ứng dụng khác có thể đã chiếm cùng phím tắt
- Thay đổi phím tắt trong Cài đặt → Kích hoạt → Phím tắt bàn phím
- Trên macOS, kiểm tra Tùy chọn hệ thống → Bàn phím → Phím tắt để tìm xung đột
Kết nối & Mạng
"Không thể kết nối đến máy chủ"
- Xác minh kết nối internet của bạn
- Kiểm tra xem neotask.ai có thể truy cập trong trình duyệt không
- Nếu sau tường lửa doanh nghiệp, đảm bảo lưu lượng HTTPS được phép
- Thử tắt VPN tạm thời
"Yêu cầu API thất bại"
- Kiểm tra kết nối internet của bạn
- Xác minh giấy phép của bạn đang hoạt động
- Nếu sử dụng BYOK, kiểm tra xem khóa API của bạn có hợp lệ và có tín dụng không
- Thử làm mới bảng điều khiển
Tác nhân & Phiên
"Không thể tạo tác nhân: đã đạt giới hạn"
- Số lượng tác nhân không bị giới hạn theo gói; tạo tác nhân tùy chỉnh yêu cầu gói trả phí
- Nếu bạn thấy lỗi này trên gói Miễn phí, hãy nâng cấp lên gói trả phí để tạo tác nhân tùy chỉnh
- Xóa các tác nhân không dùng để giữ không gian làm việc gọn gàng
"Tác nhân không phản hồi"
- Kiểm tra sức khỏe cổng kết nối (phải đang chạy)
- Xác minh mô hình của tác nhân có thể truy cập (khóa API hợp lệ, nhà cung cấp có sẵn)
- Kiểm tra ngân sách hàng ngày, nếu vượt quá, các tác nhân bị tạm dừng cho đến nửa đêm UTC
- Thử đặt lại phiên
"Tin nhắn phiên không tải được"
- Làm mới trang/ứng dụng
- Kiểm tra trạng thái kết nối cổng kết nối
- Nếu phiên rất dài, hãy thử tạo phiên mới
Thanh toán & Thanh toán
"Thanh toán thất bại"
- Xác minh chi tiết thẻ của bạn là chính xác
- Kiểm tra với ngân hàng của bạn để biết bất kỳ khối nào đối với giao dịch quốc tế
- Thử phương thức thanh toán khác
- Liên hệ hỗ trợ nếu sự cố vẫn tiếp tục
"Vượt quá phân bổ sử dụng"
- Tiêu thụ token của tác nhân đã vượt quá phân bổ được bao gồm trong đăng ký của bạn
- Sử dụng thêm được tính theo mức phí sử dụng. Kiểm tra trang Sử dụng trong bảng điều khiển để biết chi tiết.
- Chuyển sang chế độ BYOK (sử dụng khóa API của riêng bạn) để định tuyến chi phí token trực tiếp đến nhà cung cấp của bạn
- Đặt giới hạn ngân sách hàng ngày để ngăn vượt mức không mong muốn
"Gói không cập nhật sau thanh toán"
- Webhook Stripe có thể có độ trễ nhỏ (thường dưới 1 phút)
- Làm mới bảng điều khiển
- Nếu vẫn chưa cập nhật sau 5 phút, hãy liên hệ hỗ trợ với xác nhận thanh toán của bạn
Hiệu suất
"Ứng dụng chậm khi khởi động"
- Xác thực giấy phép và khởi động cổng kết nối xảy ra khi khởi chạy, đây là bình thường
- Đảm bảo hệ thống của bạn đáp ứng yêu cầu tối thiểu
- Đóng các ứng dụng nền không cần thiết
"Sử dụng CPU cao"
- Nếu sử dụng từ đánh thức luôn bật (Porcupine), nó sử dụng CPU tối thiểu nhưng có thể tắt
- Tạm dừng các phiên giọng nói khi không sử dụng
- Kiểm tra các tiến trình cổng kết nối bị kẹt trong Activity Monitor / Task Manager
"Sử dụng bộ nhớ cao"
- Các phiên chat dài tích lũy bộ nhớ
- Tạo phiên mới định kỳ
- Khởi động lại ứng dụng để xóa trạng thái tích lũy
Nhận trợ giúp
- Tài liệu: Bạn đang ở đây, duyệt cơ sở kiến thức
- Hỗ trợ: Truy cập trang Hỗ trợ tại neotask.ai/support
- Liên hệ: Sử dụng biểu mẫu liên hệ trên trang web
- Trạng thái: Kiểm tra trạng thái dịch vụ tại neotask.ai