pot-desktop 划词翻译:用 SnipDo 在 Windows 上实现选中即译
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
你在浏览器里读英文文档、在 IDE 里看一段报错信息时,是不是经常先选中文字、按 Ctrl+C,再切窗口、按 Ctrl+V?这套动作做下来,思路早就断了。pot-desktop 划词翻译配合 SnipDo 之后,流程变成:选中一段文字,SnipDo 在光标旁弹出一个小工具条,点一下"翻译",译文窗口直接出现。整个过程不用切换窗口,也不用复制粘贴。这篇文章带你从零把这套组合装好、跑通,并告诉你出问题时该查哪里。
你能拿到什么
- 一套装好的 Windows 划词翻译环境:选中文字 → 点一下 → 出译文
- 会改本地监听端口,避开和其他程序的端口冲突
- 会用 PowerShell 直接调用翻译接口,绕过 SnipDo 也能触发
- 遇到"划词没反应""接口不通"时,知道按什么顺序排查
动手前核对一下环境
| 项目 | 要求 | 从哪获取 |
|---|---|---|
| 操作系统 | Windows 10 或 11 | — |
| pot-desktop | 当前发布的版本 | 官方 Release 页面的 Windows 安装包 |
| SnipDo | 商店里的最新版 | Microsoft Store,搜索 SnipDo |
| WebView2 运行时 | 系统自带 | 一般不需要单独装 |
如果 Release 页面找不到对应系统位数的安装包,以官方最新版本为准。
主线流程:三个阶段装好
阶段一:装 pot-desktop
目标:让你的电脑上有能接收翻译请求的本体程序。
操作:
- 打开官方 Release 页面,下载 Windows 安装包,双击安装。
- 装完先打开一次,让它跑起来。安装后建议顺手在设置里选一个你能正常使用的翻译服务,否则划词后没有译文可返回。
也可以不手动下载,在 PowerShell 里执行:
winget install Pylogmon.pot # 官方仓库提供的包名验证:右键系统托盘,确认 pot 的图标在;打开任意网页,选中一段英文,按软件设置的划词快捷键(在 设置 → 快捷键 里能看到默认值),弹出翻译窗口说明本体工作正常。
阶段二:装 SnipDo
目标:装一个"在你选中文本时弹工具条"的辅助工具。
操作:打开 Microsoft Store,搜索"SnipDo",点安装。装完后不用做任何配置。
验证:在任意应用里选中一段文字,光标旁边会弹出 SnipDo 工具条。此时工具条上的按钮还跟 pot 没关系,下一步才接上。
阶段三:下载并加载 pot 的 SnipDo 扩展
目标:让 SnipDo 工具条上的"翻译"按钮能真正调用 pot-desktop。
操作:
- 回到 pot-desktop 的官方 Release 页面,在附件列表里找到
pot.pbar文件,下载。 - 双击这个文件,SnipDo 会自动识别并装好扩展。
- 装完不用重启电脑,确认 SnipDo 和 pot 都在后台运行即可。
验证:选中一段文字 → 工具条弹出 → 点"翻译"按钮 → pot 的翻译窗口出现。走到这一步,整个集成就完成了。
触发链路一共就 4 步:
你刚配好的东西是怎么跑的
装完之后,pot-desktop 会在本机开一个 HTTP 服务器,默认监听 127.0.0.1 的60828端口。你点 SnipDo 工具条上的按钮时,SnipDo 发一条请求到这个端口,pot 收到后调用你配置的翻译服务,再把结果弹出来。整个过程走本机回环地址,不经过外网,所以请求几乎不产生网络延迟。
常用端点一览(定义见 src-tauri/src/server.rs):
| 端点 | 作用 | 说明 |
|---|---|---|
/translate | 文本翻译 | POST,请求体是要翻译的原文 |
/selection_translate | 划词翻译 | GET,触发 pot 的划词翻译流程 |
/input_translate | 输入框翻译 | GET,唤起输入式翻译窗口 |
/ocr_translate | 截图识别并翻译 | GET,可带screenshot=true/false参数 |
/ocr_recognize | 截图识别文字 | GET,只识别不翻译 |
/config | 打开设置窗口 | GET |
除了点 SnipDo 按钮,你在网页、代码里选词时 pot 自己的划词快捷键依然有效,两条路都能进同一个翻译流程,怎么顺手怎么来。
常见情况与处理
情况 1:选中文本后,SnipDo 工具条不弹
- 可能原因:SnipDo 没在后台运行;扩展没装上;某些应用(如部分全屏游戏、部分受保护的窗口)不允许弹出浮层。
- 处理:先看任务栏确认 SnipDo 在运行,不在就重新打开它;再回到 Release 页重新下载
pot.pbar,双击一次重新安装扩展。如果只在某个特定应用里不弹,先换普通网页试,能弹就说明是那类应用本身的限制。
情况 2:工具条能弹,但点"翻译"没反应或报错
- 可能原因:pot-desktop 没在后台运行,所以 60828 端口没人应答。
- 处理:检查托盘里有没有 pot 图标。没有就启动它;有的话重启一次 pot 再试。
情况 3:请求通了,但翻译结果是空的或报错
- 可能原因:还没在 pot 里配置可用的翻译服务,或者所配服务的密钥、额度有问题。
- 处理:打开 pot 设置,在"翻译"里换一个你确定能用的服务并填好参数,先手动复制一段文字测一遍,通了再回去用 SnipDo。
进阶两个小技巧
改默认端口。60828 被别的程序占了、或者你想换个端口时:打开 pot 设置 → 通用,找到"监听端口",填新端口号。改动要重启应用才生效(设置界面会有提示)。改完记得确认 SnipDo 扩展里指向的端口和 pot 一致,具体配置项以官方最新版本为准。
用命令行直接触发。不想装 SnipDo、或者想写脚本批量触发时,可以直接调接口:
# 触发一次划词翻译流程 Invoke-WebRequest -Uri "http://127.0.0.1:60828/selection_translate" -Method Get # 直接把一段文本 POST 给翻译接口,pot 会弹出译文窗口 Invoke-WebRequest -Uri "http://127.0.0.1:60828/translate" -Method Post ` -Body "Hello World" -ContentType "text/plain"返回ok就说明请求被 pot 正常接收。
收尾清单
- 打开 Release 页面,装好 pot-desktop 并在设置里配好一个能用的翻译服务
- 从 Microsoft Store 装好 SnipDo,选词能弹工具条
- 下载
pot.pbar并双击安装扩展,点一下"翻译"能出译文 - 记住默认端口 60828,需要时去"通用"设置里改
- 保留上面那段 PowerShell 命令,排障时用来确认接口是否通
到这里,你电脑上"选词 → 出译文"的链路就完整了:以前一次查询要切窗口、复制、粘贴三步,现在只要一次点击。
【免费下载链接】pot-desktop🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition.项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考