Pot 划词翻译与 OCR 识别上手指南:从安装到 5 种高频用法
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
读外文网页选不中文字、PDF 里的句子复制不出来、截图想识别又要开浏览器 OCR 工具——这些繁琐的步骤,pot 一个跨平台的免费划词翻译 + OCR 识别软件都能收进一个快捷键里:选中文本弹出翻译、框选屏幕识别文字、还能呼出输入框直接翻译。它支持 Windows、macOS、Linux 三大系统,下面按"装好 → 用好 → 配好 → 解决坑"的顺序带你走完。
三分钟装好 pot:三个平台各一条命令
📦 按你的系统选一条命令执行即可,全程不需要注册账号。
Windows:PowerShell 里运行
winget install Pylogmon.potmacOS:用 Homebrew 两行命令
brew tap pot-app/homebrew-tap brew install --cask potLinux:Debian/Ubuntu 用户下载deb包后sudo apt-get install ./pot_xxx.deb;Arch/Manjaro 用户执行yay -S pot-translation;通用方案是 Flatpak 安装com.pot_app.pot。
两处提前打预防针:
- Windows 装完启动后没有任何窗口,通常是系统里 WebView2 被禁用或卸载了,把它恢复即可。
- macOS 首次打开若提示"开发者无法验证",点取消,再到 设置 → 隐私与安全性 里点"仍要打开";提示文件损坏时,在终端执行
sudo xattr -d com.apple.quarantine /Applications/pot.app后重启应用。
五步玩明白核心功能:划词、输入、剪切板、OCR 与截图翻译
装好后,进入 偏好设置 → 快捷键,给四个功能各设一个全局热键,后面的操作全靠它。
1. 划词翻译——在任意位置选中文本,按下划词翻译热键,翻译窗口直接出现在光标旁。支持多个接口同时并行翻译,一眼对比结果。
2. 输入翻译——按输入翻译热键呼出输入窗口,键入待翻译内容,回车出结果。适合翻译你自己打的句子,不必来回复制。
3. 剪切板监听——在任意翻译面板上点左上角图标启动监听,之后在别处复制任何文字都会自动翻译成英文,不用按任何键。
4. 截图 OCR——按截图 OCR 热键,框选屏幕区域,软件完成文字识别并展示可复制的文本。识别图片、PDF 里选不中的内容就是靠它。
5. 截图翻译——和上一步同样的框选动作,识别之后直接给出译文,一步到位。
选引擎与调热键:让翻译更顺手的关键配置
🛠 打开 偏好设置 → 服务设置,可以决定翻译、识别、语音合成、生词本分别用哪些接口,全部免费内置,按需勾选即可。
翻译接口:内置 20 余个,涵盖 OpenAI、Gemini Pro、DeepL、Google、Bing、有道等,另有 Ollama 可走本地模型离线翻译。完整清单见 README.md 的"支持接口"章节,源码在 src/services/translate/。
OCR 接口:离线场景选系统 OCR(Windows/macOS 自带,Linux 用 Tesseract)或 Tesseract.js;在线场景可选百度、腾讯、火山、迅飞,还有 Simple LaTeX 专门识别数学公式。目录见 src/services/recognize/。
生词本:识别或翻译结果可以导出到 Anki、欧路词典等,攒词一步到位,目录见 src/services/collection/。
插件:不够用就装.potext插件。在 偏好设置 → 服务设置 → 添加外部插件 里选择下载好的文件,装完和内置服务一样用。
常见故障排查:五类报错对应的最短解法
| 你看到的现象 | 大概率原因 | 最短解法 |
|---|---|---|
| Windows 启动后无窗口、托盘没反应 | WebView2 被禁用或卸载 | 恢复 WebView2;企业环境装不了就换内置 WebView2 的安装包 |
| 插件报"不是有效的 Win32 应用程序" | 插件架构与系统不匹配 | 重新下载对应系统、对应架构的插件 |
| Wayland 下应用内热键全部无效 | Tauri 全局热键方案不支持 Wayland | 改用系统热键 + curl 调 HTTP 接口(见下节) |
| Arch + N 卡下无法启动、崩溃 | Webkit2Gtk 的 DMABUF 渲染问题 | 环境变量里加WEBKIT_DISABLE_DMABUF_RENDERER=1 |
| macOS 每次打开都弹辅助功能提示 | 权限记录异常 | 在 辅助功能 里先移除 pot 再重新添加 |
进阶一招:用 HTTP 接口从任何脚本里调起 pot
🚀 pot 启动后在127.0.0.1上监听 HTTP 接口,默认端口60828(可在设置里改)。对本地地址发一条请求,就能从别的软件或系统快捷键里触发它:
curl "127.0.0.1:60828/selection_translate"常用端点:/selection_translate划词翻译、/input_translate输入翻译、/ocr_recognize截图 OCR、/ocr_translate截图翻译,参数和示例详见 README.md 的"外部调用"章节。
Hyprland 等纯 Wayland 环境下,内置截图和热键都不可用时,可以这样接外部截图工具:先用自己的工具把截图存到系统缓存目录com.pot-app.desktop/pot_screenshot_cut.png,再请求/ocr_recognize?screenshot=false。仓库里还附了一份 Hyprland 配置补丁 可以直接参考。
速查清单
- 四个热键入口:偏好设置 → 快捷键(划词 / 输入 / 截图 OCR / 截图翻译,全部可自定义)
- 本地接口默认地址:
127.0.0.1:60828,划词翻译 =GET /selection_translate - 离线方案:翻译用 Ollama,OCR 用系统 OCR 或 Tesseract.js
- 扩展能力:
.potext插件在 偏好设置 → 服务设置 → 添加外部插件 中安装,注意核对系统架构 - 遇到问题先查 README.md 中"安装指南"与"Wayland 支持"两节
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考