手机能玩 Windows 游戏吗？Winlator 三步跑起来
2026/9/8 22:37:10
pot-desktop 划词翻译工具安装指南：3 步完成部署与上手教程
【免费下载链接】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 三大平台。照本指南操作，10 分钟内在任意 PC 上装好它，并完成划词翻译、输入翻译、截图 OCR 三项核心功能的验收。
⚙️ 环境自检
安装前花 10 秒核对下表，确认系统可用：
| 项目 | 要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10 / macOS / 主流 Linux 发行版 | 官方提供各平台安装包，版本号以仓库最新 release 为准 |
| 内存 | 4GB 起 | 多接口并行翻译会同时发起多个请求 |
| 显示环境 | Linux 下 GNOME / KDE / Hyprland 已实测 | Wayland 可用，个别功能需额外配置 |
| 额外依赖 | Linux deb 包自带 tesseract-ocr 等依赖声明 | 离线 OCR 依赖 Tesseract，deb/rpm 已声明 |
多语言界面共 21 种（见 src/i18n/locales/），首次启动即可切换，无需重启。
💻 安装主路径
每个平台只保留一条首选路径，复制命令直接执行即可。
Windows 安装步骤（Winget）
打开 PowerShell，粘贴以下命令并回车：
winget install Pylogmon.pot备选：
- 手动安装：在 release 页面下载
pot_{version}_x64-setup.exe（64 位）、pot_{version}_x86-setup.exe（32 位）或pot_{version}_arm64-setup.exe（ARM64），双击安装 - 企业版无法安装 WebView2 时：下载内置运行时的
pot_{version}_{arch}_fix_webview2_runtime-setup.exe
macOS 安装步骤（Homebrew）
打开终端，依次执行 2 条命令：
brew tap pot-app/homebrew-tap brew install --cask pot后续升级执行brew upgrade --cask pot。备选：
- 手动安装：在 release 页面下载
pot_{version}_aarch64.dmg（Apple Silicon）或pot_{version}_x64.dmg（Intel），拖入 Applications 完成
Linux 安装步骤（apt-get）
下载与架构对应的 deb 包后，在终端执行：
sudo apt-get install ./pot_{version}_amd64.deb备选：
- Arch/Manjaro：
yay -S pot-translation或paru -S pot-translation；archlinuxcn 源用户可直接sudo pacman -S pot-translation - Flatpak：
flatpak install flathub com.pot_app.pot（注意该版本缺少托盘图标） - 从源码构建：需 Node.js ≥ 18、pnpm ≥ 8.5、Rust ≥ 1.80，执行
pnpm tauri dev调试、pnpm tauri build打包
🚀 首启配置与功能验收
基础配置
- 打开 设置 → 常规：确认界面语言（默认 English）与主题，按需开启开机自启、修改外部调用端口（默认 60828，对应 127.0.0.1:60828）
- 打开 设置 → 快捷键：为划词翻译、输入翻译、截图 OCR、截图翻译 4 项各录入一个组合键并确认注册成功
- 打开 设置 → 服务设置：至少启用一个翻译服务（如百度、OpenAI，或本地 Ollama 离线方案）；需要识别图片时再启用 OCR 服务
功能验收
验收 1：划词翻译
- 在任意应用中用鼠标选中一段英文
- 按下你设置的划词翻译快捷键
- 确认选区旁弹出翻译结果
验收 2：输入翻译
- 按下输入翻译快捷键呼出窗口
- 输入文本后按回车
- 确认返回译文
验收 3：截图 OCR
- 按下截图 OCR 快捷键
- 框选含文字的区域
- 确认返回识别出的文字
流程如下：
成功标志
逐项勾选，全部完成即代表安装成功：
- 系统托盘出现 pot 图标，点击可进入设置
- 4 项快捷键均注册成功（设置页无重复占用提示）
- 至少 1 个翻译服务返回结果
- 划词翻译、输入翻译、截图 OCR 三项验收均通过
🩹 排错速查
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 启动后无界面、托盘点击无反应（Windows） | WebView2 被卸载或禁用 | 重新安装 WebView2；企业版改用fix_webview2_runtime安装包；仍不行则用 Windows 7 兼容模式启动 |
| 提示“无法验证开发者”（macOS） | 未签名隔离属性 | 在 设置 → 隐私与安全性 中点“仍要打开”；仍失败则执行下方命令后重启 |
| 快捷键不生效 | 与其他应用冲突或未授权 | 更换组合键重新注册；macOS 在 隐私与安全 → 辅助功能 中移除 pot 后重新添加 |
| 无法划词翻译（macOS） | 辅助功能权限异常 | 同上，重置辅助功能授权 |
| 启动崩溃（Arch + Nvidia 独显） | Webkit2Gtk 2.42.0 的 DMABUF 问题 | 降级 webkit2gtk，或设置环境变量WEBKIT_DISABLE_DMABUF_RENDERER=1 |
| Wayland 下快捷键失效 | Tauri 快捷键方案不支持 Wayland | 改用系统快捷键 + curl 请求 HTTP 接口触发（见下） |
macOS 隔离属性清理命令：
sudo xattr -d com.apple.quarantine /Applications/pot.appHyprland 下用系统快捷键替代的示例（bind = SUPER, T, exec, curl "127.0.0.1:60828/selection_translate"）：
bind = SUPER, T, exec, curl "127.0.0.1:60828/selection_translate"📮 收尾
以上即 pot-desktop（当前版本 3.0.7）的完整安装与验收流程，全部命令均取自仓库 README.md。装好后如需扩展接口，前往 服务设置 安装.potext外部插件；遇到问题再回到排错速查表，或到仓库 Issues 反馈。
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考