企业官网建设流程全解析

双语对照翻译工具 kiss-translator 快速上手：从安装到进阶配置的完整指南

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

很多人在遇到外文网页时，第一反应往往是"复制、粘贴、打开翻译网站"。可一旦页面很长、术语很多，来回切换标签页核对原文和译文，效率低得让人想摔键盘。而今天要介绍的开源翻译工具kiss-translator，把"双语对照"这件事做到了极致：它直接嵌入浏览器，让译文显示在原文旁边，你甚至不需要离开正在阅读的页面。本文会带你从零走完安装、初始化配置、常用技巧和进阶玩法，读完之后就能立刻上手使用。

从一次"被迫切页"的阅读说起

想象这样一个场景：你正在读一篇英文技术博客，讲到某个框架的核心概念，三分钟之内你至少切换了五次标签页——原文一段、翻译网站一段、再看原文确认术语、再回去翻译……等终于读完，思路早就断了。

这个场景其实每天都在大量发生。数据上看，多数人阅读外文资料时，真正消耗在"来回对照"上的时间甚至超过了阅读本身。有没有一种方案，能让翻译结果直接"长"在原文旁边，看到哪里译到哪里？

kiss-translator 就是奔着这个需求来的：一个简约、开源的双语对照翻译扩展，同时提供油猴脚本版本，让不同习惯的用户都能找到适合自己的打开方式。

先认识它：一款"住在浏览器里"的翻译工具

与传统的在线翻译网页不同，kiss-translator 的定位很明确——翻译不该打断阅读。它支持 Chrome、Edge、Firefox、Safari 等主流浏览器，也能装进 Thunderbird 邮件客户端，覆盖了绝大部分人的日常使用场景。

值得留意的是它的两种形态：

• 浏览器扩展版：功能最完整，包含本地语言识别、右键菜单等增强能力，普通用户推荐优先选择。
• 油猴脚本版：轻量、免装扩展，适合脚本管理习惯成熟的老玩家，但在跨域请求上会受到一些限制。

简单说，如果你追求开箱即用、功能齐全，选扩展版准没错；如果你偏爱脚本生态，也有灵活的空间。

三步走：完成安装与第一轮配置

方式一：应用商店一键安装

在 Chrome 网上应用店或 Edge 扩展商店搜索"kiss-translator"（也叫"简约翻译"），点击添加到浏览器即可。全程不到一分钟，这是对新手最友好的路径。

方式二：手动构建开发版

如果你想尝鲜最新代码，可以自行构建：

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

构建完成后，在浏览器的扩展管理页开启"开发者模式"，再加载生成的扩展目录就好。其他浏览器也有对应的构建命令，按需替换即可。

打开面板后的第一次设置

安装完成后，点开工具栏的扩展图标，建议你按这个顺序完成初始化：

• 默认翻译服务：选一个常用的翻译引擎打底；
• 源语言：设为"自动检测"，省去手动选择的麻烦；
• 目标语言：填你的主要阅读语言；
• 快捷键：记住最常用的几个——Alt+Q切换翻译开关、Alt+S唤出翻译弹窗，另外还有Alt+I（输入框翻译）和Alt+C（循环切换样式）。

完成这三步，你已经可以开始享受双语阅读了。比如打开一条外文新闻，选中标题或正文，译文会立刻浮现在旁边，观感相当清爽：

六个实战技巧：把双语阅读的效率拉满

技巧一：划词翻译，选中即译

划词翻译是使用频率最高的模式。选中任意一段文本，翻译框自动弹出，你还能同时调用多个翻译服务对比结果，遇到生词可以直接查英文词典、加入收藏夹，方便日后复习。相关界面组件都集中在 src/views/Selection/，感兴趣可以翻翻。

技巧二：鼠标悬停，扫一眼就懂

浏览技术文档或资讯时，不想频繁选中文本，可以开启鼠标悬停翻译：指针在文字上停一下，翻译就出来了。悬停的触发延迟可以在设置里调整，建议新手从较短延迟起步，适应后再慢慢调。配置逻辑可参考 src/hooks/MouseHover.js。

技巧三：输入框翻译，边写边译

在搜索框、表单或聊天输入框里按Alt+I，就能把已输入的文本就地翻译。写英文邮件拿不准措辞时，这个功能相当救急。

技巧四：YouTube 字幕双语对照

看外语视频最怕字幕跟不上。kiss-translator 能自动识别视频字幕并生成双语对照，内置了字幕合并和断句算法，还支持用 AI 断句来提升翻译的连贯性——字幕爱好者应该会很爱这个功能。整套逻辑放在 src/subtitle/ 目录下，有兴趣可以深入研究。

技巧五：用规则系统让指定网站自动翻译

不想每次手动触发？规则系统就是为此设计的。规则分三层：

• 全局规则：兜底用的默认行为，优先级最低；
• 订阅规则：直接订阅社区维护好的规则列表；
• 个人规则：针对特定网站定制，优先级最高。

整体优先级是"个人规则 > 订阅规则 > 全局规则"。给常看的新闻站或文档站配一条"进入即翻译"的规则，之后的体验会顺畅很多。规则引擎的实现见 src/config/rules.js。

技巧六：样式随心定制，一键切换

译文显示成什么样，你说了算。字体、字号、颜色、背景透明度、双语排版比例都可以调整；设置多套样式后，用Alt+C就能在不同样式间快速轮换，阅读技术内容时换一套深色主题也是不错的选择。

技术类内容的翻译效果尤其能体现出双语对照的价值——左侧是代码与英文说明，右侧译文紧贴原文，对照起来一目了然：

翻译服务怎么选？从免费到 AI 一次配齐

kiss-translator 支持的翻译服务覆盖了几乎所有主流选择：

• 传统翻译：Google、Microsoft、百度、腾讯、火山翻译；
• 专业翻译：DeepL、DeepLX，欧洲语言翻译更精准；
• 主流 AI：OpenAI、Gemini、Claude、DeepSeek 等，擅长理解上下文；
• 本地 AI：Ollama，适合在意隐私、希望数据不出本机的用户。

给新手的选型建议很直白：日常浏览用微软或谷歌，免费且响应快；翻译论文或专业文档，优先 DeepL；内容复杂、需要连贯理解时，再上 AI 服务。所有服务的默认配置都能在 src/config/api.js 里看到。

如果你用的是 Ollama 这类本地服务，这里有个小技巧：启动时需要加上OLLAMA_ORIGINS=*环境变量，否则扩展连不上；另外部分模型不支持聚合翻译，遇到异常时记得在设置里关闭聚合功能。

更进一步，kiss-translator 还允许你接入完全自定义的翻译接口，理论上任何服务都能接进来。高级能力包括流式传输（结果边生成边显示）、上下文记忆、请求聚合发送，以及用 Hook 函数改写请求与响应逻辑。完整示例可以翻阅 custom-api_v2.md。

让配置跟着你走：同步与隐私

换台设备就要重新配一遍？不必。kiss-translator 提供三种同步方式：KISS-Worker 官方同步服务、任意 WebDAV 兼容存储，以及手动导入导出配置文件。同步的内容包括翻译规则、订阅列表、自定义样式、收藏词汇，还有加密存储的 API 密钥。

关于隐私，我的建议是：能放本地的数据尽量别上云，敏感内容优先考虑本地 AI 模型；API 密钥定期轮换，别在公共设备上保存。配置相关的逻辑集中在 src/config/ 和 src/libs/sync.js，想确认数据流向的读者可以自查。

常见问题快查

翻译不生效，怎么排查？按这个顺序检查：扩展是否启用、有没有访问当前网页的权限、设置面板里测试翻译服务连通性、最后看看是不是被规则排除了。

油猴脚本请求被拦截？这是脚本跨域权限导致的，需要在油猴设置里添加域名白名单；如果问题依旧，直接改用扩展版更省心。

感觉响应变慢了？可以适当调低最大翻译长度限制、确认本地缓存已开启，并定期清理缓存和冗余规则。

进阶玩法：从使用者到贡献者

用顺之后，你会发现这个项目的可玩性比想象中高。你可以为某个特定网站手写专属规则，把经验沉淀成规则文件分享给社区；也可以通过 Hook 机制给自定义接口加装自己的处理逻辑，实现"千人千面"的翻译体验。

作为开源项目，kiss-translator 欢迎任何形式的参与：遇到问题提交 Issue，贡献代码或文档，维护规则库，或者单纯在社区分享你的配置心得——每一样都在帮助这个工具变得更好。

结语：现在就开始你的双语阅读

回想文章开头的那个场景——如果你也能让译文直接出现在原文旁边，阅读外文资料就不再是一场"复制粘贴"的马拉松。kiss-translator 的价值正在于此：它把翻译从"额外步骤"变成了"阅读的一部分"。

别犹豫，按上面的三步装上它，配好默认服务，然后打开一篇你一直想读却迟迟没读的外文文章试试。你会很快发现，多语言阅读这件事，原来可以这么顺滑。

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