Skip to content

kany2000/QuickTranslate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

193 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 QuickTranslate - 快译

Stars

QuickTranslate

Version Chrome License

🌐 Language / 语言 / 言語 / 언어: 中文 · English · 日本語 · 한국어 · 繁體中文


🎉 选中文字即可快速翻译,支持 Google、Microsoft、GLM、LLM 多种翻译引擎

QuickTranslate 是一款强大的 Chrome 浏览器扩展,采用创新的 DOM 文字提取技术,实现精确的网页文字识别和即时翻译。

✨ 核心特色

展开

🌟 快捷翻译面板 (新功能!)

  • 选中即翻译 - 在网页上选中文字后自动显示翻译按钮,无需打开扩展
  • 一键翻译 - 点击按钮即可快速翻译,操作步骤从5步减少到2步
  • 极速响应 - 翻译速度提升75%,从约2秒缩短到0.5秒内
  • 精美面板 - 紫色渐变主题的悬浮翻译面板,现代化设计
  • 智能位置 - 翻译按钮自动出现在选中文字附近,不遮挡内容
  • 一键复制 - 快速复制翻译结果到剪贴板
  • 无干扰设计 - 在输入框中选择文字不会触发翻译
  • 可配置 - 可设置最小选择字数,避免误触发

🎯 精准识别技术

  • DOM直接提取 - 跳过OCR环节,直接从网页结构提取文字,准确率高达 98%+
  • 智能区域检测 - 多点采样算法,确保选中区域文字完整性
  • 自适应过滤 - 自动过滤CSS样式、代码片段等无关内容
  • 缓存优化 - 智能缓存机制,提升重复操作性能

🧠 智能语言处理

  • AI语言检测 - 基于深度字符特征分析,准确率达 99%+
  • 多语言支持 - 支持日文、韩文、英文、中文等10+种语言
  • 上下文理解 - 智能识别语言混合内容,提供精确翻译
  • 简繁体识别 - 自动区分简体中文和繁体中文

三模式翻译

  • 快捷翻译 - 选中文字 → 点击按钮 → 查看结果(推荐日常使用
  • 截图翻译 - Alt+1快捷键 → 框选区域 → OCR识别 → 翻译(适合图片文字)
  • 悬浮翻译 - 按住 Alt 键 → 悬停文字上 → 自动翻译(沉浸式阅读翻译)
  • 多重引擎 - Google翻译 + MyMemory备用,翻译成功率 95%+
  • 智能重试 - 网络失败时自动重试,确保翻译成功

🎨 现代化界面设计

  • 直观操作 - 拖拽选择,即选即译
  • 流畅动画 - 精美的视觉反馈和过渡效果
  • 智能提示 - 实时状态显示和操作指导
  • 响应式设计 - 适配不同屏幕尺寸
  • 紫色主题 - 优雅的渐变配色方案
---

🤩 各版本亮点说明

版本亮点更新为 v2.5.0(当前版本)

  • 新增多语言界面切换功能
  • 支持简体中文、繁体中文、英文、日文、韩文5种界面语言
  • 插件界面自动根据浏览器默认语言切换
  • 优化了高级设置按钮在不同语言下的显示效果
  • 历史版本 v2.2.0 已移入历史记录
版本亮点详情

🆕 版本亮点 (v2.5.0)(当前版本)

🚀 独立翻译面板 + 翻译历史 + 生词本(全新!)

  • 快捷面板 - 按 Ctrl+Shift+Q 呼出独立浮动面板,可在任何页面快速翻译
  • 翻译历史 - 自动保存翻译记录,最多可存储500条
  • 生词本 - 收藏常用翻译,方便复习查阅
  • 全方法收藏 - 截图翻译、划词翻译、悬停翻译均支持保存到生词本
  • 数量统计 - 历史和生词本显示已存数量/总数(如 3/500)

🌍 多语言界面切换

  • 支持 5种界面语言:简体中文、繁体中文、英文、日文、韩文
  • 插件自动检测浏览器默认语言并切换对应界面
  • 可随时通过标题栏语言选择器手动切换界面语言
  • 语言设置自动保存,下次打开自动应用
  • 安装通知和欢迎提示也支持多语言显示

🎨 界面优化

  • Google 翻译(蓝色标签)、Microsoft(青色)
  • GLM 大模型(橙色)、自定义 LLM(绿色)
  • 卡片式布局,清晰易读

🎉 历史版本亮点 (v2.1.2)

🌟 悬浮翻译功能

  • 按住 Alt 键并将鼠标悬停在文字上即可翻译
  • 无需选中文字,沉浸式阅读翻译
  • 精美的悬浮气泡展示,包含原文和译文
  • 可在高级设置中启用/关闭此功能

🔧 Bug 修复

  • 修复设置保存后无法正确读取的问题
  • 修复悬浮翻译初始化时序问题
  • 修复悬浮翻译坐标追踪问题
  • 修复快捷翻译面板内存泄漏
  • 修复快捷翻译面板复制按钮事件重复绑定

性能优化

  • 悬浮翻译响应延迟从 300ms 优化到 100ms
  • 使用 caretRangeFromPoint 获取精确单词

🎉 历史版本亮点 (v2.1.1)

更新安装完成通知

  • 简化安装完成通知文字,更加简洁明了
  • 优化欢迎提示显示时长,确保显示 5 秒钟

🎉 历史版本亮点 (v2.1.0)

🎯 翻译面板智能定位

  • 面板现在出现在选中文字附近,不再固定在屏幕正中央
  • 优先显示在文字下方,空间不足时自动切换到上方
  • 水平方向以选中区域为中心,自动保持在视口范围内

💡 翻译来源显示

  • Google 翻译正常时:面板底部留空,干净简洁
  • 切换至备用服务时:显示 "⚡ 由 MyMemory 提供""⚡ 由 Lingva 提供"
  • 悬停可查看提示:"Google 翻译不可用,已自动切换至备用服务"

🎉 历史版本亮点 (v2.0.0)

🚀 革命性更新 - 快捷翻译面板

这是一个改变游戏规则的更新!我们为您带来了全新的翻译体验:

使用场景对比

v1.x 传统方式:

  1. 点击扩展图标
  2. 点击"开始截图"
  3. 框选文字区域
  4. 等待OCR识别
  5. 查看翻译结果

v2.0 快捷翻译:

  1. 选中文字
  2. 点击翻译按钮
  3. ✅ 完成!

性能提升

  • 操作步骤:5步 → 2步 ⬇️ 60%
  • 翻译速度:~2秒 → ~0.5秒 ⬆️ 75%
  • 用户体验:需要popup → 直接在页面 ⬆️ 显著提升

适用场景

快捷翻译面板适合:

  • 📖 阅读外文网页时快速查词
  • 💬 翻译社交媒体上的短文
  • 🛍️ 查看产品描述和评论
  • 📚 学习外语时的辅助工具

截图翻译(Alt+1)适合:

  • 🖼️ 图片中的文字识别
  • 📄 PDF文档翻译
  • 🔒 无法选中的文字内容
  • 🔍 需要OCR识别的场景

🆕 历史版本亮点 (v1.5.0)

🎨 界面全面升级 - 精细化美化

  • 现代化配色方案 - 采用紫色渐变主题(#667eea → #764ba2),更加时尚优雅
  • 精致的视觉效果
    • 圆角优化:从 8px 提升到 16px,更加柔和
    • 阴影增强:多层次阴影效果,增强立体感
    • 渐变背景:标题、按钮、卡片均采用精美渐变
    • 毛玻璃效果:版本标签使用 backdrop-filter 模糊效果
  • 流畅的动画体验
    • 按钮悬停光泽扫过效果
    • 入场动画:弹窗淡入缩放效果
    • 保存成功动画:缩放脉冲反馈
    • 状态消息滑入动画
  • 交互细节优化
    • 按钮悬停抬起效果(translateY)
    • 关闭按钮旋转动画
    • 输入框聚焦发光效果
    • 复选框悬停背景变化
  • 自定义滚动条 - 精美的滚动条样式,与整体设计协调
  • 响应式优化 - 更好的小屏幕适配体验

📐 排版精细化处理

  • 间距优化 - 所有元素间距重新调整,视觉更加舒适
  • 字体优化 - 字重、字号、行高精心调整
  • 对齐优化 - 元素对齐更加精确
  • 层次分明 - 通过颜色、大小、间距建立清晰的视觉层次

🎯 用户体验提升

  • 视觉反馈增强 - 所有交互都有明确的视觉反馈
  • 操作更直观 - 按钮和控件更加醒目易用
  • 信息层次清晰 - 主要功能和次要功能区分明确

🆕 历史版本亮点(v1.4.1)

🚀 大模型翻译新时代

  • GLM 大模型 - 支持智谱 GLM-4-Flash 模型,翻译质量更高
  • LLM 自定义 - 支持 OpenAI 兼容格式的任意大模型 API
    • 可配置 Base URL(支持 OpenAI、Claude 等兼容 API)
    • 可配置模型名称(gpt-3.5-turbo、gpt-4、claude-3 等)
    • 需要 API Key 认证
  • Microsoft Translator - 新增微软翻译作为免费翻译选项

翻译服务选项

服务 类型 API Key 说明
Google Translate 免费 不需要 默认翻译引擎
Microsoft Translator 免费 不需要 新增备选
GLM 付费 需要 智谱大模型
自定义 LLM 付费 需要 OpenAI 兼容格式

🎨 用户体验革新

  • 一键智能翻译 - Alt+1快捷键,自动检测语言并翻译成目标语言
  • 快速设置保存 - 主界面直接保存,告别繁琐的设置流程
  • 实时视觉反馈 - 设置变更脉冲提示,保存动画确认
  • 分层界面设计 - 基本设置与高级设置分离,操作更加直观
  • LLM 配置界面 - 新增 Base URL 和模型名称输入框

📊 性能指标

  • 语言检测准确率 ↗️ 99%+
  • 文字识别准确率 ↗️ 98%+
  • 翻译成功率 ↗️ 95%+
  • 响应速度 ↗️ <500ms

📦 快速安装

🛠️ 开发者安装 (推荐)

# 1. 克隆项目
git clone https://github.com/kany2000/QuickTranslate.git
cd QuickTranslate

# 2. Chrome 扩展安装
# 打开 Chrome 浏览器 → chrome://extensions/
# 开启 "开发者模式" → 点击 "载入未封装项目"
# 选择 QuickTranslate 文件夹

⚡ 一键安装脚本

# Windows PowerShell
git clone https://github.com/kany2000/QuickTranslate.git && start chrome://extensions/

# macOS/Linux
git clone https://github.com/kany2000/QuickTranslate.git && open -a "Google Chrome" chrome://extensions/

📋 安装检查清单

  • ✅ Chrome 版本 88+
  • ✅ 开启开发者模式
  • ✅ 允许扩展权限
  • ✅ 测试快捷键 Alt+1

💡 提示: 首次安装后建议访问 测试页面 验证功能正常


🚀 使用方法

📢 请务必使用前先了解一下

首次设置

  1. 打开设置 - 点击浏览器工具栏中的 📷 图标
  2. 配置语言 - 选择目标语言(推荐:简体中文)和识别语言(推荐:自动检测)
  3. 保存设置 - 点击 "💾 保存设置" 按钮
  4. 开始使用 - 配置完成,可以开始翻译

快捷键操作(推荐)

  1. 智能翻译 - 按 Alt+1 启动智能翻译(自动检测语言翻译成目标语言)
  2. 选择文字 - 拖拽框选要翻译的区域
  3. 查看结果 - 自动弹出翻译窗口

快捷面板(Ctrl+Shift+Q)

  1. 呼出面板 - 按 Ctrl+Shift+Q 在页面任意位置弹出浮动面板
  2. 输入翻译 - 在输入框中输入文字,点击翻译按钮
  3. 查看结果 - 结果显示后可复制或收藏到生词本
  4. 切换标签 - 点击「翻译/历史/生词本」标签切换不同功能
  5. 关闭面板 - 点击 × 按钮或按 ESC 关闭

悬浮翻译(按住 Alt 键)

  1. 启用功能 - 在高级设置中勾选"启用悬浮翻译"
  2. 按住 Alt 键 - 将鼠标悬停在任意文字上
  3. 查看翻译 - 自动显示悬浮翻译气泡,悬停到不同文字自动翻译
  4. 松开 Alt - 关闭悬浮翻译
  5. 收藏翻译 - 悬停翻译气泡右上角有收藏按钮,点击可保存到生词本

手动操作

  1. 启动功能

    • 点击浏览器工具栏中的 📷 图标
    • 点击 "📷 开始截图翻译" 按钮
  2. 选择文字

    • 页面出现半透明覆盖层
    • 拖拽鼠标框选要翻译的文字区域
  3. 查看结果

    • 自动弹出翻译结果窗口
    • 显示原文、译文和识别信心度
    • 可点击收藏按钮保存到生词本
  4. 退出功能

    • ESC 键快速退出
    • 点击覆盖层背景退出
---

🎨 界面展示

📋 界面布局详解 (v2.5.0)

主界面结构

┌─────────────────────────────────┐
│  QuickTranslate 快译            │
│  简体中文                  v2.5.0│
├─────────────────────────────────┤
│  📷 开始截图                     │
│  拖拽选择区域,自动识别并翻译文字 │
├─────────────────────────────────┤
│  默认快捷键:Alt+1 智能翻译      │
│  (自动检测语言翻译成目标语言)    │
├─────────────────────────────────┤
│  目标语言: [简体中文 ▼]         │
│  识别语言: [自动检测 ▼]        │
│  💾 保存设置                   │
├─────────────────────────────────┤
│  📜 快捷面板历史    ⭐ 生词本   │
├─────────────────────────────────┤
│  ⚙️ 高级设置                   │
└─────────────────────────────────┘

🆕 v2.5.0 新增:新增「快捷面板历史」和「生词本」按钮,方便快速查看翻译历史和收藏内容

高级设置结构 (v2.5.0)

┌─────────────────────────────────────────┐
│  高级设置                            ×   │  ← 📋 设置标题
├─────────────────────────────────────────┤
│  翻译服务: [Google Translate ▼]          │  ← 🔧 服务选择
│  (高级) Microsoft API Key: [输入框]     │  ← 🔑 微软翻译密钥
│  (高级) GLM API Key: [输入框]           │  ← 🔑 智谱密钥
│  (高级) LLM 自定义配置                  │  ← 🤖 自定义LLM
├─────────────────────────────────────────┤
│  ☑ 启用快捷翻译面板                     │  ← ✨ 选中即翻译
│  ☑ 启用悬浮翻译 (按Alt键悬停)          │  ← 🌟 沉浸式翻译
│  ☑ 多引擎结果对比                       │  ← 🎯 三引擎对比
│  最小选择字数: [2]                      │  ← 🎯 触发设置
│  ☑ 自动复制翻译结果                     │  ← 📋 自动复制
│  快捷键设置: [Alt+1] [修改]            │  ← ⌨️ 快捷键
├─────────────────────────────────────────┤
│  [保存设置]  [重置]                     │  ← 💾 操作按钮
└─────────────────────────────────────────┘

快捷翻译面板 (v2.0.0 新功能)

┌─────────────────────────────────────────┐
│  🌐 快捷翻译                    ×      │  ← 标题 + 关闭按钮
├─────────────────────────────────────────┤
│  原文                                    │  ← 📝 原文标签
│  "Hello World"                          │  ← 📄 原文内容
├─────────────────────────────────────────┤
│  译文                                    │  ← 🌐 译文标签
│  你好世界                                │  ← ✨ 翻译结果
├─────────────────────────────────────────┤
│  [⚡ Google翻译]        [复制] [收藏]   │  ← 📋 操作按钮
└─────────────────────────────────────────┘

快捷面板 (v2.5.0 新功能)

┌─────────────────────────────────┐
│ 📝 快捷面板              [×]   │  ← 可拖动标题栏
├─────────────────────────────────┤
│ [翻译] [历史] [生词本]         │  ← Tab切换
├─────────────────────────────────┤
│ ┌─────────────────────────────┐ │
│ │ 输入文字翻译...              │ │  ← 输入框
│ └─────────────────────────────┘ │
│          [翻译]                 │
├─────────────────────────────────┤
│ 译文:你好世界                  │
│ [复制] [收藏到生词本]           │
└─────────────────────────────────┘

多引擎结果对比 (v2.2.0 新功能)

┌─────────────────────────────────────────┐
│  🌐 快速翻译                    ×      │
├─────────────────────────────────────────┤
│  原文                                    │
│  "Hello World"                          │
├─────────────────────────────────────────┤
│  ┌─ Google 翻译 ─────────────────────┐  │
│  │  你好世界                        │  │
│  │                          [复制]  │  │
│  └──────────────────────────────────┘  │
│  ┌─ Microsoft ──────────────────────┐  │
│  │  你好世界                        │  │
│  │                          [复制]  │  │
│  └──────────────────────────────────┘  │
│  ┌─ 自定义 LLM ─────────────────────┐  │
│  │  你好,世界!                    │  │
│  │                          [复制]  │  │
│  └──────────────────────────────────┘  │
│                                          │
│  ⚡ 3个成功,点击复制各引擎结果           │
└─────────────────────────────────────────┘

悬浮翻译气泡 (v2.0.0 新功能)

    ┌────────────────────────┐
    │  Hello World           │  ← 📝 原文(浅灰色)
    │  ─────────────────     │  ← 分隔线
    │  你好世界               │  ← 🌐 译文(深色)
    └────────────────────────┘
              ↓
         (悬停位置)

🎨 界面特色

特色 说明 效果
🎨 渐变标题 蓝绿色渐变背景,现代化设计 视觉美观
🎯 直观按钮 大型主操作按钮,清晰的图标和文字 易于操作
💫 智能提示 设置变更时按钮会脉冲提示保存 实时反馈
即时反馈 保存时显示"保存中..."和"已保存"状态 状态明确
📋 分层设计 基本设置和高级设置分离 操作清晰
🎯 紧凑布局 优化间距,消除多余空白 视觉协调

⚙️ 设置选项

主界面设置(推荐使用)

  • 目标语言 - 设置翻译目标语言(推荐:简体中文)
  • 识别语言 - 设置文字识别语言(推荐:自动检测)
  • 快速保存 - 点击 "💾 保存设置" 立即保存配置

高级设置

  • 翻译服务 - Google翻译、Microsoft翻译、离线翻译、GLM、LLM自定义
  • API配置 - 第三方服务的API密钥设置
    • Google翻译:免费,无需 API Key
    • Microsoft翻译:需要 API Key
    • GLM:需要智谱 API Key
    • LLM自定义:需要 API Key + Base URL + 模型名称
  • 快捷翻译面板 - 选中网页文字后自动显示翻译按钮
  • 悬浮翻译 - 按住 Alt 键悬停文字即可翻译(需启用)
  • 多引擎对比 - 同时显示 Google / Microsoft / LLM 翻译结果
  • 自动复制 - 翻译完成后自动复制结果
  • 快捷键设置 - 自定义快捷键组合

快捷键配置

默认快捷键

  • Alt+1 - 智能翻译模式(自动检测语言翻译成目标语言)

自定义快捷键

  1. 进入高级设置 → 快捷键设置区域
  2. 点击 "修改" 按钮
  3. 按下新的组合键(如 Ctrl+Shift+Q)
  4. 设置会自动保存
  5. 或前往 chrome://extensions/shortcuts 手动设置

智能翻译优势

  • 自动语言检测 - 无需手动选择源语言
  • 用户目标语言 - 使用您设置的目标语言进行翻译
  • 一键启动 - Alt+1 即可开始翻译
  • 灵活配置 - 可在设置中更改目标语言

🛠️ 技术架构

📋 展开

🏗️ 核心技术栈

  • Manifest V3 - Chrome扩展最新标准,更安全更高效
  • DOM API - 直接文字提取技术,避免OCR误差
  • Fetch API - 现代网络请求,支持并发和重试
  • Chrome Extension APIs - 系统级功能集成
  • ES6+ Modules - 模块化架构,便于维护和扩展

🧠 智能算法

  • 多点采样算法 - 智能密度调整,确保文字完整性
  • 字符特征分析 - 基于语言学特征的高精度语言检测
  • 重叠计算优化 - 精确的区域检测和元素筛选
  • 缓存策略 - LRU缓存机制,提升重复操作性能
  • 智能重试 - 指数退避算法,处理网络异常

🔧 性能优化

  • DOM查询缓存 - 减少重复DOM操作
  • 事件监听器管理 - 自动清理,防止内存泄漏
  • 异步处理 - 非阻塞操作,保持界面响应
  • 批量处理 - 优化大量文字的处理效率
  • 资源预加载 - 提前加载常用资源
---

📊 性能指标

指标 数值 说明
文字识别准确率 98%+ DOM直接提取技术
语言检测准确率 99%+ 智能字符特征分析
翻译成功率 95%+ 多重引擎保障
响应时间 <500ms 从选择到显示结果
快捷键响应 <100ms 系统级快捷键
支持语言 10+ 日韩英中等主流语言
兼容性 Chrome 88+ 支持最新浏览器

🔧 开发指南

本地开发

# 克隆项目
git clone https://github.com/kany2000/QuickTranslate.git
cd QuickTranslate

# 在Chrome中载入扩展
# 1. 打开 chrome://extensions/
# 2. 开启开发者模式
# 3. 点击"载入未封装项目"
# 4. 选择项目文件夹

调试方法

  • Console日志 - 在开发者工具中查看详细日志
  • 扩展页面 - chrome://extensions/ 查看扩展状态
  • 背景页面 - 点击"检查视图"调试后台脚本
  • 快捷键测试 - chrome://extensions/shortcuts 测试快捷键

🤝 常见问题

😒 展开

Q: 快捷键不生效怎么办? A: 请前往 chrome://extensions/shortcuts 检查快捷键设置,确保没有冲突。

Q: 为什么有些文字无法识别? A: 请确保选中的区域包含清晰的文字,避免选择图片或特殊格式的内容。

Q: 翻译结果还是原文怎么办? A: 这通常是语言检测问题。请检查浏览器控制台日志,或尝试重新加载扩展。

Q: 支持哪些语言翻译? A: 目前支持日文、韩文、英文等语言翻译成中文。系统会自动检测源语言。

Q: 翻译结果不准确怎么办? A: 扩展使用Google翻译API,翻译质量较高。如果结果不满意,可以尝试选择更精确的文字区域。

Q: 扩展在某些网站无法使用? A: 部分网站可能有特殊的安全策略,请尝试刷新页面或联系我们报告问题。

📄 许可证

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

🙏 致谢

感谢以下服务和技术:


⭐ 如果这个项目对您有帮助,请给我们一个星标!

🚀 按 Alt+1 开始您的智能翻译之旅!

🔧 查看 用户指南 了解详细使用方法!


📸 界面截图制作指南

展开

🎨 截图要求

为了完善项目展示效果,需要制作以下截图文件:

📱 主界面截图

文件: images/main-interface.png 尺寸: 显示宽度240px (60%缩放) 格式: PNG (高分辨率)

应包含元素:

  • 🎨 蓝绿色渐变标题栏
  • 📷 主操作按钮
  • ⌨️ 快捷键说明 (Alt+1)
  • 🌐 语言选择下拉框
  • 💾 保存设置按钮
  • ⚙️ 高级设置入口

⚙️ 高级设置截图

文件: images/advanced-settings.png 尺寸: 显示宽度270px (60%缩放) 格式: PNG (高分辨率)

应包含元素:

  • 📋 设置标题和关闭按钮
  • 🔧 翻译服务选择器
  • ✅ 功能开关复选框
  • ⌨️ 快捷键配置区域
  • 💾 操作按钮组

💡 制作建议

  • 分辨率: 使用2x高分辨率截图
  • 背景: 保持界面原有的渐变和阴影效果
  • 清晰度: 确保文字和图标清晰可读
  • 一致性: 保持截图风格统一

About

QuickTranslate - 快译智能截图翻译。一个功能强大全面优化的 Chrome 浏览器扩展,采用创新的DOM文字提取技术和模块化架构,实现精确的网页文字识别和即时翻译。拥有支持多种语言、多种翻译方式、生词本、快捷翻译面板等多功能模块,为您提供快速、准确、稳定、高效的翻译服务。

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors