企业官网建设流程全解析

如何快速上手 pot-desktop 划词翻译：从安装到截图 OCR 的 5 分钟完整指南

【免费下载链接】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 是什么

pot-desktop 基于 Tauri 框架构建，系统层为 Rust、界面层为 React，支持 Windows、macOS、Linux 三大桌面系统，并兼容 Wayland 环境。它把翻译、识别、语音合成拆成可配置的服务，用户按需在偏好设置里启用。

各平台安装命令与首次运行

首次运行三步跑通：

1. 安装后启动，程序常驻系统托盘，没有主窗口。
2. 点击托盘图标打开偏好设置，在"服务设置"里添加并启用一个翻译服务（需要 API Key 的服务填写后保存）。
3. 在"快捷键"页为划词翻译设置一组按键（如 Ctrl+T），选中文本按下后弹出翻译窗口即算跑通。

第一次划词翻译

前置条件：已启用至少一个翻译服务；已在偏好设置的快捷键页设置划词快捷键；macOS 用户需授予辅助功能权限。

1. 打开任意带文本的页面，例如浏览器中的外文文章。
2. 用鼠标选中要翻译的单词或句子。
3. 按下刚设置的划词快捷键。
4. 鼠标位置附近弹出翻译窗口，显示原文与译文。

你会看到译文与原文分栏展示，窗口右上角提供复制、朗读等操作；若配置了第二目标语言，会同时给出第二种译文。

四个常见任务的完成方式

把图片里的文字变成可复制文本

扫描文档、聊天截图中常有无法选中的外文。

1. 在"服务设置"的识别分类里启用一个 OCR 服务，系统内置 OCR 在 Windows、macOS 上可离线使用，Linux 基于 Tesseract。
2. 在快捷键页设置截图 OCR 快捷键。
3. 按下快捷键，用鼠标框选要识别的区域。
4. 识别完成后，文字显示在结果窗口中，可直接复制。

直接翻译截图里的外文

遇到整段外文图片时，省去"先识别再手动复制"的步骤。

1. 确认 OCR 服务与翻译服务都已启用。
2. 设置截图翻译快捷键。
3. 按下快捷键并框选区域，程序先识别文字、再自动送入翻译服务。
4. 窗口直接展示原文识别结果与译文。

一次性翻译整篇文章

整封邮件或一段文档内容，用输入翻译模式批量处理。

1. 设置输入翻译快捷键。
2. 按下快捷键呼出翻译窗口。
3. 粘贴或输入待翻译文本。
4. 按回车，译文按所选服务返回。

关键配置：偏好设置-翻译页可调整目标语言、是否自动删除换行、是否记住目标语言，长文翻译建议开启"自动删除换行"。

复制内容就自动翻译

不想按快捷键时，可以开启剪切板监听。

1. 在任意翻译面板左上角点击图标，启动剪切板监听。
2. 在任意位置选中文字并复制。
3. 复制完成即自动触发翻译，结果直接在原面板刷新。

再点一次左上角图标即可关闭监听，避免复制无关内容时频繁弹窗。

默认配置值与个性化调整

高级能力收敛为三点：

• 插件系统：偏好设置-服务设置-添加外部插件中选择.potext文件安装，安装后与内置服务同等使用；Ollama（离线）、Lingva、Paddle 等扩展能力均通过插件提供。
• 外部 HTTP 接口：程序在本地监听端口（默认 60828），/selection_translate、/input_translate、/ocr_recognize等端点可被其他脚本触发，例如终端执行curl "127.0.0.1:60828/selection_translate"即可触发划词翻译。
• 第三方工具集成：Windows 的 SnipDo 与 macOS 的 PopClip 均有对应扩展，选中文字后直接出现翻译按钮。

遇到这些情况时

1. 现象：启动后没有界面，点托盘无反应。原因：Windows 系统缺少或被禁用了 WebView2。动作：安装 WebView2 运行库，或改用内置 WebView2 的 fix_webview2 版安装包。
2. 现象：macOS 提示"无法验证开发者"无法打开。原因：系统 Gatekeeper 限制。动作：在"设置-隐私与安全性"点击"仍要打开"；若提示文件损坏，在终端移除该应用的隔离属性后再启动。
3. 现象：macOS 下快捷键无响应或无法划词翻译。原因：辅助功能权限异常。动作：在"设置-隐私与安全性-辅助功能"中先移除 pot，再重新添加。
4. 现象：Wayland 下应用内快捷键与内置截图不可用。原因：全局快捷键方案与 Wayland 不兼容。动作：在桌面环境绑定系统级快捷键，通过本机 HTTP 接口调用对应功能，截图交给系统工具完成。
5. 现象：翻译服务请求报错。原因：API Key 未填写、服务未启用或网络需代理。动作：回到服务设置核对配置；处于代理网络时在偏好设置-常规填写代理地址。

适合哪些人使用

• 经常阅读外文论文、技术文档、论坛帖子的读者，选词即译不打断阅读。
• 语言学习者：查词后可直接发送到 Anki 等生词本，形成背词闭环。
• 频繁处理含文字图片的办公与开发场景，如扫描件、聊天截图、公式图片。
• 希望在自己脚本或工具中调用翻译与识别能力的开发者，本地 HTTP 接口开箱即用。

它更偏向高频、轻量的翻译与识别，偶尔翻译一两句话用浏览器自带功能已足够；对整份文档的排版级翻译处理，也不是它的目标场景。

收尾

pot-desktop 用划词翻译、截图 OCR、输入翻译三条路径覆盖了日常外文处理，跨平台一致且服务可插拔。项目仓库的 README 是最完整的使用与 API 文档，遇到本文未覆盖的问题可优先查阅。

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