☰
Pot-Desktop 完整教程:划词翻译 + 截图 OCR,免费覆盖三大桌面平台
2026/11/3 11:31:41 网站建设 项目流程

Pot-Desktop 完整教程:划词翻译 + 截图 OCR,免费覆盖三大桌面平台

【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop

Pot-Desktop 是一款免费的开源跨平台翻译工具,支持 Windows、macOS 与 Linux:划词翻译、截图 OCR、多引擎并行对比,选中即译、框选即识别。

五分钟跑起来

三个平台都是一条命令的事,装完点开托盘图标进设置页即可。

Windows:PowerShell 里执行

winget install Pylogmon.pot

启动后没有界面、点托盘也没反应,多半是系统缺 WebView2 运行时,装一下运行时,或改用 Release 页里内置运行时的版本。

macOS:

brew install --cask pot-app/tap/pot

首次启动若提示"开发者无法验证",去 系统设置 → 隐私与安全性 点"仍要打开",之后就不会再弹。

Linux:Debian/Ubuntu 下载对应架构的 deb 包后执行

sudo apt-get install ./pot_xxx_amd64.deb

Arch 系可以直接用yay -S pot-translation,用 Flatpak 的话执行flatpak install flathub com.pot_app.pot。注意 Flatpak 版没有托盘图标,Nvidia 独显 + 新版 Webkit 出现闪退时,在环境变量里加WEBKIT_DISABLE_DMABUF_RENDERER=1即可。

平时怎么用

读外文网页:选词按快捷键

读外文网站或邮件时,用鼠标选中一段文字,按下划词翻译快捷键,选区旁会弹出一个小窗:原文、各引擎的译文、词典释义并排显示,每条结果下面有发音、复制、加入生词本按钮。全程不用切标签页,也不用打开别的翻译网站。

不想弹窗的话还有两种姿势:按"输入翻译"快捷键呼出单行输入框,打完回车直接翻译;或者开启剪切板监听,复制任意文字面板就会自动翻好等你。

识别图片、PDF 里的文字:截图 OCR

遇到选不中的图内文字,按截图 OCR 快捷键(默认 Alt+S),框选区域,几秒后识别出的文本就出现在面板里,可以直接复制或继续送去翻译。快捷键不满意就去设置的"快捷键"页重设,划词、输入翻译、截图 OCR、截图翻译四项各自独立绑定,点输入框直接按下新组合键再点确定。

多引擎结果并排对比

在服务设置里可以同时勾选多个翻译引擎,划词后每个引擎的结果在同一个面板里纵向堆叠,哪个读法更靠谱一目了然。引擎的完整列表可以翻 src/services/translate/:免费的 Google、Bing、百度,需填 Key 的 DeepL、OpenAI,还有剑桥词典、Bing 词典这类查词向服务。

一次配到位

装完之后照着下面四件事配一遍,基本不用回头再动:

  • 快捷键:默认组合若和输入法、浏览器冲突就改掉,最常调的是划词翻译(默认 Ctrl+C 连按两次)和截图 OCR(默认 Alt+S)。
  • 引擎组合:先勾 Google/Bing/百度这类免费引擎保底;追求质量再勾 OpenAI、DeepL 并填好 Key;本地跑了 Ollama 的话,多一个不依赖网络的翻译引擎。
  • OCR 服务:内网、断网环境用系统 OCR(Windows/Mac 自带)或 Tesseract.js,完全离线;要更高准确率再上百度、腾讯、火山、讯飞等在线服务(需填凭据)。全部识别服务见 src/services/recognize/。
  • 生词本:勾选 Anki 或欧路词典,阅读时遇到的词一键存入自己的词库。

卡住了?

Windows 启动后没有界面?系统没装 WebView2。手动安装运行时,或换用内置了运行时的特殊版本安装包。

macOS 提示"开发者无法验证"?系统设置 → 隐私与安全性 → 仍要打开。之后划词翻译失灵的话,去辅助功能权限里把 pot 移除再重新添加。

翻译失败或结果为空?先确认服务设置里勾选的引擎 API Key 是否填对;拿 Google、Bing 这类免费引擎测一遍,能出结果就说明只是某个服务配置问题。

Wayland 桌面下快捷键没反应?应用内快捷键注册在 Wayland 上不可用,属于已知限制。解决办法是设一个系统级快捷键,执行 curl 请求让 pot 去执行动作(命令见下一节)。

更进一步

HTTP 接口调用pot 默认在 127.0.0.1:60828 上监听(端口可在设置里改),划词翻译、截图 OCR 等动作都能通过 HTTP 触发,例如:

curl "127.0.0.1:60828/selection_translate"

想用自己的截图工具时,先把截图存到缓存目录的 pot_screenshot_cut.png,再请求ocr_recognize?screenshot=false。这条路线同时是 Wayland 下快捷键失效的标准绕法。

源码构建

git clone https://gitcode.com/GitHub_Trending/po/pot-desktop cd pot-desktop && pnpm install pnpm tauri dev

Linux 上还需先装 libgtk-3-dev、libwebkit2gtk-4.0-dev 等系统依赖,完整步骤以 README.md 的构建章节为准。

快捷键速查

  • 划词翻译:选词 + 划词翻译快捷键(默认 Ctrl+C 连按)
  • 截图 OCR:默认 Alt+S
  • 输入翻译:默认 Ctrl+T

插件扩展、Wayland 适配等更多细节都在官方文档 README.md 里,遇到问题可以直接翻。

【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询