📖 Cẩm Nang Toàn Diện • Cập nhật cho v1.0.9

Hướng Dẫn Sử Dụng Max Dịch cho macOS

Tài liệu đầy đủ từng bước giúp bạn cài đặt, vượt rào bảo mật Apple Gatekeeper, cấp các quyền hệ thống cần thiết, cấu hình AI Key miễn phí và tận dụng tối đa các phím tắt dịch siêu tốc.

1

Cài Đặt & Mở Khóa Gatekeeper

Max Dịch là ứng dụng độc lập dạng Menu Bar siêu nhẹ, không thu thập dữ liệu và được đóng gói trực tiếp cho macOS. Bạn có thể cài đặt theo 1 trong 2 cách:

A Tải Bộ Cài .DMG (Khuyên dùng)

1.6 MB
  1. Tải file Max-Dich-macOS.dmg.
  2. Mở file .dmg vừa tải, kéo biểu tượng Max Dịch vào thư mục Applications.
  3. Nhấp đúp để mở Max Dịch từ Launchpad hoặc Spotlight.

B Cài Tự Động Qua Terminal

Tự gỡ Gatekeeper

Mở ứng dụng Terminal trên Mac và dán dòng lệnh sau:

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

Script sẽ tự động tải bản mới nhất, chuyển vào Applications và gỡ chặn kiểm tra bảo mật của Apple.

Khắc phục cảnh báo "Không thể mở ứng dụng..." của Apple (Gatekeeper)

Nếu macOS chặn không cho mở với thông báo "Apple không thể kiểm tra nhà phát triển", bạn chỉ cần làm 1 trong 2 cách sau đúng một lần duy nhất:

Cách dễ nhất (Chuột phải): Mở Finder $\rightarrow$ vào thư mục Applications $\rightarrow$ nhấp chuột phải vào Max Dịch $\rightarrow$ chọn Open (Mở) $\rightarrow$ bấm nút Open ở hộp thoại thông báo.
Qua Cài đặt hệ thống: Vào System Settings (Cài đặt hệ thống) $\rightarrow$ Privacy & Security (Quyền riêng tư & Bảo mật) $\rightarrow$ cuộn xuống mục Bảo mật $\rightarrow$ bấm Open Anyway (Vẫn mở).

2

Cấp Quyền Hệ Thống (Bắt Buộc)

Để tính năng dịch bôi đen toàn cục và quét chữ chụp màn hình (OCR) hoạt động trên bất kỳ ứng dụng nào (Chrome, Safari, VS Code, Slack, PDF...), macOS yêu cầu cấp 2 quyền bảo mật:

♿

1. Quyền Trợ Năng (Accessibility)

Dùng để lắng nghe phím tắt toàn cục và tự động lấy văn bản đang bôi đen.

Bắt buộc cho phím tắt
Các bước bật quyền:
  1. Mở Cài đặt hệ thống (System Settings) trên máy Mac.
  2. Chọn mục Quyền riêng tư & Bảo mật (Privacy & Security) ở thanh bên trái.
  3. Tìm và nhấp vào Trợ năng (Accessibility).
  4. Bật công tắc màu xanh cạnh ứng dụng Max Dịch (hoặc bấm dấu + để thêm từ thư mục Applications nếu chưa thấy).
📸

2. Quyền Ghi Màn Hình (Screen Recording)

Dùng cho tính năng Chụp & Dịch OCR (khoanh vùng quét chữ trên ảnh/video/PDF).

Bắt buộc cho OCR
Các bước bật quyền:
  1. Trong System Settings $\rightarrow$ Privacy & Security.
  2. Chọn mục Ghi màn hình & Âm thanh hệ thống (Screen & System Audio Recording).
  3. Bật công tắc cho Max Dịch.
  4. Nếu macOS yêu cầu "Thoát và mở lại" (Quit & Reopen), hãy bấm đồng ý để hệ điều hành lưu quyền.
* Lưu ý bảo mật: Max Dịch chỉ chụp lại chính xác vùng chữ nhật mà bạn chủ động khoanh chuột và xử lý trích xuất văn bản ngay trên bộ vi xử lý máy bạn (Apple Vision), tuyệt đối không ghi âm hay quay màn hình nền.

3

Cấu Hình Nhà Cung Cấp AI

Max Dịch hoạt động theo mô hình Bring Your Own Key (BYOK): Bạn có toàn quyền kết nối với mô hình AI mà bạn thích. Không thu phí thuê bao hàng tháng, bảo mật tuyệt đối vì API Key lưu trực tiếp trong macOS Keychain trên máy bạn.

🚀

Model AI Mặc Định Của Max Dịch Khuyên Dùng — Cài Sẵn

Model chuyên sâu dịch thuật (TranslateGemma-27B) tối ưu đặc biệt cho cặp ngôn ngữ Anh ➔ Việt.

100% Miễn Phí — Dùng Ngay
⚡ Tốc độ dưới 1s

Máy chủ chuyên dụng phản hồi cực nhanh, không có thời gian chờ (latency tối thiểu).

🎯 Chuẩn ngữ cảnh

Văn phong tiếng Việt trôi chảy, đọc tự nhiên, chuẩn kỹ thuật và bản xứ.

🔓 Không cần API Key

Mở app là dịch ngay, không cần đăng ký tài khoản hay thiết lập phức tạp.

✨

Google Gemini Khuyên Dùng — 100% Miễn Phí

Tốc độ cực nhanh, dịch văn phong tự nhiên và chất lượng cao nhất hiện nay.

Lấy Key tại Google AI Studio ↗

Các bước lấy API Key trong 30 giây:

  1. Truy cập Google AI Studio (aistudio.google.com) và đăng nhập tài khoản Google.
  2. Nhấp nút màu xanh "Create API key" (Tạo khoá API).
  3. Chọn dự án mặc định hoặc tạo dự án mới, sau đó bấm nút sao chép (Copy) chuỗi khoá có dạng AIzaSy....
  4. Quay lại Max Dịch:
    • Ở mục Nhà cung cấp: Chọn Google Gemini.
    • Dán chuỗi khoá vào ô API Key.
    • Model mặc định: gemini-2.5-flash (hoặc gemini-1.5-flash).
    • Bấm nút Kiểm tra kết nối để xác nhận thành công!
🦙

Ollama (Chạy Offline 100%) Riêng Tư Tuyệt Đối

Dịch không cần kết nối mạng, chạy trực tiếp trên GPU máy Mac Apple Silicon (M1/M2/M3/M4).

Tải Ollama ↗

1. Cài đặt Ollama từ ollama.com.
2. Mở Terminal và kéo một mô hình dịch thuật nhẹ (ví dụ Qwen 2.5):

ollama run qwen2.5:7b

3. Trong Max Dịch $\rightarrow$ Cài đặt $\rightarrow$ Chọn Preset Ollama:
• Endpoint: http://localhost:11434/v1
• Model: qwen2.5:7b (hoặc mô hình bạn đã tải)
• API Key: Bỏ trống hoặc nhập tuỳ ý (Ollama không yêu cầu key).

DeepSeek

Chi phí siêu tiết kiệm, dịch tiếng Việt văn phong mềm mại, tự nhiên.

• Lấy key: platform.deepseek.com
• Model: deepseek-chat

Groq Cloud

Tốc độ cực hạn (phản hồi trong 0.2s - 0.5s), gói miễn phí rất hào phóng.

• Lấy key: console.groq.com
• Model: llama-3.3-70b-versatile

OpenAI (ChatGPT)

Chất lượng chuẩn mực, dịch thuật tài liệu chuyên ngành xuất sắc.

• Lấy key: platform.openai.com
• Model: gpt-4o-mini hoặc gpt-4o

4

Hướng Dẫn Khai Thác Tính Năng

⚡

1. Dịch Bôi Đen Tức Thì (Global Hotkey)

Cách nhanh nhất để dịch văn bản khi đọc báo, xem tài liệu hay lướt web.

Phím mặc định: ⌥ Option + D

Cách thực hiện:

Bước 1: Dùng chuột bôi đen đoạn văn bản bất kỳ trên màn hình.
Bước 2: Nhấn tổ hợp phím ⌥ D (hoặc phím bạn đã đổi trong Cài đặt).
Bước 3: Cửa sổ Max Dịch lập tức bật ra và hiển thị bản dịch tiếng Việt ngay tại chỗ!

💡 Mẹo tùy chỉnh: Bạn có thể vào tab Cài đặt để đổi sang ⌥ Space, ⌘ ⇧ D hoặc bất kỳ tổ hợp nào bạn thuận tay nhất.

📸

2. Chụp Màn Hình & Dịch OCR (Screen Snipping)

Quét chữ trên vùng không copy được: Video phụ đề, game, PDF scan, hình ảnh.

Phím mặc định: ⌥ Option + S

Cách thực hiện:

Bước 1: Nhấn phím tắt ⌥ S hoặc bấm nút icon Camera ("Chụp & Dịch") trong app.
Bước 2: Con trỏ chuyển thành dấu thập +. Kéo chuột khoanh vùng chứa dòng chữ cần dịch.
Bước 3: Apple Vision Framework tự động bóc tách chữ tức thì và AI dịch sang tiếng Việt ngay lập tức.
📋

3. Dán & Dịch Thông Minh (Smart Paste)

Tự nhận diện Clipboard là đoạn văn bản hay là hình ảnh vừa chụp.

Khi bạn chụp ảnh màn hình bằng phím tắt macOS mặc định (⌘ + ⌃ Control + ⇧ Shift + 4), ảnh sẽ lưu vào clipboard. Lúc này chỉ cần mở Max Dịch và bấm nút "Dán & Dịch": Ứng dụng sẽ tự động trích xuất chữ từ ảnh đó và dịch ngay mà không cần lưu file ra Desktop!

🎭

4. Bốn Phong Cách Giọng Điệu Dịch Thuật

Điều chỉnh phong thái dịch phù hợp với từng ngữ cảnh công việc.

🌱 Tự nhiên (Mặc định)

Văn phong giao tiếp đời sống, trôi chảy, đọc tự nhiên như người bản xứ nói, tránh dịch máy thô cứng.

💻 Kỹ thuật / IT

Chuyên biệt cho lập trình viên & kỹ sư: giữ nguyên tên hàm, tên biến, syntax code và các thuật ngữ chuyên ngành chuẩn xác.

👔 Trang trọng

Phù hợp viết email công việc, dịch hợp đồng, giấy tờ pháp lý hoặc báo cáo nghiên cứu học thuật lịch thiệp.

⚡ Ngắn gọn

Lược bỏ các từ đệm, đi thẳng vào ý chính, cực kỳ hữu ích khi cần tóm tắt nhanh nội dung dài.


5

Bảng Phím Tắt Toàn Tập (Cheatsheet)

Thao Tác Phím Tắt Mặc Định Phạm Vi Hoạt Động
Dịch bôi đen tức thì ⌥ Option + D Toàn hệ thống (Global)
Chụp màn hình quét chữ OCR ⌥ Option + S Toàn hệ thống (Global)
Kích hoạt dịch đoạn văn đang nhập ⌘ Command + Return Trong cửa sổ App
Chuyển qua lại giữa các ô nhập Tab Trong cửa sổ App
Đóng cửa sổ Menu Bar Esc hoặc nhấp chuột ra ngoài Mọi nơi

6

Câu Hỏi Thường Gặp & Khắc Phục Lỗi

❓ Bôi đen chữ rồi nhấn ⌥D nhưng app không tự động dịch? ▼
Nguyên nhân phổ biến nhất là quyền Trợ năng (Accessibility) chưa được cấp hoặc bị treo bởi macOS.

Cách xử lý: Vào System Settings $\rightarrow$ Privacy & Security $\rightarrow$ Accessibility. Tắt công tắc cạnh Max Dịch rồi bật lại (hoặc xóa đi và thêm lại). Sau đó khởi động lại Max Dịch.
❓ Bấm chụp màn hình báo lỗi hoặc không khoanh được vùng chữ? ▼
Bạn cần cấp quyền Screen Recording (Ghi màn hình) trong System Settings $\rightarrow$ Privacy & Security $\rightarrow$ Screen Recording. Hãy chắc chắn rằng bạn đã nhấn "Quit & Reopen" sau khi bật quyền.
❓ Báo lỗi 401 Unauthorized khi dịch? ▼
Lỗi này do API Key chưa chính xác hoặc đã bị xóa trên tài khoản của bạn. Hãy vào tab Cài đặt trong Max Dịch, kiểm tra lại API Key xem có bị dán thừa ký tự khoảng trắng không, và bấm nút "Kiểm tra kết nối" để xác thực.
❓ Tôi có thể cho Max Dịch tự khởi động cùng máy Mac không? ▼
Hoàn toàn được! Mở System Settings $\rightarrow$ General (Cài đặt chung) $\rightarrow$ Login Items (Mục đăng nhập) $\rightarrow$ tại phần Open at Login bấm dấu + và chọn Max Dịch từ thư mục Applications.

7

Hỗ Trợ Trực Tiếp Từ Tác Giả

Max Dịch Logo

Vũ Duy Mạnh

Tác giả & Nhà phát triển ứng dụng Max Dịch cho macOS

Sản phẩm phát triển với niềm đam mê công nghệ AI và mong muốn mang lại công cụ hữu ích nhất cho cộng đồng Mac Việt Nam.