Pot-desktop 安装教程：3 步跑通跨平台划词翻译与 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 三端通用。想告别鼠标逐词查词的你，跟着这篇三步教程装好它。
一、先把 Pot-desktop 跑起来
全程只需要 3 条命令，跑完就能看到翻译窗口。
克隆代码到本地：
git clone https://gitcode.com/GitHub_Trending/po/pot-desktop进入目录并安装依赖：
cd pot-desktop pnpm install启动开发模式，稍等片刻窗口就会弹出：
pnpm tauri dev
看到主窗口后，划一下鼠标选中的英文单词，按划词快捷键，翻译结果就弹出来了：
二、装前 2 分钟自查 📋
上一步如果报错，先对照下表确认依赖版本。三项都满足，直接回去执行命令即可。
| 依赖 | 最低版本 | 一句话作用 |
|---|---|---|
| Node.js | 18.0.0 | 驱动前端构建工具 |
| pnpm | 8.5.0 | 安装与管理项目依赖 |
| Rust | 1.80.0 | 编译 Tauri 后端 |
三、跑通之后必做的 3 件事
- 选翻译服务并填密钥：打开主窗口，进入「偏好设置 → 服务设置 → 翻译」，选中一个服务（如百度、腾讯），在弹出的配置框里填入你的 App ID 和密钥。没有密钥接口就调不通，这一步决定翻译能不能用。
- 确认快捷键：打开「偏好设置 → 快捷键」，检查划词翻译、截图 OCR 两个默认键，改成你顺手的组合。快捷键冲突时功能会失灵，改完立即生效。
- 开启剪切板监听：在「偏好设置 → 常规」里打开剪切板监听。之后在任何地方复制外文，翻译面板直接出结果，省掉手动划词。
四、它为什么又快又轻 ⚡
Pot-desktop 的外壳是 Tauri——用 Rust 写的轻量跨平台框架，装好的包体比 Electron 方案小得多。界面层是常规的 React 网页前端，你熟悉的浏览器技术栈。离线 OCR 由 Tesseract.js 以 WebAssembly 形式运行，也就是让识别引擎直接在浏览器环境里跑，不依赖系统装插件；翻译历史则存在本地 SQLite（一个单文件数据库）里，数据不离开你的电脑。
五、装不上？对号入座 🔧
现象：Windows 下启动后没有界面，点托盘图标没反应。原因：系统缺少 WebView2 运行时。修复：安装 WebView2 运行时后重启软件。
现象：macOS 提示"无法打开 pot"。原因：系统没有验证过开发者身份。修复：打开「系统设置 → 隐私与安全性」，点"仍要打开"。
现象：Arch/Manjaro 上启动即崩溃（N 卡）。原因：专有驱动的 DMABUF 与新版渲染不兼容。修复：在
/etc/environment中加入WEBKIT_DISABLE_DMABUF_RENDERER=1。
更多平台的细节可以翻 README.md 的安装指南章节。现在打开终端，把第一节的三条命令敲完，跑起来就停不下来了。
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
