メインコンテンツまでスキップ

Vault 検索

Vault 検索 画面(/vault-search)では、インデックス化された Vault を 意味検索・キーワード検索・ハイブリッド検索できます。また、ファイル エクスプローラー タブで Vault の Markdown をディレクトリから辿って閲覧できます。

画面上部のタブで 検索 と ファイルエクスプローラー を切り替えます。 選択したノートは共通のビューアー(本文・frontmatter・Markdown 表示・ Obsidian で開く)で開きます。

検索する​

  1. 検索クエリ を入力します(Enter でも検索できます)。
  2. モードを選びます。
    • Hybrid(既定)
    • Keyword
    • Similarity
  3. 件数を選びます(5件 / 10件 / 20件 / 50件)。
  4. Vault フィルター を選びます(既定は すべてのVault で横断検索。特定 Vault に絞り込めます)。
  5. 検索 を押します。

検索結果の一覧とプレビューには Vault ID([main] / [blog] / [ai] など)が表示され、どの Vault のノートか曖昧になりません。

検索履歴​

最近の検索 に直近の検索(最大 20 件)が保存され、再実行できます。 各項目には mode / N件 が表示されます。履歴はブラウザの localStorage に保存されます。

結果を見る​

一覧から結果を選ぶと 検索結果プレビュー パネルが開きます。 検索結果が見つからない場合は「検索結果が見つかりませんでした」と表示されます。

ファイルエクスプローラー​

ファイルエクスプローラー タブでは、ディレクトリツリー・ファイル一覧・ ビューアーを並べて Vault の Markdown を閲覧できます。

ヘッダーの Vault 選択で対象 Vault を切り替えます(初期選択は main)。 切替えるとツリー・一覧・選択状態はリセットされ、その Vault のファイルだけが表示されます。

  • ルートを選ぶと直下の Markdown、ディレクトリを選ぶとその配下の Markdown を 再帰的に一覧表示します。
  • 一覧のファイルを選ぶとビューアーに本文が表示され、Obsidian で開く から デスクトップの Obsidian で開けます。
  • ファイル一覧はタブを初めて開いたときと 再読込 のときにだけ取得します。

絞り込みと並べ替え​

  • ファイル名で絞り込み はファイル名の部分一致(大文字小文字を区別しない) で一覧を絞ります。ディレクトリ名は対象外です。絞り込みはタブを切り替えても 維持されますが、ページを再読込すると空に戻ります。
  • 一覧ヘッダーの ファイル名 / 更新日時 で並べ替えます。同じ列をもう一度 押すと昇順・降順が切り替わります。初期値は更新日時の新しい順です。

状態の復元​

最後に開いていたタブ、エクスプローラーの展開済みディレクトリ・選択ディレクトリ、 表示していたノート、並べ替えの列と方向はブラウザの localStorage に保存され、 次回同じ画面を開いたときに復元されます。本文・検索結果・絞り込み文字列は保存 しません。削除・移動済みのディレクトリやノートは該当する状態だけが初期値に戻り、 一覧やビューアーはそのまま利用できます。

インデックスの更新​

検索対象を最新にするには、Vault の同期を行います。対象未指定なら全 Vault を ID 順に同期し、 --vault <id>(反復可)で個別同期できます。一 Vault が失敗しても残りを試み、失敗 ID を報告して最後に非ゼロ終了します。

uv run -m obsidian_ai_hub --sync-vault
uv run -m obsidian_ai_hub --sync-vault --vault blog --vault ai

インデックスを完全に再構築する場合:

uv run -m obsidian_ai_hub --rebuild-vault --vault blog

インデックスの保存先と埋め込みモデルは config/config.yml の vault_index で設定します。 保存先は Vault ごとに <基準>/<vault_id>/ へ分離されます。 Vault ID の path を変更した場合はその ID の既存索引が無効化され、 --rebuild-vault --vault <id> が成功するまで検索に使われません。

CLI から検索する​

uv run -m obsidian_ai_hub --vault-search --query "project planning" \
--k 5 --search-mode hybrid --json
uv run -m obsidian_ai_hub --vault-search --query "draft" --vault blog

--k は結果件数(既定 10)、--search-mode は similarity / keyword / hybrid(既定 hybrid)、 --json は機械可読の JSON 出力です。--vault 未指定なら全 Vault を横断検索します。

次に読む​