> ## 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 がパソコン上のドキュメントを一瞬で探し出せるのは、バックグラウンドで黙々とある作業をしているからです —— それが**インデックス**です。このページでは **設定 → インデックス** にあるスイッチをひとつずつ解説し、インデックスに問題が起きたときの調べ方も示します。

インストールしたばかりでご自身のドキュメントをまだ追加していない場合は、先に[クイックスタート](/docs/ja/quickstart)をご覧ください。

***

## インデックスの仕組み

Linkly AI のインデックスは**階層的**です。「全部終わらないと使えない」のではなく、1 つの層が終わるごとに使える検索能力がひとつ増えていきます。

<Steps>
  <Step title="第 1 層：ファイル名（数秒）">ファイルを見つけた時点で、パスとファイル名をすぐインデックスに書き込みます。この層はほぼ一瞬で終わるため、フォルダを追加した直後からファイル名で検索できます。</Step>
  <Step title="第 2 層：全文（キーワード）">ドキュメント本文を解析してローカルの全文インデックスに書き込み、キーワード一致に対応します。この層が終わると、「予算表」で検索したときに本文中にその語が出てくるドキュメントがヒットします。</Step>
  <Step title="第 3 層：セマンティック（ベクトル）">ローカルの埋め込みモデルで本文をチャンクに分けてベクトルに変換します。この層が終わると、「去年いくら使ったか」で検索したときに、タイトルにその語が一切含まれない財務レポートもヒットします。</Step>
</Steps>

この 3 層とは別に、**任意の内容抽出器**が 2 つあります。もともと文字を持たないファイルを文字のあるファイルに変え、上の 3 層に流し込む役割です：

* **文字認識（OCR）**：画像やスキャン版 PDF から文字を読み取ります
* **音声・動画のテキスト抽出（ASR）**：音声や動画の中で話されている内容をテキストに変換します

***

## 設定 → インデックス ページの構成

**設定 → インデックス** を開くと、上から順に 4 つのブロックがあります：

| ブロック               | 内容                                     |
| ------------------ | -------------------------------------- |
| **インデックス済みドキュメント** | 大きな数字ひとつ。今インデックスに何件のドキュメントがあるか         |
| **状態の詳細**          | 読み取り専用の情報群。各層のインデックスが今どうなっているか         |
| **設定スイッチ**         | 7 つのスイッチ。このページの本体で、以下でひとつずつ解説します       |
| **メンテナンス**         | 「インデックスストレージ最適化」と「インデックスを再構築」の 2 つのボタン |

### 状態の詳細の読み方

| 行                     | 説明                                                 |
| --------------------- | -------------------------------------------------- |
| **ステータス**             | 全体のインデックス状態。5 種類の値があります。[インデックスの状態](#インデックスの状態)を参照 |
| **ファイル名検索**           | 第 1 層。正常なら「準備完了」と表示されます                            |
| **全文検索**              | 第 2 層。正常なら「準備完了」と表示されます                            |
| **セマンティック検索**         | 第 3 層。「準備完了 / 準備中 / キュー待ち」のいずれか。スイッチがオフのときは「無効」    |
| **文字認識（OCR）**         | 「準備完了 / 準備中」、または特定のファイルを処理中。スイッチがオフのときは「無効」        |
| **音声・動画のテキスト抽出（ASR）** | 「準備完了 / 処理中 / 待機中」など。有効にしていないときは「未有効」              |
| **最終更新**              | インデックスに最後に書き込まれた時刻                                 |
| **データサイズ**            | インデックスがディスク上で占めている容量                               |

***

## インデックスの設定項目

### 1. パフォーマンスモード

**何をするか**：バックグラウンドのインデックス処理がどれだけ計算リソースを使えるかを制御します。

**既定値**：自動（推奨）

| 選択肢           | 挙動                                                                  |
| ------------- | ------------------------------------------------------------------- |
| **バランス**      | 最小限のリソースでインデックス処理を行い、普段の操作にはほとんど影響しません                              |
| **パフォーマンス重視** | 解析と計算にできるだけ多くのマシンリソースを使います。パソコンの操作に影響することがあります                      |
| **自動（推奨）**    | キーボードとマウスが **120 秒**以上アイドルになると自動的にパフォーマンス重視へ切り替わり、操作を再開するとバランスに戻ります |

### 2. 省電力モード

**何をするか**：ノートパソコンがバッテリー駆動のとき、電力を消費する重い処理を一時停止します。

**既定値**：オフ

<Warning>効くのは「**スイッチがオン**」かつ「**バッテリー駆動中**」の 2 つの条件が同時に成立したときだけです。</Warning>

バッテリー駆動時に一時停止されるもの：

* 画像の OCR
* スキャン版 PDF の構造化 Markdown への変換
* セマンティックインデックス（ベクトル生成）
* 音声・動画の文字起こし
* クラウドライブラリの自動同期
* データベースの整理・最適化

**影響を受けず、通常どおり動くもの**：ファイル名インデックス、全文（キーワード）インデックス。そのため省電力モード中でも、新しいファイルは検索できます。

**いつ触るべきか**：ノートパソコンをお使いなら、そのままオンにして忘れてしまって構いません。デスクトップ機ではオンでもオフでも変わりません。

### 3. アイドル時にモデルを自動スリープ

**何をするか**：ローカル AI モデルが一定時間使われないとメモリを解放し、必要になったら自動的に再読み込みします。

**既定値**：オン

ローカルモデル（セマンティック埋め込み、OCR、音声認識）は約 \*\*300 秒（5 分）\*\*アイドルになると自動的にアンロードされ、メモリが解放されます。
オフにするとモデルはメモリに常駐し、3 つ合わせて約 **1 GB** ほどのメモリを使います。

**いつ触るべきか**：メモリが逼迫している場合（8 GB 以下）は、既定のオンのままにしてください。

### 4. 画像内テキスト認識（OCR）

**何をするか**：ローカルの OCR モデルで画像内の文字を認識します。**さらに、スキャン版 PDF を構造化 Markdown に変換します。**

**既定値**：オン

### 5. セマンティック検索

**何をするか**：オンにすると、自然な言葉や説明的な言い回しでドキュメントを検索できるようになります。

**既定値**：オン

### 6 / 7. 音声解析 と 動画解析

**何をするか**：ローカルの音声認識モデルで、音声や動画の中で話されている内容をテキストに変換し、全文インデックスとセマンティックインデックスに流し込みます。

**既定値：どちらもオフ** ⚠️

| 種類     | 対応形式                       |
| ------ | -------------------------- |
| **音声** | mp3、wav、m4a、flac、aac、ogg   |
| **動画** | mp4、mov、mkv、webm（avi は非対応） |

<Warning>\*\*オフ＝インデックスされない、ではありません。\*\*音声・動画ファイルは通常どおりインデックスに登録されるので、**ファイル名では検索できますが、中で何が話されているかは検索できません**。</Warning>

**いつ触るべきか**：会議の録音、ポッドキャスト、講義動画を検索したいときにオンにしてください。

***

## インデックスの最適化と再構築

### インデックスストレージ最適化

よりコンパクトな方式でベクトルインデックスを作り直します。これは**ほぼ無損失で得られる改善**です：

* ディスク使用量が**約 80% 減ります**（実測で 11.6 倍まで縮小）
* 検索が速くなります

途中でアプリを終了しても安全で、データが壊れることはありません。次回起動時に自動的に続きから再開します。

<Note>**すでに最適な状態のときは、このボタンを押しても何も起きません。**「インデックスはすでに最適化されています」と表示されるだけで、**手動で強制的に再実行することもできません**。</Note>

### インデックスを再構築

**これは危険な操作**で、ボタンは赤色です。実行すると：

* **削除されるもの**：全文インデックスのディレクトリ、すべてのベクトル、各ドキュメントのインデックス進捗マーカー
* **削除されないもの**：元のファイル、すでに抽出済みのテキストキャッシュ、ダウンロード済みのモデルファイル

テキストキャッシュとモデルが残っているからこそ、再構築は初回のインデックス作成より**ずっと速く**終わります。いちばん遅い解析と OCR の工程を省けるからです。

再構築中の検索は**空の結果を返します**（エラーにはなりません）。

<Warning>
  次の 4 つの状況では、押しても**拒否**されてボタンが効きません：

  * バックグラウンドで OCR や音声・動画の文字起こしがまだ動いている
  * インデックスが一時停止されている（トレイメニューで停止した場合）
  * スキャン中またはインデックス処理中である
  * すでに再構築が実行中である
</Warning>

***

## インデックスの状態

ステータスの値は全部で 5 種類です：

| ステータス       | 意味                                                    |
| ----------- | ----------------------------------------------------- |
| **待機中**     | まだ作業を始めていない、**またはインデックスが一時停止されている**（この 2 つは同じ値を共有します） |
| **スキャン中**   | フォルダを走査して、どんなファイルがあるかを見つけているところ                       |
| **インデックス中** | ファイルの内容を解析してインデックスを作っているところ                           |
| **監視中**     | 定常状態。すべてのインデックスが完了し、ファイルの変化を待っている                     |
| **エラー**     | 問題が発生しました。原因は[アプリのログ](/docs/ja/faq)で確認できます                 |

「監視中」が、最終的に見たい状態です。

### インデックスを一時停止するには？

**「インデックス一時停止」はシステムトレイのメニューにしかありません。**トレイの L アイコンを**右クリック**してメニューを開くと、「⏸ インデックス一時停止」/「▶ インデックス開始」があります（左クリックで開くのは AI チャットウィンドウで、メニューではありません）。

***

## よくある質問

<AccordionGroup>
  <Accordion title="音声・動画ファイルがファイル名では検索できるのに、内容では検索できないのはなぜですか？">
    **音声解析と動画解析が既定でオフになっている**からです。オフのときもメディアファイルはインデックスに登録されるため（だからファイル名では検索できます）、中で何が話されているかは文字起こしされていません。

    **設定 → インデックス** で「音声解析」と「動画解析」をオンにすると、アプリが 161 MB の音声認識モデルをダウンロードし、そのあと既存のファイルをすべて自動的に処理し直します。再スキャンもインデックスの再構築も必要ありません。

    例外：メディアファイルの隣に同名の `.srt` / `.vtt` 字幕がある場合や、以前に文字起こししたキャッシュが残っている場合は、スイッチがオフでも内容を検索できます。
  </Accordion>

  <Accordion title="スキャン版 PDF や画像の中の文字が検索できません">
    まず **設定 → インデックス** で「画像内テキスト認識（OCR）」のスイッチがオフになっていないか確認してください。

    **注意：このスイッチは画像の OCR とスキャン版 PDF のテキスト抽出の両方を制御します** —— ラベルには「画像」としか書かれていませんが。オフにすると、スキャン版 PDF も「ファイル名しかなく、本文がない」状態になります。

    スイッチがオンなら、次に状態の詳細の「文字認識（OCR）」の行を見てください。「準備中」と表示されていればモデルがまだダウンロード中か読み込み中なので、少し待ってください。
  </Accordion>

  <Accordion title="ステータスがずっと「待機中」で、進みません">
    いちばん多い原因は**インデックスが一時停止されている**ことです。このスイッチは**システムトレイのメニュー**にしかありません。トレイアイコンを**右クリック**してメニューを開き、「▶ インデックス開始」が見えたら、現在は一時停止中です。クリックすれば再開します。

    見分け方：設定ページのステータスが「待機中」で、その下に英語の小さな文字で `Indexing paused` と出ていれば、一時停止されています。

    一時停止でない場合は、**設定 → フォルダ** にご自身のディレクトリが追加されているかも確認してください。初回のウィザードでは、付属のサンプルドキュメントしかインデックスされません。
  </Accordion>

  <Accordion title="セマンティック検索が効いていないようで、結果がどれも「字面どおり」です">
    次の順に確認してください：

    1. **設定 → インデックス** の状態の詳細で「セマンティック検索」が「無効」と表示されていませんか？そうであればスイッチがオフになっています。オンにすれば自動的に処理が走るので、再構築は不要です。
    2. 「準備中」や「キュー待ち」と出ていませんか？まだベクトルを作っているところなので、終わるまで待ってください。
    3. どちらでもない場合は、**設定 → AI → Embedding モデル** でモデルがまだダウンロード中か、ダウンロードに失敗していないか確認してください。**この状況は検索画面にはまったく表示されず**、検索は黙ってキーワードのみに劣化します。失敗している場合はカード上の「再試行」をクリックしてください。
  </Accordion>

  <Accordion title="インデックスを一時停止するには？設定ページに見当たりません">
    「インデックス一時停止」は**システムトレイのメニューにしかありません**。設定ページには用意されていません。トレイの L アイコンを**右クリック** →「⏸ インデックス一時停止」。再開も同じ場所で、メニュー項目が「▶ インデックス開始」に変わります。

    一時停止中は「インデックスを再構築」を実行できません。先に再開してください。
  </Accordion>

  <Accordion title="インデックスのディスク使用量が大きすぎます">
    **設定 → インデックス → メンテナンス** で「インデックスストレージ最適化」をクリックしてください。よりコンパクトな方式でベクトルインデックスを作り直し、**ディスク使用量が約 80% 減ります**。代償は約 1% の再現率の低下で、そのうえ検索も速くなります。

    ボタンが「インデックスはすでに最適化されています」と表示する場合は、すでに新しい形式になっていて最適化の余地がなく、強制的な再実行もできません。
  </Accordion>

  <Accordion title="検索結果がおかしいのですが、インデックスを再構築すべきでしょうか？">
    急がないでください。再構築は最後の手段で、その間の検索は空の結果を返します。次の順に試してください：

    1. 対応するスイッチがオフになっていないか確認する（OCR / セマンティック検索 / 音声・動画解析）
    2. インデックスが一時停止されていないか確認する（トレイメニュー）
    3. ステータスが「インデックス中」のままではなく「監視中」まで到達しているか確認する

    ここまですべて外れた場合にはじめて **設定 → インデックス → メンテナンス → 再構築** を検討してください。再構築は元のファイルを削除しませんし、抽出済みのテキストキャッシュやモデルファイルも消さないため、通常は初回のインデックス作成よりずっと速く終わります。
  </Accordion>

  <Accordion title="「パフォーマンスモード」を変えればインデックスを止められますか？">
    止められません。パフォーマンスモードが制御するのは**インデックス処理が使うスレッド数と、どれだけ頻繁に処理を譲るか**だけで、「走らせるかどうか」は制御しません。「バランス」を選ぶのは、ゆっくり動かして邪魔をしないようにするだけです。

    本当に止めたい場合は、トレイメニューの「インデックス一時停止」を使ってください。

    なお「自動」モードが見ているのは**キーボードとマウスがアイドルかどうか**だけです（120 秒を超えるとアイドル扱い）。バッテリーの状態も CPU 負荷も見ていません。純粋な Wayland の Linux デスクトップではこの信号を取得できないため、「自動」は常に「バランス」と同じ動作になります。
  </Accordion>

  <Accordion title="省電力モードをオンにしましたが、何も変わっていないようです">
    正常です。省電力モードが効く条件は「**スイッチがオン**」かつ「**バッテリー駆動中**」です。電源につないでいる場合や、バッテリーのないデスクトップ機では、まったく作用しません。

    だからこそ**一年中オンにしたままで構いません**。出かける前に手動でオンにして、帰ってきたらオフにする、といった手間は不要です。
  </Accordion>

  <Accordion title="インデックス中にパソコンが重くなります">
    影響の小さいものから順に：

    1. パフォーマンスモードを「**バランス**」に変更する（即座に反映され、実行中のタスクも新しい予算で取り直されます）
    2. 「**音声解析**」と「**動画解析**」を一時的にオフにする —— メディアの文字起こしはもっとも重い処理で、しかも OCR と同じグローバルな 1 枠を取り合います
    3. それでも重い場合は、トレイメニューの「**インデックス一時停止**」を使い、手が空いたときに再開する
  </Accordion>
</AccordionGroup>

***

## 関連ドキュメント

* [クイックスタート](/docs/ja/quickstart) —— インストール、ドキュメントの追加、AI ツールへの接続
* [ランチャーで検索する](/docs/ja/use-launcher) —— 検索画面の詳しい使い方
* [ライブラリの使い方](/docs/ja/use-libraries) —— ライブラリ単位で検索範囲を区切る
* [よくある質問](/docs/ja/faq) —— インデックスにかかる時間の目安、アプリのログの取得方法
* [AI チャットを使う](/docs/ja/use-chatbot) —— 左サイドバー最下部でもインデックスの状態を確認できます
* [Linkly AI スペース](/docs/ja/linkly-space) —— 既定でインデックスされるフォルダ