沉浸式翻译闪电版 Chrome 扩展

一个简单易用的Chrome扩展，通过连续按三次空格键来快速翻译输入框中的文本到选定目标语言。

功能特点

• 🚀 快速翻译: 连续按三次空格键即可翻译输入框内容
• ⌨️ 多重快捷键: 支持输入框翻译（三次空格）、页面段落翻译（Ctrl+Shift+L）和原位翻译（Ctrl+Q）
• 🔄 多语言支持: 支持翻译到中文、英文、日文、韩文、德文、法文、西班牙文或自定义语言
• 🌍 全页面支持: 支持所有网页的输入框、文本框和富文本编辑器
• 📄 智能段落提取: 自动识别并翻译页面中的文本段落
• 🔑 安全私密: API密钥本地存储，确保隐私安全
• ⚡ 实时响应: 基于Google Gemini API，翻译准确快速
• 🎨 现代界面: 美观的模态窗口和实时通知反馈

安装方法

方法一：开发者模式安装

1. 打开Chrome浏览器
2. 进入扩展管理页面 chrome://extensions/
3. 启用右上角的"开发者模式"
4. 点击"加载已解压的扩展程序"
5. 选择本项目文件夹

方法二：打包安装

1. 在扩展管理页面点击"打包扩展程序"
2. 选择项目文件夹并生成.crx文件
3. 将.crx文件拖拽到扩展管理页面安装

配置方法

1. 安装扩展后，点击浏览器工具栏中的扩展图标
2. 获取Gemini API密钥：
   • 访问 Google AI Studio
   • 登录Google账号
   • 创建新的API密钥（免费）
3. 在弹窗中输入API密钥并保存
4. 选择翻译方向（目标语言）和界面语言
5. 点击"测试连接"确认配置正确

使用方法

快捷键翻译输入框内容

1. 在任意网页的输入框中输入任意语言的文本
2. 连续快速按下三次空格键（需在500毫秒内完成）
3. 扩展会将文本翻译到预设的目标语言
4. 翻译结果会自动替换原文本

快捷键操作要点：

• ⏱️ 时间限制: 三次空格必须在500毫秒内连续按下
• 🎯 精确操作: 第三次空格会被自动拦截，不会在输入框中显示
• 🔄 实时反馈: 翻译过程中会显示进度通知
• ⚠️ 注意事项: 如果间隔超过500毫秒，计数器会重置

快捷键翻译页面段落内容

1. 在任意网页上按下 Ctrl+Shift+L（Windows）或 Cmd+Shift+L（Mac）
2. 扩展会自动提取页面中的段落内容
3. 在弹出的模态窗口中查看和翻译段落
4. 支持批量翻译、隐藏原文、自动翻译等功能

段落翻译功能：

• 📄 智能提取: 自动识别页面中的文本段落
• 🔄 批量翻译: 一键翻译所有段落内容
• 👁️ 显示控制: 可选择隐藏原文，仅显示翻译结果
• ⚡ 自动翻译: 开启后自动翻译新提取的段落
• 🎨 美观界面: 现代化的模态窗口设计

快捷键原位翻译页面内容

1. 在任意网页上按下 Ctrl+Q（Windows）或 Cmd+Q（Mac）
2. 扩展会自动识别页面中的所有文本元素并添加编号
3. 直接在原位置显示翻译结果，无需弹窗
4. 适合左手单手操作，提高翻译效率

原位翻译功能：

• 🎯 原位显示: 翻译结果直接替换原文，保持页面布局
• 🔢 智能编号: 为每个文本元素添加编号，便于跟踪翻译进度
• 👈 左手友好: Ctrl+Q组合键适合左手单手操作
• ⚡ 批量处理: 自动分批翻译所有页面文本元素
• 🔄 状态保护: 防止重复触发，确保翻译过程稳定

支持的输入框类型

• ✅ 标准input输入框
• ✅ textarea文本域
• ✅ 富文本编辑器（contentEditable）
• ✅ 各种在线编辑器（如Gmail、微信网页版等）

项目结构

Ex_translation/
├── manifest.json      # 扩展清单文件
├── content.js         # 内容脚本（核心功能）
├── popup.html         # 弹窗界面
├── popup.js           # 弹窗脚本
├── icons/             # 图标文件夹
│   ├── icon16.png     # 16x16图标
│   ├── icon48.png     # 48x48图标
│   └── icon128.png    # 128x128图标
└── README.md          # 说明文档

技术实现

• 监听机制: 使用事件委托监听所有输入框的键盘事件
• 翻译引擎: 基于Google Gemini 2.0 Flash API
• 语言检测: 通过正则表达式检测中文字符
• 用户体验: 实时通知反馈，支持动态页面元素

隐私说明

• API密钥仅存储在本地Chrome存储中
• 翻译请求直接发送到Google服务器
• 扩展不会收集或存储用户的翻译内容

常见问题

Q: 为什么要连续按三次空格？ A: 这是为了避免误触发，确保用户是有意进行翻译操作。三次空格的设计既不会干扰正常输入，又能快速触发翻译功能。

Q: 为什么有时候三次空格没有反应？ A: 请检查以下几点：

1. 三次空格是否在500毫秒内连续按下
2. 当前焦点是否在支持的输入框内
3. 输入框中是否有文本内容
4. API密钥是否正确配置

Q: Ctrl+Shift+L快捷键有什么用？ A: 这个快捷键用于打开段落翻译模态窗口，可以翻译整个页面的文本内容，适合阅读外语文章时使用。

Q: 支持哪些语言？ A: 支持翻译到中文、英文、日文、韩文、德文、法文、西班牙文，以及自定义语言。

Q: API密钥是否安全？ A: API密钥存储在Chrome的本地存储中，不会上传到任何服务器。

Q: 为什么翻译没有反应？ A: 请检查：

1. 是否正确设置了API密钥
2. 网络连接是否正常
3. 输入框是否包含有效文本
4. 是否在500ms内连续按下三次空格

开发者信息

这是一个开源项目，欢迎提交Issue和Pull Request来改进功能。

许可证

MIT License