# edge翻译插件

**Repository Path**: qinxingguan/edge-translation-plugin

## Basic Information

- **Project Name**: edge翻译插件
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-23
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 页面翻译助手

一个基于translate.js的Microsoft Edge浏览器扩展，支持一键翻译网页内容，让浏览外语网站变得轻松便捷。

## 功能特点

- 🌐 **一键翻译**：简单点击即可翻译整个网页内容
- 🔄 **自动翻译模式**：开启后，页面切换时自动加载翻译功能
- 📱 **响应式界面**：简洁美观的弹出窗口，操作直观
- 🎯 **智能识别**：自动检测页面语言并翻译为中文
- ⚡ **高性能**：基于translate.js库，翻译速度快，资源占用少
- 💾 **状态保存**：记住用户的翻译偏好设置

## 安装方法

### 从源码安装

1. 下载或克隆此仓库到本地
   ```bash
   git clone git@gitee.com:qinxingguan/edge-translation-plugin.git
   ```

2. 打开Microsoft Edge浏览器

3. 在地址栏输入 `edge://extensions/` 进入扩展管理页面

4. 打开右上角的"开发人员模式"开关

5. 点击"加载已解压的扩展程序"

6. 选择您下载的项目文件夹

7. 扩展安装完成，您将在浏览器工具栏看到翻译助手图标

## 使用方法

1. **基本使用**：
   - 点击浏览器工具栏中的翻译助手图标
   - 在弹出窗口中点击"自动翻译模式"开关
   - 刷新当前页面或导航到新页面，内容将自动翻译为中文

2. **手动控制**：
   - 通过开关随时启用或禁用翻译功能
   - 翻译状态会自动保存，下次打开浏览器时保持设置

## 效果展示

### 扩展界面
![扩展界面](doc/image.png)

### 翻译效果
![翻译效果](doc/image1.png)

## 技术架构

本扩展使用以下技术构建：

- **Manifest V3**：最新的浏览器扩展API标准
- **translate.js**：强大的网页翻译库
- **Chrome Extension API**：用于标签页管理和脚本注入
- **Service Worker**：后台脚本处理扩展逻辑

### 文件结构

```
my-edge-extension/
├── manifest.json        # 扩展清单文件
├── background.js        # 后台服务脚本
├── popup.html          # 弹出窗口界面
├── popup.js            # 弹出窗口逻辑
├── translate.js        # 翻译核心库
├── inspector_v2.js     # 辅助脚本
└── icon.png            # 扩展图标
```

## 权限说明

本扩展需要以下权限：

- `storage`：保存用户设置和翻译状态
- `tabs`：获取和操作浏览器标签页
- `activeTab`：访问当前活动标签页
- `scripting`：在网页中注入翻译脚本
- `webNavigation`：监听页面导航事件
- `<all_urls>`：在所有网站上运行翻译功能

## 兼容性

- Microsoft Edge 96及以上版本
- 支持所有主流网站
- 支持动态内容翻译

## 开发说明

### 本地开发

1. 修改代码后，在扩展管理页面点击"刷新"按钮
2. 检查后台脚本的运行日志：
   - 在扩展管理页面找到"页面翻译助手"
   - 点击"错误"按钮查看日志

### 自定义翻译服务

您可以在`background.js`文件中修改翻译服务配置：

```javascript
// 修改翻译API服务地址
translate.request.api.host='https://your-translate-api.com/';

// 指定不同的翻译服务
translate.service.use('client.edge'); // 使用Edge内置翻译
// 或
translate.service.use('giteeAI'); // 使用GiteeAI翻译服务
```

## 常见问题

**Q: 为什么有些页面无法翻译？**  
A: 某些特殊网站可能有安全策略限制，阻止脚本注入。这种情况下可以尝试刷新页面或在不同网站上使用。

**Q: 翻译质量如何？**  
A: 翻译质量取决于所使用的翻译服务。默认使用translate.js提供的翻译服务，您也可以根据需要更换为其他服务。

**Q: 会影响网页性能吗？**  
A: 翻译功能仅在需要时启用，且采用了高效的翻译算法，对网页性能影响很小。

## 更新日志

### v1.1 (当前版本)
- 优化翻译脚本注入逻辑
- 改进页面切换时的自动翻译功能
- 增强错误处理和日志记录

### v1.0
- 初始版本发布
- 基本翻译功能实现
- 简单的开关控制界面

## 贡献

欢迎提交问题报告和功能请求！如果您想贡献代码：

1. Fork 本仓库
2. 创建您的功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开一个 Pull Request

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 致谢

- [translate.js](https://github.com/xnx3/translate) - 强大的网页翻译库
- Microsoft Edge 扩展开发文档
- [Trae](https://www.trae.cn/) - 强大的AI自动编程能力

## 联系方式

如有问题或建议，请通过以下方式联系：

- 提交 [Issue](https://gitee.com/qinxingguan/edge-translation-plugin/issues)
- 发送邮件至：2244131632@qq.com