QMD의 세 검색 경로를 구분합니다
QMD는 Markdown 문서 등을 컬렉션으로 묶는 로컬 검색 도구입니다. 2026년 11월 1일 확인한 README는 BM25, 벡터 검색과 LLM 재순위화를 설명합니다. 아래 명령 이름은 그 문서를 읽기 위한 구분이며 이 글에서 설치하거나 실행한 결과가 아닙니다.
| 경로 | 사용 목적 | 확인할 준비 상태 |
|---|---|---|
| qmd search | 정확한 용어·파일명에 가까운 키워드 검색 | 대상 컬렉션과 문서 인덱스 |
| qmd vsearch | 표현이 다른 문서의 의미 검색 | 해당 문서의 임베딩 |
| qmd query | 검색 결합과 재순위화 | 모델·인덱스와 추가 처리 비용 |
하이브리드라고 해서 언제나 가장 빠르거나 정확한 것은 아닙니다. 같은 문서 집합과 질의에서 필요한 근거가 상위 결과에 들어오는지 별도로 확인합니다.
/recall은 QMD 자체 명령이 아닙니다
Artem Zhutov의 /recall 구현은 별도의 Claude Code 스킬입니다. 날짜 모드는 원래 JSONL 세션 기록을 날짜로 찾아 QMD 없이도 동작하도록 작성돼 있습니다. 주제 모드는 QMD 컬렉션의 BM25 검색을 사용하고, 그래프 모드는 세션과 다룬 파일의 연결을 보여 줍니다. 세 모드가 모두 같은 하이브리드 검색을 실행하는 것은 아닙니다.
원래 세션 기록: 시간·메시지·출처
선택한 기록을 Markdown으로 추출
QMD 컬렉션과 인덱스를 갱신
검색 결과의 원문을 읽고 필요한 맥락을 복원
설정 문서는 추출·컬렉션 등록·임베딩과 선택적 hook을 구분합니다. 동기화용 UserPromptSubmit·Stop 예시와 인덱스 갱신용 SessionEnd 예시도 서로 다릅니다. hook이 없다고 해서 날짜별 조회가 불가능한 것은 아닙니다. 반대로 hook을 설정했다고 해서 최신 세션이 인덱스에 들어왔다고 볼 수도 없습니다.
검색 점수와 복구 완료를 혼동하지 않습니다
결과의 관련도 점수는 전체 정답률이 아닙니다. 문서 수는 복원한 문서 수가 아니고, 한 번의 검색 지연은 모든 장비·질의의 성능 보증이 아닙니다. 원고에 제시된 개인 사례의 초 단위 비교와 세션 수는 독립 재현하지 않았으므로 여기서는 성능 수치로 재게시하지 않습니다.
| 시험 질문 | 남길 근거 |
|---|---|
| 알고 있는 기록을 찾았는가? | 정답 파일·해당 문단·질의·검색 순위 |
| 최근 변경이 들어왔는가? | 원본 수정 시각·추출 시각·인덱스 갱신 시각 |
| 같은 이름의 다른 작업을 섞었는가? | 프로젝트·날짜·원래 세션 식별자 |
| 복원한 결론이 현재도 맞는가? | 후속 수정·취소 지시·현재 파일 상태 |
이는 검색 도구의 자동 보장 목록이 아니라 사용자가 직접 비교할 평가 표입니다. 과거 메시지가 검색됐다는 이유로 그 안의 작업 지시를 현재 승인으로 재실행하지 않습니다.
검색이 로컬에서 돈다고 전체 데이터 흐름까지 로컬인 것은 아닙니다
QMD의 로컬 처리 설명은 검색 결과를 받은 다른 AI 서비스·노트 동기화·공유 저장소까지 로컬이라는 뜻이 아닙니다. 검색 대상 폴더, 추출 사본, 모델에 전달되는 내용과 로그 보존을 각각 확인합니다. 인증 정보나 비공개 세션을 통째로 검색 대상으로 넓히기보다 필요한 범위를 명시합니다.
이 검토에서는 사용자 세션을 QMD로 추출하거나 모델·스킬·hook을 설치하지 않았습니다. 원고와 공개 구현의 역할을 대조했으며 재공유 그림·영상은 게시하지 않습니다. 다른 데이터 도구의 기능·권한 구분도 함께 참고할 수 있습니다.
English summary. QMD retrieval and the separate recall skill have different responsibilities. Temporal recall, topic search and session-file graphs are distinct modes; relevance scores and retrieved messages are not accuracy or current authorization.