Pro
RU
ВойтиАккаунт Скачать для Mac
Скачать для Mac

Справка / Установка и решение проблем

Решение проблем

Потянет ли мой Mac? Память, чип, диск и время рендера для каждого Mac на Apple Silicon на одной странице.

Когда Phosphene отказывается рендерить, он объясняет, почему и что делать. Здесь собраны сообщения, которые пользователи действительно видят. Если проблема возникла при установке или обновлении (строка FATAL error: в Pinokio, не хватает места на диске), см. Установка, обновление и место на диске.

Память и уровень этого Mac

Индикатор состояния в шапке показывает память с одного взгляда; нажмите на него, чтобы увидеть строки Уровень, Память, Помощник, Модели, Очередь и Рендер. Нажмите Уровень, чтобы узнать, что может запустить этот Mac.

  • “Helper killed by the OS: out of memory”: macOS остановила рендер. Закройте приложения, которые много занимают памяти (браузеры, Slack, iOS Simulator), и повторите попытку, либо переключите «Качество» на Быстрое: оно использует примерно вдвое меньше памяти.
  • “Image pre-flight: … needs a N GB Mac”: этот движок изображений не помещается на этот Mac. На Mac с 16 ГБ и меньше режим Авто берёт FLUX.2 [klein] 4B, если движку из «Настроек» нужен Mac побольше, и не меняет сами «Настройки». Для этого рендер должен идти без референсов: уберите референсы, чтобы «Авто» мог использовать Klein, или выберите в «Настройках» движок полегче. ”… needs ~N GB free” означает, что движок помещается, но память сейчас занята; эта проверка теперь учитывает память, которую macOS может освободить, и реальные потребности «Авто».
  • “Training needs at least 24 GB of memory”: обучение персонажа на этом Mac запустить нельзя.

Hailuo H3 на Mac с 16-60 ГБ

Полному движку H3 нужно 60 ГБ. Начиная с 16 ГБ он работает на компактном движке Q8, который один раз собирается прямо на вашем Mac (при памяти меньше 36 ГБ во время рендера модель читается с диска):

  • H3 ещё не установлен: в Pinokio откройте Phosphene на боковой панели и нажмите Install Hailuo H3 (second video engine, ~75 GB). Компактный движок установка соберёт сама в конце (ещё около 5 минут).
  • H3 установлен, но компактного движка нет, сообщение “Hailuo H3 runs on this Mac, on its reduced-RAM lane … it is not built here yet”: нажмите Build Hailuo H3 compact engine на той же боковой панели (~5 минут, без загрузки).

Оба пункта есть на боковой панели, пока панель работает.

Сделайте это, затем выберите «Настройки» → Модель Hailuo H3 → «Автоматически» или «Компактная». На Mac с памятью меньше 16 ГБ H3 недоступен: рендерите на LTX, он поддерживает все режимы.

Модель или дополнение не загружены

  • “Enhance needs its language model, Gemma 3 (8.1 GB)” и то же для адаптеров: при новой установке они скачиваются в фоне после первого нажатия Start. В сообщении сказано, идёт ли загрузка, стоит ли она в очереди или ждёт места на диске; кнопка Download now скачивает файл сразу.
  • “Extend needs the LTX-2.5 High add-on (the Q8 model), which isn’t downloaded on this Mac yet”: то же для «Ключевых кадров» и высокого качества. Установите его в окне «Модели» (нажмите на индикатор состояния, затем Модели).
  • “Upscale & Face Fix needs the LTX-2.5 Pixel Spatial Upscaler adapter”: скачайте его в окне «Модели» и запустите рендер снова.
  • “Stopped before rendering: the model weights are incomplete”: загрузка была прервана. Откройте окно «Модели» и продолжите её. Пункт «Настройки» → Проверить файлы моделей проверяет каждый файл и предлагает загрузить заново те, что повреждены.

Обновление сразу останавливается

На некоторых Mac кнопка Update в Pinokio в версиях до 4.19.7 останавливалась в первую же секунду: терминал Pinokio принимал слова «error:» в самом тексте команды обновления за сбой (#114). Pinokio запускает скрипт обновления той версии, которая у вас уже стоит, поэтому исправление подействует только после одного обновления.

Обновитесь один раз изнутри Phosphene: нажмите Обновить сейчас в баннере обновления (или на метке версии в шапке), дождитесь сообщения, что обновление завершено, и перезапустите приложение. Или откройте терминал в папке Phosphene (~/pinokio/api/<your Phosphene folder>), выполните git pull и снова нажмите Update в Pinokio: тогда запустится новый, исправленный скрипт. После этого кнопка работает.

«Click Update»: движок старше панели

“This install’s vendored engine predates LTX-2.5’s text encoder … Click Update, and if the first click only moves the panel, click it once more.”

Панель обновилась, а движок под ней нет. Нажмите Update на боковой панели Phosphene в Pinokio. Если ничего не изменилось, нажмите ещё раз: обновление, запущенное старой версией, сначала обновляет само себя. Для H3 сообщение “the installed Hailuo H3 runner is behind this panel” означает: запустите Install Hailuo H3 заново, все веса, уже лежащие на диске, сохранятся.

Если вы обновились, а панель всё равно ведёт себя как старая, значит, она всё ещё работает на старом коде. Тогда метка версии в шапке показывает Перезапустить Phosphene: нажмите её или нажмите Stop, а затем Start в Pinokio.

Сторожевой таймер GPU

“the macOS GPU watchdog killed a Metal command buffer”: сама macOS остановила задачу GPU, которая работала слишком долго. Это принудительная остановка на уровне драйвера, а не ошибка Phosphene, и чаще всего она случается на M1 и M2. Phosphene сразу же один раз повторяет ту же работу короткими шагами GPU (небольшими порциями работы GPU, чуть медленнее) и запоминает размер: следующий рендер на этом Mac начнётся с коротких шагов, и строка «Очередь» об этом скажет. Если macOS останавливает работу даже на коротких шагах, этот размер отключается на этом Mac на 24 часа (или до следующего обновления), а на карточке появляется Повторить в меньшем размере. Если это повторяется, сообщение ведёт на задачу GitHub, где больше всего помогают чип, версия macOS и журнал сбоя.

Обучение персонажа завершилось ошибкой

“training exited with code 1”: тренер остановился, не закончив. Причину ищите на вкладке Журнал: остановка из-за нехватки памяти (возьмите Mac с большим объёмом памяти или меньший пресет, если он есть), не загружены данные для обучения LTX-2.3 (их предложит карточка предварительной проверки на самой вкладке обучения) или тайм-аут кодирования описания при очень длинном описании. Обучение при памяти меньше 24 ГБ всегда заканчивается ошибкой: такой Mac его не потянет.

Панель пишет, что она офлайн

“Phosphene offline”, а нажатие Создать ничего не делает: процесс панели не отвечает. То, что вы вводили, не потеряно: промпт остаётся как был, а страница сама переподключится и вернётся к очереди, как только панель снова заработает. Если она не возвращается в течение нескольких секунд, запустите её с боковой панели Phosphene в Pinokio.

Очередь сама встала на паузу

“Queue paused: the last N renders failed the same way”: если три рендера подряд заканчиваются одной и той же ошибкой, Phosphene перестаёт гнать остаток очереди через то, что повтор не исправит. Устраните причину, названную в сообщении, и нажмите Продолжить; либо нажмите Очистить очередь, чтобы убрать остаток и начать заново.

Очередь после перезапуска

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

Как читать журнал

Вкладка Журнал на нижней панели показывает журнал рендера. Если рендер оборвался, последняя строка, начинающаяся с step:, называет этап, до которого он дошёл. Эту строку полезнее всего приложить к отчёту. Тот же вывод показывает Terminal в Pinokio.

Как сообщить о проблеме

Кнопка с жуком в шапке открывает Сообщить об ошибке. Напишите одно-два предложения в поле Что произошло? (нужно не меньше 10 символов, ведь по журналу не понять, что вы видели). Форма подставляет версию, данные вашего Mac и свежий журнал, причём строки с ошибками идут впереди обычных, и открывает задачу GitHub в новой вкладке, чтобы вы её дописали: пока вы не отправите её там, ничего не уходит. Задачи лежат на github.com/mrbizarro/phosphene/issues.

Источник: webapp/docs/troubleshooting.md в открытом репозитории. Проверено для этого сайта перед публикацией. Переведено с английского оригинала. Предложить правку.