가져오기와 내보내기
Anki 패키지와 구조화된 텍스트를 옮기고 호환성을 점검하며 올바른 컬렉션 백업 형식을 선택하세요.
Repeto는 Anki .apkg 덱 패키지를 가져오고 내보낼 수 있습니다. 이전 작업은 검토 가능한 작업으로 취급하세요. 가져온 컬렉션에 의존하기 전에 패키지 요약, 경고, 템플릿, 미디어를 확인합니다.
Anki 패키지 가져오기
가져오기를 열고 .apkg 파일을 놓거나 선택합니다. Repeto는 재개 가능한 백그라운드 작업으로 업로드하고 컬렉션에 쓰기 전에 미리보기를 준비합니다.
미리보기에는 덱과 노트·카드 수, 패키지의 노트 모델, 미디어 수, 일정 데이터 포함 여부, 패키지별 경고가 표시됩니다.
선택적으로 패키지 최상위 덱 이름을 바꿀 수 있습니다. 여러 덱이 든 패키지는 이를 감싸는 대상 이름을 지정하지 않는 한 기존 계층을 유지합니다.
보존할 내용 선택하기
일정 데이터가 있으면 일정과 복습 이력 유지가 기본으로 켜집니다. 자료만 가져오고 학습 상태를 새로 시작하려는 경우 끄세요.
Repeto 스타일 사용도 기본으로 켜집니다. 가져온 내용과 템플릿 구조는 유지하면서 Repeto 테마 셸이 카드 색상을 제어합니다. 패키지의 원래 시각 디자인이 중요하면 끄고 밝은 모드와 어두운 모드를 모두 확인하세요.
미디어는 패키지 매니페스트로 일치시키고 지속 가능한 컬렉션 미디어로 저장합니다. 카드가 이미 존재하더라도 이후 가져오기로 누락된 미디어를 복원할 수 있습니다.
업데이트된 .apkg 다시 가져오기
패키지 노트가 GUID와 노트 유형으로 기존 노트와 일치하면 기존 노트 업데이트, 기존 노트 무시, 모두 새 항목으로 추가 중 하나의 정책을 명시적으로 선택하세요. Repeto는 서로 호환되지 않는 두 노트 유형을 같다고 추측하지 않고 식별자 충돌을 차단합니다.
호환되는 업데이트는 기존 노트, 카드, 필드, 템플릿의 식별자와 함께 카드 위치, 일정, FSRS 상태, 플래그, 복습 이력을 보존합니다. 자리 잡은 카드를 초기화하지 않고 가져온 내용을 갱신하며 실제로 새로운 형제 카드를 추가할 수 있습니다. 모두 새 항목으로 추가는 독립된 식별자와 새 일정을 만듭니다.
오래 걸리는 가져오기
큰 패키지는 작업으로 계속 처리됩니다. Repeto는 현재 가져오기 ID를 로컬에 저장하고 이동하거나 새로고침한 뒤 미리보기 또는 결과를 복원합니다. 작업이 처리 중일 때 같은 파일을 반복 업로드하지 말고 기존 작업 페이지를 먼저 여세요.
브라우저가 패키지 오류를 표시하면 원본 앱에서 덱을 다시 내보내 새 파일로 시도합니다. 손상된 SQLite 데이터, 지원하지 않는 압축, 누락된 미디어 항목은 부분적으로 신뢰할 수 있는 카드를 만드는 대신 경고나 가져오기 실패로 나타나야 합니다.
덱 내보내기
덱을 열고 .apkg 내보내기를 선택합니다. Repeto가 중첩 이름, 노트, 카드, 노트 유형, 템플릿, 미디어, 지원되는 일정 데이터를 포함해 덱을 다운로드합니다.
구조 변경 전 독립 스냅샷 보관, 다른 호환 앱으로 이전, 비공개 공유, 가져오기·내보내기 왕복 테스트에 사용하세요.
모든 Anki Desktop 기능에 Repeto 대응 기능이 있는 것은 아닙니다. 필터 덱 실행 상태, 묻힌 상태, 애드온, 사용자 지정 템플릿 스크립트, 지원하지 않는 스케줄러 메타데이터는 정확히 왕복되지 않을 수 있습니다. 원본을 삭제하기 전에 대상 앱에서 내보낸 패키지를 검토하세요.
구조화된 텍스트 가져오기
가져오기에서 CSV 또는 TSV를 선택하고 UTF-8 .csv, .tsv, .txt를 선택하거나 놓으세요. 웹 화면은 최대 5 MiB와 데이터 10,000행을 받습니다. 미리보기는 흔한 구분 기호, BOM, 따옴표 안 여러 줄, 이스케이프된 따옴표, 행 너비 문제를 감지합니다.
미리보기 전에 노트 유형과 덱, 선택 태그, 구분 기호, HTML 처리, 중복 정책, 중복 검색 범위를 고르세요. 첫 데이터 행 앞의 #separator, #html, #notetype, #deck, #tags를 이해하며, 화면에서 명시한 값이 파일 지시문보다 우선합니다.
그 다음 각 열을 노트 필드, 공백 구분 태그, 또는 열 무시로 매핑합니다. 첫 노트 필드는 중복을 식별하므로 필수입니다. Repeto는 생성·갱신·건너뛰기·잘못된 행마다 진단과 행 계획을 보여 줍니다. 일치 노트 갱신, 가져온 행 건너뛰기, 다른 노트 추가 중 하나를 명시적으로 선택합니다.
파일·매핑·설정을 바꾸면 계획이 만료됩니다. 정확한 행 계획을 검토했다고 확인해야 확정할 수 있습니다. 사용자에 연결된 토큰의 파일과 선택만 다시 구성해 원자적으로 적용합니다. 갱신 때 카드 ID, 일정, 만기, 간격, 스케줄러 상태, 복습 기록을 보존하며 동일 재시도는 멱등입니다. 브라우저는 복구용으로 파일, 옵션, 미리보기를 로컬에 저장합니다. 복구 불가 경고가 나오면 페이지를 열어 두세요.
현재 참조 미디어, GUID, #columns, 행별 덱/유형 지시문, 열 머리글 행은 가져오지 않습니다. 첫 비지시문 행이 데이터입니다. 구조화 텍스트 내보내기도 아직 없습니다.
Anki 컬렉션 패키지 내보내기 또는 검사하기
.colpkg 파일을 확인하려면 가져오기 → Anki 컬렉션 가져오기를 여세요. 미리보기는 데이터를 변경하지 않습니다. 호환되는 패키지는 확인 후 컬렉션을 교체할 수 있습니다. 교체는 원자적으로 처리되며 자동 복구 지점은 생성되지 않습니다.
Marketplace 덱을 안전하게 업데이트하기
Marketplace 버전은 변경할 수 없으며 패키지와 미디어 해시를 검증합니다. 안전한 업데이트는 일치하는 카드와 그 일정·이력을 보존하고, 새 콘텐츠를 추가하며, 추적되다가 삭제된 콘텐츠를 폐기합니다. 겹치지 않는 로컬 수정은 자동으로 병합됩니다. 사용자와 게시자가 같은 추적 콘텐츠를 모두 수정했다면 Repeto가 멈추고 명시적인 선택지를 제공합니다. 충돌하는 Marketplace 콘텐츠를 덮어쓰거나, 편집한 사본을 포크로 유지하면서 현재 게시자 스냅샷을 별도로 설치할 수 있습니다.
게시 중단은 신규 획득과 업데이트를 막지만 설치된 로컬 사본을 조용히 삭제하지 않습니다. 현재 웹 충돌 대화상자는 항목별 차이가 아니라 충돌 개수를 요약하며, 비교 기준이 없는 오래된 설치에서는 포크 방식만 지원할 수 있습니다.
기타 내보내기
통계 페이지는 표시된 통계를 CSV로 내보낼 수 있습니다. API는 점검과 엔지니어링 작업용으로 결정론적 체크섬 JSON 컬렉션 매니페스트도 제공합니다. 그 매니페스트에는 미디어 바이트가 없고 복구 형식도 아니므로 정확한 복구에는 네이티브 아카이브를 사용하세요.
마켓플레이스 게시는 백업 내보내기와 다릅니다. 게시된 덱은 공유 가능한 콘텐츠 패키지이지 전체 비공개 복습 이력의 사본이 아닙니다.
안전한 이전 체크리스트
- 이전이 검증될 때까지 원본 패키지를 보관합니다.
- 연속성이 중요하면 일정을 유지해 가져옵니다.
- 각 노트 유형의 대표 카드를 엽니다.
- 이미지와 오디오를 확인합니다.
- 예정 카드 수와 일부 간격을 비교합니다.
- 원본 컬렉션을 삭제하거나 교체하기 전에 Repeto 네이티브 백업을 만듭니다.
- 가져온 덱을 Repeto에서 내보내 그 패키지를 따로 테스트합니다.
남은 자동 백업, 충돌 복구, 최신 .colpkg, 사용자 인터페이스 작업은 기능 동등성 로드맵에 있습니다.