用 kiss-translator 双语翻译扩展，三步搞定外文网页的双语对照阅读-平芜编程栈

用 kiss-translator 双语翻译扩展，三步搞定外文网页的双语对照阅读

【免费下载链接】kiss-translatorA simple, open source bilingual translation extension & Greasemonkey script (一个简约、开源的双语对照翻译扩展 & 油猴脚本)项目地址: https://gitcode.com/gh_mirrors/ki/kiss-translator

上周帮朋友调试一段英文技术文档，他全程在两个窗口之间来回切换：网页一段，谷歌翻译一段，再切回来对照。十分钟过去，文档才读了两屏。其实这种场景每天都在无数人身上发生——读外文资料最耗时的从来不是"看不懂"，而是"看一句切一次窗口"。

今天要介绍的 kiss-translator（中文名"简约翻译"）就是一个专治这个痛点的双语翻译扩展：它把整页外文直接翻译成中英对照显示，原文和译文并排呈现，不用复制粘贴，不用切换窗口。更难得的是它开源免费，支持 Chrome、Edge、Firefox，甚至 Android 的 Kiwi、iOS 的 Safari 和 Thunderbird 邮件客户端。下面我就用"完成一次真实翻译"的完整过程，带你从零上手。

第一步：选对安装姿势，十五分钟装好

kiss-translator 提供两种形态，先花十秒钟搞清楚区别，再决定装哪个：

安装方式	适用人群	优点	注意点
浏览器扩展	大多数用户（推荐）	功能完整：本地语言识别、右键菜单、跨域无忧	需要从应用商店安装
油猴脚本	不想装扩展、或使用 iOS Safari 的用户	轻量、随油猴管理器管理	会碰到跨域限制，需配置域名白名单

从项目设计来看，官方也明确建议优先用浏览器扩展，因为扩展版功能更全、踩坑更少；油猴脚本适合在扩展装不上的环境（比如部分 iOS 浏览器）里做补充。

对普通用户来说，安装就是打开 Chrome/Edge 应用商店或 Firefox 附加组件商店，搜索"kiss-translator"或"简约翻译"，点一下"添加到浏览器"即可，全程不需要任何命令行操作。

如果你恰好是开发者，想尝鲜最新代码，也可以自己构建一份开发版：

git clone https://gitcode.com/gh_mirrors/ki/kiss-translator cd kiss-translator pnpm install pnpm build:chrome

构建完成后，在浏览器的扩展管理页面打开"开发者模式"，加载解压后的扩展目录就能用。想构建 Firefox 版就把最后一条命令换成pnpm build:firefox，其它浏览器依此类推。

第二步：三次点击完成核心配置

装好后点击工具栏的翻译图标打开设置面板，你不需要逐项研究每个选项，只需要完成下面三个动作：

选翻译服务：默认的 Microsoft 和 Google 对绝大多数人够用——速度快、免费、不用填任何密钥。
确认语言：源语言保持"自动检测"，目标语言改成你的阅读语言（比如简体中文）。这两项基本是"设置一次，以后不用再管"。
记住三个快捷键：Alt+Q切换整页翻译、Alt+C循环切换译文样式、Alt+S打开翻译弹窗翻译选中的文字。

完成这三步，你的基础环境就绪了。下面这张图展示的就是它在技术文档页面的实际效果——右侧悬浮面板里可以看到服务、语言、样式等核心选项：

第三步：按下 Alt+Q，开始真正地"读"外文

在任意外文网页上按一下Alt+Q，整页内容会被翻译成目标语言，原文以你选择的样式（比如红色下划线）标注在译文下方，实现真正的双语对照阅读。

这里有三个值得了解的细节：

支持富文本翻译：翻译后的内容会尽量保留原文里的链接、加粗等样式，不会把一篇排版精美的文章翻成"纯文本墙"。
两种模式自动切换：绝大多数网站用"自动识别文本"模式就能翻译完整，不需要你写任何规则；遇到结构特殊的网站，才需要手动规则介入。
可以只看译文：如果你觉得双语对照太占版面，可以一键切换为"仅显示译文"，阅读体验接近原生中文网站。

以新闻资讯类网站为例，翻译开启后文章标题和正文会呈现为清晰的双语对照效果：

到这里，一个完整的"翻译-阅读"工作流已经跑通了。接下来是进阶部分——按你的实际使用场景，选择更顺手的翻译姿势。

进阶：按场景挑选你的翻译姿势

与其按"功能菜单"一条条介绍，不如按"你正在干什么"来选。下面七个场景基本覆盖了日常高频用法。

场景一：快速浏览技术文档——悬停翻译 + 词典

读文档最怕"打断"，鼠标悬停翻译就是为了不打断阅读流设计的：把鼠标移到不认识的段落上停一下，译文自动浮现，移开即消失，延迟时间可以在设置里调。配合内置的英文词典（划词后可以查词义、听发音），技术文档里的生词基本当场消化。

场景二：精读重点段落——划词翻译 + 多服务对比

遇到需要逐句理解的重点段落，选中文字会弹出翻译框。有意思的是，这个翻译框可以同时调用多个翻译服务做对比——同一句话微软翻一遍、谷歌翻一遍、DeepL 再翻一遍，语义拿不准时对照着看，比盲目相信单一引擎靠谱得多。相关交互实现位于 src/views/Selection/ 目录下。

场景三：固定读某个外文网站——写一条自动翻译规则

如果你每天都要刷某个英文资讯站，可以给它建一条"个人规则"：设定域名匹配条件后，这个网站每次打开都自动翻译，省去手动按Alt+Q。规则系统的优先级是个人规则 > 订阅规则 > 全局规则，全局规则相当于"兜底"，个人规则则针对特定网站定制。规则的核心逻辑在 src/config/rules.js 中。

场景四：表单和搜索框——输入框翻译

在外文网站的搜索框或表单里输入内容时，按Alt+I会立即把输入框内的文本翻译成目标语言，写完直接回车提交，不用先翻译再粘贴。遇到外语购票、填表、发邮件这类场景非常实用。

场景五：看视频学英语——YouTube 字幕双语翻译

这是很多用户入坑的原因之一。开启后，YouTube 视频字幕会被翻译并双语显示，而且项目内置了字幕合并与断句算法，能把机器识别出的一行行零碎字幕重新拼成完整句子再翻译，翻译质量明显好于"逐条字幕硬翻"。如果还想再进一步，可以开启 AI 断句功能。相关代码集中在 src/subtitle/ 模块。

场景六：接入你自己的 AI 接口——把翻译质量拉到新高度

如果你手上有 OpenAI、Gemini、Claude、DeepSeek 或本地部署的 Ollama，都可以作为翻译服务接入。更进阶的玩法是"自定义接口"：理论上任何翻译接口都能接进来，并支持流式传输（译文逐字显示）、AI 上下文记忆（AI 能记住前文，翻译长文更连贯）、聚合发送（多条文本合并成一次请求，省调用次数）以及 Hook 函数（自定义请求和响应处理逻辑）。接口层实现见 src/apis/，详细配置示例在 custom-api_v2.md。

场景七：多设备配置同步

在电脑上配好规则和样式后，可以通过 WebDAV 或自建的 KISS-Worker 服务把配置同步到手机浏览器上，规则、样式、收藏词汇、接口配置都能带过去，密钥类数据会加密存储。

避坑指南：四个高频问题，一问一答

结合项目常见问题，这里把最容易踩的四个坑提前讲清楚。

问题一：Ollama 等本地 AI 接口测试失败？

原因：kiss-translator 目前统一支持 OpenAI 兼容的接口地址，不支持 Ollama 的原生接口地址；另外很多本地服务默认禁止浏览器跨域访问。
对策：填接口地址时确认用的是 OpenAI 兼容端点；启动 Ollama 时添加环境变量OLLAMA_ORIGINS=*放开跨域限制。

问题二：油猴脚本版发不出翻译请求？

原因：油猴脚本受浏览器跨域策略限制，默认不允许向接口域名发请求。
对策：在油猴管理器的脚本设置里，把你使用的接口域名加入白名单。这也是官方建议优先用浏览器扩展的原因之一。

问题三：写了规则却不生效？

原因：多半是优先级理解反了，或者匹配条件写得太宽/太窄。
对策：记住"个人规则 > 订阅规则 > 全局规则"，先在设置页面的规则测试区验证匹配情况，再逐步收紧条件。

问题四：某个 AI 模型翻译总是报错？

原因：部分模型不支持"聚合翻译"批量参数，或者个别参数不兼容（比如某些版本的 Gemini 原生接口参数非常特殊）。
对策：在接口配置里禁用聚合翻译；参数不兼容时用 Hook 修改请求体，或改用 OpenAI 兼容的 Gemini2 接口。

效率提升：四个值得养成的使用习惯

配置对了只是第一步，真正拉开效率差距的是使用习惯：

把快捷键变成肌肉记忆：最常用的是Alt+Q（整页翻译）、Alt+S（翻译选中文字）、Alt+C（切换样式）、Alt+I（输入框翻译）。设置快捷键的入口在浏览器扩展管理页的快捷键设置处。
用订阅规则替代自己造轮子：社区维护着最新的订阅规则列表，直接订阅比自己从零写规则省事得多，遇到规则问题也可以去社区求助。
给不同网站配不同样式：新闻站用轻量的高亮样式，论文站用深色下划线样式，Alt+C一键轮换，不用反复进设置。
依赖本地缓存：重复打开同一页面时，缓存能帮你省下大量重复请求，翻过的文章二次阅读几乎秒开。