# Beyond Translate 使用文档

> 从安装原生 macOS 应用、选择翻译或 OCR 服务到捕获屏幕文字开始使用。可用功能因平台和版本而异。

- 最后更新: 2026-11-19
- Canonical URL: https://beyondtranslate.com/zh/docs

## 安装

如何在 Mac 上安装 Beyond Translate。

官网目前通过 Apple TestFlight 提供原生 macOS 测试版，Mac App Store 和独立 DMG 安装包在下载页列为即将推出。

- 从 Mac App Store 安装 Apple 的 TestFlight 应用。
- 在下载页面打开 Beyond Translate 公开邀请链接，并在 TestFlight 中接受测试。
- 通过 TestFlight 安装和更新 Beyond Translate，并确认其中列出的系统要求。

安装后启动应用。macOS 原生版首次启动会显示设置引导，完成后进入主窗口。迷你翻译器可通过菜单栏、托盘菜单或已配置的全局快捷键单独打开。

## 配置

连接提供商，选择翻译和文字识别服务。

「提供商」保存 API Key、服务器地址等连接信息；「服务」决定通过该提供商使用什么能力，例如某个翻译或 OCR 模型。填入凭据后，还需要添加服务并设为默认。

1. 打开「设置 → 服务」，添加翻译服务。选择提供商，填写所需连接信息，测试连接，并按提示选择模型。
2. 保存服务后，在可用服务列表中启用它，并将希望优先使用的服务设为默认。已保存的连接可以在「设置 → 提供商」中管理。
3. 在「设置 → 服务」中配置翻译目标和常用语言。如需识别截图或图片中的文字，还要在这里选择默认 OCR 服务。

- macOS 系统翻译 — 无需第三方 API Key。当前集成需要 macOS 26 或更新版本，并已安装所用语言对的语言文件。
- AI 翻译（BYOK） — macOS 原生版内置 OpenAI、Anthropic（Claude）、Google Gemini、DeepSeek、通义千问、Kimi（Moonshot AI）、智谱、豆包、硅基流动，以及任意 OpenAI 兼容接口（可对接自托管 vLLM、SGLang 或 Ollama）。云端服务需要各自账号与 API 密钥。
- macOS 本地模型 — 在「设置 → 提供商 → 本地模型 → 管理与下载」中选择 Hy-MT2 或 Gemma 3。Hy-MT2 1.8B Q4（约 1.13 GB，至少 4 GiB 内存）和 7B Q4（约 4.62 GB，至少 8 GiB 内存）支持断点续传与固定 SHA256 校验，下载后全程离线运行，无需密钥。
- 截图与图片 OCR — 可使用 macOS 内置文字识别，也可在提供商设置中下载离线 PaddleOCR（PP-OCRv6 Small）模型并设为默认 OCR 服务。

不同版本的服务列表可能不同。百度、DeepL、Google Cloud 等传统翻译提供商，以及独立词典和朗读界面，目前未在 macOS 原生版界面开放。请以已安装版本中的服务列表为准。

使用云端翻译会将提交的文字发送给所选提供商，并可能产生提供商侧的费用。本地模型和离线 PaddleOCR 需要预先下载模型文件，推理时无需云端 API Key。

## 使用

使用不同方式捕获文字并进行翻译。

根据平台和版本，你可以通过以下方式获取要翻译的文字：

- 划词取词 — 在其他应用中选中可复制的文字，再按划词取词快捷键。禁止复制的应用可能不支持这种方式。
- 截图取词 — 按截图取词快捷键后框选区域，由默认 OCR 服务识别文字，再进行翻译。
- 剪贴板取词 — 复制文字后按剪贴板取词快捷键。支持剪贴板图片的版本会将图片交给默认 OCR 服务识别。
- 直接输入 — 在主窗口或迷你翻译器中输入、粘贴文字，然后按设置的提交快捷键或点击翻译按钮。

自动模式下，应用会检测源语言并匹配已启用的翻译目标；你也可以手动选择语言。默认翻译服务提供首选结果，需要其他已启用服务的译文时，可使用对比功能。响应时间取决于服务、网络和模型。

点击译文旁的复制按钮即可复制结果。双击复制是否可用取决于版本和相关设置。取词结果通常在迷你翻译器中打开；macOS 原生版可在「设置 → 服务」的文字识别「取词行为」中修改取词结果的显示位置。

## 快捷键

配置全局快捷键以提高工作效率。

应用运行时，可在「设置 → 快捷键」中配置全局快捷键。macOS 原生版默认使用 Option（⌥）键；其他平台可能将该修饰键显示为 Alt。已保存的快捷键以设置页面为准。

可用的快捷键动作包括：

- 显示或隐藏迷你翻译器 — macOS 默认 Option+1
- 划词取词 — macOS 默认 Option+Q
- 截图取词 — macOS 默认 Option+W
- 剪贴板取词 — macOS 默认 Option+E

输入框的提交操作属于应用内快捷键，与全局快捷键分开设置。macOS 原生版可在「设置 → 快捷键」中选择按 Enter 或 Command+Enter 提交。如果全局快捷键被系统或其他应用占用，请更换组合。

## 故障排除

常见问题及解决方法。

翻译失败时，请检查是否已启用翻译服务并设为默认、所选模型和语言对是否受支持，以及所需凭据是否有效。云端服务还需要正常的网络连接和足够的提供商额度；本地模型则需要先完成模型下载。

macOS 划词取词需要「辅助功能」权限，截图取词需要「屏幕录制」权限。请在「系统设置 → 隐私与安全性」中的对应项目启用 Beyond Translate；较新的 macOS 版本可能将后者命名为「屏幕与系统音频录制」。修改屏幕录制权限后，退出并重新打开应用，再检查权限状态。

macOS 系统翻译提示缺少语言文件时，请先在「系统设置 → 通用 → 语言与地区 → 翻译语言」中安装源语言和目标语言，再重试。如果语言对或系统版本不受支持，请改用其他翻译服务。

如果问题仍然存在，请通过支持页面反馈，并附上应用版本、操作系统、复现步骤和界面上的错误信息。分享截图或日志前，请移除 API Key 和私人文字。
