<<<<<<< HEAD

Quick-Translater

=======

QuickTranslater

轻量级桌面翻译工具 | A lightweight desktop translator

一款简洁、原生的桌面翻译工具。输入或截图即可自动识别中英文并翻译，无需打开浏览器，没有冗余功能。

A sleek, native desktop translator built with Python tkinter. Translate text instantly between Chinese and English with auto-detection — no browser needed, no bloat.

---

功能 | Features

• 自动识别翻译 — 输入文本后自动判断中英文，300ms 内完成翻译

• 截图 OCR — 框选屏幕任意区域，提取文字并翻译（需 Tesseract OCR）

• 窗口置顶 — 始终保持在最前，翻译工作两不误

• 随意拖拽 — 拖拽标题栏即可移动窗口位置

• 缓存加速 — 已翻译的内容本地缓存，重复查询秒出结果

• 原生质感 — 简洁的 macOS 风格 UI，圆角卡片 + 浅色主题

• Auto-detect & translate — Paste or type text, auto-detects Chinese/English and translates in 300ms.

• Screenshot OCR — Capture any area on your screen and extract text for translation (requires Tesseract OCR).

• Always-on-top — Stays on top of your other windows so you can translate while working.

• Drag anywhere — Drag the title bar to move the window anywhere on screen.

• Translation cache — Frequently translated text is cached locally for instant results.

• Native look — Clean, macOS-inspired design with rounded cards and a light color scheme.

界面预览 | Preview

┌──────────────────────────────────────┐
│  Quick Translator     [Screenshot] [❌]
├──────────────────┬───────────────────┤
│  输入            │  翻译结果          │
│                  │                    │
│  Hello world     │  你好，世界        │
│                  │                    │
│                  │                    │
└──────────────────┴───────────────────┘

快速开始 | Getting Started

环境要求 | Prerequisites

• Python 3.8+
• Tesseract OCR（使用截图翻译时需要）

安装 | Install

# 克隆仓库
git clone https://github.com/Yanghuabei-design/Quick-Translater.git
cd Quick-Translater

# 安装依赖
pip install -r requirements.txt

截图 OCR 设置： 下载并安装 Tesseract OCR，添加到系统 PATH。安装时请勾选 中文简体语言包。

For screenshot OCR: Install Tesseract OCR and add it to your system PATH. During installation, select the Chinese Simplified language pack.

使用 | Usage

python main.py

或直接运行 dist/ 中的打包可执行文件。Or launch the packaged executable from dist/.

工作原理 | How It Works

操作	说明
输入 / 粘贴文本	自动检测语言，中文 → 英文，其他文字 → 中文
Type/paste text	Auto-detects language (Chinese → English, otherwise Chinese)
等待 300ms	通过 MyMemory API 翻译（缓存命中则秒出）
Wait 300ms	Translation fires via MyMemory API (cached results return instantly)
点击 Screenshot	全屏蒙层 → 框选区域 → OCR 提取文字 → 自动翻译
Click Screenshot	Fullscreen overlay — drag to select a region — OCR extracts text
按 Esc	取消截图
Press Esc	Cancel screenshot mode

技术栈 | Tech Stack

组件 Component	技术 Tech
界面 GUI	tkinter + PIL
翻译 API	MyMemory API (免费)
文字识别 OCR	pytesseract + Tesseract OCR
打包 Packaging	PyInstaller

协议 | License

MIT

---

QuickTranslater — 用 Python 构建，为开源而生。built with Python, powered by open source.

3b0fbd8 (Add project documentation and build configuration)