Khắc phục sự cố

Hầu hết sự cố của AI Translator thuộc bốn nhóm: quyền ghi âm, nguồn âm thanh, model và bản quyền. Tìm câu báo lỗi đúng chữ như app hiển thị trong các bảng dưới đây, làm theo cách xử lý, và nếu vẫn lỗi thì gửi log cho hỗ trợ.

Cập nhật 23/10/2026

Không có phụ đề hoặc không nghe thấy âm thanh

“Không nghe thấy gì dù có app đang phát tiếng: có thể AI Translator chưa được phép ghi âm thanh hệ thống.”

Nguyên nhân: macOS chưa cấp quyền và không báo lỗi: app chỉ nhận âm thanh im lặng.

Cách xử lý: Bấm Mở System Settings, bật AI Translator ở Privacy & Security › Screen & System Audio Recording › System Audio Recording Only, rồi Bắt đầu lại. Xem cấp quyền ghi âm. Trên Windows không có quyền này: nếu không nghe thấy gì, kiểm tra thiết bị phát đang chọn ở Cài đặt › Âm thanh.

“Không nghe thấy âm thanh. Kiểm tra âm thanh cuộc họp có đang phát không.” hoặc “Không thu được âm thanh.”

Nguyên nhân: Máy không phát tiếng, nguồn âm thanh sai, hoặc app không mở được nguồn.

Cách xử lý: Bật tiếng cuộc họp. Ở Cài đặt › Âm thanh, bấm Làm mới danh sách, chọn lại nguồn rồi Bắt đầu lại. Còn lỗi thì gửi log.

“App đã chọn không phát tiếng”

Nguyên nhân: Bạn chọn Chỉ {tên app} mà app đó đang im.

Cách xử lý: Cho app phát tiếng (phiên chạy tiếp ngay), hoặc chọn Toàn hệ thống, trừ app này (từ phiên sau).

Không thấy thanh phụ đề

Nguyên nhân: Thanh ẩn khi mở app cho tới khi bạn bấm Bắt đầu, hoặc đã bị ẩn bằng phím tắt hay nút ✕ (nút ✕ dừng cả phiên dịch).

Cách xử lý: Nếu đã bấm nút ✕, bấm Bắt đầu để dịch lại, thanh sẽ hiện. Còn lại, ở Màn hình chính, mục Thanh phụ đề, bấm Hiện; hoặc nhấn ⌃ + ⌥ + H (Windows: Ctrl + Alt + H); hoặc chọn “Hiện phụ đề” ở menu bar hay khay hệ thống. Thanh khóa thì mở khóa bằng ⌃ + ⌥ + L (Windows: Ctrl + Alt + L).

“Có phím tắt không đăng ký được. Mở Cài đặt › Phím tắt để đổi.”

Nguyên nhân: App khác đang giữ tổ hợp phím đó.

Cách xử lý: Ở Cài đặt › Phím tắt, bấm Đổi và nhấn tổ hợp mới, có ít nhất một phím Ctrl, Alt hoặc Cmd/Win (chỉ Shift thì chưa đủ).

Phụ đề chậm, thiếu hoặc dừng

“Đang trễ”; “Đang chạy bằng CPU (chậm hơn).”; “Máy không đủ bộ nhớ. Nên dùng gói Nhẹ.”

Nguyên nhân: Máy không theo kịp tốc độ nói, hoặc GPU lỗi nên app chuyển sang CPU.

Cách xử lý: Đóng bớt app nặng. Ở Cài đặt › Model, chọn gói model Nhẹ rồi bấm Dùng gói này (nếu chưa tải gói đó thì bấm Tải và dùng); gói mới được dùng từ phiên dịch sau.

“Dịch không khả dụng: chỉ hiện câu gốc”; “Phiên dịch đã dừng vì lỗi. Mở cửa sổ chính để xem chi tiết.”; “Phần nhận dạng giọng nói ngừng chạy…”

Nguyên nhân: Bộ dịch hoặc bộ nhận dạng lỗi. App tự khởi động lại chúng; quá 5 lần trong 10 phút thì dừng dịch.

Cách xử lý: Bấm Dừng rồi Bắt đầu. Nếu app báo thiếu hoặc hỏng một phần của app, hãy cài lại AI Translator. Lặp lại thì gửi log.

Model, cài đặt, macOS và Windows

“Không kết nối được máy chủ model. Kiểm tra kết nối mạng rồi thử lại.”

Nguyên nhân: Máy không có mạng, hoặc mạng chặn tải.

Cách xử lý: Kiểm tra mạng rồi bấm Thử lại.

“Tải chưa xong. Bấm Tiếp tục để tải tiếp từ chỗ đã dừng.” hoặc “Một file tải về bị hỏng…”

Nguyên nhân: Mạng rớt giữa chừng, hoặc file tải về không khớp mã kiểm tra.

Cách xử lý: Bấm Tiếp tục. Nếu app báo “Model bị hỏng. Hãy tải lại model.”, bấm Kiểm tra và tải lại ở Cài đặt › Model.

“Ổ đĩa không đủ chỗ cho gói này…” hoặc “Không ghi được file model xuống ổ đĩa.”

Nguyên nhân: Ổ đĩa cần trống bằng dung lượng tải cộng 1 GB (gói model Chuẩn khoảng 2,5 GB, gói model Nhẹ khoảng 1,3 GB).

Cách xử lý: Giải phóng ổ đĩa, hoặc chọn gói model Nhẹ.

“Máy này chưa đạt cấu hình tối thiểu nên không tải được model.”

Nguyên nhân: Máy dưới mức tối thiểu: Mac Apple Silicon có RAM 8 GB, hoặc máy Windows 10/11 x64 có RAM 8 GB và CPU hỗ trợ AVX2. App nói rõ lý do, ví dụ “Bộ xử lý của máy này không có AVX2…”.

Cách xử lý: Dùng máy đạt cấu hình. Xem yêu cầu ở trang tải xuống.

macOS báo không xác minh được nhà phát triển khi mở app lần đầu

Nguyên nhân: Bạn mở app từ file .dmg tải bằng trình duyệt, còn bản macOS hiện ký ad-hoc và chưa được Apple notarize.

Cách xử lý: Cách nhanh nhất là chạy lại lệnh cài trong Terminal (app mở thẳng). Hoặc bấm Done, mở System Settings › Privacy & Security, kéo xuống cuối, bấm Open Anyway cạnh AI Translator. Xem cài đặt trên macOS.

Sau khi cập nhật, macOS hỏi mật khẩu đăng nhập

Nguyên nhân: Bình thường với bản ký ad-hoc: 1 hộp thoại Keychain mỗi lần cập nhật (5 hộp thoại ở lần cập nhật đầu tiên từ 0.1.0 lên 0.1.1) và có thể thêm quyền ghi âm một lần.

Cách xử lý: Nhập mật khẩu, bấm Always Allow và cho phép quyền ghi âm.

Windows hiện “Windows protected your PC” khi mở bộ cài

Nguyên nhân: Bạn mở file .exe tải bằng trình duyệt, còn bản Windows chưa được ký mã nên Microsoft Defender SmartScreen có thể chặn.

Cách xử lý: Cách nhanh nhất là chạy lại lệnh cài trong PowerShell (không qua SmartScreen). Hoặc kiểm mã SHA-256, bấm More info, kiểm dòng App là đúng tên file cài, rồi bấm Run anyway. Không có nút Run anyway thì có thể do chính sách của máy: hỏi quản trị viên. Xem cài đặt trên Windows.

Phần mềm diệt virus chặn hoặc xóa bộ cài Windows

Nguyên nhân: Bộ cài chưa ký mã và còn ít người tải, nên có phần mềm xếp nó vào loại đáng ngờ.

Cách xử lý: Kiểm lại mã SHA-256. Nếu mã khớp mà vẫn bị chặn, liên hệ hỗ trợ và cho biết tên phần mềm diệt virus.

Bản quyền, hạn mức và dùng thử

“Đã hết hạn mức dịch · mở lại lúc …”

Nguyên nhân: Đã dùng hết 30 phút hôm nay (Free) hoặc hạn mức của chu kỳ (Monthly: 50 giờ, 6 Months: 100 giờ).

Cách xử lý: Đợi tới giờ mở lại ghi trên màn hình, hoặc gia hạn, đổi gói.

“Đã hết 10 ngày dùng thử”

Nguyên nhân: Free chỉ dùng thử 10 ngày mỗi máy; gỡ cài lại không mở lại.

Cách xử lý: Mua Monthly, 6 Months hoặc Yearly để dịch tiếp.

“Key đang dùng trên 2 máy nên đã bị tạm khóa…”

Nguyên nhân: Key đang giữ ở hai máy.

Cách xử lý: Gỡ key khỏi một máy rồi bấm Thử lại: xem cách đổi máy.

“Cần kết nối mạng một lần để bắt đầu dùng thử” hoặc “Đã 14 ngày chưa kiểm được gói nên đang dùng Free. Hãy kết nối mạng.”

Nguyên nhân: Máy chưa đăng ký dùng thử được vì chưa có mạng, hoặc gói trả phí quá 14 ngày chưa kiểm tra bản quyền.

Cách xử lý: Kết nối mạng. Nếu máy chưa đăng ký dùng thử, bấm Bắt đầu lại để app đăng ký. Với gói trả phí, bấm Kiểm tra ngay ở Cài đặt › Bản quyền.

“Giờ của máy có vẻ không đúng. Chỉnh lại giờ rồi thử lại.” hoặc “Giờ máy đã bị chỉnh lùi…”

Nguyên nhân: Đồng hồ máy bị chỉnh lùi.

Cách xử lý: Đặt lại giờ đúng (nên bật đặt giờ tự động), kết nối mạng để app kiểm lại.

“Key này không đúng…”; “Key này đang bị khóa tạm vì đổi máy quá nhiều lần…”; “Bản cài AI Translator này không chính hãng…”

Nguyên nhân: Gõ sai key; đổi máy quá nhiều; hoặc bản cài không phải bản chính thức.

Cách xử lý: Dán lại key từ email; liên hệ hỗ trợ nếu key bị khóa; tải lại bản cài chính thức từ liên kết do chúng tôi gửi hoặc từ aitranslator.vn.

Gõ dịch

Bấm ⌃⌥G (Ctrl+Alt+G) mà ô soạn không hiện

Nguyên nhân: Gõ dịch đang tắt, hoặc phím tắt bị app khác giữ.

Cách xử lý: Bật ở Cài đặt › Gõ dịch. Trên Windows, Cài đặt › Phím tắt báo phím chưa đăng ký được thì đổi sang phím khác; trên macOS, nếu app khác cũng dùng ⌃⌥G thì đổi phím của một bên.

“Đã chép bản dịch. Muốn app tự dán, hãy cấp quyền Trợ năng cho AI Translator.”

Nguyên nhân: macOS chưa cho AI Translator quyền Trợ năng, hoặc quyền mất sau khi cập nhật app.

Cách xử lý: Bấm ⌘V ở ô chat để dán lần này. Muốn app tự dán, bấm Bật tự dán rồi bật AI Translator trong Trợ năng. Đã bật từ trước mà vẫn báo (thường sau khi cập nhật app): từ bản 0.1.14, nút Bật tự dán tự xóa quyền cũ nên bạn chỉ cần bật lại một lần; với bản cũ hơn, hãy xóa AI Translator khỏi danh sách (nút −) rồi thêm lại (nút +). Xem Gõ dịch.

Bấm Enter mà bản dịch không vào ô chat

Nguyên nhân: Ô đó không nhận dán tự động (ô mật khẩu, app chạy với quyền quản trị trên Windows, app chặn dán), hoặc cửa sổ chat không về phía trước kịp.

Cách xử lý: Bản dịch vẫn nằm trong clipboard: bấm vào ô chat rồi dán bằng ⌘V hay Ctrl+V.

“Một dòng quá dài để dịch. Hãy tách thành nhiều dòng hay nhiều tin.”

Nguyên nhân: Một dòng của tin nhắn quá dài để dịch một lần (cả tin tối đa 4000 ký tự).

Cách xử lý: Bấm Shift+Enter để xuống dòng ở chỗ hợp lý, hoặc tách thành nhiều tin.

Gửi log và báo lỗi cho hỗ trợ

Khi app gặp lỗi (dừng đột ngột, phiên dịch dừng vì lỗi của app, hoặc một công cụ phụ chết rồi tự khởi động lại), nó tự gửi một báo cáo lỗi cho chúng tôi: thông tin máy và phần log liên quan, đã che đường dẫn thư mục cá nhân, key, token và email, không có âm thanh hay nội dung chép lời. Báo cáo chỉ được gửi khi app không đang dịch. Tính năng này bật mặc định; bạn tắt ở Cài đặt › Quyền riêng tư › Gửi báo cáo lỗi tự động. Xem báo cáo gồm gì và giữ bao lâu.

Với lỗi không làm app dừng (phụ đề sai, chậm…), hãy vào Giới thiệu › Gửi log cho hỗ trợ: app gửi ngay một báo cáo, kể cả khi bạn đã tắt gửi tự động, và hiện một mã báo cáo (dạng R-XXXX-XXXX). Ghi mã này vào thư gửi hỗ trợ (support@aitranslator.vn) để chúng tôi tìm đúng báo cáo của bạn.

Muốn tự xem hay đính kèm log, mở Giới thiệu › Mở thư mục log để thấy file app.log (trên macOS: thư mục con com.aitranslator.desktop trong ~/Library/Logs/; trên Windows: %LOCALAPPDATA%\com.aitranslator.desktop\logs\). File này nằm trên máy bạn và không chứa âm thanh, nội dung chép lời hay key đầy đủ.

Màn hình Giới thiệu: tên app, dòng Phiên bản, hai nút Mở thư mục log và Gửi log cho hỗ trợ, và mục điều khoản và quyền riêng tư
Giới thiệu: phiên bản, Mở thư mục log và Gửi log cho hỗ trợ.

Hãy liên hệ khi lỗi lặp lại sau khi làm theo bảng trên, khi key bị khóa tạm hoặc thu hồi, hoặc khi thanh toán có vấn đề. Hãy kèm trong thư:

  • Phiên bản app (Giới thiệu › “Phiên bản …”, hoặc chân thanh bên trái của cửa sổ chính, dạng “Monthly · v0.1.6”), phiên bản macOS hoặc Windows, chip hoặc CPU (ví dụ MacBook Air M2), RAM, và card đồ họa nếu là máy Windows.
  • Gói model (Chuẩn hoặc Nhẹ, ở Cài đặt › Model) và gói bản quyền.
  • Câu báo lỗi đúng chữ hoặc ảnh chụp, app họp đang dùng, việc bạn vừa làm.
  • Mã báo cáo (nếu bạn đã bấm Gửi log cho hỗ trợ) và mã đơn nếu liên quan thanh toán; app.log nếu bạn muốn đính kèm.

Hỏi nhanh

Tôi đóng cửa sổ mà app vẫn chạy. Thoát hẳn thế nào?

Đóng cửa sổ chỉ ẩn app xuống menu bar (macOS) hoặc khay hệ thống (Windows). Hãy chọn Thoát ở biểu tượng AI Translator trên menu bar hoặc trong khay; trên Mac, ⌘Q không thoát hẳn.

Cài lại app có làm mất key hoặc mở lại 10 ngày dùng thử không?

Không. Cài lại trên cùng một máy không tính là máy mới, và 10 ngày dùng thử tính theo máy nên không mở lại được.

Gửi log có làm lộ nội dung cuộc họp không?

Không. Log không chứa âm thanh hay nội dung chép lời. Khi app gặp lỗi, nó tự gửi phần log liên quan, đã che đường dẫn thư mục cá nhân, key, token và email, cho chúng tôi; bạn tắt được ở Cài đặt › Quyền riêng tư.