一个简约、开源的 双语对照翻译扩展 & 油猴脚本。
kiss-translator.webm
- 保持简约
- 开放源代码
- 适配常见浏览器
- Chrome/Edge
- Firefox
- Kiwi (Android)
- Orion (iOS)
- Safari
- Thunderbird
- 支持多种翻译服务
- Google/Microsoft
- Tencent/Volcengine
- OpenAI/Gemini/Claude/Ollama/DeepSeek/OpenRouter/OrcaRouter
- DeepL/DeepLX
- AzureAI/CloudflareAI
- Chrome浏览器内置AI翻译(BuiltinAI)
- 覆盖常见翻译场景
- 网页双语对照翻译
- 输入框翻译
- 通过快捷键立即将输入框内文本翻译成其他语言
- 划词翻译
- 任意页面打开翻译框，可用多种翻译服务对比翻译
- 英文词典翻译
- 收藏词汇
- 鼠标悬停翻译
- YouTube 字幕翻译
- 支持任意翻译服务对视频字幕进行翻译并双语显示
- 内置基础的字幕合并与断句算法，提升翻译效果
- 支持AI断句功能，可进一步提升翻译质量
- 自定义字幕样式
- 支持多样翻译效果
- 支持自动识别文本与手动规则两种模式
- 自动识别文本模式使得绝大部分网站无需编写规则也能翻译完整
- 手动规则模式，可以针对特定网站极致优化
- 自定义译文样式
- 支持富文本翻译及显示，能够尽量保留原文中的链接及其他文本样式
- 支持仅显示译文（隐藏原文）
- 支持自动识别文本与手动规则两种模式
- 翻译接口高级功能
- 通过自定义接口，理论上支持任何翻译接口
- 聚合批量发送翻译文本
- 支持流式传输，实时显示翻译结果
- 支持AI上下文会话记忆功能，提升翻译效果
- 自定义AI术语词典
- 所有接口均支持Hook和自定义参数等高级功能
- 跨客户端数据同步
- KISS-Worker（cloudflare/docker）
- WebDAV
- 自定义翻译规则
- 规则订阅/规则分享
- 自定义专业术语
- 自定义快捷键
Alt+Q开启翻译Alt+C切换样式Alt+K打开设置弹窗Alt+S打开翻译弹窗/翻译选中文字Alt+O打开设置页面Alt+I输入框翻译
注：基于以下原因，建议优先使用浏览器扩展
- 浏览器扩展的功能更完整（本地语言识别、右键菜单等）
- 油猴脚本会遇到更多使用上的问题（跨域问题、脚本冲突等）
- 浏览器扩展
- 油猴脚本
- Chrome/Edge/Firefox (Tampermonkey/Violentmonkey) 安装链接
- iOS Safari (Userscripts Safari) 安装链接
- 数据同步服务: https://github.com/fishjar/kiss-worker
- 可用于本项目的数据同步服务。
- 亦可用于分享个人的私有规则列表。
- 自己部署，自己管理，数据私有。
- 社区订阅规则: https://github.com/fishjar/kiss-rules
- 提供社区维护的，最新最全的订阅规则列表。
- 求助规则相关的问题。
在插件管理那里设置，例如：
- chrome chrome://extensions/shortcuts
- firefox about:addons
个人规则 > 订阅规则 > 全局规则
其中全局规则优先级最低，但非常重要，相当于兜底规则。
打开网页翻译面板，点击「编辑网站规则」。选择规则用途后点击「选取元素」，在网页上点击锁定元素；通过祖先路径调整层级，比较不同定位候选及匹配数量，点击「确认添加定位」加入草稿，最后点击主面板的「保存规则」保存。也可以通过「手动添加」输入 CSS 选择器。选取链接时不会跳转，右键可取消选取；副面板中的 ← / → 可按页面顺序浏览匹配元素。
- 支持翻译目标、排除区域、根容器、保留原文和段落边界。修改、删除、撤销和重做都只更新当前草稿及预览，点击「保存规则」后才写入本地并触发同步。
- 打开编辑器不会自动保存规则，也不会改变自动扫描设置。「自动扫描页面」启用时，目标选择器不是翻译白名单；需要严格指定目标时可选择「禁用」。删除一条定位不等于排除区域，其他规则或自动扫描仍可能覆盖它。
- 「恢复此组继承」重新使用订阅／全局值；「清空此组」将草稿中的该组设为显式空选择器。清空根容器后不扫描页面。
- 没有匹配的个人规则时，新规则的默认网站匹配与 popup 的「网域」一致，例如
www.bbc.com，可从下拉列表选择*.bbc.com等范围，也可输入自定义匹配规则。已有匹配的个人规则会直接载入编辑，保存时保留未修改的其他配置；已有hostname:规则仍兼容，订阅内容通过个人规则覆盖。 - 有未保存的草稿时，退出或重新读取规则会提示选择「保存规则」「不保存」或「继续编辑」。保存失败或检测到外部冲突会保留草稿；重新读取会替换草稿并清空撤销历史。页面路由变化时也会先提醒处理草稿，避免直接丢失修改。撤销历史仅保留在当前编辑会话。
- 「预计翻译范围」点击一次显示高亮，再次点击关闭，按钮会显示当前开关状态。范围预览使用草稿规则，只查看当前已加载 DOM，不发送翻译请求；内部排除项、保留项和后续语言／长度过滤仍然生效。「查看译文」会执行实际翻译。退出时应用已保存的规则，并恢复进入前的翻译和交互开关；未保存的预览修改不会留在页面上。
当前支持桌面普通 DOM 网页及其动态内容。iframe、Shadow DOM 内部、Canvas 文字和触屏专用操作暂未纳入可视化选取。油猴同源页面通过浏览器 Web Locks 协调写入；不同源页面共享的 GM 存储没有跨源原子事务保证，编辑器会在检测到外部变更时提示重新读取。
一般接口测试失败常见有以下几种原因：
- 地址填错了：
- 比如
Ollama有原生接口地址和Openai兼容的地址，本插件目前统一支持Openai兼容的地址，不支持Ollama原生接口地址
- 比如
- 某些AI模型不支持聚合翻译：
- 此种情况可以选择禁用聚合翻译或通过自定义接口的方式来使用。
- 或通过自定义接口的方式来使用，详情参考： 自定义接口示例文档
- 某些AI模型的参数不一致：
- 比如
Gemini原生接口参数非常不一致，部分版本的模型不支持某些参数会导致返回错误。 - 此种情况可以通过
Hook修改请求body,或者更换为Gemini2(Openai兼容的地址)
- 比如
- 服务器跨域限制访问，返回403错误：
- 比如
Ollama启动时须添加环境变量OLLAMA_ORIGINS=*, 参考：#174
- 比如
油猴脚本需要增加域名白名单，否则不能发出请求。
自定义接口功能非常强大、灵活，理论可以接入任何翻译接口。
示例参考： custom-api_v2.md
设置页面地址： https://fishjar.github.io/kiss-translator/options.html
本项目为业余开发，无严格时间表，欢迎社区共建。以下为初步设想的功能方向：
- 聚合发送文本：优化请求策略，减少翻译接口调用次数，提升性能。
- 增强富文本翻译：支持更复杂的页面结构和富文本内容的准确翻译。
- 强化自定义/AI 接口：支持流式传输、上下文记忆、多轮对话等高级 AI 功能。
- 英文词典备灾机制：当翻译服务失效时，可切换其他词典或 fallback 到本地词典查询。
- 优化 YouTube 字幕支持：改进流式字幕的合并与翻译体验，减少断句。
- 规则共建机制升级：引入更灵活的规则分享、版本管理与社区评审流程。
如果你对某个方向感兴趣，欢迎在 Issues 中讨论或提交 PR！
git clone https://github.com/fishjar/kiss-translator.git
cd kiss-translator
git checkout dev # 提交PR建议推送到dev分支
pnpm install
pnpm build// `toggle_translate` 切换翻译
// `toggle_styles` 切换样式
// `toggle_popup` 打开/关闭控制面板
// `toggle_transbox` 打开/关闭翻译弹窗
// `toggle_hover_node` 翻译鼠标悬停段落
// `input_translate` 翻译输入框
window.dispatchEvent(new CustomEvent("kiss_translator", {detail: { action: "toggle_translate" }}));- 加入 Telegram 群
ePhone AI
一个面向开发者的 AI 模型 API 中转与聚合平台，支持 OpenAI、Claude、Gemini、DeepSeek、GLM 等多家大模型。
