把网页里的非中文段落翻译成简体中文,译文显示在原文下方,保留原文方便对照。只做双语阅读这一件事,翻译请求直接发到你自己的 OpenAI 兼容 API。
- 只翻正文:用段落投票 +
article/main语义标签识别文章主体,自动跳过导航、侧栏、页脚(设置里可切整页) - 划词翻译:选中单词或句子,点旁边的「译」按钮,弹出译文小窗,支持一键复制、Esc 关闭
- 整页翻译:标题、段落、列表、表格、引用,逐段在原文下方插入中文译文
- 自动跳过:已经是中文的段落、代码块、输入框、隐藏元素、纯数字/URL
- 一键开关:页面左侧贴边的小把手,点一下呼出面板再翻译;也支持
Alt + T - 动态内容:页面滚动加载的新段落会继续翻译(可关)
- 批量请求 + 本地缓存:同一段文本只请求一次,重复翻译秒出
- 视口优先:先翻当前屏幕内的内容,长页面不用等到底
- 可选样式:淡色 / 同色 / 浅色高亮,字号可调
| 划词翻译 | 设置页 | 扩展弹窗 |
|---|---|---|
![]() |
![]() |
![]() |
- 打开 Edge,地址栏输入
edge://extensions/ - 打开左下角「开发人员模式」
- 点「加载解压缩的扩展」,选择本目录(包含
manifest.json的那一层) - 扩展图标出现后,先打开设置页填 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 或点空白处关闭
- content script 先识别正文容器(段落投票 + 语义标签 + 链接密度过滤),再用
TreeWalker把文本按块级祖先聚合成段落 - 过滤中文、代码、隐藏内容后按字符数和段数切批,每批用
<seg id="N">...</seg>格式发给 background - background 调
/chat/completions,温度 0.1;解析失败时自动降级为逐段翻译 - 译文插入原文元素之后(
td/li/标题插入内部),样式用!important防止被站点覆盖 - 结果按
模型 + 文本 hash缓存到chrome.storage.local,最多保留 2500 条;划词翻译共用同一份缓存
翻译请求只发给你配置的接口,不经过任何第三方服务。
- 只处理文本块,不处理图片、PDF、视频字幕、输入框
- 混合布局容器(同时有直接文本和块级子元素)里的一小段文字可能被跳过,宁可漏译不乱插
- 正文识别是启发式的:极少数页面可能选错容器,可临时切到「整页」
- 站点若用
!important强行覆盖译文样式,可能需要调整src/content.css - 翻译质量取决于所选模型;长文批量翻译偶发漏段时会自动逐段重试
- 商店素材与提交步骤见 docs/STORE.md
- 隐私政策见 PRIVACY.md
- 许可证:MIT(见 LICENSE)
打包上传:
node tools/package.mjs会生成两个包:
dist/bilingual-reader-<version>.zip:本地加载和 E2E 用,保留manifest.key固定扩展 IDdist/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.mjsE2E 脚本在系统临时目录(%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



