Transel
跨平台划词翻译工具。选中文字后按下热键，译文显示在鼠标附近的浮窗中。
支持 macOS 、Windows 、Linux 。可同时对照多个翻译接口，并提供截图 OCR 、静默替换、历史与收藏。日常以系统托盘常驻。
介绍
Transel 面向阅读与写作时的即时翻译：在浏览器、编辑器或其它应用中划词，用全局热键唤出结果，而不必切换到翻译网站。
- 划词翻译：读取当前选区（文本、图片或文本文件）
- 多通道对照：多家接口并行出结果
- 截图识别：框选屏幕区域后 OCR ，可选翻译或只复制文字
- 静默替换：将译文写回选区或当前输入框
- 密钥保存在系统钥匙串，配置文件不保存明文
默认目标语言为简体中文，可在设置中修改。新安装默认仅启用系统翻译（ macOS 为 Apple 翻译，其它平台为 Google 免费）；其它接口在设置中点「添加」后再配置。
功能
| 划词翻译 | 默认 Alt+D（ macOS 为 Option+D ），浮窗显示原文与译文 |
| 输入翻译 | 弹出输入框，回车翻译 |
| 截图 OCR | RapidOCR ，以及火山 / 腾讯 / 百度 / 有道 / Google 云识别；腾讯图片翻译 |
| 原图翻译 | 在截图上标出识别区域并翻译 |
| 静默替换 | 译文写回选区或输入框全文；指针旁可停止当前任务 |
| 翻译接口 | 机器翻译（ Apple 系统翻译、DeepL 、Google 、微软、Amazon 、百度、有道、阿里、火山、彩云、小牛 Flash / Pro 等）与 LLM 通道（ OpenAI / Azure / Claude / Gemini / 智谱 / DeepSeek / 通义 / 豆包 / Kimi / Ollama 等） |
| 词典 | 英语单词：音标、词性、例句 |
| 朗读 | 系统 TTS ，以及火山 / 腾讯 / Google / Microsoft 云语音 |
| 历史 / 收藏 | 应用内搜索 |
| 托盘 | 设置、历史、输入翻译、截图 OCR 、固定浮窗、退出 |
默认快捷键
Windows / Linux 上 Cmd 对应 Ctrl。可在设置中修改；将按键留空即取消注册。
| 功能 | 快捷键 |
|---|---|
| 翻译选区 | Alt+D |
| 截图翻译 | Alt+F |
| 截图 OCR （不翻译） | Shift+Alt+S |
| 静默 OCR （只写入剪贴板） | Alt+C |
| 输入翻译 | Cmd+Shift+I |
| 朗读选区 | Cmd+Shift+R |
| 历史 | Cmd+Shift+H |
| 设置 | Cmd+, |
| 固定 / 取消固定浮窗 | Cmd+Shift+P |
| 原图翻译 | Alt+Shift+O |
| 收藏夹 | Cmd+Shift+F |
| 静默划词替换 | Alt+S |
| 静默输入框替换 | Alt+A |
关闭当前窗口：Esc 或 Cmd+W。macOS 退出应用：Cmd+Q。
安装
从 Releases 下载对应平台的安装包。
macOS
- 下载
Transel-<version>-aarch64-apple-darwin.dmg（ Apple 芯片）或Transel-<version>-x86_64-apple-darwin.dmg（ Intel ）。 - 打开磁盘映像，将 Transel 拖入「应用程序」。之后可用聚焦（ Spotlight ）或启动台搜索「 Transel 」。
- 打开 系统设置 → 隐私与安全性 → 辅助功能，启用 Transel 。若从终端启动，请授权「终端」或 iTerm ，然后完全退出并重新打开。未授权时无法读取选区。
若提示「已损坏，无法打开」或无法打开未验证的开发者应用：这是 Gatekeeper 拦截未公证的下载包，不是文件真的坏了。在终端执行：
xattr -cr /Applications/Transel.app
然后再次打开。从浏览器下载的 DMG 也会带隔离属性，可先对磁盘映像执行 xattr -cr ~/Downloads/Transel-*.dmg 再打开。
Windows
安装 Transel-<version>-x86_64.msi，或解压 zip 后运行 transel.exe。
以管理员身份运行的窗口，需以相同权限运行 Transel ，否则可能无法读取选区。
Linux
Debian / Ubuntu：
sudo dpkg -i transel_<version>_amd64.deb
或使用 AppImage：
chmod +x Transel-<version>-x86_64.AppImage
./Transel-<version>-x86_64.AppImage
建议：
- 安装托盘支持（ GNOME 需 AppIndicator 扩展）
- Wayland 下全局热键通常仅对 XWayland 窗口有效；划词依赖
wl-clipboard，交互截图依赖grim与slurp - 需要稳定热键时，优先使用 X11 会话
配置翻译接口
启动后通过托盘打开「设置」，启用所需接口并填写 API Key 。OpenAI 兼容通道（智谱、硅基流动、Groq 、Ollama 等）已预置地址与默认模型。密钥写入系统钥匙串（ macOS Keychain 、Windows 凭据管理器、Linux Secret Service ）。云 OCR / TTS 也可使用环境变量，例如 TENCENT_SECRET_ID、VOLCANO_ACCESS_KEY、GOOGLE_OCR_API_KEY、VOLCANO_TTS_TOKEN。
配置文件位置：
| 平台 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/dev.transel/config.json |
| Windows | %APPDATA%\dev.transel\config.json |
| Linux | ~/.config/dev.transel/config.json |
命令行工具 transel-cli：
transel-cli config show
transel-cli config set target zh-CN
transel-cli history search <关键词>
transel-cli backend list
临时覆盖 OpenAI 兼容接口（明文，仅建议调试使用）：
export TRANSLATE_API_BASE=https://api.deepseek.com/v1
export TRANSLATE_API_KEY=sk-xxx
export TRANSLATE_MODEL=deepseek-chat
从源码构建
需要 Rust 1.88 或更高版本。
git clone https://github.com/pannanxu/transel
cd transel
cargo run --release
macOS：安装 Xcode Command Line Tools （xcode-select --install）。
Windows：安装 Visual Studio Build Tools ，并勾选「使用 C++ 的桌面开发」。
Linux（ Debian / Ubuntu ）：
sudo apt install build-essential pkg-config cmake clang \
libxkbcommon-dev libxkbcommon-x11-dev libwayland-dev libvulkan-dev mesa-vulkan-drivers \
libx11-xcb-dev libxcb1-dev libxcb-randr0-dev libxcb-xfixes0-dev libxcb-shape0-dev \
libfontconfig-dev libfreetype-dev libssl-dev libzstd-dev \
libgtk-3-dev libayatana-appindicator3-dev libxdo-dev libxi-dev libxtst-dev \
espeak-ng wl-clipboard grim slurp maim gnome-screenshot
在本机生成安装包：
# macOS / Linux
bash packaging/package.sh --build
# Windows （ PowerShell 7+）
pwsh packaging/package.ps1 -Build
产物位于 dist/。推送 v* 标签时，CI 会构建 macOS （ arm64 / x86_64 ）、Windows x86_64 与 Linux x86_64 并发布到 Releases 。
许可
本项目采用 MIT 许可证。
Select Language