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

发布时间：2026/10/30 4:41:23

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 件事

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

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

划词翻译：3 步出结果

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

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

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

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

输入翻译：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