← Назад к документации

Руководство по установке на macOS

Это руководство поможет вам установить Sokuji на системы macOS. Sokuji доступен как неподписанный установщик .pkg, который включает виртуальный аудиодрайвер для расширенных возможностей обработки звука.

Скачать для macOS

Системные требования

  • macOS 10.15 (Catalina) или новее
  • Процессор Apple Silicon (M1/M2/M3/M4) или Intel (x86_64)
  • Минимум 4 ГБ оперативной памяти (рекомендуется 8 ГБ)
  • 200 МБ свободного дискового пространства
  • Права администратора (необходимы для установки виртуального аудиодрайвера)
  • Подключение к интернету для служб перевода с ИИ
  • Микрофон и динамики/наушники

Шаги установки

Шаг 1: Скачать Sokuji

Посетите официальную страницу релизов на GitHub, чтобы скачать последнюю версию Sokuji для macOS.

Скачать установщик PKG

  • Sokuji-x.x.x-arm64.pkg - Для Mac с Apple Silicon (M1/M2/M3/M4)
  • Sokuji-x.x.x-x64.pkg - Для Mac с Intel
  • Каждый установщик включает приложение Sokuji и виртуальный аудиодрайвер
  • Размер файла примерно 150-200 МБ

Совет: Не уверены, какой скачать? Нажмите меню Apple () → «Об этом Mac», чтобы проверить тип чипа. Если вы видите «Apple M1/M2/M3/M4», выберите версию arm64. Если видите «Intel», выберите версию x64.

Установщик PKG не подписан, что означает, что вам потребуется выполнить специальные шаги для его установки (описано в следующем шаге).

Шаг 2: Подготовка к установке

Поскольку установщик PKG не подписан, macOS заблокирует его по умолчанию. Необходимо удалить атрибут карантина перед установкой.

Удаление атрибута карантина (обязательно)

  1. Откройте Терминал (Программы → Утилиты → Терминал)
  2. Введите или вставьте следующую команду (замените x.x.x на номер вашей версии):

    sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg

    Для Mac с Intel используйте: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg

  3. Нажмите Enter и введите пароль администратора при запросе
  4. Команда завершится без вывода (отсутствие вывода означает успех)

Что это делает? Эта команда удаляет флаг карантина, который macOS добавляет к загруженным файлам. Это безопасно и необходимо для неподписанных установщиков PKG.

Этот шаг критически важен! Без удаления атрибута карантина установщик PKG не сможет открыться или установиться.

Шаг 3: Установить 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 для загрузки драйвера
Пароль администратора необходим, потому что установщику нужно установить системный аудиодрайвер. Виртуальный аудиодрайвер обеспечивает расширенные функции обработки звука.

Шаг 4: Первый запуск

После установки вам может потребоваться разрешить запуск Sokuji, так как приложение загружено не из App Store.

Первый запуск Sokuji

  1. Перейдите в папку Программы
  2. Найдите Sokuji в списке
  3. Щелкните правой кнопкой мыши (или Control-щелчок) по Sokuji
  4. Выберите «Открыть» в контекстном меню
  5. Когда появится диалог безопасности, нажмите «Открыть» для подтверждения

Примечание: Если вы правильно выполнили Шаг 2, предупреждения безопасности могут не появиться.

Альтернативный способ

Если macOS продолжает блокировать Sokuji:
  1. Откройте Системные настройки → Защита и безопасность
  2. Перейдите на вкладку Основные
  3. Вы должны увидеть сообщение о блокировке Sokuji
  4. Нажмите «Все равно открыть»
Это предупреждение безопасности появляется только при первом запуске. После этого вы можете открывать Sokuji обычным способом из Launchpad или Программ.

Шаг 5: Настроить Sokuji

Теперь, когда Sokuji запущен, давайте настроим его для первого использования:

Начальная настройка

  1. Предоставьте разрешения на доступ к микрофону, когда macOS запросит
  2. Выберите предпочитаемый язык интерфейса
  3. Выберите поставщика ИИ (OpenAI, Google Gemini и т.д.)
  4. Введите API-ключ для выбранного поставщика
  5. Выберите исходный и целевой языки для перевода
  6. Выберите аудиоустройства (вы должны видеть «Sokuji Virtual Audio» в списке)
  7. Протестируйте настройку микрофона и динамиков
Поздравляем! Sokuji готов к использованию. Виртуальный аудиодрайвер установлен и доступен в вашем списке аудиоустройств. Нажмите кнопку микрофона, чтобы начать перевод в реальном времени.

Устранение неполадок

«Пакет поврежден и не может быть открыт» или PKG не устанавливается

Это происходит, когда атрибут карантина не был удален с файла PKG:
  1. Откройте Терминал (Программы → Утилиты → Терминал)
  2. Выполните: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
  3. Введите пароль при запросе
  4. Попробуйте установить PKG снова
Это наиболее распространенная проблема установки неподписанных PKG-установщиков.

«Sokuji невозможно открыть, так как он от неидентифицированного разработчика»

Это происходит, если вы не выполнили команду xattr перед установкой:
  1. Щелкните правой кнопкой мыши по приложению Sokuji в Программах
  2. Выберите «Открыть» в меню
  3. Нажмите «Открыть» в появившемся диалоге
Это нужно сделать только один раз. Лучший подход: удалите и переустановите после удаления атрибута карантина.

Микрофон не работает

Если Sokuji не может получить доступ к микрофону:
  1. Откройте Системные настройки → Защита и безопасность → Конфиденциальность
  2. Выберите Микрофон в левой боковой панели
  3. Убедитесь, что Sokuji отмечен в списке
  4. Если его нет в списке, перезапустите Sokuji и предоставьте разрешение при запросе

Нет аудиовыхода

Если вы не слышите переведенный звук:
  1. Откройте Системные настройки → Звук → Выход
  2. Выберите предпочитаемое устройство вывода
  3. Проверьте, не отключена ли громкость вывода
  4. В Sokuji убедитесь, что выбрано правильное устройство вывода

Приложение вылетает на Mac с Intel или проблемы с производительностью

Убедитесь, что вы скачали правильный установщик для вашего Mac:
  • Apple Silicon (M1/M2/M3/M4): Используйте Sokuji-x.x.x-arm64.pkg
  • Intel: Используйте Sokuji-x.x.x-x64.pkg
  • Проверьте тип чипа: меню Apple () → «Об этом Mac»
  • Если использовали неправильный установщик, скачайте правильную версию со страницы релизов
  • Если вылеты продолжаются с правильным установщиком, проверьте Console.app для логов сбоев и сообщите о них на GitHub

Виртуальный аудиодрайвер не отображается

Если вы не видите «Sokuji Virtual Audio» в аудиоустройствах:
  1. Проверьте, установлен ли драйвер: ls /Library/Audio/Plug-Ins/HAL/
  2. Если отсутствует, возможно, потребуется переустановить Sokuji
  3. Если присутствует, попробуйте перезапустить CoreAudio: sudo killall coreaudiod
  4. Проверьте Системные настройки → Звук, чтобы увидеть, появилось ли устройство

Установка требует пароль администратора

Это нормально и необходимо:
  • Установщик PKG должен установить системный аудиодрайвер
  • Системные аудиодрайверы требуют прав администратора для установки
  • Введите пароль при запросе — это безопасно и ожидаемо
  • Если у вас нет прав администратора, обратитесь к системному администратору