沉浸式翻译闪电版

连续按三次空格键即可将文本翻译到选定目标语言（支持多语言）

# 沉浸式翻译闪电版 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](https://makersuite.google.com/app/apikey) - 登录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