Pot 翻译神器零基础完全指南跨平台划词翻译与 OCR 识别的快速上手教程【免费下载链接】pot-desktop一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop你是否也遇到过这样的场景读外文网页时整段文字无法复制只能一个个字母敲进翻译器论文里的图片版 PDF 需要手动誊写为了对比几种翻译结果要同时打开五六个网页来回切换。Pot派了个萌的翻译器正是为解决这些问题而生的开源跨平台划词翻译软件集划词翻译、截图 OCR、多引擎并行翻译于一体让看不懂的内容在几秒内变成看得懂的内容。这篇零基础完全指南会带你从认识它开始一路走到把它调教成顺手的日常工具。第一章先搞清楚它到底能帮你做什么在动手安装之前建议你先花两分钟确认需求。Pot 的定位非常聚焦它不是一个臃肿的翻译平台而是四类高频能力的组合体。核心能力解决的典型问题一句话理解划词翻译网页、文档、代码里选中文本就能翻译选中 → 快捷键 → 出结果截图 OCR图片、视频、无法复制的界面文字截图 → 识别出文字截图翻译图片里的外语直接翻译截图 → 直接给译文输入翻译主动查询一个词或一句话呼出窗口 → 输入 → 回车四条能力背后翻译接口、OCR 接口都可以自由组合。Pot 同时支持 20 翻译引擎和 10 文字识别引擎还内置了插件系统、生词本导出和外部 HTTP 调用接口。理解了这个能力矩阵后面所有配置你都能对号入座。第二章5 分钟完成环境准备与多系统一键安装Pot 基于 Tauri 构建安装包体积小、内存占用低Windows、macOS、Linux 三大平台都有对应的安装方式接下来按你的系统选择一条路走完即可。Windows一行命令装好最省事的方式是用包管理器 Winget在 PowerShell 中执行winget install Pylogmon.pot如果你更习惯手动安装去项目 Release 页面下载对应架构的exe安装包即可64 位机器选x64-setup32 位选x86-setuparm64 设备选arm64-setup双击完成安装。macOS通过 Homebrew 两步搞定brew tap pot-app/homebrew-tap brew install --cask pot以后升级也很简单一条brew upgrade --cask pot即可。M1/M2 芯片用户记得在手动下载时选择aarch64版本的 dmg 包。LinuxDebian 系一条 apt 命令sudo apt-get install ./pot_{version}_amd64.debArch 系用户可以用 AUR helper 安装pot-translation或使用 Flatpak 通用包com.pot_app.pot。装好后首次启动建议先到「偏好设置 → 服务设置」里把默认翻译接口确认一遍——绝大多数免费接口如 Google、Bing开箱即用不需要申请任何密钥。第三章用它解决第一个真实翻译难题安装完成、接口就绪之后你可以立刻体验 Pot 的看家本领。三个最常见的真实场景每个对应一条快捷键链路。场景一网页文本划词翻译选中即译在浏览器、文档或编辑器里用鼠标选中一段英文按下划词翻译快捷键默认CtrlCC翻译结果会以小窗口形式出现在屏幕上全程不需要切换应用。场景二图片文字截图 OCR突破复制限制按下截图 OCR 快捷键后框选屏幕上的任意区域Pot 会立刻识别其中的文字。这一招对扫描版 PDF、视频字幕、无法复制的软件界面特别管用。场景三输入翻译主动查询一句话按下输入翻译快捷键呼出输入窗口键入文本后回车即可翻译适合你主动想搞清楚某个词句含义的情况。如果你希望图片里的外语直接变成中文还有一个截图翻译模式——截图、识别、翻译一气呵成这也是学习外语时使用频率最高的功能之一。第四章让它更顺手的系统化配置方案基础功能跑通之后接下来就是用得更好的阶段。Pot 的配置入口都集中在「偏好设置」里下面按优先级给出三组建议。第一步自定义快捷键组合默认快捷键不一定适合你的输入习惯建议按照好按、不冲突的原则重新分配功能推荐快捷键备注划词翻译CtrlCC双击 C 不易与复制冲突截图 OCRAltS顺手且少占用输入翻译CtrlT呼出频率高放在左手位截图翻译CtrlShiftS与截图 OCR 区分开在「偏好设置 → 快捷键」页面按下组合键即可完成注册。如果某个按键被其他软件占用软件会提示注册失败换一组即可。第二步配置翻译与 OCR 服务Pot 的翻译接口分为四类对应不同使用场景类型代表引擎适合谁免密钥在线Google、Bing、有道日常使用装上就能用商业 API百度、腾讯、DeepL追求准确度的专业翻译AI 大模型OpenAI、智谱 AI、Gemini Pro长难句、学术内容本地离线Ollama隐私敏感场景OCR 接口同理Windows/macOS/Linux 自带系统 OCR 离线可用百度、腾讯等在线 OCR 准确率更高追求完全本地处理则选 Tesseract。配置路径是「偏好设置 → 服务设置」每个服务展开后填入对应的密钥或参数即可相关服务代码分布在src/services/translate/、src/services/recognize/目录下想了解实现细节可以深入查看。第三步开启辅助能力剪切板监听模式在任意翻译面板点击左上角图标启动之后复制文字即自动翻译适合处理大量零散文本。生词本导出翻译结果可直接推送到 Anki、欧路词典形成翻译即收藏的学习闭环。第五章踩坑避雷清单与常见问题排查新手期最容易卡住的几个问题提前给你排掉。现象原因解法Windows 启动后无界面系统缺少/禁用了 WebView2 运行时安装 WebView2或下载内置 WebView2 的特殊版本安装包macOS 提示无法验证开发者系统安全策略拦截设置 → 隐私与安全性 → 仍要打开macOS 无法划词翻译辅助功能权限失效在隐私与安全 → 辅助功能中移除 pot 后重新添加快捷键按下无反应全局快捷键被系统或其他软件占用更换快捷键组合或检查系统权限翻译一直失败API 密钥错误或接口不可用检查服务配置换一个翻译接口对比测试Linux Wayland 截图失效部分桌面环境不支持内置截图用外部截图工具 HTTP 接口替代见下文插件相关的报错也常见Windows 提示找不到指定的模块通常是系统缺少 VC 运行库提示不是有效的 Win32 应用程序则是下载了与系统架构不匹配的插件版本。第六章进阶玩法——外部调用与 Wayland 场景定制当基础功能已经融入日常你可以进一步把 Pot 变成一个可被任何程序调用的翻译引擎。它内置完整的 HTTP 接口默认监听127.0.0.1:60828调用方式非常直接。让其他软件一键调用翻译# 划词翻译翻译当前选中的文本 curl 127.0.0.1:60828/selection_translate # 截图 OCR跳过软件内截图使用外部截图工具的产物 curl 127.0.0.1:60828/ocr_recognize?screenshotfalse # 截图翻译 curl 127.0.0.1:60828/ocr_translate?screenshotfalse调用流程是先用你熟悉的截图工具如 Windows 的 SnipDo、macOS 的 PopClip、Linux 的 Flameshot截图把图片保存到$CACHE/com.pot-app.desktop/pot_screenshot_cut.png再向接口发请求即可。Wayland 下的 Hyprland 配置示例在纯 Wayland 桌面环境里内置快捷键和截图可能失效可以用系统级快捷键把 curl 命令串起来一样能实现完整链路bind ALT, X, exec, grim -g $(slurp) ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png curl 127.0.0.1:60828/ocr_recognize?screenshotfalse bind ALT, C, exec, grim -g $(slurp) ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png curl 127.0.0.1:60828/ocr_translate?screenshotfalse想让翻译窗口跟随鼠标位置还可以在 Hyprland 里加两条窗口规则Translator/OCR/Screenshot Translate三个窗口浮动并移动到光标位置。其他桌面环境思路相同官方文档中附带了patches/hyprland.patch等参考资料有需要可以查看src-tauri/src/下的源码了解实现。用插件扩展无限可能内置接口数量终归有限Pot 的插件系统可以继续扩展翻译、OCR、语音合成、生词本四类能力。插件以.potext文件分发下载后在「偏好设置 → 服务设置 → 添加外部插件」中导入就能像内置服务一样使用。公式识别就是典型场景——用 Simple LaTeX 引擎可以直接把数学公式图片转为 LaTeX 代码。如果你对开发感兴趣还可以从src/services/目录的模块结构入手参考现有服务的写法开发自己的插件。从现在开始让语言障碍不再是你的阻碍回头看这篇 Pot 翻译神器完全指南主线其实只有四步理解它的能力边界用一条命令把它装好跑通划词翻译、截图 OCR、输入翻译三个核心场景再通过快捷键、服务组合和外部调用把它调教成顺手的工作流。剩下的就是在每天的使用中慢慢发现更多组合玩法。立即动手安装 Pot把选中文案 → 按下快捷键 → 得到结果变成你的肌肉记忆让语言障碍不再是你的阻碍。遇到任何问题回看本文的踩坑清单或者查阅项目仓库中的官方文档答案都在那里。【免费下载链接】pot-desktop一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考