Panduan · Sumber Daya

Playbook migrasi Anki ke Deckbase

Alur kerja migrasi berisiko rendah untuk jalur APKG dan CSV, dengan gerbang kualitas yang jelas agar kecepatan impor tidak merusak kualitas retensi.

Tim Editorial DeckbaseBacaan 8 menit

Untuk siapa playbook ini

Panduan ini untuk pelajar yang sudah memiliki dek Anki aktif dan ingin pindah ke Deckbase secara terstruktur tanpa mengganggu konsistensi ulasan harian. Jika Anda mencari anki import csv, ini adalah jalur implementasi yang memisahkan transfer cepat dari stabilisasi kualitas.

Daftar periksa pra-migrasi

1
Cadangkan setiap dek sumber sebelum impor pertama.
2
Daftarkan dek aktif dari 30 hari terakhir dan migrasikan lebih dulu.
3
Tetapkan gerbang kualitas lulus/gagal sebelum melampaui satu dek.
4
Tetapkan batas ulasan harian (berbasis waktu atau jumlah kartu) untuk melindungi kontinuitas kebiasaan.

Jalur A: migrasi APKG lebih dulu

Gunakan APKG ketika kecepatan dan pelestarian struktur paling penting. Jalur ini ideal untuk gelombang migrasi pertama di mana tujuannya adalah kontinuitas, bukan pembersihan sempurna.

Impor satu dek aktif dan periksa sampel 30 kartu segera.
Perbaiki hanya masalah berdampak tinggi: pertanyaan tidak terbaca, media rusak, duplikat yang jelas.
Lanjutkan ulasan di hari yang sama alih-alih berhenti untuk pengeditan kosmetik besar.

Jalur B: migrasi CSV lebih dulu

Gunakan CSV ketika normalisasi tingkat bidang diperlukan. CSV memakan waktu lebih lama di awal, tetapi lebih mudah menegakkan konsistensi penamaan, aturan template, dan deduplikasi pada skala besar.

1
Normalisasikan nama bidang dan format istilah sebelum impor.
2
Buat satu pemetaan kanonik untuk pertanyaan, jawaban, tag, dan konteks.
3
Impor batch percontohan lebih dulu dan lewati semua gerbang kualitas sebelum penerapan penuh.

Matriks pemetaan bidang

Bidang	Tujuan	Aturan kualitas	Catatan operasional
Front	Teks pertanyaan	Satu konsep saja	Pisahkan kartu yang terlalu penuh sebelum impor
Back	Jawaban yang diharapkan	Jawaban langsung di awal	Simpan penjelasan panjang di catatan
Tags	Pengelompokan topik	Taksonomi konsisten	Gunakan penamaan domain/bab
Extra / Notes	Dukungan konteks	Singkat dan opsional	Hindari menyertakan petunjuk jawaban
Media	Konteks visual/audio	Terpasang dan dapat dibaca	Verifikasi referensi rusak pada sampel

Front

Tujuan: Teks pertanyaan
Aturan kualitas: Satu konsep saja
Catatan operasional: Pisahkan kartu yang terlalu penuh sebelum impor

Back

Tujuan: Jawaban yang diharapkan
Aturan kualitas: Jawaban langsung di awal
Catatan operasional: Simpan penjelasan panjang di catatan

Gerbang kualitas batch

Jalankan gerbang sebelum setiap batch impor baru. Jika satu gerbang gagal, hentikan impor baru dan perbaiki kualitas kartu lebih dulu. Ini menjaga masalah tetap kecil dan mencegah utang backlog.

Gerbang	Ambang lulus	Sinyal gagal
Pemahaman	>=90% kartu sampel dapat dipahami	Format pertanyaan ambigu atau berisik
Tingkat duplikat	<3% pertanyaan front duplikat	Batch berisi definisi atau judul yang berulang
Beban sesi	Kenaikan waktu sesi <15% WoW	Kartu impor terlalu bertele-tele
Tren kelupaan	Stabil atau membaik pada minggu ke-2	Kualitas pertanyaan rendah untuk topik inti

Pemahaman

Ambang lulus: >=90% kartu sampel dapat dipahami
Sinyal gagal: Format pertanyaan ambigu atau berisik

Tingkat duplikat

Ambang lulus: <3% pertanyaan front duplikat
Sinyal gagal: Batch berisi definisi atau judul yang berulang

Beban sesi

Ambang lulus: Kenaikan waktu sesi <15% WoW
Sinyal gagal: Kartu impor terlalu bertele-tele

Tren kelupaan

Ambang lulus: Stabil atau membaik pada minggu ke-2
Sinyal gagal: Kualitas pertanyaan rendah untuk topik inti

Kasus khusus Anki yang harus ditangani sebelum skala besar

Sebagian besar regresi migrasi berasal dari kasus khusus yang terlihat kecil dalam sampel tetapi menjadi mahal pada volume besar. Periksa rendering cloze, status kartu yang disuspend, perilaku leech, dan referensi media sebelum mengimpor dek tambahan.

Kasus khusus	Kegagalan umum	Mitigasi
Kartu cloze	Penanda cloze hilang setelah impor	Validasikan rendering cloze sampel sebelum migrasi penuh
Kartu disuspend	Beban ulasan aktif tak terduga	Ekspor status suspensi dan terapkan kembali setelah impor
Kartu leech	Kegagalan kronis mencemari antrean	Beri tag leech dan jalankan kebijakan tulis ulang/arsip
Referensi media	Pointer gambar atau audio rusak	Jalankan pemindaian media rusak pada 100 kartu pertama
Opsi dek	Perilaku interval tidak cocok	Jalankan metrik 14 hari sebelum menskalakan dek tambahan

Kartu cloze

Kegagalan umum: Penanda cloze hilang setelah impor
Mitigasi: Validasikan rendering cloze sampel sebelum migrasi penuh

Kartu disuspend

Kegagalan umum: Beban ulasan aktif tak terduga
Mitigasi: Ekspor status suspensi dan terapkan kembali setelah impor

Kartu leech

Kegagalan umum: Kegagalan kronis mencemari antrean
Mitigasi: Beri tag leech dan jalankan kebijakan tulis ulang/arsip

Referensi media

Kegagalan umum: Pointer gambar atau audio rusak
Mitigasi: Jalankan pemindaian media rusak pada 100 kartu pertama

Opsi dek

Kegagalan umum: Perilaku interval tidak cocok
Mitigasi: Jalankan metrik 14 hari sebelum menskalakan dek tambahan

Kontrak impor CSV untuk migrasi yang dapat diulang

Jika Anda menjalankan impor berulang, tetapkan kontrak CSV yang tetap dan beri versi. Ini mengurangi penyimpangan skema antar operator dan mempermudah otomatisasi QA. Baseline praktis adalah kontrak enam kolom dengan bidang identitas, pertanyaan, jawaban, konteks, taksonomi, dan sumber.

Kolom	Peran	Batasan
note_id	Identitas baris yang stabil	Mencegah ingest duplikat yang tidak disengaja
front_text	Bidang pertanyaan	Normalisasikan tanda baca dan varian unicode
back_text	Bidang jawaban	Simpan jawaban langsung di kalimat pertama
context_hint	Disambiguasi opsional	Gunakan konteks domain singkat saja
tags_pipe	Pengelompokan taksonomi	Gunakan tag kanonik dengan pembatas pipa
source_ref	Keterlacakan	Simpan bab/halaman untuk penelusuran QA

note_id

Peran: Identitas baris yang stabil
Batasan: Mencegah ingest duplikat yang tidak disengaja

front_text

Peran: Bidang pertanyaan
Batasan: Normalisasikan tanda baca dan varian unicode

back_text

Peran: Bidang jawaban
Batasan: Simpan jawaban langsung di kalimat pertama

context_hint

Peran: Disambiguasi opsional
Batasan: Gunakan konteks domain singkat saja

tags_pipe

Peran: Pengelompokan taksonomi
Batasan: Gunakan tag kanonik dengan pembatas pipa

source_ref

Peran: Keterlacakan
Batasan: Simpan bab/halaman untuk penelusuran QA

Pertahankan enkoding UTF-8, tegakkan jeda baris yang dinormalisasi, dan hindari rumus spreadsheet tersembunyi di sel ekspor. Batasan kecil tersebut mencegah korupsi impor yang diam-diam terjadi.

Protokol stabilisasi 14 hari

1
Hari 1-3: migrasikan satu dek aktif dan langsung mulai ulasan harian.
2
Hari 4-7: perbaiki kartu yang paling sering gagal dan deduplikasi pertanyaan front.
3
Hari 8-10: standarkan tag/template dan validasikan tren waktu sesi.
4
Hari 11-14: skalakan migrasi hanya jika metrik penyelesaian dan kelupanan tetap sehat.

Panduan migrasi berbasis skenario

Skenario	Tujuan utama	Pendekatan yang direkomendasikan
Sprint ujian (8-12 minggu)	Jaga penyelesaian harian tetap stabil	Impor hanya dek aktif, tunda migrasi arsip
Studi bahasa jangka panjang	Pertahankan konteks kalimat	Jalur CSV dengan normalisasi bidang ketat
Migrasi tim	Konsistensi template	Terbitkan satu pemetaan kanonik sebelum impor massal
Pembersihan arsip	Pensiunkan dek dengan hasil rendah	Migrasikan per topik dan buang kartu basi lebih awal

Sprint ujian (8-12 minggu)

Tujuan utama: Jaga penyelesaian harian tetap stabil
Pendekatan yang direkomendasikan: Impor hanya dek aktif, tunda migrasi arsip

Studi bahasa jangka panjang

Tujuan utama: Pertahankan konteks kalimat
Pendekatan yang direkomendasikan: Jalur CSV dengan normalisasi bidang ketat

Migrasi tim

Tujuan utama: Konsistensi template
Pendekatan yang direkomendasikan: Terbitkan satu pemetaan kanonik sebelum impor massal

Pembersihan arsip

Tujuan utama: Pensiunkan dek dengan hasil rendah
Pendekatan yang direkomendasikan: Migrasikan per topik dan buang kartu basi lebih awal

FAQ

Haruskah saya menggunakan APKG atau CSV lebih dulu?

Gunakan APKG lebih dulu untuk transfer struktur yang cepat. Gunakan CSV ketika Anda memerlukan pembersihan bidang yang ketat atau normalisasi template sebelum skala besar.

Berapa banyak dek yang harus saya migrasikan sekaligus?

Mulailah dengan satu dek aktif dan stabilkan selama 7-14 hari. Perluas hanya ketika penyelesaian, waktu sesi, dan tren kelupanan tetap sehat.

Bisakah saya memakai Anki dan Deckbase secara paralel selama migrasi?

Bisa. Banyak pelajar mempertahankan dek lama di Anki sambil membuat kartu baru di Deckbase, lalu mengonsolidasikan setelah kontrol kualitas stabil.

Bagaimana jika kartu saya tidak terimpor dengan benar?

Masalah umum meliputi masalah enkoding (gunakan UTF-8), bidang wajib yang hilang, dan ketidakcocokan template. Ekspor ke CSV, perbaiki masalah di spreadsheet, dan impor ulang. Playbook ini mencakup kontrak CSV untuk migrasi yang dapat diulang.

Bisakah saya kembali jika migrasi tidak berhasil?

Bisa. Sebelum migrasi, ekspor dek Anki Anda sebagai cadangan (.apkg). Deckbase tidak akan menghapus data Anki asli Anda. Jika Deckbase tidak memenuhi kebutuhan Anda, Anda selalu dapat kembali ke Anki tanpa kehilangan progres.

Apa yang harus saya lakukan pada minggu pertama setelah migrasi?

Fokus pada stabilisasi: perbaiki kartu yang gagal, deduplikasi pertanyaan, dan bangun rutinitas ulasan harian Anda. Jangan menambah dek baru sampai dek utama Anda stabil. Pantau waktu sesi dan tingkat kelupanan dengan cermat.

Apakah riwayat ulasan saya hilang saat migrasi?

Konten kartu berpindah dengan impor APKG, tetapi riwayat ulasan (status belajar, interval) tidak ikut, sehingga kartu impor dimulai dari awal. Penjadwal FSRS Deckbase kemudian menetapkan interval berdasarkan ulasan baru Anda.

Minggu pertama setelah migrasi: daftar periksa keberhasilan

Tujuh hari pertama menentukan keberhasilan migrasi Anda. Fokus pada stabilisasi dek utama sebelum memperluas ke dek tambahan.

1
Hari 1: Selesaikan sesi ulasan pertama dengan kartu impor. Catat masalah format apa pun.
2
Hari 2-3: Identifikasi dan perbaiki kartu yang membingungkan atau pertanyaannya tidak jelas.
3
Hari 4-5: Jalankan pemeriksaan duplikat dan gabungkan kartu dengan front yang identik.
4
Hari 6-7: Evaluasi waktu sesi Anda. Jika meningkat signifikan, selidiki panjang kartu.
5
Pada Hari 7: Putuskan apakah melanjutkan dengan Anki, beralih sepenuhnya ke Deckbase, atau memakai keduanya.

Tips pro: Pertahankan instalasi Anki dan dek asli Anda selama bulan pertama. Ini memberi Anda opsi kembali jika Deckbase tidak memenuhi kebutuhan Anda.

Butuh gambaran tingkat atas lebih dulu? Baca artikel terbit tentang strategi migrasi, lalu kembali ke playbook ini untuk eksekusi. Mulai dari Panduan impor/ekspor Anki.