> ## 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 でドキュメントを整理するための名前付きコンテナです。同じテーマのドキュメントを一つのライブラリにまとめ、検索時にライブラリでフィルタリングして、目的のドキュメントを素早く見つけることができます。

<CardGroup cols={2}>
  <Card title="テーマの分離" icon="layer-group" iconType="duotone">
    「業務ドキュメント」と「学術論文」を分けて管理し、検索が混ざらないようにする
  </Card>

  <Card title="精密な検索" icon="bullseye" iconType="duotone">
    ランチャーや MCP/CLI で検索範囲を特定のライブラリに限定する
  </Card>
</CardGroup>

\*\*ライブラリはオプションの高度な機能です。\*\*ライブラリを作成しなくても既存の機能には影響しません。グローバル検索がデフォルトのまま使えます。ライブラリは、ドキュメントが多く、分類管理が必要なユーザーに最適です。

### ユースケース

* **研究者**：異なるテーマの論文を `ml-papers`、`neuroscience` などのライブラリに分類
* **開発者**：プロジェクトドキュメント、API 仕様、会議メモを分けて管理
* **チームコラボレーション**：プロジェクトごとに専用ライブラリを作成し、MCP を通じて AI アシスタントが関連するライブラリのみを検索
* **個人ナレッジ管理**：ノート、読書メモ、参考資料をカテゴリ別に整理

## ライブラリの作成

<Steps>
  <Step title="ライブラリページを開く">
    **設定 → ライブラリ**に移動します。ライブラリ一覧ページが表示されます（初回使用時は空です）。
  </Step>

  <Step title="新しいライブラリを作成">
    右上の**新規ライブラリ**ボタンをクリックし、ダイアログで以下を入力します：

    * **名前**（必須）：ライブラリの一意な識別子。小文字の英字、数字、ハイフンのみ使用可能（例：`my-research`、`work-2024`）
    * **説明**（任意）：ライブラリの用途の簡単な説明

    <Tip>
      名前はスラッグ形式で、検索時のフィルタパラメータとしても使用されます。短くて覚えやすい名前を推奨します。
    </Tip>
  </Step>

  <Step title="フォルダを追加">
    作成後、ライブラリ詳細ページに移動し、**フォルダを追加**ボタンをクリックして、システムのファイル選択ダイアログからフォルダを選択します。

    一つのライブラリに複数のフォルダを含めることができます。追加後、Linkly AI がフォルダ内のドキュメントを自動的にスキャンしてインデックスを作成します。
  </Step>
</Steps>

### ライブラリの管理

ライブラリ詳細ページでは以下の操作ができます：

* **編集**：鉛筆アイコンをクリックして名前や説明を変更
* **フォルダの削除**：フォルダ右側の削除アイコンをクリックし、ライブラリとの関連付けを解除（実際のファイルは削除されません）
* **ライブラリの削除**：削除アイコンをクリックして確認すると、ライブラリ全体が削除されます。インデックス済みのドキュメントは影響を受けず、グローバル検索で引き続き見つけることができます

## ランチャーでのライブラリ検索

ランチャーは `@` トリガーによるライブラリ限定検索をサポートしています：

<Steps>
  <Step title="@ を入力してライブラリ選択モードへ">
    ランチャーの検索ボックスに `@`
    を入力すると、ライブラリの候補リストに切り替わります。そのまま入力を続けると名前でフィルタリングできます。
  </Step>

  <Step title="ライブラリを選択">
    クリックまたは Enter
    キーでライブラリを選択します。検索ボックスの左側に青いバッジ（例：`@my-research`）が表示され、検索範囲が限定されたことを示します。
  </Step>

  <Step title="検索ワードを入力">
    限定された範囲内で検索します。結果はそのライブラリに含まれるフォルダからのみ返されます。
  </Step>

  <Step title="限定検索を終了">
    検索ボックスが空の状態で Backspace
    キーを押すか、左側の戻るボタンをクリックすると、グローバル検索に戻ります。
  </Step>
</Steps>

## AI アシスタントでの利用

Linkly AI に接続された AI アシスタント（OpenClaw、Claude、Cursor など）は、特定のライブラリ内を直接検索できます。自然言語で検索範囲を伝えるだけです：

<CardGroup cols={1}>
  <Card title="ライブラリ内検索" icon="magnifying-glass" iconType="duotone" horizontal>
    「ml-papers ライブラリで attention mechanism
    に関するドキュメントを検索して」
  </Card>

  <Card title="利用可能なライブラリを確認" icon="list" iconType="duotone" horizontal>
    「ライブラリの一覧を見せて」
  </Card>

  <Card title="組み合わせフィルタ" icon="filter" iconType="duotone" horizontal>
    「ml-papers ライブラリで transformer に関する PDF ファイルを検索して」
  </Card>
</CardGroup>

AI アシスタントが適切な MCP または CLI ツールを自動的に呼び出して検索を完了します。

## CLI での利用

### ライブラリ一覧

```bash theme={null}
linkly list-libraries
```

### ライブラリ内検索

```bash theme={null}
linkly search "attention mechanism" --library ml-papers
```

パスフィルタとの組み合わせ：

```bash theme={null}
linkly search "transformer" --library ml-papers --path-glob "*.pdf"
```

<Tip>
  ライブラリは近日中にクラウドプッシュに対応し、24
  時間いつでもオンラインアクセスできるようになります。
</Tip>

## よくある質問

<AccordionGroup>
  <Accordion title="ライブラリに追加したフォルダは再インデックスされますか？">
    いいえ。フォルダ内のドキュメントがすでにフォルダ管理機能でインデックス済みの場合、ライブラリを作成しても重複インデックスは発生しません。ライブラリは既存のインデックスの上に論理的なグループ分けを追加するだけです。
  </Accordion>

  <Accordion title="v0.3.0 にアップグレードすると再インデックスが発生しますか？">
    v0.3.0 ではキーワードインデックスの構造が変更されたため、アップグレード後にキーワードインデックスが自動的に再構築されます。このプロセスはインデックス構造の調整のみで、ドキュメント内容の再解析は行われないため、完全な再インデックスよりもはるかに高速です。ドキュメント数に応じて、通常数分から数時間程度かかります。
  </Accordion>

  <Accordion title="ライブラリとフォルダの関係は？いつライブラリを使うべきですか？">
    ライブラリに追加されたフォルダは、フォルダ管理リストにも自動的に表示されます。ライブラリは本質的にフォルダの論理的なグループ分けであり、オプション機能です。

    **フォルダを直接追加する方法**はほとんどのユーザーに適しています。フォルダはグローバルで、ローカル検索や MCP リモートトンネル経由のアクセスに対応しています。

    **ライブラリ**は、検索範囲をトピックごとに分離したい場合に便利です。例えば、「仕事」と「学術」のドキュメントを別々に検索する場合などです。また、ライブラリは将来的にクラウドプッシュや特定の外部ツールとの連携もサポートする予定です。

    特別な分類ニーズがなければ、ライブラリを作成しなくても問題なく使用できます。
  </Accordion>
</AccordionGroup>
