外文网页读不快？用 kiss-translator 实现整页双语对照的完整指南
项目地址: https://gitcode.com/gh_mirrors/ki/kiss-translator 你是不是也这样：打开一篇英文资料，先复制到翻译网站，再切回网页对照着读，来回折腾几次，思路全断了？kiss-translator（简约翻译）就是为这个场景而生的开源双语对照翻译扩展，它直接在网页原文下方渲染译文，让你边看原文边读翻译，从安装到熟练使用只需几分钟。下文不堆概念，只讲"怎么用起来"——从认识它、装好它，到用四个高频痛点串起核心功能，再给出一份完整的配置示例和排障清单。
先搞清楚：它到底解决什么问题
一句话概括：一个保持简约、完全开源的双语对照翻译工具，同时提供浏览器扩展和油猴脚本两种形态。它适合这些朋友——
- 经常读外文技术文档、新闻资讯，想流畅阅读的普通用户
- 看外语视频、需要字幕辅助的学习者
- 有跨设备阅读需求、想让配置随身走的效率党
两种形态怎么选？我的建议很直接：优先用浏览器扩展。它功能更完整，自带本地语言识别和右键菜单，也避开了油猴脚本常见的跨域限制与脚本冲突。油猴脚本则适合不想装扩展、或使用受限环境的场景。两种版本覆盖 Chrome、Edge、Firefox、Kiwi、Orion 甚至 Thunderbird 邮件客户端，基本你手头有什么浏览器，它就能住进去。
🚀 装好它：最快的两步路径
普通用户最省事的方式，是直接去 Chrome 网上应用店、Edge 加载项商店或 Firefox 附加组件商店搜索"kiss-translator"或"简约翻译"，一键安装即可。想尝鲜开发版的朋友，也可以手动构建：
git clone https://gitcode.com/gh_mirrors/ki/kiss-translator
cd kiss-translator
pnpm install
pnpm build:chrome # 按目标浏览器换成 build:firefox、build:edge 等
构建完成后，在浏览器扩展管理页开启"开发者模式"，加载解压后的产物目录就行。装好后点击工具栏图标，建议先做三件事：把默认翻译服务选成顺手的那家、源语言设为"自动检测"、目标语言设成你的母语。到这里，基础环境就绪了。
🔍 四个高频痛点，逐个击破
痛点一：整页外文读起来太累，想要双语对照
这是 kiss-translator 最核心的看家本领。打开任意外文网页，按一下 Alt+Q，整页文本就地翻译，原文下方直接跟出译文，不用跳转、不用复制粘贴。默认的自动识别模式对绝大多数网站无需写任何规则就能翻译完整；遇到特殊站点，还可以手动规则模式做极致优化。再配合 Alt+C 切换译文样式、Alt+S 翻译选中文字，日常浏览基本键不离手。
痛点二：翻译结果不放心，想多个引擎对比
单一翻译服务偶尔翻得别扭，尤其遇到一词多义的句子。这时可以用划词翻译：选中任意文本，翻译框即时弹出，支持同时调用多个翻译服务对比结果，还内置英文词典查询和词汇收藏，很适合边读边查术语的学习场景。配置入口在设置面板的"接口"标签，默认已内置 Google、Microsoft、腾讯、火山、DeepL，以及 OpenAI、Gemini、Claude、DeepSeek 等主流 AI 服务，勾选即用，无需自己写配置。
痛点三：外语视频看不懂，字幕又没人翻译
看 YouTube 视频时，kiss-translator 会自动识别字幕并做双语显示，支持用任意已配置的翻译服务处理字幕。它内置字幕合并与断句算法，还支持 AI 断句，能明显减少断句生硬导致的翻译错乱；字幕样式也能自定义，不会被一排排译文破坏观影体验。相关实现集中在 src/subtitle/ 目录，感兴趣可以翻翻源码。
痛点四：专业术语翻得不准，想自己说了算
通用翻译服务处理领域术语往往力不从心，这时轮到规则系统登场。你可以为特定网站定制"翻译或忽略"的规则，也可以维护自定义专业术语表，让某个词固定使用你指定的译法。规则优先级是个人规则 > 订阅规则 > 全局规则，全局规则相当于兜底，订阅规则则能直接采用社区维护的最新规则列表。更进阶的需求（接入私有接口、流式传输、AI 上下文记忆、自定义 Hook）也都支持，理论上只要接口存在，就能接进来。
🛠️ 十分钟搭好专属翻译环境：一次完整配置示例
把前面几条串起来，走一遍完整的配置流程：
- 装好扩展后，在设置面板把默认翻译服务设为微软翻译（响应快、免费，日常够用）。
- 将源语言设为"自动检测"，目标语言设为简体中文。
- 在"快捷键"页确认
Alt+Q、Alt+S等默认键位生效，顺手记在便签上。 - 打开一个常读的外文技术网站，按
Alt+Q验证整页双语对照效果，再用Alt+C挑一个不刺眼的译文样式。 - 阅读中遇到拿不准的句子，选中它用划词翻译调出第二引擎对比。
- 若某个词总被翻错，去"术语"设置里添加自定义译法。
- 最后，在"同步"页配置 WebDAV 或 KISS-Worker，让这套配置在多台设备间保持一致。
全程基本是点选操作，只有第 4 步需要观察实际效果稍作微调，整套下来十分钟以内就能搞定。
📌 遇到问题别慌：一份快速排障清单
- 翻译没反应？ 先确认扩展已启用、当前站点没有被规则排除，再检查设置面板里接口连接是否正常。
- Ollama 等本地服务测试失败？ 本工具统一走 OpenAI 兼容地址，不支持 Ollama 原生接口；同时给 Ollama 启动加上
OLLAMA_ORIGINS=*环境变量，可绕开跨域 403。若模型不支持聚合翻译，记得在接口配置里禁用聚合功能。 - 油猴脚本调不了接口？ 需要在脚本设置里把目标域名加入白名单，否则请求会被拦下。
- 想换快捷键？ 浏览器扩展的快捷键在扩展管理页面单独设置，Chrome 可在
chrome://extensions/shortcuts调整。 - 译文样式看着累？ 试试"仅显示译文"模式，或自定义一套背景、字体与配色。
💡 让效率再高一截的四个小习惯
- 悬停翻译用起来：鼠标悬停即出译文，适合快速扫读资讯标题和摘要，阅读节奏完全不被打断。
- 输入框翻译救急：
Alt+I直接把输入框里已写好的文本翻成目标语言，写邮件、填表单都顺手。 - 开着缓存更省心：常用页面的翻译结果会被缓存，二次访问几乎瞬时呈现，还能减少接口调用。
- 定期导出配置：样式、规则、术语都能导出备份，换设备时一键恢复，不怕配置丢失。
动手试试，让外文阅读回归"读"本身
从安装到熟练使用，kiss-translator 的学习曲线比你想的平缓得多。它想做的事情很纯粹：把"翻译"从打断阅读的动作，变成阅读的一部分。打开你的外文收藏夹，装上它，按一下 Alt+Q，剩下的交给习惯就好。想深入了解规则写法或自定义接口，官方文档（README.md、custom-api_v2.md）和各模块源码（src/config/、src/apis/）都是现成的参考；项目保持开源，也欢迎你随时参与共建。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
