Kiss-Translator(简约翻译)：开源双语对照翻译工具，提供浏览器扩展与油猴脚本

一、Kiss-Translator是什么？

Kiss-Translator（简约翻译）是一款开源免费的翻译工具，以“极简设计”为核心，提供浏览器扩展与油猴脚本两种形式，支持网页双语对照、划词翻译、输入框翻译等全场景需求。其集成了Google、DeepL、OpenAI等数十种翻译服务，适配Chrome、Firefox、iOS/Android等多平台，通过自定义规则与数据同步功能，为用户提供高效、透明的翻译体验，适合学生、科研人员、跨境工作者等各类群体使用。

与传统翻译工具相比，Kiss-Translator的最大特点是“双语对照”——即翻译时保留原文与译文的并行显示，避免用户因“纯译文”丢失上下文信息；同时，它以开源为基础，代码完全公开，用户可自主验证安全性，也能通过二次开发适配个性化需求。

该工具提供两种形态：一是浏览器扩展（支持Chrome、Edge、Firefox等主流浏览器），二是油猴脚本（适配Tampermonkey等脚本管理器，可在更多客户端中运行）。无论是电脑端还是移动设备（如Android的Kiwi浏览器、iOS的Orion浏览器），用户都能通过简单配置实现高效翻译。

二、功能特色

Kiss-Translator的功能设计围绕“全场景覆盖”与“灵活自定义”展开，既满足基础翻译需求，又支持深度个性化配置，具体特色如下：

1. 多平台适配：覆盖主流浏览器与客户端

Kiss-Translator打破了平台限制，支持在多种浏览器和客户端中运行，具体适配情况如下表：

2. 多翻译服务集成：从传统翻译到AI模型全覆盖

为满足不同场景的翻译精度需求，Kiss-Translator集成了数十种翻译服务，涵盖传统机器翻译、AI大模型、厂商接口等类型，用户可根据需求切换，具体分类如下表：

3. 多样化翻译场景：覆盖网页、输入、视频等全场景

Kiss-Translator针对用户日常翻译的高频场景，设计了多种功能模式，满足不同需求：

• 网页双语对照翻译：这是核心功能之一。开启后，网页中的外文内容会在原文下方自动显示译文，保留排版格式（如链接、列表、表格），避免因翻译破坏网页结构。支持“仅显示译文”“原文在上译文在下”“左右分栏”等多种布局，适配不同阅读习惯。

• 划词翻译：鼠标选中任意文本后，会自动弹出翻译窗口，支持多服务对比（同时显示2-3种翻译结果）、英文词典查询（显示音标、词性、例句）、词汇收藏（可导出为Excel复习）。划词范围包括网页文本、PDF（浏览器内置预览）、电子书等。

• 输入框翻译：在网页输入框（如邮件、社交媒体评论、搜索框）中，可通过快捷键（默认Alt+T）快速将输入的文本翻译成目标语言，支持“源语言自动识别”与“目标语言固定”两种模式，适合跨境沟通时快速转换语言。

• 鼠标悬停翻译：针对短文本（如单词、短语），鼠标悬停即可显示译文，无需划词，适合快速阅读外文文章时的词汇理解。

• YouTube字幕翻译：自动识别YouTube视频的原文字幕，生成双语字幕（原文+译文），支持自定义字幕颜色、大小、位置，解决“字幕过小”“翻译不准确”等问题，同时支持无字幕视频的自动转录翻译（需配合AI服务）。

4. 灵活的翻译效果自定义

为适配不同网站的排版与用户偏好，Kiss-Translator提供了丰富的效果调整功能：

• 翻译规则自定义：支持手动添加规则（如指定“某网站仅翻译标题”“某域名不翻译”），也可订阅社区维护的规则库（kiss-rules项目），覆盖学术网站（如PubMed）、技术文档（如GitHub）、新闻平台（如NYT）等场景。

• 译文样式调整：可自定义译文的字体、颜色、背景色、行距，甚至设置“译文半透明”“hover时显示译文”等轻量化模式，避免翻译内容干扰原文阅读。

• 自动/手动切换模式：默认开启“自动识别翻译”（检测外文内容后自动触发），也可手动开关（快捷键Alt+Q），适合需要部分翻译的场景（如混合语言网页）。

5. 高级功能：提升翻译效率与个性化

• 数据同步：支持通过Kiss-Worker（私有部署服务）或WebDAV同步翻译设置、自定义规则、收藏词汇，实现多设备（如电脑、手机）间的配置统一。

• 批量翻译：针对长文本（如文档、邮件），可通过内置的“批量翻译框”一次性输入并翻译，支持导出为TXT/Markdown格式。

• AI上下文记忆：使用GPT、Gemini等大模型时，工具会自动保留上下文对话历史，让翻译更贴合语境（如长文档分段翻译时保持逻辑一致）。

• 快捷键操作：提供丰富的快捷键（可自定义），如Alt+Q开启/关闭翻译、Alt+K打开设置、Alt+L切换目标语言等，减少鼠标操作成本。

三、技术细节

Kiss-Translator基于前端技术栈开发，兼顾浏览器扩展与油猴脚本的兼容性，核心技术设计如下：

1. 技术栈与架构

• 核心框架：使用React+TypeScript开发，通过React Hooks（如useStorage用于本地存储与状态同步、useTranslation管理翻译服务调用）实现组件化开发，保证代码可维护性。

• 构建工具：采用npm/pnpm管理依赖，通过Vite打包优化，减小扩展/脚本体积（浏览器扩展包体积约1-2MB），提升加载速度。

• 多环境适配：针对浏览器扩展与油猴脚本的差异，设计了统一的接口层（如api/translator封装翻译服务调用、utils/platform判断运行环境），确保功能在不同形态下一致。

2. 浏览器扩展实现

• Manifest配置：适配浏览器扩展的Manifest V3标准（主流浏览器推荐），同时兼容Manifest V2（部分旧版浏览器），通过service_worker处理后台逻辑（如翻译请求、快捷键监听），content_scripts注入网页实现文本翻译与UI渲染。

• 权限管理：仅申请必要权限（如activeTab访问当前标签页、storage本地存储、scripting注入脚本），避免过度获取用户数据，符合浏览器安全规范。

3. 油猴脚本实现

• 脚本注入：通过油猴脚本的@match规则匹配目标网页，在页面加载后注入翻译逻辑，避免与网页原有JS冲突（通过沙箱隔离实现）。

• 跨域请求处理：由于浏览器跨域限制，油猴脚本通过“用户脚本代理”或“自建Worker服务”转发翻译请求，解决部分翻译接口的跨域问题。

4. 翻译服务集成方式

• 接口封装：为每种翻译服务编写适配层（如services/google.ts、services/openai.ts），统一输入输出格式（源语言、目标语言、文本、结果），便于用户切换服务时无需调整其他逻辑。

• 缓存机制：对近期翻译的文本进行本地缓存（默认保留7天），减少重复请求，提升响应速度并节省API调用次数（针对收费服务）。

5. 规则系统设计

• 规则引擎：采用JSON格式定义翻译规则（如{ "match": "*.github.com", "exclude": ".md", "mode": " bilingual" }），通过正则匹配网址、标签名、类名等，决定是否翻译及翻译模式。

• 社区规则同步：支持通过URL订阅社区规则库（如kiss-rules项目的GitHub Raw链接），自动更新规则，适配新网站的结构变化。

四、应用场景

Kiss-Translator的功能设计覆盖了多类用户的日常需求，典型应用场景如下：

1. 学生群体：外文学习与文献阅读

• 场景需求：阅读英文教材、学术论文时，需要快速理解内容，同时积累专业词汇。

• 工具应用：开启“网页双语对照”模式，原文与译文并行显示，避免频繁切换翻译软件；遇到陌生词汇时，划词翻译查看词典解释并收藏，后续导出复习；阅读PDF文献（浏览器预览）时，同样支持划词与双语对照。

2. 科研人员：技术文档与论文翻译

• 场景需求：查阅国际期刊（如Nature、Science）、技术文档（如GitHub、Stack Overflow）时，需要精准翻译专业术语，同时保持格式完整。

• 工具应用：订阅社区的“学术网站规则库”，自动适配文献排版；使用DeepL或GPT-4等高精度翻译服务，确保专业术语准确；通过“批量翻译”功能处理长论文摘要，快速生成中文版本。

3. 跨境工作者：跨语言沟通与内容处理

• 场景需求：与海外客户邮件沟通、在国际平台（如LinkedIn、Twitter）发布内容时，需要快速转换语言，确保表达准确。

• 工具应用：在邮件输入框中用Alt+T一键翻译草稿；划词翻译客户消息中的俚语或专业表达；发布社交媒体内容时，先翻译再调整，避免机器翻译的生硬感。

4. 视频创作者：YouTube学习与字幕处理

• 场景需求：观看YouTube教程、演讲时，需要清晰的双语字幕辅助理解，或提取字幕进行二次创作。

• 工具应用：开启“YouTube字幕翻译”，自定义字幕样式（如红色原文+灰色译文）；对无字幕视频，启用“AI转录翻译”生成双语字幕；通过划词翻译视频中的专业术语（如编程教程中的函数名）。

5. 普通用户：日常网页浏览与信息获取

• 场景需求：浏览外文新闻（如BBC、CNN）、海外购物网站（如Amazon）时，需要快速理解内容，无需逐句复制翻译。

• 工具应用：打开网页后自动触发双语对照，重点内容划词加深理解；在购物网站输入收货地址时，用输入框翻译快速转换为英文格式。

五、使用方法

Kiss-Translator提供两种使用形态（浏览器扩展、油猴脚本），操作流程简单，具体步骤如下：

1. 浏览器扩展安装与使用

步骤1：下载安装

• 打开浏览器应用商店（如Chrome网上应用店、Edge加载项商店、Firefox附加组件），搜索“Kiss-Translator”或“简约翻译”，点击“添加至浏览器”。

• 若无法访问官方商店，可从GitHub仓库的Releases页面下载扩展包（.crx或.xpi格式），在浏览器“扩展管理”中开启“开发者模式”，手动拖入安装。

步骤2：基础设置

• 点击浏览器工具栏中的Kiss-Translator图标，进入设置页面：

• 选择“目标语言”（默认中文）；

• 选择常用翻译服务（如DeepL、Google）；

• 配置翻译模式（默认“双语对照”）。

步骤3：核心操作

• 网页翻译：打开外文网页，点击工具栏图标或按Alt+Q开启翻译，原文下方自动显示译文；再次按Alt+Q关闭。

• 划词翻译：选中任意文本，弹出翻译窗口，可切换翻译服务、点击“收藏”按钮保存词汇。

• 输入框翻译：在输入框中输入文本后，按Alt+T一键翻译为目标语言。

2. 油猴脚本安装与使用

步骤1：安装油猴插件

• 在浏览器中安装脚本管理器（如Tampermonkey）：Chrome/Edge用户从应用商店下载，Firefox用户从附加组件商店下载。

步骤2：安装Kiss-Translator脚本

• 打开Greasy Fork网站，搜索“Kiss-Translator”，点击“安装此脚本”，在弹出的Tampermonkey界面中确认安装。

• 或直接访问GitHub仓库的脚本地址（https://github.com/fishjar/kiss-translator/raw/main/dist/kiss-translator.user.js），触发自动安装。

步骤3：使用方法

• 脚本安装后自动生效，操作方式与浏览器扩展一致：Alt+Q开启/关闭翻译，划词触发翻译窗口，输入框按Alt+T翻译。

• 点击浏览器工具栏中的Tampermonkey图标，选择“Kiss-Translator”可进入设置页面。

3. 高级功能配置

• 数据同步：在设置页面开启“同步”，选择“Kiss-Worker”（需自建服务）或“WebDAV”（如坚果云、Nextcloud），输入服务器地址与账号，即可同步配置与收藏。

• 自定义规则：进入“规则管理”页面，点击“添加规则”，输入网址匹配模式（如*.wikipedia.org）、翻译模式（如“仅翻译正文”），保存后立即生效。

• 快捷键修改：在“快捷键”设置中，可自定义Alt+Q（开关翻译）、Alt+K（打开设置）等操作的按键组合，避免与其他软件冲突。

六、常见问题解答（FAQ）

1. 翻译结果不准确或不生效怎么办？

• 检查是否选择了合适的翻译服务（如专业术语推荐DeepL或GPT-4，日常文本可用Google）；

• 确认网页是否被规则排除（进入“规则管理”查看是否有匹配的“不翻译”规则）；

• 尝试刷新网页或重启浏览器，部分网页JS冲突可能导致翻译失效。

2. 如何同步多设备的配置与收藏词汇？

• 推荐使用WebDAV同步：在“同步设置”中选择“WebDAV”，输入坚果云（个人免费）的服务器地址（如https://dav.jianguoyun.com/dav/）、账号密码，点击“同步”即可；

• 自建Kiss-Worker服务：部署代码到云服务器（参考项目文档），通过API地址实现同步，适合对隐私要求高的用户。

3. 支持Safari浏览器吗？

• 目前官方支持iOS的Orion浏览器（基于WebKit，兼容Chrome扩展），可安装浏览器扩展；

• Safari（macOS/iOS）可通过“Userscripts”插件安装油猴脚本版本，具体步骤参考项目Wiki的“Safari适配指南”。

4. 油猴脚本与浏览器扩展有什么区别？

5. YouTube字幕翻译不显示怎么办？

• 确认视频已开启字幕（点击YouTube播放器的“CC”按钮）；

• 进入Kiss-Translator设置，在“YouTube设置”中勾选“启用字幕翻译”，并选择目标语言；

• 若仍不生效，尝试切换翻译服务（如从“Google”改为“DeepL”），部分服务可能对字幕格式支持不佳。

6. 翻译服务提示“API密钥无效”如何解决？

• 部分服务（如OpenAI、DeepL API）需要用户自行提供API密钥：在“翻译服务”设置中，找到对应服务，输入从官方平台申请的密钥；

• 免费服务（如Google翻译、Bing翻译）无需密钥，若提示失效，可能是网络问题，可尝试切换网络或使用代理。

七、相关链接

• GitHub仓库：https://github.com/fishjar/kiss-translator

• 浏览器扩展下载：

• Chrome/Edge：https://chrome.google.com/webstore/detail/kiss-translator/

• Firefox：https://addons.mozilla.org/zh-CN/firefox/addon/kiss-translator/

• 油猴脚本：

• Greasy Fork：https://greasyfork.org/zh-CN/scripts/458892-kiss-translator

• 直接安装：https://github.com/fishjar/kiss-translator/raw/main/dist/kiss-translator.user.js

• 关联项目：

• kiss-worker（数据同步服务）：https://github.com/fishjar/kiss-worker

• kiss-rules（社区规则库）：https://github.com/fishjar/kiss-rules

八、总结

Kiss-Translator作为一款开源翻译工具，以“简约高效”为核心，通过浏览器扩展与油猴脚本两种形态，覆盖了网页双语对照、划词翻译、输入框翻译、YouTube字幕翻译等全场景需求。其集成的多类翻译服务与灵活的自定义功能，满足了不同用户的个性化需求，而开源特性则保证了代码透明与二次开发的可能性。无论是学生、科研人员还是普通用户，都能通过它快速解决跨语言阅读与沟通问题，是一款兼顾实用性与开放性的翻译解决方案。