企业官网建设流程全解析

如何 3 步上手 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 是一款免费开源的跨平台划词翻译与 OCR 软件，同时覆盖 Windows、macOS 和 Linux。装好之后，一次按键就能完成划词翻译、截图 OCR、截图翻译和剪切板自动监听。本文按"装 → 用 → 扩 → 调 → 修"的顺序，带你把它从安装到高级用法一次性讲透。

一、30 秒装好 pot-desktop：按你的系统选命令

不同系统对应不同的安装入口，找到你用的那一栏，照抄命令即可。

Windows：一条 winget 命令

打开命令提示符（或 PowerShell），输入：

winget install Pylogmon.pot

想手动装也行：去 Release 页面下载对应架构的 exe 安装包，64 位系统选pot_{version}_x64-setup.exe，双击后按引导点完即可。

macOS：Homebrew 两步走

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

不用 Homebrew 的话，下载 dmg 文件，把 pot 图标拖进 Applications 文件夹就算装完了。

Linux：Debian 系 / Arch 系

Debian 和 Ubuntu 下载 deb 包后本地安装：

sudo apt-get install ./pot_{version}_amd64.deb

Arch、Manjaro 用户可以直接走 AUR：

yay -S pot-translation

二、5 个日常场景：划词、输入、截图与剪切板

安装完成后，pot-desktop 的核心能力集中在 5 个场景里，每个都对应一个快捷键（可在设置中按需调整）。

场景 1：划词翻译

浏览器或阅读器里选中一段外文，按下划词翻译快捷键，翻译结果窗口就会弹出在光标附近。如果你同时启用了多个翻译引擎，这里会并列展示各家结果，方便横向比对。

场景 2：输入翻译

不知道快捷键怎么设、或者手头没有可划词的文本时，按下输入翻译快捷键呼出独立输入窗口，粘贴或键入内容后按回车出结果，还支持语音朗读和一键复制。

场景 3 与场景 4：截图 OCR 和截图翻译

两个功能的触发方式相同——按下对应快捷键后框选屏幕区域，区别在于结果：

• 截图 OCR：只识别区域里的文字，回显原文；
• 截图翻译：识别完直接出译文，一步到位。

读论文、看外文报错截图时，截图翻译基本是必选项。

场景 5：剪切板监听模式

在任意翻译面板上点左上角图标，开启剪切板监听。之后你在任何地方复制的文字都会自动触发翻译，连续阅读外文资料时特别省手。

快捷键自定义方法

所有场景的触发键都能在设置的快捷键页面里改。建议把划词、截图翻译这类高频动作绑到顺手的手上，低频功能留给备用组合键，避免和浏览器、输入法的热键撞车。

三、翻译质量翻倍：多引擎并行 + 插件扩展

多接口并行翻译

在翻译设置里可以同时勾选多个引擎，一次翻译请求各家各出一版答案。内置支持的范围大致分三档：

学术或商务场景里，拿 AI 引擎保流畅、拿词典接口核对释义，是常见的组合方式。

插件扩展：装一个 .potext 就多一个服务

内置接口只是起点。pot-desktop 的插件系统支持翻译接口、OCR 工具和生词本同步三类扩展，目前已有的例子包括翻译类的 Lingva、Tatoeba，离线 OCR 类的 RapidOCR、PaddleOCR，以及扇贝单词这类生词本同步。

安装步骤固定为三步：

1. 下载.potext格式的插件文件；
2. 打开 软件设置 → 服务设置 → 添加外部插件；
3. 选中刚才下载的插件文件，装完即可像内置服务一样使用。

四、用 HTTP 接口调用 pot：外部集成与自动化

pot-desktop 启动后会在本机127.0.0.1:60828上监听 HTTP 请求（端口可在设置里改），把核心功能全部暴露成了接口，其他软件或脚本可以直接驱动它：

最常用的验证方式就是一条 curl：

curl "127.0.0.1:60828/selection_translate"

进阶一点：给截图接口加上screenshot=false参数（如GET /ocr_recognize?screenshot=false），就能跳过软件内置截图，改用你习惯的截图工具，先把图片存到~/.cache/com.pot-app.desktop/pot_screenshot_cut.png再发请求即可——这也是后面 Wayland 方案能成立的原因。

五、启动后最容易卡的 3 个问题及解法

Windows：启动后没有界面、托盘点了没反应

多半是系统里 WebView2 组件被卸载或禁用了，手动恢复它通常就好。企业版电脑装不了 WebView2 的话，去 Release 页面换内置 WebView2 的特殊版本安装包（文件名含fix_webview2_runtime），可以绕过这个问题。

macOS：提示"无法打开"或文件损坏

两种情况分开处理：

• 首次启动提示开发者无法验证：进「系统设置 → 隐私与安全性」，点"仍要打开"，之后就不会再弹了；
• 提示文件损坏：终端执行下面命令后重新启动 pot：

sudo xattr -d com.apple.quarantine /Applications/pot.app

Linux Wayland：应用内快捷键和截图失灵

Wayland 下 Tauri 的全局热键方案不生效，解法是让系统级快捷键替你发 HTTP 请求。以 Hyprland 为例，配置里加一行：

bind = ALT, X, exec, grim -g "$(slurp)" ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl "127.0.0.1:60828/ocr_recognize?screenshot=false"

截图、框选、识别、翻译四步被压进一次按键，体验和不支持的平台上几乎无差别。

从划一下鼠标到截图直出译文，pot-desktop 把"看到外文 → 看懂"这条路径缩到了最短。装好它、配顺快捷键，再把顺手的翻译引擎勾上，剩下的就交给日常使用去磨合了。

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