让浏览器用上本地翻译：translateLocally与Firefox/Chrome扩展集成实战教程

让浏览器用上本地翻译translateLocally与Firefox/Chrome扩展集成实战教程【免费下载链接】translateLocallyFast and secure translation on your local machine, powered by marian and Bergamot.项目地址: https://gitcode.com/gh_mirrors/tr/translateLocally还在用在线翻译插件担心网页文字被上传到云端本教程带你用本地机器翻译工具translateLocally打通 Firefox / Chrome 浏览器扩展只需 3 步完成设置即可让网页翻译在离线、免费、高速的环境中运行。翻译引擎基于 marian 与 Bergamot数据 100% 留在你的电脑上。translateLocally 是什么本地运行的机器翻译工具translateLocally是一款带图形界面的本地翻译工具支持 Windows、Linux 和 macOS提供三种使用方式图形界面GUI粘贴文本即可翻译支持词级对齐高亮命令行CLI批量翻译整个数据集支持管道串联多个模型Native Messaging 接口被浏览器扩展或其他本地程序调用 —— 这就是本文的主角。为什么选择本地翻译浏览器扩展关注点在线翻译translateLocally 本地翻译隐私文字发送到服务器数据完全留在本机费用可能限流或收费免费、无限制速度受网络状况影响本地推理延迟低离线不可用下载模型后完全离线可用浏览器扩展与 translateLocally 之间通过Native Messaging协议通信扩展把 JSON 格式的翻译请求写入本地程序的 stdin程序推理完成后把结果写回 stdout全程不需要开启任何网络服务。集成原理自动注册流程一次看懂translateLocally 在以 GUI 模式启动时会自动把自己注册为 Native Messaging host流程分三步读取已授权的扩展 ID 列表默认内置了 Firefox 翻译扩展的 ID见 src/settings/Settings.cpp按操作系统生成对应的 manifest 文件并写入本机程序路径浏览器启动扩展时读取 manifest即可拉起 translateLocally 进程通信。核心实现文件注册逻辑src/cli/NativeMsgManager.cpp消息协议定义src/cli/NativeMsgIface.h Firefox 与 Chromium 系浏览器对 manifest 的字段要求不同allowed_extensions与allowed_originstranslateLocally 会自动分别生成两份文件无需手动干预。Firefox 浏览器扩展一键配置步骤✅第 1 步安装并启动 translateLocally安装后正常打开图形界面一次即可 —— 自动注册只在此时触发随后程序可以退出。✅第 2 步安装 Firefox 翻译扩展在 Firefox 扩展商店中搜索并安装浏览器翻译扩展如 Firefox Translations。✅第 3 步选择本地翻译引擎打开扩展设置把翻译提供方translation provider切换为translateLocally然后访问任意外文网页即可看到本地翻译结果。Chrome 集成同样支持自动注册Chromium 系浏览器Chrome、Chromium 等同样被自动注册覆盖。以 Linux 为例manifest 的写入位置如下Firefox~/.mozilla/native-messaging-hosts/translatelocally.jsonChrome~/.config/google-chrome/NativeMessagingHosts/translatelocally.jsonChromium~/.config/chromium/NativeMessagingHosts/translatelocally.jsonWindows 下则通过注册表键指向配置文件Firefox 与 Chrome/Chromium 各一组。只要你的 Chrome 扩展 ID 在授权列表中使用流程与 Firefox 完全一致。准备工作先下载语言模型浏览器扩展只负责传话翻译能力取决于本地模型。打开 GUI 的Edit → Translator Settings → Languages即可下载模型也可以用命令行./translateLocally -a # 查看可下载模型 ./translateLocally -d en-es-tiny # 下载英文→西班牙文 tiny 模型tiny 模型体积小、速度快非常适合浏览器场景想要更高精度可选 base 模型。进阶开发你自己的浏览器扩展想让自己的扩展接入 translateLocally只需两步把你的扩展 ID 加入默认客户端列表写法参考 src/settings/Settings.cpp从源码重新编译以 GUI 模式启动一次程序会自动重新注册 manifest。扩展侧需要按 Native Messaging 格式收发 JSON 消息请求包含id、command、data三个字段目前支持Translate、ListModels、DownloadModel三个命令完整字段说明见 src/cli/NativeMsgIface.h。项目还附带一个 Python 异步客户端示例演示了消息长度前缀、并发请求、下载进度更新等细节照着它就能写出自己的扩展示例客户端scripts/native_client.py接口实现src/cli/NativeMsgIface.cpp⚠️ 注意入站消息有 10 MB 大小上限与 Firefox 的限制一致超长网页内容请分段发送。常见问题排查清单扩展里找不到 translateLocally 选项确认以 GUI 模式完整启动过一次命令行模式不会触发注册。翻译失败提示找不到模型先在 GUI 或 CLI 中下载对应语言对的模型再试。macOS 的 .app 版 CLI 读不了文件改用管道例如translateLocally.app/Contents/MacOS/translateLocally -m es-en-tiny input.txt output.txt。想添加更多模型来源在 Settings → Repositories 中添加自定义仓库默认支持 Bergamot也可添加 OpusMT 等仓库。总结让 Firefox / Chrome 用上translateLocally本地翻译只需 3 步启动 GUI 完成注册 → 安装浏览器扩展 → 在扩展设置中选择本地引擎再配上一个 tiny 语言模型就能获得隐私、免费、低延迟的网页翻译体验。无论是日常外文阅读还是开发自己的翻译插件这套基于 Native Messaging 的本地机器翻译方案都值得你动手试试。【免费下载链接】translateLocallyFast and secure translation on your local machine, powered by marian and Bergamot.项目地址: https://gitcode.com/gh_mirrors/tr/translateLocally创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考