在 macOS 上安装 AI Translator

你的 Mac 能运行吗？

芯片

Apple 芯片（M1 或更新）
没有 Intel Mac 版本。可在苹果菜单 › 关于本机中查看芯片。

操作系统

macOS 14.2 或更高版本

内存

最低 8 GB，建议 16 GB
内存不足 8 GB 时，应用会说明原因，并且不会下载模型。

安装包

约 9 MB 的 .dmg 文件

模型所需磁盘空间

1.3 GB（Lite 模型包）或 2.5 GB（Standard 模型包）
下载时还需要额外 1 GB 可用空间。

网络

下载模型和登记 Free 试用时需要
之后翻译离线运行。

我们没有在基础款 M1 Mac 上测量过性能，所以无法保证那里的延迟。在 8 GB 内存的 Mac 上，选择 Lite 模型包比较合理。

快捷方式：用一条命令安装

1. 打开终端：按 ⌘ + Space，输入终端，按 Enter。
2. 粘贴下面的命令并按 Enter。不需要输入密码。

curl -fsSL https://aitranslator.vn/install.sh | bash

3. 等待大约一分钟。命令会下载最新的 AI Translator，核对 SHA-256，检查应用的签名，把应用复制到 /Applications（如果该位置不可写，则复制到 ~/Applications）并打开它。
4. 当 macOS 请求系统音频录制权限时，请选择“允许”。然后继续阅读快速入门指南。

为什么没有“仍要打开”这一步？macOS 只会阻止带有“从互联网下载”标记（由浏览器添加）的文件中的应用。用终端里的 curl 下载的文件没有这个标记，所以即使 Apple 没有公证，应用也会直接打开。

出了问题？脚本会停下来并说明原因（不支持的 Mac、没有网络、SHA-256 不匹配……）。请参阅常见安装问题。

另一种方式：用 .dmg 文件安装

如果你是通过邮件收到的 .dmg，或者不想使用终端，可以用这种方式。在浏览器中下载的文件会被 macOS 加上“从互联网下载”的标记，所以第一次打开时需要额外的“仍要打开”步骤。

核对安装包（SHA-256）

我们通过邮件发送的每个安装包都附有 SHA-256 校验值。安装前请核对：

1. 打开终端（应用程序 › 实用工具）。
2. 输入 shasum -a 256 并加一个空格，从访达把 .dmg 文件拖进终端窗口以填入路径（文件名中的空格也会包含在内），然后按 Enter。也可以输入下面的命令；如果文件名中有空格，请像示例那样用双引号括起来。

shasum -a 256 ~/Downloads/"<file-name>.dmg"

3. 把输出的 64 个字符与我们发给你的进行比较。两者必须完全相同。
4. 如果不同，请不要打开文件。重新下载；如果仍然不同，请联系客服。

把 AI Translator 拖到“应用程序”

1. 双击 .dmg 文件打开它。
2. 在出现的窗口中，把 AI Translator 拖到应用程序文件夹。

首次启动：macOS 为什么会阻止，以及如何允许

macOS 用“门禁”（Gatekeeper）检查从互联网下载的应用。当前的 AI Translator 版本是临时签名，还没有经过 Apple 公证，因为我们还没有 Apple Developer ID。所以 macOS 会阻止第一次打开，并提示无法验证开发者。如果文件来自我们并且 SHA-256 一致，这就是这个版本的正常流程。

1. 从“应用程序”中打开 AI Translator。当 macOS 提示无法验证开发者时，点击完成（关闭对话框的按钮；不同 macOS 版本上的文字可能略有不同）。
2. 打开系统设置 › 隐私与安全性。
3. 滚动到页面底部，点击 AI Translator 旁边的仍要打开。
4. 用登录密码或触控 ID 确认。
5. 应用会打开并显示首次设置。继续阅读快速入门指南。

只有在浏览器中下载的 .dmg 才需要这一步；用一行命令安装则不需要。等我们有了 Developer ID 并为应用完成公证后，无论用哪种方式安装，这一步都会消失。

每次更新时，macOS 会再问一件事

先说更新的方式：应用在打开大约一分钟后检查新版本，之后每 24 小时检查一次，并在后台下载；准备好后，应用会询问“重启”还是“稍后”（托盘菜单中也有“重启以更新”），新版本会在你重启或选择“退出”时安装。更新通道（稳定版或 Beta）在“设置 › 通用”中选择，更改后会立即检查。要立即检查，请在“设置 › 通用”中点击检查更新，或从应用图标菜单中选择“检查更新…”。

其余的是临时签名带来的结果：每个新版本的签名都不同，所以 macOS 会再次请求钥匙串访问权限。从 0.1.1 版开始，AI Translator 把所有敏感数据（历史记录的加密密钥、许可证令牌、翻译时长计数）保存在一个钥匙串项目中，所以每次更新后你会看到：

• 1 个钥匙串对话框，要求输入 Mac 的登录密码（我们在一台运行 macOS 26 的 Mac 上测量过：为模拟新版本把应用重新签名两次，每次都只有 1 个对话框）：输入密码并选择始终允许。不要选择“拒绝”：应用将无法读取你的许可证和翻译时长。如果不小心选了，请完全退出应用，重新打开，然后选择“始终允许”。
• 可能会再请求一次系统音频录制权限（我们之前的测量记录到 1 个对话框）：请允许。

只有从 0.1.0 到 0.1.1 的第一次更新不同：应用需要把 5 个旧的钥匙串项目复制到新项目中，所以你会一次性看到 5 个钥匙串对话框（我们测得正好 5 个，另加 1 个允许录音的对话框）；之后的更新只有 1 个。

选择“始终允许”后，之后的启动不会再询问。你不会丢失数据、套餐或翻译时长。在全新安装时，我们没有测到钥匙串对话框（只有录音权限，以及从浏览器下载的 .dmg 安装时的“仍要打开”）；如果 macOS 仍然询问，请选择“始终允许”。应用会在更新提示中提前告诉你。等我们有了 Developer ID，这种情况就会消失。你也可以运行同一条安装命令来更新；出于同样的原因，也会出现钥匙串对话框。

正确卸载

删除应用时，macOS 不会给它清理的机会，所以请先删除模型和数据，再把应用移到废纸篓：

1. 打开 AI Translator，进入设置 › 隐私。
2. 点击删除模型和数据，然后用全部删除确认。应用会删除所有已下载的模型（1.3 GB 或 2.5 GB）、历史记录和术语表。
3. 从菜单栏中的 AI Translator 图标选择退出。
4. 把 AI Translator 从“应用程序”拖到废纸篓。

你的许可证和剩余翻译时长会保留，所以重新安装不会丢失已购买的套餐。Free 试用与你的 Mac 绑定，所以重新安装不会重新开始 10 天。如果你已经删除了应用却没有删除模型，模型位于 ~/Library/Application Support/com.aitranslator.desktop/models。

常见安装问题

• 安装命令提示无法读取 https://releases.aitranslator.vn/stable/latest.json。你的 Mac 没有联网，或者代理/VPN 阻止了 releases.aitranslator.vn。请检查网络连接后再运行一次。
• 安装命令提示 SHA-256 不匹配。下载过程中文件损坏或被篡改。脚本不会安装任何东西；请再运行一次，如果仍然不同，请写信给客服。
• 安装命令提示应用仍在运行。请完全退出 AI Translator（菜单栏中的 AI Translator 菜单 › 退出），然后再运行一次命令。
• 安装命令提示需要 Apple 芯片或 macOS 14.2。你的 Mac 不满足要求；没有适用于 Intel Mac 的版本。
• 没有“仍要打开”按钮。（仅在用浏览器下载的 .dmg 安装时。）再打开一次应用，让 macOS 记录这次阻止，然后回到“隐私与安全性”。
• 无法在 Intel Mac 上安装。AI Translator 只为 Apple 芯片构建。
• 应用显示“这台电脑的内存不足 8 GB，AI Translator 暂不支持。”内存不足 8 GB 的 Mac 无法下载模型。
• 应用显示“这份 AI Translator 不是正版，因此只能使用 Free。”安装的文件被改动过，或者来自错误的渠道。请从官方渠道重新下载。
• 更新后 macOS 多次询问钥匙串。对于临时签名的版本，这是正常的：输入密码并选择“始终允许”。

如果安装后没有出现字幕，请参阅如何授予系统音频录制权限。