简体中文 · English
网页双语阅读、划词查询与 AI 文本翻译。
选择自己的翻译服务，复用本地缓存，把值得记住的内容留下来。
开始使用 · 隐私与支持 · 反馈问题 · 欢迎 Star · 支持作者
TranslateFlow 是 Chrome Manifest V3 翻译扩展。你可以使用自己配置的 AI 服务、免费在线翻译，或设备支持的 Chrome 本地翻译，也可以导入本地词典。单词查词与句段／全文翻译分别选择方式，失败时保留你的选择，不会悄悄切换到付费 AI。
main 的源码版本与 manifest.json、package.json 一致；每次构建都会发布到 GitHub Release，其中附带可直接加载的 zip。下方功能介绍和截图都来自当前版本的实际扩展界面。商店（Chrome Web Store / Edge Add-ons）上架链接会在审核通过后补充；仓库的 Release 包未经商店签名，需要按「安装」一节以开发者模式加载。
| 功能 | 使用体验 |
|---|---|
| 网页双语阅读 | 对照原文阅读译文，保留链接和代码等结构；支持显隐、取消、重试与站点偏好。 |
| 划词查询与 AI 解读 | 选中文字查看译文或词典结果；需要理解、分析或用法时，再主动调用 AI。 |
| AI 文本翻译 | 从工具栏弹窗或悬浮球打开独立小窗，输入或粘贴文字，选择邮件、办公等场景，复制或继续调整译文。 |
| YouTube 字幕辅助 | 在有可用字幕的视频中使用双语、仅译文或原文模式，调整字号；依赖视频字幕及所选翻译方式就绪。 |
| 缓存与自动行为 | 按站点开启自动翻译或仅恢复已有译文；缓存恢复不为缺失内容自动发起翻译请求。 |
| 本地词典与学习中心 | 导入兼容词典，收藏词条、管理已启用的阅读记录，回顾保存的语境和结果。 |
本地词典查词
用户提供的实际使用截图，仅裁剪掉浏览器和背景页面。图中为《牛津高阶英汉双解词典》第10版的局部界面，正文及版式版权归相应权利人；这里仅用于说明本地导入后的显示效果，不提供该词典文件或下载授权，也不代表与出版方合作。发音按钮可见不代表已验证其音频资源，实际效果取决于导入文件与配套资源。
网页双语阅读
AI 文本翻译小窗
网页双语阅读与 AI 文本翻译图来自实际扩展界面，译文由本地 hy-mt2-7b 模型处理公开演示文字得到，不代表所有服务或模型的翻译效果；词典图中的释义来自所导入词典。
商店安装链接会在正式上线后补充。目前可从源码构建：
git clone https://github.com/CoderLambert/translateflow-plugin.git
cd translateflow-plugin
npm ci
npm run build:extension也可以直接下载 最新 Release 的 zip 并解压到固定目录，省去构建步骤。国内网络访问 GitHub 不畅时，用国内下载页（同一个包，内容与 Release 附件一致，可用 SHA256SUMS 校验）。
开发环境使用 Node.js >=24.21.0 <25、npm >=11.19.0 <12。
然后打开 chrome://extensions/，开启「开发者模式」，点击「加载已解压的扩展程序」，选择仓库内的 dist/extension/。
扩展不内置完整词典；没有 API Key 或词典也可以先查看设置和使用文档。不同翻译方式的准备要求见下文。
1. 选择翻译方式
在「设置 → 通用」分别选择「单词查词方式」与「句段与全文翻译方式」，点击 「保存翻译偏好」。
| 方式 | 需要准备什么 | 数据发送到哪里 |
|---|---|---|
| 自选 AI 服务 | 服务地址、准确模型名称和 API Key；本地兼容服务可按其要求允许空密钥与 HTTP。 | 直接发送给你配置的服务。云端可能收费；本地地址不保证服务不会再转发云端。 |
| 免费在线 | 明确同意发送待翻译文本；按提示完成服务访问准备。 | 所选服务；自动模式可能在候选服务间切换。网页接口可能失效或限流。 |
| Chrome 本地 | 浏览器、设备和语言对支持，并按提示准备模型资源。 | 可用时在设备上翻译；模型资源可能由 Chrome 下载。 |
| 本地词典 | 在「词典库」下载或导入有权使用的兼容词典，启用后将单词方式设为「词典」。 | 本地查询；单独点击 AI 功能才发送该操作需要的内容。 |
配置或安装新资源不会自动替换你已保存的翻译方式。聊天会员不等于 API 权限，使用 AI 前请确认相应服务的 API 可用性与费用。
2. 打开网页，得到第一份译文
在普通 HTTP/HTTPS 网页点击工具栏图标，选择「翻译当前页」；也可以在网页任意位置右键，选择「翻译或更新当前页面」，沿用已保存的翻译方式；还可以选中文字，点击出现的查询入口。首次访问新站点仍会先请求站点权限。更新扩展后，先刷新原来的网页。
可以用这篇公开阅读示例试用。Chrome 内部页、商店页等受保护页面无法注入页面翻译，可从工具栏打开独立的 AI 文本翻译窗口。
3. 按需要调整
- 只调整当前网站：在工具栏弹窗编辑本站偏好，点击「应用并翻译」；单词方式仍由全局设置管理。
- 翻译自己的文字：打开「AI 文本翻译」，选择语言、已有 AI 服务与场景，点击翻译或按
Ctrl/⌘ + Enter；Enter用于换行。 - 查词后继续理解：明确点击 AI 解读；本地词典结果与 AI 输出会分别标明来源。
- 想节省重复请求：开启本站「自动恢复缓存」；它只恢复命中，不自动补翻。
完整指引在「设置 → 使用文档」：按功能切换章节，包含首次配置、字幕、词典、学习中心、快捷键与问题排查；无需联网即可查阅。
支持 OpenAI、Anthropic、Gemini、DeepSeek，以及多种 OpenAI-compatible 服务；也可连接 Ollama、LM Studio 等兼容的本地或自托管服务。设置页提供平台预设，多连接可独立保存并选择默认服务。
TranslateFlow 是 BYOK 客户端：无需注册 TranslateFlow 账号，服务与凭据由用户在浏览器中自行配置。添加默认 AI 服务后，仍需在通用设置选择 AI 翻译方式并保存。
公开版不提供实验性的 ChatGPT 订阅本地连接。该功能仅面向独立开发版，不能将聊天订阅当作公开版 API 使用凭据。详见 AI 服务配置与开发版说明。
想在本地跑、又不把正文发到云端时，推荐用 LM Studio 加载 hy-mt2-7b（7B 级翻译模型，中英互译效果稳定）。在 LM Studio 中加载模型并启动本地服务后，扩展里按下图填写：
| 设置项 | 填写内容 |
|---|---|
| AI 平台 / 接口类型 | LM Studio / openai-chat（选择平台后自动带出） |
| 服务名称 / 连接标识 | 便于自己识别的名称，例如 hy-mt2-7b |
| 服务地址（Base URL） | 同一台机器填 http://127.0.0.1:1234/v1；扩展与 LM Studio 不在同一台机器时，改成那台机器的内网地址（例如 http://192.168.1.3:1234/v1） |
| 模型 | LM Studio 里显示的模型标识，例如 hy-mt2-7b |
| API Key | 留空即可；只有在 LM Studio 中为接口开启认证时才需要填 |
LM Studio 侧建议把 GPU 卸载层数拉满（GPU Offload），上下文（Context Length）给到 4K–8K，并发保持 1；需要跨机器访问时，必须先在 LM Studio 里显式开启局域网服务并放行端口。Temperature 可从 0.2 起试，最大输出 Token 按段落长度给足；这些参数对译文风格影响明显，以实际效果为准。
硬件参考（7B 模型，实际需求随量化方式、上下文长度和推理后端变化；hy-mt2-7b 本身约 7B 参数）：
| 硬件 | 建议 |
|---|---|
| 独显 6 GB 显存 | 可跑 4-bit 量化的短句翻译，长段落容易吃满显存，建议 8 GB 起步 |
| 独显 8 GB 显存 | 4-bit / 5-bit 量化较稳，日常网页段落翻译够用（推荐配置） |
| 独显 12–16 GB 显存 | 可用 6-bit / 8-bit 量化，长段落与更长上下文更从容 |
| 独显 24 GB 及以上 | 可跑 16-bit 精度，或同时保留更大上下文 |
| Apple Silicon（统一内存） | 16 GB 可跑 4-bit 量化，24 GB 及以上更顺畅；Metal 推理 |
| 纯 CPU 推理 | 8 核以上、16 GB 内存起步；速度显著慢于 GPU，适合短句和偶尔使用 |
模型文件本身：4-bit 量化约 4–5 GB，8-bit 约 7–8 GB，16-bit 约 14–15 GB；显存除权重外还要留出 KV 缓存和推理开销（通常再留 1–2 GB）。首次加载会占用几十秒，之后常驻内存即可。
注意：使用内网地址意味着待译文字会发送到那台机器，而不是留在本机；局域网内其他设备也可能访问该接口，请按自己的网络环境决定是否开启。
可按已有导入路径使用 TFLex、StarDict、MDX/MDD。词典库提供预检、进度、取消、启停、排序与删除；格式、编码和伴随资源的支持存在边界，不承诺任意第三方词典都能完整显示。
词典脚本不会执行，词典内的远程资源不会自动加载。大型词典通过用户主动下载或导入提供，不占用基础安装包。
学习中心区分阅读记录、生词本与最小复习。阅读记录需要单独启用；收藏、阅读数据和词典有各自的删除或导出入口。AI 文本小窗的草稿及最近 20 条结果仅保留在浏览器会话中，不会自动加入长期学习记录。
去哪里下载词典？
- FreeDict 官方下载：多语种开放词典，选择 StarDict 格式；每本词典的许可可能不同。
- WikDict 官方下载：基于维基词典的双语数据，使用 CC BY-SA 4.0；先确认所需语言对。
- MDX/MDD：设置页已有 ECDICT MDX 精选上游，可先核对其来源与限制；其他词典使用权利人允许在本阅读器使用的文件。公开论坛、网盘或“仅供学习”说明不能替代授权；不提供授权不明的商业词典下载推荐。
StarDict 下载包需先解压，再在「设置 → 词典库 → 本地导入」同时选择同名 .ifo、.idx、.dict / .dict.dz，以及随包提供的 .syn。MDX 则按提示连同匹配的 MDD、CSS 和本地资源一起导入。以上外部项目不代表所有包都已通过本扩展兼容性验证。
- 不内置广告、使用分析或向维护者自动发送诊断报告；在线翻译仍会把相应文字和必要上下文发送给所选服务。
- 设置、缓存、词典和学习数据分别保存在本机。API Key 保存在扩展本地存储中，不是额外加密的密码保险库。
- 普通网页访问权限用于启动划词、悬浮控件和已启用的翻译功能；访问权限本身不代表上传所有浏览内容。可在 Chrome 中限制站点访问。
- 右键菜单只在你主动点击后触发当前页翻译，不读取选中文字；是否允许访问某个站点仍由你控制。
- 自动恢复缓存不调用服务填补缺失；开启自动翻译则可能产生网络请求与相应服务费用。
- 可撤回免费在线同意、关闭站点自动行为、暂停阅读记录，并分别清理缓存、词典和学习数据。
中文隐私政策 · Privacy policy · 支持页面
政策、支持与第三方许可也可在「设置 → 关于」离线查看。外部服务的数据保留、收费与处理规则由其自身政策决定。
先查看扩展内的使用文档，或阅读帮助与恢复步骤。仍无法解决时，在 GitHub Issues说明版本、浏览器、功能入口、翻译方式、复现步骤与错误提示。
公开反馈前，请移除 API Key、私人网址、页面内容和未脱敏截图。不要通过卸载扩展或清空全部数据作为第一步排查。
生产构建使用 WXT；扩展页面使用 React，Content、Background、MAIN 和 Worker 保持各自的运行边界。开发和验收命令以仓库脚本为准：
npm run check
npm run typecheck
npm test
npm run test:unit
npm run build:extension浏览器验证使用隔离的临时配置和 mock 服务，不需要私人 API Key。npm run validate 组合静态检查、Node 测试、类型检查、Vitest 和构建，不包含浏览器 E2E。
TranslateFlow 由 CoderLambert 开发与维护，现已入驻爱发电。
爱发电主页：https://afdian.com/a/transflow
本仓库用于展示和维护 TranslateFlow；上面的爱发电主页由我本人运营，接受对项目持续开发、体验改进和日常维护的自愿支持。
扫码或点击链接会打开爱发电主页，请在平台确认金额和支持周期后再付款。赞赏完全自愿，不影响任何功能，也不包含第三方 AI 服务额度。使用、反馈问题或分享给朋友，同样是在支持这个项目。