Capitolo 6: Ripristino, archiviazione e risoluzione dei problemi

Chrome interromperà l'estensione. Non è una questione di se — i service worker si addormentano quando sono inattivi, le schede vengono chiuse, Chrome recupera memoria sotto pressione. Questo capitolo spiega come l'estensione sopravvive e cosa fare quando le cuciture si notano.

Il modello di ripristino in un paragrafo

Ogni registrazione scrive i suoi chunk audio e metadati su IndexedDB (il database locale del browser) man mano che avviene. Se Chrome termina l'estensione durante la registrazione, i chunk restano. La volta successiva che apri il pannello laterale, compaiono in un elenco salvato su questo dispositivo con un pulsante Upload all — gli utenti autenticati possono riprovare il caricamento interrotto da dove è stato lasciato, grazie ai caricamenti multi-parte riprendibili. Gli utenti anonimi possono scaricare l'audio sul proprio computer o accedere e caricarlo in seguito. Nulla viene perso silenziosamente.

Questa sezione è un riepilogo; le note di rilascio delle versioni 1.6–1.9 contengono la storia completa delle classi di bug che questo ha sostituito.

L'elenco "salvato su questo dispositivo"

Si apre in cima al pannello laterale quando ci sono registrazioni in staging locale. Ogni riga mostra:

Il titolo della riunione (o "Untitled — <date>" per le registrazioni che non hanno mai ricevuto un titolo).
La durata catturata.
Lo stato (Ready to upload / Uploading / Failed / Finalized).
Pulsanti: Upload (autenticato) o Download / Delete.

Upload all in cima all'elenco svuota la coda. Esce non appena il replay sweep segnala il completamento invece di aspettare l'intera scadenza di quattro minuti, così sembra reattivo.

Quando Chrome termina l'estensione durante la registrazione

Ognuno di questi eventi può accadere ed è gestito:

La scheda che stai registrando viene chiusa. Il service worker riceve un evento tabs.onRemoved e attiva un normale Stop + drenaggio del caricamento prima che Chrome possa mettere a dormire il service worker.
La scheda di registrazione va in crash. Il relay del content script del microfono muore; dopo 5 secondi senza frame PCM il pannello laterale mostra un avviso "microphone signal was lost". La registrazione viene interrotta e i chunk catturati fino a quel punto vengono messi in staging per il ripristino.
Il service worker viene riciclato da Chrome. Al successivo avvio a freddo l'estensione fa il ping al documento offscreen; se risponde, la registrazione continua senza interruzioni, altrimenti l'offscreen viene abbandonato e il pannello torna alla configurazione con i chunk in staging intatti.
Il documento offscreen viene recuperato sotto pressione di memoria. Il suo handler pagehide forza l'arresto della registrazione. Un backstop di stallo del segnale del microfono di 30 secondi all'interno dell'offscreen interrompe anch'esso la registrazione se ogni segnale esterno viene perso.
Il browser viene chiuso durante la registrazione. La registrazione compare nell'elenco "salvato su questo dispositivo" la volta successiva che apri Chrome.

L'unico caso che in passato veniva perso silenziosamente — una riunione Google Meet che terminava in una navigazione single-page-app — è gestito dal service worker che osserva la scheda che abbandona direttamente l'URL con il codice della riunione, indipendentemente dal content script.

Quando un caricamento fallisce

I caricamenti utilizzano un trasferimento multi-parte riprendibile. Se una parte fallisce, viene ritentata solo quella parte. Se l'intero caricamento muore a metà del trasferimento:

I chunk in staging rimangono in IndexedDB.
La registrazione compare nell'elenco "salvato su questo dispositivo" con lo stato Failed.
Autenticato: Upload su quella riga riprende il trasferimento dall'ultima parte riuscita. Per le riunioni lunghe, questo non è un nuovo caricamento completo.
Anonimo: Download salva l'audio sul tuo computer come file .webm; puoi riprodurlo localmente o caricarlo in seguito dopo aver effettuato l'accesso.

Gestione dell'archiviazione

Le registrazioni locali non vengono più eliminate automaticamente dopo 30 giorni. Se tratti l'estensione come un registratore autonomo — registrando riunioni, mantenendo i file localmente, senza mai accedere — le vecchie registrazioni scomparivano silenziosamente. È stato corretto.

Solo due categorie vengono pulite automaticamente in sicurezza:

Orfani finalizzati — il caricamento ha confermato che la registrazione è al sicuro in R2 e la copia locale è ora ridondante.
Orfani da 0 byte — la registrazione è morta prima che venisse catturato alcun audio; nulla da recuperare.

A 500 MB di registrazioni locali in staging, compare un avviso di archiviazione giallo in cima al pannello laterale. È consultivo — nessun dato viene eliminato — ma è un suggerimento ad accedere e caricare, o scaricare e cancellare.

Per cancellare una registrazione specifica: fai clic su Delete sulla sua riga nell'elenco "salvato su questo dispositivo". Se la registrazione ha note in tempo reale non caricate, l'eliminazione richiede una conferma.

Problemi comuni

"L'icona dell'estensione è disattivata su chrome://, edge:// o sul Chrome Web Store."

Chrome vieta alle estensioni di essere eseguite sulle pagine chrome://, edge:// e sul Chrome Web Store stesso. È una restrizione a livello di browser; SeaMeet non può fare nulla. Apri la riunione in una scheda normale.

"La cattura scheda ha fallito con 'Cannot access a chrome:// URL' o 'Extension not allowed for this tab'."

La scheda era aperta prima di installare l'estensione. Chrome si rifiuta di collegare la cattura scheda a una scheda senza concessione di autorizzazione. Ricarica la scheda e riprova.

"Le registrazioni mostrano 0:00 nell'elenco di ripristino."

Era un bug nelle versioni precedenti — la durata veniva scritta solo al momento dello stop, quindi una registrazione interrotta non ne aveva alcuna. Ora viene persistita durante la registrazione, quindi ciò accade solo se la registrazione è terminata prima del primo aggiornamento della durata. Ripiega su — quando sconosciuta.

"Il file caricato viene riprodotto ma mostra una durata sconosciuta / infinita."

Le registrazioni fino a 100 MB hanno i metadati di durata riscritti prima del completamento del caricamento, quindi questo è corretto per esse. Le registrazioni più grandi o riprese mantengono il fallback della patch Part-1 — il file viene riprodotto, ma un piccolo numero di lettori potrebbe non cercare correttamente. Prova VLC come workaround.

"La riunione Meet è terminata ma la registrazione è continuata."

Questa classe di bug è stata corretta in 1.9. Se accade su 1.9 o successivi, segnala — con il numero di versione da chrome://extensions/ e una nota sulla piattaforma della riunione.

"I sottotitoli si sono fermati a metà della riunione."

Il servizio speech-to-text in tempo reale si riconnette automaticamente alcune volte; quando si esaurisce, il banner "Retry captions" compare sopra la trascrizione. Fai clic su di esso. La registrazione continua per tutto il tempo — non viene perso alcun audio.

"Una registrazione da una chiamata Meet ha il titolo sbagliato (il titolo della scheda)."

È stato corretto in 1.8 — le registrazioni dell'estensione ora iniziano come "Untitled — <date>", corrispondendo alla protezione del nome predefinito dell'app web, così il titolo della riunione generato dall'AI lo sostituisce correttamente dopo il caricamento. Se lo vedi su 1.8 o successivi, il rename AI di solito recupera entro un minuto.

Quando segnalare un bug

La registrazione non è comparsa nell'elenco "salvato su questo dispositivo" dopo un'interruzione.
Upload all dichiara il successo ma la registrazione non è nella tua libreria web.
L'estensione manda in crash Chrome (invece di fallire semplicemente in modo controllato).
Qualsiasi perdita silenziosa di dati.

Segnala sul repo dell'app desktop (seasalt-ai/seameet-app-desktop) con la versione dell'estensione, la versione del browser e, se possibile, una schermata del pannello laterale.

Riferimento rapido

Sintomo	Prova
L'estensione non ha registrato	Ricarica la scheda, poi riprova
Registrazione mancante dopo un crash	Controlla l'elenco "salvato su questo dispositivo" nel pannello laterale
Caricamento bloccato	Fai clic su Upload di nuovo sulla riga — multi-parte riprendibile
Sottotitoli fermati	Fai clic su Retry captions nel banner sopra la trascrizione
Avviso di archiviazione a 500 MB	Accedi e usa Upload all, oppure Download e Delete
La riunione ha continuato a registrare dopo la fine	Aggiorna a 1.9+ se non lo hai già

Last updated: 2026-08-27

← Capitolo 5: Accesso e sincronizzazione con l'app web