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 识别桌面应用，本文带你从零把它装起来、跑起来、配置好，全程不需要额外知识。
它上手后能干什么
先说三个最常用的场景，装完你就能体会到它的价值：
- 划词翻译：在任意软件里选中一段外文，按一下你设定的快捷键，译文直接弹出来，支持 OpenAI、谷歌、Bing 等多个接口并行返回结果，哪个快用哪个。
- 截图 OCR：按一下快捷键框选屏幕区域，图中的文字马上被识别成可复制的文本；不想用云端接口时，还能切换到 Tesseract.js 离线识别，文字不出本机。
- 剪贴板翻译：在翻译面板上开启剪贴板监听后，随手复制一段文字就自动出现翻译结果，连快捷键都不用按。
动手前先备齐环境
Pot-desktop 是前后端混合的桌面项目：界面用 React + Vite 写，桌面外壳和系统能力（全局快捷键、剪贴板、截图窗口）由 Rust 端通过 Tauri 完成，本地 OCR 则靠 Tesseract.js 借助 WebAssembly 在应用内直接跑。所以你需要把下面三件套装齐，缺一不可：
| 依赖 | 最低版本 | 它负责什么 |
|---|---|---|
| Node.js | >= 18.0.0 | 跑前端构建（Vite） |
| pnpm | >= 8.5.0 | 管理前端依赖并执行脚本 |
| Rust | >= 1.80.0 | 编译 Tauri 的 Rust 核心 |
另外提醒一句：如果你要的是"装一个能用的软件"，直接去 Release 页面下载各平台安装包更省事；本教程面向想从源码本地部署、或者想参与开发的你。
本地跑通 Pot-desktop 的完整步骤
第一步：克隆仓库
把项目代码拉到本地。
git clone https://gitcode.com/GitHub_Trending/po/pot-desktop cd pot-desktop第二步：安装依赖
让 pnpm 把前端依赖全部装好，这一步会顺带拉取 Tauri 的 npm 包。
pnpm install第三步：安装系统级依赖（仅 Linux）
Linux 下 Tauri 编译需要 GTK、WebKit 等系统库，Windows / macOS 跳过这步。
sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev libayatana-appindicator3-dev librsvg2-dev patchelf libxdo-dev libxcb1 libxrandr2 libdbus-1-3第四步：构建并启动
开发模式用pnpm tauri dev，会边编译边把应用跑起来，改代码也能热更新；想产出可分发的安装包则用pnpm tauri build。
pnpm tauri dev # 开发调试 pnpm tauri build # 打包构建第一次编译 Rust 代码会比较久，泡杯咖啡的功夫很正常。跑起来之后你会看到一个挂在系统托盘上的应用，划词翻译、截图 OCR 都能试了。
启动后必做的 3 个配置
应用只是跑起来，要顺手用还得进偏好设置（菜单里叫"偏好设置"）调三样东西：
- 配翻译服务的 API 密钥：打开 偏好设置 → 服务设置，在翻译、文字识别两个列表里选中你打算用的服务（比如 OpenAI 或百度），弹窗里填入密钥并保存。不想依赖云端就用 Ollama 或 Tesseract.js 这类离线选项。
- 设快捷键：进入 偏好设置 → 快捷键，为划词翻译、截图 OCR、截图翻译分别绑定组合键，这是日常使用频率最高的功能，务必顺手。
- 确认语言对：在服务设置里调整源语言与目标语言（默认自动检测 → 简体中文），避免翻译方向反了。
各翻译/OCR 接口的接入细节，仓库里每个服务都有独立目录，例如 src/services/translate/openai/ 和 src/services/recognize/tesseract/，翻源码看参数怎么生效是个好习惯。
卡住了怎么办
绝大多数启动问题（Windows 缺 C++ 运行库、macOS 权限弹窗、Linux Wayland 下的快捷键失效等）README 里都给了对症的解法，遇到报错先对着 README.md 的"安装指南"和"故障排除"两节查一遍，能解决大部分坑。系统级能力（剪贴板、截图、托盘）的实现在 src-tauri/src/ 下，排查底层行为时从这里入手最快。
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
 页面边距的类型定义、单位换算与底层实现)
