Guía · Recursos

Guía de migración de Anki a Deckbase

Un flujo de migración de bajo riesgo para las rutas APKG y CSV, con controles de calidad explícitos para que la velocidad de importación no dañe la calidad de la retención.

Equipo editorial de Deckbase8 min de lectura

Para quién es esta guía

Esta guía es para estudiantes que ya tienen mazos activos en Anki y quieren pasar a Deckbase de forma estructurada sin perder la consistencia de las revisiones diarias. Si buscas anki import csv, esta es la ruta de implementación que separa la transferencia rápida de la estabilización de calidad.

Lista de verificación previa a la migración

  1. 1
    Haz una copia de seguridad de cada mazo fuente antes de la primera importación.
  2. 2
    Enumera los mazos activos de los últimos 30 días y migra esos primero.
  3. 3
    Define controles de calidad de aprobado/reprobado antes de escalar más allá de un mazo.
  4. 4
    Establece un mínimo diario de revisión (por tiempo o por tarjetas) para proteger la continuidad del hábito.

Ruta A: migración con APKG primero

Usa APKG cuando la velocidad y la preservación de la estructura sean lo más importante. Esta ruta es ideal para una primera ola de migración donde el objetivo es la continuidad, no la limpieza perfecta.

  • Importa un mazo activo e inspecciona de inmediato una muestra de 30 tarjetas.
  • Corrige solo los problemas de mayor impacto: preguntas ilegibles, archivos multimedia rotos, duplicados evidentes.
  • Reanuda las revisiones el mismo día en lugar de pausar por ediciones cosméticas extensas.

Ruta B: migración con CSV primero

Usa CSV cuando se requiera normalización a nivel de campo. CSV toma más tiempo al inicio, pero es más fácil hacer cumplir la consistencia de nombres, las reglas de plantilla y la deduplicación a escala.

  1. 1
    Normaliza los nombres de campo y el formato de términos antes de importar.
  2. 2
    Crea un mapeo canónico para pregunta, respuesta, etiquetas y contexto.
  3. 3
    Importa primero un lote piloto y supera todos los controles de calidad antes del despliegue completo.

Matriz de mapeo de campos

Frente

Propósito
Texto de la pregunta
Regla de calidad
Un solo concepto
Nota operativa
Divide las tarjetas sobrecargadas antes de importar

Reverso

Propósito
Respuesta esperada
Regla de calidad
Respuesta directa primero
Nota operativa
Mantén las explicaciones largas en las notas

Etiquetas

Propósito
Agrupación por tema
Regla de calidad
Taxonomía consistente
Nota operativa
Usa nomenclatura dominio/capítulo

Extra / Notas

Propósito
Soporte de contexto
Regla de calidad
Corto y opcional
Nota operativa
Evita incluir pistas de la respuesta

Multimedia

Propósito
Contexto visual/auditivo
Regla de calidad
Adjunto y legible
Nota operativa
Verifica referencias rotas en la muestra

Controles de calidad por lote

Ejecuta los controles antes de cada nuevo lote de importación. Si un control falla, pausa las nuevas importaciones y corrige primero la calidad de las tarjetas. Esto mantiene los problemas pequeños y evita deuda acumulada.

Comprensión

Umbral de aprobado
>=90% de tarjetas muestreadas comprensibles
Señal de reprobado
El formato de la pregunta es ambiguo o ruidoso

Tasa de duplicados

Umbral de aprobado
<3% de preguntas frontales duplicadas
Señal de reprobado
El lote tiene definiciones o encabezados repetidos

Carga de sesión

Umbral de aprobado
Aumento de tiempo de sesión <15% semana a semana
Señal de reprobado
Las tarjetas importadas son demasiado extensas

Tendencia de errores

Umbral de aprobado
Estable o mejorando para la semana 2
Señal de reprobado
La calidad de las preguntas es baja para temas clave

Casos particulares de Anki que debes manejar antes de escalar

La mayoría de las regresiones de migración provienen de casos particulares que parecen pequeños en una muestra y se vuelven costosos en volumen. Revisa el renderizado de clozes, los estados de tarjetas suspendidas, el comportamiento de leeches y las referencias multimedia antes de importar mazos adicionales.

Tarjetas cloze

Fallo común
Faltan marcadores cloze después de la importación
Mitigación
Valida el renderizado cloze en una muestra antes de la migración completa

Tarjetas suspendidas

Fallo común
Carga de revisión activa inesperada
Mitigación
Exporta el estado de suspensión y reaplícalo después de importar

Tarjetas leech

Fallo común
Fallos crónicos contaminan la cola
Mitigación
Etiqueta los leeches y aplica una política de reescritura/archivado

Referencias multimedia

Fallo común
Punteros de imagen o audio rotos
Mitigación
Ejecuta un escaneo de multimedia rota en las primeras 100 tarjetas

Opciones de mazo

Fallo común
Comportamiento de intervalos inconsistente
Mitigación
Ejecuta métricas de 14 días antes de escalar mazos adicionales

Contrato de importación CSV para migraciones repetibles

Si ejecutas importaciones recurrentes, define un contrato CSV fijo y versionado. Esto reduce la desviación de esquema entre operadores y facilita la automatización de QA. Una base práctica es un contrato de seis columnas con campos de identidad, pregunta, respuesta, contexto, taxonomía y origen.

note_id

Rol
Identidad estable de la fila
Restricción
Evita la ingestión accidental de duplicados

front_text

Rol
Campo de pregunta
Restricción
Normaliza puntuación y variantes de unicode

back_text

Rol
Campo de respuesta
Restricción
Mantén la respuesta directa en la primera oración

context_hint

Rol
Desambiguación opcional
Restricción
Usa solo contexto de dominio breve

tags_pipe

Rol
Agrupación taxonómica
Restricción
Usa etiquetas canónicas delimitadas por pipe

source_ref

Rol
Trazabilidad
Restricción
Guarda capítulo/página para rastreo de QA

Mantén la codificación UTF-8, aplica saltos de línea normalizados y evita fórmulas ocultas de hojas de cálculo en las celdas exportadas. Esas pequeñas restricciones evitan corrupción silenciosa en la importación.

Protocolo de estabilización de 14 días

  1. 1
    Días 1-3: migra un mazo activo y reinicia de inmediato las revisiones diarias.
  2. 2
    Días 4-7: corrige las tarjetas con más fallos y deduplica las preguntas frontales.
  3. 3
    Días 8-10: estandariza etiquetas/plantillas y valida la tendencia del tiempo de sesión.
  4. 4
    Días 11-14: escala la migración solo si las métricas de completitud y errores se mantienen saludables.

Guía de migración según escenario

Sprint de examen (8-12 semanas)

Objetivo principal
Mantener estable la completitud diaria
Enfoque recomendado
Importa solo mazos activos, pausa la migración del archivo

Estudio de idiomas a largo plazo

Objetivo principal
Preservar el contexto de las oraciones
Enfoque recomendado
Ruta CSV con normalización estricta de campos

Migración en equipo

Objetivo principal
Consistencia de plantillas
Enfoque recomendado
Publica un mapeo canónico antes de la importación masiva

Limpieza de archivo

Objetivo principal
Retirar mazos de bajo rendimiento
Enfoque recomendado
Migra por tema y elimina tarjetas obsoletas desde el inicio

Preguntas frecuentes

¿Debo usar APKG o CSV primero?

Usa APKG primero para una transferencia rápida de estructura. Usa CSV cuando necesitas una limpieza estricta de campos o normalización de plantillas antes de escalar.

¿Cuántos mazos debo migrar a la vez?

Comienza con un mazo activo y estabilízalo durante 7-14 días. Expande solo cuando la completitud, el tiempo de sesión y la tendencia de errores se mantengan saludables.

¿Puedo mantener Anki y Deckbase en paralelo durante la migración?

Sí. Muchos estudiantes mantienen los mazos heredados en Anki mientras crean tarjetas nuevas en Deckbase, y luego consolidan una vez que los controles de calidad son estables.

¿Qué hago si mis tarjetas no se importan correctamente?

Los problemas comunes incluyen problemas de codificación (usa UTF-8), campos obligatorios faltantes e incompatibilidades de plantilla. Exporta a CSV, corrige los problemas en una hoja de cálculo y vuelve a importar. La guía incluye un contrato CSV para migraciones repetibles.

¿Puedo revertir si la migración no funciona?

Sí. Antes de la migración, exporta tu mazo de Anki como copia de seguridad (.apkg). Deckbase no elimina tus datos originales de Anki. Si Deckbase no cumple tus necesidades, siempre puedes volver a Anki sin perder tu progreso.

¿Qué debo hacer la primera semana después de la migración?

Céntrate en la estabilización: corrige tarjetas que fallan, deduplica preguntas y establece tu rutina diaria de revisión. No agregues mazos nuevos hasta que tu mazo principal sea estable. Monitorea de cerca el tiempo de sesión y las tasas de errores.

¿Perderé mi historial de revisiones al migrar?

El contenido de las tarjetas se transfiere con la importación APKG, pero el historial de revisiones (estado de aprendizaje, intervalos) no, así que las tarjetas importadas comienzan de cero. El planificador FSRS de Deckbase establece entonces los intervalos a partir de tus nuevas revisiones.

Primera semana después de la migración: lista de verificación del éxito

Los primeros siete días determinan si tu migración tiene éxito. Céntrate en estabilizar tu mazo principal antes de expandirte a mazos adicionales.

  1. 1
    Día 1: completa la primera sesión de revisión con las tarjetas importadas. Anota cualquier problema de formato.
  2. 2
    Días 2-3: identifica y corrige las tarjetas que resulten confusas o tengan preguntas poco claras.
  3. 3
    Días 4-5: ejecuta una verificación de duplicados y combina tarjetas con frentes idénticos.
  4. 4
    Días 6-7: evalúa tu tiempo de sesión. Si aumentó significativamente, investiga la longitud de las tarjetas.
  5. 5
    Para el día 7: decide si continuar con Anki, cambiar por completo a Deckbase o mantener ambos.

Consejo profesional: mantén tu instalación de Anki y tus mazos originales intactos durante el primer mes. Esto te da una opción de reversa si Deckbase no cumple tus necesidades.

¿Necesitas primero la visión general? Lee la publicación sobre estrategia de migración y luego regresa a esta guía para la ejecución. Comienza por la guía de importación/exportación de Anki.