pot-app/pot-desktop 的安装与配置指南

2026-02-04 04:37:06作者：晏闻田Solitary

本文详细介绍了跨平台划词翻译工具 Pot 在 Windows、macOS 和 Linux 系统上的安装与配置方法，包括通过包管理器安装、手动安装步骤、权限配置、快捷键设置以及常见问题解决方案。

Windows 安装与配置

Pot 是一款跨平台的划词翻译软件，支持 Windows、macOS 和 Linux。以下是在 Windows 系统上安装和配置 Pot 的详细指南。

安装方式

1. 通过 Winget 安装

Winget 是 Windows 的包管理工具，可以快速安装 Pot：

winget install Pylogmon.pot

2. 手动安装

访问 Pot 的 Release 页面，下载适用于 Windows 的安装包：
- 64 位系统：pot_{version}_x64-setup.exe
- 32 位系统：pot_{version}_x86-setup.exe
- ARM64 系统：pot_{version}_arm64-setup.exe
双击下载的安装包，按照向导完成安装。

配置指南

1. 快捷键设置

Pot 支持自定义快捷键，方便快速调用翻译功能：

打开 Pot，点击右下角托盘图标。
选择 偏好设置 > 快捷键。
根据需要修改以下快捷键：
- 划词翻译：默认 Alt + S
- 输入翻译：默认 Alt + T
- 截图 OCR：默认 Alt + O
- 截图翻译：默认 Alt + P

2. 服务配置

Pot 支持多种翻译和 OCR 服务，如百度翻译、腾讯翻译等：

在 偏好设置 > 服务设置 中，点击 添加服务。
选择需要的服务（如百度翻译），输入 API Key 或其他必要信息。
保存配置后，即可在翻译时选择该服务。

3. 插件安装

Pot 支持通过插件扩展功能：

访问 Pot 插件列表，下载需要的插件（.potext 文件）。
在 偏好设置 > 服务设置 > 添加外部插件 中，选择下载的插件文件完成安装。

故障排除

1. 启动无界面或托盘图标无响应

原因：可能缺少 WebView2 运行时。
解决方案：
1. 下载并安装 WebView2 运行时。
2. 如果问题仍存在，尝试下载内置 WebView2 的版本 pot_{version}_{arch}_fix_webview2_runtime-setup.exe。

2. 插件安装失败

错误提示：“找不到指定的模块”或“不是有效的 Win32 应用程序”。
解决方案：
1. 确保下载的插件与系统架构匹配（如 64 位系统下载 64 位插件）。
2. 安装 Visual C++ Redistributable。

流程图：Pot 在 Windows 上的工作流程

flowchart TD
    A[启动 Pot] --> B{是否配置服务?}
    B -->|是| C[选择翻译服务]
    B -->|否| D[默认使用系统 OCR]
    C --> E[划词翻译或输入翻译]
    D --> E
    E --> F[显示翻译结果]

表格：常用快捷键

功能	默认快捷键	自定义快捷键
划词翻译	Alt + S	可修改
输入翻译	Alt + T	可修改
截图 OCR	Alt + O	可修改
截图翻译	Alt + P	可修改

代码示例：调用 Pot 的外部 API

Pot 提供 HTTP 接口供其他软件调用：

# 翻译指定文本
curl -X POST http://127.0.0.1:60828/ -d "Hello, world!"
# 打开设置
curl http://127.0.0.1:60828/config

通过以上步骤，您可以在 Windows 上轻松安装和配置 Pot，享受高效的翻译体验。

macOS 安装与配置

Pot 是一款跨平台的划词翻译工具，支持 macOS 系统。以下为 macOS 下的安装与配置指南，涵盖从安装到常见问题的解决方案。

安装方法

通过 Homebrew 安装

添加 Pot 的 Homebrew Tap：
```
brew tap pot-app/homebrew-tap
```
安装 Pot：
```
brew install --cask pot
```
更新 Pot：
```
brew upgrade --cask pot
```

手动安装

从 Release 页面下载最新的 .dmg 安装包：
- M1 芯片用户：下载 pot_{version}_aarch64.dmg
- Intel 芯片用户：下载 pot_{version}_x64.dmg
双击下载的文件，将 Pot 拖入 Applications 文件夹完成安装。

配置与权限

Pot 在 macOS 上需要以下权限才能正常运行：

辅助功能权限：允许 Pot 监听键盘快捷键和划词翻译。
- 打开 系统设置 -> 隐私与安全性 -> 辅助功能，添加 Pot。
屏幕录制权限（可选）：用于截图 OCR 功能。
- 打开 系统设置 -> 隐私与安全性 -> 屏幕录制，添加 Pot。

常见问题

1. 无法打开应用

如果提示“无法验证开发者”，请按以下步骤操作：

点击 取消。
前往 系统设置 -> 隐私与安全性，点击 仍要打开。
在弹出窗口中点击 打开。

如果未找到上述选项，或提示文件损坏，请在终端中运行以下命令：

sudo xattr -d com.apple.quarantine /Applications/pot.app

2. 划词翻译失效

如果划词翻译功能无法使用：

前往 系统设置 -> 隐私与安全性 -> 辅助功能，移除 Pot。
重新添加 Pot 并重启应用。

高级配置

Pot 支持通过插件扩展功能，具体操作如下：

下载插件文件（.potext）。
打开 Pot，进入 偏好设置 -> 服务设置 -> 添加外部插件，选择插件文件安装。

流程图

flowchart TD
    A[安装 Pot] --> B[配置权限]
    B --> C[辅助功能]
    B --> D[屏幕录制]
    C --> E[划词翻译]
    D --> F[截图 OCR]
    E --> G[正常使用]
    F --> G

表格：功能与权限

功能	所需权限	备注
划词翻译	辅助功能	必须配置
截图 OCR	屏幕录制	可选
插件安装	无特殊权限	需下载 `.potext` 文件

通过以上步骤，您可以顺利完成 Pot 在 macOS 上的安装与配置，享受高效的翻译体验。

Linux 安装与配置

Pot 是一款跨平台的划词翻译软件，支持 Linux 系统。以下是在 Linux 系统上安装和配置 Pot 的详细指南。

安装方法

Debian/Ubuntu

下载安装包
从 Release 页面下载最新的 .deb 安装包。根据你的系统架构选择合适的版本：
- pot_{version}_amd64.deb：适用于 64 位系统。
- pot_{version}_universal.deb：适用于依赖 glibc2.28 和 openssl-1.1 的系统。

安装
使用以下命令安装：

sudo apt-get install ./pot_{version}_amd64.deb

Arch/Manjaro

通过 AUR 安装
使用 AUR 助手（如 yay 或 paru）安装：
```
yay -S pot-translation
```
或
```
paru -S pot-translation
```
通过 archlinuxcn 源安装
如果已启用 archlinuxcn 源，可以直接使用 pacman 安装：
```
sudo pacman -S pot-translation
```

Flatpak

Pot 也支持 Flatpak 安装，但请注意 Flatpak 版本可能缺少托盘图标支持。
安装命令：

flatpak install flathub com.pot_app.pot

配置指南

依赖项

确保系统已安装以下依赖项：

tesseract-ocr：用于系统 OCR 功能。
webkit2gtk：用于渲染界面。

环境变量

如果使用 Nvidia 专有驱动，建议在 /etc/environment 中添加以下环境变量以避免兼容性问题：

WEBKIT_DISABLE_DMABUF_RENDERER=1

快捷键设置

Pot 支持自定义快捷键，可通过以下步骤配置：

打开 Pot 设置界面。
导航至“快捷键”选项卡。
根据需要修改划词翻译、输入翻译等快捷键。

插件安装

Pot 支持通过插件扩展功能。插件安装方法如下：

从 Plugin List 下载 .potext 文件。
在 Pot 设置中，选择“服务设置” > “添加外部插件” > “安装外部插件”，选择下载的 .potext 文件。

常见问题

启动失败

如果 Pot 无法启动，请检查日志文件：

journalctl -u pot --no-pager -n 100

划词翻译失效

确保已启用辅助功能权限：

打开系统设置。
导航至“隐私” > “辅助功能”。
确保 Pot 已添加到允许列表中。

流程图

flowchart TD
    A[下载安装包] --> B[安装依赖项]
    B --> C[配置环境变量]
    C --> D[启动 Pot]
    D --> E[设置快捷键]
    E --> F[安装插件]

表格：支持的 Linux 发行版

发行版	安装方法	备注
Debian/Ubuntu	`.deb` 包	支持 64 位和通用依赖版本
Arch/Manjaro	AUR 或 `archlinuxcn` 源	需注意 `webkit2gtk` 兼容性
Flatpak	`flatpak install`	可能缺少托盘图标支持

常见问题与故障排除

Pot 是一款功能强大的跨平台翻译工具，但在使用过程中可能会遇到一些问题。以下是一些常见问题及其解决方案，帮助您快速解决问题并恢复使用。

1. 安装问题

1.1 Windows 安装失败

问题描述：安装过程中提示缺少依赖或安装失败。
解决方案：
- 确保系统已安装 WebView2。
- 如果安装失败，尝试下载内置 WebView2 的版本 pot_{version}_{arch}_fix_webview2_runtime-setup.exe。

1.2 macOS 安装提示“无法验证开发者”

问题描述：安装时提示“无法验证开发者”。
解决方案：
- 右键点击 .dmg 文件，选择“打开”。
- 如果仍然无法安装，运行以下命令：
```
sudo xattr -d com.apple.quarantine /Applications/pot.app
```

1.3 Linux 依赖问题

问题描述：运行时报错，提示缺少依赖。
解决方案：
- 确保已安装 webkit2gtk 和 openssl。
- 对于 Arch Linux，如果遇到 WebKit2Gtk 问题，添加环境变量：
```
echo "WEBKIT_DISABLE_DMABUF_RENDERER=1" | sudo tee -a /etc/environment
```

2. 功能问题

2.1 划词翻译失效

问题描述：选中文本后按下快捷键无反应。
解决方案：
- 检查快捷键设置是否正确（偏好设置 > 快捷键）。
- 确保 Pot 已获得辅助功能权限（macOS 需在“系统设置 > 隐私与安全性 > 辅助功能”中添加 Pot）。

2.2 OCR 识别失败

问题描述：截图 OCR 无法识别文字。
解决方案：
- 确保已启用 OCR 服务（偏好设置 > 服务设置）。
- 检查网络连接（部分 OCR 服务需联网）。

2.3 插件安装失败

问题描述：插件安装后无法使用。
解决方案：
- 确保插件文件格式为 .potext。
- 检查插件是否与当前系统架构兼容（如 Windows 需区分 x86 和 x64）。

3. 性能问题

3.1 启动缓慢

问题描述：Pot 启动时间过长。
解决方案：
- 关闭不必要的插件或服务。
- 检查系统资源占用情况。

3.2 内存占用高

问题描述：Pot 占用内存过高。
解决方案：
- 减少并行翻译服务数量。
- 更新到最新版本（可能已优化内存管理）。

4. 其他问题

4.1 托盘图标消失

问题描述：托盘图标偶尔消失。
解决方案：
- 重启 Pot。
- 检查系统托盘设置（部分 Linux 桌面环境需手动启用托盘图标）。

4.2 外部调用失败

问题描述：HTTP 接口无法调用。
解决方案：
- 确保 Pot 正在运行且端口未被占用。
- 检查防火墙设置（部分系统可能阻止本地 HTTP 请求）。

以下是一个简单的流程图，展示了解决常见问题的步骤：

flowchart TD
    A[问题发生] --> B{问题类型}
    B -->|安装问题| C[检查依赖和权限]
    B -->|功能问题| D[检查设置和服务]
    B -->|性能问题| E[优化配置]
    C --> F[安装依赖或修复权限]
    D --> G[调整设置或重启服务]
    E --> H[关闭插件或更新版本]
    F --> I[问题解决]
    G --> I
    H --> I

如果以上方法无法解决问题，请尝试以下步骤：