企业官网建设流程全解析

沉浸式翻译四步上手：在任意网页、PDF 和字幕里开启双语显示

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

沉浸式翻译（Immersive Translate）是一款浏览器扩展，主打网页双语翻译：原文保留不动，译文以另一行颜色显示在下方。除了网页，它还能处理 PDF、Epub 电子书、视频字幕、TXT 和图片里的文字。适合经常读英文文档、论文、代码库和海外视频的用户，也适合想参考浏览器扩展工程结构的开发者。

第一步：选对渠道安装

大多数用户走扩展商店即可，自动更新、兼容性最有保障。如果你手上有dist目录里的构建产物，也可以手动加载：

1. 打开浏览器扩展管理页（Chrome 是chrome://extensions，Firefox 是about:debugging或about:addons）
2. 打开"开发者模式"
3. 选择"加载已解压的扩展"，指向dist/chrome（Firefox 用户指向dist/firefox）
4. 回到目标网页，点图标或按快捷键开始翻译

两条路径的差别在 Chrome 扩展配置 和 Firefox 扩展配置 里看得很清楚：Chrome 侧manifest_version是 3，后台是一个按需激活的 Service Worker（可理解为"有事件才醒的后台脚本"，闲置即释放内存）；Firefox 侧仍是 2，后台是常驻的传统 Background Script。两边版本号一致，说明同一套功能逻辑在两种机制下各发一份，某个浏览器升级扩展标准时只需要动对应那半边。

不想装扩展？仓库里的 油猴脚本 走的是另一条路：配合 Tampermonkey/Violentmonkey 安装后，用 GM API 提供的存储和跨域请求能力复刻主要功能，还能跟随脚本地址自动更新。

第二步：认清它到底能翻什么

装好之后，它的覆盖范围比"网页翻译器"宽不少：

• 网页双语显示：整页或选中文本，原文下挂译文，不破坏排版。代码块、列表、表格这类结构不会被整段吞掉
• PDF：有独立的翻译界面（见 PDF 翻译入口），按页提取文字再叠双语，扫描件还依赖 Tesseract 做 OCR（包在dist/chrome/tesseract/里）
• 视频字幕：由 字幕注入脚本 接管页面字幕流，支持翻译后的实时字幕
• 输入框翻译：在搜索框、表单里输入时实时给出译文，快捷键Alt+I
• 图片文字：dist/chrome/image/inject.js负责识别并翻译页面图片中的文字

页面里最重的活儿集中在 翻译引擎主文件，这个文件在当前版本超过 1.6 万行，负责从 DOM 里抽取文本、切分成合理的翻译单元、发起请求再渲染回去。它和一份 默认配置 配套——默认行为（每次翻译多少句、滚屏翻译的启动时机、默认用哪家服务）都写在这个 JSON 里，理解它比翻源码更快。

第三步：快捷键与引擎，按自己的习惯调

扩展预置了一组命令（两个浏览器的 manifest 里commands段一致），最常用的是：

引擎选择上，配置里暴露了 Google、DeepL、Bing、Transmart，以及 OpenAI、Claude、Gemini 等 AI 模型，还有 3 个自定义槽位可以填自己的 API 端点。按内容类型选会更省心：

• 技术文档、API 说明：DeepL 或 Google，术语处理稳、速度快
• 长文、文学性内容：AI 模型上下文更好，风格更连贯
• 敏感数据或特定术语：填私有端点，请求不出内网

翻译结果有本地缓存，相同内容第二次翻译直接读缓存，不再发请求。常翻同一个站点的话，缓存带来的提速比换引擎更明显。

第四步：不出翻译时，按这个顺序查

1. 网络：先确认浏览器能否直连所选引擎的域名，公司网络或代理环境下经常卡在这
2. 页面结构：重度依赖前端框架动态渲染的页面，可能让文本抽取拿到空壳。刷新后稍等一两秒再触发，或换用"整页翻译"而不是自动模式
3. 控制台：打开开发者工具的 Console，扩展的报错大多以 API 密钥失效、频率超限、超时三类出现，按提示处理即可
4. 配置：到 选项页面 对照 默认配置 逐项检查，改过自定义端点时重点看请求头和服务地址是否抄错

调试大页面时还可以观察 Service Worker 的生命周期（chrome://extensions里的 "Inspect views: service worker"），确认后台脚本正常拉起而不是处于挂起状态。

最后：谁可以用上，谁可以参与

这个仓库发布的是各浏览器的编译产物而非源码，沉浸式翻译本体不开源——旧版开源项目 2023 年 1 月已归档，README 里有说明。所以"参与"主要是三件事：在 Issues 里反馈问题、对照dist下的工程结构学习 V2/V3 双版本扩展怎么组织、或者基于油猴脚本改出自己的轻量版。方向上，V3 后台机制会继续向 Firefox 侧收敛，多设备配置同步和更多引擎端点也是已见雏形的路标。装上一个、把快捷键用上，剩下的配置都是顺手的事。

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