가져오기와 내보내기
Anki 패키지와 구조화된 텍스트를 옮기고 호환성을 점검하며 올바른 컬렉션 백업 형식을 선택하세요.
Repeto는 Anki .apkg 덱 패키지를 가져오고 내보낼 수 있습니다. 이전 작업은 검토 가능한 작업으로 취급하세요. 가져온 컬렉션에 의존하기 전에 패키지 요약, 경고, 템플릿, 미디어를 확인합니다.
Anki 패키지 가져오기
가져오기를 열고 .apkg 파일을 놓거나 선택합니다. Repeto는 재개 가능한 백그라운드 작업으로 업로드하고 컬렉션에 쓰기 전에 미리보기를 준비합니다.
미리보기에는 덱과 노트·카드 수, 패키지의 노트 모델, 미디어 수, 일정 데이터 포함 여부, 패키지별 경고가 표시됩니다.
선택적으로 패키지 최상위 덱 이름을 바꿀 수 있습니다. 여러 덱이 든 패키지는 이를 감싸는 대상 이름을 지정하지 않는 한 기존 계층을 유지합니다.
보존할 내용 선택하기
일정 데이터가 있으면 일정과 복습 이력 유지가 기본으로 켜집니다. 자료만 가져오고 학습 상태를 새로 시작하려는 경우 끄세요.
Repeto 스타일 사용도 기본으로 켜집니다. 가져온 내용과 템플릿 구조는 유지하면서 Repeto 테마 셸이 카드 색상을 제어합니다. 패키지의 원래 시각 디자인이 중요하면 끄고 밝은 모드와 어두운 모드를 모두 확인하세요.
미디어는 패키지 매니페스트로 일치시키고 지속 가능한 컬렉션 미디어로 저장합니다. 카드가 이미 존재하더라도 이후 가져오기로 누락된 미디어를 복원할 수 있습니다.
오래 걸리는 가져오기
큰 패키지는 작업으로 계속 처리됩니다. 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, 행별 덱/유형 지시문, 열 머리글 행은 가져오지 않습니다. 첫 비지시문 행이 데이터입니다. 구조화 텍스트 내보내기도 아직 없습니다.
전체 Repeto 컬렉션 백업하기
Repeto 네이티브 아카이브가 정확한 복구 형식입니다. GET /v1/collection/backup은 실제 컬렉션 그래프, 덱 트리와 설정, 노트 유형·템플릿·CSS, 노트, 카드, 일정 상태, 복습 이력, 미디어 바이트와 체크섬, 필터 덱 정의와 멤버십 스냅샷을 담은 버전 지정 ZIP64 아카이브를 만듭니다. POST /v1/collection/restore는 비어 있거나 명시적으로 교체할 컬렉션을 확정하기 전에 소유권, 경로, 체크섬, 관계, 동기화 시계를 검증합니다.
이 API는 아직 시간 지정 자동 백업 브라우저나 완성된 계정 복구 UI가 아닙니다. 파괴적인 구조 변경 전에 아카이브를 Repeto 외부에 보관하세요.
Anki 컬렉션 패키지 내보내기 또는 검사하기
GET /v1/collection/export.colpkg는 실제 Anki 표현 가능 컬렉션과 검증된 미디어를 담은 진짜 레거시 스키마 11 .colpkg를 만듭니다. 상호운용용 내보내기이며 Repeto의 정확한 백업은 아닙니다. Repeto 전용 동기화 ID, 생성 메타데이터, 일부 확장 스케줄러 상태, 실행 취소 스냅샷, 활성 필터 덱 실행 상태는 레거시 형식에 손실 없이 표현할 수 없습니다.
POST /v1/collection/import.colpkg/preview는 레거시, anki21, anki21b 패키지를 안전하게 검사하고 체크섬과 호환 범위를 보고합니다. 현재 컬렉션을 교체하지는 않습니다. 프리셋과 복습 이력을 정직하게 보호된 복구에 충분할 만큼 정확히 유지할 수 있기 전까지 파괴적인 .colpkg 가져오기는 비활성화되어 있습니다.
미디어 무결성 확인하기
컬렉션 API는 실제 노트 필드와 카드 템플릿에서 이미지, 오디오, source, [sound:…] 참조를 검사할 수 있습니다. 원격 URL을 가져오거나 아무것도 삭제하지 않으며 누락, 미사용, 잘못된 형식, 모호한 레거시 파일 이름 참조를 보고합니다. 안내형 복구·휴지통 UI는 아직 계획되어 있습니다.
기타 내보내기
통계 페이지는 표시된 통계를 CSV로 내보낼 수 있습니다. API는 점검과 엔지니어링 작업용으로 결정론적 체크섬 JSON 컬렉션 매니페스트도 제공합니다. 그 매니페스트에는 미디어 바이트가 없고 복구 형식도 아니므로 정확한 복구에는 네이티브 아카이브를 사용하세요.
마켓플레이스 게시는 백업 내보내기와 다릅니다. 게시된 덱은 공유 가능한 콘텐츠 패키지이지 전체 비공개 복습 이력의 사본이 아닙니다.
안전한 이전 체크리스트
- 이전이 검증될 때까지 원본 패키지를 보관합니다.
- 연속성이 중요하면 일정을 유지해 가져옵니다.
- 각 노트 유형의 대표 카드를 엽니다.
- 이미지와 오디오를 확인합니다.
- 예정 카드 수와 일부 간격을 비교합니다.
- 원본 컬렉션을 삭제하거나 교체하기 전에 Repeto 네이티브 백업을 만듭니다.
- 가져온 덱을 Repeto에서 내보내 그 패키지를 따로 테스트합니다.
남은 자동 백업, 충돌 복구, 최신 .colpkg, 사용자 인터페이스 작업은 기능 동등성 로드맵에 있습니다.