10 分钟把沉浸式翻译接上本地模型，断网也能双语翻译

10 分钟把沉浸式翻译接上本地模型，断网也能双语翻译

【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译， 鼠标悬停翻译， PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate

上周部门在机场酒店开会，会议室只有一根不稳定的共享线，而一份不能上传云端的客户合同要在会上逐条过。我把浏览器里的沉浸式翻译从云端引擎切到本地模型，断网状态下网页依旧出双语对照，合同过完，翻译服务一次没掉线。

本地模型跑通后你能得到什么

部署前环境自检

四项都满足后，先把项目代码拉到本地：

git clone https://gitcode.com/GitHub_Trending/im/immersive-translate

显卡那行是可选的：没有 CUDA 也能跑，只是整页长文会慢一些。

从落盘到第一条翻译的三步

第一步：把模型落盘到本地目录

1. 从官方模型库下载翻译模型：Qwen MT 约 2GB–8GB，Hunyuan-MT 约 3GB–10GB，按语言对挑一个
2. 解压到仓库下的 models/ 目录，下载时认准模型页给出的校验值，避免权重文件传坏
3. 最终目录结构如下

models/ ├── qwen-mt/ │ ├── config.json │ ├── pytorch_model.bin │ └── tokenizer.json └── hunyuan-mt/ └── ...

预期看到：每个模型子目录里 config.json、权重文件、tokenizer.json 三个文件齐全，少一个都加载不起来。

沉浸式翻译本地模型文件落盘目录结构

第二步：在选项界面指认本地模型

选项页对应项目里的 docs/options/index.html，在浏览器中操作：

1. 打开扩展管理页，找到"沉浸式翻译"点"选项"
2. 左侧导航选"高级设置"，滚动到"翻译引擎"部分
3. 引擎类型选"本地模型"，模型路径填上一步 models/ 下的对应目录
4. 选好目标语言对，点保存

预期看到：页面底部提示保存成功，引擎状态变成"本地模型已就绪"，不用重启浏览器。

沉浸式翻译选项页的本地模型配置区域

第三步：跑通第一条翻译

1. 打开任意一篇英文网页
2. 点击页面右下角的悬浮球，或按 Alt+A 开启整页翻译

预期看到：原文下方逐段出现中文对照，标题同步翻译，悬浮球会显示当前使用的引擎——确认它标的是本地模型而不是云端服务。这时把 Wi-Fi 断开再刷新一次，对照依旧生成，本地翻译链路就算跑通了。

本地模型驱动下的沉浸式翻译网页双语对照效果

翻译速度调优与高频故障速查

参数怎么调：内存档位对照

性能参数都在选项页"高级设置"里，核心是两个：单请求文本长度和并发请求数，按机器内存对照着改即可。

有独立显卡时顺手勾选"使用 GPU 加速"⚡，并把显卡驱动更新到最新版。

出错了先查这里

进阶与去向

本地模型跑通后，你拿到的是一条完全自控的离线翻译链路：敏感内容不出内网，速度只取决于自己的硬件。想进一步控制翻译风格，可以直接改 docs/options/options.js 中引擎配置段里的 temperature、max_tokens、top_p 三个参数，保存后重新打开网页即生效。整体安装方式与更新日志以 README.md 为准；后续版本还会陆续补上自动模型下载与更新、性能自动调优，以及更多轻量级模型的支持。

【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译， 鼠标悬停翻译， PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate