WuPage完全指南:免费开源网页翻译浏览器扩展,支持Edge、Chrome与Firefox
WuPage完全指南:免费开源网页翻译浏览器扩展,支持Edge、Chrome与Firefox
WuPage 是一款免费开源的浏览器网页翻译扩展,适用于 Edge、Chrome 与 Firefox,可翻译整页内容、视频字幕、图片文字与 PDF 文档,支持双语对照、划词查词,还可选择本地模型离线翻译。本指南带你 5 分钟上手。
网页翻译扩展有哪些核心功能?
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 手动安装(无商店时):
- 从项目的 Releases 发布页下载最新版本的
chrome或edge压缩包并解压; - 打开
chrome://extensions或edge://extensions,开启「开发人员模式」; - 点击「加载已解压的扩展程序」,选择包含 manifest.json 的解压目录。
更新时用新版文件替换原目录内容,再到扩展管理页重新加载;安装或更新后记得刷新已打开的网页。想从源码构建,可克隆仓库后执行 npm ci && npm run build,详细流程见 docs/development.md。
自定义配色方案:六种内置主题随你换
WuPage 内置樱粉、晴蓝、素白、玫夜、深海、墨黑六套配色,支持明暗主题、自定义颜色与透明度调节:
在「设置 → 外观 → 配色与外观」中复制内置方案即可自定义;点击颜色旁的棋盘格按钮可调节该颜色的透明度,悬浮球透明度单独设置,修改后点「保存」生效。
隐私与数据:翻译扩展会不会上传内容?
- 翻译服务只接收待翻译文字及其所需凭据,图片、视频画面和 PDF 文件不上传给翻译服务;
- 默认 OCR 在本机识别,只有主动选择自定义 OCR 服务后,图片才会发送到指定地址;
- 设置、凭据、缓存和使用统计仅保存在当前浏览器,统计功能默认关闭;
- 弹窗中的「清除缓存」仅清理翻译结果,模型与字体需在各自入口删除。
完整说明见 PRIVACY.md。
常见问题快速排查
| 问题 | 处理方法 |
|---|---|
| 点击翻译无响应 | 安装或更新后刷新网页;浏览器内置页与商店受限页面无法翻译 |
| 服务报错或限流 | 检查网络、密钥与额度,在弹窗 Debug 面板查看原因后重试 |
| 部分内容未翻译 | 在「设置 → 翻译区域」用 CSS 选择器添加补译规则,例如 [role="dialog"] .field-label |
| 本地 PDF 无法打开 | 在扩展详情中开启文件访问权限,或直接在 PDF 工作区拖入文件 |
| 找不到功能入口 | 在「设置 → 外观 → 菜单功能」添加入口或恢复默认布局 |
写在最后
WuPage 原创代码采用 GPL-3.0 开源协议,免费用于个人与商业场景。更多资料:
- 版本变更记录:docs/releases/
- 开发指南与架构说明:docs/development.md
- 源码主入口:src/background/index.ts、src/content/index.ts
- 隐私政策:PRIVACY.md · 协议:LICENSE
遇到翻译不生效、排版异常等问题,建议反馈时附上浏览器与扩展版本、所用翻译服务,以及脱敏后的 Debug 错误信息,方便定位问题。

