跳至主要內容

說明文件

安裝 dragoman、連接模型及維持運作所需的一切說明。

安裝

從瀏覽器的商店安裝 dragoman，之後就會自動保持最新版本。

Chrome Web Store Windows、Mac 與 Linux Microsoft Edge Add-ons Windows、Mac 與 Linux
Chrome、Edge、Helium 和其他 Chromium 瀏覽器
手動安裝發行版本

每個發行版本也都放在 GitHub 上，提供 Chromium 瀏覽器和 Firefox 用的 zip 檔，以及完整原始碼。手動載入的版本不會自動更新。

  1. 1 從最新版本下載 Chrome zip 檔並解壓縮。
  2. 2 開啟 helium://extensions（其他瀏覽器請開啟 chrome://extensions），然後開啟「開發人員模式」。
  3. 3 選擇「載入未封裝項目」，然後選取解壓縮後的資料夾。
開啟最新版本

將 dragoman 固定在工具列上，一鍵即可使用。

Android 版 Chrome 不支援擴充功能。在 Android 上請使用 Firefox。

翻譯第一個網頁

開啟任一網站，按一下 dragoman 圖示，選擇語言後點選「翻譯頁面」。也可以用鍵盤按 Alt+Shift+T（Mac 為 Option+Shift+T）。草稿會帶有金色虛線底線，模型潤飾完每個段落後底線便會消失。

AltShiftT / ⌥⇧T 翻譯網頁或顯示原文

翻譯後的網頁怎麼看

在你的裝置上草譯
麻糬目前被晉升為編輯在首長。
由你選擇的模型潤飾
麻糬後來還升上了總編輯。
原文隨時可看
將游標停在任一段落上，即可查看原文。按一下徽章或按 Alt+Shift+T，整個頁面就會還原。

在手機或平板上，請從瀏覽器的擴充功能選單開啟 dragoman。

與瀏覽器內建翻譯的比較

Chrome、Edge、Safari 和 Firefox 本身就能翻譯網頁，想快速看一眼時通常也夠用。dragoman 適合你想好好讀懂一個網頁的時候：意思和用字都準確到位，而且由你決定誰能看到這些文字。

通讀整個網頁

內建翻譯會把網頁切成小片段，逐一分開處理，所以同一個詞隔幾行就可能出現兩種譯法。dragoman 會讓你的 AI 模型看到網頁標題、各級標題和重複出現的詞句，讓人名、標籤或術語從頭到尾都維持同一種譯法。

逐段處理

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

綜觀整個網頁

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
示意：資訊框中重複出現的同一個希臘文標籤，翻譯成英文的結果。

文字去向由你決定

Chrome 或 Edge 翻譯網頁時，會把文字傳給 Google 或 Microsoft。dragoman 會先在你的裝置上草譯，再用你自己的金鑰，只把你正在閱讀的內容傳給你選的供應商。選擇僅在裝置上翻譯，網頁文字就完全不會外傳。

網頁文字的去向

Chrome Google Edge Microsoft dragoman 你的裝置 你的 AI 供應商 僅限你閱讀的內容，且須先加入模型
翻譯由你挑選
Chrome 用 Google 翻譯來翻譯網頁，Edge 則用 Microsoft Translator。dragoman 使用你選的 AI 模型，不論是 Claude、Gemini、ChatGPT 背後的模型，或在你自己電腦上執行的模型都行。現今的 AI 模型通常更能掌握慣用語、語氣，以及需要看上下文才知道意思的詞。
原文隨時可看
將游標移到任一段落上，或在手機上輕觸段落，就能看到原文，不必把整個網頁切換回去。

瀏覽器的翻譯器是內建的，免費又不用設定。dragoman 的裝置端草譯同樣免費，潤飾則只需支付供應商針對你閱讀內容所收的費用，用小型模型通常花費很少。Firefox 自己的翻譯器就是 Bergamot，也就是 dragoman 在 Firefox 中草譯所用的引擎，因此差別在於額外的 AI 潤飾和網頁脈絡。

技術細節
兩階段翻譯
瀏覽器的裝置端模型會在背景草譯；沒有內建模型時，則由編譯成 WebAssembly 的 Bergamot 補上。接著，畫面上和即將捲到的段落會分成小批次送到你的模型，每段潤飾完成後就會取代原本的草稿。
網頁脈絡
每次請求都會附上網頁標題、各級標題的大綱、網頁中反覆出現的詞句及其首次出現處的前後文，以及目前已確定的所有譯法。模型會回傳它選用的術語，之後的請求都會沿用。
標記
連結、強調和其他行內元素會以編號預留位置傳送，所以版面和連結都能完整保留。
只翻你讀的部分
潤飾會跟著可視範圍進行，所以再長的網頁也只會為你捲動瀏覽的部分付費。完成的翻譯會儲存在你的裝置上，下次回來時直接沿用。
沒有中間人
請求會用你的金鑰，從瀏覽器直接傳給你的服務供應商。dragoman 沒有自己的伺服器，所有程式碼也都公開。

裝置端翻譯

每個網頁都從你的裝置開始。dragoman 在 Chrome 和 Edge 中使用內建的裝置端模型草譯，在 Safari 中則使用 Apple 的模型。這些模型在你的電腦上執行，不像瀏覽器本身的網頁翻譯需要連網。在其他瀏覽器，或遇到這些模型不支援的語言時，則由 Firefox Translations 背後的開放引擎 Bergamot 直接在瀏覽器內草譯。這一切都不需要帳號或金鑰。單獨使用時，你就能得到快速又私密的翻譯；搭配 AI 模型時，這些草稿會成為初稿，再由你的模型潤飾。

每組語言只需下載一次

  • 英文 → 土耳其文 15 MB
  • 英文 → 德文 26 MB
  • 法文 → 英文 26 MB
  • 日文 → 英文 49 MB

法文 → 英文 → 德文

52 MB

兩種語言之間沒有直接對應的模型？dragoman 會經由英文轉譯，並下載兩段模型。

下載大小依據 Mozilla 模型登錄檔所列。
語言
支援 50 多種語言與英文互譯。若是兩種非英文語言之間的翻譯，dragoman 會以英文作為中繼。在語言清單中，標示為「僅限 AI」的語言需要 AI 模型才能翻譯。
首次使用
Chrome 和 Edge 會在你第一次需要時下載語言套件，Safari 則使用你裝置上為 Apple 翻譯下載的語言。Bergamot 的語言組合會從 Mozilla 下載一次，通常為 15 到 50 MB，並保存在瀏覽器中。之後就能完全離線使用。
草譯與潤飾
草譯速度快、偏向直譯，適合掌握大意。你的模型會參照整個網頁重寫，讓文字讀來自然，人名與用語也前後一致。
由你決定
即使已設定模型，若想讓網頁內容只留在你的裝置上，請在彈出式視窗中開啟「僅在這部裝置上」。若想略過草譯、直接等候模型的譯文，請到「設定」關閉「先在這部裝置上草譯」。

Bergamot 源自歐盟資助的研究計畫，其執行的語言模型由 Mozilla 負責訓練與發布。 關於 Bergamot

加入 AI 模型

從彈出式視窗開啟「設定」，選擇供應商並依照三個步驟操作。貼上金鑰後 dragoman 會立即檢查，並預先選好快速又平價的模型，你隨時都能更換。

可使用的服務供應商

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • 任何相容 OpenAI 的伺服器

OpenRouter 可以替你建立金鑰。選擇「透過 OpenRouter 連結」並核准請求即可。

未綁定工作區的 Anthropic 金鑰還需要提供工作區 ID。你可以在 Anthropic Console 的「設定」>「工作區」中找到。

使用本機模型

安裝 Ollama，下載 gemma3 等模型，並在設定 OLLAMA_ORIGINS 後啟動，讓它接受來自擴充功能的要求：

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

在 LM Studio 中載入模型，於伺服器設定開啟 CORS，然後啟動本機伺服器。dragoman 會在 localhost:1234 找到它。

費用

dragoman 完全免費。潤飾使用你自己的金鑰，費用由供應商直接向你收取。翻譯通常用小型、快速的模型就足夠了。「設定」中的「用量」分頁會按月統計各模型的 token 數；開啟「顯示每個網頁的費用」後，目前網頁的費用會顯示在徽章旁。

已潤飾 4/14 段

  • 已潤飾
  • 已草譯
  • 尚未處理

隨著你捲動，即將出現的段落會先快速草譯，畫面上的段落則會進一步潤飾。其餘部分在你讀到之前都不會耗用任何資源。

隱私權

會離開你電腦的內容：畫面上及即將捲到的段落，以及你請小幫手翻譯的文字，這些會傳給你選的供應商；另外，若瀏覽器本身無法翻譯某種語言，會從 Mozilla 下載一次模型。你的金鑰只會傳給它所屬的供應商。dragoman 沒有伺服器、沒有帳號，也不做分析。

閱讀完整隱私權政策

疑難排解

彈出式視窗顯示網頁無法翻譯

設定、擴充功能頁面和線上商店等瀏覽器頁面不允許擴充功能修改。請改開一般網站。

裝置端引擎不支援這組語言

裝置端翻譯器支援最常用的語言。在 Safari 中，你可以到裝置「語言與地區」設定的「翻譯語言」加入更多語言。其他語言，只要加入 AI 模型，dragoman 就會直接用它翻譯。

瀏覽器也跳出要翻譯網頁的提示

在瀏覽器可能會翻譯的網頁上，dragoman 會請它不要插手。如果你關閉了這項功能，請到「設定」的「語言」開啟「別讓瀏覽器的翻譯器來干擾」。如果瀏覽器已經翻譯了網頁，請選擇「改用 dragoman」，以原文重新載入。

本機模型無法連線

請確認伺服器正在執行，且「設定」中的位址正確。Ollama 需要設定 OLLAMA_ORIGINS，LM Studio 則需開啟 CORS。

dragoman 無法讀取網頁

Safari 和 Firefox 可讓你選擇擴充功能能讀取哪些網站。開啟 dragoman，選擇「在所有網站上允許」。

Firefox 沒有用我的模型潤飾

Firefox 會在擴充功能傳送網頁文字前先詢問你。開啟「設定」，在你的模型下方選擇「允許傳送網頁文字」。

從原始碼建置

dragoman 以 MIT 授權開放原始碼。建置時需要 Node 24 和 pnpm。

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

每種瀏覽器各有自己的建置版本。請在 extension/ 中執行：

Chromium 瀏覽器 pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 接著在 Xcode 中建置 safari/dragoman.xcodeproj。

這個存放庫是 pnpm 工作區：

extension/
擴充功能，使用 WXT 和 Svelte 建置
site/
本網站，使用 SvelteKit 建置
brand/
dragoman 人物、標誌與城市
messages/
85 種語言的介面文字
閱讀貢獻指南 瀏覽原始碼