Correggere editor PhotoCraft vuoto e problemi renderer

Inizia identificando il guasto

Un editor vuoto può avere cause diverse: le risorse dell'applicazione non si sono caricate, il backend grafico non si è inizializzato, la tela è fuori schermo oppure un documento specifico ha esaurito le risorse disponibili. La pagina attorno all'editor può caricarsi normalmente mentre l'applicazione WebAssembly no. Annota subito ciò che vedi, invece di ricaricare ripetutamente e presumere che tutti i guasti abbiano la stessa causa.

Questa guida riguarda la build web di PhotoCraft v0.12.0 non modificata ospitata qui. Descrive una sequenza diagnostica, non un benchmark del browser. Non pubblichiamo soglie universali di caricamento, limiti di dimensione file né promesse che un renderer funzioni con ogni driver grafico. Gli screenshot e i controlli esistenti usano Chromium; hardware reale e altre versioni del browser possono comportarsi diversamente.

Salva prima se l'area di lavoro risponde

Se il documento è visibile e i menu funzionano ancora, salva un checkpoint ed esporta un PNG di riferimento prima di cambiare qualsiasi cosa. Poi individua i file su disco. Cambiare renderer riavvia l'applicazione incorporata e ricaricare la pagina può eliminare le modifiche non salvate. Una richiesta di conferma non è un salvataggio automatico. Se non sai quali file dovrebbero esistere prima di proseguire, leggi il flusso di backup.

Se l'area di lavoro è già bloccata, conserva i download completati e annota l'ultima operazione. Non esiste una copia del documento sul server da recuperare. Evita di cancellare i dati del sito come primo passo automatico: puoi perdere preferenze e contesto diagnostico senza recuperare il documento non salvato. Diagnostica l'avvio con un nuovo piccolo campione solo dopo aver chiarito cosa era effettivamente salvato.

Distingui caricamento della pagina e avvio dell'applicazione

Scorri fino all'editor e verifica che i suoi menu e la sua tela siano comparsi. Il titolo esterno e il pulsante per aprire l'editor sono controlli del sito. Non dimostrano che l'applicazione incorporata si sia inizializzata. Su uno schermo grande l'applicazione potrebbe semplicemente trovarsi sotto l'area visibile; su uno schermo stretto i pannelli possono lasciare poco spazio alla tela.

Apri l'editor in una scheda separata con il controllo previsto se devi distinguere un problema di incorporamento o di layout dall'avvio dell'applicazione. Tieni traccia della scheda che contiene la sessione originale: una nuova scheda non porta con sé le modifiche non salvate. Se una vista funziona e l'altra no, annota URL e viewport esatti, invece di segnalare soltanto che "PhotoCraft non funziona".

Controlla le richieste delle risorse

Negli strumenti di sviluppo del browser, esamina le richieste di rete mentre riproduci il problema. L'applicazione carica HTML, JavaScript e WebAssembly da /vendor/photocraft/0.12.0/. Annota le richieste fallite, i codici di stato e i messaggi in console. Un download WASM fallito è un problema diverso da un download completato seguito da un errore di inizializzazione grafica. Conserva la versione esatta del browser nella segnalazione.

Estensioni, filtri di rete o un problema temporaneo di connessione possono interferire con il caricamento. Prova un profilo pulito o una finestra privata come confronto diagnostico, ricordando però che una finestra privata è una nuova sessione di modifica. Non disattivare globalmente il software di sicurezza e non ignora gli errori di certificato per far caricare l'applicazione. Segnala invece la risorsa bloccata e l'errore osservato.

Prova le opzioni renderer una alla volta

Dopo aver salvato, usa i controlli renderer del sito per selezionare WebGL2, CPU canvas o il renderer predefinito. Cambia una sola impostazione per volta e attendi che la nuova applicazione appaia. Ripeti con lo stesso piccolo campione e la stessa operazione. Se cambi insieme file, browser e renderer, perdi il confronto che aiuterebbe a identificare la causa.

CPU canvas è un'alternativa per la diagnosi, non una garanzia di prestazioni o compatibilità migliori. Allo stesso modo, selezionare una modalità grafica non prova che l'accelerazione hardware sia attiva. Il nostro ambiente Chromium automatico può usare grafica software. Annota la modalità richiesta e le informazioni sul backend effettivamente riportate dall'applicazione. Non trasformare quell'ambiente in affermazioni sulla velocità del laptop o del telefono di un utente.

Prova con un piccolo file noto

Scarica il PNG sintetico 320 × 320. Aprilo, disegna un segno visibile ed esporta un PNG seguendo il flusso passo per passo. Una semplice operazione riuscita dimostra che quel percorso di avvio e modifica funziona. Restringe il problema senza provare il supporto per il documento originale.

Se il campione funziona ma il tuo file no, annota tipo, dimensioni in pixel, dimensione e funzioni rilevanti del documento originale. Usa una copia per creare una riproduzione più piccola, senza materiale riservato. I documenti grandi dipendono dalla memoria del browser e del dispositivo. Il supporto del formato PSB non rende praticabili file arbitrariamente grandi in una scheda e questo sito non ha misurato una dimensione sicura universale.

Distingui guasti di input, modifica e output

Osservazione	Cosa annotare	Prossimo confronto
Nessuna tela dell'applicazione	Errori risorse e console di avvio	Profilo pulito e renderer alternativo
Il campione si apre, l'originale no	Formato, dimensioni e funzioni rilevanti	Riproduzione più piccola e sanificata
L'immagine si apre ma il pennello non segna	Strumento attivo, documento e focus della tela	Flusso del PNG noto
L'esportazione sembra invariata	Nome scaricato e riferimento visibile	Nuova esportazione con modifica evidente
Il PSD riaperto è diverso	File salvato, PNG di riferimento e struttura attesa	Checklist del round trip

Controllare un file esportato fuori dall'editor aiuta a separare un problema di visualizzazione da un output cambiato. Se un'esportazione è corretta ma la tela appare errata, conserva entrambe le prove. Se anche l'output è errato, conserva un'origine minima e i passaggi esatti. La guida PSD spiega perché fedeltà visiva e struttura modificabile richiedono osservazioni separate.

Raccogli prove utili senza esporre dati privati

Una segnalazione utile include URL della pagina, versione di PhotoCraft, sistema operativo, versione del browser, renderer selezionato e sequenza esatta delle azioni. Aggiungi risultato atteso e risultato osservato. Uno screenshot dovrebbe mostrare lo stato rilevante dell'applicazione nascondendo schede personali, dati dell'account, nomi di file e materiale dei clienti. Usa un file sintetico ogni volta che il problema è riproducibile senza l'originale.

Archivi di rete e log della console possono contenere informazioni sulla navigazione. Esaminali prima di condividerli e rimuovi credenziali o richieste non correlate. Il sito carica direttamente GA4 e Plausible per misurare le visite; queste richieste sono distinte dall'elaborazione dei documenti. Non etichettare ogni richiesta di rete come caricamento di un'immagine. Al contrario, un editor locale non significa che la navigazione non produca normali metadati di hosting.

Decidi se continuare o cambiare strumento

Se un checkpoint salvato si riapre e il piccolo flusso funziona, torna al tuo lavoro in modo graduale e salva nei punti significativi. Se un file o una funzione essenziale continua a fallire, conserva l'originale e usa un flusso già verificato per quel requisito. Forzare ripetutamente lo stesso documento nello stesso percorso non sostituisce il controllo dell'output.

Usa la guida alla community per indirizzare le segnalazioni software upstream e la pagina di contatto per gli errori del sito. Una riproduzione precisa è più utile di una diagnosi immaginata. Includi cosa hai provato, anche i cambi di renderer senza successo, e indica chiaramente cosa non hai potuto testare. Così la prossima indagine sarà utile senza esagerare ciò che le prove attuali dimostrano.