Transel
跨平台划词翻译工具。选中文字后按下热键，译文显示在鼠标附近的浮窗中。
支持 macOS 、Windows 、Linux 。可同时对照多个翻译接口，并提供截图 OCR 、静默替换、历史与收藏。日常以系统托盘常驻。
介绍
Transel 面向阅读与写作时的即时翻译：在浏览器、编辑器或其它应用中划词，用全局热键唤出结果，而不必切换到翻译网站。
● 划词翻译：读取当前选区（文本、图片或文本文件）
● 多通道对照：多家接口并行出结果
● 截图识别：框选屏幕区域后 OCR ，可选翻译或只复制文字
● 静默替换：将译文写回选区或当前输入框
● 密钥保存在系统钥匙串，配置文件不保存明文
默认目标语言为简体中文，可在设置中修改。新安装默认仅启用系统翻译（ macOS 为 Apple 翻译，其它平台为 Google 免费）；其它接口在设置中点「添加」后再配置。
功能
默认快捷键
Windows / Linux 上
Cmd 对应 Ctrl。可在设置中修改；将按键留空即取消注册。关闭当前窗口：
Esc 或 Cmd+W。macOS 退出应用：Cmd+Q。安装
从 Releases 下载对应平台的安装包。
macOS
1. 下载
Transel-<version>-aarch64-apple-darwin.dmg（ Apple 芯片）或 Transel-<version>-x86_64-apple-darwin.dmg（ Intel ）。2. 打开磁盘映像，将 Transel 拖入「应用程序」。之后可用聚焦（ Spotlight ）或启动台搜索「 Transel 」。
3. 打开 系统设置 → 隐私与安全性 → 辅助功能，启用 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。配置文件位置：
命令行工具
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 许可证。