PopTrans 是一款专为 Windows 打造的本地离线翻译与 OCR 工具。支持选中文本或屏幕截图后一键翻译。 基于 Go + Wails 构建流畅的原生交互与现代界面，后端采用 Python 与 llama.cpp 实现纯 CPU 离线大模型推理，无需 GPU 加速，彻底告别隐私泄露与网络依赖。
- 🚀 快捷翻译：一键捕获选中文本（模拟 Ctrl+C，内置多次智能重试），并即刻显示翻译结果。
- 📷 离线 OCR：原生 Go 实现的屏幕框选与截图，内置多倍率自动缩放与低置信度重试，识别更准。
- 🌐 智能互译：基于文本中的中英文字符比例，自动判断并进行中英文双向互译。
- ⚡ 极速响应：内置 LRU 结果缓存（256 条），重复文本翻译实现秒级返回。
- 🎨 现代 UI：基于 Wails 构建的亚克力毛玻璃界面，完美支持系统深色/浅色主题自适应。
- 🔧 灵活配置：系统托盘常驻，支持自定义全局快捷键、OCR 开关、本地端口等，配置热加载即刻生效。
- 操作系统：Windows 10 / 11 (x64)
- 依赖运行库：需系统已安装 WebView2 Runtime (Windows 11 通常自带)
- 硬件要求：纯 CPU 推理，无需独立显卡，建议 8GB 及以上内存。
- 双击运行发行版中的
PopTrans.exe。 - 下载模型：若本地无翻译模型，首次启动时会自动联网下载 腾讯 Hy-MT2-1.8B GGUF 模型 (约 1.13GB)。默认通过 HuggingFace 国内加速镜像 (
https://hf-mirror.com) 下载并绕过系统代理。 - 下载完成后，模型将保存在
models/Hy-MT2-1.8B-GGUF/目录下，后续运行即为完全离线状态。
| 操作 | 默认快捷键 |
|---|---|
| 翻译选中文本 | Ctrl+Alt+Q |
| OCR 截图翻译 | Ctrl+Alt+E |
| 关闭窗口 / 取消框选 | Esc |
提示：快捷键可在托盘菜单的“设置”中随时自定义修改（支持
Ctrl/Alt/Shift/Win等组合修饰键）。
为解决旧版本单进程 Python 带来的系统交互卡顿与不稳定问题，v2.0 采用了全新的 Go + Wails + Python 三进程架构：
- Go 宿主程序 (
PopTrans.exe)：专注系统集成，负责系统托盘、全局 Win32 快捷键注册、剪贴板监控以及高性能的原生 DWM 截图框选，提供极度稳定且流畅的系统交互。 - Wails UI (
translate-ui.exe)：桌面 UI 组件，提供高性能、美观的 Web 前端渲染与毛玻璃窗口。 - Python AI 服务 (
ai_engine.exe)：专注后台 AI 计算，内置 FastAPI、llama.cpp、RapidOCR 提供本地 HTTP 服务，被 PyInstaller 独立打包，无需用户电脑安装 Python。
| 对比维度 | v1.x (Python) | v2.0 (Go + Wails + Python) |
|---|---|---|
| 稳定性 | 任意模块崩溃导致应用直接退出 | 进程隔离，AI 引擎崩溃自动重启，托盘/UI 不受影响 |
| 界面 UI | Tkinter 原生窗口，界面简陋 | Wails (WebView2) 亚克力毛玻璃界面，自动适应高度 |
| 系统交互 | pynput 监听，易冲突，需要管理员权限 | 原生 Win32 API 注册，精确可靠，无需提权 |
| OCR 框选 | Python 截屏，高 DPI 下存在坐标偏移与延迟 | Go 原生多显示器虚拟坐标覆盖，无延迟，完美适配高 DPI |
项目划分为三大模块，需要分别具备 Go, Node.js, Python 开发环境。
translate-plugin/
├── backend/ # Python AI 服务代码与打包配置 (FastAPI, llama.cpp, RapidOCR)
├── cmd/translate-go/ # Go 托盘宿主程序入口
├── frontend/ # Wails/Vite 前端界面代码 (HTML/CSS/JS)
├── internal/ # Go 核心逻辑 (Win32 API, 窗口管理, HTTP 桥接, 生命周期管理)
├── scripts/ # 构建打包脚本
├── models/ # 外部 AI 模型存放路径
└── dist-go/ # 构建产物输出目录
# 1. 准备 Python 环境依赖 (用于本地运行 AI 服务)
python -m pip install -r backend/requirements.txt
# 2. 准备 UI 资源 (需构建一次前端，或者通过 wails dev 启动)
./scripts/build_wails.bat
# 3. 启动 Go 托盘主进程 (会自动拉起后台 Python 服务)
go run ./cmd/translate-go打包完整发行版需要同时安装打包相关的依赖环境：
python -m pip install -r backend/requirements-build.txt一键完整构建：
./scripts/build_all.bat构建脚本会自动按顺序编译前端、Python 后端 (ai_engine.exe) 以及 Go 主程序 (PopTrans.exe)，并自动组装依赖到 dist-go/ 目录。
注：您也可以使用
scripts/下的独立 bat 脚本单独构建某个模块。
应用配置会在同级目录生成 settings.json，支持通过设置界面或直接修改文件（自动热加载）：
server_port: AI 引擎内部服务端口，默认为8989。theme: 界面主题模式，可选system,light,dark。logging_enabled: 是否开启文件日志。开启后，各进程日志将统一输出至translate.log。
TRANSLATE_SERVER_PORT：强制覆盖配置文件中的 AI 服务端口。HF_ENDPOINT：自定义 HuggingFace 镜像下载地址（默认为https://hf-mirror.com）。NO_PROXY：下载模型时绕过代理的域名列表。
AI 后台引擎默认在 http://127.0.0.1:<server_port> 提供 API 服务，支持外部工具或脚本直接调用，详情请参阅 本地 API 文档：
GET /health：服务与模型健康状态检查。POST /api/v1/ocr：RapidOCR 纯离线图像文字识别。POST /api/v1/ocr_translate：OCR 识别 + 翻译一步集成。POST /v1/chat/completions：OpenAI 兼容的翻译/对话接口（支持流式响应 SSE）。
本项目基于 MIT License 协议开源。
