WuPage完全指南:免费开源网页翻译浏览器扩展,支持Edge、Chrome与Firefox

原创2026-11-14 14:44:20212 阅读

WuPage完全指南:免费开源网页翻译浏览器扩展,支持Edge、Chrome与Firefox

WuPage 是一款免费开源的浏览器网页翻译扩展,适用于 Edge、Chrome 与 Firefox,可翻译整页内容、视频字幕、图片文字与 PDF 文档,支持双语对照、划词查词,还可选择本地模型离线翻译。本指南带你 5 分钟上手。

WuPage网页翻译扩展效果:日语原文与简体中文译文对照

网页翻译扩展有哪些核心功能?

WuPage 的界面默认跟随浏览器语言(支持简体中文与英文),核心能力一览:

功能 说明
网页全文翻译 覆盖正文、动态加载与嵌入内容,可一键恢复原文
双语显示 译文替换、原色对照(默认)、双色对照,随时切换
段落翻译 桌面端按住 Ctrl 点击段落,再点同段即恢复原文
视频字幕翻译 点击播放器上的「译」翻译已有字幕,支持 SRT / VTT 导入
暂停画面翻译 识别并翻译视频画面文字,需 OCR 模型或自定义 OCR 服务
图片翻译 开启后点击图片旁的「译」,原位显示译文
PDF 阅读与导出 双栏原译对照、译文可编辑,可导出图像版或可搜索文字版
划词翻译 选中文字即查词典与翻译,支持有道 / Bing 词典
自动翻译 按网站或页面语言自动翻译,默认关闭
快捷键 默认 Alt+Shift+Y 翻译全文,可自定义

安装前必看:翻译服务怎么配置?

在「设置 → 翻译服务」中配置并保存,再在弹窗里选择实际使用的服务:

服务 使用条件
Microsoft / Google / 腾讯 / Yandex / 火山 预置免费服务,无需密钥,也可切换为自备凭据的 API 模式
DeepL 填入 DeepL API Key,自动匹配 Free / Pro 地址
DeepSeek / Zhipu GLM 对应平台的 API Key 与模型
OpenAI / Anthropic 兼容 自定义地址、模型与提示词,可连接 Ollama 等本地接口
HTTP 模板 完全自定义请求地址、参数与响应路径
本地翻译(Bergamot) 下载语言模型后可离线翻译,每个语言方向约 35–55 MB

💡 免费服务可能受地区与限流影响;服务持续失败时需手动重试或切换,不会自动转发到其他服务。

各服务商的适配逻辑位于 src/background/providers/,消息协议定义在 src/shared/types.ts。

如何在 Edge、Chrome 与 Firefox 安装 WuPage?

Microsoft Edge / Firefox:直接在对应浏览器官方商店搜索 WuPage Translator 点击安装,装好后把它固定到工具栏。

Chrome / Edge 手动安装(无商店时):

  1. 从项目的 Releases 发布页下载最新版本的 chrome 或 edge 压缩包并解压;
  2. 打开 chrome://extensions 或 edge://extensions,开启「开发人员模式」;
  3. 点击「加载已解压的扩展程序」,选择包含 manifest.json 的解压目录。

更新时用新版文件替换原目录内容,再到扩展管理页重新加载;安装或更新后记得刷新已打开的网页。想从源码构建,可克隆仓库后执行 npm ci && npm run build,详细流程见 docs/development.md。

自定义配色方案:六种内置主题随你换

WuPage 内置樱粉、晴蓝、素白、玫夜、深海、墨黑六套配色,支持明暗主题、自定义颜色与透明度调节:

WuPage翻译扩展六种配色方案预览:浅色与深色主题

在「设置 → 外观 → 配色与外观」中复制内置方案即可自定义;点击颜色旁的棋盘格按钮可调节该颜色的透明度,悬浮球透明度单独设置,修改后点「保存」生效。

隐私与数据:翻译扩展会不会上传内容?

  • 翻译服务只接收待翻译文字及其所需凭据,图片、视频画面和 PDF 文件不上传给翻译服务;
  • 默认 OCR 在本机识别,只有主动选择自定义 OCR 服务后,图片才会发送到指定地址;
  • 设置、凭据、缓存和使用统计仅保存在当前浏览器,统计功能默认关闭;
  • 弹窗中的「清除缓存」仅清理翻译结果,模型与字体需在各自入口删除。

完整说明见 PRIVACY.md。

常见问题快速排查

问题 处理方法
点击翻译无响应 安装或更新后刷新网页;浏览器内置页与商店受限页面无法翻译
服务报错或限流 检查网络、密钥与额度,在弹窗 Debug 面板查看原因后重试
部分内容未翻译 在「设置 → 翻译区域」用 CSS 选择器添加补译规则,例如 [role="dialog"] .field-label
本地 PDF 无法打开 在扩展详情中开启文件访问权限,或直接在 PDF 工作区拖入文件
找不到功能入口 在「设置 → 外观 → 菜单功能」添加入口或恢复默认布局

写在最后

WuPage 原创代码采用 GPL-3.0 开源协议,免费用于个人与商业场景。更多资料:

遇到翻译不生效、排版异常等问题,建议反馈时附上浏览器与扩展版本、所用翻译服务,以及脱敏后的 Debug 错误信息,方便定位问题。

登录后查看全文
wupage