← 返回文档

macOS 安装指南

本指南将指导您在 macOS 系统上安装 Sokuji。Sokuji 以已签名并通过 Apple 公证的 .pkg 安装包形式提供，其中包含用于增强音频处理功能的虚拟音频驱动程序。

下载 macOS 版本

系统要求

  • macOS 13 (Ventura) 或更高版本（v0.42.2 起；macOS 12 可继续使用 v0.42.1）
  • Apple Silicon (M1/M2/M3/M4) 或 Intel (x86_64) 处理器
  • 最低4GB内存（推荐8GB）
  • 200MB可用磁盘空间
  • 管理员权限（安装虚拟音频驱动程序所需）
  • 用于AI翻译服务的互联网连接
  • 麦克风和扬声器/耳机

安装步骤

步骤 1：下载 Sokuji

访问 官方 GitHub 发布页面 下载最新的 macOS 版本 Sokuji。

下载 PKG 安装包

  • Sokuji-x.x.x-arm64.pkg - 适用于 Apple Silicon Mac (M1/M2/M3/M4)
  • Sokuji-x.x.x-x64.pkg - 适用于 Intel Mac
  • 每个安装包均包含 Sokuji 应用程序和虚拟音频驱动程序
  • 文件大小约为 150-200MB

提示：不确定下载哪个版本？点击苹果菜单（）→"关于本机"查看芯片类型。如果显示"Apple M1/M2/M3/M4"，请选择 arm64 版本。如果显示"Intel"，请选择 x64 版本。

从 0.46.5 版本起，PKG 安装包已签名并通过公证，macOS 可以直接打开，无需额外步骤。

步骤 2：安装 PKG

安装 Sokuji 及其虚拟音频驱动程序。

安装过程

  1. 在下载文件夹中找到已下载的 .pkg 文件（如 Sokuji-x.x.x-arm64.pkg 或 Sokuji-x.x.x-x64.pkg）
  2. 双击 PKG 文件开始安装
  3. macOS 安装器将打开 - 点击"继续"继续
  4. 查看安装详情并点击"安装"
  5. 在提示时输入管理员密码（安装驱动程序需要）
  6. 等待安装完成（通常需要 1-2 分钟）
  7. 安装完成后点击"关闭"

安装内容

  • Sokuji.app - 安装到 /Applications
  • SokujiVirtualAudio.driver - 虚拟音频驱动程序安装到 /Library/Audio/Plug-Ins/HAL
  • 安装器会自动重启 CoreAudio 以加载驱动程序
需要管理员密码是因为安装器需要安装系统级音频驱动程序。虚拟音频驱动程序实现了高级音频处理功能。

步骤 3：首次启动

从"应用程序"文件夹打开 Sokuji，无需任何安全绕过步骤。

步骤 4：配置 Sokuji

现在 Sokuji 正在运行，让我们进行首次使用配置：

初始设置

  1. 当 macOS 提示时授予麦克风权限
  2. 选择您喜欢的界面语言
  3. 选择您的 AI 提供商（OpenAI、Google Gemini 等）
  4. 输入所选提供商的 API 密钥
  5. 选择翻译的源语言和目标语言
  6. 选择您的麦克风，并在语音区块中把默认播放设备设为您的扬声器或耳机。Sokuji 不会在这里列出它自己的虚拟音频设备：对方听到的翻译会把您的翻译送进这个设备，也就是会议应用里要选择的虚拟麦克风
  7. 测试您的麦克风和扬声器设置
恭喜！Sokuji 现在已准备就绪。虚拟音频驱动程序已安装并可在您的音频设备列表中使用。点击麦克风按钮开始实时翻译。

故障排除

麦克风不工作

如果 Sokuji 无法访问您的麦克风：
  1. 打开系统偏好设置 → 安全性与隐私 → 隐私
  2. 从左侧边栏选择麦克风
  3. 确保列表中的 Sokuji 已勾选
  4. 如果未列出，请重启 Sokuji 并在提示时授予权限

无音频输出

如果您听不到翻译的音频：
  1. 打开系统偏好设置 → 声音 → 输出
  2. 选择您的首选输出设备
  3. 检查输出音量是否未静音
  4. 在 Sokuji 的语音区块中，检查您想听到的那一行所选的设备：您自己的翻译看我也听（默认关闭），对方的翻译看我听到的翻译，其他声音看默认播放设备

在 Intel Mac 上崩溃或性能问题

请确认您下载了正确的安装包：
  • Apple Silicon (M1/M2/M3/M4)：使用 Sokuji-x.x.x-arm64.pkg
  • Intel：使用 Sokuji-x.x.x-x64.pkg
  • 查看芯片类型：苹果菜单（）→"关于本机"
  • 如果使用了错误的安装包，请从发布页面下载正确的版本
  • 如果使用正确的安装包仍然崩溃，请检查控制台应用中的崩溃日志并在 GitHub 上报告

虚拟音频驱动程序未显示

如果您在音频设备中看不到"SokujiVirtualAudio"：
  1. 先让 Sokuji 自己修：驱动已安装但 macOS 没有加载时，Sokuji 启动后会提示“虚拟麦克风已安装，但 macOS 没有加载它”，点击修复，输入管理员密码，Sokuji 会重启 Core Audio 加载驱动，无需重启 Sokuji
  2. 检查驱动程序是否已安装：ls /Library/Audio/Plug-Ins/HAL/
  3. 如果不存在，您可能需要重新安装 Sokuji
  4. 如果存在而修复无效，尝试重启 CoreAudio：sudo killall coreaudiod，或重启 Mac
  5. 检查系统设置 → 声音以查看设备是否出现

安装需要管理员密码

这是正常且必需的：
  • PKG 安装器需要安装系统级音频驱动程序
  • 系统音频驱动程序需要管理员权限才能安装
  • 在提示时输入密码 - 这是安全且预期的
  • 如果您没有管理员访问权限，请联系系统管理员