pot-desktop 安装与上手指南：划词翻译 + 截图 OCR 一次跑通

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（派了个萌的翻译器）的日常用法。它是一款基于 Tauri 构建的跨平台桌面工具，支持 Windows、macOS、Linux，覆盖划词翻译、输入翻译、截图 OCR 三类最高频功能，内置多接口并行翻译和离线文字识别能力。

本文顺序：先确认你的系统满足底线要求，再按平台执行一条安装命令，然后完成首次启动的几步设置，最后跑一次划词翻译验证全部就绪。

系统底线要求

不用装任何依赖，只需系统达标：

注意：Wayland 桌面（KDE Wayland、Hyprland 等）下软件本身能跑，但应用内的快捷键配置不生效，文末避坑表里给了替代方案。

安装：按平台选一条命令

Windows 用 winget 一行装好

Windows 10 及以上自带 winget，打开 PowerShell 执行：

# winget 一键安装 pot-desktop winget install Pylogmon.pot

不想用命令行，就到发布页面下载与架构匹配的 exe（64 位系统选x64），双击后跟向导走完。企业版系统装不了 WebView2 的，改下内置 WebView2 的fix_webview2_runtime版本。

macOS 用 Homebrew 两条命令

打开终端依次执行：

# 添加 tap 源并安装 pot brew tap pot-app/homebrew-tap brew install --cask pot

不走 Homebrew 的话，到发布页下载 dmg：M 系芯片选aarch64，Intel 选x64，双击后把图标拖进 Applications 文件夹即可。

Linux 两种包管理器

Debian / Ubuntu 系，把对应架构的 deb 包下载到当前目录后：

# 用 apt 安装本地 deb 包 sudo apt-get install ./pot-3.0.7-amd64.deb

Arch / Manjaro 系用 AUR 助手一行装好：

# 从 AUR 安装 pot-translation yay -S pot-translation

首次启动必做的三步

装完启动，托盘会出现图标，主体在后台静默运行。接着按设置页操作：

1. 快捷键：打开设置页的“快捷键”项，里面有划词翻译、输入翻译、截图 OCR、截图翻译四个场景。页面已给出默认值，直接按下你想要的组合并确认即可。
2. 翻译服务：进入“服务设置 → 翻译”，至少启用一个。内置的云服务一般只需填入自己的 API 密钥，先挑一个能用的接口。
3. 识别服务：进入“服务设置 → 文字识别”选一个；不想注册任何云服务，就选“系统”——这是操作系统自带的离线 OCR，开箱即用。

界面语言不是中文的话，先在通用设置里切换，再按上面顺序走。

验证安装成功：跑一次划词翻译

用最高频的功能确认一切正常：

1. 打开任意包含英文的页面，用鼠标选中一句话。
2. 按下你刚确认的划词翻译快捷键。
3. 光标旁弹出面板并显示译文，说明安装成功，可以正式使用了。

截图 OCR 同理：按对应快捷键、框选一块含文字的区域，识别结果出来即代表配置无误。

避坑速查

进阶路径

能正常翻译之后，按兴趣深入：

• README.md：项目主文档，含全部支持接口清单、外部调用（HTTP）接口说明和 Wayland 配置章节
• src/services/translate/：内置翻译服务的实现代码，想接入新接口从这里入手
• src/i18n/locales/：多语言文案资源，可看到软件支持的全部界面语言

版本说明

本文基于 pot-desktop 3.0.7 编写，默认快捷键组合和设置页布局在不同版本间可能略有差异，以软件内实际显示为准。

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