막혔을 때는 상태부터 확인하세요
대부분의 문제는 ① 엔진 상태(로고 옆 점), ② 인덱싱 진행률, ③ OCR 모델 상태, ④ LLM 연결을 확인하면 원인이 나옵니다. 아래 표에서 증상을 찾아 순서대로 점검해 보세요.
점검표
증상 → 확인 → 해결
| 증상 | 확인할 것 | 해결 |
|---|---|---|
| 검색 결과가 거의 없음 | 설정 → 감시폴더에 폴더가 등록되어 있는지, 스캔·인덱싱 진행률이 남아 있는지 확인. | 문서가 있는 폴더를 추가하고, 필요하면 설정 → 엔진에서 파일 스캔을 실행하세요. |
| 정밀 검색만 결과 없음 | 준비 창 → 이력 보기에서 해당 문서가 성공·대기열·실패·제외 중 무엇인지 확인. 제외라면 설정 → 분석의 파일 유형·최대 크기, 실패라면 표시된 실패 사유를 확인. | 문서 유형을 켜거나 최대 파일 크기를 올린 뒤 재스캔하세요. 실패 항목은 원인(암호 해제 등)을 고친 뒤 실패 항목 다시 처리를 누르고, 대기열이라면 잠시 뒤 다시 검색하세요. |
| Luna 탭이 비활성화됨 | 설정 → LLM에서 GPT 사용 여부 스위치와 제공자·키·모델 설정을 확인. | 제공자를 설정하고 연결 테스트를 실행하세요. 테스트가 실패하면 키·URL·네트워크(프록시/방화벽)를 확인합니다. |
| 새 파일이 검색에 안 나옴 | 파일이 감시 폴더 안에 있는지, 네트워크 폴더처럼 변경 감시가 제한되는 위치인지 확인. | 설정 → 엔진에서 파일 스캔을 수동 실행하세요. 네트워크 루트가 너무 넓다면 하위 폴더로 나눠 등록하세요. |
| PDF 내용이 검색 안 됨 | 스캔 이미지 PDF인지 확인한 뒤 설정 → 엔진에서 OCR 사용 여부, 인식 언어, 모델 로드 상태, 인덱싱 진행률을 확인. | OCR을 켜고 문서 언어를 선택한 뒤 저장하세요. 모델을 추가했다면 새로고침 → 언어 선택 → 저장 후 파일 스캔을 다시 실행합니다. |
| 추가한 OCR 언어가 안 보임 | ocr-models\<lang> 폴더 이름이 소문자인지, inference.onnx와 inference.yml이 모두 있는지 확인. |
파일명과 위치를 고친 뒤 OCR 모델을 새로고침하세요. 목록에 나타나면 해당 언어를 체크하고 저장해야 실제로 사용됩니다. |
| 인덱싱이 너무 느림 | 성능 프리셋이 최저사용으로 되어 있지 않은지, 감시 폴더에 불필요한 대용량 폴더가 없는지 확인. | Boost를 켜거나(번개 버튼) 성능 프리셋을 올리고, 유휴 부스트로 밤 시간대에 처리되게 하세요. |
| 검색창이 안 열림 | 트레이에 Findex 아이콘이 있는지, 단축키가 다른 프로그램과 겹치지 않는지 확인. | 트레이 아이콘을 클릭해 열고, 겹친다면 설정 → 기본에서 단축키를 바꾸세요. 아이콘이 없으면 Findex를 다시 실행하세요. |
| 엔진 오류가 반복됨 | 설정 → 엔진의 상태 메시지와 엔진 경로 테스트 결과 확인. 보안 프로그램이 Findex의 로컬 통신을 막고 있지 않은지도 확인. | 엔진 재시작 → 검색 데이터 초기화 순으로 시도하고, 계속되면 아래 로그와 함께 문의해 주세요. (엔진 포트는 1.2부터 자동으로 관리되어 직접 바꿀 필요가 없습니다.) |
| 업데이트 알림이 안 옴 / 실패 | 설정 → 정보 → 업데이트에서 자동으로 업데이트 확인이 켜져 있는지, “서버에 연결할 수 없어 껐습니다” 표시가 있는지 확인. 폐쇄망이면 자동으로 꺼집니다. | 지금 확인을 눌러 보세요. “전체 설치 파일로 설치해야 합니다”라고 나오면 다운로드 페이지에서 받아 덮어 설치합니다. 적용 실패 시 Findex는 이전 버전으로 자동 복구합니다. |
| 온라인 설치가 멈춤 | 첫 실행의 Findex 구성 요소 설치 화면에서 진행률이 오래 멈춰 있는지, 네트워크·프록시 오류 문구가 있는지 확인. | 취소 후 다시 시도하거나 오프라인 설치 파일 받기로 전체 설치본을 사용하세요. 설치 닫기로 종료해도 받은 부분은 남고 다음 실행 때 이어서 설치합니다. |
| 데스크톱 펫이 안 보임 | 앱 → 데스크톱 펫에서 펫 사용이 켜져 있는지, 길게 누르기 메뉴로 “N분 숨기기”를 했는지, 전체 화면 앱이나 발표 중이 아닌지 확인. | 펫은 전체 화면 중 자동으로 숨었다가 돌아옵니다. 다른 모니터로 넘어갔다면 “여러 모니터 넘나들기”를 끄거나 펫 사용을 껐다 켜서 기본 위치로 되돌리세요. |
이미지 PDF
OCR이 안 될 때 확인할 순서
- PDF가 실제 이미지 문서인지 확인페이지에서 글자를 드래그해 선택할 수 없다면 OCR 대상일 가능성이 큽니다.
- OCR과 인식 언어를 켜고 저장설정 → 엔진에서 문서 언어를 선택합니다. 한국어는 ko, 중국어·일본어는 default 공식 PP-OCRv5 인식 모델을 사용합니다.
- 실행 방식과 대기열 확인유휴 전용이면 PC를 사용 중일 때 기다립니다. 바로 처리하려면 균형 모드로 바꾸고, 큰 스캔 문서는 처리 시간이 걸릴 수 있으니 인덱싱 진행률을 확인하세요.
- 파일 스캔 다시 실행설정을 저장한 다음 엔진 탭의 파일 스캔으로 문서를 다시 감지시킵니다.
사용자 모델 폴더: %LOCALAPPDATA%\Findex\ocr-models\<lang>\ 안에 inference.onnx와 inference.yml 두 파일이 모두 있어야 합니다. 공용 det.onnx는 ocr-models 바로 아래에 둡니다. 전체 구조와 언어 범위는 설정의 OCR 안내를 참고하세요.
FAQ
자주 묻는 질문
Q. 문서가 외부 서버로 전송되나요?
아니요. 인덱싱·검색·OCR은 내 PC 안에서 처리됩니다. 단, 클라우드 LLM을 연결해 Luna를 사용하면 질문·대화, 필요한 문서 내용, 파일명·메타데이터, 도구 결과 등이 해당 제공자에게 전송될 수 있습니다. MCP 도구를 실행할 때는 선택한 파일과 도구 입출력도 전송될 수 있습니다. 이를 원치 않으면 Ollama·LM Studio 같은 로컬 모델을 쓰거나 LLM을 끄세요.
Q. LLM 없이 쓸 수 있나요?
네. 빠른 검색과 정밀 검색은 LLM 없이 완전히 동작합니다. LLM은 Luna의 답변과 Luna가 실행하는 문서·외부 도구 작업에 필요합니다.
Q. 인덱스는 어느 정도 용량을 쓰나요?
문서량에 따라 다르지만 보통 수백 MB에서 수 GB 수준입니다. 저장 공간이 부담되면 설정 → 분석에서 분석할 파일 유형을 줄이거나 최대 파일 크기를 낮추세요.
Q. 프로그램을 껐다 켜면 인덱싱을 처음부터 다시 하나요?
아니요. 진행 상황이 저장되어 다음 실행 때 이어서 진행됩니다.
Q. 기본 OCR 모델은 어떤 언어를 읽나요?
default 모델은 간체·번체 중국어, 영어, 일본어를 인식하고, ko 모델은 한국어, 영어, 숫자를 인식합니다. 필요한 언어만 선택하면 그에 맞는 최소 모델만 로드합니다.
Q. 완전히 처음 상태로 되돌리고 싶어요.
설정 → 엔진 → 모두 초기화를 실행하면 모든 데이터가 삭제되고 초기 설정 화면부터 다시 시작합니다. 되돌릴 수 없으니 주의하세요.
지원
로그 확인과 문의하기
해결되지 않는 문제는 로그와 함께 문의해 주시면 가장 빠르게 도와드릴 수 있습니다. 로그는 다음 위치에 있습니다.
-
탐색기 주소창에 입력:
%LOCALAPPDATA%\Findex\logsWindows 탐색기를 열고 주소창에 붙여넣은 뒤 Enter를 누르면 로그 폴더가 열립니다. - 최근 로그 파일 확보앱(Tauri) 로그와 엔진(Engine) 로그 중 문제가 발생한 시각과 가까운 파일을 준비하세요.
- sami_info@samitech.kr로 문의증상, 발생 시각, 로그 파일을 함께 보내주세요. 사용 중인 Windows 버전과 Findex 버전을 적어주시면 더 좋습니다.