> KISS 原则 — Keep It Simple, Stupid

> 一款开源、免费、高度可定制的双语对照翻译工具，支持浏览器扩展和用户脚本，让翻译真正融入你的浏览体验

✨ 特性一览

• 🌐 网页双语对照 — 将任意网页翻译为双语对照模式，同时保留原文与译文
• 🖱️ 划词翻译 — 选中文本即显示翻译，支持悬浮窗和快捷键
• ⌨️ 输入框翻译 — 在任意文本框中通过快捷键（默认 Alt+Q）快速翻译并替换内容
• 🎬 YouTube 字幕翻译 — 实时翻译视频字幕，支持双语显示
• 🤖 多引擎支持 — 内置 Google、Microsoft、DeepL，并可接入 OpenAI、Gemini、Claude、Ollama、DeepSeek 等 AI 大模型
• 📚 术语词典 & 自定义规则 — 为特定域名或页面定制翻译规则，维护专业术语表，保证翻译一致性
• 🧠 AI 上下文记忆 — 支持对话式上下文理解，让 AI 翻译更加准确连贯
• 🔁 数据同步 — 通过自部署 KISS-Worker 或 WebDAV 同步配置、规则和词典
• 🎨 多种显示样式 — 可切换译文高亮、下划线、背景色等，支持夜间模式
• ⚙️ 高级自定义 — 支持 Hook、自定义请求参数，满足技术用户的所有需求

📦 安装方式

1️⃣ 浏览器扩展（推荐）

功能最完整，支持本地语言识别、右键菜单、快捷键管理，更新及时

2️⃣ 用户脚本（Greasemonkey / Tampermonkey / Violentmonkey）

适用于不支持扩展的浏览器，或需要轻量使用的场景。

• 直接安装：kiss-translator.user.js
• Greasy Fork：安装链接

🚀 快速上手

默认快捷键

> 你可以在浏览器扩展管理页面（如 chrome://extensions/shortcuts）自定义所有快捷键

基本操作

• 翻译整页：点击扩展图标或按 Alt+Q 即可。
• 划词翻译：选中任意文本，点击出现的悬浮按钮或按 Alt+T。
• 输入框翻译：在任意输入框中输入文本，按 Ctrl+Shift+Enter（可配置）即可翻译并填入
• YouTube 字幕：在 YouTube 视频页面，点击扩展图标开启“字幕翻译”即可。

⚙️ 配置与高级功能

翻译引擎

在设置中可以选择默认翻译引擎，并支持添加自定义引擎（如 OpenAI API）：

{
  "engine": "custom",
  "name": "DeepSeek",
  "apiUrl": "https://api.deepseek.com/v1/chat/completions",
  "apiKey": "your-api-key",
  "model": "deepseek-chat",
  "systemPrompt": "你是一个专业的翻译助手"
}

自定义规则

你可以为特定域名或页面编写翻译规则，例如：

• 忽略某些元素的翻译（ignore）
• 强制翻译某些区域（force）
• 替换特定词汇（replace）

术语词典

上传或在线编辑术语表，确保专有名词翻译统一。支持 JSON / CSV 格式

数据同步

• 自部署 KISS-Worker：使用 kiss-worker 搭建私有同步服务
• WebDAV：支持通过 Nextcloud、坚果云等 WebDAV 服务同步配置

🛠️ 开发者指南

本地构建

git clone https://github.com/fishjar/kiss-translator.git
cd kiss-translator
git checkout dev   # 开发分支
pnpm install
pnpm build

构建产物位于 dist/ 目录，可用于加载为未打包扩展。

贡献代码

• 提交 PR 请推送至 dev 分支
• 确保代码通过 ESLint 检查
• 如有新功能，请同时更新文档

外部触发

你可以通过自定义事件控制翻译行为，例如：

document.dispatchEvent(new CustomEvent('kiss-translator', {
  detail: { action: 'toggle' }
}));

支持的动作：toggle、enable、disable、translateSelection、translateInput 等

🌐 社区与生态

• 数据同步服务：kiss-worker
• 社区规则订阅：kiss-rules — 提供热门网站的翻译优化规则
• Telegram 交流群：加入群组
• 问题反馈：请前往 GitHub Issues

❓ 常见问题

A：可能原因：接口地址错误、模型不支持聚合翻译、参数不一致、跨域限制（如 Ollama 需设置 OLLAMA_ORIGINS=*）

A：需要在脚本的 @connect 列表中添加目标域名

A：使用 WebDAV 或 KISS-Worker 同步；也可手动导出设置面板中的 JSON 配置

A：支持几乎所有主流语言，具体取决于所选翻译引擎

📄 许可证

本项目采用 MIT License，自由使用和修改

🙏 致谢

感谢所有贡献者和用户的支持。如果你喜欢这个项目，欢迎 Star ⭐ 或分享给更多人！

保持简约，翻译自如

购买服务器

购买雨云服务器

云服务器、网站搭建、游戏云、对象存储、裸金属物理机