Bob翻译完整使用教程（macOS）：配置8848AI API，划词截图翻译无缝接入

你有没有这样的经历：

打开一篇英文技术文档，读到一个长难句，下意识地 Cmd+C，切到 Safari，打开 Google 翻译，Cmd+V，等结果，再切回来，找到刚才读到的位置……

一篇文章下来，你在翻译工具和原文之间切换了几十次窗口。不是读不懂，是被这个"切换"的动作磨掉了所有专注力。

而配置好 Bob + 8848AI API 之后，你只需要选中文字，翻译结果就自动弹出来了。整个过程不到 1 秒，不打断任何阅读节奏。

这篇教程，我会带你用 10 分钟完成全套配置，让 AI 翻译真正融入你的工作流。

---

一、为什么说 Bob + AI API 是 macOS 翻译的终极方案？

macOS 自带的"翻译"功能用过就知道：遇到技术文档里的专业术语，翻出来的结果经常让人哭笑不得。DeepL 质量不错，但免费版有字符限制，网页版还是需要切窗口。

Bob 是一款专为 macOS 设计的翻译工具，它的核心价值在于三个能力：

划词翻译：选中任意文字，按快捷键，翻译弹窗即时出现
截图翻译：框选屏幕任意区域，OCR 识别后直接翻译，图片里的文字也不放过
输入翻译：打开翻译框，粘贴长段落，适合处理整段文字

但 Bob 本身只是一个"框架"，翻译质量取决于接入的翻译服务。接入 Google 翻译，质量就是 Google 翻译的水准；接入 GPT-4o，质量就是 GPT-4o 的水准。

接入 AI 大模型之后，翻译质量发生的是质变，不是量变。 AI 能理解上下文、处理长难句、保留技术术语的语义，这是传统翻译引擎做不到的。

而 8848AI（[api.884819.xyz](https://api.884819.xyz)）提供了兼容 OpenAI 接口格式的 API 服务，支持 GPT-4o、Claude 等主流大模型，按量计费、价格透明，是接入 Bob 的最佳搭档。

---

二、准备工作：获取 8848AI API Key（3 分钟搞定）

这一步完成后，你就拥有了调用 AI 翻译能力的"钥匙"。

第一步：注册账号

打开 [api.884819.xyz](https://api.884819.xyz)，点击右上角「注册」，用邮箱完成注册。整个流程不超过 2 分钟。

💡 新用户注册即有免费额度，足够你完成本教程的所有配置和测试，不需要先充值。

第二步：获取 API Key

登录后进入控制台，找到「API Keys」或「密钥管理」入口，点击「创建新密钥」，给它起个名字（比如"Bob翻译"），然后复制生成的 Key。

⚠️ 重要： API Key 只会显示一次，请立即复制并保存到安全的地方（比如备忘录）。格式类似：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

8848AI 的几个关键优势：

接口格式完全兼容 OpenAI，Bob 的 OpenAI 插件可以直接使用，零改造
支持 GPT-4o、GPT-4o-mini、Claude 3.5 等多个主流模型，按需选择
按量计费，没有月费门槛，用多少付多少
控制台可以实时查看用量和余额，完全透明

到这一步，你已经完成了 30%。 接下来安装 Bob。

---

三、Bob 安装与 AI 翻译插件配置（核心步骤）

这是全文最关键的部分，我会拆成三个子步骤，每步都有验证节点。

3.1 安装 Bob

Bob 有两种安装方式：

方式一：Homebrew 安装（推荐开发者）

brew install --cask bob

方式二：官网下载

前往 [Bob 官网](https://bobtranslate.com) 或 Mac App Store 搜索「Bob」下载安装包，双击安装即可。

📌 注意：Bob 分免费版和专业版（Pro）。免费版已经包含划词翻译和截图翻译的核心功能，接入 AI API 不需要购买 Pro 版。

安装完成后，首次启动 Bob 会提示你授予辅助功能权限（用于实现划词翻译）和屏幕录制权限（用于截图翻译）。

这两个权限必须都授予，否则核心功能无法使用。

路径：「系统设置」→「隐私与安全性」→「辅助功能」→ 找到 Bob，打开开关。截图翻译权限同理，在「屏幕录制」里找到 Bob 并授权。

3.2 安装 OpenAI 翻译插件

Bob 通过插件扩展翻译服务。打开 Bob 偏好设置（菜单栏点击 Bob 图标 → 偏好设置，或 Cmd+,），进入「插件」标签页。

点击右下角「获取插件」，会跳转到 Bob 插件商店。搜索「OpenAI」，找到 「OpenAI Translator」 插件，点击安装。

安装完成后，插件会出现在 Bob 偏好设置的插件列表中。

3.3 填写 8848AI 配置（最关键的一步）

点击刚安装的 OpenAI Translator 插件，进入配置页面。你会看到几个关键填写项：

API URL:  https://api.884819.xyz/v1
API Key:  sk-xxxxxxxxxxxxxxxx（填入你在第二章获取的 Key）
Model:    gpt-4o-mini（日常推荐）

⚠️ API URL 的填写是最容易出错的地方，请注意：

- 必须填完整 URL，包括末尾的 /v1

- 不要多加斜杠，正确格式：https://api.884819.xyz/v1

- 不要填成 https://api.884819.xyz（少了 /v1 会报错）

填写完成后，点击「保存」。

验证时刻： 打开任意一个英文网页，选中一段文字，按 Bob 的默认快捷键（Option+D），如果看到翻译弹窗出现，恭喜——最难的部分已经过去了。

---

四、实战演示：三种场景，感受 AI 翻译的质量差距

场景一：阅读英文技术文档 → 划词翻译

打开一篇技术文章，比如 React 官方文档。遇到这样一句话：

"React does not prescribe how you load data, but the most common approach is to use a library like React Query or SWR."

Google 翻译： "React 没有规定如何加载数据，但最常见的方法是使用像 React Query 或 SWR 这样的库。" Bob + GPT-4o-mini： "React 本身不限定数据加载的方式，但业界最常用的方案是借助 React Query 或 SWR 这类库来处理。"

差别在哪？AI 翻译保留了"业界惯用说法"的语感，"prescribe"翻成"限定"而非机械的"规定"，读起来更像一个有经验的工程师在跟你说话。

操作流程： 选中文字 → Option+D → 弹窗出现，0.5 秒内看到结果 → 继续阅读，全程不离开当前窗口。

场景二：图片中的外文 → 截图翻译

遇到 PDF 里的图表、截图里的英文说明，传统翻译工具完全无从下手。

Bob 的截图翻译：按快捷键 Option+S，鼠标变成十字准星，框选屏幕上任意区域，Bob 自动 OCR 识别文字并翻译，结果直接弹出。

这个功能对于读技术书籍扫描版 PDF、看英文软件界面、处理带文字的图片，几乎是无可替代的。

场景三：长段落翻译 → 输入框模式

需要翻译一整段文字时，打开 Bob 的输入翻译窗口（菜单栏图标 → 「文本翻译」），粘贴内容，直接翻译。适合处理邮件、合同条款、技术规范等较长的内容。

进阶技巧：自定义翻译 Prompt

Bob 的 OpenAI 插件支持自定义 System Prompt，这是让翻译质量再上一个台阶的关键。

在插件配置页找到「System Prompt」或「自定义提示词」，填入：

你是一位专业的技术文档翻译专家。请将以下内容翻译为地道的中文，要求：
1. 保持技术术语的准确性，首次出现时在括号内附上英文原文
2. 语言自然流畅，符合中文技术文档的表达习惯
3. 不要逐字翻译，要传达原文的准确含义

加上这段 Prompt 之后，翻译质量会有肉眼可见的提升，尤其是技术文档场景。

---

五、常见问题排查：5 个最容易踩的坑

坑 1：API URL 格式错误

现象： 点击翻译后报错，提示"连接失败"或"404"。 排查： 检查 API URL 是否完整填写为 https://api.884819.xyz/v1，注意末尾的 /v1 不能省略，也不能多加斜杠变成 /v1/。

坑 2：模型名称填写不对

现象： 报错提示"model not found"或"无效模型"。 排查： 模型名称区分大小写，正确写法是 gpt-4o-mini（全小写，中间是连字符）。可以在 8848AI 控制台的模型列表中确认支持的模型名称。

坑 3：辅助功能权限没有授予

现象： 划词翻译完全没反应，快捷键按下去没有弹窗。 排查： 「系统设置」→「隐私与安全性」→「辅助功能」，确认 Bob 的开关是打开状态。如果看不到 Bob，尝试重新启动 Bob 后再检查。

坑 4：快捷键冲突

现象： 按了快捷键，弹出来的不是 Bob，或者什么都没发生。 排查： Option+D 可能被其他应用占用（常见冲突：Alfred、Raycast）。在 Bob 偏好设置的「快捷键」页面修改为不冲突的组合，比如 Option+T。

坑 5：API 余额不足

现象： 偶尔翻译成功，偶尔报错"quota exceeded"。 排查： 登录 [api.884819.xyz](https://api.884819.xyz) 控制台查看余额。8848AI 按量计费，余额用完后需要充值。 费用参考： 使用 gpt-4o-mini 模型，每次翻译消耗约 500-1000 tokens，按 8848AI 的定价估算，每天翻译 50 次，月费用大约在 2-5 元人民币，几乎可以忽略不计。

---