Skip to main content
このページでは、Linkly AI ユーザーから特によく寄せられる質問にお答えします。

​
Linkly AI はユーザーのデータプライバシーをどのように保護していますか？

Linkly AI は ローカルファースト（local-first） のアーキテクチャを採用しています。ドキュメントの原本、全文検索インデックス、ベクトルインデックス、ベクトル化モデルの推論はすべてお使いのデバイス上で完結し、デフォルトではいかなるサーバーにもアップロードされません。

​
ローカルに保存されるデータ

  • ドキュメントの原本：元のフォルダにそのまま残ります。Linkly AI は読み取るだけで、コピーや移動は行いません。
  • 全文検索インデックス（BM25）：Tantivy を使ってローカルで構築します。
  • ベクトルインデックス：埋め込みベクトルはローカルデータベースに保存されます。
  • 埋め込みモデル：埋め込みモデルは完全にお使いのデバイス上でローカルに実行されます。macOS Apple Silicon では自動的に Metal GPU 加速が有効になります。
  • アプリログ：ローカルファイルにのみ書き込まれ、自動的にアップロードされることはありません。

​
AI 対話のデータの行き先

チャットボットが大規模言語モデルを呼び出す際、データの流れは選択した provider によって異なります：

ローカルモデル

Ollama、LM Studio など OpenAI 互換のローカルサービス。データは完全にローカルに留まり、デバイスから出ません。

Linkly 公式

api.linkly.ai を経由してサードパーティのモデルプロバイダーに転送します。リクエストは Linkly のサーバーを通過します。

サードパーティ直結

OpenAI、Anthropic などの API に直接接続します。リクエストは Linkly のサーバーを経由しません。
設定 → AI モデルから各 provider を自由に追加・切り替え・無効化できます。

​
ユーザー体験改善プログラム（テレメトリ）

どの機能が使われているか、どんな実行環境で動いているかを把握するため、Linkly AI はデフォルトで匿名の利用データ送信を有効にしています： 設定 → データプライバシー → ユーザー体験改善プログラムでいつでも無効にできます。無効化すると、メモリ内でまだ送信されていないイベントもすべて破棄されます。
設定の「データプライバシー」パネルでは、各機能のデータの流れ（ローカル / 公式クラウド / サードパーティ）が 3 枚のカードで可視化されており、どのデータがデバイスから出ていくのかを一目で確認できます。

​
プライバシーへの約束

  • Google Analytics などのサードパーティ分析 SDK は組み込んでいません。
  • ブラウザ履歴やクリップボードを読み取りません。
  • アカウントログインは必須ではありません。コア機能はオフラインで動作します。
  • アプリログはお使いのマシンにのみ保存され、明示的に共有しない限り送信されません。

​
Linkly AI のインデックスはどのくらいで完了しますか？

インデックス処理にかかる時間は、ファイル数、ファイル種別、マシンの性能、インデックスモードによって変わります。Linkly AI のインデックスは 3 つのフェーズで進行します：
1

ファイル名の高速インデックス（秒単位）

ファイルが発見されるとすぐにパスとファイル名を全文検索インデックスへ書き込み、本格的なインデックスを待たずにファイル名で検索できるようにします。
2

全文抽出と BM25 インデックス（分単位～時間単位）

ドキュメントの内容（txt、md、html、docx、pptx、epub、pdf、画像、および文字起こしを有効にした場合は音声・動画）をパースし、アウトラインとメタデータを Tantivy に書き込みます。複数の worker で並列処理できます。
3

ベクトル埋め込み（分単位～時間単位）

ローカルの埋め込みモデルで各ドキュメントチャンクのベクトルを生成し、ベクトルインデックスへ書き込みます。

​
速度に影響する要因

  • ファイル数：総処理時間とほぼ線形に比例します。
  • ファイル形式：プレーンテキストが最も速く、PDF はページ構造の解析が必要です。
  • マシン性能：Apple Silicon（M シリーズ）では Metal GPU 加速で埋め込み処理が高速化されます。Windows / Linux 上では現状 CPU 推論です。
  • インデックスモード：設定 → インデックスで パフォーマンス / バランス / 自動 を選べます。パフォーマンスモードは並列度が高く CPU 使用率も上がります。自動モードはシステムのアイドル時に自動的にパフォーマンスモードへ切り替わります。

​
目安

以下はあくまで概算で、実際の所要時間は機材とファイル構成によって大きく変わります：
Launcher の上部にあるインデックス進捗バーで、処理中の進捗（処理済み / 残り）をリアルタイムで確認できます。インデックスはバックグラウンドで進行し、検索を妨げません — ファイル名インデックスが完了した時点で検索はすぐに使えます。
Linkly AI を試してみる段階では、小規模なナレッジベース（数百～数千ファイル）から始め、慣れてからより大きなディレクトリを追加することをおすすめします。

​
あるファイルが検索できないのはなぜ？

まずは切り分けから——そのファイルをファイル名で検索してみてください。結果は 3 通りあり、それぞれまったく別の種類の問題です： この一手間が肝心です。3 つは対処法がまったく違うので、切り分けを飛ばすと見当違いの方向で長く消耗しがちです。
スキップされたファイルが設定ページに個別に列挙されることはありません。検索結果のバッジが唯一の発見手段です——だからこそ、上の切り分けは一度ご自身で行う必要があります。

​
4 つの原因

バッジにマウスを乗せると同じ説明が表示されます。この種のファイルも検索結果には残り続け、本文が検索できないだけです。

​
クラウドプレースホルダーとは

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 は現時点でいずれも対象外です——ホワイトリストにないファイルは、ファイル名すら登録されません。完全な一覧はツール紹介をご覧ください。 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 サービスも動いていますが、作業の邪魔をしません
  • 検索ショートカット：ランチャーを呼び出す / 隠すグローバルショートカット。クリックすればすぐ録り直せますし、「デフォルトに戻す」もできます。その組み合わせが使用中またはシステム予約だと表示された場合は、別のものに変えてください
  • Linkly AI スペース：デフォルトでインデックスされるフォルダです。開いたり別の場所に変更したりできます。詳しくは Linkly AI スペースをご覧ください
  • テーマ：ライト / ダーク / システム
  • 文字サイズ：小 / 標準 / 大。インターフェースとチャットの両方に効きます
  • Dock アイコンを表示（macOS）：オフにするとアプリはメニューバーのトレイにだけ残り、Dock の場所を取りません
  • アップデートを確認：手動で新しいバージョンを確認してダウンロードします。完了したら「再起動して更新」をクリックします
  • ベータプログラムに参加：有効にするとベータ版のアップデートを受け取り、新機能を先行して使えます。ただし十分にテストされていない変更に当たることもあります
  • データフォルダ：インデックス、設定、ログの保存先です。「開く」で直接開けます（ログの取得もここからです）
  • ここから更新履歴、プライバシーポリシー、利用規約、および CLI と Skills の説明にも移動できます
アプリ内のすべてのショートカットを一覧表示します。ランチャーで ⌘ + /（Windows/Linux は Ctrl + /）を押すと、このページを直接開けます。
「インデックス一時停止」は設定の中にはありません——システムトレイのメニューにだけあり、トレイの L アイコンを右クリックしないと出てきません（左クリックで開くのは AI チャットウィンドウです）。詳しくはインデックスの設定をご覧ください。

​
Linkly AI のアプリログを取得するには？

アプリは起動中、すべてのレベルのログを自動でローカルの app.log ファイルに書き込みます（1 ファイル最大 2 MB、ローテーション方式）。問題を報告されるときや、ご自身でトラブルシューティングする際に、このログを添付していただくと原因特定が大幅に速くなります。ログ内の機微なデータはすでにマスクされています。 ログを取得する方法は 2 つあります：

​
方法 1：アプリ内から開く（推奨）

最もかんたんな方法です：
1

「情報」ページを開く

Linkly AI で 設定 → 情報 に移動します。
2

データディレクトリを開く

「データディレクトリ」の行を見つけ、右側の「開く」ボタンをクリックします。アプリのデータが保存されているフォルダがファイルマネージャで開きます。
3

logs サブディレクトリから app.log を取り出す

そのフォルダ内の logs/ サブディレクトリに入り、app.log を弊社にお送りください。

​
方法 2：データディレクトリを手動で開く

アプリがクラッシュしていたり起動できない場合は、ディスク上のフォルダを直接開いてください：
  1. Finder を開きます。
  2. 上部メニューから 移動 → フォルダへ移動…（または ⌘ + ⇧ + G）を選びます。
  3. 以下のパスを貼り付けて Return キーを押します：
  4. 開いたフォルダで app.log を見つけて弊社へお送りください。

​
アプリが起動時にクラッシュしてしまう場合は？

アプリが起動直後にクラッシュすると、app.log への書き込みが間に合わない場合があります。そのケースでは、クラッシュ情報を別ファイル 起動時クラッシュログ linkly-ai-startup-panic.log に保存しています。以下のパスでご確認ください。
  1. Finder を開きます。
  2. メニューから 移動 → フォルダへ移動… を選択（または ⌘ + ⇧ + G）。
  3. 下のパスを貼り付けて Enter を押します：
  4. 開いたフォルダで linkly-ai-startup-panic.log を見つけて弊社へお送りください。
このログは起動時にクラッシュが発生した場合にのみ生成され、クラッシュのたびに前回の内容を上書きします。このファイルすら存在しない場合は、クラッシュ時の画面やダイアログのスクリーンショットと、OS のバージョンを併せてお送りください。

ログの送り先

GitHub Issues で報告するか、コミュニティページの各チャネルからご連絡ください。