문제 해결과 도움말
지원팀에 문의하기 전에 로그인, API, 가져오기, 미디어, 복습, 템플릿 문제를 진단하세요.
먼저 문제 페이지, 대략적인 시각, 브라우저, 운영체제, 문제를 재현하는 가장 짧은 순서를 기록하세요. 공개 신고에 액세스 토큰, 비공개 카드 내용, 전체 학습 파일을 넣지 마세요.
로그인할 수 없음
로그인 페이지를 한 번 새로고침하고 브라우저가 app.repeto.ai의 자사 쿠키를 허용하는지 확인합니다. OAuth 창이 차단됐다면 오래된 콜백 URL을 재사용하지 말고 보이는 로그인 버튼에서 공급자 흐름을 다시 시작하세요.
Repeto가 API에 연결할 수 없다고 알리면 앱 셸은 불러왔지만 api.repeto.ai가 응답하지 않은 것입니다. 연결을 확인하고 다시 시도하세요. 서비스 장애는 다른 계정을 만들어도 해결되지 않습니다.
로컬 개발 미리보기는 다릅니다. 웹 앱과 API가 모두 실행 중이어야 하며 미리보기가 로컬 API 원본을 가리켜야 합니다. Vite 프런트엔드만 실행 중이면 로컬 미리보기 열기가 작동할 수 없습니다.
복습이 저장되지 않은 것처럼 보임
오프라인 표시가 사라질 때까지 탭을 열어 두세요. 웹 복습 화면은 다음으로 이동하기 전에 평가를 로컬 IndexedDB 보낼 편지함에 기록하고 연결이 돌아오면 멱등하게 다시 시도합니다.
카드가 즉시 돌아온다면 동기화 실패가 아니라 학습 단계일 수 있습니다. 간격 미리보기와 덱의 학습 단계를 확인하세요. 여러 탭에서 같은 컬렉션을 복습한다면 오래된 탭을 닫고 가장 최신 탭을 새로고침합니다.
개수와 세션 합계가 다름
덱 목록에는 하위 트리의 모든 예정, 학습 중, 새 카드가 표시될 수 있습니다. 세션에는 이후 새 카드·복습 일일 한도, 대기열 조건, 일시 중지, 선택 범위가 적용됩니다. 상위 합계에는 이미 하위 덱이 포함되므로 보이는 부모와 자식 행을 더하면 같은 카드를 두 번 셉니다.
세션이 의심스러운 딱 떨어지는 수에서 멈춘다면 덱 설정 → 일일 최대 복습을 확인하세요. API 세션 상한은 200이 아니라 9,999입니다.
가져오기가 멈춤
가져오기로 돌아가세요. Repeto는 활성 가져오기 작업을 저장하며 처리 또는 미리보기 페이지를 다시 열어야 합니다. 첫 작업이 활성 상태일 때 중복 업로드를 시작하지 마세요.
작업이 반복해서 실패하면 다음을 수행합니다.
- 원본 앱에서 새
.apkg를 내보냅니다. - 그 앱에서 파일이 열리는지 확인합니다.
- 새 패키지로 다시 시도합니다.
- 실패한 파일 이름과 경고 문구를 지원 요청용으로 보관합니다.
가져온 카드의 모양이 잘못됨
가져올 때 Repeto 스타일 사용을 선택하거나 화면 표시에서 가져온 템플릿 색상 유지를 바꿔 보세요. 노트 유형 미리보기를 열어 앞면·뒷면 템플릿에 지원되지 않는 필터, 고정 크기, 스크립트, Anki Desktop을 가정한 선택자가 있는지 확인합니다.
큰 이미지는 복습 카드 안에서 반응형으로 맞춰져야 합니다. 작게 남는다면 템플릿 자체가 작은 너비를 지정했는지 확인하세요. 고정 크기 HTML 미디어 요소가 앱의 기본 이미지 규칙을 덮어쓸 수 있습니다.
이미지나 오디오 파일이 없음
가져오기 미리보기에 미디어가 보고됐는지 확인합니다. 패키지가 미디어 매니페스트에 없는 파일 이름을 참조할 수 있습니다. 내부 압축 파일 이름을 수동으로 바꾸기보다 원본에서 미디어를 포함해 다시 내보내는 편이 안전합니다.
새 미디어를 첨부했다면 업로드가 끝날 때까지 편집기를 닫지 마세요. 브라우저 오프라인 캐시는 완료된 서버 업로드를 대신하지 않습니다.
컬렉션 미디어 무결성 API는 아무것도 삭제하지 않고 누락, 미사용, 잘못된 형식, 모호한 참조를 나열할 수 있습니다. 복구 UI가 나오기 전에는 “미사용” 객체를 직접 지우지 마세요. 가져온 템플릿과 기존 파일 이름을 먼저 살펴봐야 할 수 있습니다.
검색이나 필터가 카드를 찾지 못함
카드 브라우저를 열고 쿼리를 지운 뒤 알려진 필드의 텍스트를 검색하세요. 형제 카드 수가 헷갈리면 카드와 노트 모드를 바꿉니다. 컬렉션 브라우저는 서버에서 필터링하고 정렬하므로 더 불러오기 전에는 불러온 수가 보고된 전체보다 작을 수 있습니다.
구조화 쿼리가 잘못됐다면 연산자를 무작정 지우지 말고 강조된 진단을 읽으세요. Repeto는 의도적으로 제한한 Anki 스타일 문법을 지원하고 단어 경계, 악센트 무시, 렌더링된 Cloze, 정규식, 프리셋, 처음 제시된 카드, 사용자 데이터 연산자는 거부합니다. 덱의 상태·태그·이미지 필터는 별도의 더 좁은 보기이며 불러온 덱 페이지만 세부 조정할 수 있습니다.
지원팀에 문의하기
계정, 개인정보, 결제, 제품 문제는 Repeto 지원을 이용하세요. 다음을 포함합니다.
- 영향받은 페이지와 덱 이름(비공개 카드 내용은 제외);
- 브라우저·앱 버전과 운영체제;
- 온라인과 오프라인에서 모두 재현되는지 여부;
- 정확한 경고 또는 오류 문구;
- 화면 동작이 중요하다면 짧은 화면 녹화.
수동 API 토큰, OAuth 코드, 비밀번호, 전체 비공개 컬렉션을 이메일로 보내지 마세요. 필요한 경우 지원팀이 범위가 좁은 진단을 요청할 수 있습니다.