Description from extension meta
连续按三次空格键即可将文本翻译到选定目标语言(支持多语言)
Image from store
Description from store
# 沉浸式翻译闪电版 Chrome 扩展
一个简单易用的Chrome扩展,通过连续按三次空格键来快速翻译输入框中的文本到选定目标语言。
## 功能特点
- 🚀 **快速翻译**: 连续按三次空格键即可翻译输入框内容
- ⌨️ **双重快捷键**: 支持输入框翻译(三次空格)和页面段落翻译(Ctrl+Shift+L)
- 🔄 **多语言支持**: 支持翻译到中文、英文、日文、韩文、德文、法文、西班牙文或自定义语言
- 🌍 **全页面支持**: 支持所有网页的输入框、文本框和富文本编辑器
- 📄 **智能段落提取**: 自动识别并翻译页面中的文本段落
- 🔑 **安全私密**: 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. 支持批量翻译、隐藏原文、自动翻译等功能
**段落翻译功能:**
- 📄 **智能提取**: 自动识别页面中的文本段落
- 🔄 **批量翻译**: 一键翻译所有段落内容
- 👁️ **显示控制**: 可选择隐藏原文,仅显示翻译结果
- ⚡ **自动翻译**: 开启后自动翻译新提取的段落
- 🎨 **美观界面**: 现代化的模态窗口设计
## 支持的输入框类型
- ✅ 标准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