가이드 · 리소스
Anki에서 Deckbase로 마이그레이션 플레이북
APKG와 CSV 경로를 위한 저위험 마이그레이션 워크플로우로, 명확한 품질 게이트를 적용해 가져오기 속도가 복습 품질을 해치지 않도록 합니다.
이 플레이북의 대상
이 가이드는 이미 활성 Anki 덱을 보유하고 있으며, 매일의 복습 일관성을 깨지 않으면서 Deckbase로 체계적으로 옮기고자 하는 학습자를 위한 것입니다. anki import csv를 검색 중이라면, 이 문서가 빠른 이전과 품질 안정화를 구분해 주는 구현 경로입니다.
마이그레이션 전 체크리스트
- 1첫 가져오기 전에 모든 원본 덱을 백업하세요.
- 2지난 30일 동안 활성이었던 덱을 목록화하고 그것부터 먼저 이전하세요.
- 3하나의 덱을 넘어 확장하기 전에 합격/불합격 품질 게이트를 정의하세요.
- 4습관의 연속성을 지키기 위해 매일 복습 하한선(시간 기준 또는 카드 수 기준)을 설정하세요.
경로 A: APKG 우선 마이그레이션
속도와 구조 보존이 가장 중요할 때 APKG를 사용하세요. 이 경로는 완벽한 정리보다 연속성이 목표인 첫 마이그레이션 웨이브에 적합합니다.
- 활성 덱 하나를 가져온 직후 30장 샘플을 바로 검토하세요.
- 영향력이 큰 문제만 수정하세요: 읽기 어려운 질문, 깨진 미디어, 명백한 중복.
- 대규모 꾸미기 수정 때문에 멈추기보다는 같은 날 바로 복습을 재개하세요.
경로 B: CSV 우선 마이그레이션
필드 단위 정규화가 필요할 때 CSV를 사용하세요. CSV는 초반에 시간이 더 걸리지만, 대규모로 명명 일관성, 템플릿 규칙, 중복 제거를 적용하기가 더 쉽습니다.
- 1가져오기 전에 필드 이름과 용어 형식을 정규화하세요.
- 2질문, 답변, 태그, 맥락에 대한 하나의 표준 매핑을 만드세요.
- 3먼저 파일럿 배치를 가져온 뒤 모든 품질 게이트를 통과하면 전체 롤아웃하세요.
필드 매핑 매트릭스
앞면
- 용도
- 질문 텍스트
- 품질 규칙
- 개념 하나만
- 운영 참고 사항
- 가져오기 전에 과밀한 카드를 분할하세요
뒷면
- 용도
- 예상 답변
- 품질 규칙
- 답변이 먼저
- 운영 참고 사항
- 긴 설명은 노트에 두세요
태그
- 용도
- 주제 그룹화
- 품질 규칙
- 일관된 분류 체계
- 운영 참고 사항
- 도메인/챕터 명명 사용
추가 / 노트
- 용도
- 맥락 보조
- 품질 규칙
- 짧고 선택 사항
- 운영 참고 사항
- 답변 힌트를 넣지 마세요
미디어
- 용도
- 시각/청각 맥락
- 품질 규칙
- 첨부되고 읽기 가능
- 운영 참고 사항
- 샘플에서 깨진 참조 확인
배치 품질 게이트
새 가져오기 배치마다 게이트를 실행하세요. 게이트 하나라도 통과하지 못하면 새 가져오기를 멈추고 카드 품질부터 수리하세요. 이렇게 하면 문제를 작게 유지하고 백로그 부채를 예방할 수 있습니다.
이해도
- 통과 기준
- 샘플 카드의 90% 이상 이해 가능
- 실패 신호
- 질문 형식이 모호하거나 노이즈가 있음
중복률
- 통과 기준
- 중복 앞면 질문 3% 미만
- 실패 신호
- 배치에 반복된 정의나 제목이 있음
세션 부담
- 통과 기준
- 세션 시간 증가 주간 15% 미만
- 실패 신호
- 가져온 카드가 너무 장황함
실패 추세
- 통과 기준
- 2주 차까지 안정적이거나 개선됨
- 실패 신호
- 핵심 주제에 대한 질문 품질이 낮음
확장 전 처리해야 할 Anki 특유의 엣지 케이스
대부분의 마이그레이션 회귀는 샘플에서는 작아 보이다가 규모가 커지면 비용이 커지는 엣지 케이스에서 발생합니다. 추가 덱을 가져오기 전에 클로즈 렌더링, 보류된 카드 상태, 지하카드(leech) 동작, 미디어 참조를 확인하세요.
클로즈 카드
- 흔한 실패
- 가져오기 후 클로즈 마커 누락
- 완화 방법
- 전체 마이그레이션 전에 샘플 클로즈 렌더링 검증
보류된 카드
- 흔한 실패
- 예상치 못한 활성 복습 부담
- 완화 방법
- 보류 상태를 내보내고 가져온 후 다시 적용
지하카드(leech)
- 흔한 실패
- 만성 실패 카드가 큐를 오염
- 완화 방법
- leech에 태그를 달고 재작성/보관 정책 실행
미디어 참조
- 흔한 실패
- 깨진 이미지나 오디오 포인터
- 완화 방법
- 처음 100장에서 깨진 미디어 스캔 실행
덱 옵션
- 흔한 실패
- 간격 동작 불일치
- 완화 방법
- 추가 덱 확장 전 14일 지표 관찰
반복 가능한 마이그레이션을 위한 CSV 가져오기 계약
반복 가져오기를 실행한다면 고정된 CSV 계약을 정의하고 버전을 관리하세요. 이렇게 하면 작업자 간 스키마 드리프트가 줄고 QA 자동화가 쉬워집니다. 실용적인 기준선은 식별, 질문, 답변, 맥락, 분류, 출처 필드를 포함하는 6열 계약입니다.
note_id
- 역할
- 안정적인 행 식별자
- 제약
- 실수로 인한 중복 수집 방지
front_text
- 역할
- 질문 필드
- 제약
- 구두점과 유니코드 변형 정규화
back_text
- 역할
- 답변 필드
- 제약
- 첫 문장에 직접적인 답변 유지
context_hint
- 역할
- 선택적 모호성 해소
- 제약
- 짧은 도메인 맥락만 사용
tags_pipe
- 역할
- 분류 그룹화
- 제약
- 파이프 구분 표준 태그 사용
source_ref
- 역할
- 추적 가능성
- 제약
- QA 역추적을 위해 챕터/페이지 저장
UTF-8 인코딩을 유지하고, 정규화된 줄바꿈을 적용하며, 내보내기 셀에 숨겨진 스프레드시트 수식을 넣지 마세요. 이런 작은 제약이 조용한 가져오기 오염을 막아 줍니다.
14일 안정화 프로토콜
- 11-3일: 활성 덱 하나를 이전하고 즉시 매일 복습을 재개하세요.
- 24-7일: 실패가 많은 상위 카드를 수리하고 앞면 질문을 중복 제거하세요.
- 38-10일: 태그/템플릿을 표준화하고 세션 시간 추세를 검증하세요.
- 411-14일: 완료율과 실패 지표가 건강한 상태로 유지될 때만 마이그레이션을 확장하세요.
시나리오 기반 마이그레이션 안내
시험 스프린트 (8-12주)
- 주요 목표
- 매일 완료율 안정 유지
- 권장 접근법
- 활성 덱만 가져오고 보관 이전은 일시 중지
장기 언어 학습
- 주요 목표
- 문장 맥락 보존
- 권장 접근법
- 엄격한 필드 정규화와 함께 CSV 경로
팀 마이그레이션
- 주요 목표
- 템플릿 일관성
- 권장 접근법
- 대량 가져오기 전에 하나의 표준 매핑 게시
보관 정리
- 주요 목표
- 수확률 낮은 덱 정리
- 권장 접근법
- 주제별로 이전하고 오래된 카드는 초기에 제거
FAQ
APKG와 CSV 중 무엇을 먼저 사용해야 하나요?
한 번에 몇 개의 덱을 이전해야 하나요?
마이그레이션 기간 동안 Anki와 Deckbase를 병행할 수 있나요?
카드가 올바르게 가져오기되지 않으면 어떻게 하나요?
마이그레이션이 잘 안 되면 롤백할 수 있나요?
마이그레이션 후 첫 주에 무엇을 해야 하나요?
마이그레이션하면 복습 기록이 사라지나요?
마이그레이션 후 첫 주: 성공 체크리스트
처음 7일이 마이그레이션의 성공을 결정합니다. 추가 덱으로 확장하기 전에 주 덱을 안정화하는 데 집중하세요.
- 11일: 가져온 카드로 첫 복습 세션을 완료하세요. 서식 문제를 메모하세요.
- 22-3일: 혼란스럽거나 질문이 불명확한 카드를 파악하고 수리하세요.
- 34-5일: 중복 검사를 실행하고 앞면이 동일한 카드를 병합하세요.
- 46-7일: 세션 시간을 평가하세요. 크게 늘었다면 카드 길이를 확인하세요.
- 57일까지: Anki를 계속 쓸지, Deckbase로 완전히 전환할지, 둘 다 유지할지 결정하세요.
팁: 첫 달 동안 Anki 설치와 원본 덱을 그대로 유지하세요. Deckbase가 필요에 맞지 않을 경우 롤백 옵션을 확보할 수 있습니다.
먼저 전체 개요가 필요하신가요? 마이그레이션 전략에 대한 발행된 글을 읽고, 실행을 위해 이 플레이북으로 돌아오세요. Anki 가져오기/내보내기 가이드부터 시작하세요.