Skip to content

About

Edge 扩展:外文网页双语对照翻译,译文显示在原文下方,支持划词翻译,可接任意 OpenAI 兼容接口。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

双语对照翻译(Edge 扩展)

把网页里的非中文段落翻译成简体中文,译文显示在原文下方,保留原文方便对照。只做双语阅读这一件事,翻译请求直接发到你自己的 OpenAI 兼容 API。

翻译效果

功能

  • 只翻正文:用段落投票 + article/main 语义标签识别文章主体,自动跳过导航、侧栏、页脚(设置里可切整页)
  • 划词翻译:选中单词或句子,点旁边的「译」按钮,弹出译文小窗,支持一键复制、Esc 关闭
  • 整页翻译:标题、段落、列表、表格、引用,逐段在原文下方插入中文译文
  • 自动跳过:已经是中文的段落、代码块、输入框、隐藏元素、纯数字/URL
  • 一键开关:页面左侧贴边的小把手,点一下呼出面板再翻译;也支持 Alt + T
  • 动态内容:页面滚动加载的新段落会继续翻译(可关)
  • 批量请求 + 本地缓存:同一段文本只请求一次,重复翻译秒出
  • 视口优先:先翻当前屏幕内的内容,长页面不用等到底
  • 可选样式:淡色 / 同色 / 浅色高亮,字号可调
划词翻译 设置页 扩展弹窗
划词 设置 弹窗

安装

  1. 打开 Edge,地址栏输入 edge://extensions/
  2. 打开左下角「开发人员模式」
  3. 点「加载解压缩的扩展」,选择本目录(包含 manifest.json 的那一层)
  4. 扩展图标出现后,先打开设置页填 API Key

配置

点扩展图标 →「设置」,或右键扩展图标 →「选项」:

配置项 说明
Base URL OpenAI 兼容地址,默认 https://api.openai.com/v1,可换成你自己的中转/本地接口
API Key 你自己的 Key,只保存在本机 chrome.storage.local
模型 默认 gpt-4o-mini,可点「获取列表」读取接口支持的模型
翻译范围 只翻译正文(默认)/ 整页
每批段数 / 字符 默认 16 段 / 1600 字符
并发请求数 默认 2,接口限流时调成 1
译文样式 淡色(默认)/ 同色 / 浅色高亮
划词翻译 选中文本时是否显示「译」按钮
自动翻译 打开非中文页面时自动开始(默认关闭,会消耗额度)

填完点「测试连接」确认接口可用,再点「保存设置」。

使用

  • 整页:打开外语网页,点左侧边缘露出的「译」把手呼出面板,点「翻译本页」(或按 Alt + T);翻译完成后按钮变成「还原原文」,再点一次还原
  • 划词:用鼠标选中一段文字,点出现的「译」按钮,弹窗里可复制译文,按 Esc 或点空白处关闭

工作原理

  1. content script 先识别正文容器(段落投票 + 语义标签 + 链接密度过滤),再用 TreeWalker 把文本按块级祖先聚合成段落
  2. 过滤中文、代码、隐藏内容后按字符数和段数切批,每批用 <seg id="N">...</seg> 格式发给 background
  3. background 调 /chat/completions,温度 0.1;解析失败时自动降级为逐段翻译
  4. 译文插入原文元素之后(td/li/标题插入内部),样式用 !important 防止被站点覆盖
  5. 结果按 模型 + 文本 hash 缓存到 chrome.storage.local,最多保留 2500 条;划词翻译共用同一份缓存

翻译请求只发给你配置的接口,不经过任何第三方服务。

已知限制

  • 只处理文本块,不处理图片、PDF、视频字幕、输入框
  • 混合布局容器(同时有直接文本和块级子元素)里的一小段文字可能被跳过,宁可漏译不乱插
  • 正文识别是启发式的:极少数页面可能选错容器,可临时切到「整页」
  • 站点若用 !important 强行覆盖译文样式,可能需要调整 src/content.css
  • 翻译质量取决于所选模型;长文批量翻译偶发漏段时会自动逐段重试

发布

打包上传:

node tools/package.mjs

会生成两个包:

  • dist/bilingual-reader-<version>.zip:本地加载和 E2E 用,保留 manifest.key 固定扩展 ID
  • dist/bilingual-reader-<version>-store.zip:商店上传用,去掉了 manifest.key(Edge Add-ons 不接受该字段)

开发

# 纯函数单测(分段、中文检测、响应解析)
node tools/test-core.mjs

# 重新生成图标和商店 logo
node tools/make-icons.mjs

# 端到端测试:本地 mock API,不消耗真实额度
$env:ITZH_MOCK="1"; node tools/e2e.mjs

# 端到端测试:真实接口(Key、Base URL、模型都可通过环境变量指定)
$env:ITZH_TEST_KEY="sk-..."; node tools/e2e.mjs
$env:ITZH_TEST_KEY="sk-..."; $env:ITZH_BASE_URL="https://api.openai.com/v1"; $env:ITZH_MODEL="gpt-4o-mini"; node tools/e2e.mjs

# 测真实站点
$env:ITZH_TEST_KEY="sk-..."; $env:ITZH_URL="https://example.com/"; node tools/e2e.mjs

E2E 脚本在系统临时目录(%TEMP%)下使用独立浏览器配置,跑完自动清理,不影响日常 Edge。

目录

manifest.json          MV3 配置
src/config.js          默认配置
src/core.js            纯函数:分段、过滤、请求体、响应解析
src/background.js      API 调用、缓存、并发控制
src/content.js         正文识别、段落抽取、译文注入、划词翻译
src/content.css        译文样式
src/popup.*            扩展弹窗
src/options.*          设置页
icons/                 图标
docs/                  截图、商店素材
tools/                 图标生成、打包、单测、E2E

About

Edge 扩展:外文网页双语对照翻译,译文显示在原文下方,支持划词翻译,可接任意 OpenAI 兼容接口。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages