Docs / Installazione e risoluzione dei problemi
Risoluzione dei problemi
Il mio Mac ce la farà? Memoria, chip, disco e tempi di render per ogni Mac con Apple Silicon, in una sola pagina.
Quando Phosphene rifiuta un render, dice perché e cosa fare. Questi sono i messaggi che si vedono davvero. Per i problemi durante Install o Update (una riga FATAL error: in Pinokio, spazio su disco insufficiente), vedi Installazione, aggiornamento e spazio su disco.
Memoria e livello di questo Mac
Il chip di stato nell’intestazione mostra la memoria a colpo d’occhio; cliccalo per vedere le righe Livello, Memoria, Helper, Modelli, Coda e Render. Clicca Livello per vedere cosa può eseguire questo Mac.
- “Helper killed by the OS, out of memory”: macOS ha interrotto il render. Chiudi le app che usano molta memoria (browser, Slack, il Simulatore iOS) e riprova, oppure porta Qualità su Rapida, che usa circa la metà della memoria.
- “Image pre-flight: … needs a N GB Mac”: quel motore immagini non entra in questo Mac. Sui Mac con 16 GB o meno, Auto usa FLUX.2 [klein] 4B quando il motore scelto in Impostazioni richiede un Mac più grande, senza cambiare le Impostazioni. Serve un render senza immagini di riferimento: togli i riferimenti per lasciare che Auto usi Klein, oppure scegli un motore più leggero in Impostazioni. ”… needs ~N GB free” significa che il motore ci sta, ma al momento la memoria è occupata; questo controllo ora tiene conto della memoria che macOS può liberare e del reale fabbisogno di Auto.
- “Training needs at least 24 GB of memory”: l’addestramento dei personaggi non può funzionare su questo Mac.
Hailuo H3 su un Mac da 16-60 GB
Il motore completo di H3 richiede 60 GB. Da 16 GB funziona con il suo motore compatto Q8, che viene creato sul tuo Mac una sola volta (sotto i 36 GB legge il modello dal disco durante il render):
- H3 non ancora installato: in Pinokio apri Phosphene nella barra laterale e clicca Install Hailuo H3 (second video engine, ~75 GB). L’installazione crea da sola il motore compatto alla fine (circa 5 minuti in più).
- H3 installato, motore compatto mancante, “Hailuo H3 runs on this Mac, on its reduced-RAM lane … it is not built here yet”: clicca Build Hailuo H3 compact engine nella stessa barra laterale (~5 minuti, nessun download).
Entrambe le voci sono nella barra laterale finché il pannello è in esecuzione.
Fatto questo, scegli Impostazioni → Modello Hailuo H3 → Automatico o Compatto. Sotto i 16 GB H3 non è disponibile: fai il render con LTX, che serve ogni modalità.
Un modello o un componente aggiuntivo non è scaricato
- “Enhance needs its language model, Gemma 3 (8.1 GB)” e lo stesso per gli adattatori: su una nuova installazione vengono scaricati in background dopo il primo Start. Il messaggio dice se è in download, in coda o in attesa di spazio su disco; Download now lo scarica subito.
- “Extend needs the LTX-2.5 High add-on (the Q8 model), which isn’t downloaded on this Mac yet”: lo stesso vale per Keyframe e qualità Alta. Installalo dalla finestra Modelli (clicca il chip di stato, poi Modelli).
- “Upscale & Face Fix needs the LTX-2.5 Pixel Spatial Upscaler adapter”: scaricalo dalla finestra Modelli, poi rifai il render.
- “Stopped before rendering, the model weights are incomplete”: un download è stato interrotto. Apri la finestra Modelli e riprendilo. Impostazioni → Verifica i file del modello controlla ogni file e propone di scaricare di nuovo quelli danneggiati.
L’aggiornamento si ferma subito
Su alcuni Mac, Update di Pinokio nelle versioni precedenti alla 4.19.7 si fermava nel primo secondo: il terminale di Pinokio leggeva la parola “error:” nel testo del comando dell’Update stesso come un errore (#114). Pinokio esegue lo script Update della versione che hai già, quindi la correzione può avere effetto solo dopo un aggiornamento.
Aggiorna una volta dall’interno di Phosphene: clicca Aggiorna ora nel banner di aggiornamento (o sulla pillola della versione nell’intestazione), aspetta che dica che l’aggiornamento è finito, poi riavvia. Oppure apri un terminale nella cartella di Phosphene (~/pinokio/api/<your Phosphene folder>), esegui git pull e premi di nuovo Update in Pinokio: ora esegue il nuovo script corretto. Da quel momento il pulsante funziona.
“Click Update”: un motore più vecchio del pannello
“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.”
Il pannello è stato aggiornato ma il motore sottostante no. Clicca Update nella barra laterale di Phosphene in Pinokio. Se non sembra cambiare nulla, cliccalo una seconda volta: un aggiornamento avviato da una versione vecchia prima aggiorna se stesso. Per H3, “the installed Hailuo H3 runner is behind this panel” significa: riesegui Install Hailuo H3, ogni peso già presente su disco viene mantenuto.
Se hai aggiornato e il pannello si comporta ancora come la versione vecchia, sta ancora eseguendo il vecchio codice. In quel caso la pillola della versione nell’intestazione dice Restart Phosphene: cliccala, oppure clicca Stop e poi Start in Pinokio.
Il watchdog della GPU
“the macOS GPU watchdog killed a Metal command buffer”: è macOS stesso che ha interrotto un’operazione della GPU durata troppo. È un’interruzione a livello di driver, non un bug di Phosphene, ed è più frequente sui Mac M1 e M2. Phosphene rifà lo stesso lavoro una volta, subito, in passi GPU brevi (pezzi più piccoli di lavoro GPU, un po’ più lenti), e ricorda la dimensione: il render successivo su questo Mac parte già in passi brevi, e la riga Coda lo indica. Se macOS lo interrompe anche in passi brevi, quella dimensione resta in pausa su questo Mac per 24 ore (o fino al prossimo aggiornamento) e la scheda offre Riprova più piccolo. Se continua a succedere, il messaggio rimanda alla issue su GitHub, dove chip, versione di macOS e log del crash sono la cosa più utile.
Un addestramento di personaggio non è riuscito
“training exited with code 1”: il trainer si è fermato prima di finire. Controlla la scheda Registri per il motivo reale: un’interruzione per memoria esaurita (passa a un Mac con più RAM, o a un preset più piccolo se esiste), un download di addestramento LTX-2.3 mancante (la scheda di controllo preliminare della scheda Addestra lo propone), oppure un timeout nella codifica di una didascalia molto lunga. L’addestramento sotto i 24 GB fallisce sempre: quel Mac non può eseguirlo.
Il pannello dice che è offline
“Phosphene offline”, e premendo Genera non succede nulla: il processo del pannello non risponde. Nulla di ciò che stavi scrivendo va perso: il prompt resta com’era, e la pagina si riconnette e riprende da sola la coda appena il pannello è di nuovo in esecuzione. Se non torna entro pochi secondi, avvialo dalla barra laterale di Phosphene in Pinokio.
La coda si è messa in pausa da sola
“Queue paused: the last N renders failed the same way”: dopo tre render di fila falliti con lo stesso problema, Phosphene smette di consumare il resto della coda su qualcosa che un nuovo tentativo non può risolvere. Correggi la causa indicata dal messaggio, poi premi Riprendi; oppure Svuota coda per eliminare il resto e ricominciare.
La coda dopo un riavvio
Riavviare il pannello fa riprendere la coda: una coda che era in pausa quando il pannello si è fermato riparte da sola, e il registro lo dice.
Leggere il registro
La scheda Registri nel pannello in basso mostra il registro dei render. Quando un render muore, l’ultima riga che inizia con step: indica la fase raggiunta: è la cosa più utile da includere in una segnalazione. Il Terminal di Pinokio mostra lo stesso output.
Segnalare un problema
Il pulsante con l’insetto nell’intestazione apre Segnala un bug. Scrivi una o due frasi sotto What happened? (servono almeno 10 caratteri: il registro non può dire cosa hai visto); Phosphene compila versione, dettagli del tuo Mac e registro recente, con le righe di errore prima di quelle di routine, e apre in una nuova scheda una issue su GitHub da completare: non viene inviato nulla finché non la invii lì. Le issue sono su github.com/mrbizarro/phosphene/issues.
Fonte: webapp/docs/troubleshooting.md nel repository pubblico. Rivisto per questo sito prima della pubblicazione. Tradotto dall'originale inglese. Suggerisci una modifica.