Chuyển đến nội dung

Tài liệu

Mọi thứ bạn cần để cài dragoman, kết nối mô hình và duy trì hoạt động.

Cài đặt

Cài dragoman từ cửa hàng tiện ích của trình duyệt, tiện ích sẽ tự cập nhật từ đó.

Chrome, Edge, Helium và các trình duyệt Chromium khác
Tự cài một bản phát hành

Mọi bản phát hành cũng có trên GitHub, kèm tệp zip cho trình duyệt Chromium và Firefox cùng toàn bộ mã nguồn. Bản tự cài sẽ không tự cập nhật.

  1. 1 Tải tệp zip cho Chrome từ bản phát hành mới nhất rồi giải nén.
  2. 2 Mở helium://extensions, hoặc chrome://extensions trên các trình duyệt khác, rồi bật Chế độ dành cho nhà phát triển.
  3. 3 Chọn Tải tiện ích đã giải nén và chọn thư mục vừa giải nén.
Mở bản phát hành mới nhất

Ghim dragoman vào thanh công cụ để mở chỉ bằng một cú nhấp.

Chrome cho Android không hỗ trợ tiện ích. Trên Android, hãy dùng Firefox.

Dịch trang đầu tiên

Mở một trang web bất kỳ, nhấp vào biểu tượng dragoman, chọn ngôn ngữ rồi chọn Dịch trang. Alt+Shift+T, hoặc Option+Shift+T trên Mac, làm điều tương tự từ bàn phím. Bản nháp hiện với gạch chân chấm vàng, gạch này biến mất khi mô hình trau chuốt xong từng đoạn.

AltShiftT / ⌥⇧T Dịch trang hoặc xem bản gốc

Trang đã dịch trông thế nào

Dịch nháp trên thiết bị
Mochi hiện tại được thăng chức thành biên tập trong trưởng.
Trau chuốt bởi mô hình bạn chọn
Từ đó, Mochi đã được thăng chức tổng biên tập.
Bản gốc chỉ cách một lần di chuột
Đặt con trỏ lên bất kỳ đoạn nào để đọc nội dung gốc. Một cú nhấp vào huy hiệu, hoặc Alt+Shift+T, sẽ khôi phục cả trang.

Trên điện thoại hoặc máy tính bảng, hãy mở dragoman từ menu tiện ích của trình duyệt.

So với trình dịch của trình duyệt

Chrome, Edge, Safari và Firefox đều tự dịch được trang, và để xem lướt thì thường là đủ. dragoman dành cho lúc bạn muốn đọc kỹ một trang: dịch đúng ý, đúng chữ, và bạn quyết định ai được thấy nội dung.

Đọc cả trang

Trình dịch có sẵn xử lý trang theo từng mẩu nhỏ, mẩu nào riêng mẩu nấy, nên cùng một từ có thể bị dịch hai kiểu chỉ cách nhau vài dòng. dragoman cho mô hình AI của bạn thấy tiêu đề trang, các đề mục và những cụm từ lặp lại, nhờ vậy tên riêng, nhãn hay thuật ngữ được dịch thống nhất từ đầu đến cuối.

Từng mảnh rời rạc

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Period
Περίοδος
1928–1932
Tenure
Περίοδος
1933
Term

Khi nhìn thấy cả trang

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Minh họa: một nhãn tiếng Hy Lạp lặp lại nhiều lần trong hộp thông tin, được dịch sang tiếng Anh.

Bạn quyết định văn bản đi đâu

Khi Chrome hoặc Edge dịch một trang, văn bản sẽ được gửi tới Google hoặc Microsoft. dragoman dịch nháp trên thiết bị của bạn, rồi chỉ gửi phần bạn đang đọc tới nhà cung cấp bạn chọn, bằng khóa của chính bạn. Nếu chỉ dùng trên thiết bị, không chữ nào trên trang bị gửi đi.

Văn bản trên trang đi đâu

Chrome Google Edge Microsoft dragoman Thiết bị của bạn Nhà cung cấp AI của bạn chỉ phần bạn đọc, nếu bạn thêm mô hình
Bạn chọn người dịch
Chrome dịch trang bằng Google Dịch, còn Edge dùng Microsoft Translator. dragoman làm việc với mô hình AI bạn chọn, dù là Claude, Gemini, các mô hình đứng sau ChatGPT hay một mô hình chạy ngay trên máy tính của bạn. Các mô hình AI ngày nay thường xử lý thành ngữ, giọng điệu và những từ có nghĩa tùy theo câu tốt hơn.
Bản gốc luôn trong tầm tay
Di chuột lên một đoạn bất kỳ, hoặc chạm vào nó trên điện thoại, để xem nguyên văn mà không cần chuyển cả trang về bản gốc.

Trình dịch của trình duyệt có sẵn, miễn phí và không cần thiết lập. Bản nháp trên thiết bị của dragoman cũng miễn phí, còn bước trau chuốt chỉ tốn đúng khoản nhà cung cấp tính cho phần văn bản bạn đọc, thường rất ít nếu dùng mô hình nhỏ. Trình dịch của Firefox chạy Bergamot, chính công cụ dragoman dùng để dịch nháp trong Firefox, nên ở đó khác biệt nằm ở lượt trau chuốt bằng AI và ngữ cảnh của trang.

Bên trong hoạt động thế nào
Hai lượt dịch
Mô hình trên thiết bị của trình duyệt dịch nháp ở chế độ nền, còn Bergamot, được biên dịch sang WebAssembly, sẽ đảm nhận khi trình duyệt không có mô hình. Sau đó, các đoạn đang hiển thị và sắp tới được gửi tới mô hình của bạn theo từng nhóm nhỏ, và mỗi đoạn đã trau chuốt sẽ thay thế bản nháp của nó.
Ngữ cảnh trang
Mỗi yêu cầu kèm theo tiêu đề trang, dàn ý các đề mục, những cụm từ lặp lại trên trang cùng đoạn văn quanh lần xuất hiện đầu tiên, và mọi cách dịch đã thống nhất đến lúc đó. Mô hình trả về các thuật ngữ nó đã chọn, và những yêu cầu sau sẽ giữ đúng như vậy.
Định dạng
Liên kết, chữ nhấn mạnh và các phần tử nội dòng khác được chuyển đi dưới dạng phần giữ chỗ đánh số, nên bố cục và liên kết trở về nguyên vẹn.
Chỉ phần bạn đọc
Bước trau chuốt đi theo vùng hiển thị, nên một trang dài chỉ tốn chi phí cho phần bạn cuộn qua. Bản dịch hoàn chỉnh được lưu trên thiết bị và dùng lại khi bạn quay lại.
Không qua trung gian
Yêu cầu đi thẳng từ trình duyệt đến nhà cung cấp của bạn bằng khóa của bạn. Không có máy chủ dragoman nào, và toàn bộ mã nguồn đều công khai.

Dịch trên thiết bị

Mọi trang đều bắt đầu trên thiết bị của bạn. dragoman dịch nháp bằng mô hình trên thiết bị tích hợp sẵn trong Chrome và Edge, và bằng mô hình của Apple trong Safari. Các mô hình này chạy trên máy tính của bạn, khác với tính năng dịch trang của chính các trình duyệt vốn cần trực tuyến. Ở mọi nơi khác, và với những ngôn ngữ chúng không hỗ trợ, Bergamot, công cụ mã nguồn mở đứng sau Firefox Translations, sẽ dịch nháp ngay trong trình duyệt. Không cần tài khoản hay khóa nào. Dùng riêng, bạn có một bản dịch nhanh và riêng tư. Khi có mô hình AI, các bản nháp đó trở thành lượt đầu để mô hình của bạn trau chuốt.

Tải một lần cho mỗi cặp ngôn ngữ

  • Tiếng Anh → Tiếng Thổ Nhĩ Kỳ 15 MB
  • Tiếng Anh → Tiếng Đức 26 MB
  • Tiếng Pháp → Tiếng Anh 26 MB
  • Tiếng Nhật → Tiếng Anh 49 MB

Tiếng Pháp → Tiếng Anh → Tiếng Đức

52 MB

Không có mô hình trực tiếp giữa hai ngôn ngữ? dragoman sẽ dịch qua tiếng Anh và tải cả hai nửa.

Dung lượng tải theo danh mục mô hình của Mozilla.
Ngôn ngữ
Hơn 50 ngôn ngữ, dịch sang và từ tiếng Anh. Giữa hai ngôn ngữ khác, dragoman sẽ dịch qua tiếng Anh. Trong danh sách ngôn ngữ, những ngôn ngữ được đánh dấu Chỉ AI cần có mô hình AI.
Lần đầu sử dụng
Chrome và Edge tải gói ngôn ngữ vào lần đầu bạn cần, còn Safari dùng các ngôn ngữ đã tải cho tính năng dịch của Apple trên thiết bị. Các cặp ngôn ngữ của Bergamot được tải một lần từ Mozilla, thường từ 15 đến 50 MB, và được lưu trong trình duyệt. Sau đó, mọi thứ đều hoạt động ngoại tuyến.
Bản nháp và trau chuốt
Bản nháp nhanh và khá sát nghĩa đen, đủ để nắm ý chính. Mô hình của bạn viết lại chúng khi nhìn thấy toàn bộ trang, nên câu chữ tự nhiên, tên riêng và thuật ngữ nhất quán.
Tùy bạn chọn
Để giữ trang trên thiết bị của bạn ngay cả khi đã thiết lập mô hình, hãy bật Chỉ trên thiết bị này trong cửa sổ bật lên. Để bỏ qua bản nháp và chờ mô hình của bạn, hãy tắt Dịch nháp trên thiết bị này trước trong Cài đặt.

Bergamot ra đời từ một dự án nghiên cứu do Liên minh châu Âu tài trợ, còn Mozilla huấn luyện và phát hành các mô hình ngôn ngữ mà nó sử dụng. Về Bergamot

Thêm mô hình AI

Mở Cài đặt từ cửa sổ bật lên, chọn nhà cung cấp và làm theo ba bước. dragoman kiểm tra khóa ngay khi bạn dán và chọn sẵn một mô hình nhanh, rẻ, bạn có thể đổi bất cứ lúc nào.

Các nhà cung cấp bạn có thể dùng

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Mọi máy chủ tương thích OpenAI

OpenRouter có thể tạo khóa cho bạn. Chọn Kết nối với OpenRouter và chấp thuận yêu cầu.

Khóa Anthropic không gắn với không gian làm việc cũng cần ID không gian làm việc. Bạn có thể tìm thấy trong Anthropic Console, mục Settings rồi Workspaces.

Dùng mô hình cục bộ

Cài Ollama, tải một mô hình như gemma3, rồi khởi động với OLLAMA_ORIGINS để chấp nhận yêu cầu từ tiện ích:

OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*,safari-web-extension://*" ollama serve

Trong LM Studio, tải một mô hình, bật CORS trong cài đặt máy chủ và khởi động máy chủ cục bộ. dragoman sẽ tìm thấy nó tại localhost:1234.

Chi phí

dragoman miễn phí. Phần trau chuốt dùng khóa của riêng bạn, nên nhà cung cấp tính phí trực tiếp cho bạn. Các mô hình nhỏ, nhanh thường đã đủ để dịch. Thẻ Mức sử dụng trong Cài đặt đếm token theo từng mô hình mỗi tháng, và khi bật Hiện chi phí của mỗi trang, chi phí của trang hiện tại sẽ hiện cạnh huy hiệu.

Đã trau chuốt 4/14 đoạn

  • Đã trau chuốt
  • Đã dịch nháp
  • Chưa dịch

Khi bạn cuộn, các đoạn sắp tới được dịch nháp nhanh, còn các đoạn đang hiện trên màn hình được trau chuốt. Phần còn lại của trang không tốn gì cho đến khi bạn cuộn tới.

Quyền riêng tư

Những gì rời khỏi máy tính của bạn: các đoạn đang hiển thị và sắp tới, cùng mọi văn bản bạn nhờ người bạn đồng hành dịch, được gửi tới nhà cung cấp bạn chọn; và với những ngôn ngữ trình duyệt không tự dịch được, một lần tải mô hình từ Mozilla. Khóa của bạn chỉ được gửi tới đúng nhà cung cấp của nó. dragoman không có máy chủ, không tài khoản, không theo dõi phân tích.

Đọc toàn bộ chính sách quyền riêng tư

Khắc phục sự cố

Cửa sổ bật lên báo không thể dịch trang

Các trang của trình duyệt như cài đặt, trang tiện ích và cửa hàng ứng dụng không cho phép tiện ích thay đổi. Hãy mở một trang web thông thường.

Công cụ trên thiết bị không có mô hình cho cặp ngôn ngữ này

Các trình dịch trên thiết bị hỗ trợ những ngôn ngữ phổ biến nhất. Trong Safari, bạn có thể thêm ngôn ngữ trong mục Ngôn ngữ dịch ở phần cài đặt Ngôn ngữ & vùng của thiết bị. Với các ngôn ngữ còn lại, hãy thêm một mô hình AI để dragoman dịch trực tiếp bằng mô hình đó.

Trình duyệt cũng đề nghị dịch trang

dragoman yêu cầu trình duyệt đứng ngoài trên những trang nó có thể dịch. Nếu bạn đã tắt tính năng này, hãy bật Không để trình dịch của trình duyệt chen vào trong Cài đặt, mục Ngôn ngữ. Nếu trình duyệt đã dịch một trang, hãy chọn Dùng dragoman thay thế để tải lại trang ở bản gốc.

Mô hình cục bộ không kết nối được

Kiểm tra máy chủ đang chạy và địa chỉ trong Cài đặt khớp với nó. Ollama cần OLLAMA_ORIGINS, còn LM Studio cần bật CORS.

dragoman không đọc được trang

Safari và Firefox cho phép bạn chọn những trang web mà tiện ích được đọc. Hãy mở dragoman và chọn Cho phép trên mọi trang web.

Firefox không trau chuốt bằng mô hình của tôi

Firefox sẽ hỏi trước khi tiện ích gửi văn bản của trang đi bất cứ đâu. Hãy mở Cài đặt và chọn Cho phép gửi văn bản của trang bên dưới mô hình của bạn.

Tự build từ mã nguồn

dragoman là mã nguồn mở theo giấy phép MIT. Để build, bạn cần Node 24 và pnpm.

git clone https://github.com/firatciftci/dragoman.git
cd dragoman
pnpm install
pnpm dev:extension

Mỗi trình duyệt có bản build riêng. Chạy các lệnh này trong extension/:

Trình duyệt Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Sau đó build safari/dragoman.xcodeproj trong Xcode.

Kho mã là một pnpm workspace:

extension/
Tiện ích, xây dựng bằng WXT và Svelte
site/
Trang web này, xây dựng bằng SvelteKit
brand/
Các dragoman, logo và thành phố
messages/
Văn bản giao diện bằng 85 ngôn ngữ