문서

볼트 & 전체 텍스트 검색

XWX Backup이 저장하는 모든 것은 볼트로 향합니다 — 디스크 위의 일반 Markdown 파일과 즉각적인 검색 색인. 이 페이지는 볼트가 어떻게 구성되는지, 아카이브한 것을 어떻게 다시 찾는지 설명합니다.

볼트의 위치

vault는 기본적으로 사용자 디렉터리(~/.xwx-backup/vault)에 위치합니다. 다른 드라이브나 동기화 폴더를 원하면 설정 → Vault에서 변경하세요.

  • 대화 하나당 Markdown 파일 하나, 플랫폼별 폴더로 정리
  • 모든 파일에 YAML 프론트매터: id, 플랫폼, 제목, 모델, 생성/업데이트 타임스탬프, 메시지 수, 태그
  • 파일 구조는 일부러 단순하게: 어떤 편집기, 스크립트, PKM 도구로도 읽을 수 있습니다

외부에서 파일을 편집한 후에는 다시 스캔을 실행하세요. 디스크의 파일 기준으로 검색 데이터베이스를 다시 만듭니다.

아카이브된 대화를 나열하는 볼트 개요 페이지
아카이브된 대화를 나열하는 볼트 개요 페이지

검색창은 제목뿐 아니라 볼트에 있는 모든 메시지의 본문을 쿼리하며, SQLite FTS 색인이 밀리초 단위로 결과를 돌려줍니다.

  • 모든 플랫폼의 메시지 내용을 한 번에 검색합니다
  • 결과에 제목, 플랫폼, 날짜, 일치 스니펫을 표시합니다
  • 결과를 클릭하면 구문 강조된 코드가 포함된 깔끔한 리더 뷰에서 대화를 읽습니다
플랫폼을 넘나드는 스니펫 검색 결과
플랫폼을 넘나드는 스니펫 검색 결과
note: 플랫폼 자체 검색은 제목과 최근 채팅 정도만 다룹니다 — 그리고 서비스를 넘나들지 못합니다. 로컬 전체 텍스트 검색이야말로 볼트가 존재하는 이유입니다.

필터, 태그 & 별표

검색과 필터를 조합해 아카이브를 좁혀 보세요:

  • 플랫폼 — ChatGPT, Claude, Gemini, …
  • 계정 — 멀티 계정 플랫폼의 경우
  • 날짜 범위 — 대화 업데이트 시간 기준
  • 태그 — 모든 대화에서 자유롭게 편집
  • 별표 — 중요한 대화를 표시하고 골라서 보기

태그와 별표는 Markdown 프런트매터에 기록되므로 앱 밖에서도 살아남습니다.

플랫폼·태그·별표 필터가 있는 볼트 필터 바
플랫폼·태그·별표 필터가 있는 볼트 필터 바

유지 관리: 재스캔, 비우기, ZIP

  • 볼트 재스캔 — 모든 파일을 다시 읽고 검색 색인을 재구축합니다(외부 수정이나 복원 후에 실행하세요)
  • ZIP으로 패키징 — 현재 필터된 선택 항목을 ZIP 아카이브로 묶어 오프사이트 보관이나 공유에 사용합니다
  • 아카이브 비우기 — 볼트 내용과 색인을 삭제합니다. 파괴적 작업이며 설정은 유지됩니다

Frequently Asked Questions

앱을 쓰면서 Obsidian에서 볼트 파일을 편집할 수 있나요?+

네 — 볼트는 일반 Markdown입니다. 편집 후 재스캔을 실행하면 검색 색인이 외부 수정을 반영합니다. Obsidian 전용 폴더를 원한다면 대신 Obsidian Sync 기능을 사용하세요.

볼트 자체는 어떻게 백업하나요?+

파일 폴더일 뿐입니다 — 평소 파일 백업에 포함하거나(또는 동기화/클라우드 폴더 안에 두세요) 주기적 스냅샷에는 ZIP 패키징이 편리합니다.

파일을 수동으로 복원한 뒤 검색이 아무것도 찾지 못합니다. 왜죠?+

색인을 다시 만들어야 합니다: 설정 → 볼트 → 재스캔.

ChatGPT, Claude, Gemini 기록을 한곳에서 함께 검색할 수 있나요?+

네 — 그것이 vault가 존재하는 이유입니다. 플랫폼 자체 검색은 제목(그것도 최근 대화만)만 대상이고 서비스 간 검색은 아예 불가능합니다. XWX Backup은 모든 플랫폼의 모든 메시지 본문을 하나의 로컬 인덱스에 색인해 밀리초 단위로 결과를 돌려줍니다.

vault를 Logseq 같은 다른 Markdown 도구와 함께 쓸 수 있나요?+

네. vault는 표준 YAML 프론트매터를 갖춘 일반 Markdown이며 독자 포맷이 전혀 없습니다. Obsidian, Logseq, VS Code, grep, 정적 사이트 생성기, 직접 만든 스크립트까지 그대로 동작합니다.

Related Articles