Guia · Recursos

Guia de migração do Anki para o Deckbase

Um fluxo de migração de baixo risco para os caminhos APKG e CSV, com critérios de qualidade explícitos para que a velocidade da importação não prejudique a qualidade da retenção.

Equipe editorial do Deckbase8 min de leitura

Para quem é este guia

Este guia é para quem já tem baralhos ativos no Anki e quer migrar para o Deckbase de forma estruturada, sem quebrar a consistência das revisões diárias. Se você está pesquisando anki import csv, este é o caminho de implementação que separa a transferência rápida da estabilização de qualidade.

Checklist pré-migração

  1. 1
    Faça backup de todos os baralhos de origem antes da primeira importação.
  2. 2
    Liste os baralhos ativos dos últimos 30 dias e migre esses primeiro.
  3. 3
    Defina critérios de aprovação/reprovação de qualidade antes de ir além de um baralho.
  4. 4
    Defina um mínimo diário de revisão (por tempo ou por cartões) para proteger a continuidade do hábito.

Caminho A: migração começando por APKG

Use APKG quando velocidade e preservação da estrutura forem mais importantes. Este caminho é ideal para uma primeira onda de migração em que o objetivo é a continuidade, não uma limpeza perfeita.

  • Importe um baralho ativo e inspecione uma amostra de 30 cartões imediatamente.
  • Corrija apenas os problemas de alto impacto: perguntas ilegíveis, mídia quebrada, duplicatas óbvias.
  • Retome as revisões no mesmo dia em vez de pausar para grandes ajustes estéticos.

Caminho B: migração começando por CSV

Use CSV quando for necessária a normalização no nível dos campos. O CSV exige mais tempo no início, mas facilita aplicar consistência de nomes, regras de modelo e remoção de duplicatas em escala.

  1. 1
    Normalize os nomes dos campos e a formatação dos termos antes de importar.
  2. 2
    Crie um único mapeamento canônico para pergunta, resposta, tags e contexto.
  3. 3
    Importe primeiro um lote piloto e passe por todos os critérios de qualidade antes da implantação completa.

Matriz de mapeamento de campos

Frente

Finalidade
Texto da pergunta
Regra de qualidade
Apenas um conceito
Nota operacional
Divida cartões sobrecarregados antes de importar

Verso

Finalidade
Resposta esperada
Regra de qualidade
Resposta direta primeiro
Nota operacional
Mantenha explicações longas nas notas

Tags

Finalidade
Agrupamento por tópico
Regra de qualidade
Taxonomia consistente
Nota operacional
Use nomes de domínio/capítulo

Extra / Notas

Finalidade
Apoio de contexto
Regra de qualidade
Curto e opcional
Nota operacional
Evite incluir pistas da resposta

Mídia

Finalidade
Contexto visual/áudio
Regra de qualidade
Anexada e legível
Nota operacional
Verifique referências quebradas na amostra

Critérios de qualidade por lote

Aplique os critérios antes de cada novo lote de importação. Se algum critério falhar, pause novas importações e corrija primeiro a qualidade dos cartões. Isso mantém os problemas pequenos e evita acúmulo de pendências.

Compreensão

Limite de aprovação
>=90% dos cartões da amostra compreensíveis
Sinal de falha
O formato da pergunta é ambíguo ou confuso

Taxa de duplicatas

Limite de aprovação
<3% de perguntas duplicadas na frente
Sinal de falha
O lote tem definições ou títulos repetidos

Carga da sessão

Limite de aprovação
Aumento do tempo de sessão <15% semana a semana
Sinal de falha
Os cartões importados estão muito longos

Tendência de lapsos

Limite de aprovação
Estável ou melhorando até a semana 2
Sinal de falha
A qualidade das perguntas é baixa nos tópicos principais

Casos extremos específicos do Anki para tratar antes de escalar

A maioria das regressões na migração vem de casos extremos que parecem pequenos em uma amostra e ficam caros em volume. Verifique a renderização de cloze, os estados de cartões suspensos, o comportamento de leech e as referências de mídia antes de importar mais baralhos.

Cartões cloze

Falha comum
Marcadores de cloze ausentes após a importação
Mitigação
Valide a renderização de cloze em uma amostra antes da migração completa

Cartões suspensos

Falha comum
Carga de revisão ativa inesperada
Mitigação
Exporte o estado de suspensão e reaplique após a importação

Cartões leech

Falha comum
Falhas crônicas poluem a fila
Mitigação
Marque os leeches com tag e aplique uma política de reescrita/arquivamento

Referências de mídia

Falha comum
Ponteiros de imagem ou áudio quebrados
Mitigação
Execute uma verificação de mídia quebrada nos primeiros 100 cartões

Opções do baralho

Falha comum
Comportamento de intervalos diferente
Mitigação
Acompanhe as métricas de 14 dias antes de escalar para outros baralhos

Contrato de importação CSV para migrações repetíveis

Se você faz importações recorrentes, defina um contrato CSV fixo e versione-o. Isso reduz a divergência de esquema entre operadores e facilita a automação de QA. Uma base prática é um contrato de seis colunas com campos de identidade, pergunta, resposta, contexto, taxonomia e origem.

note_id

Função
Identidade estável da linha
Restrição
Evita a importação duplicada acidental

front_text

Função
Campo da pergunta
Restrição
Normalize pontuação e variantes de unicode

back_text

Função
Campo da resposta
Restrição
Mantenha a resposta direta na primeira frase

context_hint

Função
Desambiguação opcional
Restrição
Use apenas um contexto curto do domínio

tags_pipe

Função
Agrupamento de taxonomia
Restrição
Use tags canônicas separadas por barra vertical

source_ref

Função
Rastreabilidade
Restrição
Armazene capítulo/página para rastreamento de QA

Mantenha a codificação UTF-8, imponha quebras de linha normalizadas e evite fórmulas ocultas de planilha nas células exportadas. Essas pequenas restrições evitam corrupção silenciosa na importação.

Protocolo de estabilização de 14 dias

  1. 1
    Dias 1-3: migre um baralho ativo e retome as revisões diárias imediatamente.
  2. 2
    Dias 4-7: corrija os cartões com mais falhas e remova as perguntas duplicadas na frente.
  3. 3
    Dias 8-10: padronize tags/modelos e valide a tendência do tempo de sessão.
  4. 4
    Dias 11-14: escale a migração somente se as métricas de conclusão e de lapsos continuarem saudáveis.

Orientação de migração por cenário

Maratona de prova (8-12 semanas)

Objetivo principal
Manter a conclusão diária estável
Abordagem recomendada
Importe apenas baralhos ativos e adie a migração do arquivo

Estudo de idiomas a longo prazo

Objetivo principal
Preservar o contexto das frases
Abordagem recomendada
Caminho CSV com normalização rigorosa dos campos

Migração em equipe

Objetivo principal
Consistência dos modelos
Abordagem recomendada
Publique um mapeamento canônico antes da importação em massa

Limpeza de arquivo

Objetivo principal
Aposentar baralhos de baixo rendimento
Abordagem recomendada
Migre por tópico e descarte cartões obsoletos logo no início

Perguntas frequentes

Devo usar APKG ou CSV primeiro?

Use APKG primeiro para transferir a estrutura rapidamente. Use CSV quando precisar de uma limpeza rigorosa dos campos ou normalização de modelos antes de escalar.

Quantos baralhos devo migrar de uma vez?

Comece com um baralho ativo e estabilize por 7 a 14 dias. Expanda somente quando a conclusão, o tempo de sessão e a tendência de lapsos continuarem saudáveis.

Posso usar o Anki e o Deckbase em paralelo durante a migração?

Sim. Muitas pessoas mantêm os baralhos antigos no Anki enquanto criam cartões novos no Deckbase e depois consolidam quando os controles de qualidade estiverem estáveis.

E se meus cartões não forem importados corretamente?

Os problemas mais comuns incluem erros de codificação (use UTF-8), campos obrigatórios ausentes e incompatibilidades de modelo. Exporte para CSV, corrija os problemas em uma planilha e importe novamente. O guia inclui um contrato CSV para migrações repetíveis.

Posso reverter se a migração não funcionar?

Sim. Antes da migração, exporte seu baralho do Anki como backup (.apkg). O Deckbase não apaga seus dados originais do Anki. Se o Deckbase não atender às suas necessidades, você pode voltar ao Anki sem perder seu progresso.

O que devo fazer na primeira semana após a migração?

Concentre-se na estabilização: corrija cartões com falhas, remova perguntas duplicadas e estabeleça sua rotina diária de revisão. Não adicione novos baralhos até que o principal esteja estável. Acompanhe de perto o tempo de sessão e as taxas de lapsos.

Vou perder meu histórico de revisões ao migrar?

O conteúdo dos cartões é transferido com a importação APKG, mas o histórico de revisões (estado de aprendizado, intervalos) não é, então os cartões importados começam do zero. Depois, o agendador FSRS do Deckbase define os intervalos a partir das suas novas revisões.

Primeira semana após a migração: checklist de sucesso

Os primeiros sete dias determinam se a sua migração terá sucesso. Concentre-se em estabilizar seu baralho principal antes de expandir para outros baralhos.

  1. 1
    Dia 1: Faça a primeira sessão de revisão com os cartões importados. Anote quaisquer problemas de formatação.
  2. 2
    Dias 2-3: Identifique e corrija cartões que pareçam confusos ou tenham perguntas pouco claras.
  3. 3
    Dias 4-5: Faça a verificação de duplicatas e una cartões com frentes idênticas.
  4. 4
    Dias 6-7: Avalie o tempo de sessão. Se aumentou bastante, investigue o tamanho dos cartões.
  5. 5
    Até o dia 7: Decida se vai continuar com o Anki, migrar totalmente para o Deckbase ou manter os dois.

Dica de especialista: mantenha a instalação do Anki e os baralhos originais intactos durante o primeiro mês. Isso dá a você uma opção de reversão caso o Deckbase não atenda às suas necessidades.

Precisa de uma visão geral primeiro? Leia o post publicado sobre estratégia de migração e depois volte a este guia para a execução. Comece pelo guia de importação/exportação do Anki.