Guide · Ressources

Playbook de migration Anki vers Deckbase

Un flux de migration à faible risque pour les voies APKG et CSV, avec des contrôles qualité explicites afin que la rapidité d'importation ne dégrade pas la qualité de la rétention.

Équipe éditoriale DeckbaseLecture : 8 min

À qui s'adresse ce playbook

Ce guide s'adresse aux apprenants qui ont déjà des decks Anki actifs et veulent passer à Deckbase de façon structurée sans rompre la cohérence des révisions quotidiennes. Si vous recherchez anki import csv, voici la voie de mise en œuvre qui distingue transfert rapide et stabilisation de la qualité.

Liste de contrôle avant migration

  1. 1
    Sauvegardez chaque deck source avant la première importation.
  2. 2
    Listez les decks actifs des 30 derniers jours et migrez-les en premier.
  3. 3
    Définissez des contrôles qualité avec critères de réussite ou d'échec avant de dépasser un deck.
  4. 4
    Fixez un plancher de révision quotidienne (en temps ou en cartes) pour protéger la continuité de l'habitude.

Voie A : migration d'abord via APKG

Utilisez l'APKG quand la vitesse et la préservation de la structure priment. Cette voie est idéale pour une première vague de migration où l'objectif est la continuité, pas un nettoyage parfait.

  • Importez un deck actif et inspectez immédiatement un échantillon de 30 cartes.
  • Corrigez uniquement les problèmes à fort impact : questions illisibles, médias cassés, doublons évidents.
  • Reprenez les révisions le même jour au lieu de tout suspendre pour de grandes retouches cosmétiques.

Voie B : migration d'abord via CSV

Utilisez le CSV quand une normalisation au niveau des champs est nécessaire. Le CSV prend plus de temps au départ, mais il est plus facile d'y imposer la cohérence des noms, les règles de modèle et la déduplication à grande échelle.

  1. 1
    Normalisez les noms de champs et le formatage des termes avant l'importation.
  2. 2
    Créez une correspondance canonique pour la question, la réponse, les balises et le contexte.
  3. 3
    Importez d'abord un lot pilote et validez tous les contrôles qualité avant le déploiement complet.

Matrice de correspondance des champs

Front

Objectif
Texte de la question
Règle qualité
Un seul concept
Note opérationnelle
Divisez les cartes surchargées avant l'importation

Back

Objectif
Réponse attendue
Règle qualité
Réponse directe d'abord
Note opérationnelle
Gardez les longues explications dans les notes

Tags

Objectif
Regroupement par sujet
Règle qualité
Taxonomie cohérente
Note opérationnelle
Utilisez une nomenclature domaine/chapitre

Extra / Notes

Objectif
Support contextuel
Règle qualité
Court et optionnel
Note opérationnelle
Évitez d'y intégrer des indices de réponse

Media

Objectif
Contexte visuel ou audio
Règle qualité
Joint et lisible
Note opérationnelle
Vérifiez les références cassées dans l'échantillon

Contrôles qualité par lot

Exécutez les contrôles avant chaque nouveau lot d'importation. Si un contrôle échoue, suspendez les nouvelles importations et réparez d'abord la qualité des cartes. Cela garde les problèmes petits et évite une dette de backlog.

Compréhension

Seuil de réussite
>=90 % des cartes échantillonnées compréhensibles
Signal d'échec
Le format de la question est ambigu ou bruité

Taux de doublons

Seuil de réussite
<3 % de questions avant en double
Signal d'échec
Le lot contient des définitions ou titres répétés

Charge de session

Seuil de réussite
Augmentation du temps de session <15 % d'une semaine sur l'autre
Signal d'échec
Les cartes importées sont trop verbeuses

Tendance des lapses

Seuil de réussite
Stable ou en amélioration dès la semaine 2
Signal d'échec
La qualité des questions est faible pour les sujets clés

Cas limites spécifiques à Anki à traiter avant la montée en échelle

La plupart des régressions de migration viennent de cas limites qui semblent minimes dans un échantillon et deviennent coûteux en volume. Vérifiez le rendu des textes à trous, les états de cartes suspendues, le comportement des cartes difficiles et les références médias avant d'importer des decks supplémentaires.

Cartes à trous

Échec courant
Marqueurs de trous manquants après l'importation
Atténuation
Validez le rendu d'un échantillon de cartes à trous avant la migration complète

Cartes suspendues

Échec courant
Charge de révision active inattendue
Atténuation
Exportez l'état de suspension et réappliquez-le après l'importation

Cartes difficiles

Échec courant
Les échecs chroniques polluent la file
Atténuation
Balisez les cartes difficiles et appliquez une politique de réécriture ou d'archivage

Références médias

Échec courant
Pointeurs d'image ou d'audio cassés
Atténuation
Lancez un scan des médias cassés sur les 100 premières cartes

Options de deck

Échec courant
Comportement des intervalles incohérent
Atténuation
Suivez les métriques sur 14 jours avant d'étendre à d'autres decks

Contrat d'importation CSV pour des migrations répétables

Si vous exécutez des importations récurrentes, définissez un contrat CSV fixe et versionnez-le. Cela réduit la dérive de schéma entre opérateurs et facilite l'automatisation qualité. Une base pratique est un contrat à six colonnes avec les champs identité, question, réponse, contexte, taxonomie et source.

note_id

Rôle
Identité stable de la ligne
Contrainte
Empêche l'ingestion accidentelle de doublons

front_text

Rôle
Champ de question
Contrainte
Normalisez la ponctuation et les variantes unicode

back_text

Rôle
Champ de réponse
Contrainte
Gardez la réponse directe dans la première phrase

context_hint

Rôle
Désambiguïsation optionnelle
Contrainte
Utilisez uniquement un contexte de domaine court

tags_pipe

Rôle
Regroupement taxonomique
Contrainte
Utilisez des balises canoniques délimitées par des pipes

source_ref

Rôle
Traçabilité
Contrainte
Stockez le chapitre ou la page pour le retour qualité

Conservez un encodage UTF-8, imposez des sauts de ligne normalisés et évitez les formules de tableur cachées dans les cellules exportées. Ces petites contraintes évitent une corruption silencieuse à l'importation.

Protocole de stabilisation sur 14 jours

  1. 1
    Jours 1 à 3 : migrez un deck actif et reprenez immédiatement les révisions quotidiennes.
  2. 2
    Jours 4 à 7 : réparez les cartes qui échouent le plus et dédupliquez les questions avant.
  3. 3
    Jours 8 à 10 : standardisez les balises et modèles, puis validez la tendance du temps de session.
  4. 4
    Jours 11 à 14 : étendez la migration seulement si les métriques de complétion et de lapses restent saines.

Guidance de migration par scénario

Sprint d'examen (8 à 12 semaines)

Objectif principal
Garder une complétion quotidienne stable
Approche recommandée
Importez uniquement les decks actifs, suspendez la migration des archives

Étude de langue à long terme

Objectif principal
Préserver le contexte des phrases
Approche recommandée
Voie CSV avec normalisation stricte des champs

Migration d'équipe

Objectif principal
Cohérence des modèles
Approche recommandée
Publiez une correspondance canonique unique avant l'importation en masse

Nettoyage d'archive

Objectif principal
Retirer les decks à faible rendement
Approche recommandée
Migrez par sujet et supprimez tôt les cartes obsolètes

FAQ

Dois-je utiliser d'abord l'APKG ou le CSV ?

Utilisez d'abord l'APKG pour un transfert rapide de la structure. Utilisez le CSV quand vous avez besoin d'un nettoyage strict des champs ou d'une normalisation des modèles avant la montée en échelle.

Combien de decks dois-je migrer à la fois ?

Commencez par un deck actif et stabilisez-le pendant 7 à 14 jours. N'élargissez que si la complétion, le temps de session et la tendance des lapses restent sains.

Puis-je garder Anki et Deckbase en parallèle pendant la migration ?

Oui. De nombreux apprenants gardent leurs decks hérités dans Anki tout en créant de nouvelles cartes dans Deckbase, puis consolident une fois les contrôles qualité stables.

Que faire si mes cartes ne s'importent pas correctement ?

Les problèmes courants incluent les erreurs d'encodage (utilisez UTF-8), les champs obligatoires manquants et les incompatibilités de modèle. Exportez vers CSV, corrigez les problèmes dans un tableur, puis réimportez. Le playbook inclut un contrat CSV pour des migrations répétables.

Puis-je revenir en arrière si la migration ne fonctionne pas ?

Oui. Avant la migration, exportez votre deck Anki en sauvegarde (.apkg). Deckbase ne supprime pas vos données Anki d'origine. Si Deckbase ne répond pas à vos besoins, vous pouvez toujours revenir à Anki sans perdre votre progression.

Que faire la première semaine après la migration ?

Concentrez-vous sur la stabilisation : réparez les cartes qui échouent, dédupliquez les questions et installez votre routine de révision quotidienne. N'ajoutez pas de nouveaux decks tant que votre deck principal n'est pas stable. Surveillez de près le temps de session et les taux de lapses.

Vais-je perdre mon historique de révision lors de la migration ?

Le contenu des cartes est transféré avec l'importation APKG, mais pas l'historique de révision (état d'apprentissage, intervalles), donc les cartes importées repartent à zéro. Le planificateur FSRS de Deckbase définit ensuite les intervalles à partir de vos nouvelles révisions.

Première semaine après la migration : liste de contrôle de réussite

Les sept premiers jours déterminent si votre migration réussit. Concentrez-vous sur la stabilisation de votre deck principal avant d'étendre à d'autres decks.

  1. 1
    Jour 1 : terminez la première session de révision avec les cartes importées. Notez tout problème de formatage.
  2. 2
    Jours 2 à 3 : identifiez et réparez les cartes déroutantes ou aux questions peu claires.
  3. 3
    Jours 4 à 5 : lancez la vérification des doublons et fusionnez les cartes aux questions identiques.
  4. 4
    Jour 6 à 7 : évaluez votre temps de session. S'il a fortement augmenté, examinez la longueur des cartes.
  5. 5
    Avant le jour 7 : décidez si vous continuez avec Anki, basculez entièrement vers Deckbase, ou conservez les deux.

Astuce : gardez votre installation Anki et vos decks d'origine intacts pendant le premier mois. Cela vous laisse une option de retour si Deckbase ne répond pas à vos besoins.

Besoin d'abord de la vue d'ensemble ? Lisez l'article publié sur la stratégie de migration, puis revenez à ce playbook pour l'exécution. Commencez par le guide d'import/export Anki.