一个智能的浏览器翻译扩展，支持多种翻译服务和OCR功能，为用户提供便捷的网页翻译体验。
- 🌐 多翻译引擎支持：集成百度翻译、有道翻译、Google翻译等主流翻译服务
- 🖼️ OCR图片翻译：支持图片文字识别和翻译
- 🎯 智能选词翻译：选中文本即可快速翻译
- 🔄 实时翻译切换：一键开启/关闭翻译功能
- 📊 使用统计：记录翻译使用情况和统计数据
- 🎨 友好界面：简洁美观的用户界面
- ⚡ 高性能：优化的翻译速度和响应时间
- 🔒 隐私保护：本地缓存，保护用户隐私
- 访问 Chrome Web Store（链接待更新）
- 点击"添加至Chrome"
- 确认安装权限
- 下载最新的发布包
- 解压到本地文件夹
- 打开Chrome浏览器，进入
chrome://extensions/ - 开启"开发者模式"
- 点击"加载已解压的扩展程序"
- 选择解压后的文件夹
- 配置翻译服务：点击扩展图标，进入设置页面配置API密钥
- 选词翻译：在网页上选中文本，自动显示翻译结果
- 图片翻译：右键点击图片，选择"翻译图片"
- 切换翻译：点击扩展图标快速开启/关闭翻译功能
- Node.js >= 16.0.0
- npm >= 8.0.0
- Chrome浏览器（用于测试）
# 克隆仓库
git clone https://github.com/yuying-translation/browser-extension.git
cd browser-extension
# 安装依赖
npm install# 开发模式（监听文件变化）
npm run dev
# 构建生产版本
npm run build
# 代码质量检查
npm run check
# 代码格式化
npm run format
# 打包扩展
npm run package
# 版本发布
npm run release.
├── js/ # 源代码目录
│ ├── background.js # 后台脚本
│ ├── content.js # 内容脚本
│ ├── popup.js # 弹窗脚本
│ ├── translation-service.js # 翻译服务
│ └── cache-manager.js # 缓存管理
├── css/ # 样式文件
├── images/ # 图片资源
├── dist/ # 构建输出目录
├── docs/ # 文档目录
├── scripts/ # 构建和发布脚本
├── .github/ # GitHub Actions配置
├── manifest.json # 扩展清单文件
├── popup.html # 弹窗页面
└── package.json # 项目配置
- 创建功能分支
git checkout -b feature/new-feature
- 开发和测试
npm run dev # 在Chrome中加载扩展进行测试 - 代码质量检查
npm run check npm run format
- 提交代码
git add . git commit -m "feat: add new feature" git push origin feature/new-feature
- 创建Pull Request
# 构建并打包
npm run package
# 输出文件位于 release/ 目录# 发布补丁版本 (1.0.0 -> 1.0.1)
npm run release:patch
# 发布次要版本 (1.0.0 -> 1.1.0)
npm run release:minor
# 发布主要版本 (1.0.0 -> 2.0.0)
npm run release:major项目配置了GitHub Actions，在推送标签时会自动：
- 运行代码质量检查
- 构建扩展包
- 创建GitHub Release
- 上传构建产物
支持以下翻译服务：
- 百度翻译：需要配置APP ID和密钥
- 有道翻译：需要配置应用ID和应用密钥
- Google翻译：需要配置API密钥
开发时可以创建 .env 文件配置：
# 百度翻译
BAIDU_APP_ID=your_app_id
BAIDU_SECRET_KEY=your_secret_key
# 有道翻译
YOUDAO_APP_ID=your_app_id
YOUDAO_APP_SECRET=your_app_secret
# Google翻译
GOOGLE_API_KEY=your_api_key- 加载扩展到Chrome
- 访问测试网页
- 测试各项功能：
- 选词翻译
- 图片翻译
- 设置页面
- 统计功能
# 运行测试（待实现）
npm test
# 运行端到端测试（待实现）
npm run test:e2e- GitHub部署指南
- Chrome扩展发布指南
- 版本管理指南
- API文档（待完善）
- 贡献指南（待创建）
我们欢迎所有形式的贡献！请查看 贡献指南 了解详情。
- 🐛 报告Bug
- 💡 提出新功能建议
- 📝 改进文档
- 🔧 提交代码修复
- 🌐 翻译界面文本
- 主要维护者：语影翻译团队
- 贡献者：查看完整列表
本项目采用 MIT 许可证。
- Chrome Web Store页面（待更新）
- 官方网站（待创建）
- 用户手册（待创建）
- FAQ（待创建）
如果您遇到问题或需要帮助：
- 📧 邮箱：support@yuying-translation.com
- 🐛 提交Issue
- 💬 讨论区
- 支持更多翻译引擎
- 添加翻译历史记录
- 优化OCR识别准确率
- 支持批量翻译
- 添加自定义翻译快捷键
- 支持翻译结果导出
- 添加翻译质量评分
- 支持离线翻译
- 重构用户界面
- 添加AI翻译引擎
- 支持实时语音翻译
- 多平台支持（Firefox、Edge等）
Made with ❤️ by 语影翻译团队
如果这个项目对您有帮助，请给我们一个 ⭐