Pot 划词翻译完整安装指南:免费跑通三平台悬浮翻译
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
Pot Desktop 是一款免费开源的跨平台划词翻译与 OCR 工具,基于 Tauri + Rust 构建,Windows、macOS、Linux 通吃,KDE、Gnome、Hyprland 下的 Wayland 环境也能跑。读外文资料、处理扫描件的人,用它划一下就能在屏幕边拿到翻译结果,不用来回切窗口,也不用注册任何账号。
🚀 各平台最小安装步骤与首次划词
先按系统选一条命令,复制即可执行,无需手动配环境:
| 平台 | 安装命令 |
|---|---|
| Windows | winget install Pylogmon.pot |
| macOS | brew tap pot-app/homebrew-tap后brew install --cask pot |
| Arch/Manjaro | yay -S pot-translation |
| Debian/Ubuntu | 下载 deb 后sudo apt-get install ./pot_{version}_amd64.deb |
手动安装时认准架构:M1 芯片选aarch64结尾的 dmg,x64 机器选 x64 安装包,Debian/Ubuntu 则下载 deb 用 apt 装。装完打开软件,在任意应用里选中文本、按划词快捷键,第一个翻译浮窗就出现在光标旁,快捷键可在「设置」里改。想从源码了解构建方式,可 git clone https://link.gitcode.com/i/27e48f334772a9be9a700a683924bc0e 后执行pnpm tauri dev。
🧩 能力一:一次划词,多引擎结果并列
基础能力是「划一下,浮窗翻译」:选中文本按快捷键,原文在上、各引擎结果在下逐一列出,每条带朗读、复制小按钮。想让结果互相印证,就在「偏好设置 → 服务设置」里给翻译区挂上 2-3 个服务,比如 DeepL 管术语、Google 管日常、Bing 词典查词源。之后同一段话一次划词同时出多份结果,哪个准信哪个,内置服务覆盖 OpenAI、Gemini、Ollama 等 20 余种,实现都在 src/services/translate/。
🧩 能力二:离线截图 OCR,扫描件也能读出文字
进阶玩法是把图变成字:按截图 OCR 快捷键,十字光标框选区域,松开即识别。它默认走系统内置 OCR——Windows 用 Windows.Media.OCR,macOS 用 Apple Vision,Linux 用 Tesseract,全程离线,云端服务只是可选补充。识别出的文本可直接复制,也能顺手接上翻译,扫描版 PDF 从此不再是死图,截图面板在 src/window/Screenshot/。
🧩 能力三:剪贴板监听与外部触发,翻译自己跑起来
最深的集成玩法是「复制即翻译」:点翻译面板左上角的监听图标,之后每次Ctrl+C新文本都会自动触发翻译,读长文时特别顺手,点掉图标随时停。更进一步,Pot 内置 HTTP 服务(默认端口 60828),一条命令就能让别的工具替你触发划词:
curl "127.0.0.1:60828/selection_translate"服务实现见 src-tauri/src/server.rs;接口还支持/ocr_recognize、/ocr_translate,配合/ocr_recognize?screenshot=false可跳过内置截图,直接把 Snipaste 等工具存到缓存目录的pot_screenshot_cut.png交给它识别,Wayland 用户尤其推荐这条路。最后,.potext插件在「偏好设置 → 服务设置 → 添加外部插件」里安装,装完与内置服务同级使用。
❓ 常见疑问速答
Q:Windows 装完没有界面,点托盘图标也没反应? A:这是启动后黑屏的典型现象,多半是系统缺 WebView2 运行时。手动安装 WebView2 即可,装不了就从 Release 里换带fix_webview2_runtime的安装包。
Q:macOS 第一次划词翻译毫无反应? A:原因是系统权限没给到位。去「设置 → 隐私与安全 → 辅助功能」把 pot 移除后重新添加,划词就恢复了。
Q:Wayland 下应用内快捷键按了没效果? A:Tauri 的快捷键方案暂不支持 Wayland,属于已知限制。用系统快捷键绑定一条curl "127.0.0.1:60828/selection_translate"来触发,README 里有 Hyprland 完整配置示例。
Q:macOS 提示「无法验证开发者」打不开? A:是未签名分发的正常提示。到「隐私与安全性」点「仍要打开」;若选项没出现,终端执行sudo xattr -d com.apple.quarantine /Applications/pot.app后重启。
Q:Arch 系用新 WebKit2GTK + Nvidia 驱动,启动即崩溃? A:这是 Nvidia 专有驱动未完整实现 DMABUF 导致的。在/etc/environment里加WEBKIT_DISABLE_DMABUF_RENDERER=1,或降级 WebKit 即可。
装完马上做这三件事
- 用 winget 或 brew 装好 Pot
- 默认配置划词翻译三次,感受浮窗速度
- 服务设置里加第二个翻译引擎对比
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考