使用文档

Beyond Translate 使用文档

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

最后更新:

01

安装

如何在 Mac 上安装 Beyond Translate。

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

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

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

02

配置

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

「提供商」保存 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。

03

使用

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

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

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

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

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

04

快捷键

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

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

可用的快捷键动作包括:

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

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

05

故障排除

常见问题及解决方法。

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

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

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

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

需要更多帮助?

在支持页面查找常见问题解答和联系方式。