챕터 6 · 문제 해결Chapter 6 · Troubleshooting

막혔을 때는 상태부터 확인하세요When something is off, check the status first

대부분의 문제는 ① 엔진 상태(로고 옆 점), ② 인덱싱 진행률, ③ LLM 연결 세 가지만 확인하면 원인이 나옵니다. 아래 표에서 증상을 찾아 순서대로 점검해 보세요. Most issues come down to three things: ① engine status (the dot next to the logo), ② indexing progress, ③ the LLM connection. Find your symptom below and follow the checks in order.

점검표Checklist

증상 → 확인 → 해결Symptom → check → fix

증상Symptom 확인할 것What to check 해결Fix
검색 결과가 거의 없음Very few results 설정 → 감시폴더에 폴더가 등록되어 있는지, 스캔·인덱싱 진행률이 남아 있는지 확인.Are folders registered in Settings → Folders? Is a scan or indexing still in progress? 문서가 있는 폴더를 추가하고, 필요하면 설정 → 엔진에서 파일 스캔을 실행하세요.Add the folders that hold your documents; run a file scan from Settings → Engine if needed.
정밀 검색만 결과 없음Precise search empty 해당 형식이 설정 → 분석의 파일 유형에 켜져 있는지, 파일이 최대 크기 제한을 넘지 않는지, 문서 인덱싱이 끝났는지 확인.Is the file type enabled in Settings → Analysis? Is the file under the size limit? Has document indexing finished? 문서 유형을 켜거나 최대 파일 크기를 올린 뒤 재스캔하세요. 인덱싱 중이라면 잠시 뒤 다시 검색하세요.Enable the type or raise the size limit, then rescan. If indexing is still running, retry shortly.
Luna 탭이 비활성화됨Luna is disabled 설정 → LLM에서 GPT 사용 여부 스위치와 제공자·키·모델 설정을 확인.In Settings → LLM, check the on/off switch and the provider, key, and model. 제공자를 설정하고 연결 테스트를 실행하세요. 테스트가 실패하면 키·URL·네트워크(프록시/방화벽)를 확인합니다.Configure a provider and run the connection test. If it fails, verify the key, URL, and network (proxy/firewall).
새 파일이 검색에 안 나옴New files missing 파일이 감시 폴더 안에 있는지, 네트워크 폴더처럼 변경 감시가 제한되는 위치인지 확인.Is the file inside a watched folder? Is it on a network path where change watching is limited? 설정 → 엔진에서 파일 스캔을 수동 실행하세요. 네트워크 루트가 너무 넓다면 하위 폴더로 나눠 등록하세요.Run a manual file scan from Settings → Engine. Split overly broad network roots into subfolders.
PDF 내용이 검색 안 됨PDF content not found 스캔 이미지로 만들어진 PDF인지 확인(텍스트 드래그가 안 되면 이미지 PDF).Is it a scanned-image PDF? (If you cannot select text, it is.) 현재 OCR은 지원되지 않습니다. 텍스트가 포함된 PDF나 원본 문서를 사용하세요.OCR is not supported yet — use a text-based PDF or the original document.
인덱싱이 너무 느림Indexing too slow 성능 프리셋이 최저사용으로 되어 있지 않은지, 감시 폴더에 불필요한 대용량 폴더가 없는지 확인.Is the performance preset set to Eco? Are unnecessary huge folders being watched? Boost를 켜거나(번개 버튼) 성능 프리셋을 올리고, 유휴 부스트로 밤 시간대에 처리되게 하세요.Turn on Boost (lightning button), raise the preset, or let Idle Boost work overnight.
검색창이 안 열림Window won't open 트레이에 Findex 아이콘이 있는지, 단축키가 다른 프로그램과 겹치지 않는지 확인.Is the tray icon present? Does the shortcut clash with another app? 트레이 아이콘을 클릭해 열고, 겹친다면 설정 → 기본에서 단축키를 바꾸세요. 아이콘이 없으면 Findex를 다시 실행하세요.Open from the tray icon; change the shortcut in Settings → General if it clashes. If no icon, relaunch Findex.
엔진 오류가 반복됨Recurring engine errors 설정 → 엔진의 상태 메시지와 엔진 경로 테스트 결과, 엔진 포트 충돌 여부 확인.Check the status message and engine test in Settings → Engine, and look for a port conflict. 엔진 재시작 → 포트 변경 → 검색 데이터 초기화 순으로 시도하고, 계속되면 아래 로그와 함께 문의해 주세요.Try engine restart → change the port → reset search data; if it persists, contact us with the logs below.

FAQ

자주 묻는 질문Frequently asked questions

Q. 문서가 외부 서버로 전송되나요?Q. Are my documents uploaded anywhere?

아니요. 인덱싱과 검색은 전부 내 PC 안에서 처리됩니다. 단, 클라우드 LLM을 연결한 상태에서 Luna에게 질문하면 답변에 필요한 문서 내용 일부가 해당 LLM 제공자에게 전송됩니다. 이것도 원치 않으면 Ollama·LM Studio 같은 로컬 모델을 쓰거나 LLM을 끄면 됩니다. No — indexing and search happen entirely on your PC. However, when you ask Luna with a cloud LLM connected, the excerpts needed for the answer are sent to that provider. If you don't want that either, use a local model (Ollama, LM Studio) or keep the LLM off.

Q. LLM 없이 쓸 수 있나요?Q. Can I use Findex without an LLM?

네. 빠른 검색과 정밀 검색은 LLM 없이 완전히 동작합니다. LLM은 Luna와 AI 기반 기능(폴더 정리 등)에만 필요합니다. Yes. Quick and precise search work fully without one. An LLM is needed only for Luna and AI features like Folder Organizer.

Q. 인덱스는 어느 정도 용량을 쓰나요?Q. How much disk space does the index use?

문서량에 따라 다르지만 보통 수백 MB에서 수 GB 수준입니다. 저장 공간이 부담되면 설정 → 분석에서 분석할 파일 유형을 줄이거나 최대 파일 크기를 낮추세요. It depends on your library — typically hundreds of MB up to a few GB. To reduce it, limit the analyzed file types or lower the max file size in Settings → Analysis.

Q. 프로그램을 껐다 켜면 인덱싱을 처음부터 다시 하나요?Q. Does indexing restart from scratch after a relaunch?

아니요. 진행 상황이 저장되어 다음 실행 때 이어서 진행됩니다. No — progress is saved and resumes on the next launch.

Q. 완전히 처음 상태로 되돌리고 싶어요.Q. How do I start over completely?

설정 → 엔진 → 모두 초기화를 실행하면 모든 데이터가 삭제되고 초기 설정 화면부터 다시 시작합니다. 되돌릴 수 없으니 주의하세요. Run Reset everything in Settings → Engine. All data is erased and the setup wizard starts again. This cannot be undone.

지원Support

로그 확인과 문의하기Finding logs and contacting support

해결되지 않는 문제는 로그와 함께 문의해 주시면 가장 빠르게 도와드릴 수 있습니다. 로그는 다음 위치에 있습니다. For anything unresolved, sending the logs speeds things up a lot. You can find them here:

  1. 탐색기 주소창에 입력: %LOCALAPPDATA%\Findex\logsWindows 탐색기를 열고 주소창에 붙여넣은 뒤 Enter를 누르면 로그 폴더가 열립니다. Paste into the Explorer address bar: %LOCALAPPDATA%\Findex\logsOpen Windows Explorer, paste the path, and press Enter.
  2. 최근 로그 파일 확보앱(Tauri) 로그와 엔진(Engine) 로그 중 문제가 발생한 시각과 가까운 파일을 준비하세요. Grab the recent filesPick the app (Tauri) and engine logs closest to when the problem occurred.
  3. sami_info@samitech.kr로 문의증상, 발생 시각, 로그 파일을 함께 보내주세요. 사용 중인 Windows 버전과 Findex 버전을 적어주시면 더 좋습니다. Email sami_info@samitech.krInclude the symptom, when it happened, the logs, and ideally your Windows and Findex versions.
📚

더 읽어보기: 처음 시작하기 · 검색 · Luna · 설정 Keep reading: Getting Started · Search · Luna · Settings