pot-desktop

环境要求

• Windows、macOS 或 Linux 桌面系统
• Windows 使用 Winget 或下载 exe 安装包；macOS 使用 Brew 或下载 dmg 安装包
• 使用外部调用/系统快捷键触发时，系统需能执行 curl 命令
• 纯 Wayland 桌面环境（如 Hyprland）需自备截图工具（如 grim、slurp）

安装与启动步骤

1. 1Windows 用 Winget 安装

   在 PowerShell 中执行 Winget 命令直接安装 pot，无需手动下载安装包，适合大多数 Windows 用户。

   winget install Pylogmon.pot

   复制

2. 2Windows 手动安装

   在 Release 页面下载最新安装包：64 位选 pot_{version}_x64-setup.exe，32 位选 x86，arm64 选 arm64，然后双击安装。

3. 3macOS 用 Brew 安装

   先添加 pot-app 的 tap，再用 cask 安装 pot；后续可用 upgrade 命令更新。

   brew tap pot-app/homebrew-tap
   brew install --cask pot

   复制

4. 4macOS 手动安装

   从 Release 页面下载 dmg：M1 芯片下载 pot_{version}_aarch64.dmg，其他下载 pot_{version}_x64.dmg，双击后拖入 Applications。

5. 5安装外部插件

   到 Plugin List 查插件并在插件仓库下载扩展名为 .potext 的文件，再在偏好设置中导入。

6. 6导入 .potext 插件

   打开 偏好设置-服务设置-添加外部插件-安装外部插件，选择下载好的 .potext 文件，安装后加入服务列表即可使用。

7. 7Wayland 配置截图调用

   Hyprland 下用 grim 和 slurp 截图并写入指定缓存路径，再用 curl 调用本地接口触发 OCR 或翻译。

   bind = ALT, X, exec, grim -g "$(slurp)" ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl "127.0.0.1:60828/ocr_recognize?screenshot=false"
   bind = ALT, C, exec, grim -g "$(slurp)" ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl "127.0.0.1:60828/ocr_translate?screenshot=false"

   复制

关键配置

如何确认成功

安装后启动 pot，用鼠标选中文字并按下划词翻译快捷键，能弹出翻译结果窗口即说明安装成功。

常见问题

注意事项

• Wayland 环境下 pot 内置快捷键不可用，需改用系统快捷键加 curl 外部调用
• 外部截图方案依赖固定的截图文件路径，请确保截图工具输出到该路径
• 插件文件扩展名必须是 .potext，安装后需添加到服务列表才会生效
• Windows 安装包需按 32 位、64 位、arm64 选择对应版本