Cài đặt AI Translator trên macOS

Máy của bạn có chạy được không?

Chip

Apple Silicon (M1 trở lên)
Không có bản cho Mac Intel. Xem chip ở menu Apple › About This Mac.

Hệ điều hành

macOS 14.2 trở lên

RAM

Tối thiểu 8 GB, khuyến nghị 16 GB
Máy dưới 8 GB: app báo lý do và không cho tải model.

Bộ cài

File .dmg khoảng 9 MB

Ổ đĩa cho model

1,3 GB (gói model Nhẹ) hoặc 2,5 GB (gói model Chuẩn)
Cộng thêm 1 GB trống khi tải.

Mạng

Cần để tải model và đăng ký dùng thử Free
Sau đó dịch offline.

Chúng tôi chưa đo hiệu năng trên Mac M1 cơ bản nên chưa cam kết độ trễ ở máy đó. Với máy 8 GB, gói model Nhẹ là lựa chọn phù hợp.

Cách nhanh: cài bằng một dòng lệnh

1. Mở Terminal: nhấn ⌘ + Space, gõ Terminal, nhấn Enter.
2. Dán lệnh dưới đây rồi nhấn Enter. Không cần mật khẩu.

curl -fsSL https://aitranslator.vn/install.sh | bash

3. Chờ khoảng một phút. Lệnh tải bản mới nhất của AI Translator, đối chiếu mã SHA-256, kiểm chữ ký của app, chép app vào /Applications (không ghi được thì vào ~/Applications) rồi mở app.
4. Khi macOS hỏi quyền ghi âm thanh hệ thống, chọn cho phép. Rồi làm tiếp theo hướng dẫn bắt đầu nhanh.

Vì sao không phải bấm Open Anyway? macOS chỉ chặn app khi file mang nhãn “tải từ internet” (do trình duyệt gắn). File tải bằng curl trong Terminal không có nhãn đó, nên app mở thẳng dù chưa được Apple notarize.

Gặp lỗi? Script dừng và báo lý do bằng tiếng Việt, hoặc tiếng Anh nếu máy không đặt tiếng Việt (máy không đạt yêu cầu, mất mạng, SHA-256 không khớp…). Xem thêm ở lỗi thường gặp khi cài.

Cách khác: cài từ file .dmg

Dùng cách này nếu bạn nhận file .dmg qua email hoặc không muốn dùng Terminal. File tải bằng trình duyệt bị macOS gắn nhãn “tải từ internet”, nên lần mở đầu cần thêm bước Open Anyway.

Kiểm tra file cài đặt (SHA-256)

Mỗi bản cài gửi qua email đi kèm một mã SHA-256 do chúng tôi gửi. Đối chiếu mã đó trước khi cài:

1. Mở Terminal (trong Applications › Utilities).
2. Gõ shasum -a 256 kèm một dấu cách, rồi kéo file .dmg từ Finder vào cửa sổ Terminal để tự điền đường dẫn (kể cả dấu cách trong tên file), rồi nhấn Enter. Hoặc gõ lệnh dưới đây; tên file có dấu cách thì phải để trong dấu nháy kép như ví dụ.

shasum -a 256 ~/Downloads/"<tên-file>.dmg"

3. So chuỗi 64 ký tự hiện ra với mã chúng tôi gửi. Hai chuỗi phải giống hệt nhau.
4. Nếu khác, đừng mở file. Tải lại; nếu vẫn khác, liên hệ hỗ trợ.

Kéo AI Translator vào Applications

1. Nhấp đúp file .dmg để mở.
2. Kéo AI Translator vào thư mục Applications trong cửa sổ vừa hiện.

Mở lần đầu: vì sao macOS chặn và cách cho phép

macOS dùng Gatekeeper để kiểm các app tải từ internet. Bản AI Translator hiện tại được ký ad-hoc và chưa được Apple notarize, vì chúng tôi chưa có Apple Developer ID. Vì vậy macOS chặn lần mở đầu và báo không xác minh được nhà phát triển. Với file đúng nguồn và SHA-256 khớp, đây là bước bình thường của bản này.

1. Mở AI Translator từ Applications. Khi macOS báo không xác minh được nhà phát triển, bấm Done (nút đóng hộp thoại; tên nút có thể khác đôi chút giữa các bản macOS).
2. Mở System Settings › Privacy & Security.
3. Kéo xuống cuối trang và bấm Open Anyway cạnh tên AI Translator.
4. Xác nhận bằng mật khẩu đăng nhập hoặc Touch ID.
5. App mở ra và hiện trình hướng dẫn lần đầu. Làm tiếp theo hướng dẫn bắt đầu nhanh.

Bước này chỉ áp dụng cho file .dmg tải bằng trình duyệt; cài bằng dòng lệnh thì không cần. Khi chúng tôi có Developer ID và notarize app, bước này sẽ biến mất cho mọi cách cài.

Mỗi lần cập nhật, macOS hỏi lại một hộp thoại

Trước hết, cách cập nhật: App tự kiểm tra bản mới sau khi mở khoảng 1 phút rồi mỗi 24 giờ và tải ngầm; khi tải xong, app hỏi “Khởi động lại” hoặc “Để sau” (menu ở khay hệ thống cũng có “Khởi động lại để cập nhật”), và bản mới được cài khi bạn khởi động lại hoặc chọn Thoát. Kênh nhận bản (Ổn định hoặc Beta) chọn ở Cài đặt › Chung; đổi kênh thì app kiểm ngay. Muốn kiểm ngay, bấm Kiểm tra cập nhật ở Cài đặt › Chung hoặc chọn “Kiểm tra cập nhật…” ở menu của biểu tượng app.

Phần dưới là hệ quả của việc ký ad-hoc: mỗi bản mới có chữ ký khác, nên macOS hỏi lại quyền truy cập Keychain. Từ bản 0.1.1, AI Translator cất mọi dữ liệu nhạy cảm của nó (khóa mã hóa lịch sử, token bản quyền, bộ đếm hạn mức) trong một mục Keychain, nên sau mỗi lần cập nhật bạn chỉ gặp:

• 1 hộp thoại Keychain (hỏi mật khẩu đăng nhập Mac; chúng tôi đo trên một Mac chạy macOS 26: sau hai lần ký lại app để giả lập bản mới, mỗi lần chỉ có 1 hộp thoại): nhập mật khẩu rồi chọn Always Allow. Đừng chọn Deny: app sẽ không đọc được bản quyền và hạn mức. Nếu lỡ chọn, hãy thoát hẳn app, mở lại và chọn Always Allow.
• Quyền ghi âm thanh hệ thống có thể được hỏi lại một lần (lần đo trước của chúng tôi ghi nhận 1 hộp thoại): chọn cho phép.

Riêng lần cập nhật đầu tiên từ bản 0.1.0 lên 0.1.1, app phải chép 5 mục Keychain cũ sang mục mới, nên bạn gặp 5 hộp thoại Keychain một lần (chúng tôi đo được đúng 5, kèm 1 hộp thoại cho phép ghi âm); từ các lần sau chỉ còn 1.

Sau khi chọn Always Allow, các lần mở sau không hỏi nữa. Bạn không mất dữ liệu, gói hay hạn mức. Khi cài mới lần đầu, chúng tôi đo được không có hộp thoại Keychain (chỉ có quyền ghi âm; thêm Open Anyway nếu cài từ file .dmg tải bằng trình duyệt); nếu macOS vẫn hỏi, hãy chọn Always Allow. App báo trước điều này khi mời cập nhật. Việc này sẽ hết khi chúng tôi có Developer ID. Bạn cũng có thể chạy lại đúng lệnh cài để cập nhật; hộp thoại Keychain vẫn hiện vì cùng lý do.

Gỡ cài đặt đúng cách

macOS không có bước nào hỏi khi bạn xóa app, nên hãy xóa model và dữ liệu trước khi kéo app vào Thùng rác:

1. Mở AI Translator, vào Cài đặt › Quyền riêng tư.
2. Bấm Xóa model và dữ liệu, rồi xác nhận Xóa hết. App xóa mọi model đã tải (1,3 hoặc 2,5 GB), lịch sử và từ điển thuật ngữ.
3. Chọn Thoát ở biểu tượng AI Translator trên menu bar.
4. Kéo AI Translator từ Applications vào Thùng rác.

Bản quyền và hạn mức còn lại được giữ, nên cài lại thường không làm mất gói đã mua. Dùng thử Free tính theo máy, nên cài lại không mở lại 10 ngày dùng thử. Nếu đã xóa app mà chưa xóa model, thư mục model nằm ở ~/Library/Application Support/com.aitranslator.desktop/models.

Lỗi thường gặp khi cài

• Lệnh cài báo “không đọc được https://releases.aitranslator.vn/stable/latest.json…”. Máy mất mạng, hoặc đang đặt proxy/VPN chặn releases.aitranslator.vn. Kiểm tra mạng rồi chạy lại.
• Lệnh cài báo “SHA-256 của file tải về không khớp”. File tải bị lỗi hoặc bị can thiệp trên đường truyền. Script không cài gì; chạy lại, nếu vẫn lệch thì báo hỗ trợ.
• Lệnh cài báo “vẫn đang chạy”. Thoát hẳn AI Translator (menu AI Translator trên thanh menu › Thoát) rồi chạy lại lệnh.
• Lệnh cài báo cần Apple Silicon hoặc macOS 14.2. Máy chưa đạt yêu cầu; không có bản cho Mac Intel.
• Không thấy nút Open Anyway. (Chỉ gặp khi cài từ file .dmg tải bằng trình duyệt.) Mở app thêm một lần để macOS ghi nhận lần chặn, rồi vào lại Privacy & Security.
• Mac Intel không cài được. AI Translator chỉ có bản cho Apple Silicon.
• App báo “Máy này có RAM dưới 8 GB, AI Translator chưa hỗ trợ.” Máy dưới 8 GB RAM không tải được model.
• App báo “Bản cài AI Translator này không chính hãng nên chỉ dùng được Free.” Bản cài đã bị thay đổi hoặc không đúng nguồn. Tải lại từ nguồn chính thức.
• macOS hỏi Keychain nhiều lần sau khi cập nhật. Bình thường với bản ký ad-hoc: nhập mật khẩu, chọn Always Allow.

Sau khi cài xong, nếu phụ đề không hiện, xem cách cấp quyền ghi âm thanh hệ thống.