Guida · Risorse

Playbook di migrazione da Anki a Deckbase

Un flusso di migrazione a basso rischio per i percorsi APKG e CSV, con controlli di qualità espliciti perché la velocità di importazione non comprometta la qualità della memorizzazione.

Team editoriale di DeckbaseLettura di 8 minuti

Per chi è questo playbook

Questa guida è per chi ha già deck Anki attivi e vuole passare a Deckbase in modo strutturato senza interrompere la continuità del ripasso quotidiano. Se stai cercando anki import csv, questo è il percorso di implementazione che separa il trasferimento rapido dalla stabilizzazione della qualità.

Checklist pre-migrazione

  1. 1
    Fai il backup di ogni deck sorgente prima del primo import.
  2. 2
    Elenca i deck attivi degli ultimi 30 giorni e migrali per primi.
  3. 3
    Definisci controlli di qualità superati/non superati prima di scalare oltre un deck.
  4. 4
    Stabilisci un minimo giornaliero di ripasso (per tempo o per carte) per proteggere la continuità dell'abitudine.

Percorso A: migrazione con APKG per prima

Usa APKG quando contano soprattutto velocità e preservazione della struttura. Questo percorso è ideale per una prima ondata di migrazione in cui l'obiettivo è la continuità, non la pulizia perfetta.

  • Importa un deck attivo e controlla subito un campione di 30 carte.
  • Correggi solo i problemi ad alto impatto: prompt illeggibili, media corrotti, duplicati evidenti.
  • Riprendi il ripasso lo stesso giorno invece di metterlo in pausa per grandi modifiche estetiche.

Percorso B: migrazione con CSV per prima

Usa CSV quando serve una normalizzazione campo per campo. Il CSV richiede più tempo all'inizio, ma è più facile imporre coerenza di denominazione, regole dei template e deduplicazione su larga scala.

  1. 1
    Normalizza i nomi dei campi e la formattazione dei termini prima dell'import.
  2. 2
    Crea una mappatura canonica per prompt, risposta, tag e contesto.
  3. 3
    Importa prima un batch pilota e supera tutti i controlli di qualità prima del rollout completo.

Matrice di mappatura dei campi

Fronte

Scopo
Testo del prompt
Regola di qualità
Solo un concetto
Nota operativa
Dividi le carte sovraccaricate prima dell'import

Retro

Scopo
Risposta attesa
Regola di qualità
Risposta diretta prima di tutto
Nota operativa
Tieni le spiegazioni lunghe nelle note

Tag

Scopo
Raggruppamento per argomento
Regola di qualità
Tassonomia coerente
Nota operativa
Usa nomi dominio/capitolo

Extra / Note

Scopo
Supporto contestuale
Regola di qualità
Corto e facoltativo
Nota operativa
Evita di incorporare indizi della risposta

Media

Scopo
Contesto visivo/audio
Regola di qualità
Allegati leggibili
Nota operativa
Verifica i riferimenti corrotti nel campione

Controlli di qualità per batch

Esegui i controlli prima di ogni nuovo batch di import. Se un controllo fallisce, metti in pausa i nuovi import e ripara prima la qualità delle carte. Così i problemi restano piccoli ed eviti debiti accumulati.

Comprensione

Soglia di superamento
>=90% delle carte campionate comprensibili
Segnale di fallimento
Il formato del prompt è ambiguo o confuso

Tasso di duplicati

Soglia di superamento
<3% di prompt frontali duplicati
Segnale di fallimento
Il batch contiene definizioni o titoli ripetuti

Carico di sessione

Soglia di superamento
Aumento del tempo di sessione <15% WoW
Segnale di fallimento
Le carte importate sono troppo verbose

Andamento degli errori

Soglia di superamento
Stabile o in miglioramento entro la settimana 2
Segnale di fallimento
La qualità del prompt è bassa per gli argomenti chiave

Casi particolari di Anki da gestire prima di scalare

La maggior parte delle regressioni di migrazione deriva da casi particolari che sembrano piccoli in un campione e diventano costosi in volume. Controlla il rendering dei cloze, gli stati delle carte sospese, il comportamento delle leech e i riferimenti ai media prima di importare altri deck.

Carte cloze

Fallimento comune
Marcatori cloze mancanti dopo l'import
Mitigazione
Valida il rendering cloze di un campione prima della migrazione completa

Carte sospese

Fallimento comune
Carico di ripasso attivo inatteso
Mitigazione
Esporta lo stato di sospensione e riapplicalo dopo l'import

Carte leech

Fallimento comune
Fallimenti cronici che inquinano la coda
Mitigazione
Assegna tag alle leech e applica una policy di riscrittura/archiviazione

Riferimenti media

Fallimento comune
Puntatori a immagini o audio corrotti
Mitigazione
Esegui una scansione dei media corrotti sulle prime 100 carte

Opzioni deck

Fallimento comune
Comportamento degli intervalli non corrispondente
Mitigazione
Esegui metriche a 14 giorni prima di scalare su altri deck

Contratto CSV per migrazioni ripetibili

Se esegui import ricorrenti, definisci un contratto CSV fisso e versionalo. Così riduci la deriva dello schema tra gli operatori e semplifichi l'automazione QA. Una base pratica è un contratto a sei colonne con campi di identità, prompt, risposta, contesto, tassonomia e sorgente.

note_id

Ruolo
Identità stabile della riga
Vincolo
Previene duplicazioni accidentali nell'ingestione

front_text

Ruolo
Campo prompt
Vincolo
Normalizza punteggiatura e varianti unicode

back_text

Ruolo
Campo risposta
Vincolo
Mantieni la risposta diretta nella prima frase

context_hint

Ruolo
Disambiguazione facoltativa
Vincolo
Usa solo contesto di dominio breve

tags_pipe

Ruolo
Raggruppamento tassonomico
Vincolo
Usa tag canonici delimitati da pipe

source_ref

Ruolo
Tracciabilità
Vincolo
Memorizza capitolo/pagina per il controllo QA retrospettivo

Mantieni la codifica UTF-8, impone interruzioni di riga normalizzate ed evita formule nascoste del foglio di calcolo nelle celle esportate. Questi piccoli vincoli prevengono corruzioni silenti dell'import.

Protocollo di stabilizzazione di 14 giorni

  1. 1
    Giorni 1-3: migra un deck attivo e riavvia subito il ripasso quotidiano.
  2. 2
    Giorni 4-7: ripara le carte con più fallimenti e deduplica i prompt frontali.
  3. 3
    Giorni 8-10: standardizza tag e template e valida l'andamento del tempo di sessione.
  4. 4
    Giorni 11-14: scala la migrazione solo se completamento ed errori restano sani.

Guida alla migrazione per scenario

Sprint d'esame (8-12 settimane)

Obiettivo principale
Mantenere stabile il completamento quotidiano
Approccio consigliato
Importa solo i deck attivi, metti in pausa la migrazione dell'archivio

Studio linguistico a lungo termine

Obiettivo principale
Preservare il contesto delle frasi
Approccio consigliato
Percorso CSV con normalizzazione rigorosa dei campi

Migrazione di team

Obiettivo principale
Coerenza dei template
Approccio consigliato
Pubblica una mappatura canonica prima dell'import in blocco

Pulizia archivio

Obiettivo principale
Ritirare i deck a basso rendimento
Approccio consigliato
Migra per argomento ed elimina subito le carte obsolete

FAQ

Dovrei usare prima APKG o CSV?

Usa prima APKG per un trasferimento rapido della struttura. Usa CSV quando ti serve una pulizia rigorosa dei campi o la normalizzazione dei template prima di scalare.

Quanti deck dovrei migrare alla volta?

Parti da un deck attivo e stabilizzalo per 7-14 giorni. Espanditi solo quando completamento, tempo di sessione e andamento degli errori restano sani.

Posso tenere Anki e Deckbase in parallelo durante la migrazione?

Sì. Molti studenti tengono i deck legacy in Anki mentre creano nuove carte in Deckbase, poi consolidano una volta che i controlli di qualità sono stabili.

Cosa faccio se le mie carte non vengono importate correttamente?

I problemi comuni includono problemi di codifica (usa UTF-8), campi obbligatori mancanti e template non corrispondenti. Esporta in CSV, correggi i problemi in un foglio di calcolo e reimporta. Il playbook include un contratto CSV per migrazioni ripetibili.

Posso tornare indietro se la migrazione non funziona?

Sì. Prima della migrazione, esporta il tuo deck Anki come backup (.apkg). Deckbase non cancella i tuoi dati originali di Anki. Se Deckbase non soddisfa le tue esigenze, puoi sempre tornare ad Anki senza perdere i progressi.

Cosa dovrei fare nella prima settimana dopo la migrazione?

Concentrati sulla stabilizzazione: ripara le carte che falliscono, deduplica i prompt e stabilisci la tua routine di ripasso quotidiano. Non aggiungere nuovi deck finché il deck principale non è stabile. Monitora da vicino tempo di sessione e tasso di errori.

Perderò la mia cronologia di ripasso quando migro?

Il contenuto delle carte si trasferisce con l'import APKG, ma la cronologia di ripasso (stato di apprendimento, intervalli) no, quindi le carte importate ripartono da zero. Lo scheduler FSRS di Deckbase imposta poi gli intervalli in base ai tuoi nuovi ripassi.

Prima settimana dopo la migrazione: checklist di successo

I primi sette giorni determinano se la migrazione avrà successo. Concentrati sul stabilizzare il deck principale prima di espanderti su altri deck.

  1. 1
    Giorno 1: completa la prima sessione di ripasso con le carte importate. Prendi nota di eventuali problemi di formattazione.
  2. 2
    Giorni 2-3: individua e ripara le carte che risultano confuse o con prompt poco chiari.
  3. 3
    Giorni 4-5: esegui il controllo dei duplicati e unisci le carte con frontali identici.
  4. 4
    Giorno 6-7: valuta il tempo di sessione. Se è aumentato in modo significativo, verifica la lunghezza delle carte.
  5. 5
    Entro il giorno 7: decidi se continuare con Anki, passare completamente a Deckbase o mantenere entrambi.

Suggerimento: mantieni l'installazione di Anki e i deck originali intatti durante il primo mese. Così hai un'opzione di ripristino se Deckbase non soddisfa le tue esigenze.

Ti serve prima una panoramica generale? Leggi l'articolo pubblicato sulla strategia di migrazione, poi torna a questo playbook per l'esecuzione. Parti dalla guida import/export da Anki.