Documentation

保管庫と全文検索

XWX Backupが保存したものは、すべて保管庫に集まります。ディスク上のプレーンなMarkdownファイル群と、それを支える即時検索インデックスです。このページでは、保管庫の構成と、アーカイブから欲しい情報を見つける方法を説明します。

保管庫の保存場所

デフォルトでは、保管庫はユーザーディレクトリ(~/.xwx-backup/vault)に置かれます。別のドライブや同期フォルダにしたい場合は、設定 → 保管庫で変更できます。

  • 会話1件につきMarkdownファイル1つ。ファイル名は会話タイトルに由来します
  • 全ファイルにYAMLフロントマター:タイトル、プラットフォーム、モデル、作成/更新タイムスタンプ、タグ、文字数、ソースURL
  • ファイル構成は意図的に素朴です。どんなエディタ、スクリプト、PKMツールでも読めます

外部でファイルを編集した後は再スキャンを実行してください。ディスク上のファイルから検索データベースを再構築します。

アーカイブ済み会話の一覧が表示された保管庫概要ページ
アーカイブ済み会話の一覧が表示された保管庫概要ページ

検索バーは、保管庫内の全メッセージの本文を対象に検索します(タイトルだけではありません)。SQLite FTSインデックスにより、結果はミリ秒単位で返ります。

  • メッセージ本文を全プラットフォーム横断で一括検索
  • 結果にはタイトル、プラットフォーム、日付、一致箇所のスニペットを表示
  • 結果をクリックすると、コードにシンタックスハイライトが付いたすっきりしたリーダービューで会話を読めます
プラットフォーム横断の検索結果とスニペット
プラットフォーム横断の検索結果とスニペット
note: プラットフォーム公式の検索はタイトル中心で、最近のチャットしか対象にならないことも多く、サービスをまたぐ検索はそもそも不可能です。ローカル全文検索こそ、この保管庫が存在する理由です。

フィルタ、タグ、スター

検索にフィルタを組み合わせて、アーカイブを絞り込みます:

  • プラットフォーム — ChatGPT、Claude、Geminiなど
  • アカウント — マルチアカウントのプラットフォーム向け
  • 期間 — 会話の更新日時で指定
  • タグ — どの会話にも自由にタグを編集できます
  • スター付き — 重要な会話に印を付け、そこだけに絞り込めます

タグとスターはMarkdownフロントマターにも書き戻されるため、アプリの外でも保持されます。

プラットフォーム・タグ・スターのフィルタがある保管庫のフィルターバー
プラットフォーム・タグ・スターのフィルタがある保管庫のフィルターバー

メンテナンス:再スキャン、消去、ZIP化

  • 保管庫を再スキャン — 全ファイルを読み直し、検索インデックスを再構築します(外部編集や復元の後に実行)
  • ZIPにパッケージ — 現在の絞り込み結果をZIPアーカイブにまとめ、オフサイト保管や共有に活用できます
  • アーカイブを消去 — 保管庫の内容とインデックスを削除します。破壊的操作です。知識グラフと設定は保持されます

Frequently Asked Questions

+

+

+

Related Articles