Imgur

Imgur

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 许可证。
主楼