문제 해결

Lertaro 사용 중 문제가 발생했나요? 아래 단계에 따라 일반적인 원인을 확인하고 해결하세요.

1. 전역 단축키가 작동하지 않음

백그라운드 서비스 실행 여부 확인: 설정 → 서비스 상태로 이동하여 Lertaro.Service가 실행 중인지 확인하세요. 일반 단축키는 App이 처리하지만 관리자 권한 후킹 프로세스는 서비스에 의존합니다.
관리자 권한 격리 (UIPI): 현재 활성 창이 관리자 권한으로 실행된 경우(예: 관리자 터미널, 작업 관리자) Windows UIPI 보안 정책으로 인해 일반 프로세스의 단축키 입력이 차단됩니다. Lertaro는 서비스를 통해 후킹을 자동 승격하므로 서비스가 정상 동작 중인지 확인하세요.
프로세스 블랙리스트 확인: 설정 → 단축키에서 현재 프로그램이 블랙리스트에 등록되어 있지 않은지 확인하세요. 블랙리스트에 포함된 앱이 활성화되어 있으면 Lertaro는 단축키를 가로채지 않습니다.
전체화면 게임/앱 자동 무시: 전체화면 3D 게임이나 비디오 재생기가 실행 중일 때는 단축키가 기본적으로 무시됩니다. 전체화면에서도 검색창을 띄우려면 설정 → 단축키에서 전체화면 앱 포커스 시에도 응답을 켜세요.

로컬 NTFS / ReFS 드라이브: USN 변경 저널을 읽어 거의 지연 없는 밀리초 단위로 실시간 갱신됩니다.
FAT32 / exFAT 드라이브: 파일 시스템 변경 이벤트를 통해 지속적으로 감지합니다.
수동 인덱스 재구축: 예기치 않은 전원 차단 등으로 인덱스 불일치가 발생한 경우, 설정 → 인덱싱 → 로컬 드라이브에서 해당 드라이브의 인덱스 재구축을 클릭하세요.

정기 스캔 메커니즘: 네트워크 공유(SMB / NAS)는 로컬 USN 저널이 없으므로 정기적인 폴링 스캔에 의존합니다.
새로고침 모드 확인: 설정 → 인덱싱 → 네트워크 드라이브에서 해당 드라이브의 새로고침 모드가 "수동"으로 되어 있지 않은지 확인하세요.
심볼릭 링크 순환 보호: NAS 상의 재귀적 심볼릭 링크로 인한 무한 루프를 방지하기 위해 순환 감지 엔진이 자동으로 중복 경로를 건너뜁니다.

제외 규칙 확인: 설정 → 인덱싱 → 제외 규칙에서 해당 파일 경로가 정확한 경로, 와일드카드, 정규식에 의해 실수로 제외되지 않았는지 확인하세요.
드라이브 활성화 상태 확인: 설정 → 인덱싱 → 로컬 드라이브에서 해당 드라이브가 활성화되어 있는지 확인하세요.

포커스 비점유 설계: 인라인 윈도우는 닫힌 후 원래 프로그램으로 포커스를 깜빡임 없이 돌려주기 위해 포커스를 가로채지 않는 구조입니다. 한글 IME 후보 창은 Windows 정식 포커스를 요구하므로 인라인 모드에서는 나타나지 않을 수 있습니다.
권장 해결 방법:
1. 퀵 윈도우 사용: Ctrl 더블 클릭으로 열리는 퀵 윈도우는 정식 포커스를 가지므로 모든 IME가 정상 작동합니다.

문제가 지속되면 설정 → 서비스 상태에서 실시간 로그를 확인하세요.

검색창으로 키워드를 필터링하거나 심각도(Info / Warn / Error)로 정렬하여 에러를 확인하고 GitHub Issue 등록 시 첨부해 주세요.