> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 全文検索ランチャーの使い方

> Linkly AI は強力な全文検索ランチャーを提供し、必要なドキュメントを素早く見つけるお手伝いをします。

## ランチャーの紹介

Linkly AI ランチャーは、macOS の Spotlight や Raycast に似たグローバル検索ウィンドウです。いつでもショートカットキーで呼び出し、キーワードや自然言語を入力してローカルドキュメントを検索できます。

Linkly AI の検索機能は、キーワードとセマンティクスに基づくハイブリッド検索アルゴリズムを採用しており、キーワードの正確なマッチングだけでなく、検索意図を理解して意味的に関連するドキュメントも見つけることができます。

<CardGroup cols={2}>
  <Card title="キーワード検索" icon="magnifying-glass" iconType="duotone">
    正確なキーワードを入力して、ドキュメントのタイトルと内容を素早くマッチング
  </Card>

  <Card title="セマンティック検索" icon="brain" iconType="duotone">
    自然言語で探したい内容を記述すると、AI
    が意味を理解して関連ドキュメントを返します
  </Card>
</CardGroup>

## 使い方

<Steps>
  <Step title="ランチャーを呼び出す">
    グローバルショートカット `⌘ + Shift + L`（macOS）または `Ctrl + Shift + L`（Windows/Linux）を押すと、ランチャーがすぐに表示されます。

    <Tip>
      「設定 → 一般 → 検索ショートカット」でショートカットキーをカスタマイズできます。
    </Tip>
  </Step>

  <Step title="検索内容を入力">
    検索ボックスにキーワードまたは自然言語で記述を入力します。入力後、システムが自動的に検索を実行するため、Enter キーを押す必要はありません。

    **検索例：**

    * 正確検索：`API 設計文档`
    * 自然言語：`チーム協力フローに関するメモ`
    * 複数キーワード：`React パフォーマンス最適化 ベストプラクティス`
  </Step>

  <Step title="検索結果を閲覧">
    検索結果はリアルタイムで表示され、各結果には以下が含まれます：

    * **ドキュメントアイコン** — ファイルタイプ（PDF、DOCX、MD など）に応じたアイコン表示
    * **タイトル** — ドキュメントのファイル名
    * **内容スニペット** — マッチした本文の断片（検索語がハイライト表示）
    * **ファイルパス** — ドキュメントの所在パス
    * **マッチ度** — パーセンテージで関連度を表示

    `↑` `↓` 方向キーで結果間をナビゲートできます。
  </Step>

  <Step title="ドキュメントをプレビュー">
    対象の結果を選択して `Enter` を押すと、ドキュメントプレビュービューに入ります。プレビュービューでは以下が提供されます：

    * **全文コンテンツ** — 完全なドキュメントテキスト（検索語が全文中でハイライト表示）
    * **自動位置特定** — 最初のマッチ位置まで自動スクロール
    * **メタデータドロワー** — `⌘ + I` でメタデータパネルを展開し、ファイルサイズ、文字数、作成日時、キーワードなどの詳細情報を確認
  </Step>

  <Step title="ファイルを開く">
    検索結果またはプレビュービューで `Shift + Enter` を押すと、システムのデフォルトプログラムでファイルを開けます。`⌘ + Shift + C` でファイルパスをコピーすることもできます。
  </Step>
</Steps>

### 検索履歴

検索ボックスが空の場合、ランチャーは最近の検索履歴（最大 20 件）を表示します。任意の履歴をクリックすると、すぐに再検索できます。

履歴の横にあるクリアボタンをクリックすると、すべての履歴を一度に消去できます。

## ショートカットキー

### グローバルショートカット

| ショートカット                                                   | 機能             |
| --------------------------------------------------------- | -------------- |
| `⌘ + Shift + L`（macOS）/ `Ctrl + Shift + L`（Windows/Linux） | ランチャーの呼び出し/閉じる |

### 検索ビュー

| ショートカット         | 機能                      |
| --------------- | ----------------------- |
| `↑` / `↓`       | 検索結果間のナビゲート             |
| `Enter`         | 選択したドキュメントをプレビュー        |
| `Shift + Enter` | システムのデフォルトプログラムでファイルを開く |
| `⌘ + Shift + C` | ファイルパスをコピー              |
| `⌘ + ,`         | 設定を開く                   |
| `Esc`           | ランチャーを閉じる               |

### プレビュービュー

| ショートカット             | 機能                      |
| ------------------- | ----------------------- |
| `Shift + Enter`     | システムのデフォルトプログラムでファイルを開く |
| `⌘ + Shift + C`     | ファイルパスをコピー              |
| `⌘ + I`             | メタデータパネルの展開/折りたたみ       |
| `⌘ + ,`             | 設定を開く                   |
| `Esc` / `Backspace` | 検索結果に戻る                 |

<Note>
  上記の表の `⌘` キーは、Windows および Linux では `Ctrl` キーに対応します。
</Note>