Pot-Desktop 划词翻译与截图 OCR 完整指南：10 分钟在三大平台跑通

发布时间：2026/10/30 4:41:23
Pot-Desktop 划词翻译与截图 OCR 完整指南：10 分钟在三大平台跑通

Pot-Desktop 划词翻译与截图 OCR 完整指南：10 分钟在三大平台跑通

【免费下载链接】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 截图识别，还能被其他工具通过 HTTP 调用。下面按安装、初配置、日常用法依次讲。

🚀 安装命令：Windows / macOS / Linux 三条路

Windows 安装命令

winget install Pylogmon.pot

跑完开始菜单里就会出现 Pot 的入口。网络受限时也可以从 Release 页下载 exe 安装包，双击安装。

macOS 安装命令

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

M1 / M2 机器也可以从 Release 页下载 aarch64 的 dmg，拖进 Applications 即完成安装。

Linux 安装命令

# Debian / Ubuntu：先下载对应架构的 deb sudo apt-get install ./pot_amd64.deb # 或者用 Flatpak flatpak install flathub com.pot_app.pot

Arch 系用yay -S pot-translation。想从源码编译，先git clone https://gitcode.com/GitHub_Trending/po/pot-desktop，再pnpm install、pnpm tauri dev即可本地跑起来。

⚙️ 首次启动：先做完这 3 件事

  1. 绑定 4 个快捷键：偏好设置的「快捷键」页里点击输入框、按下组合键即注册。划词翻译、输入翻译、截图 OCR、截图翻译共 4 项，默认全部为空，不绑定就不触发，建议划词翻译设Ctrl+Shift+T、截图 OCR 设Alt+S。
  2. 加一个翻译服务：「服务」页添加 Google、Lingva 这类无需密钥的服务即可直接翻译；OpenAI 等服务需要填 API Key。
  3. 设置语言和主题：「常规」页可选 22 种界面语言，以及跟随系统、亮色、暗色主题。

📝 日常用法：划词、截图、输入三种姿势

划词翻译：3 步出结果

  1. 在任意应用中选中要翻译的文本。
  2. 按划词翻译快捷键。
  3. 译文窗口在鼠标附近弹出，看完关掉即可继续干别的。

顺手开一下剪切板监听：在翻译面板左上角图标点击启用，之后复制任何文字都会自动翻译，不用按快捷键。

截图 OCR：3 步识别屏幕文字

  1. 按截图 OCR 快捷键。
  2. 框选要识别的区域。
  3. 识别出的文字出现在 OCR 窗口；想一步到位就直接按「截图翻译」快捷键，识别并翻译。

输入翻译：3 步查词

  1. 按输入翻译快捷键呼出输入框。
  2. 键入要查的单词或句子。
  3. 按回车，译文立刻给出。

⚖️ 翻译服务怎么选

内置服务集中在 src/services/ 目录，翻译接口约 20 个、识别接口 15 个。选型参考：

类型代表服务场景与代价
免密钥Google、Lingva、Bing日常划词翻译，装上就能用
商业 API百度、腾讯、火山更稳定，需申请 Key 且按量计费
AI 翻译OpenAI、智谱、Gemini Pro译文更自然，需自备 Key
离线本地Ollama、ECDICT、Tesseract（识别）隐私敏感场景，不依赖网络

识别方面，内置「系统 OCR」（调用 Windows / macOS / Linux 系统能力）和 Tesseract 均可离线跑；百度、腾讯、火山、讯飞走在线接口，准确率更高。

🔌 进阶：插件、外部调用与工具联动

  • 装插件：「偏好设置 → 服务设置 → 添加外部插件」选择下载好的.potext文件，装完和内置服务一样用。有道生词本、扇贝、OCRSpace、Rapid 离线识别等都以插件形式提供。
  • 外部调用：默认监听127.0.0.1:60828（端口可在设置里改），实现见 src-tauri/src/server.rs。
curl "127.0.0.1:60828/selection_translate"

请求发出即弹出划词翻译窗口；/input_translate、/ocr_recognize、/ocr_translate同理。

  • 系统工具联动：Windows 上给 SnipDo 装pot.pbar扩展，选中文字点「翻译」按钮即可；macOS 上给 PopClip 装pot.popclipextz扩展。
  • 配置同步：「设置 → 备份」支持把配置导出到本地、WebDAV 或阿里云盘，换机器时导入即可。

🩺 问题速查表

Windows

现象原因处理
启动后无界面、点托盘无反应WebView2 运行时缺失或被禁用安装 WebView2，或改用_fix_webview2_runtime版安装包
装插件提示「找不到指定的模块」系统缺 C++ 运行库安装 Visual C++ Redistributable
装插件提示「不是有效的 Win32 应用程序」插件架构与系统不匹配下载与系统 / 架构一致的插件

macOS

现象原因处理
启动提示「无法验证开发者」Gatekeeper 拦截隐私与安全性里点「仍要打开」
提示文件已损坏隔离属性未解除执行sudo xattr -d com.apple.quarantine /Applications/pot.app
划词翻译不生效辅助功能权限缺失在「辅助功能」中移除 pot 后重新添加

Linux

现象原因处理
Wayland 下全局快捷键无效Tauri 快捷键方案不支持 Wayland设系统快捷键调用上面的 curl 接口
内置截图不可用（Hyprland 等）纯 Wayland 环境屏幕捕获受限外部截图工具 +/ocr_recognize?screenshot=false
Arch 下启动失败或崩溃webkit2gtk 2.42 与 Nvidia DMABUF 冲突设置WEBKIT_DISABLE_DMABUF_RENDERER=1或降级 webkit2gtk

✅ 行动清单：接下来 30 分钟试什么

  1. 按你的系统执行上面的安装命令，打开应用。
  2. 在快捷键页绑定划词翻译和截图 OCR 两个键，先让最常用的两个动作跑起来。
  3. 在服务页添加 Google 这类免密钥服务，做一次测试翻译。
  4. 打开翻译面板的剪切板监听，复制一段英文，验证自动翻译。
  5. Linux Wayland 用户：用系统快捷键加 curl 外部调用的方式先跑通截图识别。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考