沉浸式翻译使用教程网页、PDF、字幕双语翻译一次装好【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate沉浸式翻译是一款双语网页翻译浏览器扩展装好后按一个快捷键当前页面就能变成原文译文上下排布PDF、Epub、字幕文件和网页输入框也都能翻。如果你经常读英文技术文档、论文或 GitHub 上的 README它省去了逐段选中、复制、粘贴到翻译站的麻烦。三步装好扩展离线加载 dist/chrome先说明一点这个仓库是扩展的发行版仓库README.md里写得很清楚它不包含源代码。所以不需要构建dist目录就是装好的成品。1. 拿到扩展目录git clone https://gitcode.com/GitHub_Trending/im/immersive-translate两个平台目录互相独立Chrome / Edge 用dist/chrome/Firefox 用dist/firefox/。2. 开发者模式加载地址栏输入chrome://extensionsEdge 是edge://extensions打开右上角开发者模式点加载已解压的扩展选中dist/chrome这个目录Firefox 走about:debugging→ 此 Firefox → 加载临时附加组件选中dist/firefox/manifest.json3. 验证是否生效点工具栏图标会弹出小窗对应dist/chrome/popup.html或者直接打开一个英文页面按 AltA。译文出现在正文下方、原文还在就说明装好了。快捷键速查表4 个 Alt 组合覆盖日常所有快捷键都定义在 dist/chrome/manifest.json 的commands字段里日常最常用的四个快捷键作用AltA当前页面翻译再按一次取消AltW整页翻译一次翻到页尾AltI翻译输入框里的内容AltS打开侧边翻译面板side-panel.html另外每个引擎都有独立入口比如translateWithOpenAI、translateWithDeepL、translateWithBing默认没绑定按键可以在浏览器的快捷键设置页里自己配。原理一次讲透双语显示、分段与本地识别引擎主体是dist/chrome/content_main.js一万六千多行干三件事文本提取。content_guard.js在 manifest 里以document_start时机、all_frames方式先注入打标记随后内容脚本按 DOM 结构把正文切成翻译块——列表、表格、代码块各有处理逻辑避免把一个段落拦腰截断。分块送译。切块完成后交给所选引擎。default_config.json里的immediateTranslationTextCount默认 4999控制立即翻译的字符阈值超出就走滚动触发的增量翻译长页面不会一次性打爆接口。双语渲染。译文以新节点的形式插在原文下方不覆盖原句样式放在styles/inject.css。这就是原文不丢效果的来源看 API 文档时可以对照术语。还有个容易被忽略的点dist/chrome/tesseract/里带了 Tesseract 的 OCR 运行时dist/chrome/wasm/下的ort-wasm-simd-threaded.wasm用于本地推理。图片里的文字识别和部分 AI 能力靠这两样在终端侧完成不一定要过云端。选翻译引擎和敏感信息脱敏在选项页options.html里可以给网页、输入框、图片分别指定引擎对应 dist/chrome/default_config.json 的字段translationService是主引擎默认binginputTranslationService、clientImageTranslationService设成inherit就跟随主引擎也可以单独指定userTranslationServices放自建的引擎前三个槽位对应 Custom1~3页面上有账号、邮箱、卡号这类内容时看sensitiveConfig.maskConfig手机号、银行卡号、支付信息、密码、邮箱都有开关且默认开启。翻译敏感页面前确认这些项是打开的送出去的内容会先被打码。进阶能力按需选PDF、Epub、字幕、图片PDFPDF 翻译模块 以独立标签页打开extension-entry.js负责把文件读成 blob 传给内置 iframe逐页双语渲染Epub样式在styles/epub.css配合在线阅读器站点使用视频字幕dist/chrome/video-subtitle/inject.js注入播放器页面字幕边播边换译文也可以提前整份预翻译图片文字dist/chrome/image/inject.js加 tesseract 做 OCR把图里的文字翻出来TXT选中即翻不需要单独模块Firefox 侧这些模块的文件名一一对应用法相同。排查 6 个点翻译不生效的检查清单权限Chrome 版声明了all_urls和file://匹配本地文件也能翻加载扩展后本地文件不生效检查扩展详情里的允许访问文件网址网络改写扩展用declarativeNetRequest重写请求头规则文件是dist/chrome/request_modifier_rule.json公司代理或安全网关可能拦这类请求引擎自建 key 报错时先切回内置引擎验证把问题隔离在网络和密钥上页面渲染时机单页应用内容晚出等页面稳定再按 AltA或用 AltW 强制整页翻控制台DevTools 的 Console 里过滤 immersive 相关报错key 过期、限流一般会直接给出原因脱敏配置maskConfig全开且文本很短时送出去的可能只剩空文本临时关掉对应开关再试常见问题两个浏览器版本差在哪为什么 manifest 不一样Chrome 版是 Manifest V3后台是一个 service workerbackground.js只有 55 行主要做消息中转Firefox 版是 Manifest V2用常驻后台脚本。核心逻辑两边一致这是 dist 下分两个目录的原因。没有扩展生态的浏览器怎么办仓库里有一份 userscript一万七千行配合油猴脚本管理器可用覆盖网页基础翻译。界面语言_locales/下有 28 套文案简中、繁中、日、韩、俄、阿拉伯语都有跟随浏览器语言自动切换。谁适合用从哪步入手日常看英文技术资料装 Chrome 版记熟 AltA之后再按需调引擎和脱敏开关有 PDF / 字幕需求装完直接开 PDF 模块或线上播放器页面试一次效果不达预期再去选项页换引擎Firefox 用户注意临时附加组件的特性升级新版本后要重新加载dist/firefox【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考