fishjar/kiss-translator

项目介绍

KISS Translator 为网页、输入框、划词与悬停文本以及 YouTube 字幕加上双语对照翻译，同时提供浏览器扩展和油猴脚本两种分发形式。翻译服务可以自己选：内置服务覆盖 Google、微软、百度、腾讯、DeepL 等传统接口，以及 OpenAI、Gemini、Claude、Ollama、DeepSeek、OpenRouter 等 AI 服务，非标准 API 可以通过外部接口插件接入。

扩展版功能更多：多服务横向对照窗口、词典查词与生词本、可视化网站规则编辑、TXT/Markdown/PDF/EPUB/图片的文档翻译，以及需要手动下载模型后在本机运行的本地 AI 能力。

快速使用

1. 从浏览器商店安装扩展：Chrome、Edge 或 Firefox。
2. 打开扩展设置中的「服务配置」，添加一个内置服务，填写 API 地址、API Key 和模型名称，点击「测试」确认后保存。
3. 在「场景设置」中为网页翻译、划词查词、输入框翻译或字幕翻译勾选对应服务。
4. 按 Alt+Q 或点击网页浮动图标开始翻译；按 Alt+D 打开独立对比窗口。

如果使用油猴脚本，需先安装 Tampermonkey 或 Violentmonkey，再安装主脚本或 iOS Safari 专用脚本。更多说明见项目站点。

使用约束

• 建议优先用扩展：油猴脚本缺少扩展专有 API、本地 AI、文件翻译和插件入口，且可能受跨域限制。
• 当前 dev 分支的新功能可能尚未同步到商店已发布版本；Safari 暂未支持。
• 本地 AI 依赖 WebGPU 等浏览器特性，推理速度和内存占用取决于设备与模型大小；使用前需先下载模型。
• 配置服务需要有效的 API 地址和密钥。内置 Ollama 适配使用 OpenAI 兼容协议而非 /api/chat，本机调用时可能需要处理跨域配置。
• 可视化规则编辑仅支持桌面端标准 DOM 页面，不支持 iframe、Shadow DOM、Canvas 文本和触屏手势。
• 配置同步需要借助独立的 KISS-Worker 或 WebDAV；插件授权保存在本机，同步到新设备后需重新授权。
• 项目使用 GPL-3.0 许可证。

开发方式

本地构建需要 Node.js >= 20（推荐 22/24）和 pnpm >= 9。执行 pnpm install 后运行 pnpm build:chrome 或 pnpm build:firefox，再把输出目录作为已解压扩展加载。pnpm start 可启动本地 Web 版调试。插件开发见独立的插件仓库文档。

HotRepo 点评

在 2026-11-11 的 JavaScript 日榜记录中，该项目星标数为 13,286，当天新增 19 星，位列第 11 名。单次快照只能说明当天上过榜，不能据此判断趋势；这个位置也反映出，一个把多种翻译服务和本地模型选项收进同一个扩展的工具，持续受到关注。