wupage

项目概述

当你要把外语网页、PDF 课件或视频字幕一次翻成中文时，WuPage 提供了一套装进浏览器的做法：正文、图片、PDF 和字幕都在原页面里出译文，不用复制到另一个网站。它基于 Manifest V3，可装进 Edge、Chrome 和 Firefox；翻译服务既可选在线接口，也能用 Bergamot 在本地离线运行。设置、缓存与统计都留在当前浏览器，图片、视频画面和 PDF 文件不会上传给翻译服务。

项目	内容
宿主	Microsoft Edge、Google Chrome、Firefox
扩展清单	Manifest V3
当前版本	1.9.0
许可	GPL-3.0-only

一个扩展覆盖网页、PDF、图片和视频字幕四种翻译场景。

支持的宿主

• Microsoft Edge：支持商店安装，也可加载解压目录
• Google Chrome：与 Edge 共用 Chromium 构建，手动加载 wupage-<版本>-chrome.zip
• Firefox：需要 Firefox 154 或更新版本，发布包为未签名的测试 ZIP
• Chromium 系浏览器：可安装固定密钥签名的 wupage-<版本>-chromium.crx，扩展 ID 为 fgeedjpifhmkdehbgdmngbehdfcflblc

主要功能

• 网页全文：翻译正文、动态加载内容与嵌入框架，可一键恢复原文
• 段落翻译：桌面端按住 Ctrl 点击段落，触屏端点「点选段落」，再次点击恢复原文
• 双语对照：译文替换、原色对照（默认）、双色对照三种方式随时切换
• 划词查词：选中文字后查词典或翻译，输入框可翻译所选文字并一键替换
• 视频字幕：点播放器上的「译」翻译已有字幕，支持 SRT / VTT 导入与双语显示
• 暂停画面翻译：识别并翻译暂停画面的文字，需视频字幕、图片翻译与 OCR 模型
• 图片翻译：本机 OCR 识别后原位显示译文，图片本身不出设备
• PDF 阅读与导出：打开 PDF 自动翻译当前页附近内容，可编辑译文，导出图像版或可搜索版
• 翻译排除：按网站与 CSS 选择器保留指定区域原文
• 设置备份：导出 .toml 配置文件，改完选项后再导入

安装与启用

1. Edge：在扩展商店点「获取」，安装后固定到工具栏
2. Chrome 或 Edge 手动安装：下载 wupage-<版本>-chrome.zip 或 wupage-<版本>-edge.zip，解压后打开 chrome://extensions 开启开发人员模式，点「加载已解压的扩展程序」选择解压目录
3. Firefox：从 Firefox Add-ons 安装，或在 about:debugging 中临时加载 ZIP
4. 安装后刷新已打开的网页，点工具栏图标打开弹窗
5. 在「设置 → 翻译服务」选择服务并保存，再在弹窗里选中它
6. 需要图片或画面翻译时安装 OCR 模型，需要离线翻译时下载语言模型

权限与影响范围

• 页面读取：<all_urls> 主机权限用于抓取待翻译文本，翻译后可按设置恢复原文
• 后台与离屏：storage 保存设置与缓存，offscreen 承担 OCR 与 PDF 处理
• 快捷键：默认 Alt+Shift+Y 触发全文翻译，可在设置里改键或关闭
• 数据边界：在线服务只收到待翻译文字与凭据，图片、视频画面和 PDF 文件不上传
• 本地识别：OCR 在 ocr-sandbox.html 沙箱内运行，使用 PaddleOCR JS 0.4.2 与 onnxruntime-web 1.30.0
• 备份文件：.toml 默认不含密钥，超过 5 MiB 或格式损坏会被拒绝导入

注意事项

• 免费服务不稳：预置的 Microsoft、Google 等服务可能限流或改接口，失败时不会自动切换，需手动重试或换服务
• 模型体积：本地翻译模型每个语言方向约 35–55 MB，非英语互译可能需要经英语中转
• PDF 文本层：扫描版 PDF 没有文本层，无法直接翻译
• 字体安装：导出可搜索 PDF 需安装 Noto 完整字体包，导入时会校验文件大小与 SHA-256
• 字幕预取：字幕按语句翻译并提前批量处理约 45 秒内容，只能读屏幕实时字幕的网站无法预取