> ## 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 ユーザーから特によく寄せられる質問にお答えします。 ## Linkly AI はユーザーのデータプライバシーをどのように保護していますか？ Linkly AI は **ローカルファースト（local-first）** のアーキテクチャを採用しています。ドキュメントの原本、全文検索インデックス、ベクトルインデックス、ベクトル化モデルの推論はすべてお使いのデバイス上で完結し、デフォルトではいかなるサーバーにもアップロードされません。 ### ローカルに保存されるデータ * **ドキュメントの原本**：元のフォルダにそのまま残ります。Linkly AI は読み取るだけで、コピーや移動は行いません。 * **全文検索インデックス（BM25）**：Tantivy を使ってローカルで構築します。 * **ベクトルインデックス**：埋め込みベクトルはローカルデータベースに保存されます。 * **埋め込みモデル**：埋め込みモデルは完全にお使いのデバイス上でローカルに実行されます。macOS Apple Silicon では自動的に Metal GPU 加速が有効になります。 * **アプリログ**：ローカルファイルにのみ書き込まれ、自動的にアップロードされることはありません。 ### AI 対話のデータの行き先 チャットボットが大規模言語モデルを呼び出す際、データの流れは選択した provider によって異なります： Ollama、LM Studio など OpenAI 互換のローカルサービス。データは完全にローカルに留まり、デバイスから出ません。 `api.linkly.ai` を経由してサードパーティのモデルプロバイダーに転送します。リクエストは Linkly のサーバーを通過します。 OpenAI、Anthropic などの API に直接接続します。リクエストは Linkly のサーバーを経由しません。 **設定 → AI モデル**から各 provider を自由に追加・切り替え・無効化できます。 ### ユーザー体験改善プログラム（テレメトリ） どの機能が使われているか、どんな実行環境で動いているかを把握するため、Linkly AI はデフォルトで**匿名**の利用データ送信を有効にしています： | 送信される情報 | 送信されない情報 | | --------------------- | ------------------ | | 機能の利用カウント（アクション単位） | ドキュメントの内容、ファイル名、パス | | アプリのバージョン、OS、アーキテクチャ | チャット内容、検索クエリ | | ローカルでランダム生成されたデバイス ID | API キー、カスタム URL | **設定 → データプライバシー → ユーザー体験改善プログラム**でいつでも無効にできます。無効化すると、メモリ内でまだ送信されていないイベントもすべて破棄されます。 設定の「データプライバシー」パネルでは、各機能のデータの流れ（**ローカル / 公式クラウド / サードパーティ**）が 3 枚のカードで可視化されており、どのデータがデバイスから出ていくのかを一目で確認できます。 ### プライバシーへの約束 * Google Analytics などのサードパーティ分析 SDK は組み込んでいません。 * ブラウザ履歴やクリップボードを読み取りません。 * アカウントログインは必須ではありません。コア機能はオフラインで動作します。 * アプリログはお使いのマシンにのみ保存され、明示的に共有しない限り送信されません。 ## Linkly AI のインデックスはどのくらいで完了しますか？ インデックス処理にかかる時間は、**ファイル数、ファイル種別、マシンの性能、インデックスモード**によって変わります。Linkly AI のインデックスは 3 つのフェーズで進行します： ファイルが発見されるとすぐにパスとファイル名を全文検索インデックスへ書き込み、本格的なインデックスを待たずにファイル名で検索できるようにします。 ドキュメントの内容（txt、md、html、docx、pptx、epub、pdf、画像、および文字起こしを有効にした場合は音声・動画）をパースし、アウトラインとメタデータを Tantivy に書き込みます。複数の worker で並列処理できます。 ローカルの埋め込みモデルで各ドキュメントチャンクのベクトルを生成し、ベクトルインデックスへ書き込みます。 ### 速度に影響する要因 * **ファイル数**：総処理時間とほぼ線形に比例します。 * **ファイル形式**：プレーンテキストが最も速く、PDF はページ構造の解析が必要です。 * **マシン性能**：Apple Silicon（M シリーズ）では Metal GPU 加速で埋め込み処理が高速化されます。Windows / Linux 上では現状 CPU 推論です。 * **インデックスモード**：**設定 → インデックス**で `パフォーマンス / バランス / 自動` を選べます。パフォーマンスモードは並列度が高く CPU 使用率も上がります。自動モードはシステムのアイドル時に自動的にパフォーマンスモードへ切り替わります。 ### 目安 以下はあくまで概算で、実際の所要時間は機材とファイル構成によって大きく変わります： | シナリオ | 目安 | | ------------------------------------ | -------- | | 数千ファイルのプレーンテキスト（txt / md）、M シリーズ Mac | 数分 | | 数万ファイルの混在形式（PDF を一部含む）、M シリーズ Mac | 数十分～数時間 | | 大量の画像を含む（OCR 必要） | さらに長時間 | | 同等規模を Windows / Linux の純 CPU マシンで | Mac より遅い | Launcher の上部にあるインデックス進捗バーで、処理中の進捗（処理済み / 残り）をリアルタイムで確認できます。インデックスはバックグラウンドで進行し、検索を妨げません — ファイル名インデックスが完了した時点で検索はすぐに使えます。 Linkly AI を試してみる段階では、**小規模なナレッジベース**（数百～数千ファイル）から始め、慣れてからより大きなディレクトリを追加することをおすすめします。 ## あるファイルが検索できないのはなぜ？ まずは切り分けから——**そのファイルをファイル名で検索してみてください**。結果は 3 通りあり、それぞれまったく別の種類の問題です： | ファイル名検索の結果 | 意味 | 次に読むところ | | ----------------------------- | --------------------------- | --------------------------------- | | 出る。**グレーの「未インデックス · ⋯」バッジ付き** | インデックスには入ったが、本文がスキップされた | 本節の下の [4 つの原因](#4-つの原因) | | 出る。**バッジはない**のに本文が検索できない | 本文の処理がまだ回ってきていないか、抽出スイッチがオフ | [次の節](#ファイル名は出るのにバッジもなく本文が検索できない) | | **ファイル名でも出てこない** | そもそもインデックスに入っていない | [その次の節](#ファイル名でも検索できない) | この一手間が肝心です。3 つは対処法がまったく違うので、切り分けを飛ばすと見当違いの方向で長く消耗しがちです。 スキップされたファイルが設定ページに個別に列挙されることは**ありません**。**検索結果のバッジが唯一の発見手段**です——だからこそ、上の切り分けは一度ご自身で行う必要があります。 ### 4 つの原因 | バッジ | 実際に何が起きているか | | -------------------------- | ----------------------------------------------------------------- | | **未インデックス · クラウドプレースホルダー** | ファイルはクラウド上に存在するが、**この端末にはまだ実体がダウンロードされていない**——ディスク上にはプレースホルダーしかない | | **未インデックス · 署名不一致** | ファイルの実際の中身が拡張子と一致しない（たとえば `.pdf` という名前なのに中身が PDF ではない） | | **未インデックス · 音声トラックなし** | この動画には音声トラックがなく、文字起こしできる内容がない | | **未インデックス · 文字起こし失敗** | 音声・動画の文字起こしが完了しなかった（デコードできない、または未対応の音声形式） | バッジにマウスを乗せると同じ説明が表示されます。この種のファイルも検索結果には残り続け、本文が検索できないだけです。 ### クラウドプレースホルダーとは iCloud Drive、OneDrive、Dropbox、Synology Drive といったクラウドストレージには「**オンデマンドダウンロード**」（「オンラインのみ」「スマート同期」などとも呼ばれます）という仕組みがあります。ファイルは Finder / エクスプローラー上に見えていても、中身はまだクラウドにあり、ダブルクリックして開いた時点で初めてダウンロードされます。 Linkly AI は**この種のファイルを意図的に開きません**——開いた瞬間にダウンロードが走り、1 回のインデックスで数百 GB のクラウドストレージをまるごとローカルに引き落として、ディスクを埋め尽くし帯域を使い切ってしまう恐れがあるからです。そのため属性による判定だけを行い、プレースホルダーだと分かれば本文をスキップして、ファイル名のインデックスだけを残します。 **対処法**：本当に検索したいディレクトリを、クラウドストレージのクライアント側で「この端末に常に保持する」に設定してください（呼び方は各社で異なり、OneDrive は「このデバイス上に常に保持する」、Dropbox は「ローカルにする」、iCloud は右クリックの「今すぐダウンロード」です）。ファイルがローカルに実体化すると、Linkly AI は次のスキャンでそれが利用可能になったことに気づき、**自動的に本文のインデックスを補完します**——インデックスの再構築も、フォルダの追加し直しも必要ありません。 スキャンは、アプリの起動時、設定の変更時（フォルダの追加・削除など）、大量のファイル変更を検知したときに自動的に走ります。すぐに一度走らせたいなら、アプリを再起動するのがいちばん手軽です。 ### 署名不一致と表示されたら これは、ファイル先頭のシグネチャバイトが拡張子と一致していないという意味です。よくあるのは、同期ツールから取得したスタブファイル、ダウンロードが中断して途中で切れたファイル、あるいは誰かが手作業で拡張子を書き換えたファイルです。 対応するソフトで開いて確認してみてください——そもそも開けないファイルなら、Linkly AI がスキップしたのは正解です。拡張子が間違っているだけなら、正しい拡張子に直せば解決します。 この点について Linkly AI が採っている方針は、**取りこぼしは許容しても、誤って切り捨てない**というものです。ファイルヘッダーの読み取り中に一時的な IO エラーや権限の揺らぎが起きた場合は、すべて「内容は利用可能」として扱い、一度の瞬間的な失敗で本物のファイルを恒久的にスタブ扱いすることは決してありません。 ## ファイル名は出るのにバッジもなく本文が検索できない バッジがないということは、ファイル自体には問題がなく、**本文を抽出する工程がまだ済んでいないか、そもそもできない**ということです。可能性の高い順に： 1. \*\*対応する抽出スイッチがオフになっている。\*\*画像やスキャン PDF は「画像内テキスト認識（OCR）」、音声・動画は「音声解析」「動画解析」に依存します——**後ろの 2 つはデフォルトでオフ**です。**設定 → インデックス** で確認してください。 2. \*\*まだ順番が回ってきていない。\*\*OCR と音声・動画の文字起こしはもっとも重い処理なので、待ち行列が長くなるのは正常です。設定ページのステータス詳細で、いま何を処理しているかを確認できます。 3. \*\*そのファイルの解析に失敗した。\*\*ファイルが壊れている、暗号化された PDF である、といったケースです。この場合バッジは付かず、スキップされたまま再試行もされません。 各スイッチの役割とデフォルト値、そしてステータス詳細の各行の意味は、すべてこのページにまとめてあります。 ## ファイル名でも検索できない これは、そのファイルが**そもそもインデックスに入っていない**ということです。よくある原因は 3 つあります。 **1. そのフォルダが監視されていない。**　**設定 → フォルダ** を開き、親ディレクトリが一覧にあるか確認してください。初回起動のウィザードでインデックスされるのは同梱のサンプルだけで、ご自身のディレクトリはご自身で追加する必要があります。 **2. その形式が対応リストにない。**　Linkly AI はホワイトリスト方式です。PDF、DOCX、PPTX、EPUB、Markdown、TXT、HTML、画像、音声、動画の拡張子だけが取り込まれます。**xlsx、csv、doc、rtf、htm、avi は現時点でいずれも対象外**です——ホワイトリストにないファイルは、ファイル名すら登録されません。完全な一覧は[ツール紹介](/docs/ja/tools-intro)をご覧ください。 **3. 無視されるディレクトリの中にある。**　次のディレクトリとその配下はすべて丸ごとスキップされます： * **ドットで始まる隠しディレクトリ**（`.git`、`.cache`、`.dropbox.cache` など） * **`node_modules`、`__pycache__`** といったビルド / 依存キャッシュ * **NAS の同期メタデータ**：`#recycle`、`#SynoRecycle`、`@eaDir`（Synology）、`@Recycle`（QNAP） * **システムディレクトリ**：`$RECYCLE.BIN`、`System Volume Information` Git リポジトリの中では、`.gitignore` で除外されたファイルも同様にインデックスされません。ノートがたまたまリポジトリの無視対象ディレクトリの下に置かれている場合は、外に移すか、そのディレクトリを単独で **設定 → フォルダ** に追加してください。 ## 音声や動画の中で何が話されているか検索できません **音声解析と動画解析はデフォルトで無効**だからです。無効な状態でもメディアファイル自体は通常どおりインデックスに登録されるため（だからファイル名では検索できます）、中で何が話されているかは文字起こしされません。 **設定 → インデックス** で「音声解析」と「動画解析」を有効にすると、アプリが音声認識モデルをダウンロードし、その後すでにあるメディアファイルを自動的にすべて処理します——再スキャンもインデックスの再構築も必要ありません。 このページでは、**設定 → インデックス** にある各スイッチの役割とデフォルト値、そしてインデックスに問題が起きたときの一通りの切り分け手順を説明しています。 ## よく使う設定はどこにありますか？ 設定ウィンドウは機能ごとにページが分かれています。以下は特に探されることの多いページです： * **言語**：インターフェースの表示言語 * **ログイン時に起動**：システムへのログイン時に Linkly AI を自動起動します * **サイレント起動**：ログイン時の起動ではバックグラウンドに常駐し、メインウィンドウを表示しません。**デフォルトで有効**——インデックスも MCP サービスも動いていますが、作業の邪魔をしません * **検索ショートカット**：[ランチャー](/docs/ja/use-launcher)を呼び出す / 隠すグローバルショートカット。クリックすればすぐ録り直せますし、「デフォルトに戻す」もできます。その組み合わせが使用中またはシステム予約だと表示された場合は、別のものに変えてください * **Linkly AI スペース**：デフォルトでインデックスされるフォルダです。開いたり別の場所に変更したりできます。詳しくは [Linkly AI スペース](/docs/ja/linkly-space)をご覧ください * **テーマ**：ライト / ダーク / システム * **文字サイズ**：小 / 標準 / 大。インターフェースとチャットの両方に効きます * **Dock アイコンを表示**（macOS）：オフにするとアプリはメニューバーのトレイにだけ残り、Dock の場所を取りません * **アップデートを確認**：手動で新しいバージョンを確認してダウンロードします。完了したら「再起動して更新」をクリックします * **ベータプログラムに参加**：有効にするとベータ版のアップデートを受け取り、新機能を先行して使えます。ただし十分にテストされていない変更に当たることもあります * **データフォルダ**：インデックス、設定、ログの保存先です。「開く」で直接開けます（[ログの取得](#linkly-ai-のアプリログを取得するには)もここからです） * ここから更新履歴、プライバシーポリシー、利用規約、および CLI と Skills の説明にも移動できます アプリ内のすべてのショートカットを一覧表示します。ランチャーで `⌘ + /`（Windows/Linux は `Ctrl + /`）を押すと、このページを直接開けます。 「**インデックス一時停止**」は設定の中にはありません——**システムトレイのメニュー**にだけあり、トレイの L アイコンを**右クリック**しないと出てきません（左クリックで開くのは AI チャットウィンドウです）。詳しくは[インデックスの設定](/docs/ja/indexing)をご覧ください。 ## Linkly AI のアプリログを取得するには？ アプリは起動中、すべてのレベルのログを自動でローカルの `app.log` ファイルに書き込みます（1 ファイル最大 2 MB、ローテーション方式）。問題を報告されるときや、ご自身でトラブルシューティングする際に、このログを添付していただくと原因特定が大幅に速くなります。ログ内の機微なデータはすでにマスクされています。 ログを取得する方法は 2 つあります： ### 方法 1：アプリ内から開く（推奨） 最もかんたんな方法です： Linkly AI で **設定 → 情報** に移動します。 「**データディレクトリ**」の行を見つけ、右側の「**開く**」ボタンをクリックします。アプリのデータが保存されているフォルダがファイルマネージャで開きます。 そのフォルダ内の `logs/` サブディレクトリに入り、`app.log` を弊社にお送りください。 ### 方法 2：データディレクトリを手動で開く アプリがクラッシュしていたり起動できない場合は、ディスク上のフォルダを直接開いてください： 1. Finder を開きます。 2. 上部メニューから **移動 → フォルダへ移動…**（または ⌘ + ⇧ + G）を選びます。 3. 以下のパスを貼り付けて Return キーを押します： ``` ~/Library/Application Support/ai.linkly.desktop/logs ``` 4. 開いたフォルダで `app.log` を見つけて弊社へお送りください。 1. Win + R で「ファイル名を指定して実行」ダイアログを開きます。 2. 以下のパスを貼り付けて Enter キーを押します： ``` %APPDATA%\ai.linkly.desktop\logs ``` 3. 開いたフォルダで `app.log` を見つけて弊社へお送りください。 ターミナルで実行します： ```bash theme={null} xdg-open ~/.local/share/ai.linkly.desktop/logs ``` または `app.log` を直接コピーします： ```bash theme={null} cp ~/.local/share/ai.linkly.desktop/logs/app.log ~/Desktop/ ``` ### アプリが起動時にクラッシュしてしまう場合は？ アプリが起動直後にクラッシュすると、`app.log` への書き込みが間に合わない場合があります。そのケースでは、クラッシュ情報を別ファイル **起動時クラッシュログ** `linkly-ai-startup-panic.log` に保存しています。以下のパスでご確認ください。 1. Finder を開きます。 2. メニューから **移動 → フォルダへ移動…** を選択（または ⌘ + ⇧ + G）。 3. 下のパスを貼り付けて Enter を押します： ``` ~/Library/Application Support ``` 4. 開いたフォルダで `linkly-ai-startup-panic.log` を見つけて弊社へお送りください。 1. Win + R で「ファイル名を指定して実行」ダイアログを開きます。 2. 下のパスを貼り付けて Enter を押します： ``` %LOCALAPPDATA% ``` 3. 開いたフォルダで `linkly-ai-startup-panic.log` を見つけて弊社へお送りください。 このパスは `%LOCALAPPDATA%`（ローカルデータ）であり、`app.log` が置かれる `%APPDATA%`（ローミングデータ）とは異なります。 ターミナルで実行します： ```bash theme={null} cp ~/.local/share/linkly-ai-startup-panic.log ~/Desktop/ ``` このログは起動時にクラッシュが発生した場合にのみ生成され、クラッシュのたびに前回の内容を上書きします。このファイルすら存在しない場合は、クラッシュ時の画面やダイアログのスクリーンショットと、OS のバージョンを併せてお送りください。 GitHub Issues で報告するか、コミュニティページの各チャネルからご連絡ください。