kiss-translator README

The project's README from github.com/fishjar/kiss-translator. As one markdown file: README.md.

KISS Translator 简约翻译

English | 中文 | 日本語 | 한국어

一个简约、开源的 双语对照翻译扩展 & 油猴脚本。

kiss-translator.webm

特性

安装

注：基于以下原因，建议优先使用浏览器扩展

  • 浏览器扩展的功能更完整（本地语言识别、右键菜单等）
  • 油猴脚本会遇到更多使用上的问题（跨域问题、脚本冲突等）

关联项目

常见问题

如何设置快捷键

在插件管理那里设置，例如：

规则设置的优先级是如何的

个人规则 > 订阅规则 > 全局规则

其中全局规则优先级最低，但非常重要，相当于兜底规则。

如何在网页上直接编辑规则

打开网页翻译面板，点击「编辑网站规则」。选择规则用途后点击「选取元素」，在网页上点击锁定元素；通过祖先路径调整层级，比较不同定位候选及匹配数量，点击「确认添加定位」加入草稿，最后点击主面板的「保存规则」保存。也可以通过「手动添加」输入 CSS 选择器。选取链接时不会跳转，右键可取消选取；副面板中的 ← / → 可按页面顺序浏览匹配元素。

当前支持桌面普通 DOM 网页及其动态内容。iframe、Shadow DOM 内部、Canvas 文字和触屏专用操作暂未纳入可视化选取。油猴同源页面通过浏览器 Web Locks 协调写入；不同源页面共享的 GM 存储没有跨源原子事务保证，编辑器会在检测到外部变更时提示重新读取。

接口（Ollama等）测试失败

一般接口测试失败常见有以下几种原因：

填写的接口在油猴脚本不能使用

油猴脚本需要增加域名白名单，否则不能发出请求。

如何设置自定义接口的hook函数

自定义接口功能非常强大、灵活，理论可以接入任何翻译接口。

示例参考： custom-api_v2.md

如何直接进入油猴脚本设置页面

设置页面地址： https://fishjar.github.io/kiss-translator/options.html

未来规划

本项目为业余开发，无严格时间表，欢迎社区共建。以下为初步设想的功能方向：

如果你对某个方向感兴趣，欢迎在 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" }}));

交流

赞赏

appreciate

赞助商


ePhone AI
一个面向开发者的 AI 模型 API 中转与聚合平台，支持 OpenAI、Claude、Gemini、DeepSeek、GLM 等多家大模型。

kiss-translator (fishjar/kiss-translator)

Searching Database…

12.9K ·GitHub
Kiss-translator
这是什么？KISS Translator 是一款开源的双语对照网页翻译工具，同时提供完整的浏览器扩展和 Greasemonkey/Tampermonkey 用户脚本两种形式，可以翻译网页、输入框、选中的文字以及 YouTube 字幕。
这是浏览器扩展、用户脚本，还是两者都是？两者都有。它提供适用于 Chrome/Edge、Firefox、Kiwi（Android）、Orion（iOS）和 Thunderbird 的完整浏览器扩展，也提供 Tampermonkey/Violentmonkey 用户脚本。README 推荐使用扩展版本，因为功能更完整，例如支持本地语言检测和右键菜单。
翻译引擎需要 API 密钥吗？这取决于你选择的服务。Google、Microsoft、Tencent 以及 Chrome 内置的 AI 翻译开箱即用，而 OpenAI、Gemini、Claude、Ollama、DeepSeek、DeepL 或 OpenRouter 等 AI 后端则需要你提供自己的 API 密钥或接口地址。
我应该用扩展还是用户脚本？有什么需要注意的地方吗？用户脚本版本更容易出现 CORS 错误和脚本冲突等问题，而且必须手动把每个翻译 API 的域名添加到白名单中才能正常工作。浏览器扩展基本避免了这些麻烦。
它支持翻译 YouTube 字幕吗？支持。它可以使用任何受支持的翻译服务生成双语视频字幕，并采用内置的字幕合并与断句算法（可选择借助 AI），同时支持自定义字幕样式。
我能为特定网站编写自定义翻译规则吗？可以。可视化编辑器允许你通过 CSS 选择器选取页面元素，如翻译目标、排除区域、根容器等，也可以手动添加选择器。规则可以分享，也可以订阅社区规则列表，个人规则的优先级始终高于订阅的规则和全局规则。
我能在同一页面比较多个翻译服务的结果吗？可以。你可以在任意页面打开翻译弹窗，将同一段文字发送给多个已配置的翻译服务，并把结果并排对比。
默认的键盘快捷键有什么作用？Alt+Q 切换网页翻译，Alt+C 切换显示样式，Alt+K 打开设置弹窗，Alt+S 打开翻译弹窗或翻译选中的文字，Alt+O 打开设置页面，Alt+I 翻译当前活动的输入框。
What are similar projects?github-chinese, video_vip, FluentRead, read-frog, chatGPTBox, return-youtube-dislike, integrity_baozi-, qiaomu-clipper
Which topics is it in?greasyfork, tampermonkey, translator, translate, userscript, bilingual, extension, subtitles, firefox-extension, youtube, cloudflare, chrome-extension
Creator
fishjar
Size
30 MB
Stars
12.9K
Updated
CommitOct 16Releasev2.1.1Oct 13
Age
3y
Commits · 90 Days