跳到正文

文档

安装 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 压缩包并解压。
  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 没有服务器，所有代码均公开。

本设备翻译

每个页面都先在你的设备上处理。在 Chrome 和 Edge 中，dragoman 使用其内置的设备端模型初译，在 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 种语言的界面文本
阅读贡献指南 浏览源代码