일반적인 문제
예상대로 작동하지 않으면 먼저 다음 사항을 확인하세요.
앱이 번역, 재작성 또는 변환을 하지 않음
섹션 제목: “앱이 번역, 재작성 또는 변환을 하지 않음”다음 사항을 확인하세요:
- 도구 모음에서 프리셋(Easy) 또는 모델(Advanced)을 선택했는지 확인
- Easy 모드에서 설정 → 일반 설정에 작동하는 키(또는 로컬 LLM URL)가 있는 공급자가 있는지 확인
- Advanced 모드에서 도구 모음에 모델이 선택되어 있는지 확인(빈 목록은 허용되지만, 실행하려면 설정 → 모델에 모델이 하나 이상 필요)
- API 설정이 작동하는지 확인(데스크톱: 설정 → API 설정 → 테스트)
모델 목록이 비어 있음
섹션 제목: “모델 목록이 비어 있음”Easy 모드에서는 공급자가 설정되어 있고 키/URL이 테스트되었는지 확인하세요. Local LLM의 경우 로컬 서버가 실행 중이고 모델이 로드되어 있는지 확인하세요.
Advanced 모드에서는 선택한 모델이 비어 있을 수 있습니다. 설정 → 모델을 열고 새로 고침을 클릭한 다음 선택한 모델에 모델을 추가하세요. 선택적으로 무료만을 켜세요. 마지막 도구 모음 모델을 제거해도 설정 → 모델이 열립니다.
너무 느리거나 비용이 많이 듦
섹션 제목: “너무 느리거나 비용이 많이 듦”- 다른 프리셋 또는 모델 선택
- 입력 길이 줄이기
- 일반 설정에서 입력 중 실시간 번역 끄기
- 간단한 작업에는 무료 모델 사용
인터페이스 언어가 잘못됨
섹션 제목: “인터페이스 언어가 잘못됨”도구 모음의 지구본 아이콘을 클릭하고 인터페이스 언어를 선택하세요.
텍스트가 너무 작거나 읽기 어려움
섹션 제목: “텍스트가 너무 작거나 읽기 어려움”설정 → 일반 설정 → 글꼴 및 크기 변경.
대시보드 요약이 비어 보임
섹션 제목: “대시보드 요약이 비어 보임”다음 경우에 정상입니다:
- 무료 모델만 사용하고 비용 수치를 확인하는 경우(0일 수 있음); 호출 수 KPI는 선택한 기간에 대한 데이터가 필요합니다
- 선택한 시간 필터가 호출이 수행된 시간을 포함하지 않는 경우 — 전체 시도
KPI가 전체 후에도 계속 0이면 기록 또는 대시보드 → 모든 호출을 확인하세요.
비용이 “사용 불가”로 표시되거나 잘못된 것 같음
섹션 제목: “비용이 “사용 불가”로 표시되거나 잘못된 것 같음”해당하는 경우 OpenRouter는 실제 지출 금액을 표시합니다. 다른 제공자의 경우 비용은 OpenRouter 가격 책정을 기준으로 추정됩니다. 일치하는 가격이 없으면 비용은 사용 불가로 표시되며 합계에 포함되지 않습니다.
총 비용이 제공자 청구서와 일치하지 않습니다
섹션 제목: “총 비용이 제공자 청구서와 일치하지 않습니다”앱의 수치는 청구서가 아닌 참고용 추정치입니다. OpenRouter의 경우 설정 → 비용 추적 → API 키 사용량과 동기화를 사용하세요.
사이드바에 기록 페이지가 없습니다
섹션 제목: “사이드바에 기록 페이지가 없습니다”실행 기록 유지가 꺼져 있을 수 있습니다. 관리자가 기록을 비활성화하지 않은 경우 일반 설정에서 이를 활성화하세요 (HISTORY_DISABLED — 구성 참조).
웹: 예기치 않게 로그인으로 리디렉션됨
섹션 제목: “웹: 예기치 않게 로그인으로 리디렉션됨”세션 시간이 초과되었을 수 있습니다. 다시 로그인하세요. 자주 발생하는 경우 관리자에게 설정 → 사용자에서 세션 시간 제한을 늘려달라고 요청하세요 (관리자가 세션을 취소했을 수도 있습니다).
웹 관리자: 비밀번호 분실
섹션 제목: “웹 관리자: 비밀번호 분실”다른 관리자가 로그인할 수 있는 경우, 설정 → 사용자에서 비밀번호를 재설정할 수 있습니다. 계정이 잠겨 있지만 셸 액세스 권한이 있는 경우:
docker exec transrewrt reset-web-password '<username>' '<new-password>'기본 관리자 사용자 이름은 admin입니다. 소스 체크아웃에서: pnpm run reset-web-password -- <username> <new-password>.
대시보드에 다른 사용자의 데이터가 표시되지 않음 (웹)
섹션 제목: “대시보드에 다른 사용자의 데이터가 표시되지 않음 (웹)”관리자만 사용자 필터를 통해 다른 사용자를 볼 수 있습니다. 일반 사용자는 자신의 활동만 볼 수 있습니다.
프롬프트를 변경했을 때 편집 내용을 잃어버림
섹션 제목: “프롬프트를 변경했을 때 편집 내용을 잃어버림”Transform 프롬프트를 편집할 때 실행으로 돌아가기 전에 저장을 클릭하세요.