CRX id
kbkmflbdmdalljmkkolmhijpciccjcgb
kbkmflbdmdalljmkkolmhijpciccjcgb
Description from extension meta
连续按三次空格键即可将文本翻译到选定目标语言（支持多语言）
Image from store
Description from store
# 沉浸式翻译闪电版 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