사용자 가이드

문서를 빠르게 찾는 데 필요한 모든 것. GitHub 의 전체 README 도 참고하세요.

검색 모드

오른쪽 위 토글로 키워드, 의미, 둘 다(기본)를 선택합니다. 검색은 Enter 를 누르면 실행됩니다. 입력란을 비우면 모든 문서가 다시 표시됩니다.

• 키워드: SQLite FTS5 를 통한 문자 그대로의 검색. 각 단어는 접두사 일치로 OR 결합되므로 budget report 는 budget… 또는 report… 를 포함한 문서를 찾습니다. 제목과 저자에서의 일치는 본문과 태그보다 상위입니다. 문서에 있는 단어·이름·코드를 알 때 가장 좋습니다.
• 의미: AI 임베딩을 통한 의미 검색. 정확한 단어가 없어도 쿼리에 관한 문서를 찾습니다. "X 에 관한 문서"에 가장 좋습니다.
• 둘 다: 둘 다 실행하고 문서마다 더 강한 점수를 취합니다(둘 다 맞으면 작은 보너스). 표시되려면 키워드 일치나 의미 있는 의미 점수가 필요하므로, 약한 의미 잡음이 확실한 키워드 일치를 묻어 버리지 않습니다.

단어 조합에 따른 차이

따옴표는 정확한 구문

단어를 "..." 로 묶으면 모든 모드에서 그 연속 구문의 정확 일치(대소문자 무시)를 요구합니다. 의미와 둘 다 모드에서는 먼저 존재 필터로 작동한 뒤 일치를 의미로 정렬합니다. 형식을 섞을 수 있습니다: golang "import fmt" 는 구문 import fmt 또는 느슨한 단어 golang 을 뜻합니다. 의미 모드에서 불용어로 취급되는 것은 관사(a/an/the)와 접속사뿐이므로, 정확한 표현이 중요하면 구문을 따옴표로 묶으세요.

딥 링크

의미 검색은 어느 문서가 일치하는지 찾습니다. 딥 링크는 그 안의 어디인지 찾습니다. 결과의 버튼을 클릭하면 일치하는 구절이 페이지·줄·섹션 레이블과 함께 나열됩니다. 하나를 클릭하면 일치한 텍스트가 노란색으로 강조된 채 열립니다. 재색인 없이 주문형으로 동작합니다.

모드는 검색을 따릅니다: 의미는 의미로, 키워드나 하이브리드는 용어로 구절을 찾습니다. PDF, TXT, HTML, Markdown, DOCX, RTF, ODT, 전자책, DjVu, XML 계열, LaTeX, 이메일, 소스 코드 등에서 동작합니다. 스프레드시트와 프레젠테이션은 각자의 뷰어로 여는 방식으로 되돌아갑니다.

AI 요약

문서 제목을 클릭하면 dolphin3:latest 가 로컬에서 생성하고 첫 실행 이후 캐시하는, 책 소개 같은 요약이 나옵니다. CPU 전용 하드웨어에서는 첫 요약이 느릴 수 있지만, 이후 요청은 즉시입니다.

인터페이스

• 다크·라이트 테마 전환
• 페이지로 나뉜 결과(페이지당 50 개)와 뒤로·다음
• 빠른 이동을 위한 A–Z·0–9 색인 바; Home 으로 초기화
• 주제별 필터링을 위한 태그 클라우드
• 각 결과의 관련도 배지(0–100%)
• 열기는 기본 앱으로 파일을 실행; 📋 는 경로 복사; 🗑 는 확인 후 디스크와 색인에서 파일 삭제
• 파일이 사라진 문서를 클릭하면 닫을 수 있는 모달이 나타나며 색인에서 제거됩니다. 드라이브가 단순히 마운트 해제된 경우에는 토스트가 나오고 색인은 바뀌지 않습니다.

문서 색인하기

docubrowser rescan 을 실행해 스캔·색인·임베딩합니다. 지원 형식은 다음을 포함합니다:

• PDF, DOCX, PPTX, XLSX, RTF, CSV/TSV, 이메일(.eml)
• OpenDocument(ODT, ODS, ODP 및 템플릿)
• EPUB, MOBI, AZW3, AZW, DjVu
• Visio(VSDX, 구형 VSD), draw.io, PlantUML, Mermaid, SVG
• HTML, Markdown, XML/SGML, DocBook, RSS/Atom/OPML, reST, AsciiDoc, LaTeX, 설정·로그 파일, 소스 코드

제목·저자·주제는 문서 메타데이터에서 읽고, 태그는 디렉터리 구조와 내용에서 생성됩니다. 수집 후 PII 스캐너는 SSN, 신용카드, 은행 라우팅·계좌 번호, 생년월일, MRN, 운전면허, 여권 패턴을 포함한 문서를 제거하고 영구 블랙리스트에 등록합니다. 오탐을 줄이기 위해 구조적으로 검증합니다. 점 파일과 숨김 디렉터리는 설계상 건너뜁니다.

중복은 docubrowser duplist 와 docubrowser dupclean 으로 찾아 정리할 수 있습니다.

설정

톱니바퀴 아이콘을 열거나 /settings 로 이동합니다. 일반 패널에서 문서 디렉터리(실시간 디렉터리 탐색기 포함), 임의 개수의 추가 스캔 디렉터리, 작업 디렉터리, 포트, 언어를 설정합니다. 제외 디렉터리 패널에서 폴더를 스캔에서 제외하며, 이미 색인된 것을 제거하기 전에 확인합니다.

언어

한 설치는 한 언어를 제공하며, 인터페이스, 검색 토크나이저, 임베딩 모델, 요약 모델이 모두 그것을 따릅니다. 현재 지원: 영어(기본), 일본어, 한국어, 간체 중국어, 번체 중국어. 혼합 언어 컬렉션은 지원하지 않습니다.

언어 선택

• 첫 실행. DocuBrowse 는 영어로 시작합니다. 터미널에서 docubrowser start 를 처음 실행하면 원하는 언어를 묻고 답을 저장합니다. 안내만 따르면 됩니다.
• 이후 언제든. 설정 페이지(톱니바퀴 아이콘)를 열고 일반 패널의 드롭다운에서 언어를 고릅니다.

알려진 제한